1GDL(1) General Commands Manual GDL(1)
2
6 gdl - GNU Data Language incremental compiler
7
9 gdl [--help] [-h] [--version] [-v] [-V] [[-]-quiet] [-q] [ -arg value ]
10 [ -args ... ] [ -e statement ] [ -pref=/path/to/preferenceFile ] [
11 batch_file ... ]
12
14 gdl is an incremental compiler for the GNU Data Language (GDL). GDL is
15 being developed with the aim of providing an open-source drop-in
16 replacement for ITTVIS Interactive Data Language (IDL). It is also par‐
17 tially compatible with Visual Numerics (VN) PV-WAVE. IDL and PV-WAVE
18 are registered trademarks of ITTVIS and VN, respectively. GDL and its
19 library routines are designed as a tool for numerical data analysis and
20 visualisation. GDL is dynamically typed, vectorized and has
21 object-oriented programming capabilities. The library routines handle
22 numerical calculations, data visualisation, signal/image processing,
23 file input/output (incl. graphical and scientific data formats such as
24 TIFF, PNG, netCDF, HDF etc) and interaction with host OS.
25 Information on GDL/IDL/PV-WAVE syntax and library routines can be found
27 in e.g.:
28 - GDL documentation draft at: http://gnudatalanguage.sf.net/gdl.pdf
30 - IDL manual on-line @ NASA.gov: http://idlas‐
32 tro.gsfc.nasa.gov/idl_html_help/home.html
33 - ITTVIS (ittvis.com) and Visual Numerics (vni.com) websites
35 - comp.lang.idl-pvwave newsgroup
37 - newsletter at: https://sympa.obspm.fr/wws/info/gdl-announces
39 A vast part of GDL library routines is implemented using open-source
41 libraries including GSL, plPlot, and optionally: readline, FFTW,
42 Eigen3, ImageMagick, netCDF, HDF4, HDF5, libproj4, UDUNITS-2, libps and
43 others.
44
46 --help (or -h)
47 Show summary of options
48 --version (or -v, -V)
50 Show version of program
51 --quiet (or -quiet, -q)
53 Suppress welcome messages
54 -arg value
56 Tells COMMAND_LINE_ARGS() to report the following argument (may
57 be specified more than once)
58 -args ...
60 Tells COMMAND_LINE_ARGS() to report all following arguments
61 -e statement
63 Execute given statement and exit (last occurance taken into
64 account only, executed after startup file, may not be specified
65 together with batch files)
66 -pref=/path/to/PreferenceFile
68 (only partially working now) setting using external text file
69 few variables including default preferences (e.g. X11 Windows
70 Size)
71 --fakerelease version
73 setting !VERSION.RELASE to that value. !VERSION.RELASE is often
74 tested by procedures to decide whether some function or option
75 should be used. It is sometimes possible to use this option to
76 fool a procedure that request a specific value of !VER‐
77 SION.RELEASE
78 The -demo, -em, -novm, -queue, -rt, -ulicense and -vm options
80 are ignored for compatibility with IDL.
81 A list of batch files to be executed before entering the interactive
83 mode (but after executing a startup file, if specified) may be
84 given when not using the -e option.
85
87 $DATADIR/gnudatalanguage/lib/*.pro
88 Library routines implemented in GDL. $DATADIR is specified dur‐
89 ing compilation and usually translates to /usr/share,
90 /usr/local/share or alike. GDL includes this directory in its
91 search path unless GDL_PATH or IDL_PATH env. variables are set
92 (see below).
93 $HOME/.gdl/history
95 A file used for storing the history of commands issued in the
96 interactive mode
97
99 The following environment variables have special meaning to gdl. The
100 GDL_* variant, if defined, takes precedence over any corresponding
101 IDL_* variant.
102 GDL_PATH, IDL_PATH
104 The GDL command (script) search path.
105 GDL_STARTUP, IDL_STARTUP
107 A file of commands to be executed on startup.
108 GDL_TMPDIR, IDL_TMPDIR
110 A directory in which temporary files may be created.
111 HOME, SHELL
113 Variables influencing shell invocations from within GDL (SPAWN
114 procedure and the $ interpreter command). Value of HOME deter‐
115 mines as well the location of the GDL history-file.
116 PATH Determines search path when spawning child processes using the
118 SPAWN procedure with the /NOSHELL keyword set.
119 PYTHONPATH
121 Influences behaviour of PYTHON procedure and PYTHON() function
122 (available if GDL is compiled with support for calling Python
123 code)
124 GDL_MPI
126 A message to be sent out using MPI_Send before initialization of
127 the interpreter (available if GDL is compiled with support for
128 MPI)
129 DISPLAY, XENVIRONMENT
131 Tell GDL how to connect to the X server
132 PLPLOT_DRV_DIR
134 Override the default location of PLplot dynamic drivers.
135 LC_* The locale-related settings accessible via LOCALE_GET() (GDL
137 always uses the C locale internally)
138 GDL_GR_WIN_HEIGHT
140 Sets the preference for the default height of a Windows(tm)
141 graphic window
142 GDL_GR_WIN_QSCREEN
144 if set to true (1) this will prevent the use of the
145 GDL_GR_WIN_HEIGHT and GDL_GR_WIN_WIDTH preferences and the
146 default dimensions of graphic windows will be 1/4 of the screen
147 dimensions
148 GDL_GR_WIN_WIDTH
150 Sets the preference for the default width of a Windows(tm)
151 graphic window
152 GDL_GR_X_HEIGHT
154 Sets the preference for the default height of an X11 graphic
155 window
156 GDL_GR_X_QSCREEN
158 if set to true (1) this will prevent the use of the
159 GDL_GR_X_HEIGHT and GDL_GR_X_WIDTH preferences and the default
160 dimensions of graphic windows will be 1/4 of the screen dimen‐
161 sions
162 GDL_GR_X_WIDTH
164 Sets the preference for the default width of an X11 graphic win‐
165 dow
166 GDL_WX_BACKEND
168 can be set to [0,1,2] which will select, respectively, the back‐
169 ends 0,1 or 2 of plplot's old wxWidgets driver (plplot versions
170 < 5.10). Backend 2 has antialiasing enabled.
171 GSHHS_DATA_DIR
173 If not automatically found, tells GDL where the gshhs files
174 (coasts rivers, etc) are located.
175
177 Please report bugs, comments, patches or feature requests at
178 http://sf.net/projects/gnudatalanguage/
179
181 The primary author of GDL is Marc Schellens <m_schellens@users.source‐
182 forge.net>. A list of contributors is available in the AUTHORS file
183 shipped with GDL, and on the project website (see above).
184 The original version of this manual page was written by Sergio Gelato
186 <Sergio.Gelato@astro.su.se>. It is currently a part of the GDL pack‐
187 age, and is maintained by the GDL Team.
188
190 netcdf(3), hdf(1), gsl(3)
191The GDL Team 2017-01-06 GDL(1)