Erstellung von Presets (Vorlagen) in der Erdkabeldefinitionsdatei undergroundcables_definitions.xml

Vorbemerkungen

Was sind Presets?

Presets sind vordefinierte Profilvolumenkörper, d.h. bei der Erstellung von Fachobjekten kann auf diese Vorlagen zurückgriffen werden, ohne dass diese immer wieder neu parametrisiert werden müssen.

Was ist die Datei undergroundcables_definitions.xml

Die Presets werden in der Datei undergroundcables_definitions.xml angelegt. Eine Standarddatei mit bereits vordefinierten Presets wird im KorFin®-Installationsverzeichnis mitgeliefert.

Damit diese im Projekt genutzt werden kann, muss diese zunächst im Projektverzeichnis gespeichert werden. Die Datei lässt sich kontinuierlich erweitern und kann für verschiedene Projekte weiter verwendet werden.

Grundlegender Aufbau der Datei undergroundcables_definitions.xml

<?xml version="1.0" encoding="UTF-8"?>
<asdatafile>
  <volumes>
    <volume>
      [Spezifikation]
    </volume>
    [Weitere Profilvolumina]
  </volumes>
  <sections>
    <section>
      [Spezifikation]
    </section>
    [Weitere zusammengesetzte Systemdefinitionen]
  </sections>
</asdatafile>

Profilvolumen

Um ein Preset in der Datei undergroundcables_definitions.xml zu erstellen, stehen folgende Grundformen der Profilvolumen zur Verfügung:

• Profilverschiebung

• Geböschtes Profil

• Geböschtes Profil mit Mindestdeckung über der Gradiente

• Kreisprofil

Diese Profilvolumen besitzen verschiedene Eigenschaften, die jeweils erweitert werden, um die Profilform festzulegen. Die einzelnen Profile werden in den folgenden Abschnitten erläutert.

Grundaufbau eines Profilvolumens

Jedes der Profilvolumen wird über ein XML-Element innerhalb des Wurzelelements (<asdatafile>) und dem <volumes>-Element eingefügt. Der Grundaufbau eines jeden Elements ist gleich und wird in diesem Abschnitt erläutert.

<volume id="..." type="..." name="..." info="...">
  <target line="..." />
  [Profilspezifische Eigenschaften]
</volume>

Allgemeine Attribute der Profilvolumen

id	Dient der Identifikation eines konkreten Volumenobjekts. Sie muss eindeutig sein. Es ist ein Attribut des <volume>-Tags.
type	Legt fest, um welches Profilvolumen es sich handelt. Dieser ist aus dem Klassennamen abgeleitet. Es stehen folgende Typen zur Verfügung: TsfUCProfileTerrain Profilverschiebung TsfUCProfileSloped Geböschte Profil TsfUCProfileTrench Geböschtes Profil mit Mindestdeckung über der Gradiente TsfUCProfileCircle Kreisprofil Es ist ein Attribut des <volume>-Tags. Je nach gewähltem Profiltyp ändert sich die Parametrisierung in den Eigenschaften in KorFin®.
name	Gibt den Namen des spezifischen Volumenkörpers an. Dieser Name wird im Dropdown-Menü “Presets” des Fachobjekts “Profilvolumen” verwendet. Es ist ein Attribut des <volume>-Tags.
info	Kann für weiterführende Informationen genutzt werden. Es ist ein Attribut des <volume>-Tags.
line	Über diese Bezeichnung kann dieses Profilvolumen als Referenzziel anderer Profilvolumen dienen. Es ist ein Attribut des <target>-Tags.

Die profilspezifischen Eigenschaften sind typabhängig. Sie werden in den folgenden Abschnitten beschrieben.

Profilverschiebung

Die Profilverschiebung besteht aus vier Eckpunkten, deren Lage ausgehend von der referenzierten Achse bestimmt wird. Dabei folgt das Profil dem Verlauf der Geländekante.

<volume id="..." type="TsfUCProfileTerrain" name="..." info="...">
  <target line="..." />
  <terraindelta left="..." right="..." depth="..."/>
</volume>

Attribute der Profilverschiebung

Beispiele für die praktische Anwendung:

• Oberbodenabtrag

Geböschtes Profil

Das geböschte Profil besteht aus einem Viereck, deren Lage ausgehend von der referenzierten Achse bestimmt wird.

<volume id="..." type="TsfUCProfileSloped" name="..." info="...">
  <target line="..."/>
  <profile>
    <d t="..." z="..." ftag="..." system="..." line="..."/>
    <d t="..." z="..." ftag="..." system="..." line="..."/>
  </profile>
  <left alphadeg="..." system="..." line="..."/>
  <right alphadeg="..." system="..." line="..."/>
</volume>

Attribute des geböschten Profils

t	Gibt die Breite ausgehend von der referenzierten Achse nach links an. Um eine Verschiebung nach links in Stationierungsrichtung zu erhalten, müssen negative Werte verwendet werden. Um eine Verschiebung nach rechts in Stationierungsrichtung zu erhalten, müssen positive Werte verwendet werden. Es ist ein Attribut des <d>-Tags als Unterelement des <profile>-Tags.
z	Gibt die Tiefe bzw. Höhe des Profilvolumens ausgehend von der referenzierten Achse an. Negative Werte führen zu einer Verschiebung nach unten. Positive Werte führen zu einer Verschiebung nach oben. Es ist ein Attribut des <d>-Tags als Unterelement des <profile>-Tags.
ftag	Gibt den Höhenbezug eines Punkts an. “prev” Die Punkthöhe wird vom Vorgänger übernommen und z als Delta aufdatiert. “next” Die Punkthöhe wird vom Nachfolger übernommen und z als Delta aufdatiert. “base” Die Punkthöhe wird aus der Anrechnung des Profilpunkts bezogen auf eine Basis berechnet. Zusätzlich wird z als Differenz aufdatiert. “[leer]” Die Punkthöhe wird ausschließlich durch z definiert. Es ist ein Attribut des <d>-Tags als Unterelement des <profile>-Tags.
system	Gibt an, an welchem System KorFin® nach dem passenden Volumenobjekt (Attribut line des <target>-Tags) sucht. Es ist ein Attribut des <d>-Tags als Unterelement des <profile>-Tags, sowie des <left>- und <right>-Tags.
line	Gibt an, auf welches Volumenobjekt des angegebenen Zielsystems (Attribut system) sich dieses Profil bezieht (siehe <target line="..." />, d.h. auf welches Profilvolumen geböscht wird. Es ist ein Attribut des <d>-Tags als Unterelement des <profile>-Tags, sowie des <left>- und <right>-Tags. Gibt man “site” als Böschungsziel ein, böscht das Profil auf das Geländemodell.
alphadeg	Gibt den Richtungswinkel in [°] an. Bei positiven Werten ist die Drehrichtung im Uhrzeigersinn, bei negativen entgegengesetzt des Uhrzeigersinns. Es ist ein Attribut des <left>- und <right>-Tags.

Erläuterungen zu den Attributen system und line

Im Folgenden wird ein Code-Beispiel dargestellt. Nicht relevante Inhalte werden zugunsten der Übersichtlichkeit mit “…“ ersetzt.

Erstes Volumenobjekt ist ein Oberbodenabtrag.

<volume id="..." type="TsfUCProfileTerrain" name="Oberbodenabtrag" info="...">
  <target line="topsoil" />
  <terraindelta left="-17.41" right="26.58" depth="-0.3"/>
</volume>

Beim Oberbodenabtrag wird nicht explizit angegeben (kein system- und line-Attribut im <terraindelta>-Tag), auf welche Volumenobjekthöhe sich seine eigene Höhe bezieht. Deswegen wird der einfachste Fall angenommen, der bedeutet, dass sich das Volumenobjekt auf die Höhe der referenzierten Achse bezieht. D.h. dass die Höhe und Breite des Oberbodenabtrags sich direkt auf die Höhe und Lage der Achse beziehen.

Im <target>-Tag wird mit dem Attribut line = "topsoil" angegeben, welcher Name für line in anderen Profilvolumen verwendet werden muss, um als Höhenreferenz genutzt zu werden.

Das zweite Volumenobjekt ist ein Haufwerk.

<volume id="..." type="TsfUCProfileSloped" name="Haufwerk" info="...">
  <target line="pile"/>
  <profile>
    <d t="-0.43" z="2.0" ftag="base" system="cableroute" line="topsoil"/>
    <d t="0.43" z="2.0" ftag="base" system="cableroute" line="topsoil"/>
   </profile>
   <left alphadeg="45.0" z="0.0" system="cableroute" line="topsoil"/>
   <right alphadeg="-45.0" z="0.0" system="cableroute" line="topsoil"/>
</volume>

Das Haufwerk bezieht sich auf das System cableroute (system = "cableroute" im <right>- und <left>-Tag), d.h. das Profilvolumen vergleicht zuerst, ob das Volumenobjekt, auf das referenziert wird, eine cableroute ist. Wenn ja, dann wird überprüft, ob sich ein Volumen mit der Bezeichnung topsoil daran befindet. Wenn keine Übereinstimmung mit dem System vorliegt, dann wird an dem übergeordneten Volumenobjekt ein Vergleich vorgenommen. In diesem Fall besteht eine Übereinstimmung. Das line-Attribut der <left>- und <right>-Tags fragt nach topsoil. Im ersten Volumenobjekt enthält das line-Attribut des <target>-Tags topsoil als Wert. Somit besteht eine Übereinstimmung und es wird dieser Höhenbezug verwendet.

Gibt es mehrere Systeme mit dem gleichen Namen, nimmt es immer das, welches zuerst gefunden wird.

Beispiele für die praktische Anwendung:

• Einzelnes Haufwerk

• Baustraße

Geböschtes Profil mit Mindestdeckung über der Gradiente

Das geböschte Profil mit Mindestdeckung über der Gradiente erweitert das geböschte Profil. Die Erweiterung besteht darin, dass die Gradiente durch die Angabe der Mindestdeckung um diesen Betrag nach unten gedrückt wird. Damit wird sichergestellt, dass eine ausreichende Deckung der Gradiente erreicht wird.

<volume id="..." type="TsfUCProfileTrench" name="..." info="..." system="...">
  <target line="..."/>
  <profile>
    <d t="..." z="..."/>
    <d t="..." z="..."/>
  </profile>
  <left alphadeg="..." system="..." line="..." />
  <right alphadeg="..." system="..." line="..." />
  <constraints>
     <d t="..." z="..."/>
     <d t="..." z="..."/>
  </constraints>
</volume>

Das geböschte Profil mit Mindestdeckung erweitert das geböschte Profil um die Angabe der Mindestdeckung (<constraints>-Tag). In diesem Abschnitt werden ausschließlich die Attribute des <constraints>-Tags erläutert. Für die anderen Attribute wird auf den Abschnitt “Geböschtes Profil” (siehe oben) verwiesen.

Attribute des geböschten Profils mit Mindestdeckung

Beispiele für die praktische Anwendung:

• Leerer Kabelgraben

Kreisprofil

Die Grundfläche des Kreisprofils ist kreisförmig. Es wird die Lage und der Radius angegeben.

<volume id="..." type="TsfUCProfileCircle" name="..." info="...">
  <target line="..."/>
  <circle t="..." z="..." radius="..." count="..."/>
</volume>

Attribute des Kreisprofils

Beispiele für die praktische Anwendung:

• Leerrohr

Zusammengesetzte Profilvolumen

Zusammengesetzte Profilvolumen entstehen durch die Referenzierung auf einzelne Profilvolumen. Es kann auf beliebig viele Profilvolumen verwiesen werden.

Jedes der Profilvolumen wird über ein XML-Element innerhalb des Wurzelelements (<asdatafile>) und des <sections>-Elements eingefügt. Der Grundaufbau eines jeden Elements ist gleich und wird in diesem Abschnitt erläutert.

<section id="..." name="...">
  <volumeref ref="..." dt="..." name="..." material="..."/>
  <volumeref ref="..." dt="..." name="..." material="..."/>
  [weitere Profilvolumina sind möglich]
</section>

Allgemeine Attribute der zusammengesetzten Profilvolumen

Beispiele für die praktische Anwendung:

• Standardkabelgraben

Praktische Anwendungsbeispiele

Preset für einen Oberbodenabtrag

Im Folgenden wird ein Beispiel-Preset für die Erstellung eines Oberbodenabtrags angegeben.

<volume id="{E6415734-A4EB-46F1-BDBB-933343E3197B}" type="TsfUCProfileTerrain" name="Oberbodenabtrag" info="Oberbodenabtrag mit vorgegebener Breite und einer Höhe von 0.3 m">
  <target line="topsoil" />
  <terraindelta left="-17.41" right="26.58" depth="-0.3"/>
</volume>

Beschreibung

Das Volumen besitzt eine eindeutige ID. Als Typ ist die Profilverschiebung (TsfUCProfileTerrain) festgelegt. Der Name des Presets ist “Oberbodenabtrag”. Unter info werden weiterführende Informationen angegeben.

Es handelt sich um einen Oberbodenabtrag mit einer Tiefe von 0,3 m und einer Breite von 17,41 m nach links und 26,58 m nach rechts.

Dem Attribut line des <target>-Tags ist"topsoil" zugeordnet. Möchten Sie z.B. mit einem geböschten Profil auf dieses Profil böschen, muss dieser Name entsprechend verwendet werden (siehe Beispiel).

Preset für ein einzelnes Haufwerk

Im Folgenden wird ein Beispiel-Preset für die Erstellung eines einzelnen Haufwerks angegeben.

<volume id="{BC6FE80E-AD36-4DC4-A641-FACE8E929955}" type="TsfUCProfileSloped" name="Haufwerk Unterboden (Höhe 2m, Breite 0.86m)" info="Haufwerk mit Breite 0.86m und Höhe 2m">
  <target line="pile"/>
  <profile>
    <d t="-0.43" z="2.0" ftag="base" system="cableroute" line="topsoil"/>
    <d t="0.43" z="2.0" ftag="base" system="cableroute" line="topsoil"/>
  </profile>
  <left alphadeg="45.0" system="cableroute" line="topsoil"/>
  <right alphadeg="-45.0" system="cableroute" line="topsoil"/>
</volume>

Beschreibung

Das Volumen besitzt eine eindeutige ID. Als Typ ist das geböschte Profil (TsfUCProfileTerrain) festgelegt. Der Name des Presets ist “Haufwerk Unterboden (Höhe 2m, Breite 0.86m)“. Unter info werden weiterführende Informationen angegeben.

Es handelt sich um ein Haufwerk mit einer Höhe von 2,0 m und einer Breite von jeweils 0,43 m nach links und nach rechts. Der Neigungswinkel des Profils beträgt auf beiden Seiten 45°.

Dem Attribut line des <d>-Tags ist "topsoil" zugeordnet, d.h. das Haufwerk böscht auf das Profilvolumen, das als Target-Line "topsoil" festgelegt wurde.

Preset für eine Baustraße

Im Folgenden wird ein Beispiel-Preset für die Erstellung einer Baustraße angegeben.

<volume id="{109C629A-60FF-4F6B-BC50-17929C710632}" type="TsfUCProfileSloped" name="Baustraße (Breite 5m)" info="Baustraße mit 5 m Breite">
  <target line="road"/>
  <profile>
    <d t="-2.5" z="0.3" ftag="base" system="cableroute" line="topsoil"/>
    <d t="2.5" z="0.3" ftag="base" system="cableroute" line="topsoil"/>
  </profile>
  <left alphadeg="45.0" system="cableroute" line="topsoil" />
  <right alphadeg="-45.0" system="cableroute" line="topsoil" />
</volume>

Beschreibung

Das Volumen besitzt eine eindeutige ID. Als Typ ist das geböschte Profil (TsfUCProfileTerrain) festgelegt. Der Name des Presets ist “Baustraße (Breite 5m)“. Unter info werden weiterführende Informationen angegeben.

Es handelt sich um eine Baustraße mit einer Gesamtbreite von 5,0 m (2 x 2,5 m) und einer Höhe 0,3 m.

Dem Attribut line des <d>-Tags ist "topsoil" zugeordnet, d.h. die Baustraße böscht auf das Profilvolumen, das als Target-Line “topsoil" festgelegt wurde. Der Böschungswinkel beträgt 45°.

Dem Attribut line des <target>-Tags ist "road" zugeordnet. Möchten Sie z.B. mit einem geböschten Profil auf dieses Profil böschen, muss dieser Name “road" entsprechend verwendet werden.

Für die Auswertung der Quer- und Längsneigung wird die Baustraße benutzt, deswegen ist in an dieser Stelle die Benutzung der Bezeichnung “road“ für die Target-Line obligatorisch.

Preset für einen leeren Kabelgraben

Im Folgenden wird ein Beispiel-Preset für die Erstellung eines leeren Kabelgrabens angegeben.

<volume id="{28EC66A0-D669-47A5-83B4-A43226A49991}" type="TsfUCProfileTrench" name="Kabelgraben (Überdeckung 1.40m, Tiefe 43cm unter Gradiente, 60° Böschung)" info="Kabelgraben mit Mindestüberdeckung von 1.4 (inklusive 10cm Toleranz) m, Tiefe 43cm unter Gradiente und 60° Böschungsneigung" system="cablesystem">
  <target line="trench"/>
  <profile>
    <d t="-1.05" z="-0.43"/>
    <d t="1.05" z="-0.43"/>
  </profile>
  <left alphadeg="-60.0" system="cableroute" line="topsoil" />
  <right alphadeg="60.0" system="cableroute" line="topsoil" />
  <constraints>
    <d t="-0.75" z="-1.4"/>
    <d t="0.75" z="-1.4"/>
  </constraints>
</volume>

Beschreibung

Das Volumen besitzt eine eindeutige ID. Als Typ ist das geböschte Profil (TsfUCProfileTrench) festgelegt. Der Name des Presets ist "Kabelgraben (Überdeckung 1.40m, Tiefe 43cm unter Gradiente, 60° Böschung)". Unter info werden weiterführende Informationen angegeben.

Es handelt sich um einen Kabelgraben mit einer Breite von 2,10 m und einer Gesamttiefe von 1,83 m (z vom <profile>-Tag + z vom <constraints>-Tag).

Dem Attribut line des <d>-Tags ist "topsoil" zugeordnet, d.h. die Baustraße böscht auf das Profilvolumen, das als Target-Line “topsoil" festgelegt wurde. Der Böschungswinkel beträgt 60°.

Dem Attribut line des <target>-Tags ist "trench" zugeordnet. Möchten Sie z.B. mit einem geböschten Profil auf dieses Profil böschen, muss dieser Name “trench" entsprechend verwendet werden.

Im <constraints>-Tag ist die Mindestdeckung (z) mit 1,4 m angegeben. Im <profile>-Tag ist der Abstand von der Achse zum Grabenboden mit 0,43 m angegeben (z).

Preset für ein Leerrohr

Im Folgenden wird ein Beispiel-Preset für die Erstellung eines Leerrohrs angegeben.

<volume id="{4A7D6045-925A-4597-B504-75C635B00F73}" type="TsfUCProfileCircle" name="Kabel DA 280" info="Kabel mit Durchmesser DA 280">
  <target line="cable"/>
  <circle t="0.0" z="-0.14" radius="0.14" count="5"/>
</volume>

Beschreibung

Das Volumen besitzt eine eindeutige ID. Als Typ ist das geböschte Profil (TsfUCProfileCircle) festgelegt. Der Name des Presets ist "Kabel DA 280". Unter info werden weiterführende Informationen angegeben.

Es handelt sich um ein Leerrohr mit dem Durchmesser 28 cm (radius). Es wird um 14 cm nach unten (z) verschoben. Somit befindet sich die Oberkante des Leerrohrs auf der Höhe der Gradiente. Das Attribut countgibt an, mit wie vielen Stützpunkten das Kreisprofil diskretisiert wird.

Preset für einen Standardkabelgraben

Im Folgenden wird ein Beispiel-Preset für die Erstellung eines Standardkabelgrabens mit zwei Leerrohren angegeben.

<section id="{261D48A0-6175-42B5-BF7F-3D4EA362287B}" name="Kabelgraben">
  <volumeref ref="{28EC66A0-D669-47A5-83B4-A43226A49991}" dt="0.0" name="$TRACK Graben" material="TR T_SAND1 AA $99 BA"/>
  <volumeref ref="{4A7D6045-925A-4597-B504-75C635B00F73}" dt="-0.95" name="$TRACK LL" material="CA RAL 1028"/>
  <volumeref ref="{4A7D6045-925A-4597-B504-75C635B00F73}" dt="0.95" name="$TRACK LR" material="CA RAL 1028"/>
</section>

Beschreibung

Das zusammengesetzte Volumen besitzt eine eindeutige ID. Der Name des Presets ist "Kabelgraben".

Das zusammengesetzte Volumen besteht aus drei einzelnen Profilvolumen. Diese enthalten jeweils die ID des referenzierten Einzelvolumens. In diesem Fall sind es ein Kabelgraben (TsfUCProfileTrench) und zwei Leerrohre (TsfUCProfileCircle). Das erste Volumenobjekt referenziert auf ein Kabelgrabenvolumen. Es besitzt keinen Versatz (dt = 0). Das zweite und dritte Volumenobjekt referenzieren auf ein und dasselbe Kreisvolumen. Diese beiden Volumenobjekte haben jeweils ein Versatz von 0,95 m (dt = -0,95 und dt = 0,95) nach links und rechts von der referenzierten Trassierungslinie. Es werden allen jeweils ein Name und ein Material zugeordnet.

$TRACK ist ein Platzhalter und wird mit dem Namen der Trassierungslinie ersetzt, an der das Profilvolumen angehängt wird.

Weitere Workflows:

Planung im Bereich Erdkabel

Erdkabeldefinitionsdatei verfügbar machen