derivenode, Eigenschaften

Letzte Aktualisierung: 11. Feb. 2025

Symbol für Ableitungsknoten Der Ableitungsknoten ändert Datenwerte oder erstellt neue Felder aus einem oder mehreren bestehenden Feldern. Er erstellt Felder vom Typ "Formel", "Flag", "Nominal", "Status", "Anzahl" und "Bedingt".

Beispiel 1

# Create and configure a Flag Derive field node
node = stream.create("derive", "My node")
node.setPropertyValue("new_name", "DrugX_Flag")
node.setPropertyValue("result_type", "Flag")
node.setPropertyValue("flag_true", "1")
node.setPropertyValue("flag_false", "0")
node.setPropertyValue("flag_expr", "'Drug' == \"drugX\"")

# Create and configure a Conditional Derive field node
node = stream.create("derive", "My node")
node.setPropertyValue("result_type", "Conditional")
node.setPropertyValue("cond_if_cond", "@OFFSET(\"Age\", 1) = \"Age\"")
node.setPropertyValue("cond_then_expr", "(@OFFSET(\"Age\", 1) = \"Age\" >< @INDEX")
node.setPropertyValue("cond_else_expr", "\"Age\"")

Beispiel 2

Dieses Script setzt voraus, dass zwei numerische Spalten mit den Namen XPosund YPosvorhanden sind, die die X- und Y-Koordinaten eines Punkts darstellen (z. B. wo ein Ereignis stattgefunden hat). Das Script erstellt einen Ableitungsknoten, der eine georäumliche Spalte aus den X- und Y-Koordinaten berechnet, die diesen Punkt in einem bestimmten Koordinatensystem darstellen:

stream = modeler.script.stream()
# Other stream configuration code
node = stream.createAt("derive", "Location", 192, 96)
node.setPropertyValue("new_name", "Location")
node.setPropertyValue("formula_expr", "['XPos', 'YPos']")
node.setPropertyValue("formula_type", "Geospatial")
# Now we have set the general measurement type, define the
# specifics of the geospatial object
node.setPropertyValue("geo_type", "Point")
node.setPropertyValue("has_coordinate_system", True)
node.setPropertyValue("coordinate_system", "ETRS_1989_EPSG_Arctic_zone_5-47")

Tabelle 1. Eigenschaften von "derivenode"
`derivenode`Eigenschaften	Datentyp	Eigenschaftsbeschreibung
`new_name`	Zeichenfolge	Name des neuen Felds.
`mode`	`Single` `Multiple`	Gibt eines oder mehrere Felder an.
`fields`	Liste	Wird nur im Modus "Multiple" (Mehrere) zur Auswahl mehrerer Felder verwendet.
`name_extension`	Zeichenfolge	Gibt die Erweiterung für die neuen Feldnamen an.
`add_as`	`Suffix` `Prefix`	Fügt die Erweiterung als Präfix (am Anfang) oder als Suffix (am Ende) des Feldnamens ein.
`result_type`	`Formula` `Flag` `Set` `State` `Count` `Conditional`	Die sechs Typen neuer Felder, die Sie erstellen können.
`formula_expr`	Zeichenfolge	Ausdruck zum Berechnen eines neuen Feldwerts in einem Ableitungsknoten.
`flag_expr`	Zeichenfolge
`flag_true`	Zeichenfolge
`flag_false`	Zeichenfolge
`set_default`	Zeichenfolge
`set_value_cond`	Zeichenfolge	Wird zur Bereitstellung der Bedingung, die einem bestimmten Wert zugeordnet ist, strukturiert.
`state_on_val`	Zeichenfolge	Dient zur Angabe des Werts für das neue Feld, wenn die Bedingung für "On" (Ein) erfüllt ist.
`state_off_val`	Zeichenfolge	Dient zur Angabe des Werts für das neue Feld, wenn die Bedingung für "Off" (Aus) erfüllt ist.
`state_on_expression`	Zeichenfolge
`state_off_expression`	Zeichenfolge
`state_initial`	`On` `Off`	Weist jedem Datensatz des neuen Felds den Anfangswert `On`oder `Off`zu. Dieser Wert kann sich ändern, wenn die einzelnen Bedingungen erfüllt werden.
`count_initial_val`	Zeichenfolge
`count_inc_condition`	Zeichenfolge
`count_inc_expression`	Zeichenfolge
`count_reset_condition`	Zeichenfolge
`cond_if_cond`	Zeichenfolge
`cond_then_expr`	Zeichenfolge
`cond_else_expr`	Zeichenfolge
`formula_measure_type`	`Range / MeasureType.RANGE` `Discrete / MeasureType.DISCRETE` `Flag / MeasureType.FLAG` `Set / MeasureType.SET` `OrderedSet / MeasureType.ORDERED_SET` `Typeless / MeasureType.TYPELESS` `Collection / MeasureType.COLLECTION` `Geospatial / MeasureType.GEOSPATIAL`	Diese Eigenschaft kann zum Definieren der dem abgeleiteten Feld zugeordneten Messung verwendet werden kann. An die Setter-Funktion kann entweder eine Zeichenfolge oder einer der `MeasureType`-Werte übergeben werden. Die Getter-Funktion gibt immer für die `MeasureType`-Werte Daten zurück.
`collection_measure`	`Range / MeasureType.RANGE` `Flag / MeasureType.FLAG` `Set / MeasureType.SET` `OrderedSet / MeasureType.ORDERED_SET` `Typeless / MeasureType.TYPELESS`	Bei Sammlungsfeldern (Listen mit einer Tiefe von 0) definiert diese Eigenschaft den Messtyp, der den zugrunde liegenden Werten zugeordnet ist.
`geo_type`	`Point` `MultiPoint` `LineString` `MultiLineString` `Polygon` `MultiPolygon`	Bei georäumlichen Feldern definiert diese Eigenschaft den Typ des durch dieses Feld dargestellten georäumlichen Objekts. Dies sollte konsistent mit der Listentiefe der Werte sein.
`has_coordinate_system`	Boolesch	Bei georäumlichen Feldern definiert diese Eigenschaft, ob dieses Feld ein Koordinatensystem hat
`coordinate_system`	Zeichenfolge	Bei georäumlichen Feldern definiert diese Eigenschaft das Koordinatensystem für dieses Feld.