Subregion

Befehle, die das Lesen und Zuweisen der Werte und Eigenschaften von Subregionen ermöglichen.

Geometrische Größen (Koordinaten, Längen und Flächen) entsprechen der global gewählten Längeneinheit (gobal_unit, siehe General settings). Übergebene oder zurückgelieferte Vektoren (Komponenten der Vektoren) beziehen sich, wenn in der Funktionsbeschreibung nicht explizit angegeben, auf das kartesisches System. Zur einfachen Umrechnung zwischen unerschiedlichen Bezugssystemen stehen Funktionen zur Coordinate transformation zur Verfügung.

Übersicht

---

Bezeichner	Anzahl Werte	Einheit	Zugriff get/set	Beschreibung
valid	1		g	Gültigkeit
key	1		g	Nummer der Subregion
type	1		g	Typ der Subregion
col	1		g	Farbe
sekeys	[N]		g	Nummern aller N Superelemente der Subregion
wbkey	1		g	Nummer der Wicklung zu der die Subregion gehört
nturns	1		g	Leiterzahl
area	1	gu²	g	Fläche der Subregion
curdir	1		g	Stromrichtung bzw. Wickelsinn
cur	2	A	g	(Wirbel)strom (Realteil, Imaginärteil)
curd	2	A/mm²	g	(Wirbel)stromdichte (Realteil, Imaginärteil)
curlos	1	W/gu	g	(Wirbelstrom)verluste (Mittelwert) pro Längeneinheit
volt	2	V/gu	g	Spannung (Realteil, Imaginärteil)
rlength	1		s	Relative Länge

gu = globale Längeneinheit

Befehlsbeschreibung

---

Function: key = get_sreg_key ( x, y )

Gibt die Nummer einer Subregion zurück, die über die kartesischen Koordinaten x und y adressiert wird.

Parameter

[in] x Coordinate 1

[in] y Coordiante 2

Return values

key Subregion number

Beispiel

key = get_sreg_key(x,y)          -- Get the subregion number
print("subregion key = %d",key)  -- Output to shell

Command: get_sreg_keys ( x, y, “var” )

Gibt die Nummern aller Subregionen einer Wicklung zurück. Die Wicklung wird über die kartesischen Koordinaten x und y adressiert.

Parameter

[in] x Coordinate 1

[in] y Coordiante 2

[out] var Bezeichner des Arrays in dem die Subregionnummern zurückgegeben werden

Beispiel

get_sreg_keys(x,y,"keys")  -- Get all subregions of the winding addressed by x,y
N = table.getn(keys)       -- Number of elements in array

Command: get_sreg_keys ( “var” )

Gibt die Nummern aller Subregionen des Modells zurück.

Parameter

[out] var Bezeichner des Arrays in dem die Subregionnummern zurückgegeben werden

Beispiel

get_sreg_keys("keys")      -- Get all subregions of the model
N = table.getn(keys)       -- Number of elements in array

Function: d1, d2, … = get_sreg_data ( “identifier”, key )

Liest Daten einer Subregion und gibt diese zurück.

Parameter

[in] identifier Art der auszulesenden Daten (siehe Tabelle)

[in] key Subregion number

Return values

d1 First return value

d2 Secodn return value

Beispiel: Ermittlung der Fläche einer Subregion

A = get_sreg_data("area",key)

Alternativ zu key kann die Subregion auch über kartesische Koordinaten in der globalen Einheit adressiert werden.

A = get_sreg_data("area",x,y)

Command: set_sreg_data ( “identifier”, key, d1, d2, … )

Weist einer Subregion die angegebenen Eigenschaften zu.

Parameter

[in] identifier Art der zuzuweisenden Eigenschaft (siehe Tabelle)

[in] key Subregion number

[in] d1 Firsrt refering value

[in] d2 Second refering value (optional)

Beispiel: Vorgabe der relativen Längen eines Superelements von 125%

set_sreg_data("rlength",key,1.25)