Le funzioni di calcolo dei Fogli Elettronici

Le Funzioni permettono di prendere decisioni, compiere azioni e restituire valori nei Fogli Elettronici di Vectorworks. Le Funzioni ricevono un argomento, eseguono un’azione e restituiscono un valore o un insieme di valori. Ci sono due tipi fondamentali di Funzioni: quelle che utilizzano i valori inseriti e quelle che utilizzano le informazioni ricavate dagli oggetti presenti sul disegno. Gli argomenti richiesti dai due tipi di funzione sono differenti.

        Numeri o argomenti di testo: Le Funzioni con le iniziali minuscole, conosciute come Funzioni proprie dei Fogli Elettronici, si aspettano come argomento un valore numerico o un range di celle; ad esempio la funzione acos restituisce l’arcoseno del valore specificato come argomento, che può essere una espressione matematica (ad esempio 3/5), un indirizzo di una cella che contiene un numero (ad esempio A12) o un numero. L’argomento per tutte le Funzioni trigonometriche deve essere e spresso in radianti.

        Argomenti di criterio: le Funzioni che iniziano con una lettera maiuscola devono essere applicate a uno o più oggetti presenti sul disegno. In una cella di una riga di Schedario una funzione viene automaticamente applicata agli oggetti riportati nelle sottorighe, per cui non è necessario alcun argomento di criterio.
In una cella normale, è però necessario inserire un criterio per selezionare gli oggetti a cui applicare la funzione. Per esempio la funzione “Width” restituisce come risultato la larghezza di un oggetto. Per specificare di quale oggetto ottenere la larghezza, è possibile utilizzare il comando Incolla Criterio nel menu speciale del Foglio Elettronico oppure inserire manualmente il criterio. Per dettagli su come specificare il criterio come il tipo di oggetto, la Categoria o la visibilità, consultare la documentazione per sviluppatori all’indirizzo:
http://developer.vectorworks.net

        Proprietà dei Materiali: nei prodotti Design Series, i dati delle Risorse Materiali possono essere rendicontati per proprietà. Le funzioni di Foglio Elettronico appaiono nella lista alfabetica delle funzioni; per trovare una lista dei nomi e dei tipi di funzioni MaterialProperty da usare per creare abaci, vedere la documentazione orientata agli sviluppatori accedendo all’indirizzo Internet:

https://developer.vectorworks.net/index.php/VS:Working_with_Materials#MaterialProperty_values

La seguente tabella elenca in modo alfabetico tutte le Funzioni disponibili per i Fogli Elettronici di Vectorworks.

Funzione

Restituisce

Esempio

Funzioni correlate

acos(numero)

L’arcocoseno di numero. L’arcocoseno è l’angolo il cui coseno è numero. L’angolo restituito è espresso in radianti nel range 0 a π.

Numero è il coseno dell’angolo, e deve essere compreso fra -1 e 1.

=acos(3/5)

restituisce come risultato l’angolo il cui valore di coseno è 3/5

cos

Angle(criterio)

La somma di tutti gli angoli che corrispondono al criterio specificato, in gradi

Usare questa funzione per ricavare gli angoli delle linee o dei muri (misurati dall’orizzontale), l’angolo di ampiezza degli archi, l’angolo di pendenza dei solai.

Cella Riga Schedario:

=Angle

restituisce l’angolo di ogni oggetto nello Schedario

Cella Riga Foglio Elettronico:

=Angle(t=arc) & (n=

restituisce come risultato l’angolo spicchio dell’oggetto Arco chiamato “arco-1”

 

Area(criterio)

L’area totale degli oggetti 2D che soddisfano i criteri, in base all’Unità di misura definita per le superfici a livello di documento.

Cella Riga Schedario:

=Area

restituisce l’area di ogni oggetto nello Schedario

Cella Riga Foglio Elettronico:

=Area(T=rect)

restituisce come risultato l’area di tutti gli oggetti Rettangolo presenti sul disegno

Perim

asin(numero)

L’arcoseno di numero. L’arcoseno è l’angolo il cui seno è numero. L’angolo restituito è espresso in radianti ed è compreso fra -π/2 e π/2. Per esprimere l’arcoseno in gradi, usare la funzione rad2deg (o moltiplicare il risultato per 180/π).

Numero è il seno dell’angolo, e deve essere compreso fra -1 e 1.

=asin(A3)

restituisce come risultato l’angolo il cui valore di seno è specificato nella cella A3

 

sin

atan(numero)

L’arcotangente di numero. L’arcotangente è l’angolo la cui tangente è numero. L’angolo restituito è espresso in radianti ed è compreso fra -π/2 e π/2. Per esprimere l’arcotangente in gradi, usare la funzione rad2deg (o moltiplicare il risultato per 180/π).

Numero è la tangente dell’angolo cercato.

=atan(4/3)

restituisce come risultato l’angolo il cui valore di tangente è 4/3

tan

average(numero1,
numero2...)

La media degli argomenti.

=average(85,70,95)

restituisce come risultato la media di tre numeri

max, min, sum

BotBound(criterio)

La minima coordinata y degli oggetti che soddisfano i criteri.

Cella Riga Schedario:

=BotBound

restituisce coordinata Y di ogni oggetto nello Schedario

Cella Riga Foglio Elettronico:

=BotBound(t=locus)

restituisce come risultato la coordinata Y del Punto che ha il valore più basso di coordinata Y nel disegno

LeftBound,
RightBound,
TopBound

Class(criterio)

Il nome della Categoria che degli oggetti che soddisfano i criteri specificati.

Cella Riga Schedario:
=Class

restituisce la Categoria di ogni oggetto nello Schedario

Cella Riga Foglio Elettronico

=Class

restituisce la Categoria degli oggetti selezionati nel disegno

 

CompAreaByClass
(criterio, categoria)

Area (meno i fori) di una faccia dei componenti che soddisfano i criteri specificati e sono assegnati nella Categoria specificata.

Cella Riga Schedario:

=CompAreaByClass(‘Categoria-1’)

restituisce l’area dei componenti assegnati alla Categoria “Categoria-1” per ciascun muro, muro curvo, tetto, falda e solaio nello Schedario

Cella Riga Foglio Elettronico:

=CompAreaByClass(t=muro, ‘Categoria-1’)

restituisce l’area combinata dei componenti assegnati alla Categoria “Categoria-1” per tutti i muri nel disegno

CompAreaBy­Name, Componen­tArea

CompAreaByMat
(criterio, materiale)

Area (meno i fori) di una faccia dei componenti che soddisfano i criteri specificati e usano il materiale specificato.

Cella Riga Schedario:

=CompAreaByMat(‘Mortar MT’)

restituisce l’area combinata dei componenti che usano il materiale “Mortar MT” per ogni muro, muro curvo, falda tetto e solaio nel database

Cella Riga Foglio Elettronico:

=CompAreaByMat(t=muro, ‘Mortar MT’)

restituisce l’area combinata dei componenti che usano il materiale “Mortar MT” per i muri nel disegno

CompAreaByClass, CompAreaBy­Name, Componen­tArea

CompAreaByName
(criterio, nome)

Area (meno i fori) di una faccia dei componenti che soddisfano i criteri specificati e hanno il nome indicato.

Cella Riga Schedario:

=CompAreaByName(‘Rivestimento mat­toni’)

restituisce l’area dei componenti con il nome Rivestimento mattoni’ per ciascun muro, muro curvo, tetto, falda e solaio nello Schedario

Cella Riga Foglio Elettronico:

=CompAreaByName(‘Rivestimento mat­toni’)

restituisce l’area combinata dei componenti con il nome Rivestimento mattoni’ per tutti i muri nel disegno

CompAreaByClass, ComponentArea

CompClassByMat
(criterio, materiale)

La Categoria dei componenti che soddisfano i criteri ed usano il materiale specificato.

Cella Riga Schedario:

=CompClassByMat(‘Mortar MT’)

restituisce la Categoria del primo componente che usa il materiale “Mortar MT” per ogni muro, muro curvo, tetto, falda tetto e solaio nel database

Cella Riga Foglio Elettronico:

=CompClassByMat(t=muro, ‘Mortar MT’)

restituisce la Categoria del primo componente che usa il materiale “Mortar MT” per tutti i muri nel disegno

CompMatByClass, CompClassByName

CompClassByName
(criterio, nome)

La Categoria dei componenti che soddisfano i criteri specificati a hanno il nome indicato.

Cella Riga Schedario:

=CompClassByName(‘Rivestimento mat­toni’)

restituisce la Categoria dei componenti con il nome Rivestimento mattoni’ per ciascun muro, muro curvo, tetto, falda e solaio nello Schedario

Cella Riga Foglio Elettronico:

=CompClassByName(‘Rivestimento mat­toni’)

restituisce la Categoria del primo componente con il nome Rivestimento mattoni’ per tutti i muri nel disegno

CompNameByClass

CompLambdaByClass (criterio, categoria)

Il valore Lambda dei componenti che soddisfano i criteri e appartengono alla Categoria specificata.

Cella Riga Schedario:

=CompLambdaByClass(‘Categoria-1’)

restituisce il valore Lambda dei componenti con il nome “Categoria-1” per ciascun muro, muro curvo, tetto, falda e solaio nello Schedario

Cella Riga Foglio Elettronico:

=CompLambdaByClass(‘Categoria-1’)

restituisce il valore Lambda del primo componente assegnato alla Categoria “Categoria-1” per tutti i muri nel disegno.

CompLambdaBy­Name, Component­Lambda

CompLambdaByMat

(criterio, materiale)

Il valore Lambda dei componenti che soddisfano i criteri ed usano il materiale specificato.

Cella Riga Schedario:

=CompLambdaByMat(‘Mortar MT’)

restituisce il valore Lambda del primo componente che usa il materiale “Mortar MT” per ogni muro, muro curvo, tetto, falda tetto e solaio nel database

Cella Riga Foglio Elettronico:

=CompLambdaByMat(t=muro, ‘Mortar MT’)

restituisce il valore Lambda del primo componente che usa il materiale “Mortar MT” per tutti i muri nel disegno.

CompLamb­daByClass, CopLambdaBy­Name, Component­Lambda

CompLambdaByName (criterio, categoria)

Valore Lambda dei componenti che soddisfano i criteri impostati e e hanno il nome specificato.

Cella Riga Schedario:

=CompLambdaByName(‘Rivestimento mat­toni’)

restituisce il valore Lambda dei componenti con il nome Rivestimento mattoni’ per ciascun muro, muro curvo, tetto, falda e solaio nello Schedario.

Cella Riga Foglio Elettronico:

=CompLambdaByName(‘Rivestimento mat­toni’)

restituisce il valore Lambda del primo componente con il nome Rivestimento mattoni’ per tutti i muri nel disegno.

CompLamb­daByClass, Compo­nentLambda

CompNameByClass
(criterio, categoria)

Il nome dei componenti che soddisfano i criteri specificati e appartengono a una determinata Categoria.

Cella Riga Schedario:

=CompNameByClass(‘Categoria-1’)

restituisce il nome dei componenti assegnati alla Categoria “Categoria-1” per ciascun muro, muro curvo, tetto, falda e solaio nello Schedario.

Cella Riga Foglio Elettronico:

=CompNameByClass(‘Categoria-1’)

restituisce il nome del primo componente assegnato alla Categoria “Categoria-1” per tutti i muri nel disegno.

CompClassByName

ComponentArea
(criterio, indice)

L’area di un lato del componente del muro specificato (o del componente del solaio specificato), meno quella dei fori.

Cella Riga Schedario:

=COMPONENTAREA(2)

restituisce l’area del secondo componente di ogni muro o solaio nello Schedario

Cella Riga Foglio Elettronico:

=COMPONENTAREA (t=wall,1)

restituisce come risultato l’area combinata del primo componente di tutti i muri presenti sul disegno

ComponentName,
ComponentVolume

ComponentLambda
(criterio, indice)

Valore Lambda dei componenti che soddisfano i criteri e hanno l’indice specificato. L’indice identifica il componente.

Cella Riga Schedario:

=ComponentLambda(‘Categoria-1’)

restituisce il nome dei componenti assegnati alla Categoria “Categoria-1” per ciascun muro, muro curvo, tetto, falda e solaio nello Schedario.

Cella Riga Foglio Elettronico:

=ComponentLambda(‘Categoria-1’)

restituisce il nome del primo componente assegnato alla Categoria “Categoria-1” per tutti i muri nel disegno.

CompoLamb­daByClass, Compo­LambdaByName

ComponentName
(criterio, indice)

Il nome del componente del muro specificato (o del componente del solaio specificato).

Cella Riga Schedario:

=COMPONENTNAME(2)

restituisce il nome del secondo componente di ogni muro o solaio nello Schedario

Cella Riga Foglio Elettronico:

=COMPONENTNAME (t=wall,1)

restituisce come risultato il nome del primo componente di tutti i muri presenti sul disegno

ComponentArea,
ComponentVolume

ComponentRValue
(criterio, indice)

Resistenza termica dei componenti che soddisfano i criteri e hanno l’indice specificato. L’indice identifica il componente.

Cella Riga Schedario:

=ComponentRValue(2)

restituisce la resistenza termica del secondo componente per ciascun muro, muro curvo, tetto, falda e solaio nello Schedario.

Cella Riga Foglio Elettronico:

=ComponentRValue(t=muro, 1)

restituisce i valori combinati delle resistenze termiche dei primi componenti di tutti i muri nel disegno.

CompRVa­lueByClass, CompR­ValueByName

ComponentThickness
(criterio, indice)

Lo spessore dei componenti che soddisfano i criteri e posseggono l’indice di identificazione specificato.

Cella Riga Schedario:

=ComponentThickness(2)

restituisce lo spessore del secondo componente per ciascun muro, muro curvo, tetto, falda e solaio nello Schedario.

Cella Riga Foglio Elettronico:

=ComponentThickness(t=muro, 1)

restituisce gli spessori combinati dei primi componenti di tutti i muri nel disegno.

CompThicknes­sByClass, CompThi­cknessByName

ComponentUValue
(criterio, indice)

Trasmittanza dei componenti che soddisfano i criteri e posseggono l’indice di identificazione specificato.

Cella Riga Schedario:

=ComponentUValue(2)

restituisce il valore di trasmittanza del secondo componente per ciascun muro, muro curvo, tetto, falda e solaio nello Schedario.

Cella Riga Foglio Elettronico:

=ComponentUValue(t=muro, 1)

restituisce i valori di trasmittanza combinati dei primi componenti di tutti i muri nel disegno.

CompUVa­lueByClass, Com­pUValueByName

ComponentVolume
(criterio, indice)

Il volume del componente del muro specificato (o del componente del solaio specificato), meno quello dei fori

Cella Riga Schedario:

=COMPONENTVOUME(2)

restituisce il volume del secondo componente di ogni muro o solaio nello Schedario

Cella Riga Foglio Elettronico:

=COMPONENTVOUME (t=wall,1)

restituisce come risultato il volume combinato del primo componente di tutti i muri presenti sul disegno

ComponentArea,
ComponentName

CompRValueByClass
(criterio, categoria)

Resistenza termica dei componenti che soddisfano i criteri specificati e appartengono alla Categoria specificata.

Cella Riga Schedario:

=CompRValueByClass(‘Categoria-1’)

restituisce il valore di resistenza termica dei componenti assegnati alla ‘Categoria-1’ per ciascun muro, muro curvo, tetto, falda e solaio nello Schedario.

Cella Riga Foglio Elettronico:

=CompRValueByClass (Categoria-1’)

restituisce i valori combinati di resistenza termica dei componenti assegnati alla ‘Categoria-1’ di tutti i muri nel disegno.

CompRVa­lueByClass, Compo­nentRValue

CompRValueByName (criterio, nome)

Resistenza termica dei componenti che soddisfano i criteri e hanno il nome specificato.

Cella Riga Schedario:

=CompRValueByName(t=muro, ‘Rive­stimento mattoni’)

restituisce il valore di resistenza termica dei componenti con il nome ‘Rivestimento mattoni’ per ciascun muro, muro curvo, tetto, falda e solaio nello Schedario.

Cella Riga Foglio Elettronico:

=CompRValueByName (t=muro, ‘Rive­stimento mattoni’)

restituisce i valori di resistenza termica combinati dei componenti con nome ‘Rivestimento mattoni’ di tutti i muri nel disegno.

CompRVa­lueByClass, Compo­nentRValue

CompThicknessByClass (crite­rio, categoria)

Spessore dei componenti che soddisfano i criteri specificati e appartengono alla Categoria specificata.

 

CompThicknessBy­Name, Component­Thickness

CompThicknessByName (crite­rio, nome)

Spessore dei componenti che soddisfano i criteri specificati e hanno il nome specificato.

Cella Riga Schedario:

=CompThicknessByName (t=muro, ‘Rivestimento mattoni’)

restituisce lo spessore dei componenti con il nome ‘Rivestimento mattoni’ per ciascun muro, muro curvo, tetto, falda e solaio nello Schedario.

Cella Riga Foglio Elettronico:

=CompThicknessByName (t=muro, ‘Rivestimento mattoni’)

restituisce gli spessori combinati dei componenti con nome ‘Rivestimento mattoni’ di tutti i muri nel disegno.

CompThicknes­sByClass, Compo­nentThickness

CompUValueByClass
(criterio, categoria)

Trasmittanza dei componenti che soddisfano i criteri specificati e appartengono alla Categoria specificata

Cella Riga Schedario:

=CompUValueByClass(‘Categoria-1’)

restituisce il valore di trasmittanza dei componenti assegnati alla “Categoria-1” per ciascun muro, muro curvo, tetto, falda e solaio nello Schedario.

Cella Riga Foglio Elettronico:

=CompUValueByClass (Categoria-1’)

restituisce i valori combinati di trasmittanza dei componenti assegnati alla “Categoria-1” di tutti i muri nel disegno.

CompValueBy­Name, Componen­tUValue

CompUValueByName (criterio, nome)

Trasmittanza dei componenti che soddisfano i criteri e hanno il nome specificato.

Cella Riga Schedario:

=CompUValueByName(t=muro, ‘Rive­stimento mattoni’)

restituisce il valore di trasmittanza dei componenti con il nome Rivestimento mattoni’ per ciascun muro, muro curvo, tetto, falda e solaio nello Schedario.

Cella Riga Foglio Elettronico:

=CompUValueByName (t=muro, ‘Rive­stimento mattoni’)

restituisce i valori di trasmittanza combinati dei componenti con nome Rivestimento mattoni’ di tutti i muri nel disegno.

CompUVa­lueByClass, Compo­nentUValue

CompVolumeByClass (criterio, categoria)

Volume dei componenti che soddisfano i criteri specificati e appartengono alla Categoria specificata.

Cella Riga Schedario:

=CompVolumeByClass(‘Categoria-1’)

restituisce il volume dei componenti assegnati alla “Categoria-1” per ciascun muro, muro curvo, tetto, falda e solaio nello Schedario.

Cella Riga Foglio Elettronico:

=CompVolumeByClass (Categoria-1’)

restituisce i volumi combinati dei componenti assegnati alla ‘Categoria-1’ di tutti i muri nel disegno.

CompVolumeBy­Name, Component­Volume

CompVolumeByName (criterio, nome)

Volume dei componenti che soddisfano i criteri specificati e hanno il nome specificato.

Cella Riga Schedario:

=CompVolumeByName(t=muro, ‘Rive­stimento mattoni’)

restituisce il volume dei componenti con il nome ‘Rivestimento mattoni’ per ciascun muro, muro curvo, tetto, falda e solaio nello Schedario.

Cella Riga Foglio Elettronico:

=CompVolumeByName (t=muro, ‘Rive­stimento mattoni’)

restituisce i volumi combinati dei componenti con nome ‘Rivestimento mattoni’ di tutti i muri nel disegno.

CompVolu­meByClass, Compo­nentVolume

Concat
(testo1, testo2,testo3)

Congiunge diverse stringhe di testo in una sola stringa.

=Concat(B3,

restituisce come risultato il contenuto delle celle B3 e B4 con una singola stringa, separate da un virgola e uno spazio

 

cos(numero)

Il coseno di un dato angolo.

Numero è l’angolo in radianti di cui si cerca il coseno.

=cos(deg2rad(23))

converte l’angolo di 23° nel suo equivalente in radianti e restituisce il coseno dell’angolo

acos

Count(criterio)

Il numero di oggetti che soddisfano i criteri.

Cella Riga Schedario:

=Count

restituisce il numero totale di oggetti per ogni Riga Schedario

Cella Riga Foglio Elettronico:

=Count(S=

restituisce il numero oggetti Simbolo presenti sul disegno chiamati “Sedia”

 

CurtWallFrameLength
(criterio, categoria)

La lunghezza combinata dei frame della facciata continua che soddisfano i criteri e che sono assegnati alla Categoria specificata. Per trovare tutti i frame di una certa facciata continua, non definire la Categoria.

Cella Riga Schedario:

=CurtWallFrameLength(

restituisce come risultato la lunghezza combinata dei frame di ogni facciata continua nello Schedario

Cella Riga Foglio Elettronico:

=CurtWallFrameLength(t=wall,

restituisce come risultato la lunghezza combinata dei frame di ogni facciata continua inserita sul disegno

CurtWallPnlArea­Gross

CurtWallPnlArea­Net

CurtWallPnlAreaGross
(criterio, categoria)

L’area lorda combinata dei pannelli della facciata continua che soddisfano i criteri e che sono assegnati alla Categoria specificata. L’area lorda include le parti di pannello coperte dai frame. Per trovare tutti i frame di una certa facciata continua, non definire la Categoria.

=Cella Riga Schedario:

=CurtWallAreaGross(

restituisce come risultato l’area lorda combinata dei pannelli di ogni facciata continua nello Schedario

Cella Riga Foglio Elettronico:

=CurtWallAreaNet(t=wall,

restituisce come risultato l’area lorda combinata dei pannelli di ogni facciata continua inserita sul disegno

CurtWallFrameLen­gth

CurtWallPnlArea­Net

CurtWallPnlAreaNet
(criterio, categoria)

L’area netta combinata dei pannelli della facciata continua che soddisfano i criteri e che sono assegnati alla Categoria specificata. L’area lorda include le parti di pannello coperte dai frame. Per trovare tutti i frame di una certa facciata continua, non definire la Categoria.

Cella Riga Schedario:

=CurtWallAreaNet(

restituisce come risultato l’area netta combinata dei pannelli di ogni facciata continua nello Schedario

Cella Riga Foglio Elettronico:

=CurtWallAreaNet(t=wall,

restituisce come risultato l’area netta combinata dei pannelli di ogni facciata continua inserita sul disegno

CurtWallFrameLen­gth

CurtWallPnlArea­Gross

DataBasebyScript (scriptName, param1, param2,...)

Utilizza uno Script per determinare il contenuto di una riga principale Schedario e le sue sotto-righe. Esegue lo script VectorScript o Python specificato, passando i parametri che seguono il nome dello script e attendendo che restituisca un elenco di oggetti che verranno utilizzati come sotto-righe nell’ordine in cui vengono ricevuti dallo script.

Un parametro facoltativo prima del nome dello script specifica il percorso della cartella dello script all’interno dell’installazione di Vectorworks.

Per un elenco dei valori del percorso della cartella, consultare questa pagine della documentazione per gli sviluppatori (è necessario lInternet):

https://developer.vectorworks.net/index.php/VS:GetFolderPath

Cella Riga Schedario:

=DataBaseByScript(

esegue lo script VectorScript chiamato“My Script” e restituisce un valore per ogni oggetto nello Schedario, inviandolo alle sotto-righe dello Schedario

Cella Riga Foglio Elettronico:

=DataBaseByScript(

trasforma la riga in una riga Schedario, esegue lo script Python ‘ScriptFile.py’ nella cartella dei plug-in di Vectorworks, passando i parametri “2” e “1” e restituisce un valore per ogni oggetto nello Schedario, inviandolo alle sotto-righe dello Schedario

 

RunScript

deg2rad(numero)

Converte numero da gradi in radianti.

Numero è il valore in gradi che si vuole trasformare in radianti.

=deg2rad(47)

converte un angolo di 47° nel suo equivalente in radianti

 

exp(numero)

Il numero di Nepero (e) elevato alla potenza numero. La costante è uguale a 2.71828182845904, base dei logaritmi naturali.

Numero è l’esponente applicato alla base e.

=exp(2)

restituisce il valore numerico di e elevato alla potenza di 2

ln

GetIfcProperty(criterio)

(solo prodotti
Vectorworks Design Series)

Il valore di una specifica proprietà IFC associato a un oggetto IFC. Il criterio è una stringa con due elementi separati da un punto: il primo elemento può essere una Entità IFC o un nome PSet, il secondo elemento è il nome della Proprietà IFC.

=GETIFCPROPERTY

(

restituisce una stringa contenente il valore di proprietà associato all’oggetto specificato

 

GetSpaceNameForObj
(criterio)

(solo Vectorworks
Architect)

Il nome dello Spazio che circonda lspecificati.

Cella Riga Schedario:

=GetSpaceNameForObj

restituisce il nome dello Spazio per ogni oggetto nello Schedario

Cella Riga Foglio Elettronico:

=GetSpaceNameForObj(n=

restituisce il nome dello Spazio per ogni oggetto chiamato “sedia-1”

GetSpaceNumFo­rObj

GetSpaceNumForObj
(criterio)

(solo Vectorworks
Architect)

Il numero dello Spazio che circonda lspecificati.

 

Cella Riga Schedario:

=GetSpaceNumForObj

restituisce il numero dello Spazio per ogni oggetto nello Schedario

Cella Riga Foglio Elettronico:

=GetSpaceNumForObj(n=

restituisce il numero dello Spazio per ogni oggetto chiamato “sedia-1”

GetSpaceNameFo­rObj

GradientFill(criterio)

Il Riempimento Sfumatura degli oggetti che soddisfano i criteri.

Cella Riga Schedario:

=GradientFill

restituisce la Sfumatura per ogni oggetto nello Schedario

Cella Riga Foglio Elettronico:

=GradientFill(sel=true)

restituisce la Sfumatura di tutti gli oggetti selezionati nel disegno

 

HatchFill(criterio)

Il Riempimento Tratteggio Vettoriale degli oggetti che soddisfano i criteri.

Cella Riga Schedario:

=HatchFill

restituisce il Tratteggio Vettoriale per ogni oggetto nello Schedario

Cella Riga Foglio Elettronico:

=HatchFill(sel=true)

restituisce il Tratteggio Vettoriale di tutti gli oggetti selezionati nel disegno

 

Height(criterio)

La DY (altezza) combinata degli oggetti che soddisfano i criteri.

Cella Riga Schedario:

=Height

restituisce il valore DY combinato di ogni oggetto nello Schedario)

Cella Riga Foglio Elettronico:

=Height(sel=true)

restituisce il valore DY combinato degli oggetti selezionati

Width

if(test_logico;
valore_se_vero;
valore_se_falso)

Un valore se test_logico è vero, l’altro se è falso.

Utilizzare questa Funzione per eseguire test condizionali su valori e formule e per prendere decisioni basandosi sui risultati del test. Il risultato del test determina il valore restituito dalla Funzione If. Il test_logico può essere qualunque valore, o espressione, che possa essere valutato come vero o falso. Si possono annidare fino a sette istruzioni If come valore_se_vero o valore_se_falso, per costruire formule elaborate. Le espressioni booleane nelle istruzioni If devono essere tra parentesi. Il testo deve essere posto fra virgolette.

=if((C7>100); 100; C7)

se il valore della cella C7 è maggiore di100, il valore di questa cella è 100, altrimenti il valore di questa cella è lo stesso valore di quello presente nella cella 100

 

Image(criterio)

(solo prodotti
Vectorworks Design Series)

Lche soddisfa il criterio specificato. Nel formato di cella, specificare se visualizzare una miniatura di un oggetto o gli Attributi 2D applicati all’oggetto.

Cella Riga Schedario:

=Image

restituisce il Riempimento Immagine di ogni oggetto nello Schedario

Cella Riga Foglio Elettronico:

=ImageFill(sel=true)

restituisce il Riempimento Immagine di ogni oggetto selezionato nel disegno

 

ImageFill(criterio)

Il Riempimento Immagine degli oggetti che soddisfano i criteri specificati.

Cella Riga Schedario:

=ImageFill

restituisce l’immagine di ogni oggetto nello Schedario

Cella Riga Foglio Elettronico:

=Image(S=

restituisce l’immagine del Simbolo chiamato “tavolo”

 

int(numero)

Elimina la parte decimale di numero.

Numero è il numero reale che si vuole troncare a un intero.

=int(B9)

restituisce il valore della cella B9 senza la sua parte decimale

round

IsFlipped(criterio)

Un valore pari al numero di oggetti capovolti che soddisfano i criteri.

Cella Riga Schedario:

=IsFlipped

restituisce lo stato di ribaltamento di ogni oggetto nello Schedario

Cella Riga Foglio Elettronico:

=IsFlipped(t=rect)

restituisce il numero totale di rettangoli capovolti presenti sul disegno

 

Layer(criterio)

Il nome del Lucido degli oggetti che soddisfano i criteri.

Cella Riga Schedario:

=Layer

restituisce il Lucido di ogni oggetto nello Schedario

Cella Riga Foglio Elettronico:

=Layer(sel=true)

restituisce il Lucido degli oggetti selezionati nel disegno

 

LeftBound(criterio)

La minima coordinata X degli oggetti che soddisfano i criteri.

Cella Riga Schedario:

=LeftBound

restituisce la coordinata X di ogni oggetto nello Schedario

Cella Riga Foglio Elettronico:

LeftBound(t=locus)

restituisce come risultato la coordinata X del Punto che si trova più a sinistra sul disegno

BotBound,
RightBound,
TopBound

Length(criterio)

La lunghezza di linee e muri che soddisfano i criteri.

Nel caso oggetti di tipo Estrusione soddisfino i criteri, la funzione restituisce il relativo valore di estrusione.

Cella Riga Schedario:

=Length

restituisce la lunghezza di ogni oggetto nello Schedario

Cella Riga Foglio Elettronico:

=Length(T=line)

restituisce la lunghezza totale di tutti gli oggetti di tipo Linea presenti sul disegno

 

LineType(criterio)

Il tipo di linea degli oggetti che soddisfano i criteri.

Cella Riga Schedario:

=LineType

restituisce il tipo di linea di ogni oggetto nello Schedario

Cella Riga Foglio Elettronico:

=LineType(sel=true)

restituisce il tipo di linea degli oggetti selezionati nel disegno

 

ln(numero)

Il logaritmo naturale in base e.

Numero è il numero reale positivo di cui si cerca il logaritmo.

=ln(12)

restituisce il logaritmo naturale di 12

exp

log(numero)

Il logaritmo in base 10 di un numero.

Numero è il numero reale positivo di cui si cerca il logaritmo.

=log(2)

restituisce il logaritmo in base 10 di 2

ln

max(numero1,
numero2,...)

Il numero più grande nella lista degli argomenti.

La lista può comprendere da 1 a 14 numeri.

=max(C5,C7,C9)

restituisce il numero più grande fra quelli presenti nelle celle C5, C7 e C9

min

min(numero1,
numero2,...)

Il numero più piccolo nella lista degli argomenti.

La lista può comprendere da 1 a 14 numeri.

=min(C5,C7,C9)

restituisce il numero più piccolo fra quelli presenti nelle celle C5, C7 e C9

max

Name(criterio)

Il nome degli oggetti che soddisfano i criteri specificati.

Cella Riga Schedario:

=Name

restituisce il nome di ogni oggetto nello Schedario

Cella Riga Foglio Elettronico:

=Name(sel=true)

restituisce il nome degli oggetti selezionati nel disegno

 

ObjectTexture(criterio)

La Texture degli oggetti che soddisfano i criteri specificati.

Cella Riga Schedario:

=ObjectTexture

restituisce la Texture di ogni oggetto nello Schedario

Cella Riga Foglio Elettronico:

=ObjectTexture(sel=true)

restituisce la Texture degli oggetti selezionati nel disegno

 

ObjectType(criterio)

L’ID numerico del tipo di oggetto che soddisfa i criteri specifici

Per una lista di ID dei tipi di oggetto, vedere la documentazione reperibile su
http://developer.vectorworks.net/index.php/VS:Function_Reference_Appendix#objects

Cella Riga Schedario:

=ObjectType

restituisce il valore del tipo di ogni oggetto nello Schedario

Cella Riga Foglio Elettronico:

=ObjectType(sel=true)

restituisce il valore del tipo dell’oggetto selezionato; per esempio, il valore del tipo di oggetto di una Luce è 81

 

ObjectTypeName(criterio)

Il tipo degli oggetti che soddisfano i criteri specificati.

Cella Riga Schedario:

=ObjectTypeName

restituisce il tipo di ogni oggetto nello Schedario

Cella Riga Foglio Elettronico:

=ObjectTypeName(sel=true)

restituisce il tipo degli oggetti selezionati nel disegno

 

ObjIncludeInEnergos (criterio)

(solo
Vectorworks Architect)

Lo stato Energos (1 se è incluso nei calcoli, 0 se è escluso) degli oggetti che soddisfano i criteri.

Cella Riga Schedario:

=ObjIncludeInEnergos

restituisce lo stato Energos per ogni oggetto muro, tetto, falda tetto, solaio, porta, finestra nello Schedario

Cella Riga Foglio Elettronico:

=ObjIncludeInEnergos(t=wall)

restituisce lo stato Energos di tutti i muri presenti nel progetto

 

ObjRValue(criterio)

(solo
Vectorworks Architect)

Il valore di resistenza termica degli oggetti che soddisfano i criteri.

Cella Riga Schedario:

=ObjRValue

restituisce la resistenza termica per ogni oggetto muro, tetto, falda tetto, solaio, porta, finestra nello Schedario

Cella Riga Foglio Elettronico:

=ObjRValue(n=muro-1)

restituisce la resistenza termica del muro chiamato “muro-1”

ObjUValue

ObjUValue(criterio)

(solo
Vectorworks Architect)

Il valore di trasmittanza degli oggetti che soddisfano i criteri.

 

Cella Riga Schedario:

=ObjUValue

restituisce la trasmittanza per ogni oggetto muro, tetto, falda tetto, solaio, porta, finestra nello Schedario

Cella Riga Foglio Elettronico:

=ObjUValue(n=muro-1)

restituisce la trasmittanza del muro chiamato “muro-1”

ObjRValue

Perim(criterio)

Il perimetro degli oggetti che soddisfano i criteri.

Cella Riga Schedario:

=Perim

restituisce il perimetro di ogni oggetto nello Schedario

Cella Riga Foglio Elettronico:

=Perim(sel=true)

restituisce il perimetro totale di tutti gli oggetti selezionati sul disegno

 

PlantImage
(criterio, numero)

solo Vectorworks Landmark

L’immagine specifica della pianta, presa dalla definizione della pianta. Con 1, 2, 3 o 4, scegliere rispettivamente l’immagine da Image Plant Form, Image Detail, Image Misc o Custom Image nel Database Piante. Nel Formato della cella specificare la pianta mediante criteri (selezionando la pianta con criteri come Valore campo=Plant ID = xx

Cella Riga Schedario:

=PlantImage(2)

restituisce l’immagine specificata come Image Detail nel formato Plant Data del Database Piante

Cella Riga Foglio Elettronico:

=PlantImage(‘Pianta’.’plant ID’=’TaxfR’)

restituisce l’immagine specificata come Custom Image nel formato Plant Data nel Database Piante con un plant ID uguale a TaxfR

 

rad2deg(numero)

Converte i numeri da radianti a gradi.

Numero è il valore in radianti che si vuole trasformare in gradi.

=rad2deg(0,52359878)

converte l’angolo misurato da radianti a gradi

 

RightBound(criterio)

La massima coordinata X degli oggetti che soddisfano i criteri.

Cella Riga Schedario:

=RightBound

restituisce la coordinata X di ogni oggetto nello Schedario

Cella Riga Foglio Elettronico:

=RightBound(t=locus)

restituisce come risultato la coordinata X del Punto che si trova più a destra sul disegno

(BotBound,
TopBound,
LeftBound)

RoofArea_Heated(criterio)

L’area riscaldata della superficie del tetto lungo la pendenza all’interno della linea dei muri (non aggettante), combinata per tutti gli oggetti che soddisfano i criteri.

Cella Riga Schedario:

=RoofArea_Heated

restituisce l’area riscaldata lungo la pendenza di tutti gli oggetti Tetto e Falda Tetto nello Schedario

Cella Riga Foglio Elettronico:

=RoofArea_Heated
(ST=ROOFFACE)

restituisce l’area riscaldata lungo la pendenza di tutti gli oggetti Tetto e Falda Tetto presenti sul disegno

RoofArea_Heate­dProj

RoofArea_HeatedProj
(criterio)

L’area riscaldata della proiezione sul Piano del Lucido della superficie del tetto lungo la pendenza all’interno della linea dei muri (non aggettante), combinata per tutti gli oggetti che soddisfano i criteri.

Cella Riga Schedario:

=RoofArea_HeatedProj

restituisce l’area riscaldata della proiezione sul Piano del Lucido della superficie di ogni oggetto Tetto e Falda Tetto nello Schedario

Cella Riga Foglio Elettronico:

=RoofArea_HeatedProj
(T=ROOF)

restituisce l’area riscaldata della proiezione sul Piano del Lucido della superficie di tutti gli oggetti Tetto presenti sul disegno

RoofArea_Heated

RoofArea_Total(criterio)

L’area della superficie totale del tetto lungo la pendenza.

Cella Riga Schedario:

=RoofArea_Total

restituisce l’area di ogni oggetto Tetto e Falda Tetto nello Schedario

Cella Riga Foglio Elettronico:

=RoofArea_Total
(ST=ROOFFACE)

restituisce l’area di tutti gli oggetti Tetto e Falda Tetto presenti sul disegno

RoofArea_TotalProj

RoofArea_TotalProj
(criterio)

L’area della proiezione sul Piano del Lucido della superficie totale del tetto lungo la pendenza.

Cella Riga Schedario:

=RoofArea_TotalProj

restituisce l’area della proiezione lungo la pendenza di ogni oggetto Tetto e Falda Tetto nello Schedario

Cella Riga Foglio Elettronico:

=RoofArea_TotalProj
(T=ROOF)

restituisce l’area della proiezione lungo la pendenza di tutti gli oggetti Tetto presenti sul disegno

RoofArea_Total

RoofStyleName(criterio)

 

Il nome delle Stile Tetto.

Cella Riga Schedario:

=RoofStyleName

restituisce il nome dello Stile Tetto per ogni oggetto Tetto collegato allo Schedario

Cella Riga Foglio Elettronico:

=RoofStyleName(n=‘Tetto-1’)

restituisce il nome dello Stile Tetto dell’oggetto denominato ‘Tetto-1’

 

round(numero)

Arrotonda numero al più vicino numero intero.

=round(3,6)

restituisce il numero intero più vicino; nell’esempio il valore 4

int

rounddown(numero, cifre)

Arrotonda per difetto il numero specificato al numero più vicino con un determinato numero di cifre decimali.

=round(2,345, 2)

restituisce 2,34

round, roundup

roundup(numero, cifre)

Arrotonda per eccesso il numero specificato al numero più vicino con un determinato numero di cifre decimali.

=round(2,345, 2)

restituisce 2,35

round, rounddown

RunScript(scriptName,
param1, param2,...)

Esegue lo script VectorScript o Python specificato, passandogli i parametri che seguono il nome dello script.

Un parametro facoltativo prima del nome dello script specifica il percorso della cartella dello script all’interno dell’installazione di Vectorworks.

Per un elenco dei valori del percorso della cartella, consultare questa pagine della documentazione per gli sviluppatori (è necessario l’accesso a Internet):

https://developer.vectorworks.net/index.php/VS:GetFolderPath

Cella Riga Schedario:

=RunScript(

esegue lo script VectorScript chiamato “My Script” e ritorna il valore per ogni oggetto nello Schedario

Cella Riga Foglio Elettronico:

=RunScript(2,

 

esegue lo script Python chiamato “ScriptFile.py” presente nella cartella Plug-in, gli passa i parametri “2” e “1” e restituisce un valore

DataBasebyScript

sin(numero)

Il seno di un dato angolo.

Numero è l’angolo in radianti da cui viene calcolato il seno.

sin(deg2rad(32))

converte un angolo di 32° nella sua versione in radianti e restituisce come risultato il seno dell’angolo

asin

SketchStyle(criterio)

Lo Stile di Sketch degli oggetti che soddisfano i criteri specificati

Cella Riga Schedario:

=SketchStyle

restituisce lo Stile di Sketch di ogni oggetto collegato allo Schedario

Cella Riga Foglio Elettronico:

=SketchStyle(sel=true)

restituisce lo Stile di Sketch degli oggetti selezionati nel disegno

 

SlabStyleName

(solo
Vectorworks Architect)

Il nome dello Stile Solaio.

=SlabStyleName (sel=true)

restituisce il nome dello Stile Solaio degli oggetti selezionati

 

SlabThickness
(criterio)

(solo prodotti
Vectorworks Design Series)

Spessore di oggetti di tipo Solaio (solai e falde tetto per tutti gli oggetti che soddisfano i criteri.

Cella Riga Schedario:

=SlabThickness

restituisce lo spessore ogni oggetto Solaio nello Schedario

Cella Riga Foglio Elettronico:

=SlabThickness
(T=SLAB)

restituisce lo spessore combinato di tutti gli oggetti Solaio presenti sul disegno

 

sqrt(numero)

La radice quadrata positiva.

Numero è il valore di cui si cerca la radice quadrata.

sqrt(D27)

restituisce il valore della radice quadrata del numero presente nella cella D27

 

Story(criterio)

Il nome del Piano degli oggetti che soddisfano i criteri specificati.

Cella Riga Schedario:

=Story

restituisce il nome del Piano di ogni oggetto collegato allo Schedario

Cella Riga Foglio Elettronico:

=Story(sel=true)

restituisce il nome del Piano degli oggetti selezionati nel disegno

 

Substring(testo/funzione, deli­mitatore, indice)

Spezza una singola stringa in un array di stringhe usando un delimitatore e restituisce ogni stringa all’indice specificato.

=SUBSTRING(‘cucina;salotto;bagno;pianterreno’, ‘;’, 2)

restituisce “salotto”, che è la seconda sotto-stringa della stringa specificata

 

sum(numero1;
numero2;...)

La somma di tutti i numeri nella lista degli argomenti.

Ci possono essere fra 1 e 14 numeri da sommare.

sum(A2;A20;A30)

restituisce la somma dei numeri presente nelle celle A2+A20+A30

Average

SurfaceArea
(criterio)

Il superficie totale di tutti gli oggetti che soddisfano i criteri, in base all’Unità di misura definita per le superfici a livello di documento.

Cella Riga Schedario:

=SurfaceArea

restituisce l’area ogni oggetto nello Schedario

Cella Riga Foglio Elettronico:

=SurfaceArea(st=sphere)

restituisce l’area della superficie totale di tutti gli oggetti Sfera presenti sul disegno

 

SymbolName(criterio)

Il nome del Simbolo delle istanze che soddisfano i criteri specificati.

Cella Riga Schedario:

=SymbolName

restituisce il nome di ogni istanza di Simbolo collegato allo Schedario

Cella Riga Foglio Elettronico:

=SymbolName(sel=true)

restituisce il nome del Simbolo delle istanze selezionate nel disegno

 

tan(numero)

La tangente di un dato angolo.

Numero è l’angolo in radianti di cui si cerca la tangente.

tan(deg2rad(32))

converte un angolo di 32° nel suo equivalente in radianti e restituisce come risultato la tangente dell’angolo

atan

TopBound(criterio)

La massima coordinata y degli oggetti che soddisfano i criteri.

Cella Riga Schedario:

=TopBound

restituisce la coordinata Y ogni oggetto nello Schedario

Cella Riga Foglio Elettronico:

TopBound(t=locus)

restituisce come risultato la coordinata Y del Punto che si trova più in alto sul disegno

BotBound,
LeftBound,
RightBound

value(testo)

Converte una stringa di testo che rappresenta un numero nel numero corrispondente.

=value(‘2e3’)

restituisce come risultato il valore numerico di 2 per 10 elevato alla terza

 

Volume(criterio)

Il volume totale di tutti gli oggetti che soddisfano i criteri, in base all’Unità di misura definita per i volumi a livello di documento.

Cella Riga Schedario:

=Volume

restituisce il volume ogni oggetto nello Schedario

Cella Riga Foglio Elettronico:

Volume(T=xtrd)

restituisce come risultato il volume totale di tutti gli oggetti di tipo Estrusione che si trovano sul disegno

 

WallArea_Gross
(criterio)

L’area lorda della superficie 2D di una faccia di tutti i muri che soddisfano i criteri.

Cella Riga Schedario:

=WallArea_Gross

restituisce la superficie lorda di una faccia di ogni muro nello Schedario

Cella Riga Foglio Elettronico:

=WallArea_Gross(T=wall)

restituisce come risultato la superficie lorda di una faccia di tutti i muri che si trovano sul disegno

WallArea_Net

WallArea_Net
(criterio)

L’area netta della superficie 2D di una faccia di tutti i muri che soddisfano i criteri, escludendo la superficie delle aperture.

Cella Riga Schedario:

=WallArea_Net

restituisce la superficie netta di una faccia di ogni muro nello Schedario

Cella Riga Foglio Elettronico:

=WallArea_Net(T=wall)

restituisce come risultato la superficie netta di una faccia di tutti i muri che si trovano sul disegno

WallArea_Gross

WallAverageHeight
(criterio)

L’altezza media di un muro, includendo la considerazione dei picchi e delle eventuali differenze d’altezza del bordo iniziale e finale.

Cella Riga Schedario:

=WallAverageHeight

restituisce l’altezza media di ogni muro nello Schedario

Cella Riga Foglio Elettronico:

=WallAverageHeight((t=wall)&(sel=true))

restituisce come risultato l’altezza media degli oggetti di tipo Muro selezionati

 

WallStyleName(criterio)

Il nome dello Stile Muro.

Cella Riga Schedario:

=WallStyleName

restituisce il nome dello Stile Muro dei muri nello Schedario

 

WallThickness(criterio)

Lo spessore combinato dei Muri che soddisfano i criteri.

Cella Riga Schedario:

=WallThickess

restituisce lo spessore di ogni muro nello Schedario

Cella Riga Foglio Elettronico:

=WallThickess(t=wall)

restituisce come risultato lo spessore di tutti i muri che si trovano sul disegno

 

Width(criterio)

La DX (larghezza) combinata degli oggetti

Cella Riga Schedario:

=Width

restituisce il valore DY di ogni oggetto nello Schedario

Cella Riga Foglio Elettronico:

Width(sel=true)

restituisce il valore DY combinato degli oggetti selezionati

Height

XCenter(criterio)

La coordinata X del centro degli oggetti che soddisfano i criteri.

Cella Riga Schedario:

=XCenter

restituisce la coordinata X del centro di ogni oggetto nello Schedario

Cella Riga Foglio Elettronico:

XCenter(sel=true)

restituisce la coordinata X del centro degli oggetti selezionati

YCenter, ZCenter

XCoordinate(criterio)

La coordinata X del punto di inserimento di Simboli, di oggetti parametrici e di oggetti Punto.

Cella Riga Schedario:

=XCoordinate

restituisce la coordinata X del punto di inserimento di ogni oggetto nello Schedario

YCoordinate,
ZCoordinate

YCenter(criterio)

La coordinata Y del centro degli oggetti che soddisfano i criteri.

Cella Riga Schedario:

=YCenter

restituisce la coordinata Y del centro di ogni oggetto nello Schedario

Cella Riga Foglio Elettronico:

YCenter(sel=true)

restituisce la coordinata Y del centro degli oggetti selezionati

XCenter, ZCenter

YCoordinate(criterio)

La coordinata Y del punto di inserimento di Simboli, di oggetti parametrici e di oggetti Punto.

Cella Riga Schedario:

=YCoordinate

restituisce la coordinata Y del punto di inserimento di ogni oggetto nello Schedario

XCoordinate,
ZCoordinate

ZCenter(criterio)

La coordinata Z del centro degli oggetti che soddisfano i criteri.

Cella Riga Schedario:

=ZCenter

restituisce la coordinata Z del centro di ogni oggetto nello Schedario

Cella Riga Foglio Elettronico:

ZCenter(sel=true)

restituisce la coordinata Z del centro degli oggetti selezionati

XCenter, YCenter

ZCoordinate(criterio)

La coordinata Z del punto di inserimento di Simboli, di oggetti parametrici e di oggetti Punto.

Cella Riga Schedario:

=ZCoordinate

restituisce la coordinata Z del punto di inserimento di ogni oggetto nello Schedario

XCoordinate,
YCoordinate