gadl - Runs the PDL Shell starting the GrADS Interface


NAME

gadl - Runs the PDL Shell (perldl) starting the GrADS Interface


SYNOPSIS

gadl [ -b -c -dap -dods -hdf -nc -nc4 -o grads_opts -v level ]


DESCRIPTION

Runs the Perl Data Language (PDL) shell (perldl), automatically loading the module Gerl.pm, and starting GrADS according to the command line options described below. This is a customization of perldl for running GrADS. As such it has all the capabilities of an interactive PDL shell, providing a powerful and convenient environment for advanced geophysical data analysis and visualization.

Consult the Gerl documentation at http://opengrads.org/doc/perl/Gerl/ for a description of the command line filter registered by Gerl. This filter defines many convenient shorthands for commonly used GrADS commands and automatically escapes arguments for a look-and-fell similar to the classic GrADS command line.


OPTIONS

Options controlling which GrADS executable to start:

-c

Starts the gradsc executable, assumed to be on your path

-nc

Starts the gradsnc executable, assumed to be on your path

-nc4

Starts the gradsnc4 executable, assumed to be on your path

-hdf

Starts the gradshdf executable, assumed to be on your path

-dods

Starts the gradsdods executable, assumed to be on your path

-dap

Starts the gradsdap executable, assumed to be on your path

-x pathname

Specifies to full pathname for the GrADS executable

Options controlling GrADS behavior:

-b

Starts GrADS in batch mode

-noecho

By default, any GrADS output to stdout/stderr is echoed to the screen; specify -noecho to suppress this output.

-l

Starts GrADS in landscape mode (default)

-o cmd_line_options

Passes the specified command line options directly to GrADS. Example:

   % gadl -o '-g 800x600 -c "run myscript.gs"'
-p

Starts GrADS in portrait mode

-t transfer_file

Transfer file for data exchanmge between PDL/GrADS; use a RAMDISK if you can.

-v level

Controls the verbose level of error codes returned by GrADS. Each command issued to GrADS result in an error code rc. Non-zero values 0f rc indicate that an error has occurred while rc=0 means that the command was executed successfully. When -v 1 is specified, only non-zero values of rc are echoed to stdout. When -v 2, both zero and non-zero values of rc are echoed; the default is not to echo any return code to screen. The -v option is primarily intended for developers.


BUGS

On some systems it hangs when the name of an invalid GrADS executable is provided.

Any attempt to read from stdin from within GrADS will fail, possibly hang, including the pull function in gs scripts and the request for CR after an animation sequence is displayed.


SEE ALSO

http://opengrads.org/doc/perl/Grads/Grads.html - Grads.pm, an OO interface to GrADS

http://opengrads.org/doc/perl/Gerl/Gerl.html - Gerl.pm, a procedural interface to GrADS

http://pdl.perl.org - the Perl Data Language (PDL) official website.

http://pdl.sourceforge.net/PDLdocs/perldl.html - documentation for the PDL shell.

http://grads.iges.org/grads - the official GrADS website.

http://opengrads.org - the OpenGrADS website hosting a number of GrADS extensions.

http://opengrads.org/test_data - sample datasets for running tutorials and testing GrADS.


AUTHOR

Arlindo da Silva <dasilva@alum.mit.edu>


COPYRIGHT

Copyright (c) 2007 Arlindo da Silva. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

 gadl - Runs the PDL Shell starting the GrADS Interface