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 :
- identifier l'algorithme ayant produit la couche ;
- retrouver sa section ci-dessus ;
- vérifier unités et logique d'agrégation ;
- pour un champ de synthèse, regarder le champ de cible déterminante associé ;
- distinguer NULL et zéro ;
- 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 esttheme;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.
