Ubuntu Manpage: aladin - interactive software sky atlas

NAME

       aladin - interactive software sky atlas

SYNOPSIS

       aladin [options...] [filenames...]
       aladin -hipsgen|-mocgen [-h] [options...]
       aladin -help|-version

DESCRIPTION

       aladin is an interactive sky atlas for viewing astronomical images in the online Virtual Observatory (VO)
       developed by the Centre de Données astronomiques de Strasbourg  (CDS).  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,
       ...).

       This manual describes only the command line parameters of aladin. The possibilities of the graphical user
       interface can be discovered with the Help menu once the program is started.

OPTIONS

       -help  show top-level help

       -version
              display the Aladin release number

       -local skip internet connectivity tests (off-line usage)

       -screen=full|cinema|preview|frame
              start in full-screen, cinema, preview, or other visual modes.

       -script=cmd1;cmd2;...
              script commands passed on the command-line

       -nogui script-mode.  Does not use graphical user interface. Equivalent to -noplugin -nohub

       -[no]hub
              disable/enable  starting  the  internal  SAMP  communcations  hub  for  sharing  data  with  other
              astronomical applications

       -[no]plugin
              disable/enable plugin support

   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

       -trace debugging trace mode

       -debug debugging extra verbose mode

   HiPS command parameters
       The  -hipsgen  command  allows  a  script-/command-line  based  Hierarchical  Progressive  Surveys (HiPS)
       generation. The options can be given on the  command  line,  or  in  a  config  file  (param=configfile).
       Additional parameters may be retrieved with the command aladin -hipsgen -h.

       in=dir|file
              Source  image  directory  (FITS  or  JPEG|PNG  +hhh  or  HiPS) or unique image or HEALPix map file
              (required parameter)

       out=dir
              HiPS target directory (default $PWD+"HiPS")

       obs_title=name
              Name of the survey (by default, input directory name)

       creator_did=id
              HiPS identifier (syntax: [ivo://]AUTHORITY/internalID)

       hips_creator=name
              Name of the person or institute who builds the HiPS

       hips_status=private|public clonable|clonableOnce|unclonable
              HiPS status (default: public clonableOnce)

       hdu=n1,n2-n3,...|all
              List of HDU numbers (0 is the primary HDU - default is 0)

       blank=nn
              Specifical BLANK value

       skyval=key|auto|%info|%min %max
              FITS key to use for removing a sky background, or auto detection or percents  of  pixel  histogram
              kept (central ex 99, or min max ex 0.3 99.7)

       color=jpeg|png
              The  source  images  are colored images (jpg or png) and the tiles will be produced in jpeg (resp.
              png)

       shape=ellipse|rectangle
              Shape of the observations

       border=...
              Margins (in pixels) to ignore in the original observations (N W S E or constant)

       fov=true|x1,y1..
              Observed regions by files.fov or global polygon (in FITS convention).

       pilot=nnn
              Pilot test limited to the nnn first original images.

       verbose=n
              Debug information from -1 (nothing) to 4 (a lot)

       -live  incremental HiPS (keep weight associated to each HiPS pixel)

       -f     clear previous computations

       -n     Just print process information, but do not execute it.

   MOC command parameters
       The -mocgen command generates the MOC (Multi Object Coverage Map) corresponding to a collection of images
       or WCS headers. A MOC is a a coverage map based on HEALPix sky tesselation.

       The  supported formats are: FITS files, MEF files, jpeg or png files (WCS header in the comment segment),
       .hhh file (FITS header files without pixels) and .txt simple ASCII file (FITS header as keyword  =  value
       basic ASCII lines).

       -v     Verbose mode

       -strict
              Scan pixel values instead of using WCS image coverage

       blank=value
              Alternate BLANK value (-strict only)

       order=nn
              MOC resolution (default 10 => 3.345')

       mocfmt=fits|json
              MOC output format (default FITS)

       previous=moc.fits
              Previous MOC (if additions)

       hdu=n1,n2-n3|all
              List of concerned FITS extensions

       -r     Recursive directory scanning

       -o     Output MOC updated continuously rather than generated at the end

       in=fileOrDir
              Directory of images/headers collection

       out=outMoc.fits
              Output MOC file

       -d     Debug trace

DATA FORMATS

       Aladin is able to process the following file formats:

       images FITS (gzipped,RICE,MEF,...), HEALPix maps, JPEG,GIF,PNG

       tables FITS, XML/VOTable, CSV, TSV, S-extractor, IPAC-TBL, Skycat or ASCII tables

       graphics
              Aladin or IDL or DS9 regions, MOCs

       directories
              HiPS (Hierarchical Progressive Surveys)

       Aladin backups
              Files with "*.aj" extension

       Aladin scripts
              Files with "*.ajs" extension

AUTHORS

       Aladin  was  written  by  Pierre  Fernique (Aladin Desktop core base & documentations), Thomas Boch (many
       advanced Aladin Desktop features), Anaïs Oberto (RGB support, HiPS prototypes), François Bonnarel  (Image
       calibration), and Chaitra (TAP,SIAv2 implementation).

COPYRIGHT

       Copyright   ©  1999-2017  Universite  de  Strasbourg  /  Centre  de  Donnees  astronomiques de Strasbourg
       (CDS/CNRS)

       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.

       If  the Aladin Sky Atlas was helpful for your research work, the following citation would be appreciated:
       This research has made use of "Aladin sky  atlas"  developed  at  CDS,  Strasbourg  Observatory,  France.
       2000A&AS..143...33B and 2014ASPC..485..277B.

HOMEPAGE

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

NAME

SYNOPSIS

DESCRIPTION

OPTIONS

DATA FORMATS

AUTHORS

COPYRIGHT

HOMEPAGE

SEE ALSO