1.. _vector.vdv:
2
3VDV - VDV-451/VDV-452/INTREST Data Format
4=========================================
5
6.. versionadded:: 2.1
7
8.. shortname:: VDV
9
10.. built_in_by_default::
11
12This driver can read and create text files following the VDV-451 file
13format, which is a text format similar to CSV files, potentially
14containing several layers within the same file.
15
16It supports in particular reading 2 "profiles" :
17
18-  (read/write) VDV-452 standard for route network / timetable
19-  (read/only) "INTREST Data format" used by the `Austrian official open
20   government street
21   graph <https://www.data.gv.at/katalog/dataset/3fefc838-791d-4dde-975b-a4131a54e7c5>`__
22
23The generic reader/writer for VDV-451/VDV-452 can support arbitrarily
24large files. For the INTREST data case, for combined layers in a single
25file, the driver ingests the whole file in memory to reconstruct the
26Link layer.
27
28Interleave reading among layers is supported in files with multiple
29layers.
30
31Driver capabilities
32-------------------
33
34.. supports_create::
35
36.. supports_georeferencing::
37
38.. supports_virtualio::
39
40Creations issues
41----------------
42
43The driver can create new layers (either in the same file, or in
44separate files in the same directory). It can append a new layer into an
45existing file, but it cannot append/edit/delete features to an existing
46layer, or modify the attribute structure of an existing layer after
47features have been written.
48
49The following dataset creation options are available:
50
51-  **SINGLE_FILE**\ =YES/NO. Whether several layers should be put in the
52   same file. If NO, the name is assumed to be a directory name.
53   Defaults to YES.
54
55The following layer creation options are available:
56
57-  **EXTENSION**\ =string. Extension used when creation files in
58   separate layers, i.e. only for SINGLE_FILE=NO dataset creation
59   option. Defaults to x10.
60-  **PROFILE**\ =GENERIC/VDV-452/VDV-452-ENGLISH/VDV-452-GERMAN.
61   Defaults to GENERIC. Describe which profile the writer should conform
62   to. VDV-452 will restrict layer and field names to be the one allowed
63   by the VDV-452 standard (either in English or German).
64   VDV-452-ENGLISH and VDV-452-GERMAN will restrict the VDV-452 to the
65   specified language. The configuration file describing VDV-452 table
66   and field names is
67   `vdv452.xml <https://github.com/OSGeo/gdal/blob/master/gdal/data/vdv452.xml>`__
68   located in the GDAL_DATA directory.
69-  **PROFILE_STRICT**\ =YES/NO. Whether checks of profile should be
70   strict. In strict mode, unexpected layer or field names will be
71   rejected. Defaults to NO.
72-  **CREATE_ALL_FIELDS**\ =YES/NO. Whether all fields of predefined
73   profiles should be created at layer creation. Defaults to YES.
74-  **STANDARD_HEADER**\ =YES/NO. Whether to write standard header fields
75   (i.e mod, src, chs, ver, ifv, dve, fft). If set to NO, only
76   explicitly specified HEADER_xxx fields will be written. Defaults to
77   YES.
78-  **HEADER_SRC**\ =string: Value of the src header field. Defaults to
79   UNKNOWN.
80-  **HEADER_SRC_DATE**\ =string: Value of the date of the src header
81   field as DD.MM.YYYY. Defaults to current date (in GMT).
82-  **HEADER_SRC_TIME**\ =string: Value of the time of the src header
83   field as HH.MM.SS. Defaults to current time (in GMT)
84-  **HEADER_CHS**\ =string: Value of the chs header field. Defaults to
85   ISO8859-1.
86-  **HEADER_VER**\ =string: Value of the ver header field. Defaults to
87   1.4.
88-  **HEADER_IFV**\ =string: Value of the ifv header field. Defaults to
89   1.4.
90-  **HEADER_DVE**\ =string: Value of the dve header field. Defaults to
91   1.4.
92-  **HEADER_FFT**\ =string: Value of the fft header field. Defaults to
93   '' (empty string).
94-  **HEADER\_**\ *xxx*\ =string: Value of the *xxx* (user defined)
95   header field.
96
97Links
98-----
99
100-  `VDV-451 file
101   format <https://www.vdv.de/vdv-schrift-451.pdfx?forced=true>`__
102   (German)
103-  `VDV-452 data
104   model <https://www.vdv.de/452--sdsv15.pdfx?forced=true>`__ (German)
105-  `Austrian INTREST data
106   format <http://open.gip.gv.at/ogd/0_dokumentation_gipat_ogd.pdf>`__
107   (German)
108