Guide Revit · DiStem

Écrire les coordonnées XYZ et les propriétés cachées des éléments Revit dans des paramètres

Une nomenclature d'implantation, une étiquette de coordonnées, un contrôle du sens d'ouverture des portes ou un échange de données avec un autre logiciel demandent souvent des informations que Revit connaît mais n'affiche pas comme paramètres : la position d'un élément, son identifiant unique, le fait qu'il ait été mis en miroir.

Parameter Extractor, l'un des outils de DiStem, le plugin Premium de DiRoots (société du groupe NTI), sert précisément à rendre ces propriétés exploitables : il les lit sur les éléments du modèle et les injecte dans des paramètres partagés d'instance. Ce guide détaille le déroulé décrit par la documentation officielle, les propriétés prises en charge, les profils et les limites à connaître, puis deux outils complémentaires de DiStem : 3D Ruler et Parameter Link.

Pourquoi passer par des paramètres partagés ?

D'après la documentation de DiRoots, Parameter Extractor extrait des propriétés et paramètres inaccessibles des éléments du modèle, par exemple les coordonnées X, Y, Z de leur emplacement, et les injecte dans des paramètres partagés d'instance, nouveaux ou existants. La recherche peut porter sur le modèle entier, la vue courante ou la sélection courante, et se filtrer par catégorie ou sous-catégorie.

Le choix des paramètres partagés a une conséquence pratique. Selon l'aide d'Autodesk, un paramètre partagé est une définition utilisable dans plusieurs familles ou projets ; pour qu'une information figure dans une étiquette, elle doit être portée par un paramètre partagé, et les paramètres partagés permettent aussi de créer une nomenclature qui regroupe plusieurs catégories de familles. Une fois extraites, les valeurs peuvent donc être étiquetées et mises en nomenclature comme n'importe quel autre paramètre partagé.

Autodesk précise que l'information saisie dans une famille ou un projet au moyen d'un paramètre partagé n'est pas reportée automatiquement dans les autres familles ou projets qui utilisent ce même paramètre : chaque modèle doit faire l'objet de sa propre extraction.

Les propriétés que Parameter Extractor sait extraire

La documentation regroupe les propriétés prises en charge en deux familles. Parmi les points de localisation, elle nomme le point de base du projet (« Project Base Point »), l'origine interne de Revit (« Revit Internal Origin ») et le point topographique (« Survey Point »). Les captures de la documentation montrent une case à cocher par repère sous « Location Points » : on choisit donc dans quel repère les coordonnées sont extraites, et les paramètres générés portent le repère dans leur nom (par exemple « LocationPoint_SurveyPt_Z »). Ces captures datent d'anciennes versions : l'interface actuelle peut différer.

« Bounding Box Coordinates » : coordonnées de points précis de la boîte qui englobe toute la géométrie de l'élément.
« Point-based Family Instance » : coordonnées X, Y, Z du point de localisation, qui est aussi le point d'insertion de la famille.
« Line-based Family Instance » : coordonnées de points précis de la ligne d'insertion d'une famille linéaire, comme une canalisation.
« Connectors » : coordonnées des connecteurs associés aux éléments du modèle.
« Element ID » : identifiant unique d'un élément au sein d'un seul projet.
« GUID » : le UniqueId de l'élément Revit, qui l'identifie de façon universelle et pas seulement dans un projet.
« Flipped Face Orientation », « Flipped Hand Orientation » et « Mirrored » : valeurs oui/non selon l'orientation de la face, l'orientation de la main ou l'état miroir de la famille.
« Flipped Orientation » : valeur oui/non selon l'orientation du mur.
Paramètres de fabrication : paramètres masqués courants liés aux dimensions des pièces de fabrication, par exemple le diamètre (tige de suspension, canalisation…), « Rod Extn » ou les extensions gauche et droite.

Selon le journal de modifications de l'éditeur, l'outil prend aussi en charge les TopoSolids (version 1.0.2) et l'extraction depuis les liens CAD et Revit (version 0.9.9) ; la documentation actuelle ne décrit pas ces deux cas en détail.

Étape 1 : choisir les éléments et les propriétés (onglet « Select Parameters »)

Le premier onglet sert à choisir les éléments à traiter et les propriétés à extraire. Les éléments se filtrent par portée, par catégorie ou sous-catégorie dans l'arborescence et avec une barre de recherche ; les propriétés se filtrent par type (par exemple toutes les propriétés de localisation) et par nom (par exemple « Location Point - XYZ coordinates »), là aussi avec une arborescence et une barre de recherche.

Cliquez sur l'un des boutons radio pour collecter les éléments du modèle entier (« Whole Model »), de la vue active (« Active View ») ou de la sélection courante (« Current Selection »).
Cochez les catégories ou sous-catégories voulues dans l'arborescence, ou utilisez la case de l'en-tête du tableau pour toutes les sélectionner.
Cochez dans l'arborescence les propriétés à extraire.
Cliquez sur « Map and Extract » pour passer à l'onglet « Create Parameters » et lancer le mappage.

Étape 2 : choisir le paramètre de destination et extraire (onglet « Create Parameters »)

Le second onglet associe chaque propriété à un paramètre partagé d'instance, existant ou nouveau, puis écrit les valeurs.

Cochez dans le tableau les propriétés à mapper.
Choisissez le type de paramètre à créer (par défaut ou texte).
Choisissez le groupe de rattachement dans « Group Under » ; la valeur par défaut est « Other ».
Pour une propriété au format texte, réglez si besoin les unités et l'arrondi, en bas à gauche de la fenêtre.
Choisissez le paramètre de destination : la liste déroulante propose tous les paramètres partagés d'instance présents dans le modèle ; pour en créer un, cliquez sur « + », nommez-le puis cliquez sur le bouton d'enregistrement.
Cliquez sur « Extract » pour extraire les valeurs et les injecter dans les paramètres cibles.

Conseil de NTI France : choisissez le type du paramètre avec soin avant de le créer. L'aide d'Autodesk indique qu'un paramètre partagé existant ne peut être ni renommé ni changé de type (on peut seulement le déplacer dans un autre groupe ou le supprimer). Le journal de la version 0.9.11 mentionne par ailleurs l'ajout d'un type de paramètre Angle.

Bien lire les coordonnées extraites

La documentation signale une limite importante : la propriété « Bounding Box Coordinates » renvoie une boîte alignée sur les axes cardinaux du projet. Elle peut donc ne pas suivre le système de coordonnées de l'élément, ni être la plus petite boîte qui l'englobe. Pour un élément orienté en biais, les coins de cette boîte ne correspondent pas aux coins de l'objet.

Pour un équipement ou un mobilier posé par un point, la propriété « Point-based Family Instance » donne directement le point d'insertion de la famille ; pour une canalisation ou un autre élément linéaire, « Line-based Family Instance » donne des points de la ligne d'insertion ; pour un réseau, « Connectors » renvoie la position des connecteurs.

Conseil de NTI France : cochez le repère attendu par le destinataire (souvent le point topographique pour des coordonnées de géoréférencement, à confirmer avec lui). Avant de diffuser une nomenclature de coordonnées, vérifiez les valeurs extraites sur un élément dont vous connaissez la position, par exemple avec 3D Ruler (voir plus bas).

Profils : enregistrer une configuration et la relancer

Un profil enregistre la sélection faite dans l'onglet « Select Parameters » et le mappage défini dans l'onglet « Create Parameters ». La documentation y voit un moyen pour les BIM managers de créer des règles standard et de les partager dans l'organisation, par exemple depuis un emplacement partagé. Tout se passe depuis la liste déroulante en haut à droite de la fenêtre.

Créer : ouvrez la liste des profils, saisissez un nom explicite dans le champ texte (c'est lui qui apparaîtra dans la liste), puis cliquez sur le bouton d'enregistrement.
Importer : ouvrez la liste, cliquez sur « Import », choisissez de remplacer la liste actuelle ou d'y ajouter les profils, puis sélectionnez le fichier de profils.
Exporter : ouvrez la liste, cliquez sur « Export », puis choisissez le dossier et le nom du fichier.
Supprimer : ouvrez la liste, cliquez sur l'icône de corbeille à côté du profil, puis sur « Yes » pour confirmer.

Depuis la version 1.3.0, selon le journal de l'éditeur, un Ctrl+clic sur le bouton Parameter Extractor lance le dernier profil utilisé sans ouvrir l'outil, et l'outil se trouve dans le panneau Parameters du ruban, à côté de Parameter Link. La documentation ne décrit pas de mise à jour automatique des valeurs quand un élément est déplacé : conseil de NTI France, relancez l'extraction après une modification du modèle.

Quelques usages, avec leurs limites

Les usages ci-dessous sont des suggestions de NTI France, fondées sur ce que la documentation dit de chaque propriété.

Sens d'ouverture des portes et fenêtres : la documentation indique que « Flipped Face Orientation », « Flipped Hand Orientation » et « Mirrored » peuvent aider à déterminer le côté de la poignée ou le sens d'ouverture. Une fois extraites, ces valeurs oui/non peuvent alimenter une nomenclature de contrôle.
Nomenclature d'implantation : le point d'insertion des familles ponctuelles, écrit dans des paramètres partagés, peut être mis en nomenclature ou étiqueté. Évitez la boîte englobante pour un élément orienté en biais, pour la raison vue plus haut.
Identifier un élément hors de Revit : l'Element ID n'est unique qu'au sein d'un projet, alors que le GUID (UniqueId) identifie l'élément de façon universelle, d'après la documentation. Pour un échange entre projets ou avec un autre logiciel, le GUID est donc le plus adapté.
Fabrication MEP : les dimensions masquées des pièces de fabrication (diamètre, « Rod Extn », extensions gauche et droite) deviennent lisibles dans une nomenclature.

Deux compléments dans DiStem : 3D Ruler et Parameter Link

3D Ruler mesure dans les vues 2D et 3D : distance entre deux points, longueur d'une arête et coordonnées X, Y, Z d'un point unique. Pour obtenir les coordonnées d'un point, la documentation décrit trois gestes : cliquer sur l'icône de marqueur, sélectionner un point, lire le résultat qui s'affiche automatiquement dans l'interface. Les résultats se copient dans le presse-papiers ou s'exportent vers Microsoft Excel. Depuis la version 1.3.0, un mode de mesure reste actif jusqu'à ce que vous en choisissiez un autre, appuyiez sur Échap ou fermiez l'outil, et la copie comme l'export Excel reprennent toutes les mesures de la session. Le texte de la documentation ne nomme pas le repère des coordonnées affichées, mais ses captures montrent un choix entre « Internal Origin », « Project Base Point » et « Survey Point » (captures d'anciennes versions).

Parameter Link crée des liens entre paramètres de type ou d'instance, sur des éléments filtrés par discipline et par catégorie. Plusieurs paramètres sources peuvent alimenter un seul paramètre cible, avec des champs et des séparateurs personnalisés, et un aperçu de la valeur composée s'affiche sous le tableau. Le lien s'applique au modèle entier, à la vue active ou à la sélection courante, et les liens s'enregistrent dans des profils.

Conseil de NTI France : après une extraction, Parameter Link peut par exemple composer les coordonnées X, Y et Z dans un seul paramètre texte, avec le séparateur de votre choix. La documentation avertit qu'on peut perdre les liens créés en fermant l'outil : enregistrez-les dans un profil.

Où trouver la documentation et la licence

DiRoots publie un guide détaillé de Parameter Extractor, de 3D Ruler et de Parameter Link, ainsi que des tutoriels vidéo sur sa chaîne YouTube ; les liens figurent plus bas. DiStem fonctionne avec Autodesk Revit 2019 à 2027 ; l'installation demande des droits d'administrateur. Depuis la version 1.3.0, son interface existe en français et suit par défaut la langue de Revit : les libellés peuvent alors différer des libellés anglais cités ici.

Parameter Extractor fait partie de DiStem, un plugin Premium sans version gratuite, vendu en abonnement annuel par utilisateur ; la page de prise en main mentionne un essai gratuit de 15 jours. NTI France vend la licence DiStem avec facture française : indiquez le nombre de postes sur la fiche produit, ou contactez-nous pour un devis.

Équiper vos postes avec DiStem

NTI France vend la licence DiStem en abonnement annuel, avec facture française et support en français. Pour plusieurs postes ou un règlement sur bon de commande, nous établissons un devis.

Acheter DiStem dès 114€ /an TTCsoit 95€ HTTout savoir sur DiStem

Autres guides DiRoots

Questions fréquentes

Comment écrire les coordonnées XYZ d'un élément Revit dans un paramètre ?+

Avec Parameter Extractor de DiStem : dans l'onglet « Select Parameters », choisissez la portée, les catégories et la propriété de localisation voulue, cliquez sur « Map and Extract », puis, dans l'onglet « Create Parameters », choisissez ou créez un paramètre partagé d'instance de destination et cliquez sur « Extract ».

Faut-il créer les paramètres partagés avant de lancer l’extraction ?+

Non. L'onglet « Create Parameters » propose soit un paramètre partagé d'instance déjà présent dans le modèle, soit la création d'un nouveau paramètre à la volée avec le bouton « + ».

Les coordonnées de la bounding box correspondent-elles aux coins de l’élément ?+

Pas toujours. D'après la documentation, la boîte englobante est alignée sur les axes cardinaux du projet : elle peut ne pas suivre le système de coordonnées de l'élément ni être la plus petite boîte qui l'englobe. Pour une famille ponctuelle, le point d'insertion est plus direct.

Quelle différence entre Element ID et GUID ?+

Selon la documentation, l'Element ID identifie un élément de façon unique au sein d'un seul projet, tandis que le GUID est le UniqueId Revit, qui l'identifie de façon universelle. Parameter Extractor sait écrire l'un comme l'autre dans un paramètre.

Peut-on savoir si une porte ou une fenêtre a été mise en miroir ?+

Oui. Parameter Extractor extrait les valeurs oui/non « Mirrored », « Flipped Face Orientation » et « Flipped Hand Orientation », qui, d'après la documentation, aident à déterminer le côté de la poignée ou le sens d'ouverture des portes et fenêtres.

Les valeurs se mettent-elles à jour si l’élément est déplacé ?+

La documentation ne décrit pas de mise à jour automatique. Par prudence, NTI France conseille de relancer l'extraction après une modification ; depuis la version 1.3.0, un Ctrl+clic sur le bouton Parameter Extractor relance le dernier profil utilisé sans ouvrir l'outil.

Parameter Extractor est-il gratuit ?+

Non. Il fait partie de DiStem, un plugin Premium en abonnement annuel par utilisateur, sans version gratuite. La documentation de prise en main mentionne un essai gratuit de 15 jours. DiStem est compatible avec Autodesk Revit 2019 à 2027.

Une question avant d'acheter ? Parlez à l'équipe NTI France.

Sources et dernière vérification

Les informations de cette page proviennent des publications officielles de DiRoots et du groupe NTI, relues le 26 octobre 2026. Les logiciels évoluent : versions de Revit, périmètre gratuit ou Premium et nouveautés sont à confirmer sur la fiche de l'éditeur avant achat. Les prix affichés sur ce webshop sont ceux du catalogue NTI France.