The Webmap At home AXIL format
This document is covers version 1 of the Webmap At home format.
Webmap at home is an axial mapping application intended to replace
Axman. Webmap is designed to have a number of new features including
the ability to save extra columns of information attached to each axial
line. The Webmap at home file format is derived from the webmapAthome
sever format. The format is intended to be simple to parse.
General outline
Every Element of AXIL is generally appears on one line of input.
The
file is saved by Java in what ever text format it wants It looks to be
cross platform. Each line
tends to be in the format.
NUMBER NAME ARGUMENT1,ARGUMENT 2
32 OBSERVATION 10,20,30,20,303.3
Notice there is a SINGLE space
between the number and the Label and a single space After the lable
before the arguments begin. Numbers are unique and can be used in
switch statement if required.
Structure
The aim of AXIL was to be structure less. In practice there are a
few restrictions. Individual Layer elements cannot be saved before the
layer information
is saved. Columns have a column info saved. The document can end with
end of document. This is about it. Information about the map can ( and
does ) come anywhere.
Element s
4 COMMENT <anything>
Rest of line ignored, comment idgnored.
2 LINE
| Long |
globalLineID - should be zero |
| Long |
fLineIDX local line id. 1.2.3.4.5. Referance Index used by
unlink
and super links |
| float |
x1 -
horizontal coordinate of line start normally > 0 |
| float |
y1-
vertiacal coordinate of line end normally > 0 |
| float |
x2 - horizontal coordinate of line start normally > 0 |
| float |
y2 - vertiacal coordinate of line end normally > 0 |
| float |
ignoreIntegration - can be 0 integration for this line.
Ignored by webmap but provided to other apps as a convenianced. |
| long |
totalstepdepth - total step depth from this point to all
others. Can be 0 |
| long |
totalcount - number of lines reachable normally the number of
lines in
the system can be 0. |
| long |
totalstepdepth3 - raidus 3 step depth from this point. can be
0 |
| long |
total3count - count of number of items within radius 3 count
from this
point. can be 0 |
| int |
connectivity - count of number of lines which connected
to can be 0. |
| float |
control - control value can be 0. |
| int |
maxdepth - maximum depth in system can be 0.0 |
| float |
fractionalra - Can be 0 or NaN |
| float |
cap_fractionalra - Can be 0 or NaN |
| long |
totalstepdepthx raidus X total depth - use conttroled setting |
| long |
totalxcount raidus x( 7 by default) count of items within
raidus 7. |
| String |
locked
't' or 'f' |
notes
This is the most used element. The lineidex should be from 1 and
increment for each line the system value should be 0 unless you got
this from the webmap server. lineidex is not important directly but is
used by by the other elements such as unlinks and super links. Except
for this and the coordinates all other values can be 0 if the maps is
unprocessed. Values beyond these are ignored. Note dont add new values
to the column if you want to add new values then add them as metacolum
data, is simple and then webmap can read them directly.
Future expansion
int layerID - future versions may include seperate layers for
lines.
example
2 LINE 0,1,988.0,1715.0,1131.0,1648.0,1.8672435,797,212,223,87,5,0.9254902,7,0.013951473,0.014806954,797,212,1.8672435,2.4781413,'f'
2 LINE 0,2,1199.0,1753.0,973.0,1752.0,2.0452423,746,212,243,99,10,2.4516807,6,0.012368687,0.012559475,746,212,2.0452423,2.7880101,'f'2
2 LINE 0,3,1061.0,1722.0,1048.0,1648.0,1.7070277,852,212,177,69,5,1.0214286,7,0.015482747,0.017100029,852,212,1.7070277,2.2658372,'f'
12 UNLINK
14 SUPERLINK
| long |
serverid normally 0.
|
| long |
fromId this is the axial line id from the
|
| long |
tooId |
| float |
weght no negative values.
|
32 OBSERVATION X,Y,X2,Y2,Value;
| double |
X |
Starting coord
|
| double |
Y |
Starting coord
|
| double |
X2 |
End coord
|
| double |
Y2 |
End Coord
|
| double |
Value |
Value
|
29 METACOLUMN serverid,'name',localindex,'format',defaultvalue
| long |
serverid - mostly 0. |
| String |
name - quoted name of layer the user
sees. |
| long |
localindex - local number from 0. Referance by the
value element. |
| String |
format - quoted string showing fromat of
number in Java format. |
| float |
defaultvalue - value for the line |
example
29 METACOLUMN 0,'K2OverK1',0,'########.#####',0.0
31 VALUE 0,0,1,0,5.0
Notes
If you want to add a new measure add 1 to the largest metacolumn
localindex you imported. This is the new index for your column. Export
the line id and for each line export a value element ( below).
31 VALUE
long servercolumn_id
|
Generally 0
|
|
|
| long column_id |
local column id from 0 links to
line from Meta Column id.
|
| long local_line_id |
local line id links to aixla
line di.
|
| long server_line_id |
general 0.
|
| double value |
value of column. Must be a
number.
|
|
|
26 FORMAT
3 IMAGE
| long |
serverid generally 0
|
| float |
top coordinate from the top of the page down
|
| float |
left |
| float |
width |
| float |
hight |
| String |
locked |
| String |
filename server name ( not quoted) no newlines permited.
|
The image is normally stored externally to the document ( like a web
page).
28 IMAGECATALOG
| String |
serverID |
| String |
uservisiblename |
| String |
size |
| String |
serverName |
This is a webmap at home server thing. The image catalog is a list of
images which can be loaded into the map. Not normally seen in a saved
map.
23 MAP-NAME
String - long name of map no new lines, unquoted.
example
23 MAP-NAME Barnsbury 2
25 MAP-REGION
String - region
(Europe,USA,NorthAmerica,SouthAmerica,Arabic,Asia,Non,virtual,imaginary
ect )
This sould really be a popup of choices. Indended to help catalog maps
for future comparisons. Default No Region.
25 MAP-REGION No Region
16 CITY
String name of the original city or building.
Unquoted lasts to the end of line.
example
16 CITY London
24 MAP-DATE
String - data of source of the map.
example
24 MAP-DATE 2005
6 MAP-COMMENT
String comment about the map displayed to the user.
Newlines replaced by underscores.
6 MAP-COMMENT <NOTES> _Such as sub area, intreasting features or if this is a project proposal.
7 END OF MAP
This is it the map has ended. Ignore any other data in the file.
Future elements
These may or may not arise in future versions of webmapAthome
101 USER_SETS RX,FX
102 PREFERANCE_COLOR R,G,B
103 VERSION X Lable - verson of webmap format
104 LABLE X,Y,LAYERID,ANGLE,TEXT
105 SQLTABLE USER@HOST:PASSWORD, DATABASE,TABLE, INDEXCOLUMN
106 HISTOGRAM numberOfBins
107 Intelligbiltiy factor,factor,factor
108 AUTHOR Name
109 CHECKER name
110 CALCULATION - EXPRESSION,FORMAT
The calcuation column does not calcuated new values
but saves them as a calcuation in a meta column saves space and values
are always recalcuated when nessasry.
Future elements may include images inline with the document.
[ THE PUREHOME ]