% @(#)set_opto.hlq	19.1 (ESO-IPG) 02/25/03 14:27:23
%+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT     (c) 1991 European Southern Observatory
%.IDENT         set_opto.hlq
%.AUTHOR        A. Gemmo     Padova Department of Astronomy
%.KEYWORDS      MIDAS, help files, SET/OPTOPUS
%.PURPOSE       On-line help file for the command: SET/OPTOPUS
%.VERSION       1.0 16-SEP-1991 : Creation, AG
%---------------------------------------------------------------------
\se
SECTION./OPTO
\es\co
SET/OPTOPUS                                          16-SEP-1991 AG
\oc\su
SET/OPTOPUS option1[=value1] option2[=value2] ...
	set Optopus context parameters

\us\pu
Purpose:     
             Set parameters in Optopus context. Any parameter used by
	     an Optopus context command can be set either by entering
	     it in the command line or by using the command
	     SET/OPTOPUS. To see the current settings of the parameters
	     use the command SHOW/OPTOPUS (see documentation).
\up\sy
Syntax:      
             SET/OPTOPUS option1[=value1] option2[=value2] ...
\ys\pa
	     option =  Optopus parameters to be set: value = value of the 
                       option. The following options with their values are
		       possible:
\ap\pa
	     DEFAULT = no value; sets Optopus package default mode (see below).
\ap\pa
             CRA =     Right Ascension of the center of the Optopus
		       plate. Input format must be: HH,MM,SS.sss\\ 
		       Default value is "00,00,00.000".
\ap\pa
	     CDEC =    Declination of the center of the Optopus
		       plate. Input format must be: +/-DD,AM,AS.ss\\
		       Default value is "+00,00,00.00".
\ap\pa  
             OLDEQ =   Old equinox of equatorial coordinates.
		       Input format must be: YEAR.yyyyy\\
	               Default value is "1950.0".
\ap\pa	
	     NEWEQ =   New equinox of equatorial coordinates.
		       Input format must be: YEAR.yyyyy\\
		       Default value is "2000.0".
\ap\pa		       
             LABEL =   Character string that will be used to 
                       identify all the plots in an Optopus package run,
		       both on graphics screen and on printer.
		       Default value is "Optopus plate".
\ap\pa       DATE =    Year,month and day of the observation. The
		       permitted input formats are:\\
		       (1) YEAR,MONTH(number),DAY     or\\
                       (2) YEAR.yyyyy,0,0\\
                       Default value is "1999.,12.,31.".
\ap\pa		       
             EXTIM =   Exposure time in minutes of Optopus plate.
		       Default value is "0.".
\ap\pa
             WRANGE =  Wavelength range to optimize the
		       corrections for atmospheric refraction. Input
		       format must be: LAMBDA1,LAMBDA2 \\
	               both in Angstroem. Default value is: "3800,8000".
\ap\pa
             SITSLT =  Sidereal time slot, that is sidereal time
		       interval during which a given Optopus plate will
		       probably be used. Input format must be:
         	       ST1.ss,ST2.ss. Default value is: "00.00,00.00".
 	     OST =     Optimal sidereal time for correction
		       determinations, that is sidereal time for which 
		       the corrections for atmospheric refraction are
	               calculated. Input format must be: ST.ss.
                       Default value is: "00.00".
\ap\pa
             ACFLAG =  Y or y (for yes) and N or n (for no) are
		       the alternatives. An ACFLAG set to Y enables the
		       automatic determination of the plate center in
	               the command HOLES/OPTOPUS.
	               An input from the user is otherwise requested.
		       Default value is "Y".
\ap\pa
             PFLAG =   Y or y (for yes) and N or n (for no) are
		       the alternatives. A PFLAG set to Y enables the 
		       automatic precession of the plate center in the
                       command HOLES/OPTOPUS.
		       The center coordinates are otherwise not
		       precessed. Default value is "Y".
\ap\pa
             ASTFLAG = Y or y (for yes) and N or n (for no) are
		       the alternatives. An ASTFLAG set to Y enables the
		       automatic determination of the optimal sidereal
                       time for correction determinations in the command
		       REFRACTION/OPTOPUS (see option OST).
		       An input from the user is otherwise requested.
	               Default value is "Y".
\ap\pa
	     EWFLAG =  Y or y (for yes) and N or n (for no) are
		       the alternatives. An EWFLAG set to Y enables the
                       EAST-WEST flipping of the plots produced by the
	               command PLOT/OPTOPUS (see documentation).
		       Plots are otherwise not flipped. Default value "N".
\ap\no
Note:     
          Input to the options OLDEQ and NEWEQ is possible only in the
	  format YEAR.yyyyy anyway, it may be useful to notice that every
	  time one sets the date of the observation with SET/OPTO
	  DATE=... and then one uses SHOW/OPTOPUS to see the currently
	  set values of all the Optopus parameters, the value of the
	  EPOCH (that is the EQUINOX) of the date is also displayed,
	  so that it may be copied into NEW EQUINOX by using SET/OPTO
	  NEWEQ=... .
\on\exs
Examples:
\ex
	  SET/OPTOPUS CRA=00,35,42.567 CDEC=-00,24,36.01 
\xe\ex
          SET/OPTOPUS OLDEQ=1950.0 NEWEQ=1991.76776
\xe\ex
	  SET/OPTOPUS WRANGE=4000,8000 EXTIM=120
\xe\ex
	  SET/OPTOPUS DATE=1991,10,9       
\xe\ex
	  SET/OPTOPUS ACFLAG=Y ASTFLAG=n
\xe\ex
	  SET/OPTOPUS SITSLT=20.4,22.5
\xe\sxe

