Cos'è ElectroYou | Login Iscriviti

ElectroYou - la comunità dei professionisti del mondo elettrico

Tool per inserire equazioni nei commenti del software

Strumenti informatici per la matematica applicata, le simulazioni, il disegno: Mathcad, Matlab, Scilab, Microcap, PSpice, AutoCad ...

Moderatori: Foto Utenteg.schgor, Foto Utentedimaios

10
voti

[1] Tool per inserire equazioni nei commenti del software

Messaggioda Foto Utentedimaios » 21 giu 2013, 17:28

Ho trovato una applicazione a mio avviso molto utile che risolve un problema ricorrente ..... scrivere le equazioni nel commento del codice.

Infatti, per documentare i calcoli risulta piuttosto scomodo fornire un documento separato perche' il programmatore mediamente si riferisce sempre al sorgente.

A questo proposito ho cercato un'applicazione che traducesse in "ASCII Art" le equazioni ed ho trovato questo

http://sourceforge.net/projects/asciitex/?source=dlp

E' fatto piuttosto bene e l'ho trovato utile perche' converte il LaTex in ASCII Art e quindi con un semplice Cut & Paste si inserisce la formula nel codice sorgente favorendo il debug e le modifiche da parte del programmatore.

Veramente un bel lavoro da parte dell'autore. =D>

A me e' piaciuto molto e spero sia utile anche a voi. ;-)
Ingegneria : alternativa intelligente alla droga.
Avatar utente
Foto Utentedimaios
28,7k 7 10 12
G.Master EY
G.Master EY
 
Messaggi: 3209
Iscritto il: 24 ago 2010, 14:12
Località: Behind the scenes

1
voti

[2] Re: Tool per inserire equazioni nei commenti del software

Messaggioda Foto Utentecarlomariamanenti » 21 giu 2013, 18:12

Bello e utile, grazie Foto Utentedimaios! :ok:
Avatar utente
Foto Utentecarlomariamanenti
58,5k 5 11 13
G.Master EY
G.Master EY
 
Messaggi: 4269
Iscritto il: 18 gen 2012, 10:44

0
voti

[3] Re: Tool per inserire equazioni nei commenti del software

Messaggioda Foto Utentedimaios » 21 giu 2013, 18:14

:ok:
Ingegneria : alternativa intelligente alla droga.
Avatar utente
Foto Utentedimaios
28,7k 7 10 12
G.Master EY
G.Master EY
 
Messaggi: 3209
Iscritto il: 24 ago 2010, 14:12
Località: Behind the scenes

0
voti

[4] Re: Tool per inserire equazioni nei commenti del software

Messaggioda Foto UtenteDirtyDeeds » 21 giu 2013, 19:58

Un'altra possibilità, un po' più complessa però, è quella di commentare il codice secondo il formato Doxygen, scrivendo le formule in LaTeX, e usando Doxygen per generare la documentazione in LaTeX o in HTML.
It's a sin to write sin instead of \sin (Anonimo).
...'cos you know that cos ain't \cos, right?
You won't get a sexy tan if you write tan in lieu of \tan.
Take a log for a fireplace, but don't take log for \logarithm.
Avatar utente
Foto UtenteDirtyDeeds
55,7k 7 11 13
G.Master EY
G.Master EY
 
Messaggi: 7013
Iscritto il: 13 apr 2010, 16:13
Località: Somewhere in nowhere

0
voti

[5] Re: Tool per inserire equazioni nei commenti del software

Messaggioda Foto Utentexyz » 21 giu 2013, 20:49

Io uso Doxygen per documentare il codice, ha il supporto per le formule in LaTex. Nei sorgenti rimangono in LaTex ma poi quando si genera la documentazione in HTML, PDF, LaTex, ecc... sono rese nel miglior modo possibile in base al formato d'uscita.

http://www.stack.nl/~dimitri/doxygen/ma ... mulas.html
Avatar utente
Foto Utentexyz
5.945 2 4 5
G.Master EY
G.Master EY
 
Messaggi: 1583
Iscritto il: 5 dic 2009, 18:37
Località: Italy Turin

1
voti

[6] Re: Tool per inserire equazioni nei commenti del software

Messaggioda Foto Utentedimaios » 21 giu 2013, 21:02

Doxygen è sicuramente un tool molto potente ma l'idea di scrivere un commento con la formula seppure in formato ASCII art like mi sembra immediato e utile ... e perché no...anche bello da vedere.
Ingegneria : alternativa intelligente alla droga.
Avatar utente
Foto Utentedimaios
28,7k 7 10 12
G.Master EY
G.Master EY
 
Messaggi: 3209
Iscritto il: 24 ago 2010, 14:12
Località: Behind the scenes

0
voti

[7] Re: Tool per inserire equazioni nei commenti del software

Messaggioda Foto Utentespud » 26 giu 2013, 13:59

L'ho provato e mi è venuta una domandina, se ad esempio la formula è composta da più righe, per inserirla nel codice copi una riga alla volta e poi le allinei a mano?
Atlant.

Behind every great man is a woman rolling her eyes.
Avatar utente
Foto Utentespud
3.767 3 10 12
free expert
 
Messaggi: 1593
Iscritto il: 1 feb 2012, 14:26
Località: Udine

1
voti

[8] Re: Tool per inserire equazioni nei commenti del software

Messaggioda Foto Utentedimaios » 26 giu 2013, 14:25

Dipende dall' editor che utilizzi.
In certi e' permesso fare cut & past di aree qualsiasi quindi copi ed incolli direttamente nell'area del sorgente ove vuoi inserire la formula in "ASCII art".
Ingegneria : alternativa intelligente alla droga.
Avatar utente
Foto Utentedimaios
28,7k 7 10 12
G.Master EY
G.Master EY
 
Messaggi: 3209
Iscritto il: 24 ago 2010, 14:12
Località: Behind the scenes

0
voti

[9] Re: Tool per inserire equazioni nei commenti del software

Messaggioda Foto UtenteIanero » 26 giu 2013, 14:28

Molto bello e utile, grazie :D
Servo, dai a costui una moneta, perché ha bisogno di trarre guadagno da ciò che impara.
Euclide.
Avatar utente
Foto UtenteIanero
7.354 5 8 13
Master EY
Master EY
 
Messaggi: 3796
Iscritto il: 21 mar 2012, 15:47

0
voti

[10] Re: Tool per inserire equazioni nei commenti del software

Messaggioda Foto Utentexyz » 26 giu 2013, 14:29

spud ha scritto:...poi le allinei a mano?

Per queste cose c'è il magico comando di riformattazione "par":

http://www.nicemice.net/par/

credo che non sia semplice capire le sue opzioni ma è molto potente e fa risparmiare tantissimo tempo.
Avatar utente
Foto Utentexyz
5.945 2 4 5
G.Master EY
G.Master EY
 
Messaggi: 1583
Iscritto il: 5 dic 2009, 18:37
Località: Italy Turin


Torna a Programmi applicativi: simulatori, CAD ed altro

Chi c’è in linea

Visitano il forum: Nessuno e 0 ospiti