Une fonction de tableau a un ou plusieurs argument(s), exécute une action et retourne une ou plusieurs valeurs. Il y a deux types de fonctions, notamment celles qui utilisent une valeur que vous avez entrée auparavant et les fonctions qui reprennent elles-mêmes les informations nécessaires à partir des objets. Ces deux types de fonction ont besoin d’arguments différents.
● Arguments textuels ou numériques: Les fonctions qui commencent par une minuscule demandent une valeur numérique ou une adresse de cellule comme argument. Par exemple, la fonction acos donne comme résultat l’arccosinus de la valeur spécifiée dans l’argument de la fonction. L’argument que vous saisissez peut être une formule mathématique, une adresse de cellule (comme A12), ou un nombre. Pour les fonctions trigonométriques, les arguments doivent être exprimés en radians.
● Arguments sur base de critères: Les fonctions qui commencent par une majuscule doivent être appliquées sur un ou plusieurs objets spécifiques dans le dessin. Dans une cellule d’une ligne principale de base de données, la fonction s’applique automatiquement à l’objet de chaque sous-ligne, et aucun argument de critère n’est nécessaire.
Dans une cellule de tableau, vous devez par contre entrer les critères qui permettront de sélectionner les objets sur lesquels la fonction doit être appliquée. La fonction Surface par exemple, retourne la surface cumulée de tous les objets 2D qui répondent aux critères. Pour indiquer les objets dont la superficie doit être reprise, vous pouvez soit utiliser la commande Insertion > Critères dans le menu du Tableau, ou vous pouvez entrer le critère manuellement. Consultez les liens ci-dessous pour plus d’informations (en anglais) sur la façon de spécifier des critères comme le type d’objet, la classe ou la visibilité.
developer.vectorworks.net/index.php/VS:Search_Criteria#Search_Criteria_Tables
developer.vectorworks.net/index.php/VS:Function_Reference_Appendix#attrCrit
Utilisez les règles de la Syntaxe des formules lorsque vous saisissez des fonctions pour le tableau.
Ci-dessous, vous trouverez la liste de toutes les fonctions qui peuvent être intégrées aux formules d'un tableau. Le type d'argument nécessaire est indiqué pour chaque formule.
Retourne l’arccosinus de la valeur entre parenthèses. L’arccosinus est l’angle dont le cosinus est la valeur entre parenthèses. L’angle obtenu est une valeur entre 0 et pi exprimée en radians. La (valeur) est le cosinus de l’angle en question. La valeur doit être un nombre entre -1 et +1. Fonction liée: cos
Exemple: =acos(3/5) retourne l’angle pour lequel le cosinus est 3/5.
Retourne l’angle (mesuré par rapport à un axe horizontal) des objets qui satisfont aux critères, en degrés. Utilisez cette fonction pour obtenir les angles des lignes et murs, l’angle balayé par des arcs ou l’angle de pente des planchers.
Exemples:
● Cellule d’en-tête d’une base de données: =Angle retourne l’angle de chaque objet dans la base de données.
● Cellule d’un tableau: =Angle((t=arc)&(n=’arc-1’)) retourne l’angle balayé par l’arc nommé « arc-1 » dans le dessin.
Retourne le périmètre des objets répondant au critère. Les unités utilisées sont celles définies dans la boîte de dialogue « Unités ». Fonction liée: Perim
Exemples:
● Cellule d’en-tête d’une base de données: =Surface retourne la surface de chaque objet de la base de données.
● Cellule d’un tableau: =Surface(t=rect) retourne la superficie totale de tous les rectangles dans le dessin.
Retourne l’arcsinus de la valeur entre parenthèses. L’arcsinus est l’angle dont le sinus est la valeur entre parenthèses. L’angle obtenu est une valeur entre -pi/2 et pi/2 exprimée en radians. Pour que l’arcsinus soit exprimé en degrés, utilisez la fonction Rad_en_deg (ou multipliez le résultat par 180/pi). Ce nombre doit être compris entre 1 et -1. Fonction liée: sin
Exemple: =asin(A3) retourne l’angle correspondant à la valeur de sinus donnée dans la cellule A3.
Retourne la plus petite coordonnée y des objets répondant au critère de recherche (extrémité inférieure). Fonctions liées: LimiteGauche, LimiteDroite, LimiteSup
Exemples:
● Cellule d’en-tête d’une base de données: =LimiteInf retourne la limite inférieure de chaque objet dans la base de données.
● Cellule d’un tableau: =LimiteInf(t=mur) retourne la limite inférieure du mur situé le plus bas dans le dessin.
Retourne le nom de la classe des objets répondant au critère.
Exemples:
● Cellule d’en-tête d’une base de données: =Classe retourne la classe de chaque objet de la base de données.
● Cellule d’un tableau: =Classe(sel=true) retourne le nom de la classe des objets sélectionnés dans le dessin.
Retourne la surface (percements non inclus) d'un côté des composants répondant aux critères et appartenant à la classe indiquée. Fonctions liées: CompSurfNom, CompSurf
Exemples:
● Cellule d’en-tête d’une base de données: =CompSurfClasse('Classe-1') retourne la surface des composants dont la classe est 'Classe-1' pour chaque composant de mur, toiture, pan de toiture et plancher de la base de données.
● Cellule d’un tableau: =CompSurfClasse(t=mur,'Classe-1') retourne le total des surfaces des composants dont la classe est 'Classe-1' de tous les murs du dessin.
Retourne la surface (percements non inclus) d'un côté des composants répondant aux critères et portant le nom indiqué. Fonctions liées: CompSurfClasse, CompSurf
Exemples:
● Cellule d’en-tête d’une base de données: =CompSurfNom('Plaque brique') retourne comme résultat l'épaisseur des composants dont le nom est 'Plaque brique' pour chaque composant de mur, toiture, pan de toiture et plancher de la base de données.
● Cellule d’un tableau: =CompSurfNom(t=mur,'Plaque brique') retourne comme résultat le total des surfaces des composants dont la classe est 'Plaque brique' de tous les murs du dessin.
Retourne le nom des composants qui répondent aux critères et qui portent le nom indiqué. Fonction liée: CompSurfClasse
Exemples:
● Cellule d’en-tête d’une base de données: =CompClasseNom('Plaque brique') retourne la classe des composants dont le nom est 'Plaque brique' pour chaque composant de mur, toiture, pan de toiture et plancher de la base de données.
● Cellule d’un tableau: =CompClasseNom(t=mur, 'Plaque brique') indique comme résultat la classe du premier composant dont le nom est 'Plaque brique' de tous les murs dans le dessin.
Retourne la valeur lambda des composants qui répondent aux critères et qui appartiennent à la classe indiquée. Fonctions liées: CompLambdaNom, CompLambda
Exemples:
● Cellule d’en-tête d’une base de données: =CompLambdaClasse('Classe-1') retourne comme résultat la valeur lambda des composants dont la classe est 'Classe-1' pour chaque composant de mur, toiture, pan de toiture et plancher de la base de données.
● Cellule d’un tableau: =CompLambdaClasse(t=mur,'Classe-1') retourne comme résultat la valeur lambda du premier composant dont la classe est 'Classe-1' de tous les murs du dessin.
Retourne la valeur lambda des composants qui répondent aux critères et qui possèdent le nom indiqué. Fonctions liées: CompLambdaClasse, CompLambda
Exemples:
● Cellule d’en-tête d’une base de données: =CompLambdaNom('Plaque brique') retourne la valeur lambda des composants dont le nom est 'Plaque brique' pour chaque composant de mur, toiture, pan de toiture et plancher de la base de donnée.
● Cellule d’un tableau: =CompLambdaNom(t=mur,'Plaque brique') retourne la valeur lambda du premier composant dont le nom est 'Plaque brique' de tous les murs dans le dessin.
Retourne le nom des composants qui remplissent les critères et qui appartiennent à la classe indiquée Fonction liée: CompClasseNom
Exemples:
● Cellule d’en-tête d’une base de données: =CompClasseNom('Classe-1') retourne le nom des composants dont la classe est 'Classe-1' pour chaque composant de mur, toiture, pan de toiture et plancher de la base de données.
● Cellule d’un tableau: =CompClasseNom(t=mur,'Classe-1') retourne le nom du premier composant dont la classe est 'Classe-1' de tous les murs du dessin.
Retourne la surface d’une face du composant de mur ou de plancher, déduction faite d’ouvertures éventuelles. L’(index) identifie le composant par un nombre qui commence à 1. Fonction liée: CompSurfClasse, CompSurfNom
Exemples:
● Cellule d’en-tête d’une base de données: =SurfCompos(2) retourne la surface du deuxième composant de chaque plancher ou mur dans la base de données.
● Cellule d’un tableau: =SurfCompos(t=mur,1) retourne la surface totale du premier composant de tous les murs du dessin.
Retourne la valeur lambda des composants qui répondent aux critères et qui possèdent l'index indiqué. L’(index) identifie le composant par un nombre qui commence à 1. Fonctions liées: CompLambdaClasse, CompLambdaNom
Exemples:
● Cellule d’en-tête d’une base de données: =CompLambda(2) retourne la valeur lambda du deuxième composant de chaque mur, mur arrondi, toiture, pan de toiture et plancher de la base de données.
● Cellule d’un tableau: =CompLambda(t=mur,1) retourne la valeur lambda du premier composant de tous les murs du dessin.
Retourne le nom du composant de mur ou de plancher. L’(index) identifie le composant par un nombre qui commence à 1. Fonction liée: CompSurfClasse
Exemples:
● Cellule d’en-tête d’une base de données: =CompNom(2) retourne le nom du deuxième composant pour chaque mur ou plancher dans la base de données.
● Cellule d’un tableau: =CompNom(t=mur,1) retourne le nom du premier composant pour tous les murs dans le dessin.
Retourne la valeur R des composants qui répondent aux critères et qui possèdent l'index indiqué. L’(index) identifie le composant par un nombre qui commence à 1. Fonctions liées: CompValeurRClasse, CompValeurRNom
Exemples:
● Cellule d’en-tête d’une base de données: =CompValeurR(2) retourne comme résultat la valeur R du deuxième composant de chaque mur, mur arrondi, toiture, pan de toiture et plancher de la base de données.
● Cellule d’un tableau: =CompValeurR(t=mur,1) retourne le total des valeurs R des premiers composants de tous les murs du dessin.
Retourne l'épaisseur des composants qui répondent aux critères et qui possèdent l'index indiqué. L’(index) identifie le composant par un nombre qui commence à 1. Fonctions liées: CompEpaisseurClasse, CompEpaisseurNom
Exemples:
● Cellule d’en-tête d’une base de données: =CompEpaissaur(2) retourne l'épaisseur du deuxième composant de chaque mur, mur arrondi, toiture, pan de toiture et plancher de la base de données.
● Cellule d’un tableau: =CompEpaisseur(t=mur,1) retourne le total des épaisseurs des premiers composants de tous les murs du dessin.
Retourne la valeur U des composants qui répondent aux critères et qui possèdent l'index indiqué. L’(index) identifie le composant par un nombre qui commence à 1. Fonctions liées: CompValeurUClasse, CompValeurUNom
Exemples:
● Cellule d’en-tête d’une base de données: =CompValeurU(2) retourne la valeur U du deuxième composant de chaque mur, mur arrondi, toiture, pan de toiture et plancher de la base de données.
● Cellule d’un tableau: =CompValeurU(t=mur,1) retourne le total des valeurs U des premiers composants de tous les murs du dessin.
Retourne le volume du composant de mur ou de plancher, déduction faite d’éventuelles ouvertures. L’(index) identifie le composant par un nombre qui commence à 1. Fonctions liées: CompVolumeClasse, CompVolumeNom
Exemples:
● Cellule d’en-tête d’une base de données: =CompVol(2) retourne le volume du deuxième composant de chaque mur ou plancher dans la base de données
● Cellule d’un tableau: =CompVol(t=mur,1) retourne le volume cumulé du premier composant de tous les murs dans le dessin.
Retourne la valeur R des composants qui répondent aux critères et qui appartiennent à la classe indiquée. Fonctions liées: CompValeurRNom, CompValeurR
Exemples:
● Cellule d’en-tête d’une base de données: =CompValeurRClasse('Classe-1) retourne la valeur R des composants dont la classe est 'Classe-1' pour chaque composant de mur, toiture, pan de toiture et plancher de la base de données.
● Cellule d’un tableau: =CompValeurRClasse(t=mur,'Classe-1) retourne le total des valeurs R des composants dont la classe est 'Classe-1' de tous les murs du dessin.
Retourne la valeur R des composants qui répondent aux critères et qui portent le nom indiqué. Fonctions liées: CompValeurRNom, CompValeurR
Exemples:
● Cellule d’en-tête d’une base de données: =CompValeurRClasse('Plaque brique') retourne la valeur R des composants dont le nom est 'Plaque brique' pour chaque composant de mur, toiture, pan de toiture et plancher de la base de données.
● Cellule d’un tableau: =CompValeurRClasse(t=mur,'Plaque brique') retourne le total des valeurs R des composants dont le nom est 'Plaque brique' de tous les murs dans le dessin.
Retourne l'épaisseur des composants qui répondent aux critères et qui appartiennent à la classe indiquée. Fonctions liées: CompEpaisseurNom, CompEpaisseur
Exemples:
● Cellule d’en-tête d’une base de données: =CompEpaisseurClasse('Classe-1') retourne l'épaisseur des composants dont la classe est 'Classe-1' pour chaque composant de mur, toiture, pan de toiture et plancher de la base de données.
● Cellule d’un tableau: =CompEpaisseurClasse(t=mur,'Classe-1') retourne le total des épaisseurs des composants dont la classe est 'Classe-1' de tous les murs du dessin.
Retourne l'épaisseur des composants qui répondent aux critères et qui portent le nom indiqué. Fonctions liées: CompEpaisseurClasse, CompEpaisseur
Exemples:
● Cellule d’en-tête d’une base de données: =CompEpaisseurNom('Plaque brique') retourne l'épaisseur des composants dont le nom est 'Plaque brique' pour chaque composant de mur, toiture, pan de toiture et plancher de la base de données.
● Cellule d’un tableau: =CompEpaisseurNom(t=mur,'Plaque brique') retourne comme résultat le total des épaisseurs des composants dont le nom est 'Plaque brique' de tous les murs dans le dessin.
Retourne la valeur U des composants qui répondent aux critères et qui appartiennent à la classe indiquée. Fonctions liées: CompValeurUNom, CompValeurU
Exemples:
● Cellule d’en-tête d’une base de données: =CompValeurUClasse('Classe-1') retourne la valeur U des composants dont la classe est 'Classe-1' pour chaque composant de mur, toiture, pan de toiture et plancher de la base de données.
● Cellule d’un tableau: =CompValeurUClasse(t=mur,'Classe-1') retourne le total des valeurs U des composants dont la classe est 'Classe-1' de tous les murs du dessin.
Retourne la valeur U des composants qui répondent aux critères et qui portent le nom indiqué. Fonctions liées: CompValeurUClasse, CompValeurU
Exemples:
● Cellule d’en-tête d’une base de données: =CompValeurUNom('Plaque brique') retourne la valeur U des composants dont le nom est 'Plaque brique' pour chaque composant de mur, toiture, pan de toiture et plancher de la base de données.
● Cellule d’un tableau: =CompValeurUNom(t-mur,'Plaque brique') retourne le total des valeurs U des composants dont le nom est 'Plaque brique' de tous les murs dans le dessin.
Retourne le volume des composants qui remplissent les critères et qui appartiennent à la classe indiquée. Fonctions liées: CompVolumeNom, CompVol
Exemples:
● Cellule d’en-tête d’une base de données: =CompVolClasse('Classe-1') retourne le volume des composants dont la classe est 'Classe-1' pour chaque composant de mur, toiture, pan de toiture et plancher de la base de données.
● Cellule d’un tableau: =CompVolClasse(t=mur,'Classe-1') retourne le total des volumes des composants dont la classe est 'Classe-1' de tous les murs du dessin.
Retourne le volume des composants qui répondent aux critères et qui portent le nom indiqué. Fonctions liées: CompVolumeClasse, CompVol
Exemples:
● Cellule d’en-tête d’une base de données: =CompVolNom('Plaque brique') retourne le volume des composants dont le nom est 'Plaque brique' pour chaque composant de mur, toiture, pan de toiture et plancher de la base de données.
● Cellule d’un tableau: =CompVolNom(t=mur,'Plaque brique') retourne le total des volumes des composants dont le nom est 'Plaque brique' de tous les murs dans le dessin.
Assemble des chaînes de caractères en une seule chaîne.
Exemple: =concat(B3 ; ’, ’ ; B4) retourne le contenu des cellules B3 et B4 en une seule chaîne de caractères, en les séparant d’une virgule suivie d’un espace.
Retourne le cosinus (en radians) de la valeur entre parenthèses. La (valeur) est l’angle en radians dont vous souhaitez obtenir le sinus. Fonction liée: acos
Exemple: =cos(deg_en_rad(23)) traduit un angle de 23° par son équivalent en radians et retourne le cosinus de l’angle.
Retourne le nombre d’objets répondant au critère.
Exemples:
● Cellule d’en-tête d’une base de données: =Nombre retourne le nombre total d’objets pour chaque ligne dans la base de données
● Cellule d’un tableau: =Nombre (s=’divan’) retourne le nombre total de symboles nommés « divan » dans le dessin
* En combinaison avec la fonction NOMBRE, le critère SEL comptera les objets que vous ne pouvez pas sélectionner, tels que les éléments individuels d’un groupe. Le critère VSEL compte uniquement les objets visiblement sélectionnés, comme c’est le cas dans la palette Info Objet. Si par exemple, vous sélectionnez un groupe qui comprend 11 éléments, le critère SEL donnera la valeur 12 (le groupe + les 11 éléments). Le critère VSEL donnera la valeur 1 (uniquement le groupe).
Retourne la longueur totale des cadres et des profilés du mur-rideau qui répondent aux critères et qui se trouvent dans la classe indiquées. Laissez le nom de la classe vide pour trouver tous les cadres et profilés dans un mur-rideau. Fonctions liées: FacadeRidPanSurfNet, FacadeRidPanSurfBru
Exemples:
● Cellule d’en-tête d’une base de données: =MurRidCadreLong('') retourne la longueur totale des cadres et des profilés pour chaque mur-rideau dans la base de données.
● Cellule d’un tableau: =MurRidCadreLong(t=mur,'') retourne la longueur totale des cadres et des profilés pour chaque mur-rideau dans le dessin.
Retourne la surface brute des panneaux dans les murs qui répondent aux critères et se trouvent dans la classe indiquée. La surface brute comprend la partie du panneau couverte par les cadres et les profilés. Laissez le nom de la classe vide pour trouver tous les cadres et profilés dans un mur-rideau. Fonctions liées: FacadeRidCadreLong, FacadeRidPanSurfNet
Exemples:
● Cellule d’en-tête d’une base de données: =MurRidPanSurfBru('') retourne la surface brute totale des panneaux de chaque mur-rideau dans la base de données.
● Cellule d’un tableau: =MurRidPanSurfBru(t=mur,'') retourne la surface brute totale des panneaux de chaque mur-rideau dans le dessin).
Retourne la surface nette des panneaux dans les murs qui satisfont aux critères et se trouvent dans la classe indiquée. La surface nette ne comprend que la partie visible du panneau, entourée par les cadres et les profilés. Laissez le nom de la classe vide pour trouver tous les cadres et profilés dans un mur-rideau. Fonctions liées: FacadeRidCadreLong, FacadeRidPanSurfBru
Exemples:
● Cellule d’en-tête d’une base de données: =MurRidPanSurfNet('Classe-1') retourne la surface nette totale des panneaux des murs-rideaux dont la classe est 'Classe-1', de chaque mur-rideau dans la base de données.
● Cellule d’un tableau: =MurRidPanSurfNet(t=mur,'Classe 1') retourne la surface nette totale des panneaux des murs-rideaux dont la classe est 'Classe-1', de chaque mur-rideau dans le dessin.
Utilise un script pour déterminer le contenu d’une ligne de base de données et de ses sous-lignes. Exécute le VectorScript ou script Python indiqué en utilisant les paramètres joints au nom du script. Le résultat est une liste d’objets qui seront utilisés pour les sous-lignes dans l’ordre dans lequel ils apparaissent d’après le script. Un paramètre optionnel précédant le nom du script renvoie au chemin d'accès au dossier dans lequel est sauvegardé le script dans Vectorworks. Cliquez sur le lien ci-dessous pour afficher la liste ramenant aux différents dossiers Vectorworks.
developer.vectorworks.net/index.php/VS:GetFolderPath
Voir Exécuter des scripts depuis des tableaux pour plus d’informations.
Fonction liée: ExecuterScript
Exemples:
● Cellule d’en-tête d’une base de données: =BDDSelonScript(='mon script') exécute le VectorScript 'mon script' et donne comme résultat une valeur pour chaque objet de la base de données en les plaçant dans différentes sous-lignes.
● Cellule d’un tableau: =BDDSelonScript('FichierScript.py',2,1) transforme la ligne en ligne de base de données, exécute le script « FichierScript.py » dans le dossier « Plug-ins » de Vectorworks selon les paramètres « 2 » et « 1 » et retourne une valeur pour chaque objet dans la base de données en les plaçant dans différentes sous-lignes.
La valeur d’un champ de texte dynamique pour toutes les étiquettes de données qui respectent les critères définis et possèdent un champ de texte dynamique portant le nom défini dans la formule.
Exemples:
● Cellule d’en-tête d’une base de données: =ChampEtiqDonnees('Couleur') (où « Couleur » est le nom d’un champ de texte sur mesure dans une étiquette de données) retourne la valeur du champ « Couleur » (par exemple, Rouge) pour chaque étiquette de données dans la base de données.
● Cellule d’un tableau: =ChampEtiqDonnees(sel=true,‘Couleur') (où « Couleur » est le nom d’un champ de texte sur mesure dans une étiquette de données) retourne la valeur du champ « Couleur » (par exemple, Rouge) pour l’étiquette de données sélectionnée dans le dessin.
Convertit la valeur entre parenthèses en radians. (valeur) est l'angle en degrés que vous souhaitez convertir
Exemple: =deg2rad(90) transforme l’angle de 90° par son équivalent en radians
Élève la base du logarithme e à la puissance (valeur). La base du logarithme naturel est équivalant à 2,7182818... La (valeur) est donc l’exposant appliqué à e.
Exemple =exp(2) donne la valeur numérique de e élevé à la puissance 2.
(module d'extension Vectorworks requis) Retourne la valeur d’une propriété COBie associée à un objet IFC. Le critère se compose de deux éléments séparés d’un point. Le premier élément est le nom du tableau COBie et le deuxième élément est le nom de la colonne dans ce tableau.
Exemple: =GETCOBIEPROPERTY ('space.floorname') retourne la valeur FloorName pour les objets dont la propriété COBie est Space
(module d'extension Vectorworks requis) Retourne la source des données du tableau sélectionné et de la colonne d’un objet. Le critère se compose de deux éléments séparés d’un point. Le premier élément est le nom du tableau COBie et le deuxième élément est le nom de la colonne dans ce tableau.
Exemple: =GETCOBIESOURCE ('space.floorname') retourne les données FloorName pour les objets dont la propriété COBie est Space
(module d'extension Vectorworks requis) Retourne la valeur d’une propriété IFC spécifique associée à un objet IFC. Le critère se compose de deux éléments séparés d’un point. Le premier élément est soit une entité IFC, soit le nom d’un PSet et le deuxième élément est le nom de la propriété IFC.
Exemple: =GetIFCProperty ('ifcfurnishingelement.name') retourne le nom des objets IFC dont l’entité IFC est IfcFurnishingElement.
(Module Architecture requis) Retourne le nom de l'espace dans lequel l'objet répondant aux critères se trouve. Fonction liée: EspaceNumObj
Exemples:
● Cellule d’en-tête d’une base de données: =EspaceNomObj retourne le nom de l'espace de chaque objet dans la base de données.)
● Cellule d’un tableau: =EspaceNomObj(n='chaise-1') retourne le nom de l'espace dans lequel se trouve l'objet 'chaise-1'.
(module Architecture requis) Retourne le numéro de l'espace dans lequel l'objet répondant aux critères se trouve. Fonction liée: EspaceNomObj
Exemples:
● Cellule d’en-tête d’une base de données: =EspaceNumObj retourne comme résultat le numéro de l'espace de chaque objet dans la base de données.
● Cellule d’un tableau: =EspaceNumObj(n='chaise-1') retourne comme résultat le numéro de l'espace dans lequel se trouve l'objet 'chaise-1'.
Retourne le dégradé des objets répondant au critère.
Exemples:
● Cellule d’en-tête d’une base de données: =RemplDegrade retourne le dégradé utilisé pour le remplissage de chaque objet de la base de données.
● Cellule d’un tableau: RemplDegrade(sel=true) retourne le dégradé utilisé pour le remplissage des objets sélectionnés dans le dessin.
Retourne la hachure des objets répondant au critère.
Exemples:
● Cellule d’en-tête d’une base de données: =RemplHachure retourne la hachure utilisée pour les chaque objet de la base de données.
● Cellule d’un tableau: =RemplHachure(sel=true) retourne la hachure utilisée pour le remplissage des objets sélectionnés dans le dessin.
Retourne la somme des hauteurs (±y) des objets répondant au critère. Fonction liée: Largeur
Exemples:
● Cellule d’en-tête d’une base de données: =Hauteur retourne la hauteur (delta y) de chaque objet de la base de données.
● Cellule d’un tableau: =Hauteur(sel=true) retourne la hauteur cumulée (delta y) des objets sélectionnés dans le dessin.
Retourne la valeur_si_vrai si la condition est remplie, sinon la valeur_si_faux.
Utilisez cette fonction pour effectuer des tests conditionnels sur des valeurs et formules, et agir ensuite en fonction de l’issue de ces tests. L’issue du test déterminera la valeur retournée par la fonction. La (condition) peut être n’importe quelle valeur ou expression pouvant être évaluée vraie ou fausse. Vous pouvez définir jusqu’à 7 conditions comme arguments des valeur_si_vrai et valeur_si_faux. Les propositions booléennes à l’intérieur d’une instruction conditionnelle doivent être entre parenthèses.. Les textes à l’intérieur d’une instruction conditionnelle doivent être entre guillemets.
Exemples:
● =si(('Arbre existant'.’État de santé'='Sans'), '-', 'Arbre'.’État de santé') Si aucun état de santé n’a été défini pour l’arbre existant, la cellule contiendra un tiret. Sinon, cette cellule reprendra l’état de santé défini pour l’arbre existant.
● =si(('Arbre existant'.’État de santé'='Sans'); '-'; 'Arbre'.’État de santé')
(module d’extension Vectorworks requis) Retourne l’image de l'objet répondant au critère. Précisez si la cellule doit afficher une miniature de l'objet ou les propriétés 2D de l'objet.
Exemples:
● Cellule d’en-tête d’une base de données: =Image retourne l’image de chaque objet dans la base de données.
● Cellule d’un tableau: =Image(s=’armoire’) retourne l'image du symbole dont le nom est « Armoire ».
Retourne la texture 2D des objets qui répondent aux critères spécifiés.
Exemples:
● Cellule d’en-tête d’une base de données: =RemplTexture2D retourne la texture 2D utilisée pour le remplissage de chaque objet de la base de données.
● Cellule d’un tableau: =RemplTexture2D(sel=true) retourne la texture 2D utilisée pour le remplissage des objets sélectionnés dans le dessin.
Supprime la partie décimale de la valeur vers le bas afin de retourner un nombre entier. (valeur) est le nombre réel que vous souhaitez arrondir. Fonction liée: arrondi
Exemple =int(1,698) retourne la valeur sans ses décimales: 1.
Retourne le nombre d’objets miroités répondant au critère.
Exemples:
● Cellule d’en-tête d’une base de données: =EnMiroir indique pour chaque objet dans la base de données s’il est miroité ou non.
● Cellule d’un tableau: =EnMiroir(C=Fenêtres) retourne le nombre total d’objets de la classe Fenêtres qui sont miroités.
Retourne le nom du calque des objets répondant au critère.
Exemples:
● Cellule d’en-tête d’une base de données: =Calque retourne le calque de chaque objet de la base de données.
● Cellule d’un tableau: =Calque(sel=true) retourne le nom du calque des objets sélectionnés dans le dessin.
Retourne la plus petite coordonnée x des objets répondant au critère de recherche (extrémité gauche). Fonctions liées: LimiteInf, LimiteSup, LimiteDroite
Exemples:
● Cellule d’en-tête d’une base de données: =LimiteGauche retourne la limite de gauche de chaque objet dans la base de données
● Cellule d’un tableau: =LimiteGauche(t=mur) retourne la limite de gauche du mur le plus à gauche dans le dessin.
Retourne la longueur des lignes, murs ou objets basés sur un parcours.
Exemples:
● Cellule d’en-tête d’une base de données: =Longueur retourne la longueur de chaque objet dans la base de données.
● Cellule d’un tableau: =Longueur(t=line) retourne la longueur totale de tous les objets de type ligne dans le dessin.
Retourne le style de trait des objets qui répondent aux critères spécifiés.
Exemples:
● Cellule d’en-tête d’une base de données: =StyleTrait retourne le style de trait utilisé pour chaque objet de la base de données.
● Cellule d’un tableau: =StyleTrait(sel=true) retourne le style de trait des objets sélectionnés dans le dessin.
Retourne le logarithme népérien de la valeur entre parenthèses. (valeur) est le nombre réel positif dont vous souhaitez calculer le logarithme. Fonction liée: exp
Exemple =ln(12) retourne le logarithme naturel de 12)
Retourne le logarithme d'un chiffre en base 10. (valeur) est le nombre réel positif dont vous souhaitez calculer le logarithme. Fonction liée: ln
Exemple =ln(12) retourne le logarithme naturel de 12)
Retourne le plus grand des nombres de la liste. La liste peut comporter 1 à 14 valeurs. Fonction liée: min
Exemple =max(C5;C6;C7) retourne la valeur la plus élevée parmi les cellules C5, C6, C7.
Retourne le plus petit des nombres de la liste. La liste peut comporter 1 à 14 valeurs. Fonction liée: max
Exemple =min(C5;C6;C7) retourne la valeur la plus basse parmi les cellules C5, C6, C7.
Retourne le nom des objets répondant au critère.
Exemples:
● Cellule d’en-tête d’une base de données: =Nom retourne le nom de chaque objet dans la base de données.
● Cellule d’un tableau: =Nom(sel=true) retourne le nom des objets sélectionnés dans le dessin.
Retourne la texture des objets répondant au critère.
Exemples:
● Cellule d’en-tête d’une base de données: =TextureObj retourne la texture de chaque objet de la base de données.
● Cellule d’un tableau: =TextureObj(sel=true) retourne la texture des objets sélectionnés dans le dessin.
Retourne le type de l'objet qui répond aux critères. Une liste reprenant tous les types d'objets est disponible à l'adresse suivante:
http://developer.vectorworks.net/index.php/VS:Function_Reference_Appendix#objects
Exemples:
● Cellule d’en-tête d’une base de données: =TypeObjet retourne l'ID du type de chaque objet dans la base de données.
● Cellule d’un tableau: =TypeObjet(sel=vrai) retourne le type de l'objet sélectionné, par exemple: le type d'une source lumineuse est 81.
Retourne le nom du type des objets répondant au critère.
Exemples:
● Cellule d’en-tête d’une base de données: =NomTypeObj retourne le nom du type de chaque objet dans la base de données.
● Cellule d’un tableau: =NomTypeObj(sel=true) retourne le nom du type des objets sélectionnés dans le dessin.
(Vectorworks Architecture requis)Retourne le statut Energos des objets répondant aux critères (1 si l'objet est repris dans le calcul, 0 si ce n'est pas le cas).
Exemples:
● Cellule d’en-tête d’une base de données: =ObjInclureEnergos retourne le statut Energos de chaque mur, mur arrondi, toiture, pan de toiture et plancher de la base de données.
● Cellule d’un tableau: =ObjInclureEnergos(t=mur) retourne le statut Energos de tous les murs dans le dessin.
(Vectorworks Architecture requis) Retourne la valeur R des objets répondant au critère de recherche (extrémité inférieure). Fonction liée: ObjValeurU
Exemples:
● Cellule d’en-tête d’une base de données: =ObjValeurR retourne la valeur R de chaque mur, mur arrondi, toiture, pan de toiture et plancher de la base de données.
● Cellule d’un tableau: =ObjValeurR (n='mur-1') retourne la valeur R du mur 'Mur-1'.
(Vectorworks Architecture requis) Retourne la valeur U des objets répondant au critère de recherche. Fonction liée: ObjValeurR
Exemples:
● Cellule d’en-tête d’une base de données: =ObjValeurU retourne la valeur U de chaque mur, mur arrondi, toiture, pan de toiture et plancher de la base de donnée.
● Cellule d’un tableau: =ObjValeurU(n='mur-1') retourne la valeur U du mur 'Mur-1'.
Retourne le périmètre des objets répondant au critère.
Exemples:
● Cellule d’en-tête d’une base de données: =Perim retourne le périmètre de chaque objet dans la base de données.
● Cellule d’un tableau: =Perim(sel=vrai) retourne le périmètre total des objets sélectionnés.
(Vectorworks Paysage requis) Retourne l'image des données du style de plante qui répond aux critères. Indiquez 1, 2, 3 ou 4 pour définir l’image respectivement à partir des champs Image Plant Form, Image Detail, Image Misc ou Custom Image. Dans la formule, identifiez la plante grâce des critères (en sélectionnant la plante avec des critères comme Valeur de champ = ID de la plante = xx).
Exemples:
● Cellule d’en-tête d’une base de données: =ImagePlante(2) affiche l’image définie pour le champ Image Detail dans l’onglet « Données de la plante » de la description de la plante.
● Cellule d’un tableau: =ImagePlante((‘Plante’.’ID de la plante’=’TaxfR’), 4) affiche l’image définie pour le champ Custom Image de l’onglet « Données de la plante» de la description de la plante avec un ID « TaxfR ».
Convertit l'angle en radians indiqué en degrés. (valeur) est la valeur de l'angle en radians que vous souhaitez convertir.
Exemple: =rad2deg(0,5235987) transforme l’angle en radians par son équivalent en degrés.
Retourne la plus grande coordonnée x des objets répondant au critère de recherche (extrémité droite). Fonctions liées: LimiteInf, LimiteSup, LimiteGauche
Exemples:
● Cellule d’en-tête d’une base de données: =LimiteDroite retourne la limite de droite de chaque objet dans la base de données.
● Cellule d’un tableau: =LimiteDroite(t=mur) retourne la limite de droite du mur le plus à droite dans le dessin.
Retourne la surface totale de la partie chauffée d’une toiture le long de la pente. Les parties de toiture qui dépassent des murs sont ignorées. Fonction liée: ToitSurfChauffProj
Exemples:
● Cellule d’en-tête d’une base de données: =ToitSurfChauff retourne la surface de la zone chauffée de chaque toiture et pan de toiture dans la base de données.
● Cellule d’un tableau: =ToitSurfChauff(st=pantoiture) retourne la surface totale chauffée de tous les pans de toiture dans le dessin.
Retourne la surface totale projetée sur le plan horizontal des toitures qui satisfont au critère. Les parties de toiture qui dépassent des murs sont ignorées Fonction liée: ToitSurfChauff
Exemples:
● Cellule d’en-tête d’une base de données: =ToitSurfChauffProj (retourne la surface de la zone chauffée de chaque toiture et pan de toiture dans la base de données, projetée sur le plan du calque)
● Cellule d’un tableau: =ToitSurfChauffProj(T=toiture) (retourne la surface totale chauffée de toutes les toitures dans le dessin, projetée sur le plan du calque)
Retourne la surface totale le long de la pente des toitures qui satisfont au critère. Fonction liée: ToitSurfTotaleProj
Exemples:
● Cellule d’en-tête d’une base de données: =ToitSurfTotale retourne la surface totale de chaque toiture et pan de toiture dans la base de données
● Cellule d’un tableau: =ToitSurfTotale(ST=PANTOITURE) retourne la surface cumulée totale de tous les pans de toiture dans le dessin.
Retourne la surface totale projetée sur le plan horizontal des toitures qui satisfont au critère. Les parties de toiture qui dépassent des murs sont prises en compte. Fonction liée: ToitSurfTotale
Exemples:
● Cellule d’en-tête d’une base de données: =ToitSurfTotaleProj retourne la surface totale de chaque toiture et pan de toiture dans la base de données, projetée sur le plan du calque.
● Cellule d’un tableau: =ToitSurfTotaleProj(T=TOITURE) retourne la surface totale cumulée de toutes les toitures dans le dessin, projetée sur le plan du calque.
module d'extension Vectorworks requis)Retourne le nom du style de toit.
Exemples:
● Cellule d’en-tête d’une base de données: =ToitStyle retourne le nom du style de toit de toutes les toitures de la base de données.
● Cellule d’un tableau: =ToitStyle(n='toiture-1') retourne le nom du style de toit de la toiture portant le nom 'toiture-1.
Retourne l'arrondi entier de la valeur entre parenthèses. Fonction liée: int
Exemple: =arrondi(2.345) retourne la valeur de 2.
Arrondit la valeur précisée vers le bas selon le nombre de décimales indiqué. Fonctions liées: arrondi, arrondihaut
Exemple: =ArrondiBas(2.345, 2) retourne 2.34
Arrondit la valeur précisée vers le haut selon le nombre de décimales indiqué. Fonctions liées: arrondi, arrondibas
Exemple: =ArrondiHaut(2.345, 2) retourne 2.35
Exécute le VectorScript ou script Python indiqué en utilisant les paramètres joints au nom du script. Un paramètre optionnel précédant le nom du script renvoie au chemin d'accès au dossier dans lequel est sauvegardé le script dans Vectorworks. Cliquez sur le lien ci-dessous pour afficher la liste ramenant aux différents dossiers Vectorworks.
developer.vectorworks.net/index.php/VS:GetFolderPath
Voir Exécuter des scripts depuis des tableaux pour plus d’informations.
Fonction liée: BDDSelonScript
Exemples:
● Cellule d’en-tête d’une base de données: =ExecuterScript(='mon script') exécute le VectorScript 'mon script' et donne comme résultat une valeur pour chaque objet de la base de données.
● Cellule d’un tableau: =ExecuterScript(2,'ScriptFile.py',2.1) exécute le script Python 'ScriptFile.py' dans le dossier Vectorworks contenant les plug-ins, suivant les paramètres 2 et 1 et donne comme résultat une valeur.
Retourne le sinus de la valeur entre parenthèses. La (valeur) est l’angle en radians dont vous souhaitez obtenir le sinus. Fonction liée: asin
Exemple: =sin(deg2rad(32)) traduit l’angle de 32° par son équivalent en radians et retourne le sinus de l’angle.
Retourne le nom du style de sketch des objets qui répondent aux critères.
Exemples:
● Cellule d’en-tête d’une base de données: =StyleSketch retourne le style de sketch de chaque objet dans la base de données.
● Cellule d’un tableau: =StyleSketch(sel=true) retourne le style de sketch des objets sélectionnés dans le dessin.
(Module Architecture requis) Retourne le nom du style de plancher.
Exemple:
● Cellule d’en-tête d’une base de données: =DalleStyle retourne le nom du style de plancher pour chaque plancher du dessin.
● Cellule d’un tableau: =DalleStyle(n=’plancher-1’) retourne le nom du style de plancher pour l’objet du dessin nommé « plancher-1 ».
(module d’extension Vectorworks requis) Retourne l’épaisseur des objets plancher (dalless et pans de toiture) répondant au critère.
Exemples:
● Cellule d’en-tête d’une base de données: =DalleEpaisseur retourne l’épaisseur de chaque objet dans la base de données.
● Cellule d’un tableau: =DalleEpaisseur(PON=’slab’) retourne l’épaisseur totale de tous les objets plancher dans le dessin.
Retourne la racine carrée de la valeur entre parenthèses. (valeur) est le nombre dont vous souhaitez calculer la racine carrée.
Exemple: =racine(D7) retourne la racine carrée positive du nombre dans la cellule D27.
Retourne le nom de l’étage des objets répondant au critère.
Exemples:
● Cellule d’en-tête d’une base de données: =Etage retourne le nom de l’étage de chaque objet dans la base de données.
● Cellule d’un tableau: =Etage(sel=true) retourne le nom de l’étage des objets sélectionnés dans le dessin.
Divise le texte en une série de chaînes de caractères à l’aide d’un caractère séparateur et retourne la sous-chaîne de l’index donné.
Exemple: =SubString('Salle de bain;Cuisine;Salon;Chambre'; ';'; 2 retourne la « Cuisine », qui est le deuxième élément cité.
Retourne la somme des valeurs entre parenthèses. Vous pouvez calculer la somme de 14 valeurs maximum. Fonction liée: moyenne
Exemple: =somme(A2;A10...A12) retourne la somme des nombres contenus dans les cellules A2, A10, A11 et A12.
Retourne la surface totale des objets répondant au critère, selon l’unité définie pour les volumes dans la boîte de dialogue « Unités ».
Exemples:
● Cellule d’en-tête d’une base de données: =SurfEnveloppe (retourne la surface de chaque objet de la base de données.
● Cellule d’un tableau: =SurfEnveloppe retourne la surface cumulée totale de tous les pans de toiture dans le dessin.
Retourne le nom du symbole pour les exemplaires de symbole répondant au critère.
Exemples:
● Cellule d’en-tête d’une base de données: =NomSymbole retourne le nom du symbole pour chaque exemplaire de symbole dans la base de données.
● Cellule d’un tableau: =NomSymbole(sel=true) retourne le le nom du symbole pour les exemplaires de symbole sélectionnés dans le dessin.
Retourne la tangente de la valeur entre parenthèses. La (valeur) est l’angle en radians dont vous souhaitez obtenir la tangente. Fonction liée: atan
Exemple: =tan(deg2rad(32)) traduit l’angle de 32° par son équivalent en radians et retourne le sinus de l’angle.
Retourne la plus grande coordonnée y des objets répondant au critère de recherche (extrémité supérieure). Fonctions liées: LimiteInf, LimiteGauche, LimiteDroite
Exemples:
● Cellule d’en-tête d’une base de données: =LimiteSup retourne la limite supérieure de chaque objet dans la base de données.
● Cellule d’un tableau: =LimiteSup(t=mur) retourne la limite supérieure du mur situé le plus haut dans le dessin.
Convertit une chaîne de caractères qui représente un nombre, en valeur numérique.
Exemple: =value('2e3') retourne la valeur numérique de 2 multiplié par 10³.
Retourne le volume total des objets répondant au critère, selon l’unité définie pour les volumes dans la boîte de dialogue « Unités ».
Exemples:
● Cellule d’en-tête d’une base de données: =Volume retourne le volume de chaque objet dans la base de données.
● Cellule d’un tableau: =Volume(t=xtrd) retourne le volume total de tous les objets extrudés dans le dessin.
Retourne la moyenne des surfaces brutes 2D des faces intérieures et extérieures des murs répondant aux critères. Les percements muraux sont ignorés. Fonctions liées: MurSurfaceNette, CompSurf, CompSurfClasse, CompSurfNom
Exemples:
● Cellule d’en-tête d’une base de données: =MurSurfaceBrute retourne la moyenne des surfaces brutes des faces intérieures et extérieures des murs de la base de données. Les percements muraux sont ignorés.
● Cellule d’un tableau: =MurSurfaceBrute(t=mur) retourne la moyenne des surfaces brutes des faces intérieures et extérieures de tous les murs du dessin. Les percements muraux sont ignorés.
Retourne la moyenne des surfaces nettes 2D des faces intérieures et extérieures des murs répondant aux critères. Les percements muraux sont pris en compte. Fonctions liées: MurSurfaceBrute, CompSurf, CompSurfClasse, CompSurfNom
Exemples:
● Cellule d’en-tête d’une base de données: =MurSurfaceNette retourne la moyenne des surfaces nettes des faces intérieures et extérieures des murs de la base de données. Les percements muraux sont pris en compte.
● Cellule d’un tableau: =MurSurfaceNette(t=mur) retourne la moyenne des surfaces nettes des faces intérieures et extérieures de tous les murs du dessin. Les percements muraux sont pris en compte.
Retourne la hauteur moyenne des murs qui satisfont aux critères.
Exemples:
● Cellule d’en-tête d’une base de données: =MurHauteurMoyenne retourne la hauteur moyenne de chaque mur dans la base de données.
● Cellule d’un tableau: =MurHauteurMoyenne((t=mur)&(sel=vrai)) retourne la hauteur moyenne de tous les murs sélectionnés dans le dessin.
(module d’extension Vectorworks requis) Retourne le nom du style de mur.
Exemple:
● Cellule d’en-tête d’une base de données: =MurStyle retourne le nom du style de mur de tous les murs de la base de données.
● Cellule d’un tableau: =MurStyle(n=’mur-1’) retourne le nom du style de plancher pour l’objet du dessin nommé « mur-1 ».
Retourne l'épaisseur des murs répondant au critère de recherche.
Exemples:
● Cellule d’en-tête d’une base de données: =MurEpaisseur retourne l’épaisseur de chaque mur dans la base de données.
● Cellule d’un tableau: =MurEpaisseur(t=mur) retourne l'épaisseur totale de tous les murs dans le dessin.
Retourne la valeur de largeur (±x) des objets répondant au critère de recherche. Fonction liée: Hauteur
Exemples:
● Cellule d’en-tête d’une base de données: =Largeur retourne la largeur (delta x) de chaque objet dans la base de données
● Cellule d’un tableau: =Largeur(sel=vrai) retourne la largeur cumulée (delta Z) de l’objet sélectionné.
Retourne la coordonnée x du centre de l’objet répondant au critère. Fonctions liées: YCentre, ZCentre, XCoordonnée
Exemples:
● Cellule d’en-tête d’une base de données: =XCentre retourne la coordonnée x du centre de chaque objet dans la base de données.
● Cellule d’un tableau: =XCentre(sel=vrai) retourne la coordonnée x du centre de l’objet sélectionné.
Retourne la coordonnée x du point d’insertion de l’objet répondant au critère, par rapport à l’origine de l’utilisateur. Fonctions liées: YCoordonnée, ZCoordonnée, XCentre
Exemple:
● Cellule d’en-tête d’une base de données: =XCoordonnée(sel=vrai) retourne la valeur de la coordonnée X pour chaque objet dans la base de données.
Retourne la coordonnée y du centre de l’objet répondant au critère. Fonctions liées: XCentre, ZCentre, YCoordonnée
Exemples:
● Cellule d’en-tête d’une base de données: =YCentre retourne la coordonnée y du centre de chaque objet dans la base de données.
● Cellule d’un tableau: =YCentre(sel=vrai) retourne la coordonnée y du centre de l’objet sélectionné.
Retourne la coordonnée y du point d’insertion de l’objet répondant au critère, par rapport à l’origine de l’utilisateur. Fonctions liées: XCoordonnée, ZCoordonnée, YCentre
Exemple:
● Cellule d’en-tête d’une base de données: =YCoordonnée retourne la coordonnée y de chaque objet dans la base de données.
Retourne la coordonnée z du centre de l’objet répondant au critère. Fonctions liées: XCentre, YCentre, ZCoordonnée
Exemples:
● Cellule d’en-tête d’une base de données: =ZCentre retourne la coordonnée z du centre de chaque objet dans la base de données.
● Cellule d’un tableau: =ZCentre(sel=vrai) retourne la coordonnée z du centre de l’objet sélectionné.
Retourne la coordonnée Z du point d’insertion de l’objet répondant au critère, par rapport à l’origine de l’utilisateur. Cette valeur est relative à l’origine de l’utilisateur. Fonctions liées: XCoordonnée, YCoordonnée, ZCentre
Exemple:
● Cellule d’en-tête d’une base de données: =ZCoordonnée retourne la coordonnée z de chaque objet dans la base de données.