Variablen

Eine Variable ist ein Platzhalter, den du in den Text der Projektbeschreibung schreiben. Beim Erstellen des Reports ersetzt VStatics ihn durch den Wert aus der gerade abgeschlossenen Berechnung. So steht in der Projektbeschreibung immer die aktuelle Zahl, ohne dass du sie von Hand nachpflegen musst.

Geschrieben wird eine Variable mit ihrem Namen zwischen zwei Prozentzeichen:

Die Gesamtlänge aller Traversen beträgt %TotalTrussLength%.

Wie und wo Variablen wirken

Ort. Variablen wirken im Textteil der Projektbeschreibung — also in der Datei <Zeichnungsname>.project unterhalb des Konfigurationsbereichs. Variablen können an jeder Stelle des Fließtextes stehen, auch mehrfach.

Eine Ausnahme im Konfigurationsbereich. Dort wirkt genau eine Variable an genau einer Stelle: %ProjectNumber% in der Zeile SubTitle. Der Platzhalter wird durch die Projektnummer ersetzt, so dass die Unterüberschrift der Projektbeschreibung die Nummer mitführt. Andere Variablen wirken im Konfigurationsbereich nicht, und %ProjectNumber% wirkt dort in keiner anderen Zeile.

Zeitpunkt. Die Ersetzung läuft einmal je Report, und zwar erst, nachdem die Berechnung vollständig durchgelaufen ist. Alle ausgegebenen Werte gehören deshalb immer zusammen und beschreiben denselben Berechnungslauf.

Nur im Report. Ersetzt wird ausschließlich beim Erstellen des Reports. Im Berechnungsprotokoll und in der Zeichnung gibt es keine Variablen.

Groß- und Kleinschreibung zählt. Der Name muss zeichengenau stimmen. %TotalLoad% wird ersetzt, %totalload% nicht.

Unbekannte Namen bleiben stehen. Ein Name, den es nicht gibt, und ein Name mit Tippfehler werden nicht ersetzt, nicht geleert und lösen keine Fehlermeldung aus — sie stehen unverändert im fertigen Report. Dasselbe gilt für eine unvollständige Schreibweise wie %TotalLoad ohne Schlusszeichen.

Name und Wert nebeneinander. Setzt du eine Variable in Anführungszeichen, wird sie nicht ersetzt; im Report erscheint nur der Name ohne die Anführungszeichen. Damit lassen sich Name und Wert nebeneinander ausgeben — genau so ist die mitgelieferte Vorlage aufgebaut:

"%TotalTrussLength%": %TotalTrussLength%

Übersicht

Die Spalte Bedeutung ist bewusst knapp; die Abgrenzung der Variablen untereinander steht in den Abschnitten darunter. Die Spalte Sektion im Log nennt die Stelle im Berechnungsprotokoll, an der sich derselbe Wert nachschlagen lässt.

Variable Einheit Bedeutung Sektion im Log Beispielwert
Projektdaten        
%ProjectNumber% Projektnummer aus dem Konfigurationsbereich A123456
Auflagerlasten        
%SupportDirectLoads% kN Eigengewicht der Auflager, die direkt nach oben in die Decke gehen [5] Eigengewicht Auflager 1.600 kN
%SupportSubRigLoads% kN Eigengewicht der Auflager, die zwei Traversenebenen verbinden [5] Eigengewicht Auflager Sub-Rig 1.500 kN
%SupportLoads% kN Eigengewicht aller Auflager [5] TOTAL Eigengewicht Auflager 3.100 kN
Einzellasten        
%TotalSingleLoadCount% Anzahl der Einzellasten, Auflager eingeschlossen [22] TOTAL Einzellasten 47
%TotalSingleLoads% kN Summe der Einzellasten, Auflagergewichte eingeschlossen [22] TOTAL Einzellasten 8.376 kN
%TotalSubRigLoadCount% Anzahl der zwischen Traversenebenen übertragenen Lasten [22] TOTAL Sub-Rig 3
%TotalSubRigLoads% kN Summe der zwischen Traversenebenen übertragenen Lasten [22] TOTAL Sub-Rig 7.568 kN
Streckenlasten und Traversen        
%TotalLineLoadLength% m Länge aller Streckenlasten [23] TOTAL 157.31 m
%TotalLineLoads% kN Summe aller Streckenlasten [23] TOTAL 5.252 kN
%TotalTrussLength% m Länge aller Traversen [3] TOTAL 64.77 m
%TotalTrussWeight% kg Eigengewicht aller Traversen [3] TOTAL 295.02 kg
%TotalTrussFactoredWeight% kg Eigengewicht aller Traversen, faktoriert [3] TOTAL 295.02 kg
Gesamtlast        
%TotalLoad% kN Summe aller Lasten im System [26] SUM 13.628 kN

Einheiten und Schreibweise

Jede Variable hat genau eine Schreibweise: den Namen zwischen zwei Prozentzeichen. Die Einheit musst du nicht dazuschreiben — sie ist Teil der Ausgabe. Ebenso ist die Anzahl der Nachkommastellen fest und richtet sich nach der Größe:

Größe Einheit Nachkommastellen Beispiel für die Ausgabe
Lasten kN 3 8.376 kN
Längen m 2 64.77 m
Gewichte kg 2 295.02 kg
Anzahlen 47

Am Beispiel des Traversengewichts sieht das so aus:

Schreibweise in der Projektbeschreibung Ausgabe im Report
%TotalTrussWeight% 295.02 kg
"%TotalTrussWeight%" %TotalTrussWeight%
%TotalTrussWeight_% %TotalTrussWeight_%
%TotalTrussWeight__% %TotalTrussWeight__%

Die erste Zeile ist der Normalfall. Die zweite ist die Schreibweise in Anführungszeichen, mit der die mitgelieferte Vorlage den Namen als Beschriftung ausgibt. Versehentlich gesetzte Anführungszeichen führen deshalb dazu, dass im Report der Name ohne seinen Wert steht — ohne Meldung und ohne dass ein Tippfehler vorläge. Dieses Muster gilt für alle Variablen gleichermaßen.


Projektdaten

%ProjectNumber% ist die einzige Variable, deren Wert du selbst bestimmst. Sie steht im Konfigurationsbereich am Anfang der Projektbeschreibung und lässt sich danach überall im Text verwenden. Alle übrigen Variablen kommen aus der Berechnung und lassen sich nicht von Hand setzen; entsprechend ist %ProjectNumber% auch die einzige Variable, deren Wert nicht im Berechnungsprotokoll steht.


Auflagerlasten

Auflagerlasten sind die Eigengewichte der Auflager — nicht die Kräfte, die an den Auflagern ankommen. Sie stehen im Berechnungsprotokoll in [5] Auflager Daten erfassen.

Unterschieden wird danach, wohin ein Auflager seine Last abgibt:

Variable welche Auflager gezählt werden Beschriftung im Log
%SupportDirectLoads% Auflager, die direkt nach oben in die Decke gehen Eigengewicht Auflager
%SupportSubRigLoads% Auflager, die zwei Traversenebenen miteinander verbinden (Sub-Rig) Eigengewicht Auflager Sub-Rig
%SupportLoads% alle Auflager TOTAL Eigengewicht Auflager

Die drei Werte hängen fest zusammen:

%SupportLoads% = %SupportDirectLoads% + %SupportSubRigLoads%

Im Beispiel also 1.600 kN an Auflagern zur Decke plus 1.500 kN an Sub-Rig-Auflagern zu 3.100 kN insgesamt.


Einzellasten

Diese vier Variablen zerlegen die Einzellasten in zwei Gruppen — je mit Anzahl und Summe. Sie stehen im Berechnungsprotokoll in [22] Verwendete Einzellasten.

  Anzahl Summe was gezählt wird
Einzellasten %TotalSingleLoadCount% %TotalSingleLoads% alle Lasten, die an den Traversen hängen, einschließlich der Auflager
Sub-Rig %TotalSubRigLoadCount% %TotalSubRigLoads% Lasten, die von einer Traversenebene auf die nächste übertragen werden

Im Beispiel trägt die Zeichnung 47 Einzellasten mit 8.376 kN und 3 übertragene Sub-Rig-Lasten mit 7.568 kN.

Die beiden …Count-Variablen zählen Einträge, nicht Gewichte, und tragen deshalb keine Einheit. Eine Einzellast mit 60 kg zählt genauso wie eine mit 6 kg.


Streckenlasten und Traversen

Die Traversenwerte stehen im Berechnungsprotokoll in [3] LongTruss Daten erfassen, die Streckenlasten in [23] Verwendete Streckenlasten.

Länge ist nicht gleich Länge

%TotalTrussLength% ist die Bauteillänge: die Summe aller Traversen, jede genau einmal. Im Beispiel sind das 24 Traversen mit zusammen 64.77 m.

%TotalLineLoadLength% ist dagegen die Summe der Längen aller Streckenlast-Einträge. Wirken auf eine Traverse mehrere Streckenlasten, geht ihre Länge mehrfach ein. Im Beispiel setzt sich der Wert so zusammen:

64.77 m (Eigengewicht) + 27.77 m (Medienlasten) + 64.77 m (Rigginglasten) = 157.31 m

Beide Werte können in einer Zeichnung zufällig übereinstimmen — nämlich dann, wenn außer dem Eigengewicht keine Streckenlast wirkt. Gleich sind sie deshalb aber nicht.

Gewicht und faktoriertes Gewicht

%TotalTrussWeight% ist das Eigengewicht aller Traversen aus der Spezifikation des Traversentyps. %TotalTrussFactoredWeight% ist derselbe Wert, multipliziert mit dem Lastunsicherheitsfaktor für Traversen.

%TotalTrussFactoredWeight% = %TotalTrussWeight% × Lastunsicherheitsfaktor Traversen

Im Beispiel steht dieser Faktor auf 1.00, deshalb zeigen beide Variablen 295.02 kg.

Zusammenhang mit %TotalLineLoads%

Das faktorierte Traversengewicht ist ein Bestandteil von %TotalLineLoads%. Der Rest sind die globalen und die automatischen Streckenlasten. Im Beispiel entsprechen die 295.02 kg Traversengewicht einem Anteil von 2.950 kN an den 5.252 kN Streckenlast; die übrigen 2.302 kN stammen aus den automatischen Streckenlasten für Medien- und Rigginglasten.

Für die Umrechnung zwischen den Einheiten rechnet VStatics mit einer Erdbeschleunigung von 10 m/s². 100 kg entsprechen damit 1 kN.


Gesamtlast

%TotalLoad% ist die Summe aller Lasten im System. Der Wert steht im Berechnungsprotokoll in [26] Punktlasten bei SUM — dort ist er im Fußblock aus genau zwei Zeilen aufgebaut:

Einzellasten     + 8.376
Streckenlasten   + 5.252
------------------------
SUM              Ʃ 13.628

Damit gilt:

%TotalLoad% = %TotalSingleLoads% + %TotalLineLoads%

Zwei Größen sind in dieser Summe nicht als eigener Summand enthalten:

  • Auflagerlasten. %SupportLoads% steckt bereits in %TotalSingleLoads%.
  • Sub-Rig-Lasten. %TotalSubRigLoads% ist keine zusätzliche Einwirkung, sondern eine bereits im System enthaltene Last, die von der unteren auf die obere Traversenebene weitergereicht wird.

Dieselbe Summe weist der Report auch in [18] System berechnen unter Modellierte Lasten aus, dort getrennt nach Einzellasten und Streckenlasten.


Weiterführend

  • Faktoren — welcher Faktor auf welchen Wert wirkt und wann

  • Projektbeschreibung — wie die Projektbeschreibung angelegt und angepasst wird

  • Log — das Berechnungsprotokoll mit allen Abschnitten, aus denen die Werte stammen