Modèles Twin
Définissez un type d'actif en `.twin.yaml` avec paramètres, membres, méthodes, cycle de vie et défauts.
Définissez un nouveau type d'actif quand le catalogue intégré ne correspond pas au système à modéliser.
Détails techniques
Commencez par le plus petit modèle valide
schema_version: "2"
model:
name: my-sensor
description: "Temperature sensor"
parameters:
temp_center:
type: float
default: 22
unit: degC
members:
temperature:
kind: variable
data_type: Double
access: read
unit: degC
generator:
type: noise
center: "$param.temp_center"
stddev: 0.5Enregistrez ce fichier sous my-sensor.twin.yaml.
Inspectez-le avec miravo models inspect.
miravo models inspect ./my-sensor.twin.yamlÉcrivez dans l'ordre des dépendances
- Définissez
model.nameet les paramètres qui varient par instance. - Déclarez les membres dans l'ordre d'évaluation voulu.
- Ajoutez les méthodes quand un contrôle externe doit écrire des membres ou des paramètres.
- Ajoutez les stages de cycle de vie et les défauts une fois le chemin de process correct.
Les membres sont évalués dans l'ordre de déclaration. Un membre peut référencer un membre précédent dans le même tick. Il ne peut pas référencer un membre déclaré plus tard.
Choisissez la bonne source de valeur
| Besoin | Utilisez |
|---|---|
| Vérité de process qui change à chaque tick | generator |
| État runtime comme cycle de vie ou santé des défauts | binding |
| Surface de commande accessible en écriture | membre readwrite ou write plus methods |
| Métadonnées statiques | membre property |
Exposez l'état runtime avec intention
fault_active:
kind: variable
data_type: Boolean
access: read
binding:
type: fault-active
availability_state:
kind: variable
data_type: String
access: read
binding:
type: availability-state
member: speed_feedback
operator: ">"
threshold: 50Gardez les effets d'observation après la vérité de process
discharge_pressure:
kind: variable
data_type: Double
access: read
unit: bar
eu_range: [0, 12]
generator:
type: correlated
source: speed_feedback
factor: 0.004
offset: 1.5
observation_effects:
- type: white_noise
strength: 0.01
- type: drift
tau: 1800
sigma: 0.02Utilisez observation_effects uniquement sur des variables numériques en read. Le schéma rejette les cibles readwrite, write et non numériques.
Référence
| Champ ou bloc | Notes |
|---|---|
schema_version | La valeur actuelle est "2" |
model.name | Identifiant utilisé par les templates et l'inspection CLI |
parameters | Supporte float, int, string, bool |
members | Au moins un membre. L'ordre de déclaration compte. |
methods | Les actions runtime utilisent set-members, set-parameters ou clear-faults |
binding.type | threshold, lifecycle-stage, health-state, fault-active, fault-count, active-fault-code, availability-state |
observation_effects.type | white_noise, drift, outlier, gap, noise_burst |
Pages liées
Templates
Schéma de topologie d'environnement.
CLI ⭢ models inspect
Inspectez un modèle depuis le shell.
Générateurs
Choix de générateurs.
Catalogue des modèles
Motifs de schéma intégrés.
AC induction motor
Un modèle intégré en contexte.
Was this page useful?
Last updated on
Miravo