Scroll to navigation

ALADIN(1) Virtual Observatory ALADIN(1)

NAME

aladin - interactive software sky atlas

SYNOPSIS

aladin [-help] [-version] [options...] [filenames...]
aladin -hipsgen|-mocgen [-h] <options...>
aladin [-c] [-rm] [-server] [-source] [img] [-preview] [-fov] [-aladin.resolution] [-aladin.zoom] [sciprt] [inFrame] [from]
aladin [-debug] [-trace] [-[no]hub] [-glufile=] [-scriptfile=] [-screen] [-load] [-c]
[-stringfile=] [inFrame=] [cgi]

DESCRIPTION

aladin is an interactive sky atlas for viewing astronomical images in the online Virtual Observatory (VO). It is possible to superimpose entries from astronomical catalogues or databases with remotely accessed data fetched on demand.

Aladin can also open and save to a large number of astronomical image formats (FITS, HEALPix, JPEG/GIF/PNG/...); and table formats (FITS, VO-Table, CSV/TSV, S-extractor, IPAC-TBL, Skycat, ASCII, ...).

OPTIONS

show top-level help
show version of Aladin installed
skip internet connectivity tests (off-line usage)
start in full-screen, cinema, preview, or other visual modes. -preview is
equivalent to -screen=preview
script commands passed on the command-line
script-mode. Does not use graphical user interface. Equivalent to -noplugin -nobanner -nobookmarks -nohub
hide the Aladin start up splash screen/loading status
do not perform an only check to see if a new releases of Aladin is available
-[no]hub
disable/enable starting the internal SAMP communcations hub for sharing data with other astronomical applications
-[no]plugin
disable/enable plugin support
-[no]bookmarks
disable/enable bookmarks
-[no]outreach
disable/enable alternative user interface used for Aladin "Outreach"/"Undergraduate" mode

Debugging Options

-[no]beta
disable/enable features that currently in beta-test
-[no]proto
disable/enable prototype feature. Useful for testing or when performing demonstrations
debugging trace mode
debugging extra verbose mode

HiPS Command

Script-/command-line based Hierarchical Progressive Surveys (HiPS) generation.

command-line/script-based generation of Hierarchical Progressive Surveys (HiPS). An example of how to use the HiPS generation:

aladin -hipsgen in=yourFolder color=true Additional options are described in aladin -hipsgen -h.

MOC Command

script-/command-line based Multi-Order Coverage Map (MOC) generation options.

command-line/script-based generation of Multi-Order Coverage Maps (MOC). An example of how to use the MOC generation:

aladin -mocgen in=DirScuba order=15 out=sfoo.fits

Additional options are described in aladin -mocgen -h.

Applet Options

Aladin can run remotely over the web inside a web-browser and appears to take the following options.

http://example.com/file.dic>
An HTTP-encoded URL to a publically-accessible dictionary file containing configuration data for alternative for data providers, in the format: 



  %ActionName        Foo


  %Description       My own server definition


  %Aladin.Label      MyServer


  %Aladin.Menu       Others...


  %Aladin.LabelPlane MyServer $1/$2                      


  %Url               http://example.com/yyy?ra=$1&dec=$2...


  %Param.Description $1=Right Ascension


  %Param.Description $2=Declination


  %Param.Description $3=Radius


  %Param.Description $4=Color


  %Param.DataType    $1=Target(RA)


  %Param.DataType    $2=Target(DE)


  %Param.DataType    $3=Field(RADIUS)


  %Param.Value       $3=14.1 arcmin


  %Param.Value       $4=Red


  %Param.Value       $4=Blue


  %Param.Value       $4=Infrared 


  %Aladin.filter     filter Mag.Circle { draw circle(-${Mag}) }


  %Aladin.filter     filter Prop.motion { draw pm(5*${pmRA},5*${pmDE}) }


  %ResultDataType    Mime(image/fits)
The following options are visible the source code, but are not clearly documented in other sources, and appear to be related to applet usage for running inside a web-browser.
possibly related to Applet use when running inside a web-browser.
in Applet mode, this is a path to a remote script that can be queried for additional configuration instructions. It is appended to the top-level hostname URL that the Applet is being executed from.
in Applet mode, appears to be appended to the CGI request. At point this is compared to the string "CDS-WebStart".
appears to be for internal use.

FORMATS

Aladin is able to process the following file formats:

FITS (gzipped,RICE,MEF,...), HEALPix maps, JPEG,GIF,PNG
FITS, XML/VOTable, CSV, TSV, S-extractor, IPAC-TBL, Skycat or ASCII tables
Aladin or IDL or DS9 regions, MOCs
HiPS (Hierarchical Progressive Surveys)
Files with "*.aj" extension
Files with "*.ajs" extension

A comprehensive User Manual is available from the CDS website in PDF format at: http://aladin.u-strasbg.fr/java/AladinManual6.pdf

ENVIRONMENT VARIABLES

used by the built-in SAMP hub to create the .samp lock-file

HOMEPAGE

http://aladin.u-strasbg.fr/

ORIGINAL AUTHORS

T. Boch, F. Bonnarel, P. Fernique, A. Oberto, F. Ochsenbein, A. Schaaf

COPYRIGHT

Aladin is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, version 3 of the License.

Aladin is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

On Debian systems the full text of the GNU General Public License version 3 can be found in the file `/usr/share/common-licenses/GPL-3'.

AUTHORS

This manual page was written by Florian Rothmaier and Paul Sladen, for the Debian GNU/Linux system (but may be used by others).

Nov 2016