This is a reference documentation of the XPlanGML (XPlanAuszug) 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 | XPlanGML (XPlanAuszug) |
|---|---|
| Identifier | eu.esdihumboldt.hale.io.gml.xplan.writer |
| Implementation | eu.esdihumboldt.hale.io.gml.writer.XPlanGmlInstanceWriter |
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 |
XML ID to specify for the container element, if possible
| Setting name | xml.containerId |
|---|
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. |
Pattern for formatting decimal numbers
| Setting name | xml.decimalFormat |
|---|---|
| Example value | 0.000## |
| The pattern may contain the placeholders '0' and '#' and the decimal separator '.' (once at most). The pattern defines the number of digits used before and after the decimal separator. The placeholder '0' signifies that a digit will always be written, even if it is a leading or trailing zero, whereas with the placeholder '#' the digit will only be written if it is not a leading/trailing zero. In case the original value has more significant figures than the pattern allows for, the number will be rounded. | |
| By default no format is used, decimal values may be written in scientific notation (e.g. 6.78E9) |
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.xplangml |
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.xplangml)