Rapport de Cables

Rapport de câbles

Produit une ligne Excel par câble : ses repères d'extrémité (Repere), sa nature et sa longueur totale (propriétés personnalisées lues sur le câble et les éléments groupés avec lui), et sa longueur de tranchée répartie par nature de sol — une colonne par valeur distincte, additionnée quand plusieurs zones le long du même câble partagent la même valeur. Les câbles aériens sont listés sur une feuille à part, sans nature de sol. Exemple :

Repère	Nature	Longueur	Partagé avec	CH2C	CH2C (2)	TRIC
RAS 1 - D3UP 1	HTAS 3x150 AL	493,6	RAS 1 - PT 4	193,6	100	200
RAS 1 - PT 4	HTAS 3x95 AL	120	RAS 1 - D3UP 1	20	100
Total câbles				213,6	200	200
Tranchée à terrasser (dédoublonnée)				213,6	100	200

Ce qu'ARES recherche

• Câbles : tout élément du ou des niveaux de câbles — Line, Arc, LineString, Shape, ComplexString ou ComplexShape.
• Repère : la cellule la plus proche, dans le rayon de recherche, de chaque extrémité du câble et portant la propriété Repère, écrite début - fin (dans le sens de tracé du câble). Une Shape/ComplexShape fermée n'a pas d'extrémités : pas de repère (ses longueurs sont quand même rapportées).
• Nature / Longueur : lues telles quelles. La nature est lue d'abord sur le câble lui-même, puis sur l'élément groupé avec lui (groupe graphique) qui porte la propriété — un texte, une cellule, n'importe quel membre ; la longueur, seulement sur les éléments groupés. Les deux peuvent être sur des membres différents.
• Câbles aériens : quand ARES_CableReport_Aerial_Nature_Property désigne une propriété, un câble qui la porte — sur lui-même ou sur un élément groupé, même sans valeur encore — est aérien. Il est listé sur une seconde feuille, Câbles aériens (Repère, Nature, Longueur ; la nature est la valeur de cette propriété), et n'est jamais mesuré contre une zone. Un câble qui porte la propriété Nature, ou aucune des deux, reste sur la première feuille ; un câble qui porte les deux apparaît sur les deux.
• Colonnes par nature de sol : pour chaque zone de tranchée (Shape/ComplexShape sur le niveau des zones, par ex. produite par RunOutline et découpée avec SplitRegion), la longueur du câble à l'intérieur de la zone s'ajoute à la colonne portant la valeur de la propriété nature de sol de cette zone — ou à <valeur> (n) quand n câbles partagent cette zone (voir Tranchées communes ci-dessous). Colonnes triées par ordre alphabétique ; une case sans contribution reste vide. Une zone sans valeur de nature de sol ne contribue à rien.

Tranchées communes. Quand deux câbles ou plus ont de la longueur dans la même zone, cette zone est une tranchée commune et obtient sa propre colonne, dont le titre porte la nature de sol et le nombre de câbles qui s'y trouvent — CH2C (2) — juste à côté du CH2C ordinaire. Plusieurs peuvent coexister (CH2C (2), CH2C (3), TRIC (2)), et un même câble peut apparaître dans plusieurs d'entre elles : il peut partager son début avec un câble et sa fin avec un autre. Chaque câble affiche toujours sa propre longueur dans chaque colonne, et la colonne Partagé avec nomme les autres câbles (par repère, ou #ligne quand un câble n'en a pas).

Deux câbles qui ne font que se croiser ne partagent pas de tranchée. Là où leurs tranchées se coupent, chacune contient le câble de l'autre sur environ sa propre largeur, et compter cela comme une occupation reviendrait à déclarer une tranchée commune d'un demi-mètre, que personne ne creuse. Un câble doit donc parcourir dans une zone plus que ARES_CableReport_Cross_Factor × ARES_Outline_Distance pour y être considéré comme occupant ; en dessous, la zone est entièrement exclue de sa ligne et de ses totaux. Une largeur de tranchée vaut deux fois cette distance — exactement ce que mesure un croisement perpendiculaire — et un croisement oblique mesure davantage, d'où le facteur par défaut de 3,5 qui couvre les deux. Augmentez-le là où les câbles se croisent à angle très faible.

Une colonne commune identifie le groupe de câbles, pas seulement leur nombre. Deux zones TA1 partagées chacune par deux câbles mais par des paires différentes — A+B d'un côté, A+C de l'autre — sont deux tranchées distinctes : elles donnent donc deux colonnes, TA1 (2) et TA1 (2) #2. Quels câbles appartiennent à laquelle se lit directement dans la colonne : seules leurs lignes sont remplies. Deux zones partagées par les mêmes câbles fusionnent en une seule colonne (deux tronçons d'une même tranchée commune, additionnés).

Sous le tableau, Total câbles additionne les lignes telles quelles, tandis que Tranchée à terrasser (dédoublonnée) compte chaque zone une seule fois, à la longueur du câble le plus long qu'elle contient — une colonne (2) affiche donc typiquement le double sur la première ligne et la vraie longueur sur la seconde. Une tranchée commune doit être dessinée comme une seule zone englobant les câbles (deux zones distinctes qui se chevauchent ne sont pas détectées).

Un repère, une nature ou une longueur manquants sont un trou attendu dans le dessin : la case reste vide et la ligne est comptée incomplète dans la ligne de statut finale — rien n'est journalisé.

Commandes

EditCableReportOptions

macro vba run [ARES]EditCableReportOptions

Ouvre la boîte d'options du Rapport de câbles (configure les variables ci-dessous). Les cinq champs de nom de propriété listent les ItemTypes créés dans le DGNLib « ARES » ; la liste de la nature aérienne commence par une entrée vide, qui désactive la feuille aérienne.

ExportCableReport

macro vba run [ARES]ExportCableReport

Lance le rapport et demande où enregistrer le .xlsx (annuler interrompt). Ligne de statut : N câble(s), N colonne(s) de nature de sol, N incomplet(s), N zone(s) en tranchée commune — câbles et incomplets sont comptés par ligne écrite : un câble présent sur les deux feuilles compte deux fois.

Variables de configuration

Variable	Défaut	Rôle
ARES_CableReport_Cable_Level	(vide)	Obligatoire. Niveau(x) des câbles, aériens comme souterrains, séparés par |. Les niveaux inexistants sont ignorés (signalés dans la barre de statut) ; si aucun n'existe, le rapport s'arrête.
ARES_CableReport_Zone_Level	(vide)	Niveau des zones de tranchée. Vide = ARES_Outline_Output_Level. Aucune zone trouvée → le rapport tourne quand même, sans colonnes de nature de sol.
ARES_CableReport_Repere_Property	Repere	Propriété personnalisée lue sur chaque cellule d'extrémité.
ARES_CableReport_Nature_Property	Nature	Propriété personnalisée portant la nature/type d'un câble souterrain, lue d'abord sur le câble, puis sur son groupe.
ARES_CableReport_Aerial_Nature_Property	(vide)	Propriété personnalisée portant la nature/type d'un câble aérien, lue de la même façon. Un câble qui la porte va sur la feuille Câbles aériens, sans mesure par zone. Vide = pas de feuille aérienne.
ARES_CableReport_Longueur_Property	Longueur	Propriété personnalisée lue sur le groupe du câble pour sa longueur totale.
ARES_CableReport_Zone_Property	Coupe_Type	Propriété personnalisée lue sur chaque zone ; une colonne par valeur distincte.
ARES_CableReport_Search_Radius	2.0	Rayon de recherche (unités maître) autour de chaque extrémité de câble pour la cellule Repère.
ARES_CableReport_Cross_Factor	3.5	Multiplie ARES_Outline_Distance pour donner la longueur qu'un câble doit DÉPASSER dans une zone pour y être considéré comme occupant. La largeur de tranchée vaut deux fois cette distance : un facteur 2 correspond donc exactement à une largeur, soit la valeur d'un croisement perpendiculaire ; les croisements obliques sont plus longs, d'où la valeur par défaut de 3,5. Augmentez-la là où les câbles se croisent à angle très faible. À 0, le filtre est désactivé.
ARES_CableReport_Round	2	Nombre de décimales des sommes de longueur par nature de sol.
ARES_CableReport_Excel_Visible	False	True = laisse le classeur ouvert dans Excel après l'export ; False = silencieux (classeur fermé, Excel quitté s'il a été lancé par ARES).

Chaque nom de propriété doit être un ItemType du DGNLib « ARES » ; un nom invalide est signalé et la colonne correspondante reste vide — pour la nature aérienne, il n'y a pas de feuille aérienne.