Other ASCII files

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


SAMPLE

The SAMPLE file type is used for 3D samples of the digital terrain models (DTM) represented by spot height and/or contour lines (see figure below).

The first line of the file is the keyword SAMPLE. This line is the identification section, which is mandatory. The following lines can have the following options:

  • Keyword INFO and INFO_END, identifying the beginning and the end of the information section, which is an optional section; or
  • Keyword POINT3D identifying the beginning of the information section in the file and next the data related to spot height. This section may or may not be present, depending on the samples; or
  • Keyword LINE3D identifying the beginning of the contour line This section may or may not exist, depending on the samples.

The data section for a file of the SAMPLE entity is formed by spot height (POINT3D) or contour lines (LINE3D) or both.

A set of spot height is identified by the keyword POINT3D followed by lines having the point coordinates and its height. The keyword END identifies the end of a spot height set.

Height lines in the data section of an ASCII file for the SAMPLE entity are identified by the keyword LINE3D. The keyword HEIGHT determines the height, and it is followed by coordinate pairs of the line points. The keyword END identifies the end of a line.

The sequence END END shows the end of the data section in the file. There is no constraint related to the number of instances of the POINT3D and LINE3D entity in a file.


The following examples show two files of the SAMPLE type, one using planes coordinates and another in geographic coordinates:
SAMPLE
INFO
// Topology samples
// ASCII file generated by SPRING system
// project Brasilia  information layer Mapa_alt
// category Altimetry  model DIGITALMODEL
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
POINT3D
 187490.655018   8256234.947535   321.000000
 185561.894539   8257949.960113   125.000000
 189794.452258   8258485.901543   125.000000
 189740.875578   8254734.311530   134.000000
END
LINE3D
HEIGHT 100.000000
 184597.514299   8257360.424539
 185026.127739   8258539.495686
 186365.544739   8259664.972690
 190651.679138   8259182.625403
 190865.985858   8256127.759249
 190705.255818   8253823.211098
 188187.151858   8253448.052097
 184597.514299   8257360.424539
END
LINE3D
HEIGHT 200.000000
 185936.931299   8256074.165106
 186954.888219   8258164.336685
 188562.188618   8258057.148399
 189419.415498   8257574.801112
 186472.698099   8254787.905673
 185615.471219   8254948.688102
 185936.931299   8256074.165106
END
LINE3D
HEIGHT 300.000000
 186740.581499   8255913.382677
 186794.158179   8256342.135821
 187062.041579   8256824.483109
 187544.231698   8256931.671395
 188401.458578   8256770.888966
 186740.581499   8255913.382677
END
END


SAMPLE
INFO
// Topology samples
// ASCII file generated by SPRING system
// project Brasilia  information layer dddd
// category Altimetry  model DIGITALMODEL
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	geographic
SCALE	25000.000000
INFO_END
POINT3D
 o 47  54  58.385   s 15  45  10.299   z 321.000000
 o 47  56  2.318   s 15  44  13.686   z 125.000000
 o 47  53  40.026   s 15  43  58.165   z 125.000000
 o 47  53  43.553   s 15  46  0.084   z 134.000000
END
LINE3D
HEIGHT 100.000000
 o 47  56  34.958   s 15  44  32.411
 o 47  56  20.023   s 15  43  54.282
 o 47  55  34.550   s 15  43  18.305
 o 47  53  10.938   s 15  43  35.900
 o 47  53  5.148   s 15  45  15.292
 o 47  56  34.958   s 15  44  32.411
END
LINE3D
HEIGHT 200.000000
 o 47  55  50.607   s 15  45  14.825
 o 47  55  15.470   s 15  44  7.346
 o 47  54  21.579   s 15  44  11.551
 o 47  53  53.032   s 15  44  27.613
 o 47  53  53.576   s 15  45  5.937
 o 47  56  1.921   s 15  45  51.261
 o 47  55  50.607   s 15  45  14.825
END
LINE3D
HEIGHT 300.000000
 o 47  55  23.709   s 15  45  20.414
 o 47  55  21.711   s 15  45  6.502
 o 47  55  12.496   s 15  44  50.944
 o 47  54  56.263   s 15  44  47.677
 o 47  54  40.627   s 15  45  26.218
 o 47  54  53.264   s 15  45  29.534
 o 47  55  16.641   s 15  45  29.220
 o 47  55  23.709   s 15  45  20.414
END
END

NOTE: When exporting a numeric IL with entities of the samples type (contour lines and/or spot height), Samples option in the " Exporting " window, the SAMPLE file is created, and also the LINES file if the IL has breaking lines. By default, when exporting a samples file the "spr" file name extension, added to the "_L3D" suffix is added to the IL name, that is, *_L3D.spr. However, when importing a file created by a different system the file name has to have the "spr" extension.


About the ASCII format

Learn more about Import/Export in SPRINGG


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 ]