propriétés de derivenode

Dernière mise à jour : 11 févr. 2025

Icône Noeud Calculer Le noeud Calculer modifie les valeurs de données ou crée des nouveaux champs à partir d'un ou de plusieurs champs existants. Il crée des champs de type formule, indicateur, ensemble, nominal, statistiques, comptage et conditionnel.

Exemple 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\"")

Exemple 2

Ce script suppose qu'il existe deux colonnes numériques appelées XPos et YPos qui représentent les coordonnées X et Y d'un point (par exemple, où un événement a eu lieu). Le script crée un noeud Calculer qui calcule une colonne géospatiale depuis les coordonnées X et Y représentant ce point dans un système de coordonnées spécifique :

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")

Tableau 1. propriétés de derivenode
`derivenode`propriétés	Type de données	Description de la propriété
`new_name`	chaîne	Nom du nouveau champ.
`mode`	`Single` `Multiple`	Spécifie un ou plusieurs champs.
`fields`	list	Utilisé en mode Multiple uniquement pour sélectionner plusieurs champs.
`name_extension`	chaîne	Indique l'extension des nouveaux noms de champ.
`add_as`	`Suffix` `Prefix`	Ajoute l'extension du nom de champ en tant que préfixe (au début) ou en tant que suffixe (à la fin).
`result_type`	`Formula` `Flag` `Set` `State` `Count` `Conditional`	Les six types de nouveau champ que vous pouvez créer.
`formula_expr`	chaîne	Expression de calcul de la valeur du nouveau champ dans un noeud Dériver
`flag_expr`	chaîne
`flag_true`	chaîne
`flag_false`	chaîne
`set_default`	chaîne
`set_value_cond`	chaîne	Propriété structurée (définition de la condition associée à une valeur donnée).
`state_on_val`	chaîne	Indique la valeur du nouveau champ si la condition Activé est vérifiée.
`state_off_val`	chaîne	Indique la valeur du nouveau champ si la condition Désactivé est vérifiée.
`state_on_expression`	chaîne
`state_off_expression`	chaîne
`state_initial`	`On` `Off`	Affecte à chaque enregistrement du nouveau champ une valeur initiale de `On` ou `Off`. Cette valeur peut changer au fur et à mesure que les conditions sont respectées.
`count_initial_val`	chaîne
`count_inc_condition`	chaîne
`count_inc_expression`	chaîne
`count_reset_condition`	chaîne
`cond_if_cond`	chaîne
`cond_then_expr`	chaîne
`cond_else_expr`	chaîne
`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`	Cette propriété peut être utilisée pour définir la mesure associée au champ calculé. La fonction setter peut être transmise à une chaîne ou à l'une des valeurs `MeasureType`. La méthode getter retournera toujours sur les valeurs `MeasureType`.
`collection_measure`	`Range / MeasureType.RANGE` `Flag / MeasureType.FLAG` `Set / MeasureType.SET` `OrderedSet / MeasureType.ORDERED_SET` `Typeless / MeasureType.TYPELESS`	Pour les champs de résumé (listes avec une profondeur de 0), cette propriété définit le type de mesure associé au valeurs sous-jacentes.
`geo_type`	`Point` `MultiPoint` `LineString` `MultiLineString` `Polygon` `MultiPolygon`	Pour les champs géospatiaux, cette propriété définit le type d'objet géospatial représenté par ce champ. Elle doit être cohérente avec la profondeur de liste des valeurs.
`has_coordinate_system`	Booléen	Pour les champs géospatiaux, cette propriété spécifie si le champ comporte un système de coordonnées
`coordinate_system`	chaîne	Pour les champs géospatiaux, cette propriété définit le système de coordonnées pour ce champ.