QCALVIEW40.21
Documentation utilisateur · QCALVIEW 40.21

Champs attributaires

QCALVIEW

Référence des champs attributaires

QCALVIEW utilise et génère de nombreuses colonnes attributaires. Cette page constitue la référence utilisateur des noms de champs pour la documentation 40.21.

Les tableaux distinguent :

  • champs persistants des points de vue — stockés dans la couche de PDV QCALVIEW ;
  • champs de scénario — utilisés pour piloter des variantes reproductibles ;
  • champs internes/cache — à ne normalement pas modifier manuellement ;
  • alias historiques/import — reconnus pour compatibilité mais non recommandés comme noms de sortie.

Les noms de champs sont reproduits exactement tels qu'ils existent dans les données et ne sont donc pas traduits.

Champs persistants des points de vue QCALVIEW#

Champs caméra/PDV canoniques gérés par QCALVIEW.

Champ Signification Valeurs / unités courantes
qcv_id Identifiant lisible du point de vue texte
qcv_img Chemin vers l'image source chemin/texte
qcv_mode Mode/source de la vue AUTO, PHOTO, SCHEMA
qcv_proj Projection caméra PINHOLE, CYLINDRICAL, EQUIRECTANGULAR
qcv_360 Indicateur vue 360 0/1
qcv_yaw Orientation horizontale de la caméra degrés
qcv_pitch Orientation verticale de la caméra degrés
qcv_roll Rotation autour de l'axe de vue degrés
qcv_hfov Champ visuel horizontal degrés
qcv_vfov Champ visuel vertical degrés
qcv_ahf État/indicateur HFOV automatique entier
qcv_alt Hauteur/Z caméra utilisée par QCALVIEW ; avec relief, généralement hauteur observateur au-dessus du terrain local mètres
qcv_ofh Offset horizontal image pixels ou pourcentage selon qcv_ofmd
qcv_ofv Offset vertical image pixels ou pourcentage selon qcv_ofmd
qcv_ofmd Mode des offsets 0 = pixels, 1 = pourcentage
qcv_mdst Distance maximale de projection/analyse associée au PDV mètres ; 0 peut signifier absence de limite explicite selon le contexte
qcv_iw Largeur image/vue pixels
qcv_ih Hauteur image/vue pixels
qcv_foc Focale mm
qcv_sens Largeur du capteur mm
qcv_stat Champ de statut optionnel texte
qcv_note Note utilisateur texte
qcv_upd Horodatage/texte de dernière mise à jour texte/date

Identifiant interne stable du point de vue#

Champ Signification
qcv_uid Identité interne stable utilisée par QCALVIEW pour suivre un point de vue plus sûrement que son FID. Généralement masqué et à ne pas modifier manuellement.

Alias historiques/import des champs PDV#

QCALVIEW sait reconnaître plusieurs anciens noms ou noms alternatifs. Pour les nouveaux projets, utiliser les champs canoniques ci-dessus.

Champ canonique Alias reconnus
qcv_mode qcv_source, qcv_src
qcv_alt qcv_cam_h
qcv_ofh qcv_off_h
qcv_ofv qcv_off_v
qcv_ofmd qcv_off_mode, qcv_ofmod
qcv_mdst qcv_maxdist, qcv_maxdst
qcv_iw qcv_img_w
qcv_ih qcv_img_h
qcv_foc qcv_focal
qcv_sens qcv_sensorw, qcv_sensw
qcv_stat qcv_status
qcv_upd qcv_updated, qcv_updatd

Champs internes de FOV/cache#

Ces champs stockent des géométries auxiliaires internes. Ne pas les modifier manuellement sauf débogage du plugin.

Champ Rôle
qcv_fov_full Cache de géométrie/état du FOV complet
qcv_fov_symbol Cache de géométrie/état du symbole FOV
qcv_fov_ring Cache de géométrie/état d'anneau
qcv_fov_axis Cache de géométrie/état de l'axe de vue
qcv_fov_equi Cache de géométrie/état du FOV équirectangulaire

Des variantes internes suffixées comme _live peuvent également apparaître. Il s’agit de détails d’implémentation et non de champs utilisateur persistants.

Champs de la couche ponctuelle de monoplotting#

Lorsque le monoplotting crée des points, les champs peuvent inclure :

Champ Signification
mp_id Identifiant de l'enregistrement monoplotting
src_mode Mode/source du clic
src_pdv Identifiant/référence du PDV source
src_name Nom de la source
dist_m Distance au point monoplotting
dist_h_m Distance horizontale
az_deg Azimut
z Altitude résultat utilisée par la sortie
z_raw Valeur/altitude brute échantillonnée
z_view Valeur altimétrique ajustée pour la vue
z_mode Mode altimétrique
curv_on Indicateur de courbure terrestre
proj Projection
hfov HFOV au moment de la création
vfov VFOV au moment de la création
yaw Yaw au moment de la création
pitch Pitch au moment de la création
roll Roll au moment de la création
created Horodatage de création
label Libellé utilisateur/affichage
is_ctrl Point marqué/utilisé comme point de contrôle

Champs de la couche rayon du monoplotting#

Champ Signification
mp_id Identifiant monoplotting
src_pdv PDV source
dist_m Distance du rayon/résultat
az_deg Azimut du rayon

Champs diagnostics interactifs d'occultation/écran#

L'outil interactif schématique/occultation peut produire/exposer des enregistrements comportant :

Champ Signification
hedge_fid FID de l'écran/haie
target_fid FID cible
target_h Hauteur cible
h_geom Hauteur issue de la relation géométrique de ligne de visée
h_nominal Hauteur nominale/actuelle de l'écran
crown_ratio Ratio de couronne du motif végétal si applicable
z_ground Altitude terrain à l'intersection
z_los Altitude de la ligne de visée
dist_cam Distance à la caméra
part Référence/indice de partie géométrique
segment Référence/indice de segment
first_hit Indicateur de première intersection
controls_h Indique si cette intersection contrôle la hauteur requise
h_source Source de hauteur écran

Données d'état/style qui ne sont pas des colonnes analytiques#

Comment utiliser cette référence#

Lorsqu'une carte ou une table est difficile à lire :

  1. identifier l'algorithme ayant produit la couche ;
  2. retrouver sa section ci-dessus ;
  3. vérifier unités et logique d'agrégation ;
  4. pour un champ de synthèse, regarder le champ de cible déterminante associé ;
  5. distinguer NULL et zéro ;
  6. conserver la table détaillée lorsque la traçabilité est importante.

Champ de résultat de l'outil interactif d'écran#

Champ Signification
qcv_h_req Hauteur d'occultation requise écrite par l'outil interactif. L'utilisateur peut choisir un autre nom de champ dans la boîte de dialogue.

Noms QCALVIEW qui ne sont pas des colonnes attributaires ordinaires#

  • qcv_layer_crs — variable d'expression QGIS décrivant le SCR de la couche ;
  • qcv_work_crs — variable d'expression QGIS décrivant le SCR de travail QCALVIEW ;
  • qcv_wkt — variable temporaire/d'expression utilisée pour la géométrie de FOV ;
  • qcv_theme — alias de thème reconnu dans les scénarios, mais la colonne générée canonique est theme ;
  • qcv_fov_*_live — variables d'expression dynamiques liées aux caches internes de FOV.

Cette distinction est utile lorsque l'on parcourt le code source : toute chaîne qcv_* n'est pas nécessairement un en-tête de colonne dans la table attributaire.

Champs source choisis par l'utilisateur sans nom QCALVIEW imposé#

Certains contrôles QCALVIEW permettent de sélectionner un champ existant de la couche plutôt que de créer une colonne canonique. C'est notamment le cas du champ d'ordre utilisé pour la navigation point de vue précédent/suivant. Il n'existe pas de colonne obligatoire qcv_order. En l'absence de champ d'ordre explicite, QCALVIEW peut se rabattre sur les identifiants/FID selon sa logique courante.