Manual:Using spreadsheets/it

FreeCAD dispone di un altro ambiente di lavoro interessante da esplorare: l'ambiente Spreadsheet. Questo ambiente permette di creare direttamente in FreeCAD un foglio di calcolo come quelli fatti con Excel o con LibreOffice. Questi fogli di calcolo possono essere popolati con dei dati estratti dal modello, e possono anche eseguire una serie di calcoli tra i valori. I fogli di calcolo possono essere esportati come file CSV, che possono essere importati in qualsiasi altra applicazione che gestisca i foglio di calcolo.

In FreeCAD, però, fogli di calcolo hanno un'utilità aggiuntiva: le loro celle possono ricevere un nome, e possono quindi essere referenziate da qualsiasi campo supportato dal motore delle espressioni. Questo trasforma fogli di calcolo in potenti strutture di controllo, in cui i valori inseriti nelle specifiche celle possono guidare le dimensioni del modello. C'è solo una cosa da tenere a mente, dato che FreeCAD vieta le dipendenze circolari tra oggetti, uno stesso foglio non può essere utilizzato per impostare una proprietà di un oggetto e allo stesso tempo recuperare il valore della proprietà dallo stesso oggetto. Ciò renderebbe il foglio di calcolo e l'oggetto dipendenti l'uno dall'altro.

Nel seguente esempio, creeremo un paio di oggetti, recupereremo alcune delle loro proprietà in un foglio di calcolo, e quindi utilizzeremo il foglio di calcolo per guidare direttamente le proprietà di altri oggetti.

Leggere le proprietà

 * Iniziare passando all'ambiente Part, e creare alcuni oggetti: un [[Image:Part_Box.png|16px]] box, un [[Image:Part_Cylinder.png|16px]] cilindro e una [[Image:Part_Sphere.png|16px]] sfera.
 * Modificare le loro proprietà Placement (o usare lo strumento [[Image:Draft_Move.png|16px]] Muovi) per separarli, in modo che si possa vedere meglio gli effetti di quello che faremo:




 * Ora, si tratta di estrarre alcune informazioni su questi oggetti. Passare all'ambiente Spreadsheet
 * Premere il pulsante [[Image:Spreadsheet_Create.png|16px]] Nuovo foglio di calcolo
 * Fare doppio clic sul nuovo oggetto Spreadsheet nella vista ad albero. Si apre l'editor dei fogli di calcolo:



L'editor di FreeCAD, anche se non è così completo e potente come quello dei fogli di calcolo elencati sopra, posside comunque la maggior parte degli strumenti di base e le funzioni che vengono utilizzate comunemente, come ad esempio la possibilità di cambiare l'aspetto delle celle ( dimensione, colore, allineamento), unire e dividere le celle, l'uso di formule come = 2 + 2, o di riferirsi ad altre celle con = B1.

In FreeCAD, a questi comportamenti comuni, è stata aggiunta una cosa molto interessante: la possibilità di fare riferimento non solo ad altre celle, ma anche ad altri oggetti del documento, e di recuperare i valori dalle loro proprietà. Come esempio, proviamo a recuperare alcune proprietà dai 3 oggetti creati in precedenza. Le proprietà sono quello che possiamo vedere nella finestra dell'editor delle proprietà, nella scheda Dati, quando si seleziona un oggetto.


 * Iniziamo inserendo un paio di testi nelle celle A1, A2 e A3, in modo che più avanti si possa ricordare a cosa si riferiscono, per esempio Cube Length, Cylinder Radius e Sphere Radius. Per immettere il testo, basta scrivere nel campo "Contents" sopra il foglio di calcolo, o fare doppio clic su una cella.
 * Ora recuperiamo la lunghezza attuale del cubo. Nella cella B1, digitare =Cube.Length. Notare che il foglio di calcolo ha un meccanismo di completamento automatico, che in realtà è lo stesso dell'editor delle espressioni che abbiamo usato nel capitolo precedente.
 * Fare lo stesso per le celle B2 (=Cylinder.Radius) e B3 (=Sphere.Radius).




 * Although these results are expressed with their units, the values can be manipulated as any number, try for example entering in cell C1: =B1*2.
 * We can now change one of these values in the properties editor, and the change will be immediately reflected in the spreadsheet. For example, let's change the length of our cube to 20mm:



Nella pagina L'ambiente foglio di calcolo sono descritte più in dettaglio tutte le possibili operazioni e le funzioni che è possibile utilizzare nei fogli di calcolo.

Scrivere le proprietà
Un altro uso molto interessante del foglio di calcolo in FreeCAD è quello di fare il contrario di quello che abbiamo fatto fino ad ora: invece di leggere i valori delle proprietà degli oggetti 3D, possiamo anche assegnare i valori a questi oggetti. Ricordate, però, una delle regole fondamentali di FreeCAD: le dipendenze circolari sono vietate. Pertanto, non possiamo usare lo stesso foglio per leggere e scrivere i valori di un oggetto 3D. Ciò renderebbe l'oggetto dipendente dal foglio di calcolo, che a sua volta sarebbe dipendente dall'oggetto. Creiamo invece un altro foglio di calcolo.


 * We can now close the spreadsheet tab (under the 3D view). This is not mandatory, there is no problem in keeping several spreadsheet windows open.
 * Press the [[Image:Spreadsheet_Create.png|16px]] New Spreadsheet button again
 * Change the name of the new spreadsheet to something more meaningful, such as Input (do this by right-clicking the new spreadsheet object, and choosing Rename).
 * Double-click the Input spreadsheet to open the spreadsheet editor.
 * In cell A1, let's put a descriptive text, for example: "Cube dimensions"
 * In cell B1, write =5mm (using the = sign makes sure the value is interpreted as a unit value, not a text).
 * Now to be able to use this value outside the spreadsheet, we need to give a name, or alias, to the B1 cell. Right-click the cells, click Properties and select the Alias tab. Give it a name, such as cubedims:




 * Premere OK, quindi chiudere la scheda foglio di calcolo
 * Selezionare l'oggetto cubo
 * Nel editor di proprietà, fare clic sulla piccola icona [[Image:Bound-expression-unset.png|16px]] espressioni sul lato destro del campo Length. Si apre l'editor delle espressioni, dove si può scrivere Spreadsheet001.cubedims. Ripetere questa operazione per Height e Width:



You might wonder why we had to use "Spreadsheet001" instead of "Input" in the expression above. This is because each object, in a FreeCAD document, has an internal name, which is unique in the document, and a label, which is what appears in the tree view. If you uncheck the appropriate option in the preferences settings, FreeCAD will allow you to give the same label to more than one object. This is why all operations that must identify an object with absolutely no doubt, will use the internal name instead of the label, which could designate more than one object. The easiest way to know the internal name of an object is by keeping the selection panel (menu Edit->Panels) open, it will always indicate the internal name of a selected object:



Usando gli alias delle celle nei fogli di calcolo, è possibile utilizzare un foglio di calcolo per memorizzare i "valori master" in un documento FreeCAD. Questo può essere utilizzato, ad esempio, per avere un modello di un pezzo con certe dimensioni, e per memorizzare tali dimensioni in un foglio di calcolo. Diventa quindi molto facile produrre un altro modello con dimensioni diverse, basta aprire il file e modificare un paio di quote nel foglio di calcolo.

Infine, notare che anche i vincoli all'interno uno schizzo possono ricevere il valore da una cella del foglio:



Si può anche dare un alias a vincoli dimensionali (orizzontale, verticale o distanza) in uno schizzo (quindi è anche possibile utilizzare tale valore al di fuori dello schizzo):



Download


 * Il file prodotto in questo esercizio: https://github.com/yorikvanhavre/FreeCAD-manual/blob/master/files/spreadsheet.FCStd

Approfondimenti


 * L'ambiente Foglio di calcolo
 * Le espressioni