home *** CD-ROM | disk | FTP | other *** search
/ Aminet 18 / aminetcdnumber181997.iso / Aminet / misc / sci / graph303c.lha / GraphWrite / graphwrite_it.doc < prev    next >
Encoding:
Text File  |  1980-01-31  |  15.3 KB  |  436 lines
  1. -----------------------------  GUIDA DI GRAPHWRITE ---------------------------
  2.  
  3.             GRAPHWRITE PROGRAMMATO DA:
  4.  
  5.                      POMPEI LUCA
  6.  
  7.             Via Togliatti 47 - 40026 IMOLA (BO) (ITALY)
  8.  
  9.                      Tel. 0542/640056
  10.  
  11.            
  12.            INDIRIZZO FIDONET: 2:332/405.23
  13.  
  14.            Le ultime versioni di Graphwrite si possono trovare:
  15.            IDCMP BBS Imola(BO) 0542-25983   2:332/405 fidonet
  16.                            2400 --> 28800 baud
  17.                                 GRAPH303.LHA
  18.  
  19. *****************************************************************************
  20.  
  21. VERSIONE DI PUBBLICO DOMINIO
  22.  
  23. *****************************************************************************
  24.  
  25. ISTRUZIONI PER L'USO DI GRAPHWRITE
  26.  
  27. INSTALLAZIONE                           - 49
  28. A COSA SERVE?                           - 61
  29. FORMATO FILE INPUT                      - 69
  30. LANCIO DA DOS                           - 82
  31. DESCRIZIONE MENU                        - 133
  32. FITTING                                 - 284
  33. FINESTRA DI OUTPUT                      - 294
  34. SALVATAGGIO IN ENCAPSULATED POSTSCRIPT  - 313
  35. USO DI GRAPHWRITE                       - 369
  36. CONFIGURAZIONE                          - 395
  37. COPYRIGHT                               - 409
  38.  
  39. ******************************************************************************
  40.  
  41. INSTALLAZIONE:
  42. --------------
  43. Creare una directory es. GRAPHWRITE ed esplodere li dentro il file compresso
  44. poi copiare il contenuto della directory Gfont in FONTS:.
  45. E' sufficente che tutti i file della directory GRAPHWRITE non vengano rimossi
  46. (tranne i file di dati e i sorgenti) per il corretto funzionamento del
  47. programma.
  48. N. B. La libreria reqtools.library X os 2.0 deve essere presente
  49. nella directory LIBS: quindi assicurarsi di averla prima di eseguire il prog.
  50. Essa puo' essere reperita in BBS come libreria PD.
  51. @endnode
  52.  
  53. A COSA SERVE:
  54. ------------------
  55. Il programma è un creatore di grafici X/Y con possibilità di fitting che
  56. utilizza dei file di dati ASCI come input.
  57. Con esso è possibile produrre, sovrapporre, stampare, interpolare ed
  58. esportare grafici.
  59.  
  60.  
  61. FORMATO FILE DI INPUT:
  62. ----------------------
  63. I file di input dei dati devono essere in formato ASCI e disposti come segue:
  64.  
  65. x1 y1
  66. x2 y2
  67. x3 y3
  68. x4 y4
  69. .. ..
  70. Xn Yn
  71.  
  72.  
  73.  
  74. ************ LANCIO DA DOS *************
  75.  
  76. E' possibile lanciare il programma da dos e specificare nella linea di comando
  77. il file da graficare ed una serie di comandi che ora saranno descritti.
  78.  
  79. sintassi:
  80.  
  81. GRAPHWRITEMAIN [filename] [COMMAND1 data COMMAND2 data ....]
  82.  
  83. COMANDI:
  84. MAX <xmax> <ymax> specifica i massimi degli assi x e y
  85. MIN <xmin> <ymin>    "      le origini  "    "   "   "
  86. TITLE <title>        "      il titolo del grafico
  87. NOTE <note>          "      le note    "    "
  88. LEG <string legend>  "      la leggenda"    "
  89. MAXTIK <x> <y>       "      lo step dei tratti numerati degli assi
  90. MINTIK <x> <y>       "      lo step dei trattini non numerati degli assi
  91. MAXGRID              "      la griglia sui tratti numerati
  92. MINGRID              "      la griglia tratteggiata sui trattini non numerati
  93. CONFIG <configfile>  "      il file di configurazione da utilizzare. I file di
  94.                              configurazione sono generati solo dal programma.
  95.  
  96. Es.
  97.  
  98. >graphwritemain dati MAX 3 1 LEG stringa TITLE prova
  99.  
  100. il programma appena lanciato provvede a caricare e a graficare il file "dati"
  101. utilizzando come titolo la parola "prova" come legenda la parola "stringa"
  102. e come massimi degli assi i valori 3 (x) e 1 (y).
  103.  
  104. oppure
  105.  
  106. >graphwritemain dati CONFIG myconfig
  107.  
  108. Il prog. carica il file di dati "dati" ed utilizza i parametri
  109. contenuti nel file di configurazione "myconfig"
  110.  
  111. In questo modo e' possibile utilizzare il mio programma come modulo di
  112. graficazione richiamabile dai vostri programmi.
  113. in C si puo' scrivere:
  114. .......
  115. system("graphwritemain datafile commands .....");
  116. .....
  117. ecc.
  118.  
  119. Provare ora a lanciare l'icona "example", essa carichera' il programma
  120. utilizzando come dati il file "dati1" e il file di configurazione
  121. "config2".
  122. ---------------------------------------------------------------------------------------
  123.  
  124.  
  125. **************** MENU DEL PROGRAMMA ******************
  126.  
  127.  
  128.                 PROJECT     -141
  129.                 PARAMETER   -174
  130.                 GRAPH       -256
  131.  
  132.  
  133. MENU PROJECT:
  134. -------------
  135. LOAD:
  136. carica i file di dati.
  137. Appare un requester molto chiaro da interpretare in cui deve essere
  138. specificato il file.
  139.  
  140. EDIT DATA:
  141. edita il file di dati corrente (dataset corrente).
  142. Viene richiamato l'editor c:ed.
  143.  
  144. DATASET:
  145. consente di specificare in quale set di dati operare con le voci dei menu
  146. (modifiche caricamenti ecc.).
  147.  
  148. DEL DATA:
  149. cancella il data set corrente (specificato con la voce di menu dataset).
  150.  
  151. PRINT:
  152. stampa su stampante o in file ILBM del grafico corrente.
  153. Per la stampa su stampante aspettare una decina di secondi per
  154. permettere al dumper di preparare la stampa.
  155.  
  156. PLOT:
  157. stampa il grafico in formato enc. postscript su un file di nostra scelta.
  158.  
  159. ABOUT:
  160. Notizie sul programma.
  161.  
  162. QUIT:
  163. esce dal programma.
  164.  
  165.  
  166. MENU PARAMETER:
  167. ---------------
  168.  
  169. CONFIG:
  170. -LOAD config:
  171. carica unaa configurazione del programma riguardante tutti i parametri
  172. modificabili da menu'
  173. -SAVE config:
  174. Salva la configurazione corrente del programma in un file di vostra scelta
  175. N.B. non includere nei testi del grafico il carattere "@" in quanto viene
  176.      utilizzato dal prog. per il suo funzionamento.
  177.      Se si immette tale carattere in un testo e si salva la configurazione,
  178.      il programma poi non e' piu' in grado di recuperarla con loadconfig.
  179.  
  180. ORIGIN:
  181. X:
  182. origine dell'asse X
  183. Y:
  184. origine dell'asse Y
  185. sono settati 0 0 per default.
  186.  
  187. SCALE:
  188. -XMAX:
  189. inserimento del valore max dell'asse x.
  190. -YMAX:
  191. inserimento del valore max. Dell'asse y.
  192. Se non specificati vengono utilizzati i valori di x e di y massimi presenti
  193. in tutti i file di dati caricati.
  194.  
  195. UNITS:
  196. apre una finestra in cui è possibile inserire le unità di misura dei trattini
  197. presenti sugli assi, nonché di selezionare le griglie ad essi relativi.
  198.  
  199. FIT:
  200.  Permette di selezionare il tipo di fitting da utilizzare per il corrente
  201.  dataset.
  202.  N. B. Il fitting viene eseguito sul dataset correntemente selezionato.
  203. -Select:
  204.  apre una finestra in cui è possibile selezionare una delle 22 funzioni
  205.  interpolanti inserite nel prog.
  206.  FUNZIONE N. 20 interpolazione polinomiale:
  207.  Appare un requester in cui si deve indicare il grado del polinomio (max 9).
  208.  Best polinomial fit:
  209.  Inserendo 0 viene calcolato il polinomio con correlazione 1 (questa funzione
  210.  puo' portare a polinomi di elevato grado).
  211.  Vengono poi visualizzati i dati del calcolo, premendo "print" nel requester
  212.  di visualizzazione dati e' possibile stampare i dati del polinomio.
  213.  FUNZIONE N. 21 interpolazione di lagrange:
  214.  Viene utilizzato un polinomio di lagrange di grado N, dove N è il numero
  215.  di punti da interpolare.
  216.  Questo tipo di polinomi sono molto accurati nei punti intermedi del grafico
  217.  ma possono mostrare notevoli deviazioni agli estremi.
  218.  FUNZIONE N. 22 interpolazione a mezzo di spline:
  219.  in questo caso per la interpolazione viene utilizzata una funzione di
  220.  spline, che puo' essere molto utile perchè interpreta in modo pressochè
  221.  perfetto i punti sperimentali.
  222. -Best-fit:
  223.  il programma calcola quale funzione (tranne la 20, 21 e 22) permette di
  224.  raggiungere il coefficiente di correlazione migliore.
  225. -Calculate:
  226.  Viene chiesto un valore di X e viene mostrato il corrispondente valore
  227.  y della funzione interpolante in quel punto x.
  228. -Save curve-fit:
  229.  Permette il salvataggio per punti della curva interpolante del dataset
  230.  corrente in un file ASCI di dati x y.
  231.  Viene richiesto il nome del file, il valore di xiniziale, xfinale e numero
  232.  punti con cui salvare la curva.
  233. -Integrate:
  234.  Permette l'integrazione attraverso il metodo di simpson della curva inter-
  235.  polante tra gli estremi forniti dall'utente (X0,X1).
  236.  
  237. POINT:
  238. possibilità di selezionare nel dataset corrente cerchi, quadrati,
  239. asterischi o niente come segnalatori nel grafico dei punti sperimentali
  240. caricati, nonché di selezionarne la dimensione.
  241. Se non specificati il programma utilizza symboli differenti per ogni set di
  242. dati caricato.
  243.  
  244. LINETYPE:
  245. consente di selezionare per il dataset corrente un certo tipo di linea.
  246.  
  247. COLORS:
  248. consente di cambiare i colori dei vari dataset caricati.
  249.  
  250.  
  251.  MENU  GRAPH:
  252.  -----------
  253.  
  254. KIND:
  255. per adesso solo grafici tipo xy.
  256. Se ci sara' la voglia allora pensero' ad includere anche la possibilita'
  257. di grafici a torta, a sbarre ecc.
  258.  
  259. TITLE:
  260. consente di modificare il testo, la posizione ed il font del titolo.
  261.  
  262. NOTE:
  263. consente di modificare il testo, la posizione ed il font delle note del
  264. grafico.
  265.  
  266. AXIS:
  267. consente di modificare il testo ed il font dei titoli degli assi del
  268. grafico.
  269.  
  270. LEGEND:
  271. consente di specificare testi e posizione della legenda.
  272.  
  273. DRAW:
  274. disegna il grafico.
  275. @endnode
  276. @endnode
  277. --------------------------------------------------------------------------
  278.  
  279. ***************************** FITTING ************************************
  280.  
  281. Il fitting è quel particolare procedimento matematico che permette di
  282. determinare una funzione matematica il cui andamento approssima al meglio
  283. una serie di punti sperimentali xy.
  284. Tale funzione puo' essere graficata insieme ai punti sperimentali per
  285. evidenziare la bontà dell'accordo.
  286. vedi menu parameter-fit (Linea 207) per ulteriori precisazioni.
  287. --------------------------------------------------------------------------
  288.  
  289. ************************   FINESTRA DI OUTPUT:  *************************
  290.  
  291. sono visibili dei pulsanti "draw","load","dataset","fit" che permettono
  292. di disegnare il grafico, caricare dati, cambiare il set di dati corrente
  293. e selezionare una funzione interpolante.
  294.  
  295. -Selezione dei dati da modificare sul grafico:
  296.  
  297. Cliccando inoltre sulle varie parti del grafico e' possibile selezionare
  298. le finestre di modifica degli oggetti selezionati.
  299.  
  300. es.
  301. Cliccando sugli assi viene richiamata la finestra di gestione delle
  302. spaziature tra i trattini e il settaggio delle griglie.
  303. Cliccando invece alle estremita' degli assi e' possibile modificare
  304. l'origine o la scala degli assi.
  305. @endnode
  306. ---------------------------------------------------------------------------
  307.  
  308. ****************** SALVATAGGIO IN ENCAPSULATED POSTSCRIPT ******************
  309.  
  310. Selezionando la voce PLOT e' possibile stampare il grafico corrente su
  311. disco in formato encapsulated-postscript.
  312. Questa opzione permette di caricare il grafico prodotto in formato
  313. vettoriale su prog. amiga che hanno tale funzione (word processor come
  314. wordworth ecc.) e su altri sistemi operativi.
  315. E' possibile utilizzare il formato eps2.0 leggibile direttamente da
  316. art-expression oppure il formato generico EPSF3.0 leggibile dalla
  317. maggior parte dei prog. vettoriali su pc.
  318. Per ora io lo ho testato con ART EXPRESSION, noto manipolatore
  319. di immagini vettoriali su amiga.
  320. Tramite esso e' possibile esportare in formato dr2d compatibile con
  321. Pagestream (prog. di DTP).
  322.  
  323. ----------  FONT: -------------
  324.  
  325. I font utilizzati da GRAPHWRITE sono di tipo Bitmap, quelli da me forniti
  326. nella directory gfont se copiati in FONTS: e utilizzati per il grafico
  327. permettono di utilizzare i font vettoriali forniti con art-expression quando
  328. a quest'ultimo viene fatto caricare un file postscript generato dal mio
  329. programma.
  330. Se si dispone di s.o 3.0 e' possibile utilizzare i font vettoriali
  331. agfa, in questo caso la stampa diretta su stampante avra' una qualita'
  332. superiore.
  333.  
  334. Installazione di un nuovo font:
  335. -------------------------------
  336. Per installare nuovi font e fare in modo che art-expression li riconosca
  337. e' necessario disporre per ogni font di due formati, uno vettoriale usato
  338. da art-expression(Adobe type 1) e uno Bitmap utilizzabile dal sistema.
  339. Copiare il font bitmap nella directory FONTS: e quello vettoriale nella
  340. directory dei fonts di art-expression (Aefonts).
  341. Importante che i due tipi di font abbiano lo stesso nome sia per graphwrite
  342. (nome corrente in FONTS:) che per artexpression (nome indicato nella
  343. fontlist utilizzata dal prog.).
  344. es. font bitmap = Times.font, font vett. corrispondente = TI.pfb (normal),
  345. TIB.pfb (bold), TII.pfb (italic), TIBI.pfb (bolditalic) la fontlist di
  346. artexpression dovra' contenere:
  347. ........
  348. TI.pfb Times
  349. TIB.pfb Times-Bold
  350. TII.pfb Times-Italic
  351. TIBI.pfb Times-BoldItalic
  352. .......
  353. Le maiuscole sono importanti, se il font bitmap fosse stato times.font
  354. in questo caso artexpression non avrebbe riconosciuto il font e utilizzato
  355. quello di default nell'importazione da graphwrite.
  356.  
  357. Modifica del nome di un bitmap:
  358. es. times.font -> Times.font
  359. 1)rinominare in FONTS: la directory times con Times
  360. 2)eseguire il prog. FixFonts fornito assieme al WB 2.0 o 3.0, esso
  361.   provvedera' ad aggiornare i file .font nella directory FONTS:
  362. ---------------------------------------------------------------------------------
  363.  
  364. ***************************   USO DI GRAPHWRITE   ********************************
  365.  
  366. Come fare il primo grafico:
  367. ----------------------------
  368.  
  369. Caricare il programma.
  370. selezionare LOAD e scegliere il file "data"
  371. selezionare DATASET e cliccare su 2
  372. selezioanre LOAD e scegliere il file "data1"
  373. selezionare DATASET e cliccare su 3
  374. selezionare LOAD e scegliere il file "data2"
  375.  
  376. cliccare su DRAW
  377.  
  378. ora potete sbizarrirvi a cambiare i parametri ecc.
  379.  
  380. E' possibile accedere alle finestre di modifica delle varie parti del grafico
  381. semplicemente cliccando sulla zona del grafico interessata.
  382. Se si clicca in un punto vuoto del grafico vengono mostrate nella finestra in
  383. alto le coordinate reali di quel punto (vedi finestra di output).
  384.  
  385. Per chi intende utilizzare il mio programma come modulo di graficazione
  386. esterno per altri programmi legga la parte riguardante il lancio da dos.
  387. -------------------------------------------------------------------------------------
  388.  
  389.  
  390. *************************  CONFIGURAZIONE DI GRAPHWRITE  ******************************
  391.  
  392. Richiamare il programma "graphconfig" cliccando sulla sua icona.
  393. Esso permette di selezionare il tipo di schermo sul quale graphwrite dovrà
  394. operare ed il, font utilizzato dai menu di graphwrite.
  395. Tutto questo lo si fa semplicemente selezionando l'apposito modo schermo
  396. e font nei requester del programma di configurazione.
  397. Uscendo dal programma la nuova configurazione viene salvata nel file
  398. graph.config che deve essere presente nella stessa directory, assieme al
  399. graphwrite.
  400.  
  401.  
  402.  
  403.               COPYRIGHT/LICENZA/GARANZIA
  404.  
  405.     I  file di graphwrite  e   questo  documento  sono   di
  406. proprieta'   dell'  autore   (Pompei Luca).
  407.     Il proprietario  pero' consente:  
  408. l' uso del  software, la sua copia in quantita' illimitata,
  409. la sua  distribuzione a chiunque.
  410.     E'  tuttavia  proibito  nella  maniera  piu'   assoluta
  411. richiedere donazioni  o contributi di alcun genere per tali
  412. copie, comunque vengano eseguite.
  413.     E' altresi'  proibito distribuire  il software   e/o la
  414. documentazione congiuntamente  a prodotti commerciali senza
  415. esplicito consenso scritto dell ' autore.
  416.     E' anche proibito utilizzare il software registrato ad
  417. un'altra persona, il cui nome  compare  all'interno  del 
  418. programma.
  419.  
  420.     Nessuna copia  del software  puo'  essere   distribuita
  421. senza  questo   documento (e la sua versione inglese) e tutti
  422. i file che costituiscono il pacchetto originale;  ne'
  423. il  software  ne'  questo documento possono  essere alterati
  424. in nessun modo, non sono consentite operazioni di reverse
  425. engineering, dissasemblazione o altri metodi.
  426.  
  427.     Non c'e'  nessuna garanzia di nessun tipo,  e l' autore
  428. non e'  responsabile  di  danni  di  nessun  tipo  generati
  429. direttamente o indirettamente dall' uso proprio o improprio
  430. del software.
  431.  
  432.     ENTRANDO IN POSSESSO E/O USANDO QUESTO SOFTWARE SI
  433. ACCETTANO NEL MODO PIU' COMPLETO E SENZA CONDIZIONI QUESTE
  434.                        DISPOSIZIONI.
  435.  
  436.