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 occurrence 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 --fussy
80 signals that all used procedures will adhere with modern IDL,
81 where "()" are for functions and "[]" are for arrays. This
82 speeds up (sometimes terribly) compilation but choke on every
83 use of "()" with arrays. Conversion of procedures to modern IDL
84 can be done with D. Landsman's idlv4_to_v5 procedure. Use envi‐
85 romnment variable "GDL_IS_FUSSY" to set up permanently this fea‐
86 ture.
87 --sloppy
89 inverse of fussy above. Sets the traditional (default) compil‐
90 ing option where "()" can be used both with functions and
91 arrays. Needed to counteract temporarily the effect of the
92 enviromnment variable "GDL_IS_FUSSY".
93 --use-wx
95 Tells GDL to use WxWidgets graphics instead of X11 or Windows.
96 (nicer plots). Also enabled by setting the environment variable
97 GDL_USE_WX to a non-null value.
98 --no-use-wx
100 Tells GDL no to use WxWidgets graphics, even if env. var.
101 "GDL_USE_WX" is set.
102 --no-dSFMT
104 Tells GDL not to use double precision SIMD oriented Fast
105 Mersenne Twister(dSFMT) for random doubles. Also disabled by
106 setting the environment variable GDL_NO_DSFMT to a non-null
107 value.
108 The -demo, -em, -novm, -queue, -rt, -ulicense and -vm options
111 are ignored for compatibility with IDL.
112 A list of batch files to be executed before entering the interactive
114 mode (but after executing a startup file, if specified) may be
115 given when not using the -e option.
116
118 $DATADIR/gnudatalanguage/lib/*.pro
119 Library routines implemented in GDL. $DATADIR is specified dur‐
120 ing compilation and usually translates to /usr/share,
121 /usr/local/share or alike. GDL includes this directory in its
122 search path unless GDL_PATH or IDL_PATH env. variables are set
123 (see below).
124 $HOME/.gdl/history
126 A file used for storing the history of commands issued in the
127 interactive mode
128
130 The following environment variables have special meaning to gdl. The
131 GDL_* variant, if defined, takes precedence over any corresponding
132 IDL_* variant.
133 GDL_PATH, IDL_PATH
135 The GDL command (script) search path.
136 GDL_STARTUP, IDL_STARTUP
138 A file of commands to be executed on startup.
139 GDL_TMPDIR, IDL_TMPDIR
141 A directory in which temporary files may be created.
142 HOME, SHELL
144 Variables influencing shell invocations from within GDL (SPAWN
145 procedure and the $ interpreter command). Value of HOME deter‐
146 mines as well the location of the GDL history-file.
147 PATH Determines search path when spawning child processes using the
149 SPAWN procedure with the /NOSHELL keyword set.
150 PYTHONPATH
152 Influences behaviour of PYTHON procedure and PYTHON() function
153 (available if GDL is compiled with support for calling Python
154 code)
155 GDL_MPI
157 A message to be sent out using MPI_Send before initialization of
158 the interpreter (available if GDL is compiled with support for
159 MPI)
160 DISPLAY, XENVIRONMENT
162 Tell GDL how to connect to the X server
163 PLPLOT_DRV_DIR
165 Override the default location of PLplot dynamic drivers.
166 LC_* The locale-related settings accessible via LOCALE_GET() (GDL
168 always uses the C locale internally)
169 GDL_GR_WIN_HEIGHT
171 Sets the preference for the default height of a Windows(tm)
172 graphic window
173 GDL_GR_WIN_QSCREEN
175 if set to true (1) this will prevent the use of the
176 GDL_GR_WIN_HEIGHT and GDL_GR_WIN_WIDTH preferences and the
177 default dimensions of graphic windows will be 1/4 of the screen
178 dimensions
179 GDL_GR_WIN_WIDTH
181 Sets the preference for the default width of a Windows(tm)
182 graphic window
183 GDL_GR_X_HEIGHT
185 Sets the preference for the default height of an X11 graphic
186 window
187 GDL_GR_X_QSCREEN
189 if set to true (1) this will prevent the use of the
190 GDL_GR_X_HEIGHT and GDL_GR_X_WIDTH preferences and the default
191 dimensions of graphic windows will be 1/4 of the screen dimen‐
192 sions
193 GDL_GR_X_WIDTH
195 Sets the preference for the default width of an X11 graphic win‐
196 dow
197 GDL_WX_BACKEND
199 can be set to [0,1,2] which will select, respectively, the back‐
200 ends 0,1 or 2 of plplot's old wxWidgets driver (plplot versions
201 < 5.10). Backend 2 has antialiasing enabled.
202 GDL_MAPS_DIR
204 If not automatically found, tells GDL where the maps files
205 (coasts rivers, etc, used by MAPS_CONTINENTS) are located.
206 These are in Shapefile format and newer versions can possibly be
207 present on naturalearthdata.com
208
210 Please report bugs, comments, patches or feature requests at
211 http://sf.net/projects/gnudatalanguage/
212
214 The primary author of GDL is Marc Schellens <m_schellens@users.source‐
215 forge.net>. A list of contributors is available in the AUTHORS file
216 shipped with GDL, and on the project website (see above).
217 The original version of this manual page was written by Sergio Gelato
219 <Sergio.Gelato@astro.su.se>. It is currently a part of the GDL pack‐
220 age, and is maintained by the GDL Team.
221
223 netcdf(3), hdf(1), gsl(3)
224The GDL Team 2017-01-06 GDL(1)