Référence › Commandes › Import

Référence › Commandes

Importer

La commande qui lit les fichiers d’autres outils et les traduit en arche-lang.

Commandes : archec import

Commande Ce qu’elle fait
archec import <arche-project> [-o <dir>] Un projet Arche réécrit en arche-lang, reconstruit et comparé jusqu’à ce qu’il redonne exactement le projet.
archec import <plant.fmu> [-o plant.arche] Une FMU sous forme de composant dont elle est le comportement, exécutée dans la simulation.
archec import <model.sysml> [-o out.arche] Un modèle textuel SysML v2 en arche-lang. Ce qui n’a pas d’équivalent est gardé sous forme de commentaire // sysml line N: et d’une note.
archec import <bus.dbc> [-o bus.arche] Une base CAN DBC en arche-lang, telle que gen --target dbc la réécrit. Chaque trame devient un message avec son format sur le fil (bit de départ, longueur, ordre des octets, signe, facteur, décalage, plage, unité, tables de valeurs en enums, temps de cycle en period, commentaires en labels). Chaque nœud devient un composant avec un port par trame et un processeur sur le bus. Chaque trame devient une route à son identifiant CAN. Voir l’import.
archec import <types.asn> [more.asn…] [-o types.arche] Des définitions de types ASN.1 (un sous-ensemble) en arche-lang : chaque module devient un package, ses IMPORTS sont cherchés parmi les fichiers donnés. SEQUENCE devient une struct (un message quand aucun autre type ne l’utilise), CHOICE une union, ENUMERATED une enum ; les plages d’INTEGER et SIZE sont reprises. Voir l’import.
archec import <robot.urdf|scene.xml> [-o robot.arche] Un robot décrit en URDF ou en MJCF de MuJoCo (un .xml reconnu à sa racine <robot> ou <mujoco>). Ses corps deviennent des parts imbriquées avec mass, shape et joint (ce que gen --target mujoco réécrit). Ses actionneurs et capteurs deviennent des parts kind actuator / kind sensor, et une part commands envoie aux actionneurs. Ce qu’ils ne disent pas devient des enregistrements prop. Les includes et les classes par défaut de MJCF sont résolus, et la première keyframe donne la position de départ de chaque articulation. Ce qui n’a pas sa place devient un commentaire // urdf: ou // mjcf: et une note. Le résultat est construit tout de suite. Depuis MJCF, le bruit et la fréquence de coupure d’un capteur, ainsi que la forcerange et le filtre d’un actionneur, deviennent les noise, range, force-range et lag des ports. Chaque <key> devient une keyframe du système.
archec import <x.py|dir> [-o x.arche|dir] [--check | --checked-only] [--embedded-only] [--report r.json] [--option int=int32|int64] [--option float=float32|float64] [--option max=64] [--avoid dir] Des fonctions Python dans le langage d’action : chaque module devient un composant, chaque fonction est traduite (embedded, embedded-bounded) ou gardée comme fn simulation-only liée au .py. Ses doctests deviennent un plan de test. --check compare chaque traduction avec le Python dans le simulateur, en C et en Rust, et garde en Python ce qui diverge. Voir importer.
archec import <file> [--importer id] [-o out.arche|dir] [--option k=v]… [--allow-read dir]… [--project main.arche] Le fichier d’un autre outil, lu par l’importer d’un plugin : celui dont les extensions terminent le nom (un importeur intégré garde ses propres extensions), ou celui que donne --importer. Un script ne lit que le dossier du fichier, celui de son plugin, et les dossiers qu’il déclare avec reads et --allow-read. Ce qu’il renvoie est écrit (un seul fichier dans -o x.arche ou sur stdout, plusieurs dans le dossier -o), puis vérifié comme le ferait archec build, avec ses avertissements aux lignes du fichier. Les plugins sont ceux de --project, sinon ceux du main.arche du dossier courant, sinon les plugins intégrés et ./plugins (plugins).