Draft Draft: GDL - GNU Data Language

T
F
A
R
GDL GNU Data Language
a free/libre/open-source implementation of IDL/PV-WAVE*
developed by Marc Schellens and The GDL team

documentation maintained by Sylwester Arabas and Alain Coulais
D
*
January 3, 2012
IDL (Interactive Data Language) and PV-WAVE (Precision Visuals - Workstation Analysis and Visualization Environment)
are (were) registered trademarks of EXELIS VIS (ITT VIS; Research Systems, Inc.) and Rogue Wave Software (Visual Numerics; Precision Visuals), respectively
Contents
About GDL . . . . . . . . . .
License . . . . . . . . . . . .
Credits . . . . . . . . . . . .
Providing fedback . . . . . . .
Organization of this document
I.
.
.
.
.
.
.
.
.
.
.
T
F
A
R
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
7
7
7
7
8
Users guide
Chapter 1. Obtaining, installing, and invoking GDL

Requirements and supported environments . . . .
Availability of pre-compiled packages . . . . . . .
Compiling GDL from source . . . . . . . . . . . .
Installation layout . . . . . . . . . . . . . . . . . .
Command-line options . . . . . . . . . . . . . . .
Influential environmental variables . . . . . . . . .
11
11
11
11
11
11
11
Chapter 2. Language reference . . . . . . . . . . .

Syntax basics . . . . . . . . . . . . . . . . . . . .
Datatypes . . . . . . . . . . . . . . . . . . . . . .
Operators . . . . . . . . . . . . . . . . . . . . . .
Flow control structures . . . . . . . . . . . . . . .
Variable scoping rules . . . . . . . . . . . . . . . .
Functions and procedures . . . . . . . . . . . . . .
Argument passing . . . . . . . . . . . . . . . . . .
Arrays . . . . . . . . . . . . . . . . . . . . . . . .
Structures . . . . . . . . . . . . . . . . . . . . . .
System variables (global) . . . . . . . . . . . . . .
Heap variables (pointers) . . . . . . . . . . . . . .
The HELP procedure . . . . . . . . . . . . . . . .
Object-oriented programming . . . . . . . . . . .
Handling Overflows, Floating Point Special Values
Error handling . . . . . . . . . . . . . . . . . . . .
Compile options . . . . . . . . . . . . . . . . . . .
12
12
12
12
12
14
14
14
15
15
15
15
15
15
15
15
15
Chapter 3. Interpreter commands and built-in

debugging facilities . . . . . . . . . . . . . . . .
17
Chapter 4. Maths . . . . . . . . . . . . .
Basic Scalar, vector and array operations
Basic and special function library . . . .
Linear algebra . . . . . . . . . . . . . . .
Statistics . . . . . . . . . . . . . . . . .
Interpolation . . . . . . . . . . . . . . .
Polynomials . . . . . . . . . . . . . . . .
Geometric calculations . . . . . . . . . .
Bitwise operations . . . . . . . . . . . .
Function fitting . . . . . . . . . . . . . .
Fourier analysis . . . . . . . . . . . . . .
Multidimensional root-finding . . . . . .
Random numbers . . . . . . . . . . . . .
Ordinary differential equations . . . . . .
Wavelet analysis . . . . . . . . . . . . .
Mathematical and physical constants . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
18
18
18
19
19
19
19
19
19
19
20
20
20
20
20
20
Chapter 5. Input/output, supported data

Basics accessing files and io streams . .
ASCII . . . . . . . . . . . . . . . . . . .
CSV . . . . . . . . . . . . . . . . . . . .
Binary data (raw access) . . . . . . . . .
FITS . . . . . . . . . . . . . . . . . . . .
netCDF . . . . . . . . . . . . . . . . . .
HDF4 . . . . . . . . . . . . . . . . . . .
HDF5 . . . . . . . . . . . . . . . . . . .
raster images (TIFF, PNG, JPEG, . . . ) .
DICOM . . . . . . . . . . . . . . . . . .
GRIB . . . . . . . . . . . . . . . . . . .
IDL save files . . . . . . . . . . . . . . .
formats
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
21
21
21
21
21
21
21
21
21
22
22
22
22
Chapter 6. Plotting and mapping .

2D plots . . . . . . . . . . . . . . .
3D plots . . . . . . . . . . . . . . .
Plotting raster data . . . . . . . . .
Managing multiple windows . . . .
Map projections . . . . . . . . . . .
Output terminals . . . . . . . . . .
Working with colours . . . . . . . .
Fonts, symbols and text formatting
.
.
.
.
.
.
.
.
.
23
23
23
23
23
23
23
23
24
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
Misc . . . . . . . . . . . . . . . . . . . . . . . . .
24
Chapter 7. Interaction with host OS . . . . . . . .

Executing external commands (via shell or not) . .
Filesystem operations . . . . . . . . . . . . . . . .
Network operations . . . . . . . . . . . . . . . . .
Command-line options and environmental variables
25
25
25
25
25
Chapter 8. Manipulating strings . . . . . . . . . .
26
Chapter 9. Representing date & time . . . . . . .
27
Chapter 10. Image processing . . . . . . . . . . .
28
Chapter 11. Parallel processing . . . . .

Built-in features (OpenMP) . . . . . .
Semaphores and shared memory (library
ImageMagicks features . . . . . . . . .
MPI and GDL . . . . . . . . . . . . . .
.
.
.
.
.
29
29
29
29
29
Chapter 12. GUI programming (widgets) . . . . .
30
Chapter 13. Dynamic loading . . . . . . . . . . . .
31
Chapter 14. The Python bridge . . . . . . . . . .

calling Python code from GDL . . . . . . . . . . .
calling GDL code from Python . . . . . . . . . . .
32
32
32
Chapter 15. Alphabetical list of library routines

ABS() function . . . . . . . . . . . . . . . . . .
ACOS() function . . . . . . . . . . . . . . . . .
ALOG() function . . . . . . . . . . . . . . . . .
ALOG10() function . . . . . . . . . . . . . . . .
APPLEMAN procedure . . . . . . . . . . . . . .
ARG_PRESENT() function . . . . . . . . . . .
ARRAY_EQUAL() function . . . . . . . . . . .
ARRAY_INDICES() function . . . . . . . . . . .
ASIN() function . . . . . . . . . . . . . . . . . .
ASSOC() function . . . . . . . . . . . . . . . .
ATAN() function . . . . . . . . . . . . . . . . .
AXIS procedure . . . . . . . . . . . . . . . . . .
BESELI() function . . . . . . . . . . . . . . . .
BESELJ() function . . . . . . . . . . . . . . . .
BESELK() function . . . . . . . . . . . . . . . .
BESELY() function . . . . . . . . . . . . . . . .
BETA() function . . . . . . . . . . . . . . . . .
BILINEAR() function . . . . . . . . . . . . . . .
33
33
33
33
33
33
34
34
34
34
34
34
35
35
35
35
35
35
35
. . . . .
. . . . .
routines)
. . . . .
. . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
Contents
T
F
A
R
BINDGEN() function . . . . . . . . .
BROYDEN() function . . . . . . . .
BYTARR() function . . . . . . . . .
BYTE() function . . . . . . . . . . .
BYTEORDER procedure . . . . . . .
BYTSCL() function . . . . . . . . . .
CALDAT procedure . . . . . . . . . .
CALENDAR procedure . . . . . . . .
CALL_EXTERNAL() function . . . .
CALL_FUNCTION() function . . . .
CALL_METHOD procedure . . . . .
CALL_METHOD() function . . . . .
CALL_PROCEDURE procedure . . .
CATCH procedure . . . . . . . . . .
CD procedure . . . . . . . . . . . . .
CDF_EPOCH procedure . . . . . . .
CEIL() function . . . . . . . . . . . .
CHECK_MATH() function . . . . . .
CINDGEN() function . . . . . . . . .
CLOSE procedure . . . . . . . . . . .
COMMAND_LINE_ARGS() function
COMPLEX() function . . . . . . . .
COMPLEXARR() function . . . . . .
CONGRID() function . . . . . . . . .
CONJ() function . . . . . . . . . . .
CONTOUR procedure . . . . . . . .
CONVERT_COORD() function . . .
CONVOL() function . . . . . . . . .
CORRELATE() function . . . . . . .
COS() function . . . . . . . . . . . .
COSH() function . . . . . . . . . . .
CPU procedure . . . . . . . . . . . .
CREATE_STRUCT() function . . . .
CROSSP() function . . . . . . . . . .
CURSOR procedure . . . . . . . . . .
DBLARR() function . . . . . . . . .
DCINDGEN() function . . . . . . . .
DCOMPLEX() function . . . . . . .
DCOMPLEXARR() function . . . . .
DEFSYSV procedure . . . . . . . . .
DERIV() function . . . . . . . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
35
35
35
35
36
36
36
36
36
38
38
38
38
38
38
38
39
39
39
39
39
39
39
39
39
39
39
40
40
40
40
41
41
41
41
41
41
41
41
41
41
DETERM() function . . . . . . . . . .
DEVICE procedure . . . . . . . . . . .
DIALOG_MESSAGE() function . . . .
DIALOG_PICKFILE() function . . . .
DINDGEN() function . . . . . . . . . .
DIST() function . . . . . . . . . . . . .
DOUBLE() function . . . . . . . . . .
EOF() function . . . . . . . . . . . . .
ERASE procedure . . . . . . . . . . . .
ERF() function . . . . . . . . . . . . .
ERFC() function . . . . . . . . . . . .
ERRORF() function . . . . . . . . . .
ESCAPE_SPECIAL_CHAR() function
EXECUTE() function . . . . . . . . . .
EXIT procedure . . . . . . . . . . . . .
EXP() function . . . . . . . . . . . . .
EXPAND_PATH() function . . . . . .
EXPINT() function . . . . . . . . . . .
FACTORIAL() function . . . . . . . . .
FFT() function . . . . . . . . . . . . .
FILEPATH() function . . . . . . . . . .
FILE_BASENAME() function . . . . .
FILE_COPY procedure . . . . . . . . .
FILE_DELETE procedure . . . . . . .
FILE_DIRNAME() function . . . . . .
FILE_EXPAND_PATH() function . . .
FILE_INFO() function . . . . . . . . .
FILE_LINES() function . . . . . . . . .
FILE_MKDIR procedure . . . . . . . .
FILE_SAME() function . . . . . . . . .
FILE_SEARCH() function . . . . . . .
FILE_TEST() function . . . . . . . . .
FILE_WHICH() function . . . . . . . .
FINDEX() function . . . . . . . . . . .
FINDFILE() function . . . . . . . . . .
FINDGEN() function . . . . . . . . . .
FINITE() function . . . . . . . . . . .
FIX() function . . . . . . . . . . . . .
FLOAT() function . . . . . . . . . . .
FLOOR() function . . . . . . . . . . .
FLTARR() function . . . . . . . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
41
41
42
42
42
42
42
42
42
42
43
43
43
43
43
43
43
43
43
44
44
44
44
44
45
45
45
45
45
45
45
45
45
45
45
46
46
46
46
46
46
FLUSH procedure . . . . . . . . . . . . .
FREE_LUN procedure . . . . . . . . . .
FSTAT() function . . . . . . . . . . . . .
GAMMA() function . . . . . . . . . . . .
GAUSSINT() function . . . . . . . . . .
GAUSS_CVF() function . . . . . . . . .
GAUSS_PDF() function . . . . . . . . .
GDL_ERFINV() function . . . . . . . . .
GETENV() function . . . . . . . . . . .
GET_DRIVE_LIST() function . . . . . .
GET_KBRD() function . . . . . . . . . .
GET_LOGIN_INFO() function . . . . .
GET_LUN procedure . . . . . . . . . . .
GET_SCREEN_SIZE() function . . . . .
GRIBAPI_CLONE() function . . . . . .
GRIBAPI_CLOSE_FILE procedure . . .
GRIBAPI_COUNT_IN_FILE() function .
GRIBAPI_GET procedure . . . . . . . .
GRIBAPI_GET_DATA procedure . . . .
GRIBAPI_GET_SIZE() function . . . . .
GRIBAPI_NEW_FROM_FILE() function
GRIBAPI_OPEN_FILE() function . . . .
GRIBAPI_RELEASE procedure . . . . .
GSL_EXP() function . . . . . . . . . . .
H5A_CLOSE procedure . . . . . . . . .
H5A_GET_NAME() function . . . . . .
H5A_GET_NUM_ATTRS() function . .
H5A_GET_SPACE() function . . . . . .
H5A_GET_TYPE() function . . . . . .
H5A_OPEN_IDX() function . . . . . . .
H5A_OPEN_NAME() function . . . . .
H5A_READ() function . . . . . . . . . .
H5D_CLOSE procedure . . . . . . . . .
H5D_GET_SPACE() function . . . . . .
H5D_GET_TYPE() function . . . . . .
H5D_OPEN() function . . . . . . . . . .
H5D_READ() function . . . . . . . . . .
H5F_CLOSE procedure . . . . . . . . .
H5F_IS_HDF5() function . . . . . . . .
H5F_OPEN() function . . . . . . . . . .
H5G_CLOSE procedure . . . . . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
46
46
46
46
46
46
46
47
47
47
47
47
47
47
47
47
47
47
47
48
48
48
48
48
48
48
48
48
48
48
48
48
48
49
49
49
49
49
49
49
49
T
F
A
R
H5G_OPEN() function . . . . . . . . . . . . . . .
H5S_CLOSE procedure . . . . . . . . . . . . . .
H5S_GET_SIMPLE_EXTENT_DIMS() function .
H5T_CLOSE procedure . . . . . . . . . . . . . .
H5T_GET_SIZE() function . . . . . . . . . . . .
H5_GET_LIBVERSION() function . . . . . . . .
HDF_CLOSE procedure . . . . . . . . . . . . . .
HDF_OPEN() function . . . . . . . . . . . . . . .
HDF_SD_ADDDATA procedure . . . . . . . . . .
HDF_SD_ATTRFIND() function . . . . . . . . .
HDF_SD_ATTRINFO procedure . . . . . . . . .
HDF_SD_CREATE() function . . . . . . . . . . .
HDF_SD_DIMGET procedure . . . . . . . . . . .
HDF_SD_DIMGETID() function . . . . . . . . .
HDF_SD_END procedure . . . . . . . . . . . . .
HDF_SD_ENDACCESS procedure . . . . . . . .
HDF_SD_FILEINFO procedure . . . . . . . . . .
HDF_SD_GETDATA procedure . . . . . . . . . .
HDF_SD_GETINFO procedure . . . . . . . . . .
HDF_SD_NAMETOINDEX() function . . . . . .
HDF_SD_SELECT() function . . . . . . . . . . .
HDF_SD_START() function . . . . . . . . . . .
HDF_VD_ATTACH() function . . . . . . . . . .
HDF_VD_DETACH procedure . . . . . . . . . .
HDF_VD_FIND() function . . . . . . . . . . . .
HDF_VD_GET procedure . . . . . . . . . . . . .
HDF_VD_READ() function . . . . . . . . . . . .
HDF_VG_ATTACH() function . . . . . . . . . .
HDF_VG_DETACH procedure . . . . . . . . . . .
HDF_VG_GETID() function . . . . . . . . . . . .
HDF_VG_GETINFO procedure . . . . . . . . . .
HDF_VG_GETTRS procedure . . . . . . . . . . .
HEAP_GC procedure . . . . . . . . . . . . . . . .
HELP procedure . . . . . . . . . . . . . . . . . .
HELPFORM() function . . . . . . . . . . . . . . .
HISTOGRAM() function . . . . . . . . . . . . . .
HIST_2D() function . . . . . . . . . . . . . . . .
HIST_ND() function . . . . . . . . . . . . . . . .
IDENTITY() function . . . . . . . . . . . . . . .
IDL_BASE64() function . . . . . . . . . . . . . .
IDL_VALIDNAME() function . . . . . . . . . . .
49
49
49
49
49
50
50
50
50
50
50
50
50
50
50
50
50
51
51
51
51
51
51
51
51
51
51
51
51
51
51
52
52
52
52
52
52
52
53
53
53
IGAMMA() function . . . . . . . . .
IMAGE_STATISTICS procedure . . .
IMAGINARY() function . . . . . . .
IMSL_BINOMIALCOEF() function .
IMSL_CONSTANT() function . . . .
IMSL_ERF() function . . . . . . . .
IMSL_ZEROPOLY() function . . . .
IMSL_ZEROSYS() function . . . . .
INDGEN() function . . . . . . . . . .
INTARR() function . . . . . . . . . .
INTERPOL() function . . . . . . . .
INTERPOLATE() function . . . . . .
INVERT() function . . . . . . . . . .
ISHFT() function . . . . . . . . . . .
JOURNAL procedure . . . . . . . . .
KEYWORD_SET() function . . . . .
KURTOSIS() function . . . . . . . .
L64INDGEN() function . . . . . . . .
LAGUERRE() function . . . . . . . .
LAST_ITEM() function . . . . . . .
LA_TRIRED procedure . . . . . . . .
LEGENDRE() function . . . . . . . .
LINDGEN() function . . . . . . . . .
LINKIMAGE procedure . . . . . . . .
LL_ARC_DISTANCE() function . . .
LMGR() function . . . . . . . . . . .
LNGAMMA() function . . . . . . . .
LOADCT procedure . . . . . . . . .
LOADCT_INTERNALGDL procedure
LOCALE_GET() function . . . . . .
LOGICAL_AND() function . . . . . .
LOGICAL_OR() function . . . . . . .
LOGICAL_TRUE() function . . . . .
LON64ARR() function . . . . . . . .
LONARR() function . . . . . . . . .
LONG() function . . . . . . . . . . .
LONG64() function . . . . . . . . . .
LUDC procedure . . . . . . . . . . .
LUSOL() function . . . . . . . . . .
MACHAR() function . . . . . . . . .
MAGICK_ADDNOISE procedure . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
53
53
53
53
54
55
55
55
56
56
56
56
56
56
56
56
56
56
56
56
56
57
57
57
57
57
57
57
58
58
59
59
59
59
59
59
59
59
59
59
59
MAGICK_CLOSE procedure . . . . . . . . .
MAGICK_COLORMAPSIZE() function . . .
MAGICK_COLUMNS() function . . . . . . .
MAGICK_CREATE() function . . . . . . . .
MAGICK_DISPLAY procedure . . . . . . . .
MAGICK_EXISTS() function . . . . . . . .
MAGICK_FLIP procedure . . . . . . . . . .
MAGICK_INDEXEDCOLOR() function . . .
MAGICK_INTERLACE procedure . . . . . .
MAGICK_MAGICK() function . . . . . . . .
MAGICK_MATTE procedure . . . . . . . .
MAGICK_OPEN() function . . . . . . . . .
MAGICK_PING() function . . . . . . . . . .
MAGICK_QUALITY procedure . . . . . . .
MAGICK_QUANTIZE procedure . . . . . .
MAGICK_READ() function . . . . . . . . .
MAGICK_READCOLORMAPRGB procedure
MAGICK_READINDEXES() function . . . .
MAGICK_ROWS() function . . . . . . . . .
MAGICK_WRITE procedure . . . . . . . . .
MAGICK_WRITECOLORTABLE procedure .
MAGICK_WRITEFILE procedure . . . . . .
MAGICK_WRITEINDEXES procedure . . .
MAKE_ARRAY() function . . . . . . . . . .
MAP_CLIP_SET procedure . . . . . . . . .
MAP_CONTINENTS procedure . . . . . . .
MATRIX_MULTIPLY() function . . . . . . .
MAX() function . . . . . . . . . . . . . . . .
MEAN() function . . . . . . . . . . . . . . .
MEANABSDEV() function . . . . . . . . . .
MEDIAN() function . . . . . . . . . . . . .
MEMORY() function . . . . . . . . . . . . .
MESSAGE procedure . . . . . . . . . . . . .
MIN() function . . . . . . . . . . . . . . . .
MOMENT() function . . . . . . . . . . . . .
NCDF_ATTCOPY() function . . . . . . . .
NCDF_ATTDEL procedure . . . . . . . . .
NCDF_ATTGET procedure . . . . . . . . .
NCDF_ATTINQ() function . . . . . . . . .
NCDF_ATTNAME() function . . . . . . . .
NCDF_ATTPUT procedure . . . . . . . . .
Contents
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
59
60
60
60
60
60
60
60
60
60
60
60
60
60
61
61
61
61
61
61
61
61
61
61
61
61
61
62
62
62
62
62
62
62
62
62
62
62
62
62
62
Contents
NCDF_ATTRENAME procedure .
NCDF_CLOSE procedure . . . .
NCDF_CONTROL procedure . .
NCDF_CREATE() function . . .
NCDF_DIMDEF() function . . .
NCDF_DIMID() function . . . .
NCDF_DIMINQ procedure . . . .
NCDF_DIMRENAME procedure .
NCDF_EXISTS() function . . . .
NCDF_INQUIRE() function . . .
NCDF_OPEN() function . . . . .
NCDF_VARDEF() function . . .
NCDF_VARGET procedure . . .
NCDF_VARGET1 procedure . . .
NCDF_VARID() function . . . .
NCDF_VARINQ() function . . .
NCDF_VARPUT procedure . . .
NCDF_VARRENAME procedure .
NEWTON() function . . . . . . .
NORM() function . . . . . . . . .
N_ELEMENTS() function . . . .
N_PARAMS() function . . . . . .
N_TAGS() function . . . . . . .
OBJARR() function . . . . . . .
OBJ_CLASS() function . . . . .
OBJ_DESTROY procedure . . .
OBJ_ISA() function . . . . . . .
OBJ_NEW() function . . . . . .
OBJ_VALID() function . . . . . .
ON_ERROR procedure . . . . . .
OPENR procedure . . . . . . . .
OPENU procedure . . . . . . . .
OPENW procedure . . . . . . . .
OPLOT procedure . . . . . . . .
PARSE_URL() function . . . . .
PATH_SEP() function . . . . . .
PLOT procedure . . . . . . . . .
PLOTERR procedure . . . . . . .
PLOTS procedure . . . . . . . .
PM procedure . . . . . . . . . . .
POINT_LUN procedure . . . . .
T
F
A
R
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
63
63
63
63
63
63
63
63
63
63
63
63
63
64
64
64
64
64
64
64
64
64
64
64
64
65
65
65
66
66
66
66
66
66
66
67
67
67
67
67
67
POLY() function . . . . . .
POLYFILL procedure . . . .
POLY_2D() function . . . .
POLY_AREA() function . .
POPD procedure . . . . . .
PREWITT() function . . . .
PRIMES() function . . . . .
PRINT procedure . . . . . .
PRINTD procedure . . . . .
PRINTF procedure . . . . .
PRODUCT() function . . .
PTRARR() function . . . .
PTR_FREE procedure . . .
PTR_NEW() function . . .
PTR_VALID() function . .
PUSHD procedure . . . . .
PYTHON procedure . . . .
PYTHON() function . . . .
PY_PLOT procedure . . . .
PY_PRINT procedure . . .
QUERY_BMP() function .
QUERY_DICOM() function
QUERY_GIF() function . .
QUERY_IMAGE() function
QUERY_JPEG() function .
QUERY_PICT() function .
QUERY_PNG() function . .
QUERY_PPM() function .
QUERY_TIFF() function . .
RADON() function . . . . .
RANDOMN() function . . .
RANDOMU() function . . .
READ procedure . . . . . .
READF procedure . . . . .
READS procedure . . . . .
READU procedure . . . . .
READ_ASCII() function . .
READ_BINARY() function
READ_BMP() function . .
READ_DICOM() function .
READ_GIF procedure . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
67
67
68
68
68
68
68
68
68
68
68
68
68
69
69
69
69
69
69
69
69
69
70
70
70
70
70
70
70
70
70
70
70
70
70
70
71
71
71
71
71
READ_JPEG procedure . . . . . .
READ_PICT procedure . . . . . .
READ_PNG() function . . . . . . .
READ_TIFF() function . . . . . .
READ_XWD() function . . . . . .
REAL_PART() function . . . . . .
REBIN() function . . . . . . . . . .
RECALL_COMMANDS() function
REFORM() function . . . . . . . .
REPLICATE() function . . . . . . .
REPLICATE_INPLACE procedure .
RESOLVE_ROUTINE procedure . .
RESTORE procedure . . . . . . . .
RETALL procedure . . . . . . . . .
REVERSE() function . . . . . . . .
RK4() function . . . . . . . . . . .
RK4JMG() function . . . . . . . .
ROBERTS() function . . . . . . . .
ROTATE() function . . . . . . . .
ROUND() function . . . . . . . . .
ROUTINE_INFO() function . . . .
ROUTINE_NAMES() function . . .
RSTRPOS() function . . . . . . . .
SAVE procedure . . . . . . . . . .
SCOPE_VARFETCH() function . .
SEM_CREATE() function . . . . .
SEM_DELETE procedure . . . . .
SEM_LOCK() function . . . . . . .
SEM_RELEASE procedure . . . . .
SETENV procedure . . . . . . . . .
SET_PLOT procedure . . . . . . .
SHIFT() function . . . . . . . . . .
SHOWFONT procedure . . . . . .
SIN() function . . . . . . . . . . .
SINDGEN() function . . . . . . . .
SINH() function . . . . . . . . . . .
SIZE() function . . . . . . . . . . .
SKEWNESS() function . . . . . . .
SKIP_LUN procedure . . . . . . .
SMOOTH() function . . . . . . . .
SOBEL() function . . . . . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
71
71
71
71
71
71
71
71
72
72
72
72
72
72
72
72
72
72
72
72
72
73
74
75
75
75
75
75
75
75
75
75
75
83
83
83
84
84
84
84
84
T
F
A
R
SOCKET procedure . . . . . . . . . . .
SORT() function . . . . . . . . . . . .
SPAWN procedure . . . . . . . . . . .
SPHER_HARM() function . . . . . . .
SPL_INIT() function . . . . . . . . . .
SPL_INIT_OLD() function . . . . . .
SPL_INTERP() function . . . . . . . .
SPL_INTERP_OLD() function . . . .
SQRT() function . . . . . . . . . . . .
STDDEV() function . . . . . . . . . .
STOP procedure . . . . . . . . . . . .
STRARR() function . . . . . . . . . .
STRCMP() function . . . . . . . . . .
STRCOMPRESS() function . . . . . .
STREGEX() function . . . . . . . . . .
STRING() function . . . . . . . . . . .
STRJOIN() function . . . . . . . . . .
STRLEN() function . . . . . . . . . . .
STRLOWCASE() function . . . . . . .
STRMATCH() function . . . . . . . . .
STRMID() function . . . . . . . . . . .
STRPOS() function . . . . . . . . . . .
STRPUT procedure . . . . . . . . . . .
STRSPLIT() function . . . . . . . . . .
STRTOK() function . . . . . . . . . .
STRTRIM() function . . . . . . . . . .
STRUCT_ASSIGN procedure . . . . .
STRUPCASE() function . . . . . . . .
STR_SEP() function . . . . . . . . . .
SURFACE procedure . . . . . . . . . .
SVDC procedure . . . . . . . . . . . .
SWAP_ENDIAN() function . . . . . .
SWAP_ENDIAN_INPLACE procedure
SYSTIME() function . . . . . . . . . .
TAG_NAMES() function . . . . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
84
84
84
84
84
84
84
84
85
85
85
85
85
85
85
85
85
86
86
86
86
86
86
86
86
87
87
87
87
87
88
88
88
88
88
TAN() function . . . . . . . . .
TANH() function . . . . . . . .
TEMPLATE procedure . . . . .
TEMPLATE_BLANK procedure
TEMPORARY() function . . .
TEST procedure . . . . . . . .
TOTAL() function . . . . . . .
TRACE() function . . . . . . .
TRANSPOSE() function . . . .
TRIGRID() function . . . . . .
TV procedure . . . . . . . . . .
TVLCT procedure . . . . . . .
TVRD() function . . . . . . . .
TVSCL procedure . . . . . . . .
T_PDF() function . . . . . . .
UINDGEN() function . . . . . .
UINT() function . . . . . . . .
UINTARR() function . . . . . .
UL64INDGEN() function . . . .
ULINDGEN() function . . . . .
ULON64ARR() function . . . .
ULONARR() function . . . . .
ULONG() function . . . . . . .
ULONG64() function . . . . . .
UNIQ() function . . . . . . . .
USERSYM procedure . . . . . .
VALUE_LOCATE() function . .
VARIANCE() function . . . . .
VOIGT() function . . . . . . . .
WAIT procedure . . . . . . . .
WDELETE procedure . . . . . .
WHERE() function . . . . . . .
WIDGET_BASE() function . .
WIDGET_BUTTON() function
WIDGET_CONTROL procedure
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
88
88
88
89
89
89
89
89
89
89
89
89
89
89
89
89
90
90
90
90
90
90
90
90
90
90
90
90
90
90
91
91
91
91
91
Contents
WIDGET_DROPLIST() function
WIDGET_EVENT() function . .
WIDGET_INFO() function . . . .
WIDGET_LABEL() function . . .
WIDGET_TEXT() function . . .
WINDOW procedure . . . . . . .
WRITEU procedure . . . . . . . .
WRITE_BMP procedure . . . . .
WRITE_GIF procedure . . . . . .
WRITE_JPEG procedure . . . . .
WRITE_PICT procedure . . . . .
WRITE_PNG procedure . . . . .
WSET procedure . . . . . . . . .
WSHOW procedure . . . . . . . .
WTN() function . . . . . . . . .
XYOUTS procedure . . . . . . .
II.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
91
91
91
92
92
92
92
92
92
92
92
92
92
92
93
93
Developers guide
Chapter 16. General remarks and coding guidelines 95

Chapter 17. The library-routine API . . . . . . . .
96
Chapter 18. Extending the documentation . . . .
97
Chapter 19. Extending the testsuite

(testsuite/README) . . . . . . . . . . . . . . .
98
Chapter 20. A short overview of how GDL works

internally . . . . . . . . . . . . . . . . . . . . . .
99
Chapter 21. How to make use of OpenMP in GDL 100

Chapter 22. Notes for packagers . . . . . . . . . . 101
Optional features of PLplot and ImageMagick . . . 101
The HDF4-netCDF conflict . . . . . . . . . . . . 101
III.
Indices
Subject Index . . . . . . . . . . . . . . . . . . . . . 104

Bibliography . . . . . . . . . . . . . . . . . . . . . 105
Credits
About GDL
T
F
A
R
GNU Data Language (GDL) is a free/libre/open source incremental compiler compatible with IDL and to some extent with PV-WAVE. Together with its library routines
it serves as a tool for data analysis and visualization in such disciplines as astronomy,
geosciences and medical imaging.
GDL as a language is dynamically-typed, vectorized and has object-oriented programming capabilities. GDL library routines handle numerical calculations, data visualisation, signal/image processing, interaction with host OS and data input/output.
GDL supports several data formats such as netCDF, HDF4, HDF5, GRIB, PNG,
TIFF, DICOM, etc. Graphical output is handled by X11, PostScript, SVG or z-buffer
terminals, the last one allowing output graphics (plots) to be saved in a variety of
raster graphics formats. GDL features integrated debugging facilities. GDL has also
a Python bridge (Python code can be called from GDL; GDL can be compiled as a
Python module).
Packaged versions of GDL are available for several Linux and BSD flavours as well
as Mac OS X. The source code compiles as well on other UNIX systems, including
Solaris. GDL source code is available for download from Sourceforge.net at: http:
//sourceforge.net/projects/gnudatalanguage/.
Other open-source numerical data analysis tools similar to GDL include:
GNU Octave: http://www.gnu.org/software/octave/

NCL NCAR Command Language: http://www.ncl.ucar.edu/
PDL Perl Data Language: http://pdl.perl.org/
R: http://www.r-project.org/
Scilab: http://www.scilab.org/
SciPy: http://www.scipy.org/
Yorick: http://yorick.sourceforge.net/
License
GDL is a free, libre and open-source software released under the GNU General Public
License version 2 Fundation [1]. It basicaly means that any GDL user has the freedom
to run, copy, distribute, study, change and improve GDL.
Credits
GDL have been developed by a team of volunteers led by Marc Schellens the
projects founder and maintainer. As of 2011 the core team consists additionally of
(in alphabetical order) Sylwester Arabas, Alain Coulais and Jeol Gales.
Among many good folks who provided patches and valuable feedback (in alphabetical
order) there are: Mdric Bocquien, Justin Bronn, Pierre Chanial, Pedro Corona Romero,
Gilles Duvert, Christoph Fuchs, Nicolas Galmiche, Greg Huey, Gaurav Khanna, Christopher Lee, Maxime Lenoir, Peter Messmer, Gregory Marchal, Thibaut Mermet, Lea Noreskal,
Orion Poplawski, Rene Preusker, Mateusz Turcza, Joanna Woo, H Xu, . . .
GDL contains snippets of code borrowed from other free and open-source projects
credited to: Deepak Bandyopadhyay, Sergio Gelato, Lutz Kettner, Craig B. Markwardt, Paul Ricchiazzi, Danny Smith, J.D. Smith, Richard Schwartz, Paul Wessel,
Bob Withers, . . .
Pre-compiled or pre-configured packages of GDL are available for numerous systems thanks to: Juan A. Ael, Axel Beckert, Markus Dittrich, Takeshi Enomoto,
Sbastien Fabbro, Orlando Garcia Feal, Gaurav Khanna, Justin Lecher, Sebastien Maret,
Lea Noreskal, Orion Poplawski, Marius Schamschula, Grkan Sengn, Thierry Thomas,
...
GDL is written in C++ using the Terence Parrs ANTLR language-recognition framework. Most of the library routines are implemented as interfaces to open-source
packages such as GNU Scientific Library, PLPlot, FFTW, ImageMagick, and many
many more.
Last but not least, we would like to acknowledge the designers of IDL and PV-WAVE.
Please do report any missing name on the lists above in the same way as any other
bug in GDL (see section below).
Providing fedback
Your comments are welcome! Let us know what you use GDL for. Or if you dont, why
not. Which functionality are you missing/would appreciate most for comming versions.
Please send your bug reports, complaints, suggestions, comments and patches using
the trackers or forums available at GDLs project website at SourceForge: http:
//sourceforge.net/projects/gnudatalanguage/.
T
F
A
R
Contents
Organization of this document
This document is divided into two parts:
Users guide: intended for users developing programs written in GDL,

Developers guide: intended for those interested in developing or packaging GDL.
Most of GDL functionalities are exemplified with short GDL scripts. For each such
script there are two listings provided: a source code listing with line numbers to the
left and a log of output below, e.g.:
1
print , Hello world !
Hello world !
All scripts are run by invoking gdl script.pro what is equivalent to loading the
script with the @ operator or typing every line of script at the GDLs interactive mode
command prompt.
Often the scripts contain lines beginning with a dollar sign $ which is the GDL
syntax for executing shell commands, e.g.
1
$ echo " H e l l o w o r l d ! "
Hello world !
If a script involves creation of a plot, the resultant postscript file is displayed below
the output listing, e.g.:
1
2
p l o t , wtn ( [ f l t a r r ( 9 ) , 1 , f l t a r r ( 1 0 1 4 ) ] , 4 , / i n v e r s e )
x y o u t s , 4 8 0 , . 0 2 , H e l l o w o r l d ! , c h a r s i z e =2
While GDL itself reached a beta status of development, the hereby documentation is
far from reaching an alpha status help is very welcome!
T
F
A
R
Part I
Users guide
T
F
A
R
Chapter 1
T
F
A
R
Obtaining, installing, and invoking GDL

Requirements and supported environments
Availability of pre-compiled packages
Compiling GDL from source
Compiler requirements
GNU g++ clang Intel C++
Autotools
Cmake
Installation layout
Command-line options
Influential environmental variables
Chapter 2
T
F
A
R
Language reference
Syntax basics
IDL_VALIDNAME() TEMPORARY()
Datatypes
a = 10
i f a g t 5 t h e n p r i n t , a > 5 e l s e p r i n t , a <= 5
a > 5
ASSOC()
BYTE() COMPLEX(), DCOMPLEX() ( CONJ(), ATAN(), IMAGINARY(), REAL_PART())

contrary to... cannot be used in interactive mode nor in batch scripts, but only within
DOUBLE() FIX() FLOAT() LONG() LONG64() UINT() ULONG() ULONG64()
...
SIZE()
1
Operators
2
3
LOGICAL_AND() LOGICAL_OR() LOGICAL_TRUE()
SQRT()
Flow control structures

Conditional execution
IF
1
2
a = 10
i f a gt 5 then p r i n t , a i s g r e a t e r than 5
a i s g r e a t e r than 5
$ cat replace_with_nans . pro

x = [ 1 . 1 , 2 . 1 , 3.3 , 4 . 1 , 999 , 6 ]
r e p l a c e _ w i t h _ n a n s , x , 999
print , x
pro replace_with_nans , x , v a l
whr = where ( x eq v a l , c n t )
i f cnt gt 0 then begin
x [ whr ] = ! VALUES . F_NAN
message , nan c o u n t : + s t r t r i m ( cnt , 2 ) , / c o n t i
endif
end
% C o m p i l e d module : REPLACE_WITH_NANS .
% REPLACE_WITH_NANS : nan c o u n t : 1
1.10000
2.10000
3.30000
4.10000
nan
Flow control structures
data type
T
F
A
R
size
constants
min
max
casting
array allocation index array alloc.
8b
1b
0
255
BYTE()
BYTARR()
BINDGEN()
16b
1u
0
65535
UINT()
UINTARR()
UINDGEN()
natural numbers incl. zero (unsigned)
32b
1ul
0
4109
ULONG()
ULONARR()
ULINDGEN()
64b
1ull
0
1,81019 ULONG64()
ULON64ARR() UL64INDGEN()
16b
1
-32768
32767
FIX()
INTARR()
INDGEN()
integer numbers (signed)
32b
1l
-2109
2109
LONG()
LONARR()
LINDGEN()
64b
1ll
-91018
91018
LONG64()
LONG64ARR()
L64INDGEN()
38
32b
1.
-10
1038
FLOAT()
FLTARR()
FINDGEN()
real numbers
64b
1d
-10308
10308
DOUBLE()
DBLARR()
DINDGEN()
64b complex(1,0) 2x float 2x float COMPLEX() COMPLEXARR()
CINDGEN()
complex numbers
128b dcomplex(1,0) 2x double 2x double DCOMPLEX() DCOMPLEXARR() DCINDGEN()
character (byte) strings
variable
one
STRING()
STRARR()
structures
variable {a:1, b:1}
REPLICATE()
pointers
n/a
ptr_new(1)
PTRARR()
objects
n/a obj_new(One)
OBJARR()
CASE
Loops
FOR
FOREACH
FOREACH statement allows to simplify loop constructs when the array index is not
used within the loop:
tocompare = [ apples , o r r a g e s ]
f o r e a c h a , t o c o m p a r e do h e l p , a
A
A
freeing
TEMPORARY()
TEMPORARY()
TEMPORARY()
TEMPORARY()
TEMPORARY()
TEMPORARY()
PTR_FREE()
OBJ_DESTROY()
As with index variables in FOR loops, the lifetime of the loop variables in FOREACH
statements extends beyond the loop execution (see example below). Both BREAK
and CONTINUE statements work in FOREACH in the same way as in other loop
constructs:
SWITCH
13
STRING
STRING
= apples
= orrages
$ cat example . pro

example
pro example
l e t t e r s = [ a , b , c , d , e ]
f o r e a c h l , l e t t e r s do b e g i n
i f l eq c t h e n c o n t i n u e
i f l eq d t h e n b r e a k
p r i n t , t r y i n g t o r e p l a c e + l + w i t h x
l = x
endforeach
print , l e t t e r s
print , l
end
% Warning : A s s i g n m e n t t o l o o p v a r i a b l e d e t e c t e d .
14
T
F
A
R
% C o m p i l e d module : EXAMPLE .
t r y i n g to r e p l a c e a with x
t r y i n g to r e p l a c e b with x
a b c d e
d
Chapter 2. Language reference
Other
EXECUTE()
Variable scoping rules
Loop variables in FOREACH statements contain copies of the array elements thus
assigning them a value within the loop does not change contents of the array and as
a potentially bug-prone situation causes a compiler warning (see example above).
REPEAT
WHILE
Jumps
GOTO
Functions and procedures
There may exist a function and a procedure of the same name (e.g.
and PYTHON, CALL_METHOD() and CALL_METHOD)
EXPAND_PATH(), FILEPATH()
CALL_FUNCTION() CALL_PROCEDURE()
Argument passing
Highly deprecated as it usually make the code difficult to read and prone to errors.
Anyhow, the syntax is as follows
1
2
$ cat example . pro

example
pro example
x = 0
goto , a
x++
a : print , x = , x
end
x =
0
As most of the flow control operator described in this section GOTO is usable only
within a GDL routine not within a batch script which is equivalent to a series of
statements in the interactive mode.
PYTHON()
N_PARAMS() KEYWORD_SET() ARG_PRESENT() N_ELEMENTS() SIZE()

_EXTRA _STRICT_EXTRA _REF_EXTRA
when by reference, when by value...
Keyword name abbreviations are allowed if unambiguous, e.g.:
1
2
3
4
help
help
help
help
,
,
,
,
s t r p o s ( kayak
s t r p o s ( kayak
s t r p o s ( kayak
s t r p o s ( kayak
,
,
,
,
a
a
a
a
,
,
,
,
/ reverse_search )
/ reverse_s )
/ rev )
2 , / reverse_search , / reverse_offset )
<E x p r e s s i o n >
LONG
=
3
LONG
=
3
% STRPOS : Ambiguous keyword a b b r e v i a t i o n : REV
% E x e c u t i o n h a l t e d a t : $MAIN$
LONG
=
1
Object-oriented programming
Arrays
PRINT ( TV) PM
N_ELEMENTS() SIZE()
T
F
A
R
15
Object-oriented programming
CALL_METHON CALL_METHON() OBJARR()
OBJ_CLASS() OBJ_DESTROY OBJ_ISA() OBJ_NEW() OBJ_VALID()
REFORM() REBIN() REVERSE() ROTATE() TRANSPOSE()

SORT() UNIQ()
WHERE() ARRAY_INDICES()
ARRAY_EQUAL()
Handling Overflows, Floating Point Special Values

CHECK_MATH() FINITE() MACHAR()
MAKE_ARRAY() REPLICATE() REPLICATE_INPLACE
Error handling
BYTARR() COMPLEXARR() DBLARR() DCOMPLEXARR() FLTARR() INTARR() LON64ARR() LONARR() OBJARR() PTRARR() STRARR() UINTARR() ULON64ARR() ULONARR()
MESSAGE CATCH ON_ERROR ON_IOERROR EXECUTE
BINDGEN() CINDGEN() DCINDGEN() DINDGEN() FINDGEN() INDGEN()

L64INDEGEN() LINDEGEN() SINDGEN() UINDGEN() UL64INDGEN() ULINDGEN()
IDENTITY()
Compile options
1
2
3
Structures
pro example
compile_opt i d l 2
help , 1
end
INT
=
LONG
=
CREATE_STRUCT() N_TAGS() STRUCT_ASSIGN TAG_NAMES()
System variables (global)
DEFSYSV (checking if running GDL)
Heap variables (pointers)
$ cat example . pro

help , 1
example
1
2
$cat example . pro

example
HEAP_GC PTRARR PTR_FREE PTR_NEW() PTR_VALID()
The HELP procedure

HELP
pro example_helper
compile_opt hidden
p r i n t , example p r o c e d u r e h e l p e r
end
pro example
16
T
F
A
R
example_helper
end
example p r o c e d u r e h e l p e r
Chapter 2. Language reference
Chapter 3
T
F
A
R
Interpreter commands and built-in debugging facilities

MESSAGE RETALL STOP .COMPILE .STEP .CONTINUE
CHECK_MATH
JOURNAL RECALL_COMMANDS
MEMORY ( TEMPORARY())
RESOLVE_ROUTINE ROUTINE_INFO() ROUTINE_NAMES() SCOPE_VARFETCH()
Chapter 4
Maths
T
F
A
R
Basic Scalar, vector and array operations
Similarily, if a functions returns integer numbers, the /L64 keyword (flag) can be used
to force usage of 64-bit integers, e.g.:
TOTAL() SQRT() REVERSE() SHIFT() MAX() MIN() MEAN() NORM()

CONVOL() PRODUCT() CROSSP() DERIV() INVERT() MATRIX_MULTIPLY()
TRACE() TRANSPOSE() ( ROTATE())
Basic and special function library
GDL has a built-in collection of mathematical functions that are listed below. A great
majority of these routines accept both scalar and vector arguments of any numerical
type and return the result as scalars or vectors, respectively, preserving the type of
the argument, e.g.:
h e l p , a b s (1 l ) , a b s ( [ ! PI , 0 , ! PI ] )
LONG
FLOAT
=
= Array [ 3 ]
Some of the routines support a /DOUBLE keyword (flag) which enables one to force
GDL to perform the calculations in (if applicable) and return the value[s] as double
precision floating point numbers regardless of the type of the argument[s] passed,
e.g:
1
h e l p , gamma( 3 6 b ) , gamma( 3 6 b , / d o u b l e )
h e l p , r o u n d ( 1 d10 ) , r o u n d ( 1 d10 , / l 6 4 )
UNIQ()?
FLOAT
DOUBLE
=
=
inf
1 . 0 3 3 3 1 4 8 e+40
LONG
LONG64
=
=
2147483648
10000000000
If GDL was compiled with OpenMP support (which is the default if the compiler
supports it, and most of them do nowadays), and if GDL is run on a multi-cpu (or
multi-core) system, and if the array[s] passed as the argument[s] are big enough (see
chapter ... TODO) the computations are performed by multiple threads. Consult the
individual documentation entries of each of the routines for details.
ABS() returns the absolute value[s] of the real number[s] passed as the argument
(integer or floating point) or the magnitude[s] in case of complex number[s]
CEIL() returns the smallest integer number[s] greater than or equal to the argument
FLOOR() returns the greatest integer number[s] less than or equal to the argument
(aka the Gauss symbol)
ROUND() returns an integer value[s] closest to the argument
ERF()
IMSL_ERF()
ERFC()
ERRORF()
EXPINT()
ALOG()
ALOG10()
EXP() ( GSL_EXP())
... the following trigonometric functions:
Statistics
T
F
A
R
SIN() returns the sine of the argument

ASIN() returns the cosine of the argument
COS()
ACOS()
TAN()
ATAN() ... complex! ...
the following hyperbolic functions:
SINH()
COSH()
TANH()
Statistics
CORRELATE()
HISTOGRAM() HIST_2D() (implemented using HIST_ND())

IMSL_BINOMIALCOEF()
GAUSSINT() GAUSS_CVF() GAUSS_PDF()

T_PDF()
KURTOSIS() SKEWNESS() MEAN() MIN() MAX() MEDIAN() MEANABSDEV() MOMENT() STDDEV() VARIANCE()
as well as the following related functions:

LL_ARC_DISTANCE()
Interpolation
INTERPOL() (implemented using FINDEX()) INTERPOLATE()
BESELI()
BESELJ()
BESELK()
BESELY()
REBIN()
DERIV()
SPL_INIT() SPL_INTERP()
VALUE_LOCATE()
SPHER_HARM()
LAGUERRE()
LEGENDRE()
Polynomials
IMSL_ZEROPOLY() POLY()
GAUSSINT() GAUSS_CVF() GAUSS_PDF()

T_PDF()
Geometric calculations
FACTORIAL() GAMMA() BETA() IGAMMA() LNGAMMA()

PRIMES()
VOIGT()
Linear algebra
19
POLY_AREA() TRIGRID()
Bitwise operations
ISHFT() BYTEORDER SWAP_ENDIAN() SWAP_ENDIAN_INPLACE
LA_TRIRED LUDC SVDC
Function fitting
IDENTITY() REPLICATE() REPLICATE_INPLACE
Markwardt [3]
20
Fourier analysis
FFT() DIST()
T
F
A
R
Multidimensional root-finding
BROYDEN() IMSL_ZEROPOLY() NEWTON()
Random numbers
RANDOMN() RANDOMU()
Ordinary differential equations

RK4()
Wavelet analysis
WTN()
Mathematical and physical constants

!PI !DPI IDL_CONSTANT()
Chapter 4. Maths
Chapter 5
T
F
A
R
Input/output, supported data formats

Basics accessing files and io streams
netCDF
PRINT PM GET_KBRD READ
NCDF_ATTCOPY() NCDF_ATTDEL NCDF_ATTGET NCDF_ATTINQ() NCDF_ATTNAME(

NCDF_ATTPUT NCDF_ATTRENAME NCDF_CLOSE NCDF_CONTROL NCDF_CREATE()
NCDF_DIMDEF() NCDF_DIMID() NCDF_DIMINQ NCDF_DIMRENAME NCDF_EXISTS()
NCDF_INQUIRE() NCDF_OPEN() NCDF_VARDEF() NCDF_VARGET NCDF_VARGET1
NCDF_VARID() NCDF_VARINQ() NCDF_VARPUT NCDF_VARRENAME
BYTEORDER CLOSE EOF

READ WRITE
READF READS READU
GET_LUN FREE_LUN POINT_LUN SKIP_LUN

OPENR OPENU OPENW
HDF4
HDF_CLOSE HDF_OPEN()
ASCII
PRINTF READF READ_ASCII
CSV
Binary data (raw access)

READ_BINARY()
BYTEORDER SWAP_ENDIAN() SWAP_ENDIAN_INPLACE
FITS
Astron
HDF_SD_ADDDATA HDF_SD_ATTRFIND() HDF_SD_ATTRINFO HDF_SD_CREATE()

HDF_SD_DIMGET HDF_SD_DIMGETID() HDF_SD_END HDF_SD_ENDACCESS
HDF_SD_FILEINFO HDF_SD_GETDATA HDF_SD_GETINFO HDF_SD_NAMETOINDEX()
HDF_SD_SELECT() HDF_SD_START()
HDF_VD_ATTACH() HDF_VD_DETACH HDF_VD_FIND() HDF_VD_GET
HDF_VD_READ()
HDF_VG_ATTACH() HDF_VG_DETACH HDF_VG_GETID() HDF_VG_GETINFO
HDF_VG_GETTRS
HDF5
H5A_CLOSE H5A_GET_NAME() H5A_GET_NUM_ATTRS() H5A_GET_SPACE()

H5A_GET_TYPE() H5A_OPEN_IDX() H5A_OPEN_NAME() H5A_READ()
H5D_CLOSE H5D_GET_SPACE() H5D_GET_TYPE() H5D_OPEN() H5D_READ()
H5F_CLOSE H5F_IS_HDF5() H5F_OPEN() H5G_CLOSE H5G_OPEN() H5S_CLOSE
H5S_GET_SIMPLE_EXTENT_DIMS() H5T_CLOSE H5T_GET_SIZE() H5_GET_LIBVERSIO
22
T
F
A
R
Chapter 5. Input/output, supported data formats
raster images (TIFF, PNG, JPEG, . . . )

see chapter in Image Processing
DICOM
GRIB
GRIBAPI_CLONE() GRIBAPI_CLOSE_FILE GRIBAPI_COUNT_IN_FILE() GRIBAPI_GET GRIBAPI_GET_DATA GRIBAPI_GET_SIZE() GRIBAPI_NEW_FROM_FILE()

GRIBAPI_OPEN_FILE() GRIBAPI_RELEASE
IDL save files

RESTORE SAVE
Chapter 6
T
F
A
R
Plotting and mapping

2D plots
Working with colours

LOADCT
AXIS CONTOUR OPLOT PLOT PLOTERR PLOTS POLYFILL XYOUTS
3D plots
SURFACE PLOTS
Plotting raster data
BYTSCL() TV() TVLCT() TVRD() TVSCL()
Managing multiple windows
WDELETE WINDOW WSHOW WSET
Map projections
MAP_CONTINENTS MAP_PROJ_FORWARD MAP_PROJ_INVERSE

LL_ARC_DISTANCE()
MAP_CLIP_SET
Output terminals
SET_PLOT DEVICE CURSOR ERASE FLUSH
2
3
4
device
loadct
plot ,
oplot ,
, / c o l o r , decomposed=0
, 1
[ 0 , 1 ] , t h i c k =20
[ 1 , 0 ] , c o l o r =200 , t h i c k =20
% C o m p i l e d module : LOADCT .
% LOADCT : L o a d i n g t a b l e BLUE/WHITE
24
1
2
3
T
F
A
R
Chapter 6. Plotting and mapping
d e v i c e , / c o l o r , decomposed=1
p l o t , [ 0 , 1 ] , t h i c k =20
o p l o t , [ 1 , 0 ] , c o l o r = f f 0 0 0 0 x , t h i c k =20
Fonts, symbols and text formatting

SHOWFONT Harshey fonts [8]
Misc
CONVERT_COORD() GET_SCREEN_SIZE()
Chapter 7
T
F
A
R
Interaction with host OS

CD POPD PUSHD PRINTD EXIT WAIT
Executing external commands (via shell or not)

SPAWN (while EXECUTE() ...)
Filesystem operations
CD FILE_BASENAME() FILE_COPY FILE_DELETE FILE_DIRNAME() FILE_EXPAND_PATH()

( EXPAND_PATH()) FILE_INFO() FILE_LINES() FILE_MKDIR FILE_SAME()
FILE_SEARCH() FILE_TEST() FILE_WHICH() FINDFILE() FSTAT() PATH_SEP()
Network operations
SOCKET PARSE_URL()
Command-line options and environmental variables
COMMAND_LINE_ARGS() SETENV GETENV() LOCALE_GET()
Chapter 8
T
F
A
R
Manipulating strings
STRCMP() STRCOMPRESS() STREGEX() STRJOIN() STRLEN()

STRLOWERCASE() STRUPCASE()
STRMID() STRPOS() RSTRPOS() STRPUT() STRSPLIT() STRTOK() STRTRIM() STR_SEP()

READS()
STRARR() STRING() SINDGEN()
IDL_BASE64() IDL_VALIDANEM() SORT() UNIQ() PARSE_URL()
Chapter 9
T
F
A
R
Representing date & time

CALDAT CALENDAR SYSTIME()
Chapter 10
Image processing
T
F
A
R
QUERY_BMP() QUERY_DICOM() QUERY_GIF() QUERY_IMAGE() QUERY_JPEG()

QUERY_PICT() QUERY_PNG() QUERY_PPM() QUERY_TIFF()
READ_BMP() READ_DICOM() READ_JPEG READ_PICT READ_PNG() READ_TIFF()

READ_XWD()
WRITE_BMP WRITE_JPEG WRITE_PICT WRITE_PNG
BYTSCL() CONVOL() MEDIAN() POLY_2D() PREWITT() RADON() ROBERTS()

ROTATE() REBIN() SMOOTH() SOBEL()
Chapter 11
Parallel processing
T
F
A
R
Built-in features (OpenMP)

CPU
Semaphores and shared memory (library routines)
SEM_CREATE() SEM_DELETE SEM_LOCK() SEM_RELEASE
ImageMagicks features
MPI and GDL
Chapter 12
T
F
A
R
GUI programming (widgets)

DIALOG_MESSAGE() DIALOG_PICKFILE()
WIDGET_BASE() WIDGET_BUTTON() WIDGET_CONTROL WIDGET_DROPLIST()

WIDGET_EVENT() WIDGET_INFO() WIDGET_LABEL() WIDGET_TEXT()
Chapter 13
Dynamic loading
T
F
A
R
CALL_EXTERNAL() LINKIMAGE()
Chapter 14
The Python bridge

van Rossum and Fred L. Drake [6]
T
F
A
R
calling Python code from GDL

PYTHON() PYTHON
calling GDL code from Python
Chapter 15
T
F
A
R
Alphabetical list of library routines
ALOG10() function
ABS() function
positional arguments: 1
keywords: none
Returns absolute value of a number passed as the first argument or an array of absolute values
if argument is an array. For complex arguments the length of the argument in the complex
plane is returned (the phase of a complex number may be obtained using ATAN()).
1
2
3
p r i n t , a b s ( 2.2)
p r i n t , abs ([ 1 ,1 ,0])
p r i n t , abs ( . 5 s q r t ( 2 ) complex (1 , 1 ) )
2.20000
1
1.00000
multi-threading: this routine uses GDL thread pool if working on large array, see the...
ACOS() function
keywords: none
keywords: none
APPLEMAN procedure
keywords: HELP, NODISPLAY, RESULT, TEST, XSIZE, YSIZE
Computes and optionally renders the Mandelbrot set. The two positional arguments are
optional and allow specification of the range over which the set is computed (default values:
[-1.0,2.3] and [-1.3,1.3]).
RESULT keyword
Allows passing a variable into which the computed data will be sotred. If set, no rendering
is done.
ALOG() function
keywords: none
XSIZE keyword
Allows specification of the width of the domain over which the set is computed.
34
T
F
A
R
YSIZE keyword
keywords: none
Allows specification of the height of the domain over which the set is computed.
1
2
3
4
5
6
7
8
rng_x = [ 1 , 2 . 3 ]
rng_y = [ 1 . 3 , 1 . 3 ]
appleman , rng_x , rng_y , r e s u l t =f r a c t a l , x s i z e =165 , y s i z e =130
device , / color
p l o t , [ 0 ] , / nodata , x r a n g e=rng_x , y r a n g e=rng_y
l o a d c t , 15
t v s c l , f r a c t a l , rng_x [ 0 ] , rng_y [ 0 ] , $
x s i z e=rng_x [1] rng_x [ 0 ] , y s i z e=rng_y [1] rng_y [ 0 ]
ARRAY_EQUAL() function
%
%
%
%
keywords: none
C o m p i l e d module :
LOADCT : L o a d i n g
APPLEMAN .
LOADCT .
t a b l e BOW SPECIAL
TVSCL .
keywords: NO_TYPECONV
ARRAY_INDICES() function
see also: WHERE()
ASIN() function
keywords: none
ASSOC() function
keywords: PACKED
ATAN() function
keywords: PHASE
ARG_PRESENT() function
AXIS procedure
AXIS procedure
T
F
A
R
keywords: CHARSIZE, CHARTHICK, COLOR, DATA, DEVICE, FONT, NODATA,
NOERASE, NORMAL, SAVE, SUBTITLE, T3D, THICK, TICKLEN, XAXIS,
XCHARSIZE, XGRIDSTYLE, XLOG, XMARGIN, XMINOR, XRANGE, XSTYLE,
XTHICK, XTICKFORMAT, XTICKINTERVAL, XTICKLEN, XTICKNAME, XTICKS,
XTITLE, XTYPE, YAXIS, YCHARSIZE, YGRIDSTYLE, YLOG, YMARGIN, YMINOR, YNOZERO, YRANGE, YSTYLE, YTHICK, YTICKFORMAT, YTICKINTERVAL, YTICKLEN, YTICKNAME, YTICKS, YTITLE, YTYPE, ZCHARSIZE,
ZGRIDSTYLE, ZMARGIN, ZMINOR, ZRANGE, ZSTYLE, ZTHICK, ZTICKFORMAT, ZTICKLEN, ZTICKNAME, ZTICKS, ZTITLE, ZVALUE
BESELI() function
keywords: DOUBLE, HELP, ITER
BESELJ() function
BESELK() function
BETA() function
keywords: DOUBLE
BILINEAR() function
keywords: MISSING
BINDGEN() function
keywords: none
BROYDEN() function
keywords: DOUBLE, ITMAX, TOLF, TOLX
BYTARR() function
keywords: NOZERO
BESELY() function
BYTE() function
keywords: none
35
36
T
F
A
R
BYTEORDER procedure
positional arguments: any number

keywords: DTOXDR, FTOXDR, HTONL, HTONS, L64SWAP, LSWAP, NTOHL,
NTOHS, SSWAP, SWAP_IF_BIG_ENDIAN, SWAP_IF_LITTLE_ENDIAN, XDRTOD, XDRTOF
BYTSCL() function
keywords: MAX, MIN, NAN, TOP
CALDAT procedure
keywords: none
CALENDAR procedure
keywords: none
CALL_EXTERNAL() function

keywords: ALL_GDL, ALL_VALUE, B_VALUE, D_VALUE, F_VALUE, I_VALUE,
L64_VALUE, L_VALUE, RETURN_TYPE, STRUCT_ALIGN_BYTES, S_VALUE,
UI_VALUE, UL64_VALUE, UL_VALUE, UNLOAD, VALUE
Calls a routine from a sharable object library. The first argument should be a string containing
the filename of the sharable object to load (standard library paths are searched). The second
argument should be a string with the name of the routine in the image to ba called. All
subsequent arguments are passed to the routine.
An interface to the UNIX cal command. Displays a calendar using the current graphics
device (i.e. X, PS, . . . ). The two optional arguments allow to specify a month, or a month
and a year.
1
c a l e n d a r , 9 , 1983
% C o m p i l e d module : CALENDAR .
Here is a, hopefully concise, example covering all the steps one could take to write, build
and call a C routine from GDL:
1
2
3
4
5
6
7
$
$
$
$
$
$
$
echo $ c a t l i b e x a m p l e . c
cat libexample . c
echo $ c a t CMakeLists . txt
cat CMakeLists . t x t
e c h o $ cmake .
cmake . | awk { p r i n t ( l e n g t h ( $0 ) >50? s u b s t r ( $0 , 0 , 5 0 )
echo
" . . . " : $0 ) }
CALL_EXTERNAL() function
8
9
10
$ e c h o $ make
$ make
$ echo
11
12
13
14
15
16
17
T
F
A
R
img = l i b e x a m p l e . + ( ! VERSION .OS_NAME eq d a r w i n ? " d y l i b " : " s o " )

message , 1 d308 v s . a n e x t r e p r e s e n t a b l e d o u b l e : , / c o n t i n u e
p r i n t , f o r m a t = (E ) , 1 d308 , $
c a l l _ e x t e r n a l ( img , c _ n e x t a f t e r , 1 d308 , 2 d308 , / d _ v a l u e )
$ make c l e a n
$ cat libexample . c
#i n c l u d e <math . h>
double c _ n e x t a f t e r ( i n t argc , v oi d argv [ ] ) {
r e t u r n n e x t a f t e r (( double ) argv [ 0 ] , ( double ) argv [ 1 ] ) ;
}
Linking C shared l i b r a r y libexample . d y l i b

[ 10 0 %] B u i l t t a r g e t e x a m p l e
% $MAIN$ : 1 d308 v s . a n e x t r e p r e s e n t a b l e d o u b l e :
1 . 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 E+308
1 . 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 2 E+308
RETURN_TYPE keyword
Indicates the type of the return value of the called routine, this value will be returned by
CALL_EXTERNAL to GDL. The value of the keyword is interpreted in the same way as the
type field of the SIZE() function. Possible values for it are those for numeric types except
COMPLEX and DCOMPLEX. The default value is 3 (GDL type LONG, which corresponds
to C type int). Alternatively one of the following keywords may be used:
B_VALUE keyword
$ cat CMakeLists . t x t
p r o j e c t ( l i b e x a p l e C)
cmake_minimum_required ( VERSION 2 . 0 )
a d d _ l i b r a r y ( e x a m p l e SHARED l i b e x a m p l e . c )
s e t _ d i r e c t o r y _ p r o p e r t i e s ( PROPERTIES ADDITIONAL_MAKE_CLEAN_FILES
" M a k e f i l e ; CMakeCache . t x t ; c m a k e _ i n s t a l l . cmake ; C M a k e F i l e s " )
$ cmake .
The C c o m p i l e r i d e n t i f i c a t i o n i s GNU
C h e c k i n g w h e t h e r C c o m p i l e r h a s i s y s r o o t
C h e c k i n g w h e t h e r C c o m p i l e r h a s i s y s r o o t y e s
C h e c k i n g w h e t h e r C c o m p i l e r s u p p o r t s OSX d e p l o y . . .
C h e c k i n g w h e t h e r C c o m p i l e r s u p p o r t s OSX d e p l o y . . .
Check f o r w o r k i n g C c o m p i l e r : / u s r / b i n / g c c
Check f o r w o r k i n g C c o m p i l e r : / u s r / b i n / g c c w . . .
D e t e c t i n g C c o m p i l e r ABI i n f o
D e t e c t i n g C c o m p i l e r ABI i n f o done
C o n f i g u r i n g done
G e n e r a t i n g done
B u i l d f i l e s h a v e been w r i t t e n t o : / U s e r s / s l a y o o . . .
$ make
Scanning d e p e n d e n c i e s of t a r g e t example
[100%] B u i l d i n g C o b j e c t CMakeFiles / example . d i r / l i b e x a m p l e . o
37
equivalent to RETURN_TYPE=1 (BYTE)

I_VALUE keyword
equivalent to RETURN_TYPE=2 (INTEGER)

L_VALUE keyword
equivalent to RETURN_TYPE=3 (LONG)

This correspodns to the default behaviour.
F_VALUE keyword
equivalent to RETURN_TYPE=4 (FLOAT)

D_VALUE keyword
equivalent to RETURN_TYPE=5 (DOUBLE)

UI_VALUE keyword
equivalent to RETURN_TYPE=12 (UINT)
38
T
F
A
R
UL_VALUE keyword
equivalent to RETURN_TYPE=13 (ULONG)

L64_VALUE keyword
CALL_FUNCTION() function
keywords: _REF_EXTRA
equivalent to RETURN_TYPE=14 (LONG64)
CALL_METHOD procedure
UL64_VALUE keyword

equivalent to RETURN_TYPE=15 (ULONG64)

S_VALUE keyword
equivalent to RETURN_TYPE=6 (STRING, the called function should return char*)

ALL_VALUE keyword
CALL_METHOD() function
The default is to pass all parameters by reference. If this keyword is set, all parameters are
passed by value.
CALL_PROCEDURE procedure
UNLOAD keyword

If set (/UNLOAD or UNLOAD=1) the shared object will be unloaded after calling the routine.
STRUCT_ALIGN_BYTES keyword
CATCH procedure
If set to an integer n, CALL_EXTERNAL assumes that structures in the shared object are
aligned at boundaries of n bytes, where n should be a power of 2. If n=0 or if this keyword
is not given, the default machine dependent alignment is assumed (normally 4/8 bytes on
32/64 bit systems). It should only be necessary to use this keyword if the called shared
object has been compiled with a different alignment, e.g. with #pragma pack(n)
keywords: CANCEL
implementation details: This routine uses the dlopen/dlsym/dlclose calls, and thus is available only on systems that support them. It has been tested on Linux, Apple OS X and
Solaris.
keywords: CURRENT
see also: LINKIMAGE
CDF_EPOCH procedure
disclaimer: CALL_EXTERNAL was implemented in GDL by Christoph Fuchs, who also

wrote the documentation for it which was the base for this entry. Copyright: (C) 2010
by Christoph Fuchs. The original file was licensed under GNU GPL v>=2.
CD procedure
keywords: BREAKDOWN_EPOCH, COMPUTE_EPOCH
CEIL() function
CEIL() function
keywords: L64
T
F
A
R
39
COMPLEXARR() function
keywords: NOZERO
CONGRID() function
CHECK_MATH() function
keywords: CENTER, CUBIC, HELP, INTERP, MINUS_ONE, MISSING, TEST
keywords: MASK, NOCLEAR, PRINT
CONJ() function
CINDGEN() function
keywords: none
CLOSE procedure

keywords: ALL, EXIT_STATUS, FILE, FORCE
COMMAND_LINE_ARGS() function
positional arguments: none
keywords: COUNT
COMPLEX() function
keywords: none
keywords: none
CONTOUR procedure
keywords: BACKGROUND, CHARSIZE, CHARTHICK, CLIP, COLOR, C_CHARSIZE,
C_COLORS, C_LINESTYLE, DATA, DEVICE, FILL, FOLLOW, FONT,
ISOTROPIC, LEVELS, MAX_VALUE, MIN_VALUE, NLEVELS, NOCLIP, NODATA, NOERASE, NORMAL, OVERPLOT, POSITION, SUBTITLE, T3D,
THICK, TICKLEN, TITLE, XCHARSIZE, XGRIDSTYLE, XLOG, XMARGIN,
XMINOR, XRANGE, XSTYLE, XTHICK, XTICKFORMAT, XTICKLEN, XTICKNAME, XTICKS, XTICKV, XTICK_GET, XTITLE, XTYPE, YCHARSIZE, YGRIDSTYLE, YLOG, YMARGIN, YMINOR, YRANGE, YSTYLE, YTHICK, YTICKFORMAT, YTICKLEN, YTICKNAME, YTICKS, YTICKV, YTICK_GET, YTITLE,
YTYPE, ZCHARSIZE, ZGRIDSTYLE, ZLOG, ZMARGIN, ZMINOR, ZRANGE,
ZSTYLE, ZTHICK, ZTICKFORMAT, ZTICKLEN, ZTICKNAME, ZTICKS, ZTICKV,
ZTICK_GET, ZTITLE, ZTYPE, ZVALUE
CONVERT_COORD() function
40
T
F
A
R
DOUBLE keyword
keywords: DATA, DEVICE, DOUBLE, NORMAL, T3D, TO_DATA, TO_DEVICE,

TO_NORMAL
Forces double-precision calculations and output value type.
CONVOL() function
2
3
keywords: CENTER, EDGE_TRUNCATE, EDGE_WRAP
x =
y =
help
help
[1 ,
2,
3,
4,
5]
[1.1 , 1.9 , 3.1 , 3.9 , 5 , 6 , 7 , 8 , 9]
, correlate (x , y)
, c o r r e l a t e (x , y , / double )
% C o m p i l e d module : CORRELATE .
% C o m p i l e d module : MEAN.
FLOAT
=
DOUBLE
=
CORRELATE() function
keywords: COVARIANCE, DOUBLE
0.99813
0.9981310
COVARIANCE keyword
When called with two vector arguments x and y it returns the correlation coefficient r defined
as:
cov(x, y)
(15.1)
r=
stdev(x) stdev(y)
If called with the COVARIANCE keyword, the covariance cov(x, y) of the two vectors is
returned instead.
where
cov(x, y) =
N 1
1 X
(x[i] x) (y[i] y)
N 1
(15.2)
x = [ 1 , 0 , 1 . ]
y = [ 2 , 0 , 2 . ]
print , correlate (x , y , / covariance )
i=0
v
u
u
stdev(x) = t
and
(N is the length of the longer vector).

1
N 1
1 X
[x[i] x]2
N 1
(15.3)
2.00000
(15.4)
COS() function
i=0
N 1
x=
X x[i]
i=0
keywords: none
print , c o r r e l a t e ([ 1 ,0 ,1] , [1 ,0 , 1])

1.00000
COSH() function
CPU procedure
keywords: none
T
F
A
R
DCOMPLEX() function
CPU procedure

keywords: RESET,
RESTORE,
TPOOL_MAX_ELTS,
TPOOL_NTHREADS, VECTOR_ENABLE
CROSSP() function
keywords: none
CURSOR procedure
TPOOL_MIN_ELTS,
keywords: CHANGE, DATA, DEVICE, DOWN, NORMAL, NOWAIT, UP, WAIT
DBLARR() function
keywords: NOZERO
DCINDGEN() function
keywords: none
keywords: none
DCOMPLEXARR() function
CREATE_STRUCT() function
keywords: NAME
41
keywords: NOZERO
DEFSYSV procedure
keywords: EXISTS
DERIV() function
keywords: HELP, NO_CHECK, TEST
DETERM() function
keywords: DOUBLE
DEVICE procedure

keywords: CLOSE_FILE,
COLOR,
DECOMPOSED,
ENCAPSULATED,
FILENAME, GET_DECOMPOSED, GET_SCREEN_SIZE, GET_VISUAL_DEPTH,
INCHES, LANDSCAPE, PORTRAIT, SCALE_FACTOR, SET_CHARACTER_SIZE,
SET_RESOLUTION, WINDOW_STATE, XOFFSET, XSIZE, YOFFSET, YSIZE,
Z_BUFFERING
42
T
F
A
R
DIALOG_MESSAGE() function
keywords: CANCEL,
CENTER,
DEFAULT_CANCEL,
DEFAULT_NO,
DIALOG_PARENT, DISPLAY_NAME, ERROR, HELP, INFORMATION, QUESTION,
RESOURCE_NAME, TITLE, ZENITY_NAME, ZENITY_PATH
DIALOG_PICKFILE() function

keywords: DEBUG, DEFAULT_EXTENSION, DIALOG_PARENT, DIRECTORY, DISPLAY_NAME, FILE, FILTER, FIX_FILTER, GET_PATH, GROUP, HELP, MULTIPLE_FILES, MUST_EXIST, OVERWRITE_PROMPT, PATH, READ, RESOURCE_NAME, TEST, TITLE, VERBOSE, WRITE, ZENITY_NAME, ZENITY_PATH, ZENITY_SEP
DOUBLE() function
DINDGEN() function
keywords: none
DIST() function
keywords: none
surface , d i s t (25)
% C o m p i l e d module : DIST .
keywords: none
EOF() function
keywords: none
ERASE procedure
keywords: none
ERF() function
keywords: DOUBLE
ERFC() function
ERFC() function
keywords: DOUBLE
T
F
A
R
STATUS keyword
1
2
3
ERRORF() function
keywords: DOUBLE
spawn , . . / . . / . . / . . / s r c / g d l q u i e t e " e x i t , s t a t u s =44" 1>/ dev / n u l l , $

e x i t _ s t a t u s=s
p r i n t , spawned GDL p r o c e s s e x i t e d w i t h c o d e , s t r t r i m ( s , 2 )
spawned GDL p r o c e s s e x i t e d w i t h c o d e 44
EXP() function
ESCAPE_SPECIAL_CHAR() function
keywords: HELP, LIST_OF_SPECIAL_CHAR, SHOW_LIST, TEST, VERBOSE
keywords: none
1
2
EXECUTE() function
keywords: none
Executes the statement passed in the first arguement, returns 1 if no error occured or 0 if
the execution failed, e.g.
1
2
3
4
status
help ,
status
help ,
= execute ( print , " Hello world ! " )

status
= execute ( print , Hello world ! ) )
status
43
p r i n t , exp ( [ 0 , 1 , !VALUES . F_INFINITY ] )

p r i n t , a l o g ( exp ( [ ! PI ] ) )
1.00000
3.14159
2.71828
0.00000
EXPAND_PATH() function
keywords: ALL_DIRS, ARRAY, COUNT
Hello world !
STATUS
INT
=
1
% P a r s e r s y n t a x e r r o r : u n e x p e c t e d t o k e n : HELLO
STATUS
INT
=
0
EXPINT() function
EXIT procedure
FACTORIAL() function

keywords: NO_CONFIRM, STATUS
keywords: STIRLING, UL64
keywords: DOUBLE
44
T
F
A
R
FFT() function
keywords: DIMENSION, DOUBLE, INVERSE, OVERWRITE
F [m] =
1
2
3
1 X
f [k] e
2i mk
N
% Compiled
% Compiled
% Compiled
% Compiled
passwd
(15.5)
$ t a i l stddev . pro
x = [1.31 , 2.44 , 2.51 , 3.01 , 2.96 , 2.50 , 0.05 , 3.24 , 0.13]
p r i n t , stddevsum ( x ) , s t d d e v f f t ( x )
implementation details: FFTW vs. GSL - TODO
FILEPATH() function
keywords: ROOT_DIR, SUBDIRECTORY, TERMINAL, TMP
FILE_BASENAME() function
keywords: FOLD_CASE, HELP
module :
module :
module :
module :
FILE_BASENAME .
ESCAPE_SPECIAL_CHAR .
STRSPLIT .
UNIQ .
p r i n t , file_basename ( / e t c / r e s o l v . conf ,
% Compiled
% Compiled
% Compiled
% Compiled
resolv
==> s t d d e v f f t . p r o <==
function stddevfft , x
return , s q r t ( t o t a l ( ( abs ( f f t ( x ) ) ^ 2 ) [ 1 : 1 ] ) )
end
==> s t d d e v s u m . p r o <==
f u n c t i o n stddevsum , x
r e t u r n , s q r t ( mean ( x ^2) mean ( x ) ^ 2 )
end
% C o m p i l e d module : STDDEVSUM.
% C o m p i l e d module : STDDEVFFT .
1.15258
1.15258
p r i n t , f i l e _ b a s e n a m e ( / e t c / passwd )
module :
module :
module :
module :
. conf )
FILE_BASENAME .
ESCAPE_SPECIAL_CHAR .
STRSPLIT .
UNIQ .
print , file_basename ( f i l e _ s e a r c h ( . . / . . / . . / . . / src / gdl . g ) )
% C o m p i l e d module : FILE_BASENAME .
% C o m p i l e d module : ESCAPE_SPECIAL_CHAR .
% C o m p i l e d module : STRSPLIT .
% C o m p i l e d module : UNIQ .
gdlc . g gdlc . i . g gdlc . tree . g
see also: FILE_DIRNAME(), PATH_SEP()
FILE_COPY procedure
keywords: ALLOW_SAME, HELP, NOEXPAND_PATH, OVERWRITE, QUIET, RECURSIVE, REQUIRE_DIRECTORY, TEST, VERBOSE
FILE_DELETE procedure
keywords: ALLOW_NONEXISTENT, HELP, NOEXPAND_PATH, QUIET, RECURSIVE, TEST, VERBOSE
FILE_DIRNAME() function
T
F
A
R
FILE_DIRNAME() function
FILE_SAME() function
keywords: HELP, MARK_DIRECTORY
keywords: NOEXPAND_PATH
FILE_EXPAND_PATH() function
FILE_SEARCH() function
keywords: none
FILE_INFO() function
FILE_LINES() function
keywords: COMPRESS, NOEXPAND_PATH
1
p r i n t , f i l e _ l i n e s ( . . / . . / . . / . . / ChangeLog )
% C o m p i l e d module : FILE_LINES .
6335
FILE_MKDIR procedure

implementation details: Current implementation uses the system() call and executes the
mkdir using using a shell subprocess
45
keywords: COUNT, EXPAND_ENVIRONMENT, EXPAND_TILDE, FOLD_CASE,
FULLY_QUALIFY_PATH,
ISSUE_ACCESS_ERROR,
MARK_DIRECTORY,
MATCH_ALL_INITIAL_DOT, MATCH_INITIAL_DOT, NOSORT, QUOTE
FILE_TEST() function
keywords: BLOCK_SPECIAL, CHARACTER_SPECIAL, DIRECTORY, EXECUTABLE,
GET_MODE, NAMED_PIPE, NOEXPAND_PATH, READ, REGULAR, SOCKET,
SYMLINK, WRITE, ZERO_LENGTH
FILE_WHICH() function
keywords: DEBUG, HELP, INCLUDE_CURRENT_DIR, TEST
FINDEX() function
keywords: none
FINDFILE() function
keywords: COUNT, HELP, QUIET, SH_LOCATION, SPAWN_OPTIONS, TEST, VERBOSE
46
T
F
A
R
FINDGEN() function
keywords: none
FINITE() function
keywords: INFINITY, NAN
FLUSH procedure

keywords: none
FREE_LUN procedure

keywords: EXIT_STATUS, FORCE
FSTAT() function
FIX() function
keywords: PRINT, TYPE
keywords: none
GAMMA() function
FLOAT() function
keywords: none
keywords: DOUBLE
GAUSSINT() function
FLOOR() function
keywords: L64
keywords: DOUBLE
GAUSS_CVF() function
keywords: none
FLTARR() function
GAUSS_PDF() function
keywords: NOZERO
keywords: none
GDL_ERFINV() function
GDL_ERFINV() function
keywords: DOUBLE
GETENV() function
keywords: ENVIRONMENT
T
F
A
R
GET_LUN procedure
keywords: none
GET_SCREEN_SIZE() function
keywords: RESOLUTION
GRIBAPI_CLONE() function
GET_DRIVE_LIST() function
keywords: COUNT
keywords: none
GRIBAPI_CLOSE_FILE procedure
GET_KBRD() function
keywords: none
keywords: none
GRIBAPI_COUNT_IN_FILE() function
GET_LOGIN_INFO() function
keywords: none
Returns a structure with current username and hostname:

1
help , get_login_info ( ) , / s t r u c t u r e
S t r u c t u r e <Anonymous >, 2 t a g s , d a t a l e n g t h =16:

MACHINE_NAME
STRING
e y r i e . prac . igf
USER_NAME
STRING
slayoo
keywords: none
GRIBAPI_GET procedure
keywords: none
GRIBAPI_GET_DATA procedure
keywords: none
47
48
T
F
A
R
GRIBAPI_GET_SIZE() function
H5A_GET_NUM_ATTRS() function
keywords: none
keywords: none
GRIBAPI_NEW_FROM_FILE() function
H5A_GET_SPACE() function
keywords: none
keywords: none
GRIBAPI_OPEN_FILE() function
H5A_GET_TYPE() function
keywords: none
keywords: none
GRIBAPI_RELEASE procedure
H5A_OPEN_IDX() function
keywords: none
keywords: none
GSL_EXP() function
keywords: none
H5A_CLOSE procedure
keywords: none
H5A_OPEN_NAME() function
keywords: none
H5A_READ() function
keywords: none
H5A_GET_NAME() function
H5D_CLOSE procedure
keywords: none
keywords: none
H5D_GET_SPACE() function
T
F
A
R
H5D_GET_SPACE() function
H5G_CLOSE procedure
keywords: none
keywords: none
H5D_GET_TYPE() function
keywords: none
H5D_OPEN() function
keywords: none
H5D_READ() function
keywords: none
H5F_CLOSE procedure
keywords: none
H5F_IS_HDF5() function
keywords: none
H5F_OPEN() function
keywords: none
H5G_OPEN() function
keywords: none
H5S_CLOSE procedure
keywords: none
H5S_GET_SIMPLE_EXTENT_DIMS() function
keywords: none
H5T_CLOSE procedure
keywords: none
H5T_GET_SIZE() function
keywords: none
49
50
T
F
A
R
H5_GET_LIBVERSION() function
HDF_SD_CREATE() function

keywords: none
keywords: BYTE, DFNT_CHAR, DFNT_FLOAT32, DFNT_FLOAT64, DFNT_INT16,
DFNT_INT32, DFNT_INT8, DFNT_UINT16, DFNT_UINT32, DFNT_UINT8,
DOUBLE, FLOAT, HDF_TYPE, INT, LONG, SHORT, STRING
Returns a string containing the version number of the HDF5 library.

1
help , h5_get_libversion ()
STRING
= 1.8.8
HDF_CLOSE procedure
keywords: none
HDF_OPEN() function
HDF_SD_DIMGET procedure
keywords: COUNT, NAME, NATTR, SCALE
HDF_SD_DIMGETID() function
keywords: none
keywords: ALL, CREATE, NUM_DD, RDWR, READ, WRITE
HDF_SD_END procedure
HDF_SD_ADDDATA procedure
keywords: none
keywords: COUNT, START, STRIDE
HDF_SD_ENDACCESS procedure
HDF_SD_ATTRFIND() function
keywords: none
keywords: none
HDF_SD_ATTRINFO procedure
HDF_SD_FILEINFO procedure
keywords: COUNT, DATA, HDF_TYPE, NAME, TYPE
keywords: none
HDF_SD_GETDATA procedure
T
F
A
R
HDF_SD_GETDATA procedure
HDF_VD_FIND() function
keywords: COUNT, START, STRIDE
keywords: none
HDF_SD_GETINFO procedure
HDF_VD_GET procedure
keywords: COORDSYS, DIMS, FORMAT, HDF_TYPE, LABEL, NAME, NATTS,
NDIMS, TYPE, UNIT
keywords: CLASS, COUNT, NAME, REF, TAG
HDF_SD_NAMETOINDEX() function
keywords: none
HDF_SD_SELECT() function
keywords: none
HDF_SD_START() function
keywords: CREATE, RDWR, READ
HDF_VD_READ() function
keywords: FIELDS, FULL_INTERLACE, NO_INTERLACE, NRECORDS
HDF_VG_ATTACH() function
keywords: READ, WRITE
HDF_VG_DETACH procedure
keywords: none
HDF_VD_ATTACH() function
HDF_VG_GETID() function
keywords: READ, WRITE
keywords: none
HDF_VD_DETACH procedure
HDF_VG_GETINFO procedure
keywords: none
keywords: CLASS, NAME, NENTRIES, REF, TAG
51
52
T
F
A
R
HDF_VG_GETTRS procedure
HIST_ND() function
keywords: none
keywords: MAX, MIN, NBINS, REVERSE_INDICES
Performs an N-dimensional histogram, also known as the joint density function of N variables.
HEAP_GC procedure
keywords: OBJ, PTR, VERBOSE
The first argument is an NP array representing P data points in N dimensions. The second
argument is optional, and it may be used to specify the size of the bin to use. Either an N
point vector specifying a separate size for each dimension, or a scalar, which will be used for
all dimensions. If BINSIZE is not passed, the NBINS keyword must be set (see below).
The function returns the N-Dimensional histogram, an array of size N1N2N3. . . ND
where the Nis are the number of bins implied by the data, and/or the optional inputs (see
below).
HELP procedure

keywords: BRIEF, CALLS, FUNCTIONS, INFO, LIB, MEMORY, OUTPUT, PROCEDURES, RECALL_COMMANDS, ROUTINES, STRUCTURES
HELPFORM() function
keywords: FULL_STRUCT,
TAGFORM, WIDTH
SHORTFORM,
HISTOGRAM() function
The minimum value for the histogram. Either a P point vector specifying a separate minimum
for each dimension, or a scalar, which will be used for all dimensions. If omitted, the natural
minimum within the dataset will be used.
MAX keyword
SINGLE,
SIZE,
STRUCTURE_NAME,
Rather than specifying the binsize, you can pass NBINS, the number of bins in each dimension, which can be a P point vector, or a scalar. If BINSIZE it also passed, NBINS will be
ignored, otherwise BINSIZE will then be calculated as binsize=(max-min)/nbins.
REVERSE_INDICES keyword
Set to a named variable to receive the reverse indices, for mapping which points occurred in
a given bin. Note that this is a 1-dimensional reverse index vector (see HISTOGRAM()).
E.g., to find the indices of points which fell in a histogram bin [i,j,k], look up:
keywords: BIN1, BIN2, MAX1, MAX2, MIN1, MIN2
implementation details: this routine is implemented as a wrapper to the
function
The maximum value for the histogram. Either a P point vector specifying a separate maximmum for each dimension, or a scalar, which will be used for all dimensions. If omitted,
the natural maximum within the dataset will be used.
NBINS keyword
keywords: BINSIZE, INPUT, LOCATIONS, MAX, MIN, NAN, NBINS, OMAX, OMIN,
REVERSE_INDICES
HIST_2D() function
MIN keyword
ind=[i+nx*(j+ny*k)]
ri[ri[ind]:ri[ind+1]-1]
HIST_ND()
See also ARRAY_INDICES() for converting in the other direction.
IDENTITY() function
T
F
A
R
see also: HISTOGRAM(), HIST_2D()
IMAGINARY() function
disclaimer: Entry based on J.D. Smiths documentation for his implementation of HIST_ND
which was included in GDL unchanged. Copyright (C) 2001-2007, J.D Smith. This
software is provided as is without any warranty whatsoever. Permission to use, copy,
modify, and distribute modified or unmodified copies is granted, provided this copyright
and disclaimer are included unchanged.
keywords: none
IDENTITY() function
IMSL_BINOMIALCOEF() function
keywords: DOUBLE
53
keywords: DOUBLE
Returns the binomial coefficient defined as:
IDL_BASE64() function
keywords: none

n
k
n!
for 0 k n
k!(n k)!
where n and k are the first and second arguments, respectively.
disclaimer: the name of this GDL routine includes the IDL_ prefix for compatibility with
IDL, it has no ...
The routine can be used for example to construct the Pascals trangle:
1
2
IDL_VALIDNAME() function
keywords: CONVERT_ALL, CONVERT_SPACES, HELP, TEST
IGAMMA() function
keywords: DOUBLE
IMAGE_STATISTICS procedure
keywords: COUNT, DATA_SUM, HELP, LUT, MASK, MAXIMUM, MEAN, MINIMUM, STDDEV, SUM_OF_SQUARES, TEST, VARIANCE, VECTOR, VERBOSE,
WEIGHTED, WEIGHT_SUM
$ cat p a s c a l . pro
pascal , 8
pro pascal , n
tri = replicate (
, 2 n 1 , n)
f o r i =0, n1 do f o r j =0 , i do t r i [ 2 j + ( ni ) 1 , i ] = $
s t r i n g ( i m s l _ b i n o m i a l c o e f ( i , j ) , f = ( I 3 ) )
print , t r i
end
% C o m p i l e d module : PASCAL .
1
1
1
1
2
1
1
3
3
1
1
4
6
4
1
1
5
10
10
5
1
1
6
15
20
15
6
1
1
7
21
35
35
21
7
1
(15.6)
54
T
F
A
R
DOUBLE keyword
20
21
Forces double precision:

1
2
22
23
help , i m s l _ b i n o m i a l c o e f (1000 , 20)

help , i m s l _ b i n o m i a l c o e f (1000 , 20 , / double )
24
25
26
FLOAT
DOUBLE
=
=
inf
3 . 3 9 4 8 2 8 1 e+41
27
28
29
30
implementation details: this routine is a wrapper to the GSLs gsl_sf_choose() function

[2]
31
32
33
disclaimer: the name of this GDL routine includes the IMSL_ prefix for compatibility with
IDL, it has no ...
34
35
36
IMSL_CONSTANT() function
37
keywords: DOUBLE
39
38
40
41
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
p r i n t , U n i f i e d a t o m i c mass , amu . [ kg ] :
i m s l _ c o n s t a n t ( amu )
p r i n t , P r e s s u r e o f 1 s t a n d a r d a t m o s p h e r e [ Pa ] :
i m s l _ c o n s t a n t ( atm )
p r i n t , ||
imsl_constant ( StandardPressure )
p r i n t , A s t r o n o m i c a l u n i t [m ] :
i m s l _ c o n s t a n t ( AU )
p r i n t , " Avogadro s number [ 1 / mole ] :
i m s l _ c o n s t a n t ( Avogadro )
p r i n t , Boltzmann c o n s t a n t [ J /K ] :
i m s l _ c o n s t a n t ( Boltzman )
p r i n t , Speed o f l i g h t i n vacuum [m/ s ] :
imsl_constant ( C )
p r i n t , ||
imsl_constant ( Speedlight )
p r i n t , Base o f t h e n a t u r a l l o g a r i t h m [ 1 ] :
imsl_constant ( E )
p r i n t , C ha rge o f t h e e l e c t r o n [ C ] :
, $
, $
, $
, $
", $
, $
, $
, $
, $
, $
42
43
44
45
46
47
48
49
50
51
52
53
54
imsl_constant ( ElectronCharge )
p r i n t , Mass o f t h e e l e c t r o n [ kg ] :
imsl_constant ( ElectronMass )
p r i n t , The e n e r g y o f 1 e l e c t r o n v o l t , eV [ J ] :
imsl_constant ( ElectronVolt )
p r i n t , E u l e r M a s c h e r o n i ( gamma ) c o n s t a n t [ 1 ] :
imsl_constant ( Euler )
p r i n t , ||
i m s l _ c o n s t a n t ( Gamma )
p r i n t , Molar c h a r g e o f 1 F a r a d a y [ C/ mole ] :
i m s l _ c o n s t a n t ( Faraday )
print , Electromagnetic f i n e structure constant [ 1 ] :
imsl_constant ( FineStructure )
p r i n t , The m o l a r g a s c o n s t a n t [ J / mole /K ] :
i m s l _ c o n s t a n t ( Gas )
p r i n t , The g r a v i t a t i o n a l c o n s t a n t [ Nm2/ kg2 ] :
imsl_constant ( Gravity )
p r i n t , " P l a n c k s c o n s t a n t d i v i d e d by 2 p i [ J s ] :
i m s l _ c o n s t a n t ( Hbar )
p r i n t , The s t a n d a r d g a s volume [ m3 / mole ] :
imsl_constant ( PerfectGasVolume )
p r i n t , Pi [ 1 ] :
i m s l _ c o n s t a n t ( Pi )
p r i n t , " Planck s c o n s t a n t [ J s ] :
i m s l _ c o n s t a n t ( Planck )
p r i n t , Mass o f t h e p r o t o n [ kg ] :
i m s l _ c o n s t a n t ( ProtonMass )
p r i n t , " Rydberg s c o n s t a n t [ 1 /m ] :
i m s l _ c o n s t a n t ( Rydberg )
p r i n t , S t a n d a r d g r a v i t a t i o n a l a c c . on E a r t h [m/ s 2 ] :
imsl_constant ( StandardGravity )
p r i n t , S t e f a n Boltzmann r a d i a t i o n c o n s t . [W/K4/m2 ] :
imsl_constant ( StefanBoltzman )
p r i n t , T r i p l e p o i n t temperature f o r water [K ] :
imsl_constant ( WaterTriple )
U n i f i e d a t o m i c mass , amu . [ kg ] :
P r e s s u r e o f 1 s t a n d a r d a t m o s p h e r e [ Pa ] :
||
A s t r o n o m i c a l u n i t [m ] :
Avogadro s number [ 1 / mole ] :
, $
, $
, $
, $
, $
, $
, $
, $
", $
, $
, $
", $
, $
", $
, $
, $
, $
1 . 6 6 0 5 4 e 27
101325.
101325.
1 . 4 9 5 9 8 e+11
6 . 0 2 2 1 4 e+23
IMSL_ERF() function
T
F
A
R
Boltzmann c o n s t a n t [ J /K ] :
Speed o f l i g h t i n vacuum [m/ s ] :
||
Base o f t h e n a t u r a l l o g a r i t h m [ 1 ] :
Ch a rg e o f t h e e l e c t r o n [ C ] :
Mass o f t h e e l e c t r o n [ kg ] :
The e n e r g y o f 1 e l e c t r o n v o l t , eV [ J ] :
E u l e r M a s c h e r o n i (gamma) c o n s t a n t [ 1 ] :
||
Molar c h a r g e o f 1 F a r a d a y [ C/ mole ] :
Electromagnetic f i n e structure constant [ 1 ] :
The m o l a r g a s c o n s t a n t [ J / mole /K ] :
The g r a v i t a t i o n a l c o n s t a n t [ Nm2/ kg2 ] :
P l a n c k s c o n s t a n t d i v i d e d by 2 p i [ J s ] :
The s t a n d a r d g a s volume [ m3 / mole ] :
Pi [ 1 ] :
Planck s c o n s t a n t [ J s ] :
Mass o f t h e p r o t o n [ kg ] :
Rydberg s c o n s t a n t [ 1 /m ] :
S t a n d a r d g r a v i t a t i o n a l a c c . on E a r t h [m/ s 2 ] :
S t e f a n Boltzmann r a d i a t i o n c o n s t . [W/K4/m2 ] :
T r i p l e p o i n t temperature f o r water [K ] :
1 . 3 8 0 6 5 e 23
2 . 9 9 7 9 2 e+08
2 . 9 9 7 9 2 e+08
2.71828
1 . 6 0 2 1 8 e 19
9 . 1 0 9 3 8 e 31
1 . 6 0 2 1 8 e 19
0.57722
0.57722
96485.3
0.00730
8.31447
6 . 6 7 3 0 0 e 11
1 . 0 5 4 5 7 e 34
0.02271
3.14159
6 . 6 2 6 0 7 e 34
1 . 6 7 2 6 2 e 27
1 . 0 9 7 3 7 e+07
9.80665
5 . 6 7 0 4 0 e 08
273.160
1
2
3
4
5
6
7
8
55
c = [ 1 ,2 ,3 , 4]
x = 1 + f i n d g e n ( 1 0 0 ) / 40
d e v i c e , / c o l o r , / decomposed
p l o t , x , c [ 0 ] + c [ 1 ] x + c [ 2 ] x ^2 + c [ 3 ] x ^3 , $
x t i t l e =X , y t i t l e =Y , t h i c k =3
o p l o t , x , r e p l i c a t e ( 0 , n _ e l e m e n t s ( x ) ) , c o l o r = f f 0 0 0 0 x
f o r e a c h z , i m s l _ z e r o p o l y ( c ) do $
p l o t s , z , 0 . , psym =6 , t h i c k =3 , c o l o r = 0000 f f x
implementation details: this routine uses the GSLs constants catalogue [2], the unit conversion is implemented using the UDUNITS-2 library
IDL, it has no ...
IMSL_ERF() function
keywords: DOUBLE, INVERSE
implementation details: this routine is a wrapper to the GSLs gsl_poly_complex_solve()

function [2]
IDL, it has no ...
IMSL_ZEROPOLY() function
keywords: COMPANION, DOUBLE, JENKINS_TRAUB
IMSL_ZEROSYS() function
56
T
F
A
R
keywords: DOUBLE, ERR_REL, FNORM, ITMAX, JACOBIAN, XGUESS
INDGEN() function
keywords: BYTE, COMPLEX, DCOMPLEX, DOUBLE, FLOAT, L64, LONG, STRING,
TYPE, UINT, UL64, ULONG
INTARR() function
keywords: NOZERO
INTERPOL() function
JOURNAL procedure
keywords: none
KEYWORD_SET() function
keywords: none
KURTOSIS() function
keywords: DOUBLE, NAN
L64INDGEN() function
keywords: LSQUADRATIC, QUADRATIC, SPLINE
INTERPOLATE() function
keywords: CUBIC, GRID, MISSING
INVERT() function
keywords: DOUBLE
keywords: none
LAGUERRE() function
keywords: COEFFICIENTS, DOUBLE
LAST_ITEM() function
keywords: none
ISHFT() function
LA_TRIRED procedure
keywords: _EXTRA
keywords: DOUBLE, UPPER
LEGENDRE() function
LEGENDRE() function
keywords: DOUBLE
T
F
A
R
57
LOADCT procedure
keywords: BOTTOM, FILE, GET_NAMES, NCOLORS, SILENT
LINDGEN() function
keywords: none
LINKIMAGE procedure
keywords: none
Loads a colour table that defines the RGB values corresponding to given colour indices (used
when a plotting terminal is not set to the decomposed mode). The first argument may be
used to chose from one of the 41 predefined colour tables, see example below for a graphical
list of the colour predefined tables.
1
2
see also: CALL_EXTERNAL()
$ cat l i s t c t . pro
listct
LL_ARC_DISTANCE() function
keywords: DEGREES
Snyder [eqs. 5-5 and 5-6 in 5]
LMGR() function

keywords: CLIENTSERVER, DEMO, EMBEDDED, EXPIRE_DATE, FORCE_DEMO,
INSTALL_NUM, LMHOSTID, RUNTIME, SITE_NOTICE, STUDENT, TRIAL,
VM
LNGAMMA() function
keywords: DOUBLE
pro l i s t c t
! X . STYLE=5
! Y . STYLE=5
! P . MULTI = [ 0 , 3 , 1 4 ]
! X . MARGIN= [ 1 0 , 0 ]
! Y . MARGIN= [ 1 , 0 ]
device , / color
f o r i =0, 40 do b e g i n
loadct , i , / s i l e n t
c o n t o u r , [ [ i n d g e n ( 2 5 5 ) ] , [ i n d g e n ( 2 5 5 ) ] ] , n l e v e l s =256 , / f i l l
x y o u t s , 77 , . 5 , s t r m i d ( i , 2 )
endfor
end
% C o m p i l e d module : LISTCT .
58
T
F
A
R
GET_NAMES keyword
When set to a variable, a list of colour table names (string array) is assigned to that variable.
1
2
3
l o a d c t , get_names=names
f o r i =0 , n _ e l e m e n t s ( names)1 do $
p r i n t , i , names [ i ] , f o r m a t =(%"%d : %s " )
0 : BW LINEAR
1 : BLUE/WHITE
2 : GRNREDBLUWHT
3 : RED TEMPERATURE
4 : BLUE/GREEN/RED/YELLOW
5 : STD GAMMA I I
6 : PRISM
7 : REDPURPLE
8 : GREEN/WHITE LINEAR
9 : GRN/WHT EXPONENTIAL
1 0 : GREENPINK
1 1 : BLUERED
12:
13:
14:
15:
16:
17:
18:
19:
20:
21:
22:
23:
24:
25:
26:
27:
28:
29:
30:
31:
32:
33:
34:
35:
36:
37:
38:
39:
40:
16 LEVEL
RAINBOW
STEPS
BOW SPECIAL
Haze
B l u e P a s t e l Red
Pastels
Hue S a t L i g h t n e s s 1
Hue S a t L i g h t n e s s 2
Hue S a t V a l u e 1
Hue S a t V a l u e 2
P u r p l e Red + S t r i p e s
Beach
Mac S t y l e
Eos A
Eos B
Hardcandy
Nature
Ocean
Peppermint
Plasma
BlueRed
Rainbow
B l u e Waves
Volcano
Waves
Rainbow18
Rainbow + w h i t e
Rainbow + b l a c k
LOADCT_INTERNALGDL procedure
keywords: GET_NAMES
LOCALE_GET() function
LOGICAL_AND() function
keywords: none
T
F
A
R
59
LONG() function
keywords: none
LOGICAL_AND() function
keywords: none
LOGICAL_OR() function
keywords: none
LOGICAL_TRUE() function
keywords: none
LONG64() function
keywords: none
LUDC procedure
keywords: COLUMN, DOUBLE, INTERCHANGES
LUSOL() function
keywords: COLUMN, DOUBLE
MACHAR() function

keywords: DOUBLE
LON64ARR() function
MAGICK_ADDNOISE procedure
keywords: NOZERO
keywords: GAUSSIANNOISE, IMPULSENOISE, LAPLACIANNOISE, MULTIPLICATIVEGAUSSIANNOISE, NOISE, POISSONNOISE, UNIFORMNOISE
LONARR() function
MAGICK_CLOSE procedure
keywords: NOZERO
keywords: none
60
T
F
A
R
MAGICK_COLORMAPSIZE() function
MAGICK_INTERLACE procedure
keywords: none
keywords: LINEINTERLACE, NOINTERLACE, PLANEINTERLACE
MAGICK_COLUMNS() function
keywords: none
MAGICK_MAGICK() function
keywords: none
MAGICK_CREATE() function
keywords: none
MAGICK_MATTE procedure
keywords: none
MAGICK_DISPLAY procedure
keywords: none
MAGICK_OPEN() function
keywords: none
MAGICK_EXISTS() function

keywords: none
MAGICK_FLIP procedure
keywords: none
MAGICK_PING() function
keywords: CHANNELS, DIMENSIONS, GAUSSIANNOISE, HAS_PALETTE, IMAGE_INDEX, IMPULSENOISE, INFO, LAPLACIANNOISE, MULTIPLICATIVEGAUSSIANNOISE, NOISE, NUM_IMAGES, PIXEL_TYPE, POISSONNOISE, TYPE,
UNIFORMNOISE
MAGICK_INDEXEDCOLOR() function
MAGICK_QUALITY procedure
keywords: none
keywords: none
MAGICK_QUANTIZE procedure
T
F
A
R
MAGICK_QUANTIZE procedure
MAGICK_WRITEFILE procedure
keywords: DITHER, GRAYSCALE, TRUECOLOR, YUV
keywords: none
MAGICK_READ() function
MAGICK_WRITEINDEXES procedure
keywords: MAP, RGB, SUB_RECT
keywords: none
MAGICK_READCOLORMAPRGB procedure
keywords: none
MAGICK_READINDEXES() function
keywords: none
MAKE_ARRAY() function
keywords: BYTE, COMPLEX, DCOMPLEX, DIMENSION, DOUBLE, FLOAT, INDEX,
INTEGER, L64, LONG, NOZERO, OBJ, PTR, SIZE, STRING, TYPE, UINT,
UL64, ULONG, VALUE
MAP_CLIP_SET procedure
MAGICK_ROWS() function
keywords: none
MAGICK_WRITE procedure
keywords: RGB
61

keywords: CLIP_PLANE, CLIP_UV, RESET, SPLIT, TRANSFORM
MAP_CONTINENTS procedure

keywords: COLOR, COUNTRIES, FILL_CONTINENTS, HIRES, RIVERS
Wessel and Smith [7]
MAGICK_WRITECOLORTABLE procedure
MATRIX_MULTIPLY() function
keywords: none
keywords: ATRANSPOSE, BTRANSPOSE
62
T
F
A
R
MAX() function
MOMENT() function
keywords: DIMENSION, MIN, NAN, SUBSCRIPT_MIN
keywords: DOUBLE, MAXMOMENT, MDEV, NAN, SDEV
MEAN() function
NCDF_ATTCOPY() function
MEANABSDEV() function
MEDIAN() function
keywords: DIMENSION, DOUBLE, EVEN
MEMORY() function
keywords: CURRENT, HIGHWATER, L64, NUM_ALLOC, NUM_FREE, STRUCTURE
MESSAGE procedure
keywords: IN_GLOBAL, OUT_GLOBAL
NCDF_ATTDEL procedure
keywords: GLOBAL
NCDF_ATTGET procedure
keywords: GLOBAL
NCDF_ATTINQ() function
keywords: GLOBAL
NCDF_ATTNAME() function
keywords: CONTINUE, INFORMATIONAL, IOERROR, NONAME, NOPREFIX, NOPRINT, RESET, TRACEBACK
keywords: GLOBAL
MIN() function
NCDF_ATTPUT procedure
keywords: DIMENSION, MAX, NAN, SUBSCRIPT_MAX
keywords: BYTE, CHAR, DOUBLE, FLOAT, GLOBAL, LENGTH, LONG, SHORT
NCDF_ATTRENAME procedure
T
F
A
R
NCDF_ATTRENAME procedure
NCDF_DIMRENAME procedure
keywords: GLOBAL
keywords: none
NCDF_CLOSE procedure
keywords: none
NCDF_EXISTS() function
keywords: none
NCDF_CONTROL procedure
keywords: ABORT, ENDEF, FILL, NOFILL, NOVERBOSE, OLDFILL, REDEF, SYNC,
VERBOSE
NCDF_CREATE() function
keywords: CLOBBER, NOCLOBBER
NCDF_DIMDEF() function
keywords: UNLIMITED
NCDF_DIMID() function
keywords: none
63
p r i n t , GDL c o m p i l e d w i t h netCDF s u p p o r t :
+ ( n c d f _ e x i s t s ( ) ? y e s : no )
GDL c o m p i l e d w i t h netCDF s u p p o r t : y e s
NCDF_INQUIRE() function
keywords: none
NCDF_OPEN() function
keywords: NOWRITE, WRITE
NCDF_VARDEF() function
keywords: BYTE, CHAR, DOUBLE, FLOAT, LONG, SHORT
NCDF_DIMINQ procedure
NCDF_VARGET procedure
keywords: none
keywords: COUNT, OFFSET, STRIDE
64
T
F
A
R
NCDF_VARGET1 procedure
NORM() function
keywords: OFFSET
keywords: DOUBLE
NCDF_VARID() function
keywords: none
N_ELEMENTS() function
keywords: none
N_PARAMS() function
NCDF_VARINQ() function
keywords: none
keywords: none
N_TAGS() function
NCDF_VARPUT procedure
keywords: DATA_LENGTH, LENGTH
keywords: COUNT, OFFSET, STRIDE
OBJARR() function
NCDF_CONTROL with SYNC to force...
keywords: NOZERO
NCDF_VARRENAME procedure
keywords: none
NEWTON() function
keywords: DOUBLE, HYBRID, ITMAX, TOLF, TOLX
Galassi et al. [2]
OBJ_CLASS() function
keywords: COUNT, SUPERCLASS
Returns the name of the class of an object passed as the first argument.
SUPERCLASS keyword
Returns instead an array of all direct superclasses of the object passed as the first argument.
In this case the first argument may be a string defining the object name.
OBJ_DESTROY procedure
COUNT keyword
T
F
A
R
OBJ_DESTROY procedure
Allows to pass a reference to a variable into which the number of direct superclasses will be
stored.
1
2
3
4
5
$ t a i l __define . pro
b o t t l e = obj_new ( b e e r )
print , bottle i s a [ n ] , obj_class ( bottle )
s p r = o b j _ c l a s s ( b e e r , / s u p e r c l a s s , c o u n t=c n t )
p r i n t , b e e r h a s , s t r t r i m ( cnt , 2 ) , d i r e c t s u p e r c l a s s [ e s ] :
==> a l c o h o l i c _ d r i n k _ _ d e f i n e . p r o <==
pro a l c o h o l i c _ d r i n k _ _ d e f i n e
struct = { alcoholic_drink , proof : 0 , i n h e r i t s drink }
end

OBJ_ISA() function
, s t r j o i n ( spr , , )
keywords: none
OBJ_NEW() function
==> b e e r _ _ d e f i n e . p r o <==
pro beer__define
s t r u c t = { beer , i n h e r i t s a l c o h o l i c _ d r i n k }
end
==> d r i n k _ _ d e f i n e . p r o <==
pro drink__define
s t r u c t = { d r i n k , c o l o r : 0}
end
% C o m p i l e d module : BEER__DEFINE .
% C o m p i l e d module : ALCOHOLIC_DRINK__DEFINE .
% C o m p i l e d module : DRINK__DEFINE .
b o t t l e i s a [ n ] BEER
b e e r h a s 1 d i r e c t s u p e r c l a s s [ e s ] : ALCOHOLIC_DRINK
A list of all known classes is returned if

1
2
3
classes = obj_class ()
help , c l a s s e s
print , classes
CLASSES
STRING
=
! PLT !GNUDATALANGUAGE ! AXIS
IDL_MEMORY64 MACHAR DMACHAR
65

Beware that values of object fields may only be initialised in the constructor, and not while
defining the object structure, i.e.:
1
2
3
$ cat test__ define . pro

a = obj_new ( t e s t )
a>p r i n t X Y
pro t e s t : : printXY
print , s e l f . x , s e l f . y
end
function test : : i n i t
called without any argument:
s e l f . x = 10
return , 1
end
pro t est__define
s t r u c t = { t e s t , x : 5 , y : 5}
end
Array [ 2 4 ]
% !CCPU
o m p i!WARN
l e d module
: TEST__DEFINE
.
! VERSION !MOUSE !ERROR_STATE ! VALUES !MAP
!USERSYM
IDL_SIZE FSTAT64
FSTAT FILE_INFO IDL_MEMORY
10
0 ! DEVICE
WIDGET_BUTTON WIDGET_DROPLIST WIDGET_TEXT WIDGET_VERSION
66
T
F
A
R
OBJ_VALID() function
keywords: CAST, COUNT
ON_ERROR procedure
keywords: none
OPENR procedure
keywords: APPEND, BINARY, BLOCK, BUFSIZE, COMPRESS, DELETE, ERROR,

F77_UNFORMATTED, GET_LUN, MORE, NOAUTOMODE, STDIO, STREAM,
SWAP_ENDIAN,
SWAP_IF_BIG_ENDIAN,
SWAP_IF_LITTLE_ENDIAN,
VAX_FLOAT, WIDTH, XDR
OPENW procedure
SWAP_ENDIAN,
SWAP_IF_BIG_ENDIAN,
SWAP_ENDIAN,
SWAP_IF_BIG_ENDIAN,
COMPRESS keyword
1
2
3
4
5
6
7
8
$ e c h o "GDL r o c k s ! " > f i l e . t x t

$ g z i p f f i l e . t x t
op e n r , u , f i l e . t x t . gz , / g e t _ l u n , / c o m p r e s s
s =
readu , u , s
free_lun , u
print , s
$ rm f i l e . t x t . gz
GDL r o c k s !
OPENU procedure
OPLOT procedure
keywords: CLIP, COLOR, LINESTYLE, MAX_VALUE, MIN_VALUE, NOCLIP, NSUM,
POLAR, PSYM, SYMSIZE, T3D, THICK
PARSE_URL() function
keywords: none
Returns a structure describing components of the URL passed as an argument, e.g.:
h e l p , p a r s e _ u r l ( h t t p : / / r o o t : qwerty@kgb . r u : 6 6 6 / ? hack ) , / s t r u

SCHEME
STRING
http
USERNAME
STRING
root
PASSWORD
STRING
qwerty
HOST
STRING
kgb . ru
PORT
STRING
666
PATH
STRING
/
QUERY
STRING
hack
PATH_SEP() function
PATH_SEP() function
T
F
A
R
1

keywords: PARENT_DIRECTORY, SEARCH_PATH, TEST
2
3
4
5
6
PLOT procedure
keywords: BACKGROUND, CHARSIZE, CHARTHICK, CLIP, COLOR, DATA, DEVICE, LINESTYLE, MAX_VALUE, MIN_VALUE, NOCLIP, NODATA, NOERASE,
NORMAL, POSITION, PSYM, SUBTITLE, SYMSIZE, THICK, TICKLEN, TITLE, XCHARSIZE, XLOG, XMARGIN, XMINOR, XRANGE, XSTYLE, XTHICK,
XTICKFORMAT, XTICKLEN, XTICKS, XTITLE, XTYPE, YCHARSIZE, YLOG,
YMARGIN, YMINOR, YNOZERO, YRANGE, YSTYLE, YTHICK, YTICKFORMAT,
YTICKLEN, YTICKS, YTITLE, YTYPE, ZCHARSIZE, ZGRIDSTYLE, ZMARGIN,
ZMINOR, ZRANGE, ZSTYLE, ZTHICK, ZTICKFORMAT, ZTICKLEN, ZTICKS,
ZTITLE, ZVALUE
67
arr = indgen (4 ,4)

fmt = ( 4 I 3 )
p r i n t , PM
pm , a r r , f o r m a t=fmt
p r i n t , PRINT :
p r i n t , a r r , f o r m a t=fmt
PM
0 4
1 5
2 6
3 7
PRINT :
0 1
4 5
8 9
12 13
8
9
10
11
12
13
14
15
2 3
6 7
10 11
14 15
see also: ORDER keyword in TV, TVRD(), ... (TODO: section on # and ## ops.)
PLOTERR procedure
keywords: BAR_COLOR, HAT, HELP, LENGTH_OF_HAT, PSYM, TEST, TYPE,
XLOG, XRANGE, YLOG, YRANGE, _EXTRA
PLOTS procedure
keywords: CLIP, COLOR, CONTINUE, DATA, DEVICE, LINESTYLE, NOCLIP, NORMAL, PSYM, SYMSIZE, T3D, THICK
PM procedure

keywords: FORMAT, TITLE
POINT_LUN procedure
keywords: none
POLY() function
keywords: none
POLYFILL procedure
keywords: CLIP, COLOR, DATA, DEVICE, LINESTYLE, LINE_FILL, NOCLIP, NORMAL, ORIENTATION, SPACING, THICK
68
T
F
A
R
POLY_2D() function
keywords: CUBIC, MISSING
POLY_AREA() function
keywords: DOUBLE, SIGNED
POPD procedure
keywords: none
PREWITT() function
keywords: HELP
PRIMES() function
keywords: none
PRINT procedure

keywords: AM_PM, DAYS_OF_WEEK, FORMAT, MONTH, STDIO_NON_FINITE
PRINTD procedure

keywords: none
PRINTF procedure

PRODUCT() function
keywords: CUMULATIVE, INTEGER, NAN, PRESERVE_TYPE
PTRARR() function
keywords: ALLOCATE_HEAP, NOZERO
PTR_FREE procedure

keywords: none
PTR_FREE can also be used to deallocate a variable:
1
2
3
a = 1
p t r _ f r e e , ptr_new ( a , / no_copy )
help , a
UNDEFINED = <U n d e f i n e d >
see also: PTR_NEW(), PTR_VALID()
PTR_NEW() function
T
F
A
R
PY_PLOT procedure
PTR_NEW() function
keywords: ALLOCATE_HEAP, NO_COPY
keywords: GRID, TITLE, XLABEL, YLABEL
PTR_VALID() function
PY_PRINT procedure
keywords: none
keywords: CAST, COUNT
QUERY_BMP() function
PUSHD procedure
keywords: none
keywords: none
1
2
PYTHON procedure
3
4

keywords: ARGV
PYTHON() function

keywords: ARGV, DEFAULTRETURNVALUE
Executes a python function whose name is specified using the second argument, the first
argument defines the package (e.g. numpy). All other argument are passed as positional
arguments to the function.
1
p r i n t , p y t h o n ( numpy ,
0.0000000
arange , 4 . )
1.0000000
$ wget q u i e t h t t p : / / w i k i p e d i a . o r g / f a v i c o n . i c o
$ c o n v e r t f a v i c o n . i c o f a v i c o n . bmp
ok = query_bmp ( f a v i c o n . bmp , i n f o )
i f ok t h e n h e l p , i n f o , / s t r u c t u r e e l s e p r i n t , q u e r y f a i l e d !
$ rm f a v i c o n .
% C o m p i l e d module : QUERY_BMP.
CHANNELS
LONG
4
DIMENSIONS
LONG
Array [ 2 ]
HAS_PALETTE
INT
0
IMAGE_INDEX
LONG
0
NUM_IMAGES
LONG
1
PIXEL_TYPE
INT
1
TYPE
STRING
BMP
QUERY_DICOM() function
2.0000000
3.0000000
keywords: none
69
70
T
F
A
R
QUERY_GIF() function
keywords: none
QUERY_IMAGE() function
QUERY_JPEG() function
keywords: none
QUERY_PICT() function
keywords: none
QUERY_PNG() function
keywords: none
QUERY_PPM() function
keywords: none
RADON() function
keywords: BACKPROJECT, DOUBLE, DRHO, DX, DY, GRAY, LINEAR, NRHO,
NTHETA, NX, NY, RHO, RMIN, THETA, XMIN, YMIN
RANDOMN() function
keywords: BINOMIAL, DOUBLE, GAMMA, LONG, NORMAL, POISSON, UNIFORM
RANDOMU() function
keywords: BINOMIAL, DOUBLE, GAMMA, LONG, NORMAL, POISSON, UNIFORM
READ procedure

keywords: AM_PM, DAYS_OF_WEEK, FORMAT, MONTH, PROMPT
READF procedure

keywords: AM_PM, DAYS_OF_WEEK, FORMAT, MONTH, PROMPT
READS procedure

keywords: AM_PM, DAYS_OF_WEEK, FORMAT, MONTH
QUERY_TIFF() function
READU procedure
keywords: IMAGE_INDEX

keywords: TRANSFER_COUNT
READ_ASCII() function
READ_ASCII() function
T
F
A
R
keywords: COMMENT_SYMBOL, COUNT, DATA_START, DELIMITER, HEADER,
HELP, MISSING_VALUE, NUM_RECORDS, RECORD_START, TEMPLATE,
TEST, VERBOSE
71
READ_PICT procedure
keywords: none
READ_PNG() function
READ_BINARY() function
keywords: HELP, ORDER, TEST, TRANSPARENT, VERBOSE
keywords: DATA_DIMS, DATA_START, DATA_TYPE, ENDIAN, TEMPLATE
READ_TIFF() function
READ_BMP() function
keywords: CHANNELS, GEOTIFF, IMAGE_INDEX, INTERLEAVE, ORIENTATION,
PLANARCONFIG, SUB_RECT, VERBOSE
keywords: RGB
READ_DICOM() function
keywords: IMAGE_INDEX
READ_GIF procedure
keywords: DEBUG, HELP, TEST
READ_XWD() function
keywords: none
REAL_PART() function
keywords: none
REBIN() function
keywords: SAMPLE
READ_JPEG procedure
keywords: BUFFER, COLORS, DEBUG, DITHER, GRAYSCALE, HELP, ORDER,
TEST, TRUE, TWO_PASS_QUANTIZE, UNIT
RECALL_COMMANDS() function
keywords: none
72
T
F
A
R
REFORM() function
keywords: OVERWRITE
REPLICATE() function
keywords: none
RK4() function
keywords: DOUBLE, ITER
RK4JMG() function
keywords: DOUBLE
REPLICATE_INPLACE procedure
keywords: none
ROBERTS() function
keywords: HELP
RESOLVE_ROUTINE procedure
keywords: none
RESTORE procedure
keywords: DESCRIPTION, FILENAME, RELAXED_STRUCTURE_ASSIGNMENT, RESTORED_OBJECTS, VERBOSE
RETALL procedure

keywords: RETALL
REVERSE() function
keywords: OVERWRITE
ROTATE() function
keywords: none
ROUND() function
keywords: L64
ROUTINE_INFO() function
keywords: DISABLED, ENABLED, FUNCTIONS, PARAMETERS, SYSTEM
ROUTINE_NAMES() function
T
F
A
R
ROUTINE_NAMES() function
$MAIN$ A_FUNCTION A_PROCEDURE

keywords: ARG_NAME, FETCH, LEVEL, STORE, S_FUNCTIONS, S_PROCEDURES,
VARIABLES
ROUTINE_NAMES can be invoked in several other ways, which are detailed below together
with keyword descriptions.
Examines variables and parameters of procedures and the call stack Using ROUTINE_NAMES a subroutine can interrogate, and in some cases change, the values and
names of variables and parameters in its calling routine, or at the $MAIN$ level.
ROUTINE_NAMES uses a notion of the current "call level," which is the numerical stack
depth of the currently executing routine. At each procedure or function call, the call level
becomes one deeper, and upon each RETURN, the call level becomes one shallower. The
call stack always begins at the $MAIN$ level. The current call stack can always be printed
by executing HELP.
When specifying the call level to ROUTINE_NAMES, one can use one of two numbering
systems, depending on whichever is most convenient. In the absolute numbering system,
the $MAIN$ level starts at number 1, and becomes deeper with increasing numbers. In the
relative numbering system, the current (deepest) call level is number 0, and becomes shallower with more negative numbers. Hence, if the deepest level is N, then the correspondence
is thus:
VALUE
MEANING
1 or -N+1 $MAIN$ level
2 or -N+2 NEXT deeper level
...
...
N or 0
DEEPEST (currently executing) level
S_PROCEDURES keyword
The lists of system procedures is returned, as a string array. The list does not cover procedures
written in GDL itself which are also part of GDLs routine library (e.g. WRITE_PNG).
2
3
$ cat l i b r a r y . pro
. compile l i b r a r y . pro
print , routine_names ()
pro a_procedure
print , Hello world !
end
function a_function
return , Hello world !
end
% C o m p i l e d module : A_PROCEDURE .
% C o m p i l e d module : A_FUNCTION .
p r i n t , ( routine_names (/ s_pro ) ) [ 0 : 5 ]
AXIS BYTEORDER CALDAT CALL_METHOD CALL_PROCEDURE CATCH
S_FUNCTIONS keyword
The lists of system functions is returned, as a string array. The list does not cover functions
written in GDL itself which are also part of GDLs routine library (e.g. READ_PNG()).
help , routine_names (/ s _ f u n c t i o n s )
When called without any keyword ROUTINE_NAMES returns a string array containing a
list of currently compiled functions and procedures, e.g.:
1
73
STRING
= Array [ 25 0]
LEVEL keyword
The call level of the calling routine is returned, e.g.:
1
2
$ cat func . pro

p r i n t , routine_names (/ l e v e l ) , func ( )
function func
return , routine_names (/ l e v e l )
end
% C o m p i l e d module : FUNC .
1
2
74
T
F
A
R
FETCH keyword
ARG_NAME keyword
The value of a variable which name is passed in the first argument (string) at call level specified with the FETCH keyword is returned. If the value is undefined, then the assignment
will cause an error. Therefore, the only safe way to retrieve a value is by using a variant of
the following:
The names of variables passed as positional arguments at call level specified with the
ARG_NAME keyword are returned, as a string array. Note that the arguments passed
are the actual parameters, not strings containing their names. All of the arguments must be
parameters that have been passed to the calling procedure. Variables that are unnamed at
the specified call level will return the empty string.
1
2
3
4
5
$ cat procedure . pro

a1 = 1
a2 = 2
a3 = [ 3 b ]
p r o c e d u r e , a1 , a2 , a3
2
3
% $MAIN$ : a i s n o t d e f i n e d !
% E x e c u t i o n h a l t e d a t : $MAIN$
p r o p r o c e d u r e , arg0 , arg1 , a r g 2
p r i n t , r o u t i n e _ n a m e s ( arg1 , arg2 , arg_name=0)
p r i n t , r o u t i n e _ n a m e s ( arg1 , arg2 , arg_name=1)
end
% C o m p i l e d module : PROCEDURE .
ARG1 ARG2
A2 A3
STORE keyword
The value specified with the second argument is stored into the variable which name is passed
in the first argument (string) at the call level specified with the STORE keyword. Note that
there is no way to cause the named variable to become undefined. The value returned can
be ignored.
1
2
VARIABLES keyword
The names of variables at call level specified with the VARIABLES keyword are returned, as
a string array, e.g.:
1
2
3
4
5
$ cat procedure . pro

s t r = Hello world !
a r r = [ Hello , world ,
int = 0
procedure
i f n _ e l e m e n t s ( r o u t i n e _ n a m e s ( a , f e t c h =0)) g t 0 $
t h e n v a l u e = r o u t i n e _ n a m e s ( a , f e t c h =0) $
e l s e message , a i s n o t d e f i n e d !
a = 1
dummy = r o u t i n e _ n a m e s ( a , 2 , s t o r e =0)
print , a
2
see also: ROUTINE_INFO(), ARG_PRESENT(), SCOPE_VARFETCH()
! ]
pro procedure
p r i n t , r o u t i n e _ n a m e s ( v a r i a b l e s =1)
end
% C o m p i l e d module : PROCEDURE .
STR ARR INT
disclaimer: Entry based on Craig Markwardts documentation for ROUTINE_NAMES:

Copyright (C) 2000, Craig Markwardt. This software is provided as is without any warranty whatsoever. Permission to use, copy, modify, and distribute modified or unmodified
copies is granted, provided this copyright and disclaimer are included unchanged.
RSTRPOS() function
keywords: none
SAVE procedure
SAVE procedure
T
F
A
R
SETENV procedure
keywords: ALL, APPEND, COMPATIBLE, DATA, ERRMSG, FILENAME, MTIMES,
NAMES, NOCATCH, PASS_METHOD, QUIET, STATUS, TEST, USEUNIT,
VARSTATUS, VERBOSE, XDR
keywords: none
SET_PLOT procedure
SCOPE_VARFETCH() function
keywords: LEVEL
SEM_CREATE() function
75
keywords: COPY, INTERPOLATE
SHIFT() function
keywords: DESTROY_SEMAPHORE
SEM_DELETE procedure
keywords: none
SEM_LOCK() function
keywords: none
keywords: none
SHOWFONT procedure
keywords: BASE, BEG, ENCAPSULATED, FIN, TT_FONT
Displays a table of fonts for a give font number (first argument) in the current graphics
terminal, e.g.:
s h o w f o n t , 3 , S i m p l e x Roman
SEM_RELEASE procedure
keywords: none
% C o m p i l e d module : SHOWFONT.
76
T
F
A
R
s h o w f o n t , 4 , S i m p l e x Greek
s h o w f o n t , 5 , D u p l e x Roman
SHOWFONT procedure
T
F
A
R
s h o w f o n t , 6 , Complex Roman
s h o w f o n t , 7 , Complex Greek
77
78
T
F
A
R
s h o w f o n t , 8 , Complex I t a l i c
s h o w f o n t , 9 , Math and S p e c i a l
SHOWFONT procedure
T
F
A
R
showfont , 11 , Gothic En g li s h
showfont , 12 , Simplex S c r i p t
79
80
T
F
A
R
s h o w f o n t , 1 3 , Complex S c r i p t
showfont , 14 , Gothic I t a l i a n
SHOWFONT procedure
T
F
A
R
s h o w f o n t , 1 5 , G o t h i c German
showfont , 16 , C y r i l i c
81
82
T
F
A
R
s h o w f o n t , 1 7 , T r i p l e x Roman
showfont , 18 , T r i p l e x I t a l i c
SIN() function
T
F
A
R
SIN() function
keywords: none
showfont , 20 , M i s c e l l a n e o u s
SINDGEN() function
keywords: none
SINH() function
keywords: none
83
84
T
F
A
R
SIZE() function
keywords: DIMENSIONS, FILE_LUN, L64, N_DIMENSIONS, N_ELEMENTS, STRUCTURE, TNAME, TYPE
SORT() function
keywords: L64
SPAWN procedure
SKEWNESS() function
keywords: COUNT, EXIT_STATUS, NOSHELL, PID, SH, UNIT
SPHER_HARM() function
SKIP_LUN procedure
keywords: DOUBLE
keywords: EOF, HELP, LINES, TEST, TRANSFER_COUNT
SPL_INIT() function
SMOOTH() function
keywords: EDGE_TRUNCATE, HELP, NAN, TEST, VERBOSE
SOBEL() function
keywords: HELP
SOCKET procedure
keywords: CONNECT_TIMEOUT, ERROR, GET_LUN, READ_TIMEOUT, STDIO,
SWAP_ENDIAN, SWAP_IF_BIG_ENDIAN, SWAP_IF_LITTLE_ENDIAN, WIDTH,
WRITE_TIMEOUT
keywords: DOUBLE, HELP, YP0, YPN_1
SPL_INIT_OLD() function
keywords: DEBUG, DOUBLE, YP0, YPN_1
SPL_INTERP() function
keywords: DOUBLE, HELP
SPL_INTERP_OLD() function
keywords: DOUBLE
SQRT() function
SQRT() function
keywords: none
T
F
A
R
STREGEX() function
keywords: BOOLEAN, EXTRACT, FOLD_CASE, LENGTH, SUBEXPR
STDDEV() function
STRING() function

keywords: AM_PM, DAYS_OF_WEEK, FORMAT, MONTH, PRINT
PRINT keyword
STOP procedure
2
3

STRARR() function
keywords: NOZERO
STRCMP() function
keywords: FOLD_CASE
STRCOMPRESS() function
keywords: REMOVE_ALL
85
4
5
help
help
help
help
help
,
,
,
,
,
s t r i n g (55 b )
s t r i n g (55b , / p r i n t )
string ( findgen (2 ,2))
string ( findgen (2 ,2) , / print )
string ( findgen (2) , / print )
STRING
STRING
STRING
STRING
STRING
=
=
=
=
=
7
55
Array [2 , 2]
Array [ 2 ]
0.00000
STRJOIN() function
keywords: SINGLE
1
2
3
arr = [ a , b , c ]
str = strjoin ( arr )
help , arr , s t r
ARR
STR
STRING
STRING
= Array [ 3 ]
= abc
1.00000
86
1
2
3
4
5
T
F
A
R
arr = [ [ a , b , c ] , [ d ,
s t r = s t r j o i n ( a r r , )
help , arr , s t r
print , str [0]
print , str [1]
e ,
f ]]
STRMATCH() function
keywords: FOLD_CASE
STRMID() function
ARR
STR
abc
def
STRING
STRING
= Array [3 , 2]
= Array [ 2 ]
keywords: REVERSE_OFFSET
STRPOS() function
SINGLE keyword
1
2
3
arr = [ [ a , b , c ] , [ d , e ,
s t r = s t r j o i n ( arr , , / s i n g l e )
help , arr , s t r
f ]]
keywords: REVERSE_OFFSET, REVERSE_SEARCH
ARR
STR
STRING
STRING
= Array [3 , 2]
= abcdef
STRPUT procedure
keywords: none
STRLEN() function
keywords: none
STRLOWCASE() function
keywords: none
STRSPLIT() function
keywords: COUNT, ESCAPE, EXTRACT, FOLD_CASE, HELP, LENGTH, PRESERVE_NULL, REGEX, TEST
STRTOK() function
keywords: ESCAPE, EXTRACT, LENGTH, PRESERVE_NULL, REGEX
STRTRIM() function
STRTRIM() function
keywords: none
T
F
A
R
YTITLE, YTYPE, ZCHARSIZE, ZGRIDSTYLE, ZLOG, ZMARGIN, ZMINOR,

ZRANGE, ZSTYLE, ZTHICK, ZTICKFORMAT, ZTICKINTERVAL, ZTICKLAYOUT, ZTICKLEN, ZTICKNAME, ZTICKS, ZTICKUNITS, ZTICKV, ZTICK_GET,
ZTITLE, ZTYPE, ZVALUE
AX keyword
STRUCT_ASSIGN procedure
keywords: NOZERO, VERBOSE
1
2
3
4
STRUPCASE() function
keywords: none
STR_SEP() function
keywords: ESC, HELP, REMOVE_ALL, TEST, TRIM
. . . STR_SEP separates the string on any of the characters of the 2nd string. . . .
SURFACE procedure
keywords: AX, AZ, BACKGROUND, CHARSIZE, CHARTHICK, CLIP, COLOR,
DATA, DEVICE, FONT, LINESTYLE, MAX_VALUE, MIN_VALUE, NOCLIP, NODATA, NOERASE, NORMAL, POSITION, SUBTITLE, T3D, THICK,
TICKLEN, TITLE, XCHARSIZE, XGRIDSTYLE, XLOG, XMARGIN, XMINOR,
XRANGE, XSTYLE, XTHICK, XTICKFORMAT, XTICKINTERVAL, XTICKLAYOUT, XTICKLEN, XTICKNAME, XTICKS, XTICKUNITS, XTICKV, XTICK_GET,
XTITLE, XTYPE, YCHARSIZE, YGRIDSTYLE, YLOG, YMARGIN, YMINOR,
YRANGE, YSTYLE, YTHICK, YTICKFORMAT, YTICKINTERVAL, YTICKLAYOUT, YTICKLEN, YTICKNAME, YTICKS, YTICKUNITS, YTICKV, YTICK_GET,
87
! P . MULTI = [ 0 , 3 , 3 ]
d = d i s t (10)
f o r ax = 0 , 9 0 , 11 do $
s u r f a c e , d , ax=ax , t i t l e = ax = + s t r t r i m ( ax , 2 )
88
AZ keyword
1
2
3
4
T
F
A
R
! P . MULTI = [ 0 , 3 , 3 ]
d = d i s t (10)
f o r az = 0 , 9 0 , 11 do $
s u r f a c e , d , az=az , t i t l e = az = + s t r t r i m ( az , 2 )
SWAP_ENDIAN_INPLACE procedure
keywords: SWAP_IF_BIG_ENDIAN, SWAP_IF_LITTLE_ENDIAN
SYSTIME() function
keywords: JULIAN, SECONDS, UTC
TAG_NAMES() function
keywords: STRUCTURE_NAME
TAN() function
keywords: none
SVDC procedure
TANH() function
keywords: none
keywords: COLUMN, DOUBLE, ITMAX
SWAP_ENDIAN() function
TEMPLATE procedure
keywords: SWAP_IF_BIG_ENDIAN, SWAP_IF_LITTLE_ENDIAN

keywords: none
T
F
A
R
TRIGRID() function

keywords: none
keywords: MAP, MAX_VALUE, MISSING, NX, NY
TEMPORARY() function
keywords: none
TV procedure
keywords: CHANNEL, DATA, DEVICE, NORMAL, ORDER, TRUE, XSIZE, YSIZE
TVLCT procedure
TEST procedure
keywords: none
keywords: GET, HLS, HSV
TVRD() function
TOTAL() function
keywords: CHANNEL, ORDER, TRUE, WORDS
keywords: CUMULATIVE, DOUBLE, INTEGER, NAN, PRESERVE_TYPE
TVSCL procedure
TRACE() function
keywords: DOUBLE
89
keywords: NAN, _EXTRA
T_PDF() function
keywords: none
TRANSPOSE() function
UINDGEN() function
keywords: none
keywords: none
90
T
F
A
R
UINT() function
keywords: none
UINTARR() function
keywords: NOZERO
UL64INDGEN() function
keywords: none
ULINDGEN() function
keywords: none
ULON64ARR() function
keywords: NOZERO
ULONARR() function
keywords: NOZERO
ULONG64() function
keywords: none
UNIQ() function
keywords: none
USERSYM procedure
keywords: COLOR, FILL, THICK
VALUE_LOCATE() function
keywords: L64
VARIANCE() function
VOIGT() function
keywords: DOUBLE, ITER
ULONG() function
WAIT procedure
keywords: none
keywords: none
WDELETE procedure
WDELETE procedure
keywords: none
WHERE() function
T
F
A
R
keywords: COMPLEMENT, NCOMPLEMENT
see also: ARRAY_INDICES()
TAB_MODE, TOOLTIP, TRACKING_EVENTS, UNAME, UNITS,

VALUE, XOFFSET, XSIZE, X_BITMAP_EXTRA, YOFFSET, YSIZE
91
UVALUE,
WIDGET_CONTROL procedure
keywords: DESTROY,
EVENT_PRO,
FUNC_GET_VALUE,
GET_UVALUE,
GET_VALUE, MANAGED, MAP, NO_COPY, PRO_SET_VALUE, REALIZE, SENSITIVE, SET_BUTTON, SET_DROPLIST_SELECT, SET_UNAME,
SET_UVALUE, SET_VALUE, XMANAGER_ACTIVE_COMMAND
WIDGET_BASE() function
WIDGET_DROPLIST() function
keywords: ALIGN_BOTTOM,
ALIGN_CENTER,
ALIGN_LEFT,
ALIGN_RIGHT,
keywords: DYNAMIC_RESIZE, EVENT_FUNC, EVENT_PRO, FONT, FRAME,
ALIGN_TOP, BASE_ALIGN_BOTTOM, BASE_ALIGN_CENTER, BASE_ALIGN_LEFT,
FUNC_GET_VALUE, GROUP_LEADER, KILL_NOTIFY, NOTIFY_REALIZE,
BASE_ALIGN_RIGHT, BASE_ALIGN_TOP, COLUMN, CONTEXT_EVENTS,
NO_COPY, PRO_SET_VALUE, RESOURCE_NAME, SCR_XSIZE, SCR_YSIZE,
CONTEXT_MENU, DISPLAY_NAME, EVENT_FUNC, EVENT_PRO, EXSENSITIVE, TAB_MODE, TITLE, TRACKING_EVENTS, UNAME, UNITS,
CLUSIVE,
FLOATING,
FRAME,
FUNC_GET_VALUE,
GRID_LAYOUT,
UVALUE, VALUE, XOFFSET, XSIZE, YOFFSET, YSIZE
GROUP_LEADER, KBRD_FOCUS_EVENTS, KILL_NOTIFY, MAP, MBAR,
MODAL, NONEXCLUSIVE, NOTIFY_REALIZE, NO_COPY, PRO_SET_VALUE,
RESOURCE_NAME, RNAME_MBAR, ROW, SCROLL, SCR_XSIZE, SCR_YSIZE,
SENSITIVE, SPACE, TITLE, TLB_FRAME_ATTR, TLB_ICONIFY_EVENTS,
WIDGET_EVENT() function
TLB_KILL_REQUEST_EVENTS, TLB_MOVE_EVENTS, TLB_SIZE_EVENTS,
TOOLBAR, TRACKING_EVENTS, UNAME, UNITS, UVALUE, XOFFSET, XPAD,
XSIZE, X_SCROLL_SIZE, YOFFSET, YPAD, YSIZE, Y_SCROLL_SIZE
keywords: DESTROY, XMANAGER_BLOCK
WIDGET_BUTTON() function
keywords: ACCELERATOR,
ALIGN_CENTER,
ALIGN_LEFT,
ALIGN_RIGHT,
BITMAP, CHECKED_MENU, DYNAMIC_RESIZE, EVENT_FUNC, EVENT_PRO,
FONT, FRAME, FUNC_GET_VALUE, GROUP_LEADER, HELP, KILL_NOTIFY,
MENU, NOTIFY_REALIZE, NO_COPY, NO_RELEASE, PRO_SET_VALUE,
PUSHBUTTON_EVENTS, SCR_XSIZE, SCR_YSIZE, SENSITIVE, SEPARATOR,
WIDGET_INFO() function
keywords: CHILD, MANAGED, MODAL, VALID, VERSION, XMANAGER_BLOCK
92
T
F
A
R
WIDGET_LABEL() function
WRITE_GIF procedure
keywords: ALL_EVENTS,
CONTEXT_EVENTS,
EDITABLE,
EVENT_FUNC,
EVENT_PRO,
FONT,
FRAME,
FUNC_GET_VALUE,
GROUP_LEADER,
IGNORE_ACCELERATORS,
KBRD_FOCUS_EVENTS,
KILL_NOTIFY,
NOTIFY_REALIZE,
NO_COPY,
NO_NEWLINE,
PRO_SET_VALUE,
RESOURCE_NAME, SCROLL, SCR_XSIZE, SCR_YSIZE, SENSITIVE, TAB_MODE,
TRACKING_EVENTS, UNAME, UNITS, UVALUE, VALUE, WRAP, XOFFSET,
XSIZE, YOFFSET, YSIZE
keywords: BACKGROUND_COLOR,
CLOSE,
DEBUG,
DELAY_TIME,
DISPOSAL_METHOD, HELP, MULTIPLE, REPEAT_COUNT, TEST, TRANSPARENT, USER_INPUT
WIDGET_TEXT() function
keywords: ALL_EVENTS,
CONTEXT_EVENTS,
EDITABLE,
EVENT_FUNC,
EVENT_PRO,
FONT,
FRAME,
FUNC_GET_VALUE,
GROUP_LEADER,
IGNORE_ACCELERATORS,
KBRD_FOCUS_EVENTS,
KILL_NOTIFY,
NOTIFY_REALIZE,
NO_COPY,
NO_NEWLINE,
PRO_SET_VALUE,
RESOURCE_NAME, SCROLL, SCR_XSIZE, SCR_YSIZE, SENSITIVE, TAB_MODE,
TRACKING_EVENTS, UNAME, UNITS, UVALUE, VALUE, WRAP, XOFFSET,
XSIZE, YOFFSET, YSIZE
WRITE_JPEG procedure
keywords: DEBUG, HELP, ORDER, PROGRESSIVE, QUALITY, TEST, TRUE, UNIT
WRITE_PICT procedure
keywords: DEBUG, HELP, TEST
WRITE_PNG procedure
WINDOW procedure
keywords: COLORS, FREE, PIXMAP, RETAIN, TITLE, XPOS, XSIZE, YPOS, YSIZE
WRITEU procedure

keywords: TRANSFER_COUNT
keywords: DEBUG, HELP, ORDER, TEST, TRANSPARENT, VERBOSE
WSET procedure
keywords: none
WRITE_BMP procedure
WSHOW procedure
keywords: DEBUG, FOUR_BIT, HEADER_DEFINE, HELP, IHDR, RGB, TEST
keywords: none
WTN() function
WTN() function
T
F
A
R
keywords: COLUMN, DOUBLE, INVERSE, OVERWRITE
93
XYOUTS procedure
keywords: ALIGNMENT, CHARSIZE, CHARTHICK, CLIP, COLOR, DATA, DEVICE,
NOCLIP, NORMAL, ORIENTATION, WIDTH, Z
T
F
A
R
Part II
Developers guide
Chapter 16
T
F
A
R
General remarks and coding guidelines
... such as the CERN C++ Coding Standard Specification [4] or other similar documents.
Chapter 17
T
F
A
R
The library-routine API
TODO: extract it using Doxygen or some similar tool.
Chapter 18
T
F
A
R
Extending the documentation

LATEX
gdldoc.sty
Natbib:
Chapter 19
T
F
A
R
Extending the testsuite (testsuite/README)

The list of GDL routines to be executed during the make-check run is
defined in the testsuite/Makefile.am file. After adding a new item
(filename) to the list, please rerun "automake" being in the root
folder of the source tree. CMake also uses the list in Makefile.am.
Each test routine is invoked using the GDL "-e" command-line option
by the "try" shell script in the testsuite directory (and in an
analogous manner for the case of CMake/CTest). "make" decides
on the status of a test basing on the exit code of this script:
- "success" for exit code 0
- "ignorable failure" for code 77
- "failure" for any other exit code, e.g. 1
The "try" script should, in principle, exit with the GDL exit code.
Therefore, a failure of a GDL test should be indicated by e.g.:
if ( ...true if test failed... ) begin
message, reason for the failure, /continue
exit, status=1
endif
An ignorable failure can be indicated by e.g.:
if (!XXX_exists()) then begin

message, GDL was built w/o support for XXX - skipping, /conti
exit, status=77
endif
Any GDL error (e.g. parser error or library-routine-triggered error)

causing GDL to return to the $MAIN$ level will cause make to assume
_success_! (GDL exits normally in this case). Any GDL error causing
GDL to stop execution on an other-than-$MAIN$ level will bring the
GDL interpreter prompt.
The name of the file must match the name of the test routine, e.g.
testsuite/test_dummy.pro for
pro test_dummy
...
end
GDL segfaults, assertion-exits, std::terminate() exits, etc. are

handled as failures by make.
The "try" script always uses the gdl binary in the build tree not the one installed in the system. The "try" script also sets
appropriate env. variables so that the GDL-written library routines
are taken from the source tree as well (e.g. src/pro/mean.pro).
Regardless if the autotools or the CMake/CTest configuration
mechanism, the testsuite run is invoked by "make check" (not the
default CMakess "make test").
Chapter 20
T
F
A
R
A short overview of how GDL works internally

Programs (*.pro files) or command line input is parsed (GDLLexer.cpp, GDLParser.cpp
generated with ANTLR from gdlc.g). These results in an abstract syntax tree (AST)
consisting of DNode (dnode.hpp). This systax tree is further manipulated (compiled) with a tree parser (GDLTreeParser.cpp generated with ANTLR from gdlc.tree.g,
dcompiler.hpp). Here the AST is splitted into the different functions/procedures and
the DNode(s) are annotated with further information and converted to ProgNode(s).
Then these compiled (ProgNode) ASTs are interpreted (GDLInterpreter.cpp generated
with ANTLR from gdlc.i.g, dinterpreter.cpp).
Chapter 21
T
F
A
R
How to make use of OpenMP in GDL
Chapter 22
T
F
A
R
Notes for packagers
Optional features of PLplot and ImageMagick

The HDF4-netCDF conflict
T
F
A
R
Part III
Indices
T
F
A
R
Subject Index
T
F
A
R
.COMPILE, 17
.CONTINUE, 17
.STEP, 17
$MAIN$, 73
_EXTRA, 14
_REF_EXTRA, 14
_STRICT_EXTRA, 14
_EXTRA keyword
in ISHFT() function, 56
in PLOTERR procedure, 67
in TVSCL procedure, 89
_REF_EXTRA keyword
in CALL_FUNCTION() function, 38
in CALL_METHOD procedure, 38
in CALL_METHOD() function, 38
in CALL_PROCEDURE procedure, 38
in OBJ_DESTROY procedure, 65
in OBJ_NEW() function, 65
in QUERY_IMAGE() function, 70
abbreviated keyword names, 14

ABORT keyword
in NCDF_CONTROL procedure, 63
ABS() function, 18, 33
ACCELERATOR keyword
in WIDGET_BUTTON() function, 91
ACOS() function, 19, 33
ALIGN_BOTTOM keyword
in WIDGET_BASE() function, 91
ALIGN_CENTER keyword
ALIGN_LEFT keyword
ALIGN_RIGHT keyword
ALIGN_TOP keyword
ALIGNMENT keyword
in XYOUTS procedure, 93
ALL_DIRS keyword
in EXPAND_PATH() function, 43
ALL_EVENTS keyword
in WIDGET_LABEL() function, 92
in WIDGET_TEXT() function, 92
ALL_GDL keyword
in CALL_EXTERNAL() function, 36
ALL_VALUE keyword
ALL keyword
in CLOSE procedure, 39
in HDF_OPEN() function, 50
in SAVE procedure, 75
ALLOCATE_HEAP keyword
in PTR_NEW() function, 69
in PTRARR() function, 68
ALLOW_NONEXISTENT keyword
in FILE_DELETE procedure, 44
ALLOW_SAME keyword
in FILE_COPY procedure, 44
ALOG() function, 18, 33
ALOG10() function, 18, 33
AM_PM keyword
in PRINT procedure, 68
in PRINTF procedure, 68
in READ procedure, 70
in READF procedure, 70
in READS procedure, 70
in STOP procedure, 85
in STRING() function, 85
APPEND keyword
in OPENR procedure, 66
in OPENU procedure, 66
in OPENW procedure, 66
APPLEMAN procedure, 33
ARG_NAME keyword
in ROUTINE_NAMES() function, 73
ARG_PRESENT() function, 14, 34, 74
ARGV keyword
in PYTHON procedure, 69
in PYTHON() function, 69
ARRAY_EQUAL() function, 15, 34
ARRAY_INDICES() function, 15, 34, 52, 91
ARRAY keyword
ASIN() function, 19, 34
ASSOC() function, 12, 34
ATAN() function, 12, 19, 33, 34
ATRANSPOSE keyword
in MATRIX_MULTIPLY() function, 61
AX keyword
in SURFACE procedure, 87
AXIS procedure, 35
AXISprocedure, 23
AZ keyword
T
F
A
R
B_VALUE keyword
BACKGROUND_COLOR keyword
in WRITE_GIF procedure, 92
BACKGROUND keyword
in CONTOUR procedure, 39
in PLOT procedure, 67
BACKPROJECT keyword
in RADON() function, 70
BAR_COLOR keyword
BASE_ALIGN_BOTTOM keyword
BASE_ALIGN_CENTER keyword
BASE_ALIGN_LEFT keyword
BASE_ALIGN_RIGHT keyword
BASE_ALIGN_TOP keyword
BASE keyword
in SHOWFONT procedure, 75
BEG keyword
BEGIN, 14
in CASE statement, 13
in FOR statement, 13
in IF/THEN/ELSE statement, 12
in SWITCH statement, 13
in WHILE statement, 14
BESELI() function, 19, 35
BESELJ() function, 19, 35
BESELK() function, 19, 35
BESELY() function, 19, 35
BETA() function, 19, 35
BILINEAR() function, 35
BIN1 keyword
in HIST_2D() function, 52
BIN2 keyword
BINARY keyword
BINDGEN() function, 13, 15, 35
BINOMIAL keyword
in RANDOMN() function, 70
in RANDOMU() function, 70
BINSIZE keyword
in HISTOGRAM() function, 52
BITMAP keyword
BLOCK_SPECIAL keyword
in FILE_TEST() function, 45
BLOCK keyword
BOOLEAN keyword
in STREGEX() function, 85
BOTTOM keyword
in LOADCT procedure, 57
BREAK
in FOREACH statement, 13
in REPEAT statement, 14
BREAKDOWN_EPOCH keyword
in CDF_EPOCH procedure, 38
BRIEF keyword
in HELP procedure, 52
BROYDEN() function, 20, 35
BTRANSPOSE keyword
in MATRIX_MULTIPLY() function, 61
BUFFER keyword
in READ_JPEG procedure, 71
BUFSIZE keyword
BYTARR() function, 13, 15, 35
BYTE() function, 12, 13, 35
BYTE keyword
in HDF_SD_CREATE() function, 50
in INDGEN() function, 56
in MAKE_ARRAY() function, 61
in NCDF_ATTPUT procedure, 62
in NCDF_VARDEF() function, 63
BYTEORDER procedure, 36
BYTEORDERprocedure, 19, 21
BYTSCL() function, 23, 28, 36
C_CHARSIZE keyword
C_COLORS keyword
C_LINESTYLE keyword
cal (UNIX), 36
CALDAT procedure, 36
CALDATprocedure, 27
CALENDAR procedure, 36
CALENDARprocedure, 27
CALL_EXTERNAL() function, 31, 36, 57
CALL_FUNCTION() function, 14, 38
CALL_METHOD procedure, 38
CALL_METHOD() function, 14, 38
CALL_METHODprocedure, 14
CALL_METHON() function, 15
CALL_METHONprocedure, 15
CALL_PROCEDURE procedure, 38
CALL_PROCEDURE() function, 14
CALLS keyword
CANCEL keyword
105
106
T
F
A
R
in CATCH procedure, 38
in DIALOG_MESSAGE() function, 42
CASE, 13
CAST keyword
in OBJ_VALID() function, 66
in PTR_VALID() function, 69
CATCH procedure, 38
CATCHprocedure, 15
CD procedure, 38
CDF_EPOCH procedure, 38
CDprocedure, 25
CEIL() function, 18, 39
CENTER keyword
in CONGRID() function, 39
in CONVOL() function, 40
CHANGE keyword
in CURSOR procedure, 41
CHANNEL keyword
in TV procedure, 89
in TVRD() function, 89
CHANNELS keyword
in MAGICK_PING() function, 60
in READ_TIFF() function, 71
CHAR keyword
CHARACTER_SPECIAL keyword
CHARSIZE keyword
in AXIS procedure, 35
CHARTHICK keyword
CHECK_MATH() function, 15, 39

CHECK_MATHprocedure, 17
CHECKED_MENU keyword
CHILD keyword
in WIDGET_INFO() function, 91
CINDGEN() function, 13, 15, 39
CLASS keyword
in HDF_VD_GET procedure, 51
in HDF_VG_GETINFO procedure, 51
CLIENTSERVER keyword
in LMGR() function, 57
CLIP_PLANE keyword
in MAP_CLIP_SET procedure, 61
CLIP_UV keyword
CLIP keyword
in OPLOT procedure, 66
in PLOTS procedure, 67
in POLYFILL procedure, 67
CLOBBER keyword
in NCDF_CREATE() function, 63
CLOSE procedure, 39
CLOSE_FILE keyword
in DEVICE procedure, 41
CLOSE keyword
CLOSEprocedure, 21
COEFFICIENTS keyword
in LAGUERRE() function, 56
COLOR keyword
in MAP_CONTINENTS procedure, 61
Subject Index
in USERSYM procedure, 90
COLORS keyword
in WINDOW procedure, 92
COLUMN keyword
in LUDC procedure, 59
in LUSOL() function, 59
in SVDC procedure, 88
in WTN() function, 93
COMMAND_LINE_ARGS() function, 25, 39
COMMENT_SYMBOL keyword
in READ_ASCII() function, 71
COMPANION keyword
in IMSL_ZEROPOLY() function, 55
COMPATIBLE keyword
COMPLEMENT keyword
in WHERE() function, 91
complex numbers
magnitude, 18
COMPLEX() function, 12, 13, 39
COMPLEX keyword
COMPLEXARR() function, 13, 15, 39
COMPRESS keyword
in FILE_LINES() function, 45
COMPUTE_EPOCH keyword
in CDF_EPOCH procedure, 38
CONGRID() function, 39
CONJ() function, 12, 39
CONNECT_TIMEOUT keyword
in SOCKET procedure, 84
T
F
A
R
CONTEXT_EVENTS keyword
CONTEXT_MENU keyword
CONTINUE
in CONTINUE statement, 14
CONTINUE keyword
in MESSAGE procedure, 62
CONTOUR procedure, 39
CONTOURprocedure, 23
CONVERT_ALL keyword
in IDL_VALIDNAME() function, 53
CONVERT_COORD() function, 24, 40
CONVERT_SPACES keyword
CONVOL() function, 18, 28, 40
COORDSYS keyword
in HDF_SD_GETINFO procedure, 51
COPY keyword
in SET_PLOT procedure, 75
CORRELATE() function, 19, 40
COS() function, 19, 40
COSH() function, 19, 41
COUNT keyword
in COMMAND_LINE_ARGS() function, 39
in FILE_SEARCH() function, 45
in FINDFILE() function, 45
in GET_DRIVE_LIST() function, 47
in HDF_SD_ADDDATA procedure, 50
in HDF_SD_ATTRINFO procedure, 50
in HDF_SD_DIMGET procedure, 50
in HDF_SD_GETDATA procedure, 51
in IMAGE_STATISTICS procedure, 53
in NCDF_VARGET procedure, 63
in NCDF_VARPUT procedure, 64
in OBJ_CLASS() function, 64
in OBJ_VALID() function, 66
in PTR_VALID() function, 69
in SPAWN procedure, 84
in STRSPLIT() function, 86
COUNTRIES keyword
COVARIANCE keyword
in CORRELATE() function, 40
CPU procedure, 41
CPUprocedure, 29
CREATE_STRUCT() function, 15, 41
CREATE keyword
in HDF_SD_START() function, 51
CROSSP() function, 18, 41
CUBIC keyword
in INTERPOLATE() function, 56
in POLY_2D() function, 68
CUMULATIVE keyword
in PRODUCT() function, 68
in TOTAL() function, 89
CURRENT keyword
in CD procedure, 38
in MEMORY() function, 62
CURSOR procedure, 41
CURSORprocedure, 23
D_VALUE keyword
DATA_DIMS keyword
in READ_BINARY() function, 71
DATA_LENGTH keyword
in N_TAGS() function, 64
DATA_START keyword
DATA_SUM keyword
DATA_TYPE keyword
DATA keyword
in CONVERT_COORD() function, 40
in TV procedure, 89
DAYS_OF_WEEK keyword
DBLARR() function, 13, 15, 41
DCINDGEN() function, 13, 15, 41
DCOMPLEX() function, 12, 13, 41
DCOMPLEX keyword
DCOMPLEXARR() function, 13, 15, 41
DEBUG keyword
in DIALOG_PICKFILE() function, 42
in FILE_WHICH() function, 45
in READ_GIF procedure, 71
in SPL_INIT_OLD() function, 84
in WRITE_BMP procedure, 92
in WRITE_JPEG procedure, 92
107
108
T
F
A
R
in WRITE_PICT procedure, 92
in WRITE_PNG procedure, 92
DECOMPOSED keyword
DEFAULT_CANCEL keyword
DEFAULT_EXTENSION keyword
DEFAULT_NO keyword
DEFAULTRETURNVALUE keyword
in PYTHON() function, 69
DEFSYSV procedure, 41
DEFSYSVprocedure, 15
DEGREES keyword
in LL_ARC_DISTANCE() function, 57
DELAY_TIME keyword
DELETE keyword
DELIMITER keyword
DEMO keyword
DERIV() function, 18, 19, 41
DESCRIPTION keyword
in RESTORE procedure, 72
DESTROY_SEMAPHORE keyword
in SEM_CREATE() function, 75
DESTROY keyword
in WIDGET_CONTROL procedure, 91
in WIDGET_EVENT() function, 91
DETERM() function, 41
DEVICE procedure, 41
DEVICE keyword
in TV procedure, 89
DEVICEprocedure, 23
DFNT_CHAR keyword
DFNT_FLOAT32 keyword
DFNT_FLOAT64 keyword
DFNT_INT16 keyword
DFNT_INT32 keyword
DFNT_INT8 keyword
DFNT_UINT16 keyword
DFNT_UINT32 keyword
DFNT_UINT8 keyword
DIALOG_MESSAGE() function, 30, 42
DIALOG_PARENT keyword
DIALOG_PICKFILE() function, 30, 42
DIMENSION keyword
in FFT() function, 44
in MAX() function, 62
in MEDIAN() function, 62
in MIN() function, 62
DIMENSIONS keyword
in SIZE() function, 84
DIMS keyword
Subject Index
DINDGEN() function, 13, 15, 42

DIRECTORY keyword
DISABLED keyword
in ROUTINE_INFO() function, 72
DISPLAY_NAME keyword
DISPOSAL_METHOD keyword
DIST() function, 20, 42
DITHER keyword
in MAGICK_QUANTIZE procedure, 61
DO
DOUBLE keyword, 18
DOUBLE() function, 12, 13, 42
DOUBLE keyword
in BESELI() function, 35
in BESELJ() function, 35
in BESELK() function, 35
in BESELY() function, 35
in BETA() function, 35
in BROYDEN() function, 35
in CORRELATE() function, 40
in DETERM() function, 41
in ERF() function, 42
in ERFC() function, 43
in ERRORF() function, 43
in EXPINT() function, 43
in GAMMA() function, 46
in GAUSSINT() function, 46
in GDL_ERFINV() function, 47
in
in
in
in
in
in
in
in
in
in
in
in
in
in
in
in
in
in
in
in
in
in
in
in
in
in
in
in
in
in
in
in
in
in
in
in
in
in
in
in
in
T
F
A
R
IDENTITY() function, 53
IGAMMA() function, 53
IMSL_BINOMIALCOEF() function, 53
IMSL_CONSTANT() function, 54
IMSL_ERF() function, 55
IMSL_ZEROPOLY() function, 55
IMSL_ZEROSYS() function, 56
INDGEN() function, 56
INVERT() function, 56
KURTOSIS() function, 56
LA_TRIRED procedure, 56
LAGUERRE() function, 56
LEGENDRE() function, 57
LNGAMMA() function, 57
LUDC procedure, 59
LUSOL() function, 59
MACHAR() function, 59
MAKE_ARRAY() function, 61
MEAN() function, 62
MEANABSDEV() function, 62
MEDIAN() function, 62
MOMENT() function, 62
NCDF_ATTPUT procedure, 62
NCDF_VARDEF() function, 63
NEWTON() function, 64
NORM() function, 64
POLY_AREA() function, 68
RADON() function, 70
RANDOMN() function, 70
RANDOMU() function, 70
RK4() function, 72
RK4JMG() function, 72
SKEWNESS() function, 84
SPHER_HARM() function, 84
SPL_INIT() function, 84
SPL_INIT_OLD() function, 84
SPL_INTERP() function, 84
SPL_INTERP_OLD() function, 84
STDDEV() function, 85
SVDC procedure, 88
TOTAL() function, 89
in TRACE() function, 89
in VARIANCE() function, 90
in VOIGT() function, 90
DOWN keyword
DRHO keyword
DTOXDR keyword
in BYTEORDER procedure, 36
DX keyword
DY keyword
DYNAMIC_RESIZE keyword
in WIDGET_DROPLIST() function, 91
EDGE_TRUNCATE keyword
in SMOOTH() function, 84
EDGE_WRAP keyword
EDITABLE keyword
ELSE
in IF/THEN/ELSE statement, 12
EMBEDDED keyword
ENABLED keyword
ENCAPSULATED keyword
ENDCASE, 13
ENDEF keyword
ENDELSE, 12
ENDFOR, 13
ENDFOREACH, 13
ENDIAN keyword
ENDIF, 12
ENDREP, 14
ENDSWITCH, 13
ENDWHILE, 14
ENVIRONMENT keyword
in GETENV() function, 47
EOF() function, 42
EOF keyword
in SKIP_LUN procedure, 84
EOFprocedure, 21
ERASE procedure, 42
ERASEprocedure, 23
ERF() function, 18, 42
ERFC() function, 18, 43
ERR_REL keyword
in IMSL_ZEROSYS() function, 56
ERRMSG keyword
ERROR keyword
ERRORF() function, 18, 43
ESC keyword
in STR_SEP() function, 87
ESCAPE_SPECIAL_CHAR() function, 43
ESCAPE keyword
in STRTOK() function, 86
EVEN keyword
in MEDIAN() function, 62
EVENT_FUNC keyword
109
110
T
F
A
R
EVENT_PRO keyword
EXCLUSIVE keyword
EXECUTABLE keyword
EXECUTE() function, 14, 25, 43
EXECUTEprocedure, 15
EXISTS keyword
in DEFSYSV procedure, 41
EXIT procedure, 43
EXIT_STATUS keyword
in FREE_LUN procedure, 46
EXITprocedure, 25
EXP() function, 18, 43
EXPAND_ENVIRONMENT keyword
EXPAND_PATH() function, 14, 25, 43
EXPAND_TILDE keyword
EXPINT() function, 18, 43
EXPIRE_DATE keyword
EXTRACT keyword
F77_UNFORMATTED keyword
F_VALUE keyword
FACTORIAL() function, 19, 43
FETCH keyword
FFT() function, 20, 44
FIELDS keyword
in HDF_VD_READ() function, 51
FILE_BASENAME() function, 25, 44
FILE_COPY procedure, 44
FILE_COPYprocedure, 25
FILE_DELETE procedure, 44
FILE_DELETEprocedure, 25
FILE_DIRNAME() function, 25, 44, 45
FILE_EXPAND_PATH() function, 25, 45
FILE_INFO() function, 25, 45
FILE_LINES() function, 25, 45
FILE_LUN keyword
FILE_MKDIR procedure, 45
FILE_MKDIRprocedure, 25
FILE_SAME() function, 25, 45
FILE_SEARCH() function, 25, 45
FILE_TEST() function, 25, 45
FILE_WHICH() function, 25, 45
FILE keyword
FILENAME keyword
FILEPATH() function, 14, 44
FILL_CONTINENTS keyword
FILL keyword
FILTER keyword
Subject Index
FIN keyword
FINDEX() function, 19, 45
FINDFILE() function, 25, 45
FINDGEN() function, 13, 15, 46
FINITE() function, 15, 46
FIX() function, 12, 13, 46
FIX_FILTER keyword
FLOAT() function, 12, 13, 46
FLOAT keyword
FLOATING keyword
FLOOR() function, 18, 46
FLTARR() function, 13, 15, 46
FLUSH procedure, 46
FLUSHprocedure, 23
FNORM keyword
FOLD_CASE keyword
in FILE_BASENAME() function, 44
in STRCMP() function, 85
in STRMATCH() function, 86
FOLLOW keyword
FONT keyword
T
F
A
R
FOR, 13
FORCE_DEMO keyword
FORCE keyword
in FREE_LUN procedure, 46
FOREACH, 13
FORMAT keyword
in PM procedure, 67
FOUR_BIT keyword
FRAME keyword
FREE_LUN procedure, 46
FREE_LUNprocedure, 21
FREE keyword
FSTAT() function, 25, 46
FTOXDR keyword
FULL_INTERLACE keyword
FULL_STRUCT keyword
in HELPFORM() function, 52
FULLY_QUALIFY_PATH keyword
FUNC_GET_VALUE keyword
FUNCTIONS keyword
GAMMA() function, 19, 46
GAMMA keyword
Gauss symbol, 18
GAUSS_CVF() function, 19, 46
GAUSS_PDF() function, 19, 46
Gaussian probability function, 19
GAUSSIANNOISE keyword
in MAGICK_ADDNOISE procedure, 59
GAUSSINT() function, 19, 46
GDL_ERFINV() function, 47
GEOTIFF keyword
GET_DECOMPOSED keyword
GET_DRIVE_LIST() function, 47
GET_KBRD() function, 47
GET_KBRDprocedure, 21
GET_LOGIN_INFO() function, 47
GET_LUN procedure, 47
GET_LUN keyword
GET_LUNprocedure, 21
GET_MODE keyword
GET_NAMES keyword
in LOADCT_INTERNALGDL procedure, 58
GET_PATH keyword
GET_SCREEN_SIZE() function, 24, 47
GET_SCREEN_SIZE keyword
GET_UVALUE keyword
GET_VALUE keyword
GET_VISUAL_DEPTH keyword
GET keyword
in TVLCT procedure, 89
GETENV() function, 25, 47
GLOBAL keyword
in NCDF_ATTDEL procedure, 62
in NCDF_ATTGET procedure, 62
in NCDF_ATTINQ() function, 62
in NCDF_ATTNAME() function, 62
in NCDF_ATTRENAME procedure, 63
GOTO statement, 14
GRAY keyword
GRAYSCALE keyword
GRIBAPI_CLONE() function, 22, 47
GRIBAPI_CLOSE_FILE procedure, 47
GRIBAPI_CLOSE_FILEprocedure, 22
GRIBAPI_COUNT_IN_FILE() function, 22, 47
GRIBAPI_GET procedure, 47
GRIBAPI_GET_DATA procedure, 47
GRIBAPI_GET_DATAprocedure, 22
GRIBAPI_GET_SIZE() function, 22, 48
GRIBAPI_GETprocedure, 22
GRIBAPI_NEW_FROM_FILE() function, 22, 48
GRIBAPI_OPEN_FILE() function, 22, 48
GRIBAPI_RELEASE procedure, 48
GRIBAPI_RELEASEprocedure, 22
111
112
T
F
A
R
GRID_LAYOUT keyword
GRID keyword
in PY_PLOT procedure, 69
GROUP_LEADER keyword
GROUP keyword
GSL_EXP() function, 18, 48
H5_GET_LIBVERSION() function, 21, 50

H5A_CLOSE procedure, 48
H5A_CLOSEprocedure, 21
H5A_GET_NAME() function, 21, 48
H5A_GET_NUM_ATTRS() function, 21, 48
H5A_GET_SPACE() function, 21, 48
H5A_GET_TYPE() function, 21, 48
H5A_OPEN_IDX() function, 21, 48
H5A_OPEN_NAME() function, 21, 48
H5A_READ() function, 21, 48
H5D_CLOSE procedure, 48
H5D_CLOSEprocedure, 21
H5D_GET_SPACE() function, 21, 49
H5D_GET_TYPE() function, 21, 49
H5D_OPEN() function, 21, 49
H5D_READ() function, 21, 49
H5F_CLOSE procedure, 49
H5F_CLOSEprocedure, 21
H5F_IS_HDF5() function, 21, 49
H5F_OPEN() function, 21, 49
H5G_CLOSE procedure, 49
H5G_CLOSEprocedure, 21
H5G_OPEN() function, 21, 49
H5S_CLOSE procedure, 49
H5S_CLOSEprocedure, 21
H5S_GET_SIMPLE_EXTENT_DIMS() function, 21, 49
H5T_CLOSE procedure, 49
H5T_CLOSEprocedure, 21
H5T_GET_SIZE() function, 21, 49
HAS_PALETTE keyword
HAT keyword
HDF_CLOSE procedure, 50
HDF_CLOSEprocedure, 21
HDF_OPEN() function, 21, 50
HDF_SD_ADDDATA procedure, 50
HDF_SD_ADDDATAprocedure, 21
HDF_SD_ATTRFIND() function, 21, 50
HDF_SD_ATTRINFO procedure, 50
HDF_SD_ATTRINFOprocedure, 21
HDF_SD_CREATE() function, 21, 50
HDF_SD_DIMGET procedure, 50
HDF_SD_DIMGETID() function, 21, 50
HDF_SD_DIMGETprocedure, 21
HDF_SD_END procedure, 50
HDF_SD_ENDACCESS procedure, 50
HDF_SD_ENDACCESSprocedure, 21
HDF_SD_ENDprocedure, 21
HDF_SD_FILEINFO procedure, 50
HDF_SD_FILEINFOprocedure, 21
HDF_SD_GETDATA procedure, 51
HDF_SD_GETDATAprocedure, 21
HDF_SD_GETINFO procedure, 51
HDF_SD_GETINFOprocedure, 21
HDF_SD_NAMETOINDEX() function, 21, 51
HDF_SD_SELECT() function, 21, 51
HDF_SD_START() function, 21, 51
HDF_TYPE keyword
HDF_VD_ATTACH() function, 21, 51
HDF_VD_DETACH procedure, 51
HDF_VD_DETACHprocedure, 21
HDF_VD_FIND() function, 21, 51
HDF_VD_GET procedure, 51
Subject Index
HDF_VD_GETprocedure, 21
HDF_VD_READ() function, 21, 51
HDF_VG_ATTACH() function, 21, 51
HDF_VG_DETACH procedure, 51
HDF_VG_DETACHprocedure, 21
HDF_VG_GETID() function, 21, 51
HDF_VG_GETINFO procedure, 51
HDF_VG_GETINFOprocedure, 21
HDF_VG_GETTRS procedure, 52
HDF_VG_GETTRSprocedure, 21
HEADER_DEFINE keyword
HEADER keyword
HEAP_GC procedure, 52
HEAP_GCprocedure, 15
HELP procedure, 52
HELP keyword
in APPLEMAN procedure, 33
in DERIV() function, 41
in ESCAPE_SPECIAL_CHAR() function, 43
in FILE_BASENAME() function, 44
in FILE_DIRNAME() function, 45
in PREWITT() function, 68
T
F
A
R
in READ_PNG() function, 71
in ROBERTS() function, 72
in SOBEL() function, 84
in SPL_INIT() function, 84
in SPL_INTERP() function, 84
HELPFORM() function, 52
HELPprocedure, 15, 73
HIGHWATER keyword
HIRES keyword
HIST_2D() function, 19, 52, 53
HIST_ND() function, 19, 52
HISTOGRAM() function, 19, 52, 53
HLS keyword
HSV keyword
HTONL keyword
HTONS keyword
HYBRID keyword
in NEWTON() function, 64
hyperbolic functions, 19
I_VALUE keyword
IDENTITY() function, 15, 19, 53
IDL_BASE64() function, 26, 53
IDL_CONSTANT() function, 20
IDL_VALIDANEM() function, 26
IDL_VALIDNAME() function, 12, 53
IF, 12
IGAMMA() function, 19, 53
IGNORE_ACCELERATORS keyword
IHDR keyword
IMAGE_INDEX keyword
in QUERY_TIFF() function, 70
in READ_DICOM() function, 71
IMAGE_STATISTICS procedure, 53
IMAGINARY() function, 12, 53
IMPULSENOISE keyword
IMSL_BINOMIALCOEF() function, 19, 53
IMSL_CONSTANT() function, 54
IMSL_ERF() function, 18, 55
IMSL_ZEROPOLY() function, 19, 20, 55
IMSL_ZEROSYS() function, 56
IN_GLOBAL keyword
in NCDF_ATTCOPY() function, 62
INCHES keyword
INCLUDE_CURRENT_DIR keyword
INDEX keyword
INDGEN() function, 13, 15, 56
INFINITY keyword
in FINITE() function, 46
INFO keyword
INFORMATION keyword
INFORMATIONAL keyword
INPUT keyword
INSTALL_NUM keyword
INT keyword
INTARR() function, 13, 15, 56
INTEGER keyword
INTERCHANGES keyword
in LUDC procedure, 59
INTERLEAVE keyword
INTERP keyword
INTERPOL() function, 19, 56
INTERPOLATE() function, 19, 56
INTERPOLATE keyword
in SET_PLOT procedure, 75
INVERSE keyword
in IMSL_ERF() function, 55
INVERT() function, 18, 56
IOERROR keyword
ISHFT() function, 19, 56
ISOTROPIC keyword
ISSUE_ACCESS_ERROR keyword
ITER keyword
in RK4() function, 72
in VOIGT() function, 90
113
114
T
F
A
R
ITMAX keyword
in SVDC procedure, 88
JACOBIAN keyword
JENKINS_TRAUB keyword
in IMSL_ZEROPOLY() function, 55
joint density function, 52
JOURNAL procedure, 56
JOURNALprocedure, 17
JULIAN keyword
in SYSTIME() function, 88
KBRD_FOCUS_EVENTS keyword
KEYWORD_SET() function, 14, 56
KILL_NOTIFY keyword
KURTOSIS() function, 19, 56
L64 keyword, 18
L64_VALUE keyword
L64 keyword
in CEIL() function, 39
in FLOOR() function, 46
in ROUND() function, 72
in SORT() function, 84
in VALUE_LOCATE() function, 90
L64INDEGEN() function, 15
L64INDGEN() function, 13, 56
L64SWAP keyword
L_VALUE keyword
LA_TRIRED procedure, 56
LA_TRIREDprocedure, 19
LABEL keyword
LAGUERRE() function, 19, 56
LANDSCAPE keyword
LAPLACIANNOISE keyword
LAST_ITEM() function, 56
LEGENDRE() function, 19, 57
LENGTH_OF_HAT keyword
LENGTH keyword
in N_TAGS() function, 64
LEVEL keyword
in SCOPE_VARFETCH() function, 75
LEVELS keyword
LIB keyword
LINDEGEN() function, 15
LINDGEN() function, 13, 57
LINE_FILL keyword
LINEAR keyword
LINEINTERLACE keyword
in MAGICK_INTERLACE procedure, 60
Subject Index
LINES keyword
LINESTYLE keyword
LINKIMAGE procedure, 57
LINKIMAGE() function, 31
LINKIMAGEprocedure, 38
LIST_OF_SPECIAL_CHAR keyword
LL_ARC_DISTANCE() function, 19, 23, 57
LMGR() function, 57
LMHOSTID keyword
LNGAMMA() function, 19, 57
LOADCT procedure, 57
LOADCT_INTERNALGDL procedure, 58
LOADCTprocedure, 23
LOCALE_GET() function, 25, 59
LOCATIONS keyword
LOGICAL_AND() function, 12, 59
LOGICAL_OR() function, 12, 59
LOGICAL_TRUE() function, 12, 59
LON64ARR() function, 15, 59
LONARR() function, 13, 15, 59
LONG() function, 12, 13, 59
LONG64() function, 12, 13, 59
LONG64ARR() function, 13
LONG keyword
LSQUADRATIC keyword
T
F
A
R
in INTERPOL() function, 56
LSWAP keyword
LUDC procedure, 59
LUDCprocedure, 19
LUSOL() function, 59
LUT keyword
MACHAR() function, 15, 59

MAGICK_ADDNOISE procedure, 59
MAGICK_CLOSE procedure, 59
MAGICK_COLORMAPSIZE() function, 60
MAGICK_COLUMNS() function, 60
MAGICK_CREATE() function, 60
MAGICK_DISPLAY procedure, 60
MAGICK_EXISTS() function, 60
MAGICK_FLIP procedure, 60
MAGICK_INDEXEDCOLOR() function, 60
MAGICK_INTERLACE procedure, 60
MAGICK_MAGICK() function, 60
MAGICK_MATTE procedure, 60
MAGICK_OPEN() function, 60
MAGICK_PING() function, 60
MAGICK_QUALITY procedure, 60
MAGICK_QUANTIZE procedure, 61
MAGICK_READ() function, 61
MAGICK_READCOLORMAPRGB procedure, 61
MAGICK_READINDEXES() function, 61
MAGICK_ROWS() function, 61
MAGICK_WRITE procedure, 61
MAGICK_WRITECOLORTABLE procedure, 61
MAGICK_WRITEFILE procedure, 61
MAGICK_WRITEINDEXES procedure, 61
magnitude of a complex number, 18
MAKE_ARRAY() function, 15, 61
MANAGED keyword
Mandelbrot set, 33
MAP_CLIP_SET procedure, 61
MAP_CLIP_SETprocedure, 23
MAP_CONTINENTS procedure, 61
MAP_CONTINENTSprocedure, 23
MAP_PROJ_FORWARDprocedure, 23
MAP_PROJ_INVERSEprocedure, 23
MAP keyword
in MAGICK_READ() function, 61
in TRIGRID() function, 89
MARK_DIRECTORY keyword
in FILE_DIRNAME() function, 45
MASK keyword
in CHECK_MATH() function, 39
MATCH_ALL_INITIAL_DOT keyword
MATCH_INITIAL_DOT keyword
MATRIX_MULTIPLY() function, 18, 61
MAX() function, 18, 19, 62
MAX1 keyword
MAX2 keyword
MAX_VALUE keyword
MAX keyword
in BYTSCL() function, 36
in HIST_ND() function, 52
MAXIMUM keyword
MAXMOMENT keyword
in MOMENT() function, 62
MBAR keyword
MDEV keyword
MEAN() function, 18, 19, 62
MEAN keyword
MEANABSDEV() function, 19, 62
MEDIAN() function, 19, 28, 62
MEMORY() function, 62
MEMORY keyword
MEMORYprocedure, 17
MENU keyword
MESSAGE procedure, 62
MESSAGEprocedure, 15, 17
MIN() function, 18, 19, 62
MIN1 keyword
MIN2 keyword
MIN_VALUE keyword
MIN keyword
MINIMUM keyword
MINUS_ONE keyword
MISSING_VALUE keyword
MISSING keyword
in BILINEAR() function, 35
115
116
T
F
A
R
in POLY_2D() function, 68
MODAL keyword
MOMENT() function, 19, 62
MONTH keyword
MORE keyword
MTIMES keyword
MULTIPLE_FILES keyword
MULTIPLE keyword
MULTIPLICATIVEGAUSSIANNOISE keyword
multithreading
in ABS() function, 33
in ACOS() function, 33
in ASIN() function, 34
in ATAN() function, 34
in CEIL() function, 39
in COMPLEX() function, 39
in CONJ() function, 39
in COS() function, 40
in COSH() function, 41
in EXP() function, 43
in FLOOR() function, 46
in IMAGINARY() function, 53
in LOGICAL_AND() function, 59
in LOGICAL_OR() function, 59
in LOGICAL_TRUE() function, 59
in MAGICK_WRITEINDEXES procedure, 61
in ROUND() function, 72
in SIN() function, 83
in SINH() function, 83
in SQRT() function, 85
in STRCOMPRESS() function, 85
in STRLEN() function, 86
in STRLOWCASE() function, 86
in STRMID() function, 86
in STRPOS() function, 86
in STRPUT procedure, 86
in STRTRIM() function, 87
in STRUPCASE() function, 87
in TAN() function, 88
in TANH() function, 88
MUST_EXIST keyword
N_DIMENSIONS keyword
N_ELEMENTS() function, 14, 15, 64
N_ELEMENTS keyword
N_PARAMS() function, 14, 64
N_TAGS() function, 15, 64
NAME keyword
in CREATE_STRUCT() function, 41
NAMED_PIPE keyword
Subject Index
NAMES keyword
NAN keyword
in FINITE() function, 46
in KURTOSIS() function, 56
in MEAN() function, 62
in MEANABSDEV() function, 62
in SKEWNESS() function, 84
in STDDEV() function, 85
in TVSCL procedure, 89
in VARIANCE() function, 90
NATTR keyword
NATTS keyword
NBINS keyword
NCDF_ATTCOPY() function, 21, 62
NCDF_ATTDEL procedure, 62
NCDF_ATTDELprocedure, 21
NCDF_ATTGET procedure, 62
NCDF_ATTGETprocedure, 21
NCDF_ATTINQ() function, 21, 62
NCDF_ATTNAME() function, 21, 62
NCDF_ATTPUT procedure, 62
NCDF_ATTPUTprocedure, 21
NCDF_ATTRENAME procedure, 63
NCDF_ATTRENAMEprocedure, 21
NCDF_CLOSE procedure, 63
NCDF_CLOSEprocedure, 21
NCDF_CONTROL procedure, 63
T
F
A
R
NCDF_CONTROLprocedure, 21, 64
NCDF_CREATE() function, 21, 63
NCDF_DIMDEF() function, 21, 63
NCDF_DIMID() function, 21, 63
NCDF_DIMINQ procedure, 63
NCDF_DIMINQprocedure, 21
NCDF_DIMRENAME procedure, 63
NCDF_DIMRENAMEprocedure, 21
NCDF_EXISTS() function, 21, 63
NCDF_INQUIRE() function, 21, 63
NCDF_OPEN() function, 21, 63
NCDF_VARDEF() function, 21, 63
NCDF_VARGET procedure, 63
NCDF_VARGET1 procedure, 64
NCDF_VARGET1procedure, 21
NCDF_VARGETprocedure, 21
NCDF_VARID() function, 21, 64
NCDF_VARINQ() function, 21, 64
NCDF_VARPUT procedure, 64
NCDF_VARPUTprocedure, 21
NCDF_VARRENAME procedure, 64
NCDF_VARRENAMEprocedure, 21
NCOLORS keyword
NCOMPLEMENT keyword
NDIMS keyword
NENTRIES keyword
NEWTON() function, 20, 64
NLEVELS keyword
NO_CHECK keyword
NO_CONFIRM keyword
in EXIT procedure, 43
NO_COPY keyword
in PTR_NEW() function, 69
NO_INTERLACE keyword
NO_NEWLINE keyword
NO_RELEASE keyword
NO_TYPECONV keyword
in ARRAY_EQUAL() function, 34
NOAUTOMODE keyword
NOCATCH keyword
NOCLEAR keyword
NOCLIP keyword
NOCLOBBER keyword
in NCDF_CREATE() function, 63
NODATA keyword
NODISPLAY keyword
NOERASE keyword
NOEXPAND_PATH keyword
in FILE_INFO() function, 45
in FILE_LINES() function, 45
in FILE_MKDIR procedure, 45
in FILE_SAME() function, 45
NOFILL keyword
NOINTERLACE keyword
NOISE keyword
NONAME keyword
NONEXCLUSIVE keyword
NOPREFIX keyword
NOPRINT keyword
NORM() function, 18, 64
NORMAL keyword
in TV procedure, 89
NOSHELL keyword
117
118
T
F
A
R
NOSORT keyword
NOTIFY_REALIZE keyword
NOVERBOSE keyword
NOWAIT keyword
NOWRITE keyword
in NCDF_OPEN() function, 63
NOZERO keyword
in BYTARR() function, 35
in COMPLEXARR() function, 39
in DBLARR() function, 41
in DCOMPLEXARR() function, 41
in FLTARR() function, 46
in INTARR() function, 56
in LON64ARR() function, 59
in LONARR() function, 59
in OBJARR() function, 64
in STRARR() function, 85
in STRUCT_ASSIGN procedure, 87
in UINTARR() function, 90
in ULON64ARR() function, 90
in ULONARR() function, 90
NRECORDS keyword
NRHO keyword
NSUM keyword
NTHETA keyword
NTOHL keyword
NTOHS keyword
NUM_ALLOC keyword
NUM_DD keyword
NUM_FREE keyword
NUM_IMAGES keyword
NUM_RECORDS keyword
NX keyword
NY keyword
OBJ_CLASS() function, 15, 64

OBJ_DESTROY procedure, 65
OBJ_DESTROY() function, 13
OBJ_DESTROYprocedure, 15
OBJ_ISA() function, 15, 65
OBJ_NEW() function, 15, 65
OBJ_VALID() function, 15, 66
OBJ keyword
in HEAP_GC procedure, 52
OBJARR() function, 13, 15, 64
OF
OFFSET keyword
in NCDF_VARGET1 procedure, 64
OLDFILL keyword
OMAX keyword
Subject Index
OMIN keyword
ON_ERROR procedure, 66
ON_ERRORprocedure, 15
ON_IOERRORprocedure, 15
OPENR procedure, 66
OPENRprocedure, 21
OPENU procedure, 66
OPENUprocedure, 21
OPENW procedure, 66
OPENWprocedure, 21
OPLOT procedure, 66
OPLOTprocedure, 23
ORDER keyword
in TV procedure, 89
ORIENTATION keyword
OUT_GLOBAL keyword
in NCDF_ATTCOPY() function, 62
OUTPUT keyword
OVERPLOT keyword
OVERWRITE_PROMPT keyword
OVERWRITE keyword
in REFORM() function, 72
in REVERSE() function, 72
PACKED keyword
in ASSOC() function, 34
T
F
A
R
PARAMETERS keyword
PARENT_DIRECTORY keyword
in PATH_SEP() function, 67
PARSE_URL() function, 25, 26, 66
Pascals triangle, 53
PASS_METHOD keyword
PATH_SEP() function, 25, 44, 67
PATH keyword
PHASE keyword
in ATAN() function, 34
PID keyword
PIXEL_TYPE keyword
PIXMAP keyword
PLANARCONFIG keyword
PLANEINTERLACE keyword
PLOT procedure, 67
PLOTERR procedure, 67
PLOTERRprocedure, 23
PLOTprocedure, 23
PLOTS procedure, 67
PLOTSprocedure, 23
PM procedure, 67
PMprocedure, 15, 21
POINT_LUN procedure, 67
POINT_LUNprocedure, 21
POISSON keyword
POISSONNOISE keyword
POLAR keyword
POLY() function, 19, 67

POLY_2D() function, 28, 68
POLY_AREA() function, 19, 68
POLYFILL procedure, 67
POLYFILLprocedure, 23
POPD procedure, 68
POPDprocedure, 25
PORTRAIT keyword
POSITION keyword
PRESERVE_NULL keyword
PRESERVE_TYPE keyword
PREWITT() function, 28, 68
PRIMES() function, 19, 68
PRINT procedure, 68
PRINT keyword
in FIX() function, 46
PRINTD procedure, 68
PRINTDprocedure, 25
PRINTF procedure, 68
PRINTFprocedure, 21
PRINTprocedure, 15, 21
PRO_SET_VALUE keyword
PROCEDURES keyword
PRODUCT() function, 18, 68
PROGRESSIVE keyword
PROMPT keyword
PSYM keyword
PTR_FREE procedure, 68
PTR_FREE() function, 13
PTR_FREEprocedure, 15
PTR_NEW() function, 15, 68, 69
PTR_VALID() function, 15, 68, 69
PTR keyword
PTRARR() function, 13, 15, 68
PTRARRprocedure, 15
PUSHBUTTON_EVENTS keyword
PUSHD procedure, 69
PUSHDprocedure, 25
PY_PLOT procedure, 69
PY_PRINT procedure, 69
PYTHON procedure, 69
PYTHON() function, 14, 32, 69
PYTHONprocedure, 14, 32
QUADRATIC keyword
QUALITY keyword
QUERY_BMP() function, 28, 69
QUERY_DICOM() function, 28, 69
QUERY_GIF() function, 28, 70
QUERY_IMAGE() function, 28, 70
QUERY_JPEG() function, 28, 70
QUERY_PICT() function, 28, 70
QUERY_PNG() function, 28, 70
119
120
T
F
A
R
QUERY_PPM() function, 28, 70

QUERY_TIFF() function, 28, 70
QUESTION keyword
QUIET keyword
QUOTE keyword
RADON() function, 28, 70
RANDOMN() function, 20, 70
RANDOMU() function, 20, 70
RDWR keyword
READ procedure, 70
READ_ASCII() function, 71
READ_ASCIIprocedure, 21
READ_BINARY() function, 21, 71
READ_BMP() function, 28, 71
READ_DICOM() function, 28, 71
READ_GIF procedure, 71
READ_JPEG procedure, 71
READ_JPEGprocedure, 28
READ_PICT procedure, 71
READ_PICTprocedure, 28
READ_PNG() function, 28, 71, 73
READ_TIFF() function, 28, 71
READ_TIMEOUT keyword
READ_XWD() function, 28, 71
READ keyword
in HDF_VD_ATTACH() function, 51
in HDF_VG_ATTACH() function, 51
READF procedure, 70
READFprocedure, 21
READprocedure, 21
READS procedure, 70
READS() function, 26
READSprocedure, 21
READU procedure, 70
READUprocedure, 21
REAL_PART() function, 12, 71
REALIZE keyword
REBIN() function, 15, 19, 28, 71
RECALL_COMMANDS() function, 71
RECALL_COMMANDS keyword
RECALL_COMMANDSprocedure, 17
RECORD_START keyword
RECURSIVE keyword
REDEF keyword
REF keyword
REFORM() function, 15, 72
REGEX keyword
REGULAR keyword
RELAXED_STRUCTURE_ASSIGNMENT keyword
REMOVE_ALL keyword
in STRCOMPRESS() function, 85
REPEAT, 14
REPEAT_COUNT keyword
REPLICATE() function, 13, 15, 19, 72
Subject Index
REPLICATE_INPLACE procedure, 72
REPLICATE_INPLACEprocedure, 15, 19
REQUIRE_DIRECTORY keyword
RESET keyword
in CPU procedure, 41
RESOLUTION keyword
in GET_SCREEN_SIZE() function, 47
RESOLVE_ROUTINE procedure, 72
RESOLVE_ROUTINEprocedure, 17
RESOURCE_NAME keyword
RESTORE procedure, 72
RESTORE keyword
RESTORED_OBJECTS keyword
RESTOREprocedure, 22
RESULT keyword
RETAIN keyword
RETALL procedure, 72
RETALL keyword
in RETALL procedure, 72
RETALLprocedure, 17
RETURN_TYPE keyword
REVERSE() function, 15, 18, 72
REVERSE_INDICES keyword
REVERSE_OFFSET keyword
in STRMID() function, 86
T
F
A
R
REVERSE_SEARCH keyword
RGB keyword
in MAGICK_WRITE procedure, 61
in READ_BMP() function, 71
RHO keyword
RIVERS keyword
RK4() function, 20, 72
RK4JMG() function, 72
RMIN keyword
RNAME_MBAR keyword
ROBERTS() function, 28, 72
ROOT_DIR keyword
in FILEPATH() function, 44
ROTATE() function, 15, 18, 28, 72
ROUND() function, 18, 72
ROUTINE_INFO() function, 17, 72, 74
ROUTINE_NAMES() function, 17, 73
ROUTINES keyword
ROW keyword
RSTRPOS() function, 26, 74
RUNTIME keyword
S_FUNCTIONS keyword
S_PROCEDURES keyword
S_VALUE keyword
SAMPLE keyword
in REBIN() function, 71
SAVE procedure, 75
SAVE keyword
SAVEprocedure, 22
SCALE_FACTOR keyword
SCALE keyword
SCOPE_VARFETCH() function, 17, 74, 75
SCR_XSIZE keyword
SCR_YSIZE keyword
SCROLL keyword
SDEV keyword
SEARCH_PATH keyword
SECONDS keyword
SEM_CREATE() function, 29, 75
SEM_DELETE procedure, 75
SEM_DELETEprocedure, 29
SEM_LOCK() function, 29, 75
SEM_RELEASE procedure, 75
SEM_RELEASEprocedure, 29
SENSITIVE keyword
SEPARATOR keyword
SET_BUTTON keyword
SET_CHARACTER_SIZE keyword
SET_DROPLIST_SELECT keyword
SET_PLOT procedure, 75
SET_PLOTprocedure, 23
SET_RESOLUTION keyword
SET_UNAME keyword
SET_UVALUE keyword
SET_VALUE keyword
SETENV procedure, 75
SETENVprocedure, 25
SH_LOCATION keyword
SH keyword
SHIFT() function, 18, 75
SHORT keyword
SHORTFORM keyword
SHOW_LIST keyword
SHOWFONT procedure, 75
SHOWFONTprocedure, 24
SIGNED keyword
in POLY_AREA() function, 68
SILENT keyword
121
122
T
F
A
R
SIN() function, 19, 83
SINDGEN() function, 15, 26, 83
SINGLE keyword
in STRJOIN() function, 85
SINH() function, 19, 83
SITE_NOTICE keyword
SIZE() function, 12, 14, 15, 37, 84
SIZE keyword
SKEWNESS() function, 19, 84
SKIP_LUN procedure, 84
SKIP_LUNprocedure, 21
SMOOTH() function, 28, 84
SOBEL() function, 28, 84
SOCKET procedure, 84
SOCKET keyword
SOCKETprocedure, 25
SORT() function, 15, 26, 84
SPACE keyword
SPACING keyword
SPAWN procedure, 84
SPAWN_OPTIONS keyword
SPAWNprocedure, 25
SPHER_HARM() function, 19, 84
SPL_INIT() function, 19, 84
SPL_INIT_OLD() function, 84
SPL_INTERP() function, 19, 84
SPL_INTERP_OLD() function, 84
SPLINE keyword
SPLIT keyword
SQRT() function, 12, 18, 85
SSWAP keyword
START keyword
STATUS keyword
in EXIT procedure, 43
STDDEV() function, 19, 85
STDDEV keyword
STDIO_NON_FINITE keyword
STDIO keyword
STIRLING keyword
in FACTORIAL() function, 43
STOP procedure, 85
STOPprocedure, 17
STORE keyword
STR_SEP() function, 26, 87
STRARR() function, 13, 15, 26, 85
STRCMP() function, 26, 85
STRCOMPRESS() function, 26, 85
STREAM keyword
STREGEX() function, 26, 85
STRIDE keyword
STRING() function, 13, 26, 85
Subject Index
STRING keyword
STRJOIN() function, 26, 85
STRLEN() function, 26, 86
STRLOWCASE() function, 86
STRLOWERCASE() function, 26
STRMATCH() function, 86
STRMID() function, 26, 86
STRPOS() function, 26, 86
STRPUT procedure, 86
STRPUT() function, 26
STRSPLIT() function, 26, 86
STRTOK() function, 26, 86
STRTRIM() function, 26, 87
STRUCT_ALIGN_BYTES keyword
STRUCT_ASSIGN procedure, 87
STRUCT_ASSIGNprocedure, 15
STRUCTURE_NAME keyword
in TAG_NAMES() function, 88
STRUCTURE keyword
STRUCTURES keyword
STRUPCASE() function, 26, 87
STUDENT keyword
SUB_RECT keyword
SUBDIRECTORY keyword
SUBEXPR keyword
SUBSCRIPT_MAX keyword
SUBSCRIPT_MIN keyword
T
F
A
R
SUBTITLE keyword
SUM_OF_SQUARES keyword
SUPERCLASS keyword
in OBJ_CLASS() function, 64
SURFACE procedure, 87
SURFACEprocedure, 23
SVDC procedure, 88
SVDCprocedure, 19
SWAP_ENDIAN() function, 19, 21, 88
SWAP_ENDIAN_INPLACE procedure, 88
SWAP_ENDIAN_INPLACEprocedure, 19, 21
SWAP_ENDIAN keyword
SWAP_IF_BIG_ENDIAN keyword
in SWAP_ENDIAN() function, 88
in SWAP_ENDIAN_INPLACE procedure, 88
SWAP_IF_LITTLE_ENDIAN keyword
in SWAP_ENDIAN() function, 88
in SWAP_ENDIAN_INPLACE procedure, 88
SWITCH, 13
SYMLINK keyword
SYMSIZE keyword
SYNC keyword
SYSTEM keyword
SYSTIME() function, 27, 88
T3D keyword
T_PDF() function, 19, 89
TAB_MODE keyword
TAG_NAMES() function, 15, 88
TAG keyword
TAGFORM keyword
TAN() function, 19, 88
TANH() function, 19, 88
TEMPLATE procedure, 88
TEMPLATE_BLANK procedure, 89
TEMPLATE keyword
TEMPORARY() function, 12, 13, 17, 89
TERMINAL keyword
TEST procedure, 89
TEST keyword
THEN, 12
THETA keyword
THICK keyword
TICKLEN keyword
123
124
T
F
A
R
TITLE keyword
in PM procedure, 67
TLB_FRAME_ATTR keyword
TLB_ICONIFY_EVENTS keyword
TLB_KILL_REQUEST_EVENTS keyword
TLB_MOVE_EVENTS keyword
TLB_SIZE_EVENTS keyword
TMP keyword
TNAME keyword
TO_DATA keyword
TO_DEVICE keyword
TO_NORMAL keyword
TOLF keyword
TOLX keyword
TOOLBAR keyword
TOOLTIP keyword
TOP keyword
TOTAL() function, 18, 89
TPOOL_MAX_ELTS keyword
TPOOL_MIN_ELTS keyword
TPOOL_NTHREADS keyword
TRACE() function, 18, 89
TRACEBACK keyword
TRACKING_EVENTS keyword
TRANSFER_COUNT keyword
in READU procedure, 70
in WRITEU procedure, 92
TRANSFORM keyword
TRANSPARENT keyword
TRANSPOSE() function, 15, 18, 89
TRIAL keyword
trigonometric functions, 18
TRIGRID() function, 19, 89
TRIM keyword
TRUE keyword
in TV procedure, 89
Subject Index
TRUECOLOR keyword
TT_FONT keyword
TV procedure, 89
TV() function, 23
TVLCT procedure, 89
TVLCT() function, 23
TVprocedure, 15, 67
TVRD() function, 23, 67, 89
TVSCL procedure, 89
TVSCL() function, 23
TWO_PASS_QUANTIZE keyword
TYPE keyword
in FIX() function, 46
UI_VALUE keyword
UINDGEN() function, 13, 15, 89
UINT() function, 12, 13, 90
UINT keyword
UINTARR() function, 13, 15, 90
UL64_VALUE keyword
UL64 keyword
in FACTORIAL() function, 43
UL64INDGEN() function, 13, 15, 90
T
F
A
R
UL_VALUE keyword
ULINDGEN() function, 13, 15, 90
ULON64ARR() function, 13, 15, 90
ULONARR() function, 13, 15, 90
ULONG() function, 12, 13, 90
ULONG64() function, 12, 13, 90
ULONG keyword
UNAME keyword
UNIFORM keyword
UNIFORMNOISE keyword
UNIQ() function, 15, 18, 26, 90
UNIT keyword
UNITS keyword
UNLIMITED keyword
in NCDF_DIMDEF() function, 63
UNLOAD keyword
UNTIL, 14
UP keyword
UPPER keyword
in LA_TRIRED procedure, 56
USER_INPUT keyword
USERSYM procedure, 90
USEUNIT keyword
UTC keyword
UVALUE keyword
VALID keyword
VALUE_LOCATE() function, 19, 90
VALUE keyword
VARIABLES keyword
VARIANCE() function, 19, 90
VARIANCE keyword
VARSTATUS keyword
VAX_FLOAT keyword
VECTOR_ENABLE keyword
VECTOR keyword
VERBOSE keyword
in STRUCT_ASSIGN procedure, 87
VERSION keyword
VM keyword
VOIGT() function, 19, 90
WAIT procedure, 90
WAIT keyword
WAITprocedure, 25
WDELETE procedure, 91
WDELETEprocedure, 23
WEIGHT_SUM keyword
WEIGHTED keyword
WHERE() function, 15, 34, 91
WHILE, 14
WIDGET_BASE() function, 30, 91
WIDGET_BUTTON() function, 30, 91
WIDGET_CONTROL procedure, 91
WIDGET_CONTROLprocedure, 30
WIDGET_DROPLIST() function, 30, 91
WIDGET_EVENT() function, 30, 91
125
126
T
F
A
R
WIDGET_INFO() function, 30, 91

WIDGET_LABEL() function, 30, 92
WIDGET_TEXT() function, 30, 92
WIDTH keyword
WINDOW procedure, 92
WINDOW_STATE keyword
WINDOWprocedure, 23
WORDS keyword
WRAP keyword
WRITE_BMP procedure, 92
WRITE_BMPprocedure, 28
WRITE_GIF procedure, 92
WRITE_JPEG procedure, 92
WRITE_JPEGprocedure, 28
WRITE_PICT procedure, 92
WRITE_PICTprocedure, 28
WRITE_PNG procedure, 92
WRITE_PNGprocedure, 28, 73
WRITE_TIMEOUT keyword
WRITE keyword
in HDF_VD_ATTACH() function, 51
in HDF_VG_ATTACH() function, 51
in NCDF_OPEN() function, 63
WRITEprocedure, 21
WRITEU procedure, 92
WSET procedure, 92
WSETprocedure, 23
WSHOW procedure, 92
WSHOWprocedure, 23
WTN() function, 20, 93
X_BITMAP_EXTRA keyword
X_SCROLL_SIZE keyword
XAXIS keyword
XCHARSIZE keyword
XDR keyword
XDRTOD keyword
XDRTOF keyword
XGRIDSTYLE keyword
XGUESS keyword
XLABEL keyword
XLOG keyword
XMANAGER_ACTIVE_COMMAND keyword
XMANAGER_BLOCK keyword
Subject Index
in WIDGET_EVENT() function, 91
XMARGIN keyword
XMIN keyword
XMINOR keyword
XOFFSET keyword
XPAD keyword
XPOS keyword
XRANGE keyword
XSIZE keyword
in TV procedure, 89
XSTYLE keyword
XTHICK keyword
XTICK_GET keyword
XTICKFORMAT keyword
XTICKINTERVAL keyword
XTICKLAYOUT keyword
XTICKLEN keyword
XTICKNAME keyword
XTICKS keyword
XTICKUNITS keyword
XTICKV keyword
T
F
A
R
XTITLE keyword
XTYPE keyword
XYOUTS procedure, 93
XYOUTSprocedure, 23
Y_SCROLL_SIZE keyword
YAXIS keyword
YCHARSIZE keyword
YGRIDSTYLE keyword
YLABEL keyword
YLOG keyword
YMARGIN keyword
YMIN keyword
YMINOR keyword
YNOZERO keyword
YOFFSET keyword
YP0 keyword
YPAD keyword
YPN_1 keyword
YPOS keyword
YRANGE keyword
YSIZE keyword
in TV procedure, 89
127
128
YSTYLE keyword
YTHICK keyword
YTICK_GET keyword
YTICKFORMAT keyword
YTICKINTERVAL keyword
YTICKLAYOUT keyword
YTICKLEN keyword
YTICKNAME keyword
YTICKS keyword
YTICKUNITS keyword
YTICKV keyword
T
F
A
R
YTITLE keyword
YTYPE keyword
YUV keyword
Z_BUFFERING keyword
Z keyword
ZCHARSIZE keyword
ZENITY_NAME keyword
ZENITY_PATH keyword
ZENITY_SEP keyword
ZERO_LENGTH keyword
ZGRIDSTYLE keyword
ZLOG keyword
ZMARGIN keyword
ZMINOR keyword
ZRANGE keyword
ZSTYLE keyword
ZTHICK keyword
ZTICK_GET keyword
ZTICKFORMAT keyword
ZTICKINTERVAL keyword
ZTICKLAYOUT keyword
ZTICKLEN keyword
Subject Index
ZTICKNAME keyword
ZTICKS keyword
T
F
A
R
ZTICKUNITS keyword
ZTICKV keyword
ZTITLE keyword
ZTYPE keyword
ZVALUE keyword
129
Bibliography
T
F
A
R
[1] Fundation, F. S.: GNU General Public License, version 2, URL http://www.gnu.org/
licenses/old-licenses/gpl-2.0.html, 1991.
[2] Galassi, M., Davies, J., Theiler, J., Gough, B., Jungman, G., Alken, P., Booth, M., and
Rossi, F.: GNU Scientific Library Reference Manual - Third Edition (v1.12), Network
Theory Ltd., URL http://www.gnu.org/software/gsl/manual/, 2009. {7}
[3] Markwardt, C.: Non-linear Least-squares Fitting in IDL with MPFIT, in: Astronomical
Society of the Pacific Conference Series, edited by Bohlender, D., Durand, D., and
Dowler, P., vol. 411 of Astronomical Society of the Pacific Conference Series, URL
http://cdsads.u-strasbg.fr/abs/2009ASPC..411..251M, 2009. {19}
[4] Paoli, S.: C++ Coding Standard Specification, Tech. rep., CERN European Laboratory for Particle Physics, URL http://pst.web.cern.ch/PST/HandBookWorkBook/
Handbook/Programming/CodingStandard/c++standard.pdf, 2000. {95}
[5] Snyder, J.: Map projectionsA working manual, Tech. Rep. 1395, U.S. Geological Survey,
URL http://pubs.er.usgs.gov/djvu/PP/pp_1395.djvu, 1987. {57}
[6] van Rossum, G. and Fred L. Drake, J.: The Python Language Reference Manual, Network
Theory Ltd., URL http://docs.python.org/reference/, 2006. {32}
[7] Wessel, P. and Smith, W. H. F.: A global, self-consistent, hierarchical, high-resolution
shoreline database, J. Geophys. Res., 101, 87418743, doi:10.1029/96JB00104, 1996.
{61}
[8] Wolcott, N. and Hilsenrath, J.: Tables of coordinates for Hersheys repertory of occidental
type fonts and graphic symbols. A contribution to computer typesetting techniques., NBS
special publication 424, National Bureau of Standards, 1975. {24}

Draft Draft: GDL - GNU Data Language

Diunggah oleh

Informasi Dokumen

Judul Asli

Hak Cipta

Format Tersedia

Bagikan dokumen Ini

Bagikan atau Tanam Dokumen

Opsi Berbagi

Apakah menurut Anda dokumen ini bermanfaat?

Apakah konten ini tidak pantas?

Hak Cipta:

Format Tersedia

Draft Draft: GDL - GNU Data Language

Diunggah oleh

Hak Cipta:

Format Tersedia

T

a free/libre/open-source implementation of IDL/PV-WAVE*

developed by Marc Schellens and The GDL team

Chapter 1. Obtaining, installing, and invoking GDL

Chapter 2. Language reference . . . . . . . . . . .

Chapter 3. Interpreter commands and built-in

Chapter 5. Input/output, supported data

Chapter 6. Plotting and mapping .

Chapter 7. Interaction with host OS . . . . . . . .

Chapter 8. Manipulating strings . . . . . . . . . .

Chapter 9. Representing date & time . . . . . . .

Chapter 10. Image processing . . . . . . . . . . .

Chapter 11. Parallel processing . . . . .

Chapter 12. GUI programming (widgets) . . . . .

Chapter 13. Dynamic loading . . . . . . . . . . . .

Chapter 14. The Python bridge . . . . . . . . . .

Chapter 15. Alphabetical list of library routines

Chapter 16. General remarks and coding guidelines 95

Chapter 18. Extending the documentation . . . .

Chapter 19. Extending the testsuite

Chapter 20. A short overview of how GDL works

Chapter 21. How to make use of OpenMP in GDL 100

Subject Index . . . . . . . . . . . . . . . . . . . . . 104

GNU Octave: http://www.gnu.org/software/octave/

Organization of this document

This document is divided into two parts:

Users guide: intended for users developing programs written in GDL,

print , Hello world !

$ echo " H e l l o w o r l d ! "

Obtaining, installing, and invoking GDL

Influential environmental variables

BYTE() COMPLEX(), DCOMPLEX() ( CONJ(), ATAN(), IMAGINARY(), REAL_PART())

LOGICAL_AND() LOGICAL_OR() LOGICAL_TRUE()

Flow control structures

$ cat replace_with_nans . pro

Flow control structures

$ cat example . pro

Chapter 2. Language reference

Variable scoping rules

Functions and procedures

$ cat example . pro

N_PARAMS() KEYWORD_SET() ARG_PRESENT() N_ELEMENTS() SIZE()

Keyword name abbreviations are allowed if unambiguous, e.g.:

CALL_METHON CALL_METHON() OBJARR()

OBJ_CLASS() OBJ_DESTROY OBJ_ISA() OBJ_NEW() OBJ_VALID()

REFORM() REBIN() REVERSE() ROTATE() TRANSPOSE()

Handling Overflows, Floating Point Special Values

MAKE_ARRAY() REPLICATE() REPLICATE_INPLACE

MESSAGE CATCH ON_ERROR ON_IOERROR EXECUTE

BINDGEN() CINDGEN() DCINDGEN() DINDGEN() FINDGEN() INDGEN()

CREATE_STRUCT() N_TAGS() STRUCT_ASSIGN TAG_NAMES()

System variables (global)

DEFSYSV (checking if running GDL)

Heap variables (pointers)

$ cat example . pro

$cat example . pro

HEAP_GC PTRARR PTR_FREE PTR_NEW() PTR_VALID()

The HELP procedure

Chapter 2. Language reference

Interpreter commands and built-in debugging facilities

RESOLVE_ROUTINE ROUTINE_INFO() ROUTINE_NAMES() SCOPE_VARFETCH()

Basic Scalar, vector and array operations

TOTAL() SQRT() REVERSE() SHIFT() MAX() MIN() MEAN() NORM()