Direkt zum Inhalt

Funktionen in Variablenformeln

Modified: 11 März 2026 Tekla Structures 2026
2026
Tekla Structures

Arithmetische Operatoren

Mit arithmetischen Operatoren werden Ausdrücke kombiniert, die numerische Werte ergeben.

Operator

Beschreibung

Anmerkungen

+

Addition

Wird auch zum erstellen von Parameterzeichenfolgen verwendet.

-

Subtraktion

*

Multiplikation

Die Multiplikation ist schneller als die Division.

=D1*0.5 ist schneller als =D1/2

/

Division

Logische und Vergleichsoperatoren

Verwenden Sie logische und Vergleichsoperatoren in if-Ausdrücken. Sie können if-then-else-Ausdrücke verwenden, um auf eine Bedingung zu testen und den Wert laut Ergebnis zu setzen.

Zum Beispiel:

=if (D1>200) then 20 else 10 endif

Sie können die folgenden Operatoren in If-Ausdrücken verwenden:

Operator

Beschreibung

Beispiel

==

Beide Seiten sind gleich

!=

Seiten sind nicht gleich

<

Linke Seite ist kleiner

<=

Linke Seite ist kleiner oder gleich

>

Rechte Seite ist kleiner

>=

Rechte Seite ist kleiner oder gleich

&&

Logisch UND

Beide Bedingungen müssen wahr sein.

=if (D1==200 && D2<40) then 6 else 0 endif

Wenn D1 = 200 ist und D2 < 40, ist das Ergebnis 6, andernfalls 0.

||

Logisch ODER

Nur eine Bedingung muss wahr sein.

=if (D1==200 || D2<40) then 6 else 0 endif

Wenn D1 200 oder D2 kleiner als 40 ist, ist das Ergebnis 6, andernfalls 0.

Referenzfunktionen

Mit Referenzfunktionen beziehen Sie sich auf die Eigenschaft eines anderen Objekts, z. B. die Blechdicke eines Nebenteils. Tekla Structures verweist auf Systemebene auf das Objekt, d. h. eine Änderung der Objekteigenschaft zieht auch eine Änderung des Referenzfunktionswertes nach sich.

Funktion

Beschreibung

Beispiel

fTpl("template attribute", "object GUID")

Ergibt den Vorlagenattributwert eines Objekts, das einen gegebenen Objekt-GUID hat.

=fTpl("WEIGHT","ID50B8559A-0000-010B-3133-353432373038")

Ergibt das Gewicht eines Objekts mit dem GUID ID50B8559A-0000-010B-3133-353432373038.

fP("user-defined attribute", "object GUID")

Ergibt den Wert des benutzerdefinierten Attributs eines Objekts, das einen gegebenen Objekt-GUID hat.

=fP("comment", "ID50B8559A-0000-010B-3133-353432373038")

Ergibt den Kommentar für das benutzerdefinierte Attribut eines Objekts mit dem GUID ID50B8559A-0000-010B-3133-353432373038.

fValueOf("parameter")

Ergibt den Wert des Parameters.

Lautet die Gleichung =P2+"*"+P3, ist das Ergebnis P2*P3

Bei =fValueOf("P2")+"*"+fValueOf("P3"), wobei P2=780 und P3=480, lautet das Ergebnis 780*480

fRebarCatalogValue(BarGrade, BarSize, Usage, FieldName)

Liefert den Katalogwert des Bewehrungsstabs eines Objekts.

Usage kann entweder 2 („Verbindung“) oder 1 sein („Haupt“).

FieldName muss einer der folgenden Parameter sein:

  • 0 NominalDiameter
  • 1 ActualDiameter
  • 2 Weight
  • 3 MinRadius
  • 4 Hook1Radius
  • 5 Hook1Angle
  • 6 Hook1Length
  • 7 HookRadius
  • 8 Hook2Angle
  • 9 Hook2Length
  • 10 Hook3Radius
  • 11 Hook3Angl
  • 12 Hook3Length
  • 13 Area

fRebarCatalogValue("A500HW", "10", 1, 2)

liefert die Größe, die Anwendung und das Gewicht eines Objekts mit Bewehrungsstabgüte A500HW.

ASCII-Datei als Referenzfunktion

Sie können auf ASCII-Dateien verweisen, um Daten zu erhalten. Tekla Structures sucht die Dateien in der folgenden Reihenfolge:

  1. Modellordner

  2. ..<model folder>\CustomComponentDialogFiles

  3. Projektordner (XS_PROJECT)

  4. Firmenordner (XS_FIRM)

  5. Systemordner (XS_SYSTEM)

  6. Profildatenbankordner (XS_PROFDB)

  7. <model folder>\cr (kaltgewalzte Bauteile)

Die verwendeten Parameter sind: Dateiname, Schlüsselwert der Zeile, Spaltennummer, Trennzeichen(e), leere Spalten zulassen. Das Format zum Einlesen der Dateien lautet wie folgt:

fVF("filename", "key_value_of_row", column_number, "separator(s)", FALSE)

  • Schlüsselwert einer Zeile: Eine eindeutige Schlüssel-Wert-Zeichenfolge, die zum Auswählen der Zeile in der Datei verwendet wird. Bei der Suche wird zwischen Groß- und Kleinschreibung unterschieden. Die Zeichenfolge darf keine Leerzeichen, Tabulatoren oder eines der angegebenen Trennzeichen enthalten.
  • Spaltennummer: Ein Index beginnend mit 1, der den Wert aus der gewählten Zeile auswählt. Index 1 entspricht dem Schlüsselwert.
  • Trennzeichen: Wahlparameter. Das Trennzeichen besteht aus einem oder mehreren Zeichen, die zur Datentrennung verwendet werden. Die Standardtrennzeichen sind Leerzeichen und Tabulatortaste.

    Die angegebene Zeichenfolge wird als eine Reihe von Zeichen interpretiert, die jeweils als einzelnes Trennzeichen und nicht als Gruppe behandelt werden. "\t" stehet dabei für einen Tabulator. Zum Beispiel bedeutet "\t", dass Leerzeichen und Tabulatoren als Trennzeichen behandelt werden, und ",.;" bedeutet, dass Komma, Punkt und Semikolon als Trennzeichen behandelt werden.

  • Leere Spalten zulassen: Optionaler Parameter. Die Standardeinstellung für das Zulassen leerer Spalten ist FALSE.

    Wenn sie auf TRUE gesetzt ist, werden leere Einträge aus der Dateizeile berücksichtigt, wenn die Funktion aufgelöst wird. Fehlt sie oder ist sie auf FALSE eingestellt, werden leere Einträge entfernt.

Beispiel

Die =fVF("Overlap.dat", "MET-202Z25", 5) Funktion befindet sich im Feld Formel im Dialogfeld Variablen . Die Funktion ergibt den Wert 16.0 für das Profil MET-202Z25 aus der Datei Overlap.dat.

  1. Schlüsselwert der Zeile (MET-202Z25)
  2. Spaltennummer (5)

Weitere Informationen finden Sie im Supportartikel Lesen von Daten aus einer Textdatei in benutzerdefinierten Komponenten .

Rechenfunktionen

Verwenden Sie Rechenfunktionen, um komplexere mathematische Ausdrücke zu erstellen.

Funktion

Beschreibung

Beispiel

fabs(Parameter)

Gibt den absoluten Wert des Parameters zurück.

=fabs(D1) ergibt den Wert 15,

Wenn D1 = -15

exp(power)

Ergibt die Potenzzahl von e

e ist die eulersche Zahl.

=exp(D1) ergibt den Wert 7.39,

wenn D1 = 2

ln(Parameter)

Gibt den natürlichen Logarithmus des Parameters zurück (Basiszahl e).

=ln(P2) ergibt den Wert 2.71,

wenn P2 = 15

log(Parameter)

Gibt den Logarithmus des Parameters zurück (Basis 10).

=log(D1) ergibt den Wert 2,

wenn D1 = 100

sqrt(Parameter)

Gibt die Quadratwurzel des Parameters zurück.

=sqrt(D1) ergibt den Wert 4,

wenn D1 = 16

mod(Dividende, Teiler)

Gibt den Modulo der Division zurück.

=mod(D1, 5) ergibt den Wert 1,

wenn D1 = 16

pow(Basiszahl, Potenzzahl)

Ergibt die Basiszahl mit der spezifizierten Potenzzahl

=pow(D1, D2) ergibt den Wert 9,

Wenn D1 = 3 und D2 = 2

hypot(Seite1,Seite2)

Gibt die Hypotenuse zurück.

(1): Seite1

(2): Hypotenuse

(3): Seite2

=hypot(D1, D2) ergibt den Wert 5,

Wenn D1 = 3 und D2 = 4

n!(Parameter)

Gibt die Fakultät des Parameters zurück.

=n!(P2) ergibt den Wert 24,

Wenn P2 = 4

(1*2*3*4)

rund(Parameter, Genauigkeit)

Gibt den Parameter mit einer bestimmten Genauigkeit abgerundet zurück

=round(P1, 0.1) ergibt den Wert 10.600,

Wenn P1 = 10.567

PI

Ergibt den Wert von Pi mit 31 Nachkommastellen

=PI ergibt den Wert 3.1415926535897932384626433832795,

Statistische Funktionen

Mit statistischen Funktionen können Sie Summen und Durchschnitte berechnen sowie Werte runden.

Funktion

Beschreibung

Beispiel (P1 = 1.4 P2 = 2.3)

ceil()

Gibt die kleinste Ganzzahl größer oder gleich dem Parameter zurück.

=ceil(P1) ergibt den Wert 2,

floor()

Gibt die größte Ganzzahl kleiner gleich dem Parameter zurück.

=floor(P1) ergibt den Wert 1,

min()

Gibt den kleinsten Parameter zurück

=min(P1, P2) ergibt den Wert 1.4,

max()

Gibt den größten Parameter zurück

=max(P1, P2) ergibt den Wert 2.3,

sum()

Summe der Parameter

=sum(P1, P2) ergibt den Wert 3.7,

sqsum()

Summe der Parameter im Quadrat: (Parameter1)2 + (Parameter2)2

=sqsum(P1, P2) ergibt den Wert 7.25,

ave()

Gibt den Durchschnitt der Parameter zurück.

=ave(P1, P2) ergibt den Wert 1.85,

sqave()

Mittelwert der Parameter im Quadrat

=sqave(P1, P2) ergibt den Wert 3.625,

Beispiel: Statistische Funktionen für Decke und Boden

In diesem Beispiel stehen die folgenden Parametervariablen zur Verfügung:

  • Trägerlänge: P1 = 3500
  • Pfostenabstand: P2 = 450

P1 / P2 = 7.7778

Mit den statistischen Funktionen ceil und floor können Sie den Wert runden und anschließend auf die Anzahl der Trägerpfosten anwenden:

  • =ceil(P1/P2) ergibt den Wert 8,
  • =floor(P1/P2) ergibt den Wert 7,

Konvertierungsfunktionen für Datentypen

Mit den Konvertierungsfunktionen für Datentypen konvertieren Sie Werte in einen anderen Datentyp. Konvertierungsfunktionen führen Konvertierungen zwischen den drei unterstützten Datentypen durch: Integers, Doubles und Strings.

Funktion

Beschreibung

Beispiel

int()

Konvertiert Daten in Ganzzahlen.

Hilfreich insbesondere zur Berechnung von Profilbemaßungen:

=int(100.0132222000) ergibt 100, wenn die Dezimalstellen im Dialogfeld Optionen auf 0 eingestellt sind.

double()

Konvertiert Daten in Doppel.

string()

Konvertiert Daten in Zeichenfolge.

imp()

Konvertiert englische Maßeinheiten.

Verwenden Sie diese Funktion in Berechnungen anstelle von imperialen Einheiten. Sie können imperiale Einheiten nicht direkt in Berechnungen verwenden.

Bei den folgenden Beispielen ist für die Längeneinheit im Dialogfeld Optionen auf mm eingestellt und für die Dezimalstellen wurde 2 eingegeben.

=imp(1,1,1,2), d. h.:1 Fuß 1 1/2 Zoll ergibt 342.90 mm.

=imp(1,1,2), d. h.: 1 1/2 Zoll ergibt 38.10 mm.

=imp(1,2), d. h.: 1/2 Zoll ergibt 12.70 mm.

=imp(1), d. h.: 1 Zoll ergibt 25.40 mm.

=3’/3" ist nicht möglich, jedoch ist =imp(36)/imp(3) zulässig.

vwu(Wert, Einheit)

Konvertiert die Längen- und Winkelwerte. Die verfügbaren Einheiten sind:

  • „ft“ („Fuß“)
  • „in“ („Zoll“)
  • „m“
  • „cm“
  • „mm“
  • „rad“
  • „deg“

=vwu(4.0,"in") gibt 101,60 mm zurück, wenn die Längeneinheit im Dialogfeld Optionen auf mm und Dezimalstellen auf 2 festgelegt sind.

=vwu(2.0,"rad") gibt 114,59 Grad zurück, wenn der Winkel im Dialogfeld Optionen auf Grad und Dezimalstellen auf 2 festgelegt sind.

Beachten Sie, dass Tekla Structures beim automatischen Konvertieren der Winkelmaße von Grad in Radiant diese mit PI/180 multipliziert.

Um sicherzustellen, dass die Winkel korrekt berechnet werden, konvertieren Sie mittels vwu("rad") Bogenmaße in Grad. Dies ermöglicht es Tekla Structures , sie während der Berechnungen wieder in Bogenmaße umzuwandeln.

Anmerkung:

Die Einheiten richten sich nach den Einstellungen unter Datei > Einstellungen > Optionen > Einheiten und Dezimalstellen.

String-Operationen

Mit Zeichenfolge-Operationen bearbeiten Sie Zeichenfolgen. Zeichenfolgen müssen in Variablenformeln in Anführungszeichen gesetzt werden.

Operation

Beschreibung

Beispiel (P1 = „PL100*10“)

match(Parameter1, Parameter2)

Ergibt den Wert „1“, wenn die Parameter gleich sind und „0“ ungleich ist.

Sie können mit der Abgleichungsfunktion auch die Platzhalter *, ? und [ ] verwenden.

=match(P1, "PL100*10") ergibt den Wert 1,

Nehmen Sie alle Profile an, die mit „PFC“ beginnen: =match(P4, "PFC*")

Es werden Profile akzeptiert, die mit PFC beginnen und bei denen die Höhe mit 2, 3, 4 oder 5 anfängt: =match(P4, "PFC[2345]*")

Es werden Profile akzeptiert, die mit PFC beginnen und bei denen die Höhe mit 200, 300, 400 oder 500 sowie die Breite mit 7 anfängt: =match(P4, "PFC[2345]00?7*")

length(parameter)

Ergibt die Anzahl der Zeichen im Parameter.

=length(P1) ergibt den Wert 8,

find(Parameter, String)

Ergibt die Bestellnummer (ab Null aufwärts) des angegebenen Strings oder, wenn der Parameter den angegebenen String nicht findet, den Wert „-1“.

=find(P1, "*") ergibt den Wert 5,

getat(Parameter, n)

Ergibt das n-te Zeichen (ab Null aufwärts) des Parameters.

=getat(P1, 1) gibt „L“ zurück.

setat(Parameter, n, Zeichen)

Stellt das n-te Zeichen (ab Null aufwärts) auf das spezifizierte Zeichen im Parameter ein.

=setat(P1, 0, "B") gibt den Wert „BL100*10“ zurück

mid(String, n, x)

Ergibt x Zeichen des Strings ab dem n-ten Zeichen (ab Null aufwärts). Wenn Sie das letzte Argument (x) weglassen, ergibt sich der letzte Teil des Strings.

=mid(P1,2,3) gibt den Wert „100“ zurück.

reverse(String)

Kehrt den jeweiligen String um.

=reverse(P1) gibt „01*001LP“ zurück.

Beispiel 1

Um die Profilgröße PL100*10 mit zwei Variablen P2 = 100 und P3 = 10 zu definieren, geben Sie die folgende Formel ein:

="PL"+P2+"*"+P3

Beispiel 2

Tekla Structures behandelt Schraubenabstände als Abstände. Um einen Schraubenabstand zu definieren, setzen Sie Werttyp auf Abstände und geben Sie die folgende Formel ein:

=P1+" "+P2

Daraus ergibt sich in 100 200, wenn P1 = 100 (Länge) und P2 = 200 (Länge) ist.

Trigonometrische Funktionen

Mit trigonometrischen Funktionen können Sie Winkel berechnen.

Anmerkung:

Wenn Sie trigonometrische Funktionen in Variablenformeln verwenden, müssen Sie einen Präfix einbeziehen/mit einbeziehen, um die Einheit zu definieren. Wenn Sie keinen Präfix angeben, verwendet Tekla Structures als Standardeinheit Radiant.

  • d ist Grad. Beispiel: sin(d180).
  • r ist Radiant (Standard). Beispiele: sin(r3.14) oder sin(3.14).

Funktion

Beschreibung

Beispiel

sin()

Gibt den Sinuswert zurück.

=sin(d45) ergibt den Wert 0.71,

cos()

Gibt den Kosinuswert zurück.

=cos(d45) ergibt den Wert 0.71,

tan()

Gibt den Tangenswert zurück.

=tan(d45) ergibt den Wert 1.00,

asin()

Die Umkehrfunktion von sin() ergibt den Wert in Radiant

=asin(1) ergibt 1.571 rad

acos()

Die Umkehrfunktion von cos() ergibt den Wert in Radiant

=acos(1) gibt 0 rad zurück

atan()

Die Umkehrfunktion von tan() ergibt den Wert in Radiant

=atan(1) gibt 0.785 rad zurück.

sinh()

Ergibt den Sinus der Hyperbel

=sinh(d45) ergibt den Wert 0.87,

cosh()

Ergibt den Kosinus der Hyperbel

=cosh(d45) ergibt den Wert 1.32,

tanh()

Ergibt den Tangens der Hyperbel

=tanh(d45) ergibt den Wert 0.66,

atan2()

Gibt den Winkel zurück, dessen Tangens der Quotient der beiden Zahlen ist. Ergibt den Wert in Radiant

=atan2(1,3) ergibt den Wert 0.32,

Marktgrößefunktion

Wählen Sie in der Marktgrößefunktion einer benutzerdefinierten Komponente eine geeignete Blechabmessung (normalerweise Blechdicke) aus den verfügbaren Marktgrößen aus. Beispielsweise sollte die Dicke einer Bleches dem Steg eines Trägers entsprechen.

Funktion

Beschreibung

Beispiel

fMarketSize(Material, Dicke, Extraschritt)

Ergibt die nächste verfügbare Marktgröße für das Material aus der Datei marketsize.dat je nach der von Ihnen angegebenen Dicke.

Die Datei muss sich im Verzeichnis ..\environments\your_environment\profil oder im Systemverzeichnis befinden.

Als Zusatzschritt geben Sie eine Zahl ein, um die Erhöhung zur nächsten Größe (standardmäßig: 0) zu definieren.

=fMarketSize("S235JR", 10, 0)

Beispiel

In diesem Beispiel sind in marketsize.dat folgende Daten enthalten:

S235JR,6,9,12,16,19,22
SS400,1.6,2.3,3.2,4.5,6,9,12,16,19,22,25,28,32,38
DEFAULT,6,9,12,16,19,22,25,28,32,38

Das erste Element in einer Zeile ist die Materialgüte, gefolgt von den verfügbaren Blechdicken in Millimetern. In der Zeile DEFAULT werden die Dicken aufgelistet, die in anderen Materialgüten erhältlich sind.

Mit den obigen Daten ergäben die Funktionen =fMarketSize("S235JR",10,0) 12 und =fMarketSize("S235JR",10,1) 16 (um eine Größe erhöht).

Rahmenbedingungsfunktionen

Aus den Rahmenbedingungsfunktionen ergeben sich der abgeschrägte, der geneigte und der gekippte Winkel des Nebenträgers in Bezug zum Hauptteil (Stütze oder Träger).

Funktion

Beschreibung

Beispiel

fAD("Schrägstellung", GUID)

Ergibt den Schrägstellungswinkel für das Nebenteil mit dem gegebenen GUID.

=fAD("skew","ID50B8559A-0000-010B-3133-353432373038") ergibt den Wert 45,

ID50B8559A-0000-010B-3133-353432373038 ist der GUID des Nebenteils, das einen 45-Grad-Winkel zum Hauptteil hat.

fAD("Neigung", GUID)

Ergibt den Neigungswinkel für das Nebenteil mit dem gegebenen GUID.

=fAD("slope","ID50B8559A-0000-010B-3133-353432373038")

fAD("Kipp", GUID)

Ergibt den Kippwinkel für das gedrehte Nebenteil mit dem gegebenen GUID.

=fAD("cant","ID50B8559A-0000-010B-3133-353432373038")

Anmerkung:
  • Diese Funktionen ergeben keine positiven und negativen Neigungs- und Schrägstellungswerte. Mit diesen Funktionen können weder Aufwärts- oder Abwärtsneigungen noch Links- oder Rechtsschrägstellungen bestimmt werden.

  • Der maximale Schrägstellungswinkel beträgt 45 Grad.

  • Tekla Structures berechnet die Winkel in 2D, damit Schräg- und Neigungswinkel getrennt voneinander angeordnet werden. Der Schrägstellungswinkel wird beispielsweise nicht berücksichtigt, wenn der Neigungswinkel berechnet wird, was bedeutet, dass der Wert des Neigungswinkels gleich bleibt, unabhängig von der Drehung des Nebenteils um das Hauptteil.

    Um die tatsächliche 3D-Neigung mit der eingeschlossenen Schrägstellung herauszufinden, können Sie die folgende mathematische Formel verwenden:

    TRUE_SLOPE = atan( tan(SLOPE) * cos(SKEW))

Beispiel 1

Neigung und Schrägstellung sind relativ zu einem Trägerrahmen in einer Stütze.

Seitenansicht Träger-Stützen-Verbindung Draufsicht Träger-Stützen-Verbindung

  1. Spalte
  2. Träger
  3. Neigung
  4. Nicht rechtwinklig

Beispiel 2

Wenn Sie mit zwei Trägern arbeiten, ist Neigung die horizontale Schräge des Trägerrahmens in den anderen Träger, und die vertikale Neigung des Trägers in Bezug zum Hauptteil ist der schräge Winkel.

Träger-an-Träger-Seitenansicht Träger-zu-Träger-Draufsicht

  1. Nicht rechtwinklig
  2. Neigung
Absenden

Table of Contents