vectorlib_ogr.dox 2.3 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768
  1. /*! \page vlibOgr GRASS-OGR data provider
  2. by GRASS Development Team (https://grass.osgeo.org)
  3. \tableofcontents
  4. \section vLibPseudoTopo Pseudo-topology
  5. Reduced topology: each boundary is attached to one area only,
  6. i.e. smoothing, simplification, removing small areas etc. will not
  7. work properly for adjacent areas or areas within areas.
  8. Full topology is only available for native GRASS vectors or can only
  9. be built after all polygons are converted to areas and cleaned as done
  10. by <tt>v.in.ogr</tt>.
  11. \section vlibFrmtFileFormat Frmt file format specification
  12. Frmt is a plain text file which contains basic information about
  13. external format of linked vector map. Each line contains key, value
  14. pairs separated by comma.
  15. OGR specific format is described by:
  16. - FORMAT - ogr
  17. - DSN - OGR datasource name
  18. - LAYER - OGR layer name
  19. Example:
  20. \verbatim
  21. FORMAT: ogr
  22. DSN: /path/to/shapefiles
  23. LAYER: cities
  24. \endverbatim
  25. OGR layer can be linked via <tt>v.external</tt> command. When linking
  26. OGR layer pseudo-topology ('topo') is built including spatial index
  27. file ('sidx') and category index file ('cidx'). Additionally also
  28. feature index file (see \ref vlibFidxFileFormat) is created.
  29. \section vlibFidxFileFormat Fidx file format specification
  30. Note: <tt>finfo</tt> is an instance of \ref Format_info structure.
  31. <table border="1" style="border-collapse: collapse" cellpadding="5">
  32. <tr><td><b>Name</b></td><td><b>Type</b></td><td><b>Number</b></td><td><b>Description</b></td></tr>
  33. <tr><td>Version_Major </td><td>C</td><td>1</td><td>file version (major)</td></tr>
  34. <tr><td>Version_Minor </td><td>C</td><td>1</td><td>file version (minor)</td></tr>
  35. <tr><td>Back_Major</td><td>C</td><td>1</td><td>supported from GRASS version (major)</td></tr>
  36. <tr><td>Back_Minor</td><td>C</td><td>1</td><td>supported from GRASS version (minor)</td></tr>
  37. <tr><td>byte_order</td><td>C</td><td>1</td><td>little or big endian
  38. flag; files are written in machine native order but
  39. files in both little and big endian order may be
  40. readl; zero for little endian</td></tr>
  41. <tr><td>length</td><td>L</td><td>1</td><td>header size</td></tr>
  42. <tr><td>fInfo.ogr.offset_num</td><td>I</td><td>1</td><td>number of records</td></tr>
  43. <tr><td>fInfo.ogr.offset</td><td>I</td><td>offset_num</td><td>offsets</td></tr>
  44. </table>
  45. */