### GRASS5.0: brief description of ASCII formats

This description of ASCII formats supported by GRASS5 is for quick reference only. For full up-to-date description see GRASS 5 Programmer's manual

- Sites

      #any comment, can be inserted anywhere
      name|mysoils.site
      desc|3D soils data for location A
      time|15 Jan 1999
      labels|east north elevation ID pH Corg color
      form||||#%%@
      333444.55|2543367.01|22.45|#1 %6.6 %20.123 @brown
      333445.05|2543377.21|32.46|#2 %5.6 %10.043 @gray

  for lat/long data

      labels|longitude latitude ID elevation
      75:33:55.34W|33:44:59.21N|#1 %225.2

  Notes:

  - sites data are stored in this ASCII format in GRASS database
  - comment and header lines are optional
  - elevation can be given as a 3rd dimension or an attribute
  - read more about how to define time in GRASS: Programmer's Manual Chap. 23 Datetime library
  - read more detailed description of sites format: GRASS 4.2(= 5.0) Site Record Format Specification

- Vector

  Example area data

  Example ASCII vector file (store in dig_ascii/):

             ORGANIZATION:
             DIGIT DATE:   Oct 24 2001
             DIGIT NAME:   nds_gem
             MAP NAME:     nds_gem
             MAP DATE:
             MAP SCALE:    500000
             OTHER INFO:   /home/neteler/grassdata5/langeoog/PERMANENT/dig_cats
             ZONE:         0
             WEST EDGE:    3399965.343
             EAST EDGE:    3403360.343
             SOUTH EDGE:   5957127.30045067
             NORTH EDGE:   5960625.30045067
             MAP THRESH:   19.05
             VERTI:
             A  13
              5958812.48844435 3400828.84221011
              5958957.29887089 3400877.11235229
              5959021.65906046 3400930.7458436
              5959048.47580612 3400973.65263665
              5959069.92920264 3401032.64947709
              5959064.56585351 3401123.82641232
              5958994.84231481 3401188.1866019
              5958914.39207784 3401188.1866019
              5958823.21514261 3401107.73636493
              5958753.49160391 3401005.83273144
              5958753.49160391 3400941.47254186
              5958780.30834956 3400887.83905055
              5958812.48844435 3400828.84221011
             A  8
              5959010.9323622 3401338.36037757
              5959096.7459483 3401370.54047235
              5959091.38259917 3401450.99070932
              5958973.38891828 3401520.71424803
              5958882.21198305 3401467.08075671
              5958903.66537958 3401375.90382148
              5958941.2088235 3401332.99702844
              5959010.9323622 3401338.36037757

  The associated dig_att file needs following format (store in dig_att/):

             A 3401180.463379 5959003.209139          1
             A 3401516.741397 5958966.635071          2

  The associated dig_cats file needs following format:

             # 2 categories

             0.00 0.00 0.00 0.00
             1:forest
             2:water

  Example line data

      ORGANIZATION:
      DIGIT DATE:
      DIGIT NAME:
      MAP NAME:     from raster map lidar99.t800
      MAP DATE:
      MAP SCALE:    0
      OTHER INFO:
      ZONE:         18
      WEST EDGE:    442296
      EAST EDGE:    443960
      SOUTH EDGE:   3978824.85093895
      NORTH EDGE:   3980319.16466812
      MAP THRESH:   0
      VERTI:
      L  5
       3980318.16445813 442301.26497998
       3980318.08679477 442301
       3980316.24075428 442299
       3980316.16403814 442298.85299258
       3980315.46571843 442297
      L  264
       3980318.16445813 442777.02040119
       3980317.26230805 442779
       3980316.16403814 442780.1796963

  Notes:

  - this format is produced by v.out.ascii and can be read by v.in.ascii, vector data are stored as binary in GRASS database
  - header is mandatory

- 2D Raster

      north: 3980319.16466812
      south: 3978824.85093895
      east: 443960
      west: 442296
      rows: 747
      cols: 832
      10.30957 10.318124 10.201462 9.9399 9.566847.............

  Notes:

  - this format is produced by r.out.ascii and can be read by r.in.ascii, raster data are stored as binary in GRASS database
  - header is mandatory
  - first row starts at NW (upper left corner) and the raster is written west to east, north to south.

- 3D Raster

      Proj: 1
      Zone: 1
      North: 2.0000000000000
      South: 0.5000000000000
      East: 4.0000000000000
      West: 3.0000000000000
      Top: 6.0000000000000
      Bottom: 5.0000000000000
      nofRows: 30
      nofCols: 20
      nofDepths: 14
      e-w resol: 0.05
      n-s resol: 0.05
      t-b resol: 0.071428571
      TileDimensionX: 8
      TileDimensionY: 8
      TileDimensionZ: 8
      CellType: double
      useCompression: 1
      useRle: 1
      useLzw: 0
      Precision: -1
      nofHeaderBytes: 12
      useXdr: 1
      hasIndex: 1
      Units: none
      22.3 44.5 33.8

  Notes:

  - this format is produced by r3.out.ascii and can be read by r3.in.ascii, raster data are stored as binary in GRASS database
  - header is mandatory
  - first row starts at NW (upper left corner) and the raster is written west to east, north to south, bottom to top.

- 3D Region definition DEFAULT_WIND3/WIND3

      Proj: 99
      Zone: 0
      North: 5766600
      South: 5763400
      East: 3573200
      West: 3570000
      Top: 0
      Bottom: -200
      nofRows: 160
      nofCols: 160
      nofDepths: 20
      e-w resol: 20
      n-s resol: 20
      t-b resol: 10

  Notes:

  - Note, this file is generated by g3.createwind and can be changed either by g3.region or g3.setregion

  GRASS Development Team ($Date: 2003/04/03 10:22:23 $)