Fichier "locators.csv"

Modifié le Mar, 20 Janv. à 11:36 H

Contexte

Le fichier locators.csv est le fichier utilisé par MySurvey Manager pour lister les stations Scan, UHD, POI et virtuelles en cours de modification dans un projet. Si il n’existe pas, MySurvey Manager lit un projet de la même manière que MySurvey.

Ce fichier fait foi à lui seul de toutes les stations visible dans un projet en mode Manager, les stations déjà existantes dans le projet si il a déjà été publié, ainsi que les stations ajoutées via le Manager.

Pour éditer ce fichier, il faut l’ouvrir dans Excel ou autre tableur.

Format de la donnée

Le fichier locators.csv est un tableau avec en colonne les différent champs utiles à la création d’une station et en lignes les stations. Une station combinant une photo et un scan (co-station) sera affichée en 2 lignes, une pour la photo et une pour le scan.

Certains de ces champs sont fait pour être modifiés, d’autres seulement présent afin d’information, ou pour faire des filtres dans Excel. Ces derniers ne doivent pas être modifiés au risque de corrompre le fichier

ATTENTION : Un fichier CSV une fois sauvegardé et fermé oubli les règles de filtrage et les formules. Les valeurs seront appliquées en dur et si le tableau était filtré. Les lignes non affichées par le filtre seront perdues.

Ci-après une liste des différent champs, leur usage, possibilité d’édition et formules Excel pratiques pour les remplir

Nom	Description	Éditable
LOC_ID	ID du locator, il doit être unique dans la liste des locators. Il peut-être édité mais ce n’est pas recommandé	Limité
NAME	Le nom d’affichage du locator en général au format “{EDF.LOCAL}_{EDF.INDEX}” avec un index sur 3 caractères	Oui
LOC_STATUS	Status de publication actuel du locator (PUBLISHED, EXTERNAL, RAW, UNCONVERTED, etc.)	Non
TYPE	Type de station (SCAN ou UHD)	Non
PATH	Chemin vers le dossier de la station ou vers le dossier contenant la source (pour les UHD non converties)	Non
FILENAME	Fichier .loc représentant la station ou fichier image pour les UHD non converties (sans l’extension)	Non
EXTENSION	Extension du fichier	Non
LEVEL	Niveau auquel la station est attaché	Oui
X	Position de la station en X	Oui
Y	Position de la station en Y	Oui
Z	Position de la station en Z	Oui
NORTH_ANGLE	Position du nord sur l’image en % (Photo seulement)	Oui
LINKED_LOCATOR	ID de la station à laquelle il faut rattaché la station actuelle	Oui
COLOR	Couleur de la station en HEX	Oui
HANDPICKED	Vrai/Faux indiquant si la station (Photo seulement) a été positionnée avec un picking sur le plan	Limité
PIXEL_X	Position X piquée sur le plan par rapport aux pixels du plans	Limité
PIXEL_Y	Position Y piquée sur le plan par rapport aux pixels du plans	Limité
COMMENT	Zone de commentaire libre	Oui
SURVEY_NAME	Nom d’origine de la station	Oui
EDF.PALIER	Palier de la centrale	Oui
EDF.CNPE	Trigramme de la centrale (BUG, TRI, GRA)	Oui
EDF.TRANCHE	Trigramme de la tranche (TR1)	Oui
EDF.BATIMENT	Bi/Trigramme du bâtiment (BL, BR, BAN)	Oui
EDF.PLANCHER	Plancher au format numéraire	Oui
EDF.LOCAL	Local de la station	Oui
EDF.INDEX	Index de la station	Oui
EDF.NIVEAU	Altimétrie du plancher	Oui
EDF.DED	Valeur dosimétrique de la station	Oui
EDF.DATESCAN	Date d’aquisition au format AAAAMMJJ	Oui
SCANNER_MODEL	Modèle du scanner utilisé pour l’aquisition	Oui
PRODUCER_NAME	Entreprise ou individu ayant réalisé l’aquisition	Oui

Utilisation

Général

Pour générer le fichier CSV sur un projet, il faut appuyer sur le bouton “Disquette”, cela génère le fichier dans le projet tel que Projet\\DATA\\LOCATORS_BRUT\\locators.csv

Il n’y a pas besoin de fermer MySurvey Manager pour modifier le fichier. Le seul cas de figure ou il faut fermer le fichier locators.csv est à la sauvegarde dans MySurvey Manager. si le fichier reste ouvert MySurvey Manager n’arrivera pas a sauvegarder l’état du projet.

Pour que MySurvey Manager lise les modifications apportées dans le fichier CSV il faut appuyer sur le bouton “Recharger SiteStructure”

Modification des données

Retirer des stations du projet

Il est possible de supprimer des stations d’un projet en supprimant les lignes des stations à enlever

Ajouter des stations au projet

Il est plus simple d’ajouter des stations à un projet via MySurvey Manager que via le CSV

Renommer une station

Pour renommer une station, le champ NAME est utilisé, il défini le nom d’affichage de la station, il est en général formatté tel que :

{EDF.LOCAL}_[EDF.INDEX} pour des scans
{EDF.LOCAL}_[EDF.INDEX}P pour des photos

où EDF.INDEX est encodé sur 3 caractères.

Modifier une station de plancher

Pour changer le plancher auquel une station est rattaché, il faut changer le champ LEVEL de la station par le nom de plancher auquel on souhaite la rattacher. Si ce plancher n’existe pas déjà dans le projet, il sera crée à la prochaine lecture du fichier locators.csv.

Si un plancher n’a plus de station rattachée, il n’est pas supprimé automatiquement pour autant, il faut le supprimer dans MySurvey Manager

Modifier l’orientation d’une station photo

L’orientation d’une photo dans le fichier est exprimée en %. Il s’agit de la position du nord sur l’image en % par rapport au bord gauche de l’image.

50% : centre de l’image
75% : 3ème quart de l’image en partant de la gauche
0% / 100% : bord gauche ou droite de l’image

Modifier la position d’une station

Les champs X, Y et Z représentent la position des stations. Il est possible de les changer même pour les scans mais il faut être sûr dans le cas des scans de changer toutes les positions pour éviter des problèmes d’assemblage.

Modifier les métadonnées

Toutes les métadonnées importantes sont listées dans le fichier, il suffit d’appliquer la valeur attendue pour chacun. Le faire via une fonction est conseillé

Co-stationnement de stations

Le champ LINKED_LOCATOR permet de gérer le co-stationnement Scan/UHD, il faut mettre l’ID de l’UHD dans le champ LINKED_LOCATOR du Scan ou inversément. Si MySurvey détecte une incohérence à ce niveau il ne fera pas le co-stationnement et informera dans les logs de l’erreur

Si 2 scans pointent vers la même UHD
Si 2 UHD pointent vers le même scan
Si une station pointe vers une station déjà co-stationnée

Ce champ est temporaire, une gestion avec une interface graphique plus simple sera disponible à terme

Une fois les modifications finies, le fichier peut-être sauvegarder et dans le Manager la structure peut être rechargée pour lire les changements effectués dans le fichier “locators.csv”