This is a reference documentation of the CityGML (CityModel) writer in hale studio. Usually you will not need this reference, as in hale studio the configuration of I/O providers is done via the respective wizards for import and export. Where this reference can come in handy is if you want launch a transformation via the command line.
Name | CityGML (CityModel) |
---|---|
Identifier | eu.esdihumboldt.hale.io.citygml.writer |
Implementation | eu.esdihumboldt.hale.io.gml.writer.CityGMLInstanceWriter |
Following are the specific configuration parameters for this writer.
If geometries should be simplified (e.g. a MultiPolygon to a Polygon), if possible, before writing them.
Setting name | gml.geometry.simplify |
---|---|
Default value | true |
Target coordinate reference system the data should be transformed to.
Setting name | crs |
---|---|
Example value | code:EPSG:4326 |
Reference systems can be defined either as code or WKT (preceded with code: or wkt: respectively) | |
By default no CRS transformation is performed, the existing geometries are written with their respective CRS. |
If the output should be pretty printed (indented)
Setting name | xml.pretty |
---|---|
Default value | false |
Prefix to use for all CRS codes based on EPSG in geometry srsNames.
Setting name | crs.epsg.prefix |
---|---|
Example value | http://www.opengis.net/def/crs/EPSG/0/ |
Make sure that all SRS names use this kind of notation. The EPSG code number is appended to the provided parameter to build the SRS name. | |
By default the CRS code is not modified. |
Unifiying the winding order of geometries, before writing them
Setting name | geometry.unifyWindingOrder |
---|---|
Example value | clockwise, noChange |
Unifying order can be set as Clockwise or no change in order (clockwise or noChange respectively). | |
Default value | counterClockwise |
By default, counterClockwise is set for GML instance |
Don't encode nilReason attributes for elements that are not nil.
Setting name | xml.notNil.omitNilReason |
---|---|
Example value | false |
Default value | true |
By default, nilReason attributes are omitted for elements that are not nil. |
Number representation format for geometry coordinates
Setting name | geometry.write.decimalFormat |
---|---|
Example value | 000000.000 |
Format must be given with digit 0 and decimal separator '.'. It states number of digits before and after decimal separator. | |
By default no format is used, geometry coordiantes are written in the standard format only. |
Guiding value for instances per file. The number will be exceeded only in cases where there are too many inter-related instances that cannot be separated.
Setting name | instancesPerFile |
---|---|
Example value | 1000 |
Default value | 0 |
By default, no partitioning will take place and all instances will be written to a single file. |
Mode for partitioning the output
Setting name | partition.mode |
---|---|
Example value | cut |
The partitioning can also be done by cutting strictly at the threshold. | |
Default value | related |
By default objects that are connected via local XML references are kept together. |
The following configuration parameters are shared for all I/O providers.
During import the content type is tried to be auto-detected, for export this is not possible, but I/O providers may have a default content type associated. If an I/O provider only supports one content type, it's usually not necessary to set this parameter. In any case you can override the content type to use/assume using a content type identifier (see the list of supported content types at the bottom of the page).
Setting name | contentType |
---|---|
Example value | eu.esdihumboldt.hale.io.citygml.gzip |
Specifying a character encoding is important especially for the
import, so data is interpreted correctly. Not every I/O provider
may respect this setting though (e.g. if the encoding is given by
the data source).
Specify a character encoding by its name
as recognised by Java.
Setting name | charset |
---|---|
Example value | UTF-8 |
eu.esdihumboldt.hale.io.citygml.gzip
)eu.esdihumboldt.hale.io.citygml
)