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      

long fromId
long tooId



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 ]