1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
|
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
<!ENTITY legal SYSTEM "legal.xml">
<!ENTITY appversion "2.18">
<!ENTITY manrevision "2.8">
<!ENTITY date "February 2007">
<!ENTITY app "<application>Good ViBrations</application>">
<!ENTITY appname "Gvb">
]>
<!--
(Do not remove this comment block.)
Maintained by the GNOME Documentation Project
http://developer.gnome.org/projects/gdp
Template version: 2.0 beta
Template last modified Feb 12, 2002
-->
<!-- =============Document Header ============================= -->
<article id="index" lang="it_IT">
<!-- please do not change the id; for translations, change lang to -->
<!-- appropriate code -->
<articleinfo>
<title>Good ViBrations</title>
<copyright>
<year>2009</year>
<holder>Pietro Battiston</holder>
</copyright>
<!-- translators: uncomment this:
<copyright>
<year>2009</year>
<holder>ME-THE-TRANSLATOR (Latin translation)</holder>
</copyright>
-->
<!-- An address can be added to the publisher information. If a role is
not specified, the publisher/author is the same for all versions of the
document. -->
<publisher role="maintainer">
<publishername>Pietro Battiston (<email>toobaz@email.it</email>)</publishername>
</publisher>
<legalnotice id="legalnotice">
<para>Questo documento è rilasciato sotto una licenza Creative Commons ShareAlike 3.0 (CC-BY-SA).</para>
<para>Questo documento è distribuito nella speranza che sia utile, ma SENZA ALCUNA GARANZIA: senza neanche la garanzia implicita di COMMERCIABILITÀ o di APPLICABILITÀ PER UN PARTICOLARE SCOPO.</para>
<para>Una copia della licenza è disponibile <ulink url="http://creativecommons.org/licenses/by-sa/3.0">qui</ulink>.</para>
</legalnotice>
<!-- This file contains link to license for the documentation (GNU FDL), and
other legal stuff such as "NO WARRANTY" statement. Please do not change
any of this. -->
<authorgroup>
<author>
<firstname>Pietro</firstname>
<surname>Battiston</surname>
<affiliation>
<orgname>Sviluppatore di GVB</orgname>
</affiliation>
</author>
<othercredit role="translator">
<firstname>Pietro</firstname>
<surname>Battiston</surname>
<affiliation>
<orgname>Sviluppatore di GVB</orgname>
<email>toobaz@email.it</email>
</affiliation>
<contrib>Traduzione italiana</contrib>
</othercredit>
</authorgroup>
<revhistory>
<revision>
<revnumber>Manuale 1.0 di Gvb</revnumber>
<date>Novembre 2009</date>
<revdescription>
<para role="author">Pietro Battiston <email>toobaz@email.it</email></para>
<para role="publisher">Pietro Battiston</para>
</revdescription>
</revision>
</revhistory>
<releaseinfo>Questo manuale descrive la versione 1.2 di Good ViBrations (GVB).</releaseinfo>
<legalnotice>
<title>Feedback</title>
<para>Per segnalare un bug o dare suggerimenti riguardanti il programma <application>Good ViBrations</application> o questo manuale, si prega di utilizzare la <ulink url="https://bugs.launchpad.net/gvb" type="help">pagina su Launchpad del progetto</ulink>.</para>
<!-- Translators may also add here feedback address for translations -->
</legalnotice>
<abstract role="description">
<para>Manuale utente di <application>Good ViBrations</application>.</para>
</abstract>
</articleinfo>
<indexterm>
<primary>Good ViBrations</primary>
</indexterm>
<!-- ============= Document Body ============================= -->
<!-- ============= Introduction ============================== -->
<sect1 id="introduction">
<title>Introduzione</title>
<para><application>Good ViBrations</application> (letteralmente, "buone vibrazioni" in italiano) è un'applicazione per simulare vibrazioni in 1 e 2 dimensioni.</para>
<sect2 id="using">
<title>Finestra principale di Good ViBrations</title>
<para>La maggioranza delle funzionalità di <application>Good ViBrations</application> è accessibile direttamente dalla schermata principale:</para>
<figure id="main-window">
<title>Finestra principale di GVB</title>
<screenshot>
<mediaobject>
<imageobject>
<imagedata fileref="figures/main_window.png" format="PNG"/>
</imageobject>
<textobject> <phrase>Mostra la finestra principale di GVB.</phrase>
</textobject>
</mediaobject>
</screenshot>
</figure>
<para>Sulla sinistra, si può vedere l'area di visualizzazione principale, in cui si svolge la simulazione.</para>
<para>Sulla destra si trovano le varie regolazioni e gli indicatori: premere <guibutton>Parti</guibutton> per vederli in azione.</para>
<itemizedlist>
<listitem>
<para><guilabel>Velocità</guilabel>: imposta la velocità a cui si svolge la simulazione.</para>
</listitem>
<listitem>
<para><guilabel>Passo</guilabel>: per quei metodi di calcolo che operano in tempo discreto (si veda (see <xref linkend="calculation-methods"/> per informazioni), permette di impostare il tempo trascorso tra un'iterazione e la successiva. Più questo valore è basso, maggiore sarà la precisione della simulazione, ma anche il costo computazionale.</para>
</listitem>
<listitem>
<para>Sotto a <guilabel>Passo</guilabel> si trova il contatore, che mostra quanti fotogrammi sono stati calcolati dall'inizio della simulazione.</para>
</listitem>
<listitem>
<para><guilabel>ms. di calcolo</guilabel> riporta la media dei millisecondi spesi per calcolare ogni nuovo fotogramma (negli ultimi 2 seconds).</para>
</listitem>
<listitem>
<para><guilabel>ms. di disegno</guilabel> riporta la media dei millisecondi spesi per disegnare ogni nuovo fotogramma (negli ultimi 2 secondi).</para>
</listitem>
<listitem>
<para><guilabel>Corda</guilabel> e <guilabel>Superficie</guilabel> permettono di passare a simulazioni in (rispettivamente) 1 e 2 dimensioni. Cambiando questa impostazione, l'animazione sarà fermata e riavviata.</para>
</listitem>
<listitem>
<para>Sotto, il pulsante <guibutton>Start</guibutton> riporta ora la scritta <guibutton>Ferma</guibutton>: premendolo, l'animazione si arresterà.</para>
</listitem>
<listitem>
<para><guilabel>Metodo di calcolo</guilabel>: imposta il metodo di calcolo utilizzato. Si veda <xref linkend="calculation-methods"/> per una lista dei metodi e le rispettive descrizioni.</para>
</listitem>
<listitem>
<para><guilabel>Fotogramma/secondo</guilabel>: imposta il numero di fotogrammi visualizzati al secondo. Sotto i 20, l'animazione può essere scattosa, ma sopra i 25 non si dovrebbe notare quasi alcuna differenza (ed il costo computazionale salirà per i metodi che operano in tempo continuo).</para>
</listitem>
<listitem>
<para><guilabel>Grafica</guilabel>: imposta il metodo di visualizzazione. Si veda <xref linkend="drawing-methods"/> per una lista dei metodi e le rispettive descrizioni.</para>
</listitem>
</itemizedlist>
<warning>
<title>Troppa precisione può far male!</title>
<para><guilabel>Velocità</guilabel>, <guilabel>Passo</guilabel> e <guilabel>Fotogrammi/secondo</guilabel> sono parametri fondamentali (insieme al numero di punti utilizzati - si veda <xref linkend="number-of-points"/>) nel determinare la quantità di operazioni matematiche che il computer deve effettuare ogni secondo: se sono scelti valori eccessivi, l'animazione può diventare scattosa, o addirittura <application>Good ViBrations</application> può bloccarsi. In questa eventualità, cliccare <guibutton>Ferma</guibutton> (solo una volta): nella maggior parte dei casi, l'interfaccia tornerà alla normalità in pochi secondi.</para>
</warning>
</sect2>
<sect2 id="menu-file">
<title>Il menu <guimenu>File</guimenu></title>
<para>Il menu <guimenu>File</guimenu> elenca alcune operazioni generali:</para>
<itemizedlist>
<listitem>
<para><menuchoice><guimenu>File</guimenu><guimenuitem>Apri</guimenuitem></menuchoice>: apre una disposizione (ovvero la descrizione dei punti e delle loro velocità) da un file.</para>
</listitem>
<listitem>
<para><menuchoice><guimenu>File</guimenu><guimenuitem>Salva</guimenuitem></menuchoice>: salva la disposizione dei punti e le loro velocità in un file.</para>
</listitem>
<listitem>
<para><menuchoice><guimenu>File</guimenu><guimenuitem>Salva come</guimenuitem></menuchoice>: salva la disposizione dei punti e le loro velocità in un nuovo file (se non si è ancora salvata alcuna disposizione, questa opzione è equivalente a <menuchoice><guimenu>File</guimenu><guimenuitem>Salva</guimenuitem></menuchoice>).</para>
</listitem>
<listitem>
<para><menuchoice><guimenu>File</guimenu><guimenuitem>Esci</guimenuitem></menuchoice>: esci da <application>Good ViBrations</application>.</para>
</listitem>
</itemizedlist>
</sect2>
<sect2 id="menu-disposition">
<title>Il menu <guimenu>Disposizioni</guimenu></title>
<para>Il menu <guimenu>Disposizioni</guimenu> permette di impostare la forma della corda o della membrana all'inizio della simulazione. Ci sono due modi di farlo:</para>
<itemizedlist>
<listitem>
<para>scegliendo una delle disposizioni <guimenuitem>precotte</guimenuitem>: ne è disponibile una collezione, sia in 1 che in 2 dimensioni,</para>
</listitem>
<listitem>
<para>avviando l'editor <guimenuitem>avanzato</guimenuitem>, anche questo disponibile per 1 e 2 dimensioni (si veda <xref linkend="advanced-editor"/>).</para>
</listitem>
</itemizedlist>
</sect2>
<sect2 id="menu-options">
<title>Il menu <guimenu>Opzioni</guimenu></title>
<para>Il menu <guimenu>Opzioni</guimenu> permette di configurare alcuni aspetti della simulazione.</para>
<itemizedlist>
<listitem>
<para><menuchoice><guimenu>Opzioni</guimenu><guimenuitem>Numero di punti</guimenuitem></menuchoice>: cambia il numero di punti utilizzati nella simulazione (si veda <xref linkend="number-of-points"/>).</para>
</listitem>
<listitem>
<para><menuchoice><guimenu>Opzioni</guimenu><guimenuitem>Salva i fotogrammi come png</guimenuitem></menuchoice>: se questa casellina è spuntata, l'animazione verrà salvata su disco invece di essere resa sullo schermo: si veda <xref linkend="dump-to-png"/> per informazioni.</para>
</listitem>
</itemizedlist>
</sect2>
<sect2 id="menu-help">
<title>Il menu <guimenu>Aiuto</guimenu></title>
<para>Il menu <guimenu>Aiuto</guimenu> permette di accedere ad informazioni riguardanti il programma.</para>
<itemizedlist>
<listitem>
<para><menuchoice><guimenu>Aiuto</guimenu><guimenuitem>Sommario</guimenuitem></menuchoice>: apri questo manuale.</para>
</listitem>
<listitem>
<para><menuchoice><guimenu>Aiuto</guimenu><guimenuitem>Informazioni</guimenuitem></menuchoice>: mostra alcune informazioni su Good ViBrations.</para>
</listitem>
</itemizedlist>
</sect2>
</sect1>
<!--============== Number of points ===========-->
<sect1 id="number-of-points">
<title>Cambiare il numero di punti</title>
<para>In <application>Good ViBrations</application>, la corda e la membrana sono approssimate come un certo numero di punti connessi da segmenti diritti. Maggiore è il numero di punti, maggiore sarà la qualità della simulazione, ma crescerà anche il numero di operazioni di calcolo necessarie per effettuarla. Per cambiare il numero di punti, selezionare <menuchoice><guimenu>Opzioni</guimenu><guimenuitem>Numero di punti</guimenuitem></menuchoice>.</para>
<warning>
<para>
Una volta aperta questa finestra di dialogo, l'animazione, se attiva, si fermerà automaticamente e, se il numero di punti viene effettivamente cambiato, sarà riportata alla posizione iniziale, dato che <application>Good ViBrations</application> non è in grado di cambiare il numero di punti di una simulazione durante il suo svolgimento.
</para>
</warning>
<para>Mentre in 1 dimensione un numero può valere l'altro, in 2 dimensioni i punti devono essere disposti lungo una griglia rettangolare (quasi quadrata). Se il numero scelto non è adatto, ne saranno utilizzati meno. Ad esempio, se il numero di punti scelto è 11, ne verranno utilizzati solo 9 (3×3); se è 14, ne verranno utilizzati solo 12 (3×4).</para>
<warning>
<title>Quando i punti sono troppi</title>
<para>
Il numero di punti utilizzati è un parametro fondamentale per determinare il costo computazionale della simulazione: l'efficienza può peggiorare molto con il loro incremento, e mentre un numero tra 100 e 150 dovrebbe essere accettabile su qualsiasi computer, un numero superiore a questi livelli può far sì che l'interfaccia si blocchi (a seconda anche del metodo di calcolo scelto - si veda <xref linkend="calculation-methods"/> - e del valore degli altri parametri descritti in <xref linkend="using"/>).
</para>
</warning>
<tip>
<para>
Per osservare le armoniche, si può trovare il numero più adatto in questo modo:
<itemizedlist>
<listitem>
<para>prendere un numero con molti fattori piccolo, come ad esempio 2×2×3=12,</para>
</listitem>
<listitem>
<para>sottrarre 1: 11.</para>
</listitem>
<listitem>
<para>se si vuole effettuare una simulazione in 2 dimensioni, prenderne il quadrato: 11×11=121.</para>
</listitem>
</itemizedlist>
In questo esempio, sarà possibile osservare in modo ottimale le armoniche seconda, quarta e terza.
</para>
</tip>
</sect1>
<sect1 id="drawing-methods">
<title>Metodi di disegno</title>
<para><application>Good ViBrations</application> ha tre diversi modi di visualizzare una simulazione, sia in 1 che in 2 dimensioni, accessibili tramite la casella di scelta:</para>
<itemizedlist>
<listitem>
<para><guilabel>wave</guilabel>/<guilabel>3D</guilabel> i punti sono disegnati ad altezze diverse (in prospettiva se si sta lavorando in 2 dimensioni), formando qualcosa di effettivamente simile ad una corda o ad una membrana;</para>
</listitem>
<listitem>
<para><guilabel>speeds</guilabel> è simile al precedente, ma mostra anche la velocità istantanea di ogni punto, sotto forma di un segmento rosso orientato nella direzione del movimento;</para>
</listitem>
<listitem>
<para><guilabel>geo</guilabel> mostra le altezze similmente a come le mappe geografiche mostrano le altitudini: i punti sono rappresentati da quadratini, con colori che variano dal blu scuro (i punti più in basso) a blu chiaro, verde, marrone, marrone scuro ed infine bianco (i punti più alti).</para>
</listitem>
</itemizedlist>
</sect1>
<!-- ============= Advanced editor ============================== -->
<sect1 id="advanced-editor">
<title>L'editor avanzato di disposizioni</title>
<para>Selezionando <menuchoice><guimenu>Disposizioni</guimenu><guimenuitem>1 dimensione: avanzato</guimenuitem></menuchoice> o <menuchoice><guimenu>Disposizioni</guimenu><guimenuitem>2 dimensioni: avanzato</guimenuitem></menuchoice>, si accede all'editor avanzato di disposizioni. È una finestra che permette di configurare la posizione di partenza della corda o della membrana interattivamente, con molta più libertà di scelta che accontentandosi di una delle disposizioni <guimenuitem>precotte</guimenuitem>.</para>
<figure id="advanced-editor-2d">
<title>L'editor avanzato in 2 dimensioni</title>
<screenshot>
<mediaobject>
<imageobject>
<imagedata fileref="figures/advanced_editor_2d.png" format="PNG"/>
</imageobject>
<textobject> <phrase>Mostra l'editor avanzato GVB.</phrase>
</textobject>
</mediaobject>
</screenshot>
</figure>
<para>In cima, la casella di scelta <guilabel>Grafica</guilabel> permette di cambiare la visualizzazione della disposizione all'interno dell'editor, un po' come nella finestra principale. Si noti che in questo caso non c'è particolare differenza tra <guilabel>wave</guilabel>/<guilabel>3D</guilabel> e <guilabel>speeds</guilabel>, dato che non si sta considerando alcuna velocità.</para>
<para>L'editor avanzato si utilizza regolando i parametri di certe forme d'onda e combinandole. Sulla sinistra, si può vedere un'anteprima della disposizione mano a mano che le modifiche sono applicate. Sulla destra si trovano le varie regolazioni per modificare la forma fino a raggiungere quella desiderata.</para>
<sect2 id="dimension-specific-controls">
<title>Regolazioni per una dimensione specifica</title>
<itemizedlist>
<listitem>
<para><guilabel>Forma d'onda</guilabel>: stabilisce la forma base della onda da usare: può essere <guilabel>sinusoidale</guilabel>, <guilabel>triangolare</guilabel>, <guilabel>quadrata</guilabel> o un semplice <guilabel>picco</guilabel>.</para>
</listitem>
<listitem>
<para><guilabel>Lunghezza d'onda</guilabel>: stabilisce la frazione dello spazio disponibile che la nuova forma deve occupare. Il valore iniziale è "tutta"; se ad esempio il cursore viene spostata a metà corsa, la forma risultante occuperà solo metà dell'intero spazio della simulazione.</para>
</listitem>
<listitem>
<para><guilabel>Spostamento</guilabel>: stabilisce se la forma deve partire dal primo punto (è il valore di default) o da un qualche altro punto nel mezzo. Si noti che se l'onda è spostata fino a superare il limite dello spazio totale, la parte in eccesso dalla parte destra/anteriore viene aggiunta dalla parte sinistra/posteriore, in una sorta di rotazione.</para>
</listitem>
<listitem>
<para><guilabel>Lunghezza d'onda</guilabel>: stabilisce la lunghezza d'onda della forma base, ovvero lo spazio occupato da una sua ripetizione completa, o in altre parole la distanza tra due picchi successivi. Il valore iniziale è esattamente lo spazio disponibile, ma lo si può accrescere fino a 4 volte tanto e diminuire fino a 4 volte meno.</para>
</listitem>
<listitem>
<para><guilabel>Fase</guilabel>: stabilisce la fase dell'onda, ovvero la traslazione che viene effettuata alla forma base. Se <guilabel>Lunghezza totale</guilabel> ha il valore massimo, l'effetto di questa regolazione è esattamente lo stesso di <guilabel>Spostamento</guilabel>; se invece così non è, può essere utilizzata per traslare/ruotare la forma d'onda all'interno dell'intervallo di applicazione.</para>
</listitem>
<listitem>
<para><guilabel>Ampiezza</guilabel>: stabilisce l'ampiezza dell'onda, ovvero la distanza verticale tra un picco e la linea di riposo: il valore di default è il massimo; se ridotto, tutta la forma d'onda viene riscalata verticalmente.</para>
</listitem>
<listitem>
<para><guilabel>Centratura</guilabel>: stabilisce a che punto la forma d'onda deve raggiungere il picco massimo: normalmente è posto a metà, e la forma d'onda e simmetrica; spostandolo a sinistra aumenterà la pendenza della forma d'onda a sinistra ed aumenterà a destra, e viceversa spostandolo a destra.</para>
</listitem>
<listitem>
<para><guilabel>Rifletti</guilabel>: selezionando questa casella, la forma d'onda viene riflessa rispetto ad un asse verticale posto a metà.</para>
</listitem>
</itemizedlist>
<para>Quelle elencate sono proprietà legate ad una singola dimensione: quando si lavora in 2 dimensioni, ognuna di esse è ripetuta due volte, una nella colonna <guilabel>Orizzontale</guilabel> ed una in quella <guilabel>Verticale</guilabel>, e riguarda rispettivamente il dominio sinistra-destra e quello dietro-avanti.</para>
</sect2>
<sect2 id="general-controls">
<title>Controlli generali</title>
<para>Le altre opzioni che seguono invece si applicano genericamente ad 1 o 2 dimensioni.</para>
<itemizedlist>
<listitem>
<para><guilabel>Inverti</guilabel>: selezionando questa casella, la forma d'onda è invertita, ovvero ogni punto viene riflesso rispetto ad un piano orizzontale: ciò che è sotto andrà sopra e viceversa.</para>
</listitem>
<listitem>
<para><guilabel>Regola di composizione</guilabel> (solo in 2 dimensioni): dato che le regolazioni legate ad una singola dimensione permettono di forgiare solo due particolari forme d'onda monodimensionali, che verranno orientate rispettivamente da sinistra a destra e da dietro a davanti, è qui possibile stabilire come queste forme dovranno combinarsi:</para>
<itemizedlist>
<listitem><guilabel>prodotto</guilabel>: l'altezza di ogni punto sarà il prodotto delle altezze date dalle due forme d'onda;
</listitem>
<listitem><guilabel>somma</guilabel>: l'altezza di ogni punto sarà la somma delle altezze date dalle due forme d'onda;
</listitem>
<listitem><guilabel>massimo</guilabel>: l'altezza di ogni punto sarà il valore massimo assunto tra le due forme d'onda;
</listitem>
<listitem><guilabel>minimo</guilabel>: l'altezza di ogni punto sarà il valore minimo assunto tra le due forme d'onda.
</listitem>
</itemizedlist>
</listitem>
<listitem>
<para><guilabel>Aggiungi alla posizione attuale</guilabel>: se il numero di dimensioni in cui stiamo lavorando è lo stesso utilizzato nella simulazione nella finestra principale, è possibile, selezionando questa casella, sommare la forma d'onda che si sta creando con lo stato corrente della simulazione. Ciò fornisce uno strumento molto potente per creare disposizioni arbitrariamente complesse, semplicemente aggiungendo una forma d'onda alla volta, eventualmente ognuna ristretta ad una parte soltanto dello spazio disponibile.</para>
</listitem>
</itemizedlist>
<para>In fondo alla finestra, sono presenti tre pulsanti.</para>
<itemizedlist>
<listitem>
<para><guibutton>Ripristina</guibutton> riassegna ad ogni regolazione il suo valore iniziale.</para>
</listitem>
<listitem>
<para><guibutton>Annulla</guibutton> chiude la finestra, annullando ogni modifica fatta.</para>
</listitem>
<listitem>
<para><guibutton>Applica</guibutton> chiude la finestra, rendendo effettive le modifiche.</para>
</listitem>
</itemizedlist>
</sect2>
</sect1>
<sect1 id="calculation-methods">
<title>Metodi di calcolo</title>
<para><application>Good ViBrations</application> mette a disposizione diversi metodi di calcolo, accessibili dal menu a scelta <guilabel>Metodi ci calcolo</guilabel>, nella finestra principale.</para>
<warning>
<title>Attenzione, dettagli tecnici!</title>
<para>Questa pagina contiene una lista dettagliata dei vari algoritmi disponibili <application>Good ViBrations</application> e dei loro aspetti tecnici; in quanto tale, potrebbe non essere comprensibile a chi non fosse abituato ai concetti matematici adoperati. Siccome <application>Good ViBrations</application> non è fatto solo per i laureati in matematica, ecco un riassunto più sintetico:</para>
<itemizedlist>
<listitem>
<para><guilabel>naif</guilabel>: spreciso e lento, non c'è nessun motivo reale di utilizzarlo;</para>
</listitem>
<listitem>
<para><guilabel>naif matrix</guilabel>: identico a <guilabel>naif</guilabel>, ma più veloce;</para>
</listitem>
<listitem>
<para><guilabel>quad</guilabel>: più preciso, ma anche più pesante dal punto di vista dei calcoli necessari;</para>
</listitem>
<listitem>
<para><guilabel>eig</guilabel>: meno preciso di <guilabel>quad</guilabel> per animazioni molto brevi, ma il migliore a lungo termine, dato che non introduce o amplifica errori con il passare del tempo: tuttavia, deve effettuare alcuni calcoli iniziali, che potrebbero richiedere molto tempo e bloccare l'interfaccia prima dell'inizio dell'animazione se il numero di punti utilizzato è alto.</para>
</listitem>
</itemizedlist>
</warning>
<para>Quella che segue è la lista più dettagliata.</para>
<itemizedlist>
<listitem>
<para><guilabel>naif</guilabel> opera in tempo discreto: calcola la posizione di un punto ad una data iterazione grosso modo come la posizione nell'iterazione precedente più la velocità nell'iterazione precedente, moltiplicata per il tempo trascorso (che è dato dal parametro <guilabel>Passo</guilabel>), e la velocità in una data iterazione come la differenza tra la sua altezza e l'altezza media dei punti circostanti nell'iterazione precedente.</para>
</listitem>
<listitem>
<para><guilabel>naif matrix</guilabel> è identico a <guilabel>naif</guilabel>, tranne che non calcola i punti uno alla volta, ma li tratta come un vettore, che è aggiornato iterazione dopo iterazione moltiplicandolo per una matrice data. Lo si può considerare un test di riferimento: paragonare i tempi di calcolo con quelli di <guilabel>naif</guilabel> dà l'idea di quanto le librerie scipy utilizzate per i calcoli matriciali siano più efficienti del semplice codice Python.</para>
</listitem>
<listitem>
<para><guilabel>quad</guilabel> è simile a <guilabel>naif</guilabel>, tranne che non linearizza il calcolo della velocità: essa non è più la semplice differenza in altezza rispetto ai punti circostanti, ma prende in considerazione la distanza "vera", compresa la componente orizzontale.</para>
</listitem>
<listitem>
<para><guilabel>eig</guilabel> opera in tempo continuo: prende il problema linearizzato (come <guilabel>naif</guilabel>), ma considera il sistema associato di equazioni differenziali, che è definito da una certa matrice, di cui calcola l'esponenziale: per effettuare questa operazione, deve calcolarne gli autovalori ed autovettori (grazie alla libreria scipy). Una volta finito questo calcolo, non fa altro che moltiplicare tra di loro la matrice risultante e la matrice diagonale data dagli esponenziali degli autovalori.</para>
</listitem>
</itemizedlist>
</sect1>
<sect1 id="dump-to-png">
<title>Salvare i fotogrammi come immagini</title>
<para>Selezionando <menuchoice><guimenu>Opzioni</guimenu><guimenuitem>Salva fotogrammi come png</guimenuitem></menuchoice>, si aprirà una finestra di dialogo in cui sarà possibile scegliere una cartella, ed i fotogrammi saranno quindi salvati in quella cartella come immagini png, invece di essere visualizzati sullo schermo. Questa funzionalità è comoda per creare un video, o quando la complessità dei calcoli richiesti è eccessiva per una visualizzazione in tempo reale.</para>
<para>Deselezionando la casellina, l'animazione riprenderà ad essere visualizzata sullo schermo.</para>
<tip>Un modo semplice per trasformare le immagini così prodotte in un video è il seguente:
<itemizedlist>
<listitem>
<para>assicurarsi che il programma <command>ffmpeg</command> sia installato nel sistema,</para>
</listitem>
<listitem>
<para>aprire un terminale e spostarsi nella cartella contentente le immagini preparate con <application>Good ViBrations</application>,</para>
</listitem>
<listitem>
<para>dare il comando <command>ffmpeg -i %08d.png video.mp4</command>.</para>
</listitem>
</itemizedlist></tip>
</sect1>
</article>
|
