referencingconfiguration

This configuration is optional.

  • Documentation

  • YAML Format

  • XML Format

Fill relevant inputs (blue boxes) and click the blue bars on the left to copy XML configuration snippets.
<referencingConfiguration
>
required

Settings for spatial reference systems (SRSs). In order to adapt and optimize the use of SRSs, there are the following possibilities:

  • definition of additionally available SRSs

  • pre-setting of maximum extent for SRSs in order to optimize loading time

  • mappings of SRSs

<definitions
>
optionalmax. 1

Definition settings for additionally available SRSs.

If the SRSs delivered with Cadenza are not sufficient to display data with spatial references, additional SRSs can be defined. These will also be available in the SRS selection dialogs. Furthermore, it is possible to override SRSs that are already supported but not accurate enough for the use case by specifying the appropriate WKT string.

<coordinateReferenceSystem
<authority
>
optionalmax. 1
string

Identifier of the SRS. Format: authority:code - authority of the SRS, code of the SRS, e.g. EPSG:31467.

</authority>
<wkt
>
requiredmax. 1
string

Well-known text (WKT) of the SRS.

</wkt>
>
requiredmax. unbounded

Definition of the SRS. This consists of 'authority:code' and the description as a WKT string.

</coordinateReferenceSystem>
</definitions>
<maximumExtents
>
optionalmax. 1

Settings for SRSs for which a maximum extent is pre-set in order to optimize loading time.

Note: The default setting usually differs from the layer-specific maximum extent, e.g. if data exist only for a certain federal state (Bundesland), but the default extent covers the whole of Germany. If no SRSs are configured or if no extent is pre-set for the SRS of the vector layer, then the data source is queried during initial loading to calculate the maximum extent - even if the features are not initially visible in the map view.

<maximumExtent
>
optionalmax. unbounded

Settings for a SRS for which a maximum map extent is pre-set.

<authority
>
required
string

Identifier of the SRS. Format: authority:code - authority of the SRS, code of the SRS, e.g. EPSG:31467. The SRS must be known to Cadenza.

</authority>
<boundingBox
<xMin
>
required
double

Minimum value in x-direction.

</xMin>
<yMin
>
required
double

Minimum value in y-direction.

</yMin>
<xMax
>
required
double

Maximum value in x-direction.

</xMax>
<yMax
>
required
double

Maximum value in y-direction.

</yMax>
>
required

Extent to be taken into account if the layer uses this spatial reference system.

Note: This information may differ from the official definitions for the spatial reference system. This ensures that features that are located slightly outside of this system are also taken into account. For example, in order to cover the whole of Germany, a larger extent must be entered for the spatial reference system EPSG:31467 than the officially specified extent (see "http://epsg.io/31467").

</boundingBox>
</maximumExtent>
</maximumExtents>
<availableReferencingSystems
>
optionalmax. 1

DEPRECATED: Settings to restrict the SRSs the user can select in the corresponding dialogs. When setting a SRS, e.g. to import data with spatial reference, the SRSs available for selection can be restricted. This ensures that the user is only offered the SRSs relevant to him. If no SRSs are pre-set, a very extensive list of the supported SRSs is loaded.

<referencingSystem
>
requiredmax. unbounded

Settings for a SRS the user can select in the corresponding dialogs.

srsId
required
=
string

Identifier of the SRS. Format: authority:code - authority of the SRS, code of the SRS, e.g. EPSG:31467.

<description
>
optionalmax. 1
string

Description of the SRS.

</description>
</referencingSystem>
</availableReferencingSystems>
<mappings
>
optionalmax. 1

Settings for the mappings of SRSs. Cadenza uses SRSs from the EPSG authority. If a data source, e.g. a database, uses a a non-EPSG SRS, it can be mapped to a corresponding SRS from EPSG. If no mapping exists, the SRS of the data source will be used, if supported by Cadenza.

<mapping
>
optionalmax. unbounded

The ID of the spatial reference system used by the data source (sourceSystem) and the EPSG code to which the data source should be assigned in Cadenza (targetSystem).

<sourceSystem
Choice: Choose only ONE of the following
<authority
>
requiredmax. 1
string

Identifier of the SRS. Format: authority:code - authority of the SRS, code of the SRS, e.g. EPSG:31467.

</authority>
<wkt
>
requiredmax. 1
string

Well-known text (WKT) of the SRS. Important: DEPRECATED for targetSystem. Please do not use this element any more inside targetSystem.

</wkt>
Choice End
>
requiredmax. 1

Settings of the SRS used by the data source.

</sourceSystem>
<targetSystem
Choice: Choose only ONE of the following
<authority
>
requiredmax. 1
string

Identifier of the SRS. Format: authority:code - authority of the SRS, code of the SRS, e.g. EPSG:31467.

</authority>
<wkt
>
requiredmax. 1
string

Well-known text (WKT) of the SRS. Important: DEPRECATED for targetSystem. Please do not use this element any more inside targetSystem.

</wkt>
Choice End
>
requiredmax. 1

Settings of the SRS the data source should be mapped to in Cadenza.

</targetSystem>
</mapping>
</mappings>
</referencingConfiguration>
This is a generated sample file with fake data and all the possible options shown, refer to the Documentation tab for what combinations are valid and what is required or not. 
cadenzaconfig:
  settings:
    referencingconfiguration:
      definitions:
      - authority: "text"
        wkt: "text"
      - authority: "text"
        wkt: "text"
      maximumExtents:
      - authority: "text"
        boundingBox:
          xMin: 133.7
          yMin: 133.7
          xMax: 133.7
          yMax: 133.7
      - authority: "text"
        boundingBox:
          xMin: 133.7
          yMin: 133.7
          xMax: 133.7
          yMax: 133.7
      availableReferencingSystems:
      - srsId: "text"
        description: "text"
      - srsId: "text"
        description: "text"
      mappings:
      - sourceSystem:
          authority: "text"
          wkt: "text"
        targetSystem:
          authority: "text"
          wkt: "text"
      - sourceSystem:
          authority: "text"
          wkt: "text"
        targetSystem:
          authority: "text"
          wkt: "text"

Filename: referencingconfiguration-config.xml

This is a generated sample file with fake data and all the possible options shown, refer to the Documentation tab for what combinations are valid and what is required or not. 
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<referencingConfiguration>
  <definitions>
    <coordinateReferenceSystem>
      <authority>text</authority>
      <wkt>text</wkt>
    </coordinateReferenceSystem>
    <coordinateReferenceSystem>
      <authority>text</authority>
      <wkt>text</wkt>
    </coordinateReferenceSystem>
  </definitions>
  <maximumExtents>
    <maximumExtent>
      <authority>text</authority>
      <boundingBox>
        <xMin>133.7</xMin>
        <yMin>133.7</yMin>
        <xMax>133.7</xMax>
        <yMax>133.7</yMax>
      </boundingBox>
    </maximumExtent>
    <maximumExtent>
      <authority>text</authority>
      <boundingBox>
        <xMin>133.7</xMin>
        <yMin>133.7</yMin>
        <xMax>133.7</xMax>
        <yMax>133.7</yMax>
      </boundingBox>
    </maximumExtent>
  </maximumExtents>
  <availableReferencingSystems>
    <referencingSystem srsId="text">
      <description>text</description>
    </referencingSystem>
    <referencingSystem srsId="text">
      <description>text</description>
    </referencingSystem>
  </availableReferencingSystems>
  <mappings>
    <mapping>
      <sourceSystem>
        <authority>text</authority>
        <wkt>text</wkt>
      </sourceSystem>
      <targetSystem>
        <authority>text</authority>
        <wkt>text</wkt>
      </targetSystem>
    </mapping>
    <mapping>
      <sourceSystem>
        <authority>text</authority>
        <wkt>text</wkt>
      </sourceSystem>
      <targetSystem>
        <authority>text</authority>
        <wkt>text</wkt>
      </targetSystem>
    </mapping>
  </mappings>
</referencingConfiguration>