Other ASCII files

[ LINES ]   [ POINTS ]   [ POINT2D ]   [ SAMPLE ]   [ GRIDREG ]   [ TABLE ]   [ TEXT ]   [ POLYGONS ]   [ NETWORK ]   [ NETWORK_OBJECTS ]


POINTS

A POINTS file type is used for identification of lines or polygons entities, either in a cadastral or in a thematic IL model. If the entity is of the point type (see POINT2D), the identifiers are in the points file.

The identifiers file, usually with a file name extension *_LAB.spr, comes together with the lines file, and it has its own syntax for thematic or cadastral data identification. The SPRING knows how to differentiate the identification between lines and polygons.

The figure below shows a lines map and a polygons map. To identify the three lines, independently of the number of points in each line, it is required, in the POINTS file, three identifiers, with X/Y coordinates over any point in each line. For both polygons, formed with three lines, it is required two identifiers, with internal X/Y coordinates.

The data syntax inside a POINTS file type varies as a function of its purpose, that is:

  • Identify lines/polygons in a cadastral map - it is required to inform a pair of coordinates X/Y or Lat/Long, a label, a name (not mandatory) and an object category which belongs to the line or polygon.
  • Identify lines/polygons in a thematic map - it is required to inform a pair of coordinates X/Y or Lat/Long and the thematic class that the line or polygon belongs to.

In the data section it is possible to use different formats:

  • Define a character separator ( ; or , ) among the data through the SEPARATOR keyword;
  • Use the keyword; CLASS_NAME, NAME, LABEL and CATEGORY_OBJ, described as follows:
    • CLASS_NAME: identify lines or polygons from a thematic IL in its class;
    • LABEL: identify lines or polygons using a label (unique) associated to an object category in a cadastral map. Each entity can have one or several labels, but they have to have different codes (see more about objects identification);
    • NAME: indicates a name in a cadastral entity, it may have repeated names for different labels;
    • CATEGORY_OBJ: it is an identifier for the objects category, when the entity is represented in a cadastral or network map.

NOTE: The X and Y coordinates of an identifier can be associated more than once to the same geographic entity, when dealing with cadastral objects, independently if it is a line or an area.

IMPORTANT: To import a polygon (area) identifiers file, the lines building the polygon must be adjusted and polygonalized. The polygonalization and the adjust can be executed when importing line entities (Line with topology option), or in the editor window (see about polygonalization and nodes adjust).

The next two examples show a thematic entity identifiers file and the other one for cadastral entities. Notice that these files must begin using the keyword POINTS and end using the keyword END.


POINTS
INFO
// Polygons and classified lines identifiers
// ASCII files generated by the SPRING system
// project Proj1  information layer Uso1996
// category Uso  model THEMATICMODEL
DATUM	SAD69, 6378160.000000, 0.003353, 0.000000, 0.000000, 0.000000
PROJECTION	 UTM/SAD69, 0, 0.000000, -0.785398, 0.000000, 0.000000
BOX    181972.256980, 8241710.934769, 202825.187176, 8264137.640522
UNITS	meters
SCALE	25000.000000
INFO_END
NAME   "Reforestation"
 656937.129399   7405850.529104
CLASS_NAME   "Urban"
 657230.110953   7404143.297071
CLASS_NAME   "Reforestation"
 658557.145050   7406764.501808
CLASS_NAME   "Urban"
 657092.237280   7407005.928560
CLASS_NAME   "Forest"
 657643.931890   7495805.634533
 579643.031970   7805605.933766
 807643.231088   8305505.643743
 345643.667319   8605555.683743
CLASS_NAME   "Reforestation"
 658850.126604   7403005.142383
CLASS_NAME   "Urban"
 659367.152876   7404971.045935
END

NOTE: Notice that it is possible to have several entities (lines or polygons) associated to the same thematic class, without repeating the keyword CLASS_NAME in each line in the file. In the example above there are 4 identifiers for the "Forest" class.


See next the cadastral objects identifiers example, but using the geographic coordinates.

POINTS
INFO
// Polygons and classified lines identifiers
// ASCII files generated by the SPRING system
// project: Brasilia - Information Layer: Blocks_Map
// Category: Urban_Cadastre  - Model: CADASTRALMODEL
DATUM	SAD69, 6378160.000000, 0.003353, 0.000000, 0.000000, 0.000000
PROJECTION	 UTM/SAD69, 1, 0.000000, -0.785398, 0.000000, 0.000000
BOX	o 47  57  15.14, s 15  50  37.46, o 47  50  44.85, s 15  43  40.70
UNITS Geographical
SCALE	25000.000000
INFO_END
CATEGORY_OBJ  "Blocks"
LABEL  "SQN-416"
NAME   "SQN-416"
 o 47  53  17.01   s 15  44  8.89
CATEGORY_OBJ  "Blocks"
LABEL  "SQN-415"
NAME   "SQN-415"
 o 47  53  14.09   s 15  44  19.50
CATEGORY_OBJ  "Blocks"
LABEL  "SQN-414"
NAME   "SQN-414"
 o 47  53  12.03   s 15  44  31.46
CATEGORY_OBJ  "Blocks"
LABEL  "SQN-413"
NAME   "SQN-413"
 o 47  53  3.85   s 15  44  45.39
END

The same examples presented above could be represented by separators like semicolon or comma:

POINTS
INFO
// Polygons and classified lines identifiers
// ASCII files generated by the SPRING system
// project: Brasilia - Information Layer: TESTE
// Category: Land_Use  - Model: THEMATICMODEL
DATUM	SAD69, 6378160.000000, 0.003353, 0.000000, 0.000000, 0.000000
PROJECTION	 UTM/SAD69, 1, 0.000000, -0.785398, 0.000000, 0.000000
BOX	183557.000000, 8246277.000000, 195017.000000, 8258937.000000
UNITS Meters
SCALE	10000.000000
SEPARATOR ,
// Format coordx , coordy , class_name
INFO_END
 656937.129399 ,  7405850.529104  , Reforestation
 657230.110953 ,  7404143.297071  , Urban
 658557.145050 ,  7406764.501808  , Reforestation
 657092.237280 ,  7407005.928560  , Urban
 657643.931890 ,  7495805.634533  , Forest
 579643.031970 ,  7805605.933766  ,
 807643.231088 ,  8305505.643743  ,
 345643.667319 ,  8605555.683743  ,
 658850.126604   7403005.142383  , Reforestation
 659367.152876   7404971.045935  , Urban
END

NOTE: Notice that it is possible to have several entities (lines or polygons) associated to the same thematic class, without repeating the class name in each line in the file. In the example above there are 4 identifiers for the "Forest" class.


POINTS
INFO
// Polygons and classified lines identifiers
// ASCII files generated by the SPRING system
// project : Brasilia - Information Layer: Blocks_Map
// Category: Urban_Cadastre  - Model: CADASTRALMODEL
DATUM	SAD69, 6378160.000000, 0.003353, 0.000000, 0.000000, 0.000000
PROJECTION	 UTM/SAD69, 1, 0.000000, -0.785398, 0.000000, 0.000000
BOX	183557.000000, 8246273.000000, 195009.000000, 8258937.000000
UNITS Meters
SCALE	25000.000000
SEPARATOR ;
// Format coordx ; coordy ; label ; name ; category_obj
INFO_END
 190485.563504 ; 8258165.416549 ; SQN-416 ; SQN-416 ; Blocks
 190577.039063 ; 8257840.187344 ; SQN-415 ; SQN-415 ; Blocks
 190643.566742 ; 8257473.262088 ; SQN-414 ; SQN-414 ; Blocks
 190893.045539 ; 8257047.962359 ; SQN-413 ; SQN-413 ; Blocks
END

NOTE: When exporting a Thematic or Cadastral Information Layer with lines and/or polygon entity types, the Lines and Identif option in the " Exporting" window, two files are generated: the lines file (LINES) and the identifiers file (POINTS). By default, when exporting an identifiers file the "spr" file name extension is used and the "_LAB" suffix is added to the IL name, that is, *_LAB.spr. However, when importing a file it is required that the file name has the extension "spr" if it was created using a different system.


About the ASCII format

Learn more about Import/Export in SPRING


See also:
How to IMPORT data?
How to IMPORT SGI data?
How to IMPORT GRIB images?
How to EXPORT data?


Other ASCII files

[ LINES ]   [ POINTS ]   [ POINT2D ]   [ SAMPLE ]   [ GRIDREG ]   [ TABLE ]   [ TEXT ]   [ POLYGONS ]   [ NETWORK ]   [ NETWORK_OBJECTS ]