Other ASCII files

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


POINT2D

A POINT2D file type is used to identify entities of the point type, from a cadastral or thematic model. These entities represented by a single point (for instance, a landmark or a farm-house) store a coordinate pair X/Y and its respective identifier in the same ASCII file.

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

  • Create and identify points 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, to which the point belongs to (see the figure below).
  • Create and identify points in a thematic map - it is required to inform a pair of coordinates X/Y or Lat/Long the thematic class to which the point belongs to (see the figure below).


Still in the data section it is possible to use different formats:

  • Define a separator (a character: ; or ,) among the data using the keyword SEPARATOR;
  • Use the keywords; CLASS_NAME, NAME, LABEL and CATEGORY_OBJ, described next:
    • CLASS_NAME: identify points from a thematic IL to a class;
    • LABEL: identify points through a (single) label associated to an objects' category, in a cadastral map. Each entity can have one or more labels, but has to have different codes (see more about objects identification in chapter 9);
    • NAME: indicates a name of a cadastral entity, it may have repeated names to different labels. If it is left out the system repeats the label contents during the importing process;
    • CATEGORY_OBJ: it is an identifier of the objects category, when the entity is represented in a cadastral map.

The first line in the file is a keyword POINT2D. This line forms the identifier section, which is a mandatory section. For the second line there are the following options:

  • The keyword INFO, identifying the beginning of the information section, which ends with the keyword INFO_END, but this section is not mandatory, or
  • The X Y or LONG LAT point values. This option for the second line only happens if there is no information section in the file and none of the three keywords required for the data section are present.

The keyword END shows the end of the data section in the file. There is no constraints related to the number of entity instances in a file.

The examples presented below show a point file in a thematic map and a point file in a cadastral map.
POINT2D
INFO
// Point 2D and Identifiers if Classified Point
// ASCII file generated by the SPRING System
// project Proj1  information layer Uso1996
// category Usage  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    o 47  58  10.485, s 15  53  0.000, o 47  46  20.203, s 15  41  0.124
UNITS	geographical
SCALE	25000.000000
INFO_END
CLASS_NAME   "Cerrado"
 o 47  56  59.255   s 15  47  40.251
CLASS_NAME   "Campo"
 o 47  57  1.457   s 15  48  8.097
CLASS_NAME   "Mata"
 o 47  56  7.600   s 15  48  15.797
END

POINT2D
INFO
// Point 2D and Identifiers if Classified Point
// ASCII file generated by the SPRING System
// project Proj1  information layer Mapa_rural
// category Cad_rural  model CADASTRALMODEL
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   653162.837615, 661774.873403, 7400228.734734, 7409547.788588
UNITS	meters
SCALE	25000.000000
INFO_END
LABEL   "None"
 657212.876744   7408419.999536
LABEL   "None"
 658746.721350   7404350.234287
LABEL   "None"
 656196.058409   7406557.564592
CATEGORY_OBJ "Farms"
LABEL  "FZ012344"
NAME   "Sed. Farm                        "
 657212.876744   7408419.999536
CATEGORY_OBJ "Farms"
LABEL  "FZ049666"
NAME   "Sed. Farm                        "
 658953.531859   7406471.340752
CATEGORY_OBJ "Farms"
LABEL  "FZ087564"
NAME   "Sed. Farm                        "
 656196.058409   7406557.564592
CATEGORY_OBJ "Farms"
LABEL  "FZ065544"
NAME   "Sed. Farm                        "
 658746.721350   7404350.234287
CATEGORY_OBJ "Farms"
LABEL  "FZ04554"
NAME   "Sed. Farm                        "
658901.829231   7401884.232462
END


NOTE: When a thematic point or a cadastral point is not properly identified, that is, not associated to a thematic class or to a cadastral objects, the line corresponding to the class name or object, must appear as a LABEL = "None".


The examples presented previously could be represented by separators (semicolon or comma):
POINT2D
INFO
// Point 2D and Identifiers if Classified Point
// ASCII file generated by the SPRING System
// project Brasilia - information layer: Mapa PTO
// Category: Drainage  - 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, 8246273.000000, 195009.000000, 8258937.000000
UNITS Geographical
SCALE	10000.000000
SEPARATOR ,
// Format coordx , coordy , class_name
INFO_END
 o 47  56  59.255 ,  s 15  47  40.251 , Cerrado
 o 47  57  1.457 ,  s 15  48  8.097 , Campo
 o 47  56  7.600 ,  s 15  48  15.797 , Mata
END

POINT2D
INFO
// Point 2D and Identifiers if Classified Point
// ASCII file generated by the SPRING System
// project Brasilia - information layer: Points
// 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
 657212.876744 ; 7408419.999536; None
 658746.721350 ; 7404350.234287
 656196.058409 ; 7406557.564592
 657212.876744   7408419.999536 ; FZ012344 ; Sed. Faz ; Farms
 658953.531859   7406471.340752 ; FZ049666 ; Sed. Faz ; Farms
 656196.058409   7406557.564592 ; FZ087564 ; Sed. Faz ; Farms
 658746.721350   7404350.234287 ; FZ065544 ; Sed. Faz ; Farms
 658901.829231   7401884.232462 ; FZ04554 ; Sed. Faz ; Farms
END


NOTE: When a thematic or cadastral point is not properly identified, that is, not associated to a thematic class or to a cadastral object, the line corresponding to the class name or object, must have the "None" word. The following points with nothing written will not be identified. In the example above the first three points will not have identifiers.

NOTE: When a thematic or cadastral IL is exported with point entities types, the Points option in the " Exporting" window, the POINT2D file is created. By default, when exporting a points file the file name extension is "spr", with the "_P2D" suffix added to the IL name, that is, *_P2D.spr. However, when importing the file should have only the extension "spr", in case it was created by a different system.


About the ASCII format

See about the Importing/Exporting in the SPRING


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


Other ASCII files

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