NAME

Image::DS9::Manual::API.pod - Image::DS9 API Reference

VERSION

version v1.0.1

DESCRIPTION

Image::DS9 provides the user access to DS9's directives via methods which closely mirror their syntax. This document provides the list of methods, as generated from Image::DS9's internal grammar

Most methods exactly parallel the DS9 XPA commands. For more information on what the methods do, or how the arguments affect things, please consult the DS9 documentation.

In general each element in a command is passed as a separate argument to the method. For example, to change the binning factor:

  $dsp->bin( factor => 0.2 );

Some commands have more arguments:

  $dsp->bin( smooth => function => 'boxcar' );
  $dsp->bin( smooth => radius => 33 );
  $dsp->bin( about => ( 3, 3 ) );
  $dsp->bin( cols => ( 'rt_x', 'rt_y' ) );

Note the use of the => operator to force preceding barewords to be treated as strings, and the frivolous use of extra parenthesis for aesthetics. Some arguments are concatenated to avoid confusion; see the documentation for the individual methods.

Some commands can query DS9 for state information as well as set it. For example,

        $function = $dsp->bin( smooth => function );

Image::DS9 differentiates between the setting and requesting of values by the presence or absence of the argument containing the information.

Some commands take a hash as their last argument, which contains attributes which are passed on to DS9.

True Boolean values may be one of the following: 1, yes, true. False Boolean values may be one of the following: 0, no, false. Boolean values returned by a command are always translated into either 0 or 1.

The documentation for the commands lists the options supported and any deviations from the general approach described above. Refer to the DS9 XPA documentation to determine which commands permit queries and the allowed data types for the arguments. Image::DS9 checks that all data passed to DS9 is of the appropriate type.

Arguments and Return values

Please see Image::DS9::Manual::Interface for the general concepts around argument passing and return values.

METHODS

about

  [ STRING ] = $ds9->about;

align

  $ds9->align( BOOL );

  [ BOOL ] = $ds9->align;

analysis

Not implemented

array

  $ds9->array( PDL, ?{ new => BOOL, mask => BOOL } );

  $ds9->array( SCALARREF, ?{ new => BOOL, mask => BOOL, bitpix =>
    INTEGER, skip => INTEGER, -o => [ -a => [ xdim => INTEGER, ydim =>
    INTEGER ], dim => INTEGER ], zdim => INTEGER, endian => ( 'big' |
    'little' | 'native' ) } );

backup

  $ds9->backup( <filename>:STRING );

bin

  $ds9->bin( 'about', 'center' );
  $ds9->bin( 'about', <x>:FLOAT, <y>:FLOAT );

  $ds9->bin( 'buffersize', INTEGER );

  $ds9->bin( 'close' );

  $ds9->bin( 'cols', <xcol>:STRING, <ycol>:STRING );
  $ds9->bin( 'colsz', <xcol>:STRING, <ycol>:STRING, <zcol>:STRING );

  $ds9->bin( 'depth', INTEGER );

  $ds9->bin( 'factor', <x/y>:FLOAT );
  $ds9->bin( 'factor', <x>:FLOAT, <y>:FLOAT );

  $ds9->bin( 'filter', <filter>:STRING );

  $ds9->bin( 'function', ( 'average' | 'sum' ) );

  $ds9->bin( 'in' );

  $ds9->bin( 'lock', BOOL );

  $ds9->bin( 'match' );

  $ds9->bin( 'open' );

  $ds9->bin( 'out' );

  $ds9->bin( 'to fit' );
  $ds9->bin( 'tofit' );

  [ <filter>:STRING ] = $ds9->bin( 'filter' );

  [ <function>:STRING ] = $ds9->bin( 'function' );

  [ <x>:FLOAT, <y>:FLOAT ] = $ds9->bin( 'about' );

  [ ARRAY ] = $ds9->bin( 'cols' );
  [ ARRAY ] = $ds9->bin( 'factor' );
  [ ARRAY ] = $ds9->bin( 'factor' );

  [ BOOL ] = $ds9->bin( 'lock' );

  [ INTEGER ] = $ds9->bin( 'buffersize' );
  [ INTEGER ] = $ds9->bin( 'depth' );

blink

  $ds9->blink( 'interval', FLOAT );

  $ds9->blink( BOOL );

  $ds9->blink;

  [ BOOL ] = $ds9->blink( 'state' );

  [ FLOAT ] = $ds9->blink( 'interval' );

block

  $ds9->block( '0' );
  $ds9->block( 'abs', <x/y>:FLOAT );
  $ds9->block( 'abs', <x>:FLOAT, <y>:FLOAT );
  $ds9->block( 'close' );
  $ds9->block( 'lock', BOOL );
  $ds9->block( 'match' );
  $ds9->block( 'open' );
  $ds9->block( 'rel', <x/y>:FLOAT );
  $ds9->block( 'rel', <x>:FLOAT, <y>:FLOAT );
  $ds9->block( 'to', 'fit' );
  $ds9->block( 'to', <x/y>:FLOAT );
  $ds9->block( 'to', <x>:FLOAT, <y>:FLOAT );
  $ds9->block( 'tofit' );

  $ds9->block( <x/y>:FLOAT );
  $ds9->block( <x>:FLOAT, <y>:FLOAT );

  [ ARRAY ] = $ds9->block;

  [ BOOL ] = $ds9->block( 'lock' );

catalog

Not implemented

cd

  $ds9->cd( STRING );

  [ STRING ] = $ds9->cd;

cmap

  $ds9->cmap( 'close' );

  $ds9->cmap( 'file', <filename>:STRING );

  $ds9->cmap( 'invert', BOOL );

  $ds9->cmap( 'load', <filename>:STRING );

  $ds9->cmap( 'open' );

  $ds9->cmap( 'save', <filename>:STRING );

  $ds9->cmap( 'tag', 'delete' );
  $ds9->cmap( 'tag', 'load', <filename>:STRING );
  $ds9->cmap( 'tag', 'save', <filename>:STRING );

  $ds9->cmap( 'value', <contrast>:FLOAT, <brightness>:FLOAT );

  $ds9->cmap( <name>:STRING );

  [ <contrast>:FLOAT, <brightness>:FLOAT ] = $ds9->cmap( 'value' );

  [ <filename>:STRING ] = $ds9->cmap( 'file' );

  [ <name>:STRING ] = $ds9->cmap;

  [ BOOL ] = $ds9->cmap( 'invert' );

colorbar

  $ds9->colorbar( 'font', ( 'courier' | 'helvetica' | 'times' ) );
  $ds9->colorbar( 'fontsize', FLOAT );
  $ds9->colorbar( 'fontslant', ( 'italic' | 'roman' ) );
  $ds9->colorbar( 'fontweight', ( 'bold' | 'normal' ) );
  $ds9->colorbar( 'horizontal' );
  $ds9->colorbar( 'lock' );
  $ds9->colorbar( 'lock', 'state' );
  $ds9->colorbar( 'lock', BOOL );
  $ds9->colorbar( 'match' );
  $ds9->colorbar( 'numerics', BOOL );
  $ds9->colorbar( 'orientation', ( 'horizontal' | 'vertical' ) );
  $ds9->colorbar( 'size', INTEGER );
  $ds9->colorbar( 'space', ( 'distance' | 'value' ) );
  $ds9->colorbar( 'ticks', INTEGER );
  $ds9->colorbar( 'vertical' );
  $ds9->colorbar( BOOL );

  [ <font>:STRING ] = $ds9->colorbar( 'font' );

  [ <fontslant>:STRING ] = $ds9->colorbar( 'fontslant' );

  [ <fontweight>:STRING ] = $ds9->colorbar( 'fontweight' );

  [ <orientation>:STRING ] = $ds9->colorbar( 'orientation' );

  [ <space>:STRING ] = $ds9->colorbar( 'space' );

  [ BOOL ] = $ds9->colorbar( 'lock', 'state' );
  [ BOOL ] = $ds9->colorbar( 'numerics' );
  [ BOOL ] = $ds9->colorbar;

  [ FLOAT ] = $ds9->colorbar( 'fontsize' );

  [ INTEGER ] = $ds9->colorbar( 'size' );
  [ INTEGER ] = $ds9->colorbar( 'ticks' );

console

Not implemented

contour

  $ds9->contour( 'clear' );
  $ds9->contour( 'close' );
  $ds9->contour( 'color', COLOR );
  $ds9->contour( 'convert' );
  $ds9->contour( 'copy' );
  $ds9->contour( 'dash', BOOL );
  $ds9->contour( 'generate' );
  $ds9->contour( 'levels', ARRAY );
  $ds9->contour( 'limits', FLOAT, FLOAT );
  $ds9->contour( 'load', 'levels', <filename>:STRING );
  $ds9->contour( 'load', <filename>:STRING );
  $ds9->contour( 'log', 'exp', FLOAT );
  $ds9->contour( 'method', ( 'block' | 'smooth' ) );
  $ds9->contour( 'mode', ( 'minmax' | 'zmax' | 'zscale' ) );
  $ds9->contour( 'mode', FLOAT );
  $ds9->contour( 'nlevels', INTEGER );
  $ds9->contour( 'open' );
  $ds9->contour( 'paste' );
  $ds9->contour( 'paste', FRAME_COORD_SYSTEMS, COLOR, FLOAT, BOOL );
  $ds9->contour( 'save', 'levels', <filename>:STRING );
  $ds9->contour( 'save', <filename>:STRING, FRAME_COORD_SYSTEMS );
  $ds9->contour( 'save', <filename>:STRING, FRAME_COORD_SYSTEMS,
    SKYFRAME );

  $ds9->contour( 'scale', <scale>:STRING );
  $ds9->contour( 'scope', ( 'global' | 'local' ) );
  $ds9->contour( 'smooth', INTEGER );
  $ds9->contour( 'width', INTEGER );
  $ds9->contour( BOOL );
  $ds9->contour( FRAME_COORD_SYSTEMS );
  $ds9->contour( FRAME_COORD_SYSTEMS, SKYFRAME );

  [ <method>:STRING ] = $ds9->contour( 'method' );

  [ <mode>:STRING ] = $ds9->contour( 'mode' );

  [ <scale>:STRING ] = $ds9->contour( 'scale' );

  [ <scope>:STRING ] = $ds9->contour( 'scope' );

  [ ARRAY ] = $ds9->contour( 'levels' );

  [ BOOL ] = $ds9->contour( 'dash' );
  [ BOOL ] = $ds9->contour;

  [ COLOR ] = $ds9->contour( 'color' );

  [ FLOAT ] = $ds9->contour( 'log', 'exp' );
  [ FLOAT ] = $ds9->contour( 'mode' );

  [ FLOAT, FLOAT ] = $ds9->contour( 'limits' );

  [ INTEGER ] = $ds9->contour( 'nlevels' );
  [ INTEGER ] = $ds9->contour( 'smooth' );
  [ INTEGER ] = $ds9->contour( 'width' );

  [ STRING ] = $ds9->contour( FRAME_COORD_SYSTEMS );
  [ STRING ] = $ds9->contour( FRAME_COORD_SYSTEMS, SKYFRAME );

crop

  $ds9->crop( '3d', <x>:FLOAT, <y>:FLOAT );
  $ds9->crop( '3d', <x>:FLOAT, <y>:FLOAT, FRAME_COORD_SYSTEMS );

  $ds9->crop( 'close' );

  $ds9->crop( 'lock', 'none' );
  $ds9->crop( 'lock', FRAME_COORD_SYSTEMS );

  $ds9->crop( 'match', SKY_COORD_SYSTEMS | FRAME_COORD_SYSTEMS:STRING
    );

  $ds9->crop( 'open' );

  $ds9->crop( 'reset' );

  $ds9->crop( <ra>:DECIMAL_OR_SEXAGESIMAL,
    <dec>:DECIMAL_OR_SEXAGESIMAL, <width>:FLOAT, <height>:FLOAT );

  $ds9->crop( <ra>:DECIMAL_OR_SEXAGESIMAL,
    <dec>:DECIMAL_OR_SEXAGESIMAL, <width>:FLOAT, <height>:FLOAT,
    FRAME_COORD_SYSTEMS_NON_WCS );

  $ds9->crop( <ra>:DECIMAL_OR_SEXAGESIMAL,
    <dec>:DECIMAL_OR_SEXAGESIMAL, <width>:FLOAT, <height>:FLOAT,
    FRAME_COORD_SYSTEMS_NON_WCS, ( 'degrees' | 'sexagesimal' ) );

  $ds9->crop( <ra>:DECIMAL_OR_SEXAGESIMAL,
    <dec>:DECIMAL_OR_SEXAGESIMAL, <width>:FLOAT, <height>:FLOAT,
    SKYFRAME, ( 'arcmin' | 'arcsec' | 'degrees' ) );

  $ds9->crop( <ra>:DECIMAL_OR_SEXAGESIMAL,
    <dec>:DECIMAL_OR_SEXAGESIMAL, <width>:FLOAT, <height>:FLOAT, WCS, (
    'arcmin' | 'arcsec' | 'degrees' ) );

  $ds9->crop( <ra>:DECIMAL_OR_SEXAGESIMAL,
    <dec>:DECIMAL_OR_SEXAGESIMAL, <width>:FLOAT, <height>:FLOAT, WCS,
    SKYFRAME );

  $ds9->crop( <ra>:DECIMAL_OR_SEXAGESIMAL,
    <dec>:DECIMAL_OR_SEXAGESIMAL, <width>:FLOAT, <height>:FLOAT, WCS,
    SKYFRAME, ( 'arcmin' | 'arcsec' | 'degrees' ) );

  $ds9->crop( SKYFRAME );
  $ds9->crop( SKYFRAME, ( 'degrees' | 'sexagesimal' ) );
  $ds9->crop( SKYFRAME, ( 'degrees' | 'sexagesimal' ), ( 'arcmin' |
    'arcsec' | 'degrees' ) );

  $ds9->crop( WCS, SKYFRAME, ( 'degrees' | 'sexagesimal' ), ( 'arcmin'
    | 'arcsec' | 'degrees' ) );

  [ <x>:FLOAT, <y>:FLOAT ] = $ds9->crop( '3d' );
  [ <x>:FLOAT, <y>:FLOAT, <width>:FLOAT, <height>:FLOAT ] = $ds9->crop(
    SKYFRAME );

  [ <x>:FLOAT, <y>:FLOAT, <width>:FLOAT, <height>:FLOAT ] = $ds9->crop;

  [ <x>:STRING, <y>:STRING, <width>:FLOAT, <height>:FLOAT ] =
    $ds9->crop( SKYFRAME, ( 'degrees' | 'sexagesimal' ) );

  [ <x>:STRING, <y>:STRING, <width>:FLOAT, <height>:FLOAT ] =
    $ds9->crop( SKYFRAME, ( 'degrees' | 'sexagesimal' ), ( 'arcmin' |
    'arcsec' | 'degrees' ) );

  [ <x>:STRING, <y>:STRING, <width>:FLOAT, <height>:FLOAT ] =
    $ds9->crop( WCS, SKYFRAME, ( 'degrees' | 'sexagesimal' ), (
    'arcmin' | 'arcsec' | 'degrees' ) );

  [ FRAME_COORD_SYSTEMS ] = $ds9->crop( 'lock' );

crosshair

  $ds9->crosshair( 'lock', 'none' );
  $ds9->crosshair( 'lock', FRAME_COORD_SYSTEMS );
  $ds9->crosshair( 'match', SKY_COORD_SYSTEMS |
    FRAME_COORD_SYSTEMS:STRING );

  $ds9->crosshair( <ra>:DECIMAL_OR_SEXAGESIMAL,
    <dec>:DECIMAL_OR_SEXAGESIMAL, FRAME_COORD_SYSTEMS );

  $ds9->crosshair( <ra>:DECIMAL_OR_SEXAGESIMAL,
    <dec>:DECIMAL_OR_SEXAGESIMAL, FRAME_COORD_SYSTEMS, SKYFRAME );

  $ds9->crosshair( FRAME_COORD_SYSTEMS );
  $ds9->crosshair( FRAME_COORD_SYSTEMS, ( 'degrees' | 'sexagesimal' )
    );

  $ds9->crosshair( FRAME_COORD_SYSTEMS, SKYFRAME );
  $ds9->crosshair( FRAME_COORD_SYSTEMS, SKYFRAME, ( 'degrees' |
    'sexagesimal' ) );

  [ <ra>:STRING, <dec>:STRING ] = $ds9->crosshair( FRAME_COORD_SYSTEMS
    );

  [ <ra>:STRING, <dec>:STRING ] = $ds9->crosshair( FRAME_COORD_SYSTEMS,
    ( 'degrees' | 'sexagesimal' ) );

  [ <ra>:STRING, <dec>:STRING ] = $ds9->crosshair( FRAME_COORD_SYSTEMS,
    SKYFRAME );

  [ <ra>:STRING, <dec>:STRING ] = $ds9->crosshair( FRAME_COORD_SYSTEMS,
    SKYFRAME, ( 'degrees' | 'sexagesimal' ) );

  [ <ra>:STRING, <dec>:STRING ] = $ds9->crosshair;

  [ FRAME_COORD_SYSTEMS ] = $ds9->crosshair( 'lock' );

cube

  $ds9->cube( 'axes', 'lock', BOOL );
  $ds9->cube( 'axis', INTEGER );

  $ds9->cube( 'close' );

  $ds9->cube( 'first' );

  $ds9->cube( 'interval', FLOAT );

  $ds9->cube( 'last' );
  $ds9->cube( 'lock', (CUBE_COORD_SYSTEMS | 'none') );

  $ds9->cube( 'match', CUBE_COORD_SYSTEMS );

  $ds9->cube( 'next' );

  $ds9->cube( 'open' );
  $ds9->cube( 'order', ( '123' | '132' | '213' | '231' | '312' | '321'
    ) );

  $ds9->cube( 'play' );
  $ds9->cube( 'prev' );

  $ds9->cube( 'slice', FLOAT, WCS system );
  $ds9->cube( 'slice', INTEGER );
  $ds9->cube( 'stop' );

  [ ( '123' | '132' | '213' | '231' | '312' | '321' ) ] = $ds9->cube(
    'order' );

  [ (CUBE_COORD_SYSTEMS | 'none') ] = $ds9->cube( 'lock' );

  [ BOOL ] = $ds9->cube( 'axes', 'lock' );
  [ BOOL ] = $ds9->cube( WCS );

  [ FLOAT ] = $ds9->cube( 'interval' );

  [ INTEGER ] = $ds9->cube( 'axis' );

cursor

  $ds9->cursor( <x>:FLOAT, <y>:FLOAT );

data

Not implemented

dsseso

  $ds9->dsseso( 'close' );
  $ds9->dsseso( 'coord', <ra>:DECIMAL_OR_SEXAGESIMAL,
    <dec>:DECIMAL_OR_SEXAGESIMAL );

  $ds9->dsseso( 'frame', ( 'current' | 'new' ) );
  $ds9->dsseso( 'name', STRING );
  $ds9->dsseso( 'open' );
  $ds9->dsseso( 'save', BOOL );
  $ds9->dsseso( 'size', <x>:FLOAT, <y>:FLOAT, ( 'arcmin' | 'arcsec' |
    'degrees' ) );

  $ds9->dsseso( 'survey', DSS_ESO_SURVEYS );
  $ds9->dsseso( 'update', ( 'crosshair' | 'frame' ) );
  $ds9->dsseso( <ra>:DECIMAL_OR_SEXAGESIMAL,
    <dec>:DECIMAL_OR_SEXAGESIMAL );

  $ds9->dsseso( STRING );

  [ <ra>:DECIMAL_OR_SEXAGESIMAL, <dec>:DECIMAL_OR_SEXAGESIMAL, STRING ]
    = $ds9->dsseso( 'coord' );

  [ <survey>:STRING ] = $ds9->dsseso( 'survey' );

  [ <x>:FLOAT, <y>:FLOAT, ( 'arcmin' | 'arcsec' | 'degrees' ) ] =
    $ds9->dsseso( 'size' );

  [ BOOL ] = $ds9->dsseso( 'save' );

  [ STRING ] = $ds9->dsseso( 'frame' );
  [ STRING ] = $ds9->dsseso( 'name' );
  [ STRING ] = $ds9->dsseso;

dsssao

  $ds9->dsssao( 'close' );
  $ds9->dsssao( 'coord', <ra>:DECIMAL_OR_SEXAGESIMAL,
    <dec>:DECIMAL_OR_SEXAGESIMAL );

  $ds9->dsssao( 'frame', ( 'current' | 'new' ) );
  $ds9->dsssao( 'name', STRING );
  $ds9->dsssao( 'open' );
  $ds9->dsssao( 'save', BOOL );
  $ds9->dsssao( 'size', <x>:FLOAT, <y>:FLOAT, ( 'arcmin' | 'arcsec' |
    'degrees' ) );

  $ds9->dsssao( 'update', ( 'crosshair' | 'frame' ) );
  $ds9->dsssao( <ra>:DECIMAL_OR_SEXAGESIMAL,
    <dec>:DECIMAL_OR_SEXAGESIMAL );

  $ds9->dsssao( STRING );

  [ <ra>:DECIMAL_OR_SEXAGESIMAL, <dec>:DECIMAL_OR_SEXAGESIMAL, STRING ]
    = $ds9->dsssao( 'coord' );

  [ <x>:FLOAT, <y>:FLOAT, ( 'arcmin' | 'arcsec' | 'degrees' ) ] =
    $ds9->dsssao( 'size' );

  [ BOOL ] = $ds9->dsssao( 'save' );

  [ STRING ] = $ds9->dsssao( 'frame' );
  [ STRING ] = $ds9->dsssao( 'name' );
  [ STRING ] = $ds9->dsssao;

dssstsci

  $ds9->dssstsci( 'close' );
  $ds9->dssstsci( 'coord', <ra>:DECIMAL_OR_SEXAGESIMAL,
    <dec>:DECIMAL_OR_SEXAGESIMAL );

  $ds9->dssstsci( 'frame', ( 'current' | 'new' ) );
  $ds9->dssstsci( 'name', STRING );
  $ds9->dssstsci( 'open' );
  $ds9->dssstsci( 'save', BOOL );
  $ds9->dssstsci( 'size', <x>:FLOAT, <y>:FLOAT, ( 'arcmin' | 'arcsec' |
    'degrees' ) );

  $ds9->dssstsci( 'survey', DSS_STSCI_SURVEYS );
  $ds9->dssstsci( 'update', ( 'crosshair' | 'frame' ) );
  $ds9->dssstsci( <ra>:DECIMAL_OR_SEXAGESIMAL,
    <dec>:DECIMAL_OR_SEXAGESIMAL );

  $ds9->dssstsci( STRING );

  [ <ra>:DECIMAL_OR_SEXAGESIMAL, <dec>:DECIMAL_OR_SEXAGESIMAL, STRING ]
    = $ds9->dssstsci( 'coord' );

  [ <survey>:STRING ] = $ds9->dssstsci( 'survey' );

  [ <x>:FLOAT, <y>:FLOAT, ( 'arcmin' | 'arcsec' | 'degrees' ) ] =
    $ds9->dssstsci( 'size' );

  [ BOOL ] = $ds9->dssstsci( 'save' );

  [ STRING ] = $ds9->dssstsci( 'frame' );
  [ STRING ] = $ds9->dssstsci( 'name' );
  [ STRING ] = $ds9->dssstsci;

envi

Not implemented

exit

  $ds9->exit;

export

  $ds9->export( 'array', <filename>:STRING );
  $ds9->export( 'array', <filename>:STRING, ( 'big' | 'little' |
    'native' ) );

  $ds9->export( 'envi', <filename>:STRING );
  $ds9->export( 'envi', STRING, STRING, ( 'big' | 'little' | 'native' )
    );

  $ds9->export( 'gif', <filename>:STRING );
  $ds9->export( 'jpeg', <filename>:STRING, <quality>:INTEGER );
  $ds9->export( 'nrrd', <filename>:STRING );
  $ds9->export( 'nrrd', <filename>:STRING, ( 'big' | 'little' |
    'native' ) );

  $ds9->export( 'png', <filename>:STRING );
  $ds9->export( 'tiff', <filename>:STRING );
  $ds9->export( 'tiff', <filename>:STRING, ( 'deflate' | 'jpeg' |
    'none' | 'packbits' ) );

fade

Not implemented

file

  [ STRING ] = $ds9->file;

fits

  $ds9->fits( 'header', 'keyword', STRING );
  $ds9->fits( 'header', INTEGER );
  $ds9->fits( 'header', INTEGER, 'keyword', STRING );

  $ds9->fits( 'size' );
  $ds9->fits( 'size', ( 'arcmin' | 'arcsec' | 'degrees' ) );
  $ds9->fits( 'size', SKYFRAME, ( 'arcmin' | 'arcsec' | 'degrees' ) );
  $ds9->fits( 'size', WCS, ( 'arcmin' | 'arcsec' | 'degrees' ) );
  $ds9->fits( 'size', WCS, SKYFRAME, ( 'arcmin' | 'arcsec' | 'degrees'
    ) );

  $ds9->fits( <filename>:STRING, ?{ new => BOOL, mask => BOOL, extname
    => STRING, filter => STRING, bin => ARRAY } );

  $ds9->fits( \$buffer:SCALARREF, ?{ new => BOOL, mask => BOOL, extname
    => STRING, filter => STRING, bin => ARRAY } );

  [ <x>:FLOAT, <y>:FLOAT ] = $ds9->fits( 'size' );
  [ <x>:FLOAT, <y>:FLOAT ] = $ds9->fits( 'size', ( 'arcmin' | 'arcsec'
    | 'degrees' ) );

  [ <x>:FLOAT, <y>:FLOAT ] = $ds9->fits( 'size', SKYFRAME, ( 'arcmin' |
    'arcsec' | 'degrees' ) );

  [ <x>:FLOAT, <y>:FLOAT ] = $ds9->fits( 'size', WCS, ( 'arcmin' |
    'arcsec' | 'degrees' ) );

  [ <x>:FLOAT, <y>:FLOAT ] = $ds9->fits( 'size', WCS, SKYFRAME, (
    'arcmin' | 'arcsec' | 'degrees' ) );

  [ INTEGER ] = $ds9->fits( 'bitpix' );
  [ INTEGER ] = $ds9->fits( 'depth' );
  [ INTEGER ] = $ds9->fits( 'height' );
  [ INTEGER ] = $ds9->fits( 'width' );

  [ STRING ] = $ds9->fits( 'header' );
  [ STRING ] = $ds9->fits( 'header', 'keyword', STRING );
  [ STRING ] = $ds9->fits( 'header', INTEGER );
  [ STRING ] = $ds9->fits( 'header', INTEGER, 'keyword', STRING );
  [ STRING ] = $ds9->fits( 'image' );
  [ STRING ] = $ds9->fits( 'slice' );
  [ STRING ] = $ds9->fits( 'table' );
  [ STRING ] = $ds9->fits;

footprint

Not implemented

fp

Not implemented

frame

  $ds9->frame( 'center' );
  $ds9->frame( 'center', 'all' );
  $ds9->frame( 'center', INTEGER );
  $ds9->frame( 'clear' );
  $ds9->frame( 'clear', 'all' );
  $ds9->frame( 'clear', INTEGER );
  $ds9->frame( 'delete' );
  $ds9->frame( 'delete', 'all' );
  $ds9->frame( 'delete', INTEGER );
  $ds9->frame( 'deleteall' );
  $ds9->frame( 'first' );
  $ds9->frame( 'frameno', INTEGER );
  $ds9->frame( 'has', 'contour', 'aux' );
  $ds9->frame( 'has', 'fits', ( 'bin' | 'cube' | 'mosaic' ) );
  $ds9->frame( 'has', 'marker', ( 'highlite' | 'paste' | 'select' |
    'undo' ) );

  $ds9->frame( 'has', 'system', FRAME_COORD_SYSTEMS );
  $ds9->frame( 'has', 'wcs', ( 'celestial' | 'linear' ) );
  $ds9->frame( 'has', 'wcs', ( 'celestial' | 'linear' ), WCS system );
  $ds9->frame( 'has', 'wcs', WCS system );
  $ds9->frame( 'has', FRAME_COMPONENTS );
  $ds9->frame( 'hide' );
  $ds9->frame( 'hide', 'all' );
  $ds9->frame( 'hide', INTEGER );
  $ds9->frame( 'last' );
  $ds9->frame( 'lock', 'none' );
  $ds9->frame( 'lock', FRAME_COORD_SYSTEMS );
  $ds9->frame( 'match', FRAME_COORD_SYSTEMS );
  $ds9->frame( 'move', ( 'back' | 'first' | 'forward' | 'last' ) );
  $ds9->frame( 'new' );
  $ds9->frame( 'new', ( '3d' | 'rgb' ) );
  $ds9->frame( 'next' );
  $ds9->frame( 'prev' );
  $ds9->frame( 'refresh' );
  $ds9->frame( 'refresh', 'all' );
  $ds9->frame( 'refresh', INTEGER );
  $ds9->frame( 'reset' );
  $ds9->frame( 'reset', 'all' );
  $ds9->frame( 'reset', INTEGER );
  $ds9->frame( 'show' );
  $ds9->frame( 'show', 'all' );
  $ds9->frame( 'show', INTEGER );

  $ds9->frame( INTEGER );

  [ 'none' ] = $ds9->frame( 'lock' );

  [ ARRAY ] = $ds9->frame( 'active' );
  [ ARRAY ] = $ds9->frame( 'all' );

  [ BOOL ] = $ds9->frame( 'has', 'contour' );
  [ BOOL ] = $ds9->frame( 'has', 'contour', 'aux' );
  [ BOOL ] = $ds9->frame( 'has', 'fits' );
  [ BOOL ] = $ds9->frame( 'has', 'fits', ( 'bin' | 'cube' | 'mosaic' )
    );

  [ BOOL ] = $ds9->frame( 'has', 'marker', ( 'highlite' | 'paste' |
    'select' | 'undo' ) );

  [ BOOL ] = $ds9->frame( 'has', 'system', FRAME_COORD_SYSTEMS );
  [ BOOL ] = $ds9->frame( 'has', 'wcs' );
  [ BOOL ] = $ds9->frame( 'has', 'wcs', ( 'celestial' | 'linear' ) );
  [ BOOL ] = $ds9->frame( 'has', 'wcs', ( 'celestial' | 'linear' ), WCS
    system );

  [ BOOL ] = $ds9->frame( 'has', 'wcs', WCS system );
  [ BOOL ] = $ds9->frame( 'has', FRAME_COMPONENTS );

  [ FRAME_COORD_SYSTEMS ] = $ds9->frame( 'lock' );

  [ INTEGER ] = $ds9->frame( 'frameno' );
  [ INTEGER ] = $ds9->frame;

gif

  $ds9->gif( 'new', <filename>:STRING );
  $ds9->gif( 'new', SCALARREF );

  $ds9->gif( 'slice', <filename>:STRING );
  $ds9->gif( 'slice', SCALARREF );

  $ds9->gif( <filename>:STRING );

  $ds9->gif( SCALARREF );

  [ STRING ] = $ds9->gif;

graph

Not implemented

grid

  $ds9->grid( 'axes', 'color', COLOR );
  $ds9->grid( 'axes', 'dash', BOOL );
  $ds9->grid( 'axes', 'origin', ORIGIN );
  $ds9->grid( 'axes', 'type', ( 'external' | 'internal' ) );
  $ds9->grid( 'axes', 'width', INTEGER );
  $ds9->grid( 'axes', BOOL );

  $ds9->grid( 'border', 'color', COLOR );
  $ds9->grid( 'border', 'dash', BOOL );
  $ds9->grid( 'border', 'width', INTEGER );
  $ds9->grid( 'border', BOOL );

  $ds9->grid( 'close' );

  $ds9->grid( 'format1', STRING );
  $ds9->grid( 'format2', STRING );

  $ds9->grid( 'grid', 'color', COLOR );
  $ds9->grid( 'grid', 'dash', BOOL );
  $ds9->grid( 'grid', 'gap1', FLOAT );
  $ds9->grid( 'grid', 'gap2', FLOAT );
  $ds9->grid( 'grid', 'gap3', FLOAT );
  $ds9->grid( 'grid', 'width', INTEGER );
  $ds9->grid( 'grid', BOOL );

  $ds9->grid( 'labels', 'color', COLOR );
  $ds9->grid( 'labels', 'def1', BOOL );
  $ds9->grid( 'labels', 'def2', BOOL );
  $ds9->grid( 'labels', 'font', ( 'courier' | 'helvetica' | 'times' )
    );

  $ds9->grid( 'labels', 'fontsize', FLOAT );
  $ds9->grid( 'labels', 'fontslant', ( 'italic' | 'roman' ) );
  $ds9->grid( 'labels', 'fontweight', ( 'bold' | 'normal' ) );
  $ds9->grid( 'labels', 'gap1', FLOAT );
  $ds9->grid( 'labels', 'gap2', FLOAT );
  $ds9->grid( 'labels', 'text1', STRING );
  $ds9->grid( 'labels', 'text2', STRING );
  $ds9->grid( 'labels', BOOL );
  $ds9->grid( 'load', <filename>:STRING );

  $ds9->grid( 'numerics', 'color', COLOR );
  $ds9->grid( 'numerics', 'font', ( 'courier' | 'helvetica' | 'times' )
    );

  $ds9->grid( 'numerics', 'fontsize', FLOAT );
  $ds9->grid( 'numerics', 'fontslant', ( 'italic' | 'roman' ) );
  $ds9->grid( 'numerics', 'fontweight', ( 'bold' | 'normal' ) );
  $ds9->grid( 'numerics', 'gap1', FLOAT );
  $ds9->grid( 'numerics', 'gap2', FLOAT );
  $ds9->grid( 'numerics', 'gap3', FLOAT );
  $ds9->grid( 'numerics', 'type', ( 'external' | 'internal' ) );
  $ds9->grid( 'numerics', 'vertical', BOOL );
  $ds9->grid( 'numerics', BOOL );

  $ds9->grid( 'open' );

  $ds9->grid( 'reset' );

  $ds9->grid( 'save', <filename>:STRING );
  $ds9->grid( 'sky', SKYFRAME );
  $ds9->grid( 'skyformat', ( 'degrees' | 'sexagesimal' ) );
  $ds9->grid( 'system', FRAME_COORD_SYSTEMS );

  $ds9->grid( 'tickmarks', 'color', COLOR );
  $ds9->grid( 'tickmarks', 'dash', BOOL );
  $ds9->grid( 'tickmarks', 'width', INTEGER );
  $ds9->grid( 'tickmarks', BOOL );
  $ds9->grid( 'title', 'color', COLOR );
  $ds9->grid( 'title', 'def', BOOL );
  $ds9->grid( 'title', 'font', ( 'courier' | 'helvetica' | 'times' ) );
  $ds9->grid( 'title', 'fontsize', FLOAT );
  $ds9->grid( 'title', 'fontslant', ( 'italic' | 'roman' ) );
  $ds9->grid( 'title', 'fontweight', ( 'bold' | 'normal' ) );
  $ds9->grid( 'title', 'gap', FLOAT );
  $ds9->grid( 'title', 'text', STRING );
  $ds9->grid( 'title', BOOL );
  $ds9->grid( 'type', ( 'analysis' | 'publication' ) );

  $ds9->grid( BOOL );

  [ ( 'degrees' | 'sexagesimal' ) ] = $ds9->grid( 'skyformat' );

  [ <font>:STRING ] = $ds9->grid( 'labels', 'font' );
  [ <font>:STRING ] = $ds9->grid( 'numerics', 'font' );
  [ <font>:STRING ] = $ds9->grid( 'title', 'font' );

  [ <fontslant>:STRING ] = $ds9->grid( 'labels', 'fontslant' );
  [ <fontslant>:STRING ] = $ds9->grid( 'numerics', 'fontslant' );

  [ <fontslants>:STRING ] = $ds9->grid( 'title', 'fontslant' );

  [ <fontweight>:STRING ] = $ds9->grid( 'labels', 'fontweight' );
  [ <fontweight>:STRING ] = $ds9->grid( 'numerics', 'fontweight' );
  [ <fontweight>:STRING ] = $ds9->grid( 'title', 'fontweight' );

  [ <origin>:STRING ] = $ds9->grid( 'axes', 'origin' );

  [ <type>:STRING ] = $ds9->grid( 'axes', 'type' );
  [ <type>:STRING ] = $ds9->grid( 'numerics', 'type' );
  [ <type>:STRING ] = $ds9->grid( 'type' );

  [ BOOL ] = $ds9->grid( 'axes' );
  [ BOOL ] = $ds9->grid( 'axes', 'dash' );
  [ BOOL ] = $ds9->grid( 'border' );
  [ BOOL ] = $ds9->grid( 'border', 'dash' );
  [ BOOL ] = $ds9->grid( 'grid' );
  [ BOOL ] = $ds9->grid( 'grid', 'dash' );
  [ BOOL ] = $ds9->grid( 'labels' );
  [ BOOL ] = $ds9->grid( 'labels', 'def1' );
  [ BOOL ] = $ds9->grid( 'labels', 'def2' );
  [ BOOL ] = $ds9->grid( 'numerics' );
  [ BOOL ] = $ds9->grid( 'numerics', 'vertical' );
  [ BOOL ] = $ds9->grid( 'tickmarks' );
  [ BOOL ] = $ds9->grid( 'tickmarks', 'dash' );
  [ BOOL ] = $ds9->grid( 'title' );
  [ BOOL ] = $ds9->grid( 'title', 'def' );
  [ BOOL ] = $ds9->grid;

  [ COLOR ] = $ds9->grid( 'axes', 'color' );
  [ COLOR ] = $ds9->grid( 'border', 'color' );
  [ COLOR ] = $ds9->grid( 'grid', 'color' );
  [ COLOR ] = $ds9->grid( 'labels', 'color' );
  [ COLOR ] = $ds9->grid( 'numerics', 'color' );
  [ COLOR ] = $ds9->grid( 'tickmarks', 'color' );
  [ COLOR ] = $ds9->grid( 'title', 'color' );

  [ FLOAT ] = $ds9->grid( 'grid', 'gap1' );
  [ FLOAT ] = $ds9->grid( 'grid', 'gap2' );
  [ FLOAT ] = $ds9->grid( 'grid', 'gap3' );
  [ FLOAT ] = $ds9->grid( 'labels', 'fontsize' );
  [ FLOAT ] = $ds9->grid( 'labels', 'gap1' );
  [ FLOAT ] = $ds9->grid( 'labels', 'gap2' );
  [ FLOAT ] = $ds9->grid( 'numerics', 'fontsize' );
  [ FLOAT ] = $ds9->grid( 'numerics', 'gap1' );
  [ FLOAT ] = $ds9->grid( 'numerics', 'gap2' );
  [ FLOAT ] = $ds9->grid( 'numerics', 'gap3' );
  [ FLOAT ] = $ds9->grid( 'title', 'fontsize' );
  [ FLOAT ] = $ds9->grid( 'title', 'gap' );

  [ FRAME_COORD_SYSTEMS ] = $ds9->grid( 'system' );

  [ INTEGER ] = $ds9->grid( 'axes', 'width' );
  [ INTEGER ] = $ds9->grid( 'border', 'width' );
  [ INTEGER ] = $ds9->grid( 'grid', 'width' );
  [ INTEGER ] = $ds9->grid( 'tickmarks', 'width' );

  [ SKYFRAME ] = $ds9->grid( 'sky' );

  [ STRING ] = $ds9->grid( 'format1' );
  [ STRING ] = $ds9->grid( 'format2' );
  [ STRING ] = $ds9->grid( 'labels', 'text1' );
  [ STRING ] = $ds9->grid( 'labels', 'text2' );
  [ STRING ] = $ds9->grid( 'title', 'text' );

  $ds9->header( 'close' );
  $ds9->header( 'close', INTEGER );
  $ds9->header( 'save', <filename>:STRING );
  $ds9->header( 'save', INTEGER, <filename>:STRING );
  $ds9->header( INTEGER );

  $ds9->header;

height

  $ds9->height( INTEGER );

  [ INTEGER ] = $ds9->height;

iconify

  $ds9->iconify( BOOL );

  [ BOOL ] = $ds9->iconify;

iis

Not implemented

illustrate

Not implemented

ixem

Not implemented

jpeg

  $ds9->jpeg( 'new', SCALARREF );
  $ds9->jpeg( 'new', STRING );

  $ds9->jpeg( 'slice', SCALARREF );
  $ds9->jpeg( 'slice', STRING );

  $ds9->jpeg( <filename>:STRING );

  $ds9->jpeg( INTEGER );

  $ds9->jpeg( SCALARREF );

  [ STRING ] = $ds9->jpeg( INTEGER );
  [ STRING ] = $ds9->jpeg;

lock

  $ds9->lock( '3d', BOOL );

  $ds9->lock( 'axes', BOOL );

  $ds9->lock( 'bin', BOOL );
  $ds9->lock( 'block', BOOL );

  $ds9->lock( 'colorbar', BOOL );
  $ds9->lock( 'crop', 'none' );
  $ds9->lock( 'crop', FRAME_COORD_SYSTEMS );
  $ds9->lock( 'crosshair', 'none' );
  $ds9->lock( 'crosshair', FRAME_COORD_SYSTEMS );

  $ds9->lock( 'frame', 'none' );
  $ds9->lock( 'frame', FRAME_COORD_SYSTEMS );

  $ds9->lock( 'scale', BOOL );
  $ds9->lock( 'scalelimits', BOOL );
  $ds9->lock( 'slice', 'none' );
  $ds9->lock( 'slice', FRAME_COORD_SYSTEMS );
  $ds9->lock( 'smooth', BOOL );

  [ BOOL ] = $ds9->lock( '3d' );
  [ BOOL ] = $ds9->lock( 'axes' );
  [ BOOL ] = $ds9->lock( 'bin' );
  [ BOOL ] = $ds9->lock( 'block' );
  [ BOOL ] = $ds9->lock( 'colorbar' );
  [ BOOL ] = $ds9->lock( 'scale' );
  [ BOOL ] = $ds9->lock( 'scalelimits' );
  [ BOOL ] = $ds9->lock( 'smooth' );

  [ FRAME_COORD_SYSTEMS ] = $ds9->lock( 'crop' );
  [ FRAME_COORD_SYSTEMS ] = $ds9->lock( 'crosshair' );
  [ FRAME_COORD_SYSTEMS ] = $ds9->lock( 'frame' );
  [ FRAME_COORD_SYSTEMS ] = $ds9->lock( 'slice' );

lower

  $ds9->lower;

magnifier

Not implemented

mask

  $ds9->mask( 'blend', ( 'darken' | 'lighten' | 'screen' | 'source' )
    );

  $ds9->mask( 'clear' );
  $ds9->mask( 'close' );
  $ds9->mask( 'color', COLOR );

  $ds9->mask( 'load', <filename>:STRING );

  $ds9->mask( 'mark', MARK );

  $ds9->mask( 'open' );

  $ds9->mask( 'range', <low>:FLOAT, <high>:FLOAT );

  $ds9->mask( 'system', FRAME_COORD_SYSTEMS );

  $ds9->mask( 'transparency', FLOAT );

  [ <blend>:STRING ] = $ds9->mask( 'blend' );

  [ <low>:FLOAT, <high>:FLOAT ] = $ds9->mask( 'range' );

  [ <mark>:STRING ] = $ds9->mask( 'mark' );

  [ COLOR ] = $ds9->mask( 'color' );

  [ FLOAT ] = $ds9->mask( 'transparency' );

  [ FRAME_COORD_SYSTEMS ] = $ds9->mask( 'system' );

match

  $ds9->match( '3d' );
  $ds9->match( 'axes' );
  $ds9->match( 'bin' );
  $ds9->match( 'block' );
  $ds9->match( 'colobar' );
  $ds9->match( 'crop', FRAME_COORD_SYSTEMS );
  $ds9->match( 'crosshair', FRAME_COORD_SYSTEMS );
  $ds9->match( 'frame', FRAME_COORD_SYSTEMS );
  $ds9->match( 'scale' );
  $ds9->match( 'scalelimits' );
  $ds9->match( 'slice', FRAME_COORD_SYSTEMS );
  $ds9->match( 'smooth' );

mecube

Not implemented

minmax

  $ds9->minmax( 'interval', INTEGER );
  $ds9->minmax( 'mode', ( 'datamin' | 'irafmin' | 'sample' | 'scan' )
    );

  $ds9->minmax( 'rescan' );
  $ds9->minmax( ( 'datamin' | 'irafmin' | 'sample' | 'scan' ) );

  [ <mode>:STRING ] = $ds9->minmax( 'mode' );
  [ <mode>:STRING ] = $ds9->minmax;

  [ INTEGER ] = $ds9->minmax( 'interval' );

mode

  $ds9->mode( MOUSE_BUTTON_MODES );

  [ <modes>:STRING ] = $ds9->mode;

mosaic

  $ds9->mosaic( <filename>:STRING );
  $ds9->mosaic( ENUM, ( 'mask' | 'new' ), <filename>:STRING );
  $ds9->mosaic( ENUM, <filename>:STRING );
  $ds9->mosaic( SCALARREF );
  $ds9->mosaic( SCALARREF, ENUM );
  $ds9->mosaic( SCALARREF, ENUM, ( 'mask' | 'new' ) );

  [ STRING ] = $ds9->mosaic;

mosaicimage

  $ds9->mosaicimage( <filename>:STRING );
  $ds9->mosaicimage( ENUM, ( 'mask' | 'new' ), <filename>:STRING );
  $ds9->mosaicimage( ENUM, <filename>:STRING );
  $ds9->mosaicimage( SCALARREF );
  $ds9->mosaicimage( SCALARREF, ENUM );
  $ds9->mosaicimage( SCALARREF, ENUM, ( 'mask' | 'new' ) );

movie

Not implemented

multiframe

Not implemented

nameserver

  $ds9->nameserver( 'close' );
  $ds9->nameserver( 'name', STRING );
  $ds9->nameserver( 'open' );
  $ds9->nameserver( 'server', NAMESERVERS );
  $ds9->nameserver( 'skyformat', ( 'degrees' | 'sexagesimal' ) );
  $ds9->nameserver( STRING );

  [ ( 'degrees' | 'sexagesimal' ) ] = $ds9->nameserver( 'skyformat' );

  [ <nameserver>:STRING ] = $ds9->nameserver( 'server' );

  [ STRING ] = $ds9->nameserver( 'name' );
  [ STRING ] = $ds9->nameserver;

notes

Not implemented

nrrd

Not implemented

nvss

Not implemented

orient

  $ds9->orient( 'close' );
  $ds9->orient( 'open' );
  $ds9->orient( ( 'none' | 'x' | 'xy' | 'y' ) );

  [ <orientation>:STRING ] = $ds9->orient;

pagesetup

  $ds9->pagesetup( 'orient', ( 'landscape' | 'portrait' ) );
  $ds9->pagesetup( 'scale', FLOAT );
  $ds9->pagesetup( 'size', PAGE_SIZES );

  [ <orient>:STRING ] = $ds9->pagesetup( 'orient' );

  [ <size>:STRING ] = $ds9->pagesetup( 'size' );

  [ FLOAT ] = $ds9->pagesetup( 'scale' );

pan

  $ds9->pan( 'abs', <ra>:DECIMAL_OR_SEXAGESIMAL,
    <dec>:DECIMAL_OR_SEXAGESIMAL );

  $ds9->pan( 'abs', <ra>:DECIMAL_OR_SEXAGESIMAL,
    <dec>:DECIMAL_OR_SEXAGESIMAL, FRAME_COORD_SYSTEMS );

  $ds9->pan( 'abs', <ra>:DECIMAL_OR_SEXAGESIMAL,
    <dec>:DECIMAL_OR_SEXAGESIMAL, FRAME_COORD_SYSTEMS, ( 'degrees' |
    'sexagesimal' ) );

  $ds9->pan( 'abs', <ra>:DECIMAL_OR_SEXAGESIMAL,
    <dec>:DECIMAL_OR_SEXAGESIMAL, FRAME_COORD_SYSTEMS, SKYFRAME );

  $ds9->pan( 'abs', <ra>:DECIMAL_OR_SEXAGESIMAL,
    <dec>:DECIMAL_OR_SEXAGESIMAL, FRAME_COORD_SYSTEMS, SKYFRAME, (
    'degrees' | 'sexagesimal' ) );

  $ds9->pan( 'close' );

  $ds9->pan( 'open' );

  $ds9->pan( 'rel', <ra>:DECIMAL_OR_SEXAGESIMAL,
    <dec>:DECIMAL_OR_SEXAGESIMAL );

  $ds9->pan( 'rel', <ra>:DECIMAL_OR_SEXAGESIMAL,
    <dec>:DECIMAL_OR_SEXAGESIMAL, FRAME_COORD_SYSTEMS );

  $ds9->pan( 'rel', <ra>:DECIMAL_OR_SEXAGESIMAL,
    <dec>:DECIMAL_OR_SEXAGESIMAL, FRAME_COORD_SYSTEMS, ( 'degrees' |
    'sexagesimal' ) );

  $ds9->pan( 'rel', <ra>:DECIMAL_OR_SEXAGESIMAL,
    <dec>:DECIMAL_OR_SEXAGESIMAL, FRAME_COORD_SYSTEMS, SKYFRAME );

  $ds9->pan( 'rel', <ra>:DECIMAL_OR_SEXAGESIMAL,
    <dec>:DECIMAL_OR_SEXAGESIMAL, FRAME_COORD_SYSTEMS, SKYFRAME, (
    'degrees' | 'sexagesimal' ) );

  $ds9->pan( 'to', <ra>:DECIMAL_OR_SEXAGESIMAL,
    <dec>:DECIMAL_OR_SEXAGESIMAL );

  $ds9->pan( 'to', <ra>:DECIMAL_OR_SEXAGESIMAL,
    <dec>:DECIMAL_OR_SEXAGESIMAL, FRAME_COORD_SYSTEMS );

  $ds9->pan( 'to', <ra>:DECIMAL_OR_SEXAGESIMAL,
    <dec>:DECIMAL_OR_SEXAGESIMAL, FRAME_COORD_SYSTEMS, ( 'degrees' |
    'sexagesimal' ) );

  $ds9->pan( 'to', <ra>:DECIMAL_OR_SEXAGESIMAL,
    <dec>:DECIMAL_OR_SEXAGESIMAL, FRAME_COORD_SYSTEMS, SKYFRAME );

  $ds9->pan( 'to', <ra>:DECIMAL_OR_SEXAGESIMAL,
    <dec>:DECIMAL_OR_SEXAGESIMAL, FRAME_COORD_SYSTEMS, SKYFRAME, (
    'degrees' | 'sexagesimal' ) );

  $ds9->pan( <ra>:DECIMAL_OR_SEXAGESIMAL, <dec>:DECIMAL_OR_SEXAGESIMAL
    );

  $ds9->pan( <ra>:DECIMAL_OR_SEXAGESIMAL, <dec>:DECIMAL_OR_SEXAGESIMAL,
    FRAME_COORD_SYSTEMS );

  $ds9->pan( <ra>:DECIMAL_OR_SEXAGESIMAL, <dec>:DECIMAL_OR_SEXAGESIMAL,
    FRAME_COORD_SYSTEMS, ( 'degrees' | 'sexagesimal' ) );

  $ds9->pan( <ra>:DECIMAL_OR_SEXAGESIMAL, <dec>:DECIMAL_OR_SEXAGESIMAL,
    FRAME_COORD_SYSTEMS, SKYFRAME );

  $ds9->pan( <ra>:DECIMAL_OR_SEXAGESIMAL, <dec>:DECIMAL_OR_SEXAGESIMAL,
    FRAME_COORD_SYSTEMS, SKYFRAME, ( 'degrees' | 'sexagesimal' ) );

  $ds9->pan( FRAME_COORD_SYSTEMS );
  $ds9->pan( FRAME_COORD_SYSTEMS, ( 'degrees' | 'sexagesimal' ) );
  $ds9->pan( FRAME_COORD_SYSTEMS, SKYFRAME );
  $ds9->pan( FRAME_COORD_SYSTEMS, SKYFRAME, ( 'degrees' | 'sexagesimal'
    ) );

  $ds9->pan;

  [ STRING, STRING ] = $ds9->pan( FRAME_COORD_SYSTEMS );
  [ STRING, STRING ] = $ds9->pan( FRAME_COORD_SYSTEMS, ( 'degrees' |
    'sexagesimal' ) );

  [ STRING, STRING ] = $ds9->pan( FRAME_COORD_SYSTEMS, SKYFRAME );
  [ STRING, STRING ] = $ds9->pan( FRAME_COORD_SYSTEMS, SKYFRAME, (
    'degrees' | 'sexagesimal' ) );

  [ STRING, STRING ] = $ds9->pan;

pixeltable

  $ds9->pixeltable( ( 'close' | 'open' ) );
  $ds9->pixeltable( BOOL );

  [ ( 'close' | 'open' ) ] = $ds9->pixeltable;

  [ BOOL ] = $ds9->pixeltable;

plot

Not implemented

png

  $ds9->png( 'new', SCALARREF );
  $ds9->png( 'new', STRING );

  $ds9->png( 'slice', SCALARREF );
  $ds9->png( 'slice', STRING );

  $ds9->png( <filename>:STRING );

  $ds9->png( SCALARREF );

  [ STRING ] = $ds9->png;

prefs

Not implemented

preserve

  $ds9->preserve( 'pan', BOOL );
  $ds9->preserve( 'regions', BOOL );

  [ BOOL ] = $ds9->preserve( 'pan' );
  [ BOOL ] = $ds9->preserve( 'regions' );

print

  $ds9->print( 'color', ( 'cmyk' | 'gray' | 'rgb' ) );
  $ds9->print( 'command', STRING );
  $ds9->print( 'destination', ( 'file' | 'printer' ) );
  $ds9->print( 'filename', STRING );
  $ds9->print( 'level', ( '1' | '2' | '3' ) );
  $ds9->print( 'resolution', PRINT_RESOLUTIONS );

  $ds9->print;

  [ <color>:STRING ] = $ds9->print( 'color' );

  [ <destination>:STRING ] = $ds9->print( 'destination' );

  [ <level>:INTEGER ] = $ds9->print( 'level' );

  [ <resolution>:STRING ] = $ds9->print( 'resolution' );

  [ STRING ] = $ds9->print( 'command' );
  [ STRING ] = $ds9->print( 'filename' );

prism

Not implemented

quit

  $ds9->quit;

raise

  $ds9->raise;

region

  $ds9->region( 'color', COLOR );
  $ds9->region( 'deleteall' );
  $ds9->region( 'format', REGION_FORMATS );
  $ds9->region( 'load', <filename>:STRING );
  $ds9->region( 'moveback' );
  $ds9->region( 'movefront' );
  $ds9->region( 'save', <filename>:STRING );
  $ds9->region( 'selectall' );
  $ds9->region( 'selectnone' );
  $ds9->region( 'shape', STRING );
  $ds9->region( 'sky', SKYFRAME );
  $ds9->region( 'skyformat', ( 'degrees' | 'sexagesimal' ) );
  $ds9->region( 'strip', BOOL );
  $ds9->region( 'system', FRAME_COORD_SYSTEMS );
  $ds9->region( 'width', INTEGER );
  $ds9->region( SCALARREF );
  $ds9->region( STRING );

  [ ( 'degrees' | 'sexagesimal' ) ] = $ds9->region( 'skyformat' );

  [ <format>:STRING ] = $ds9->region( 'format' );

  [ BOOL ] = $ds9->region( 'strip' );

  [ COLOR ] = $ds9->region( 'color' );

  [ FRAME_COORD_SYSTEMS ] = $ds9->region( 'system' );

  [ INTEGER ] = $ds9->region( 'width' );

  [ SKYFRAME ] = $ds9->region( 'sky' );

  [ STRING ] = $ds9->region( 'background' );
  [ STRING ] = $ds9->region( 'exclude' );
  [ STRING ] = $ds9->region( 'include' );
  [ STRING ] = $ds9->region( 'selected' );
  [ STRING ] = $ds9->region( 'shape' );
  [ STRING ] = $ds9->region( 'source' );
  [ STRING ] = $ds9->region( ?{ -format => REGION_FORMATS, -system =>
    FRAME_COORD_SYSTEMS, -sky => SKYFRAME, -skyformat => ( 'degrees' |
    'sexagesimal' ), -strip => BOOL, -prop => REGION_PROPERTIES } );

restore

  $ds9->restore( STRING );

rgb

Not implemented

rgbarray

Not implemented

rgbcube

Not implemented

rgbimage

Not implemented

rotate

  $ds9->rotate( 'abs', FLOAT );
  $ds9->rotate( 'close' );
  $ds9->rotate( 'open' );
  $ds9->rotate( 'rel', FLOAT );
  $ds9->rotate( 'to', FLOAT );
  $ds9->rotate( FLOAT );

  [ FLOAT ] = $ds9->rotate;

samp

Not implemented

save

  $ds9->save( 'fits', <filename>:STRING, ( 'image' | 'slice' | 'table'
    ) );

  $ds9->save( 'mecube', <filename>:STRING, ( 'image' | 'slice' |
    'table' ) );

  $ds9->save( 'mosaic', <filename>:STRING, ( 'image' | 'slice' |
    'table' ) );

  $ds9->save( 'mosaicimage', <filename>:STRING, ( 'image' | 'slice' |
    'table' ) );

  $ds9->save( 'mosaicimagewcs', <filename>:STRING, ( 'image' | 'slice'
    | 'table' ) );

  $ds9->save( 'mosaicwcs', <filename>:STRING, ( 'image' | 'slice' |
    'table' ) );

  $ds9->save( 'rgbcube', <filename>:STRING, ( 'image' | 'slice' |
    'table' ) );

  $ds9->save( 'rgbimage', <filename>:STRING, ( 'image' | 'slice' |
    'table' ) );

saveimage

  $ds9->saveimage( '*.jpeg|*.jpg', INTEGER );
  $ds9->saveimage( '*.tiff', 'deflate', 'none', 'packbits', 'jpeg' );
  $ds9->saveimage( 'eps', <filename>:STRING );
  $ds9->saveimage( 'fits', <filename>:STRING );
  $ds9->saveimage( 'gif', <filename>:STRING );
  $ds9->saveimage( 'jpeg', <filename>:STRING );
  $ds9->saveimage( 'png', <filename>:STRING );
  $ds9->saveimage( 'tiff', <filename>:STRING );

scale

  $ds9->scale( 'close' );
  $ds9->scale( 'datasec', BOOL );
  $ds9->scale( 'limits', FLOAT, FLOAT );
  $ds9->scale( 'lock', 'limits', BOOL );
  $ds9->scale( 'lock', BOOL );
  $ds9->scale( 'log', 'exp', FLOAT );
  $ds9->scale( 'match' );
  $ds9->scale( 'match', 'limits' );
  $ds9->scale( 'mode', ( 'minmax' | 'zmax' | 'zscale' ) );
  $ds9->scale( 'mode', FLOAT );
  $ds9->scale( 'open' );
  $ds9->scale( 'scope', ( 'global' | 'local' ) );

  $ds9->scale( SCALE_FUNCTIONS );

  [ <function>:STRING ] = $ds9->scale;

  [ <mode>:STRING ] = $ds9->scale( 'mode' );

  [ <scope>:STRING ] = $ds9->scale( 'scope' );

  [ BOOL ] = $ds9->scale( 'datasec' );
  [ BOOL ] = $ds9->scale( 'lock' );
  [ BOOL ] = $ds9->scale( 'lock', 'limits' );

  [ FLOAT ] = $ds9->scale( 'log', 'exp' );
  [ FLOAT ] = $ds9->scale( 'mode' );

  [ FLOAT, FLOAT ] = $ds9->scale( 'limits' );

shm

Not implemented

sia

Not implemented

single

  $ds9->single;

  [ BOOL ] = $ds9->single( 'state' );

skyview

Not implemented

sleep

  $ds9->sleep( INTEGER );

  $ds9->sleep;

smooth

  $ds9->smooth( 'angle', FLOAT );
  $ds9->smooth( 'close' );
  $ds9->smooth( 'function', ( 'boxcar' | 'gaussian' | 'tophat' ) );
  $ds9->smooth( 'lock', BOOL );
  $ds9->smooth( 'match' );
  $ds9->smooth( 'open' );
  $ds9->smooth( 'radius', INTEGER );
  $ds9->smooth( 'radiusminor', INTEGER );
  $ds9->smooth( 'sigma', FLOAT );
  $ds9->smooth( 'sigmaminor', FLOAT );
  $ds9->smooth( BOOL );

  [ <function>:STRING ] = $ds9->smooth( 'function' );

  [ BOOL ] = $ds9->smooth( 'lock' );
  [ BOOL ] = $ds9->smooth;

  [ FLOAT ] = $ds9->smooth( 'angle' );
  [ FLOAT ] = $ds9->smooth( 'sigma' );
  [ FLOAT ] = $ds9->smooth( 'sigmaminor' );

  [ INTEGER ] = $ds9->smooth( 'radius' );
  [ INTEGER ] = $ds9->smooth( 'radiusminor' );

source

  $ds9->source( STRING );

tcl

  $ds9->tcl( STRING );

threads

  $ds9->threads( INTEGER );

  [ INTEGER ] = $ds9->threads;

threed

Not implemented

tiff

  $ds9->tiff( 'new', SCALARREF );
  $ds9->tiff( 'new', STRING );

  $ds9->tiff( 'slice', SCALARREF );
  $ds9->tiff( 'slice', STRING );

  $ds9->tiff( ( 'deflate' | 'jpeg' | 'none' | 'packbits' ) );

  $ds9->tiff( <filename>:STRING );

  $ds9->tiff( SCALARREF );

  [ ( 'deflate' | 'jpeg' | 'none' | 'packbits' ) ] = $ds9->tiff( (
    'deflate' | 'jpeg' | 'none' | 'packbits' ) );

  [ STRING ] = $ds9->tiff;

tile

  $ds9->tile( 'column' );

  $ds9->tile( 'grid' );
  $ds9->tile( 'grid', 'direction', ( 'x' | 'y' ) );
  $ds9->tile( 'grid', 'gap', INTEGER );
  $ds9->tile( 'grid', 'layout', INTEGER, INTEGER );
  $ds9->tile( 'grid', 'mode', ( 'automatic' | 'manual' ) );

  $ds9->tile( 'mode', ( 'column' | 'grid' | 'row' ) );

  $ds9->tile( 'row' );

  $ds9->tile( BOOL );

  [ ( 'x' | 'y' ) ] = $ds9->tile( 'grid', 'direction' );

  [ <mode>:STRING ] = $ds9->tile( 'grid', 'mode' );
  [ <mode>:STRING ] = $ds9->tile( 'mode' );

  [ BOOL ] = $ds9->tile( 'state' );
  [ BOOL ] = $ds9->tile;

  [ INTEGER ] = $ds9->tile( 'grid', 'gap' );

  [ INTEGER, INTEGER ] = $ds9->tile( 'grid', 'layout' );

two_mass

Not implemented

update

  $ds9->update( 'now' );
  $ds9->update( 'now', INTEGER, FLOAT, FLOAT, FLOAT, FLOAT );
  $ds9->update( INTEGER, FLOAT, FLOAT, FLOAT, FLOAT );

  $ds9->update;

url

  $ds9->url( STRING );

version

  [ STRING ] = $ds9->version;

view

  $ds9->view( 'blue', BOOL );

  $ds9->view( 'graph', 'horizontal', BOOL );
  $ds9->view( 'graph', 'vertical', BOOL );
  $ds9->view( 'green', BOOL );

  $ds9->view( 'keyvalue', STRING );

  $ds9->view( 'layout', VIEW_LAYOUTS );

  $ds9->view( 'red', BOOL );

  $ds9->view( FRAME_COORD_SYSTEMS, BOOL );

  $ds9->view( VIEW_BOOL_COMPONENTS, BOOL );

  [ <layout>:STRING ] = $ds9->view( 'layout' );

  [ BOOL ] = $ds9->view( 'blue' );
  [ BOOL ] = $ds9->view( 'graph', 'horizontal' );
  [ BOOL ] = $ds9->view( 'graph', 'vertical' );
  [ BOOL ] = $ds9->view( 'green' );
  [ BOOL ] = $ds9->view( 'red' );
  [ BOOL ] = $ds9->view( FRAME_COORD_SYSTEMS );
  [ BOOL ] = $ds9->view( VIEW_BOOL_COMPONENTS );

  [ STRING ] = $ds9->view( 'keyvalue' );

vla

Not implemented

vlss

Not implemented

vo

Not implemented

wcs

  $ds9->wcs( 'align', BOOL );

  $ds9->wcs( 'append', WCS_ARRAY );
  $ds9->wcs( 'append', WCS_HASH );
  $ds9->wcs( 'append', WCS_SCALARREF );

  $ds9->wcs( 'close' );

  $ds9->wcs( 'load', <filename>:STRING );

  $ds9->wcs( 'open' );

  $ds9->wcs( 'replace', WCS_ARRAY );
  $ds9->wcs( 'replace', WCS_HASH );
  $ds9->wcs( 'replace', WCS_SCALARREF );
  $ds9->wcs( 'reset' );

  $ds9->wcs( 'save', <filename>:STRING );
  $ds9->wcs( 'save', INTEGER, <filename>:STRING );

  $ds9->wcs( 'sky', SKYFRAME );
  $ds9->wcs( 'skyformat', ( 'degrees' | 'sexagesimal' ) );

  $ds9->wcs( 'system', WCS system );

  $ds9->wcs( WCS system );

  [ ( 'degrees' | 'sexagesimal' ) ] = $ds9->wcs( 'skyformat' );

  [ BOOL ] = $ds9->wcs( 'align' );

  [ SKYFRAME ] = $ds9->wcs( 'sky' );

  [ WCS system ] = $ds9->wcs( 'system' );
  [ WCS system ] = $ds9->wcs;

web

  $ds9->web( 'STRING', 'clear' );
  $ds9->web( 'STRING', 'click', ( 'back' | 'forward' | 'reload' |
    'stop' ) );

  $ds9->web( 'STRING', 'click', INTEGER );
  $ds9->web( 'STRING', 'close' );

  $ds9->web( 'new', STRING, STRING );

  $ds9->web( STRING );

  [ STRING ] = $ds9->web;

width

  $ds9->width( INTEGER );

  [ INTEGER ] = $ds9->width;

xpa

  $ds9->xpa( 'disconnect' );

  $ds9->xpa( BOOL_FALSE );

  [ STRING ] = $ds9->xpa( 'info' );

zoom

  # alias for 'to fit'

  $ds9->zoom( '0' );

  $ds9->zoom( 'abs', FLOAT );

  $ds9->zoom( 'in' );

  $ds9->zoom( 'out' );

  $ds9->zoom( 'rel', FLOAT );

  $ds9->zoom( 'to', 'fit' );
  $ds9->zoom( 'to', FLOAT );

  # alias for 'to fit'

  $ds9->zoom( 'tofit' );

  $ds9->zoom( FLOAT );

  [ FLOAT ] = $ds9->zoom;

zscale

  $ds9->zscale( 'contrast', FLOAT );
  $ds9->zscale( 'line', INTEGER );
  $ds9->zscale( 'sample', INTEGER );

  $ds9->zscale;

  [ FLOAT ] = $ds9->zscale( 'contrast' );

  [ INTEGER ] = $ds9->zscale( 'line' );
  [ INTEGER ] = $ds9->zscale( 'sample' );

SUPPORT

Bugs

Please report any bugs or feature requests to bug-image-ds9@rt.cpan.org or through the web interface at: https://rt.cpan.org/Public/Dist/Display.html?Name=Image-DS9

Source

Source is available at

  https://gitlab.com/djerius/image-ds9

and may be cloned from

  https://gitlab.com/djerius/image-ds9.git

AUTHOR

Diab Jerius <djerius@cpan.org>

COPYRIGHT AND LICENSE

This is free software, licensed under:

  The GNU General Public License, Version 3, June 2007

To install Image::DS9, copy and paste the appropriate command in to your terminal.

cpanm

cpanm Image::DS9

CPAN shell

perl -MCPAN -e shell
install Image::DS9

For more information on module installation, please visit the detailed CPAN module installation guide.

	Global
`s`	Focus search bar
`?`	Bring up this help dialog

	GitHub
`g` `p`	Go to pull requests
`g` `i`	go to github issues (only if github is preferred repository)

	POD
`g` `a`	Go to author
`g` `c`	Go to changes
`g` `i`	Go to issues
`g` `d`	Go to dist
`g` `r`	Go to repository/SCM
`g` `s`	Go to source
`g` `b`	Go to file browse

	Search terms
module: (e.g. module:Plugin)
distribution: (e.g. distribution:Dancer auth)
author: (e.g. author:SONGMU Redis)
version: (e.g. version:1.00)