referencingconfiguration

This configuration is optional when using the plugin Gis.

  • 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 geographic extents for SRSs in order to optimize loading time - restrict the SRSs from which the user can select in the corresponding dialogs - 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 geographic extent is pre-set in order to optimize loading time. Note: The default setting usually differs from the theme-specific maximum geographic 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 geographic extent is pre-set for the SRS of the vector theme, then the data source is queried during initial loading to calculate the maximum geographic extent - even if the geo objects are not initially visible in the map.

<maximumExtent
>
optionalmax. unbounded

Settings for a SRS for which a maximum geographic 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

Settings for the extent to be considered. Note: These specifications may differ from the official definitions for the SRS. This is to ensure that geo objects lying somewhat outside of it are also considered. E.g., to cover the whole of Germany, a larger extent must be entered for the EPSG:31467 spatial reference system than that officially specified (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>