Content-type: text/html
Man page of idl2matlab
idl2matlab
Section: USER COMMANDS (1)
Updated: 1.5 (21 January 2009)
Index
Return to Main Contents
NAME
idl2matlab - This tool translates automatically an IDL code into Matlab/Scilab code.
SYNOPSIS
idl2matlab
[-options] inputFile [outputDirectory]
DESCRIPTION
The
idl2matlab
command is an automatic translation tool from the IDL (and partly PV-Wave) to Matlab and Scilab source code.
idl(1) [http://www.ittvis.com] and matlab(1) [http://www.mathworks.com] are two major numerical languages for scientists. Additionally, scilab(1) [http://www.scilab.org] is a free Matlab-like software, which integrates a high compatibility (syntax, functions, graphics, user interfaces).
Many IDL programs have been developed in large facilities studying astrophysics, geology,medicine, particle and nuclear physics.
On the other hand, Matlab is widely used in smaller laboratories (universities, national scientific agencies, ...). In order to extend the portability of such IDL programs, we have developped an automatic translator from IDL to Matlab and Scilab.
This translator works as follow:
* analyze and formalize the IDL grammar-
* use lex/yacc to parse the original IDL source code to translate-
* generate a translated equivalent program, using Matlab grammar (and all variable types)-
* use a hash table for library functions.-
This library is quite big, and covers the most useful IDL/Matlab functions, particularly mathematical functions, basic plotting functions, widgets/uicontrols.
IDL2Matlab works on all systems (Unix/Linux/Windows). It is built upon lex/yacc and programmed in C.
The usage of the translator is done through the command line.
Installation of the package is done with the usual procedure: ./configure; make; make install on Linux/Unix systems. An installation script is provided for Windows systems.
OPTIONS
- -s
-
for script files translation
- -S string
-
for string translation
- -q
-
to hide messages
- -w
-
to stop warnings writing
- -t
-
to print the abstract tree
- -V
-
to get idl2matlab version
- -Tx
-
to get x spaces for a tabulation x<10
- -f
-
to translate only one function
- -C
-
to translate for scilab(1) (default : matlab(1))
EXAMPLES
idl2matlab -qw essai.pro outDir/-
idl2matlab -t essai.pro outDir/ > out-
idl2matlab -S "print,'IDL2Matlab'"-
idl2matlab -T4 essai.pro outDir/ > out-
idl2matlab -f essai.pro functionName outDir/ > out-
ENVIRONMENT
The
IDL2MATLAB
environment variable may be set to define the IDL2Matlab library location. This is /usr/local/lib/idl2matlab on Linux/BSD systems, and C:idl2matlab on Windows systems. Executables are usually located in /usr/local/bin on Linux/BSD systems, and in C:idl2matlabndows systems.
BUGS
idl2matlab is an experimental tool. The IDL grammar handled by idl2matlab is not fully qualified, and you should expect small translation errors. Additionally, the Library is certainly unstable and incomplete. PV-Wave translation should work partially.
Graphic functions (plot, surf, widgets) are incomplete. Translated code is not guaranteed to work. IDL objects are not translated.
EXIT STATUS
idl2matlab returns 1 in case of error, 0 when all went fine
AUTHOR
project leaders: Emmanuel FARHI and Didier RICHARD.
team1: AZIZI MOURIER Karim, BENZEGHIOUA ABDESLAM, GARDON Lucien, SYLVESTRE Nadege.
team2: BOURTEMBOURG Reynald, CORTINA Stephane, SZCZUCZAK Nadege.
Designed by the Computing for Science group
Institut Laue Langevin, BP 156
F-38042 Grenoble cedex 9, FRANCE
SEE ALSO
Institut Laue Langevin at [http://www.ill.eu/]
IDL at [http://www.ittvis.com/]
Matlab at [http://www.mathworks.com/]
Scilab at [http://www.scilab.org]
matlab(1), idl(1), scilab(1), octave(1)
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- OPTIONS
-
- EXAMPLES
-
- ENVIRONMENT
-
- BUGS
-
- EXIT STATUS
-
- AUTHOR
-
- SEE ALSO
-
This document was created by
man2html,
using the manual pages.
Time: 10:29:26 GMT, January 21, 2009