<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN"> <!--Converted with LaTeX2HTML 98.1p1 release (March 2nd, 1998) originally by Nikos Drakos (nikos@cbl.leeds.ac.uk), CBLU, University of Leeds * revised and updated by: Marcus Hennecke, Ross Moore, Herb Swan * with significant contributions from: Jens Lippmann, Marek Rouchal, Martin Wilck and others --> <HTML> <HEAD> <TITLE>Starting up</TITLE> <META NAME="description" CONTENT="Starting up"> <META NAME="keywords" CONTENT="vol2"> <META NAME="resource-type" CONTENT="document"> <META NAME="distribution" CONTENT="global"> <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1"> <LINK REL="STYLESHEET" HREF="vol2.css"> <LINK REL="next" HREF="node542.html"> <LINK REL="previous" HREF="node540.html"> <LINK REL="up" HREF="node540.html"> <LINK REL="next" HREF="node542.html"> </HEAD> <BODY > <!--Navigation Panel--> <A NAME="tex2html8201" HREF="node542.html"> <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="icons.gif/next_motif.gif"></A> <A NAME="tex2html8198" HREF="node540.html"> <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="icons.gif/up_motif.gif"></A> <A NAME="tex2html8192" HREF="node540.html"> <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="icons.gif/previous_motif.gif"></A> <A NAME="tex2html8200" HREF="node1.html"> <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="icons.gif/contents_motif.gif"></A> <BR> <B> Next:</B> <A NAME="tex2html8202" HREF="node542.html">The Optopus session</A> <B> Up:</B> <A NAME="tex2html8199" HREF="node540.html">Using the Optopus Package</A> <B> Previous:</B> <A NAME="tex2html8193" HREF="node540.html">Using the Optopus Package</A> <BR> <BR> <!--End of Navigation Panel--> <H2><A NAME="SECTION003121000000000000000"> Starting up</A> </H2> The commands in the Optopus package have to initialised by setting the Optopus context with the MIDAS command <TT>SET/CONTEXT OPTOPUS</TT>. All commands in this package have the qualifier <TT>OPTOPUS</TT>. Since the majority of them need quite a number of input parameters, and where their correct order and meaning is not always easy to remember, there are are two ways to enter command parameters. Besides the usual way of writing for each command:<BLOCKQUOTE> <TT><TT>command/qualifier p1 p2 p3 ...</TT></TT></BLOCKQUOTE>it is also possible to define them in an explicit form:<BLOCKQUOTE> <TT><TT>SET/OPTOPUS param=value [param=value]</TT>,</TT></BLOCKQUOTE>where <TT>param</TT> is the parameter name and <TT>value</TT> is the assigned value. Every parameter set in this ways can be defaulted on the command lines. Only the input and output filenames are required unless the general default names are used (see documentation of the individual commands). However, before executing a command it is recommended to check the session parameters by listing them with the command <TT>SHOW/OPTOPUS</TT>. This will produce an output table like in Table <A HREF="node541.html#show-command">H.1</A>. For a complete overview see Section <A HREF="node546.html#session-parameters">H.3.2</A>. <P> <BR> <DIV ALIGN="CENTER"><A NAME="29234"> </A> <TABLE> <CAPTION><STRONG>Table H.1:</STRONG> Parameters listed by SHOW/OPTOPUS</CAPTION> <TR><TD> <DIV ALIGN="CENTER"> <TABLE CELLPADDING=3 BORDER="1" ALIGN="CENTER"> <TR><TD ALIGN="LEFT">Input file:</TD> <TD ALIGN="LEFT">mytab1.tbl</TD> </TR> <TR><TD ALIGN="LEFT">Output file:</TD> <TD ALIGN="LEFT">mytab2.tbl</TD> </TR> <TR><TD ALIGN="LEFT">Plate label:</TD> <TD ALIGN="LEFT">SA94</TD> </TR> <TR><TD ALIGN="LEFT">Plate center:</TD> <TD ALIGN="LEFT">R.A.: 02h 43m 30.000s DEC.: -00d 15' 50.00"</TD> </TR> <TR><TD ALIGN="LEFT">Equinoxes:</TD> <TD ALIGN="LEFT">Old : 1950.00000 New: 1991.76776</TD> </TR> <TR><TD ALIGN="LEFT">Date:</TD> <TD ALIGN="LEFT">Year: 1991.00000 Month: 10. Day: 9. Epoch: 1991.76776</TD> </TR> <TR><TD ALIGN="LEFT">Exposure time:</TD> <TD ALIGN="LEFT">120.0m</TD> </TR> <TR><TD ALIGN="LEFT">Wavelength range:</TD> <TD ALIGN="LEFT">from: 4000. Ångstrom to: 8000. Ångstrom</TD> </TR> <TR><TD ALIGN="LEFT">Optimal sid. time slot:</TD> <TD ALIGN="LEFT">from: 1h 0m to: 3h 0m</TD> </TR> <TR><TD ALIGN="LEFT">Optimal sid. time:</TD> <TD ALIGN="LEFT">0.00h</TD> </TR> <TR><TD ALIGN="LEFT">ACFLAG:</TD> <TD ALIGN="LEFT">N</TD> </TR> <TR><TD ALIGN="LEFT">PFLAG:</TD> <TD ALIGN="LEFT">Y</TD> </TR> <TR><TD ALIGN="LEFT">ASTFLAG:</TD> <TD ALIGN="LEFT">Y</TD> </TR> <TR><TD ALIGN="LEFT">EWFLAG:</TD> <TD ALIGN="LEFT">N</TD> </TR> </TABLE> </DIV> <A NAME="show-command"> </A></TD></TR> </TABLE> </DIV> <BR> <P> The assigned values are maintained until the user gives the MIDAS command <BR><TT>CLEAR/CONTEXT</TT> or decides to leave the MIDAS session. However, is is possible to save them with the command <TT>SAVE/OPTOPUS table</TT>, where <TT>table</TT> is the name of any table chosen by the user. <TT>SAVE/OPTOPUS</TT> saves the relevant session parameters by copying them to descriptors of <TT>table</TT>. It is advisable to use this command, not only when you want to interrupt a session and restart it later, but again during the session to protect yourself against system crashes or accidental logouts of MIDAS. When re-entering Optopus context, all parameters are re-initialised to the default values but they can be re-set to the values of a previously saved session with <TT>RESTORE/OPTOPUS table</TT>, where <TT>table</TT> is of course the name of the table that contains the saved setting. <P> Since almost all commands in the package work, both in input and in output, on MIDAS tables, another important task of the user at the start of an Optopus session will be to create a MIDAS table from the ASCII file where the data about the objects to be observed are being kept. The newly created table will have to contain, amongst others, an <TT>:IDENT</TT> and a <TT>:TYPE</TT> column, where <TT>:TYPE</TT> contains ``B'' or ``S'', respectively for ``big'' and ``small'' guidestars, and ``O'' for scientific object. As the format of this table is fixed and crucial for all the following operations, there is a dedicated command for this purpose:<BLOCKQUOTE> <TT><TT>CREATE/OPTOPUS inp_file [out_tab] [fmt_file] [old_equinox]</TT></TT></BLOCKQUOTE>A standard <TT>fmt_file</TT> can be seen in Table <A HREF="node541.html#ex-fmt-file">H.2</A>. <P> <BR> <DIV ALIGN="CENTER"><A NAME="29258"> </A> <TABLE> <CAPTION><STRONG>Table H.2:</STRONG> Example format file</CAPTION> <TR><TD> <DIV ALIGN="CENTER"> <TABLE CELLPADDING=3 BORDER="1" ALIGN="CENTER"> <TR><TD ALIGN="LEFT">define/field</TD> <TD ALIGN="LEFT">1</TD> <TD ALIGN="LEFT">16</TD> <TD ALIGN="LEFT">c</TD> <TD ALIGN="LEFT">a16</TD> <TD ALIGN="LEFT">:ident</TD> <TD ALIGN="LEFT"> </TD> </TR> <TR><TD ALIGN="LEFT">define/field</TD> <TD ALIGN="LEFT">18</TD> <TD ALIGN="LEFT">19</TD> <TD ALIGN="LEFT">d</TD> <TD ALIGN="LEFT">f2.0</TD> <TD ALIGN="LEFT">:ahr</TD> <TD ALIGN="LEFT">"hours"</TD> </TR> <TR><TD ALIGN="LEFT">define/field</TD> <TD ALIGN="LEFT">21</TD> <TD ALIGN="LEFT">22</TD> <TD ALIGN="LEFT">d</TD> <TD ALIGN="LEFT">f2.0</TD> <TD ALIGN="LEFT">:amin</TD> <TD ALIGN="LEFT">"min"</TD> </TR> <TR><TD ALIGN="LEFT">define/field</TD> <TD ALIGN="LEFT">24</TD> <TD ALIGN="LEFT">29</TD> <TD ALIGN="LEFT">d</TD> <TD ALIGN="LEFT">f6.3</TD> <TD ALIGN="LEFT">:asec</TD> <TD ALIGN="LEFT">"sec"</TD> </TR> <TR><TD ALIGN="LEFT">define/field</TD> <TD ALIGN="LEFT">33</TD> <TD ALIGN="LEFT">33</TD> <TD ALIGN="LEFT">c</TD> <TD ALIGN="LEFT">a1</TD> <TD ALIGN="LEFT">:sign</TD> <TD ALIGN="LEFT"> </TD> </TR> <TR><TD ALIGN="LEFT">define/field</TD> <TD ALIGN="LEFT">34</TD> <TD ALIGN="LEFT">35</TD> <TD ALIGN="LEFT">d</TD> <TD ALIGN="LEFT">f2.0</TD> <TD ALIGN="LEFT">:ddeg</TD> <TD ALIGN="LEFT">"degrees"</TD> </TR> <TR><TD ALIGN="LEFT">define/field</TD> <TD ALIGN="LEFT">37</TD> <TD ALIGN="LEFT">38</TD> <TD ALIGN="LEFT">d</TD> <TD ALIGN="LEFT">f2.0</TD> <TD ALIGN="LEFT">:dmin</TD> <TD ALIGN="LEFT">"arcmin"</TD> </TR> <TR><TD ALIGN="LEFT">define/field</TD> <TD ALIGN="LEFT">40</TD> <TD ALIGN="LEFT">44</TD> <TD ALIGN="LEFT">d</TD> <TD ALIGN="LEFT">f5.2</TD> <TD ALIGN="LEFT">:dsec</TD> <TD ALIGN="LEFT">"arcsec"</TD> </TR> <TR><TD ALIGN="LEFT">define/field</TD> <TD ALIGN="LEFT">48</TD> <TD ALIGN="LEFT">48</TD> <TD ALIGN="LEFT">c</TD> <TD ALIGN="LEFT">a1</TD> <TD ALIGN="LEFT">:type</TD> <TD ALIGN="LEFT"> </TD> </TR> <TR><TD ALIGN="LEFT">exit</TD> <TD ALIGN="LEFT"> </TD> <TD ALIGN="LEFT"> </TD> <TD ALIGN="LEFT"> </TD> <TD ALIGN="LEFT"> </TD> <TD ALIGN="LEFT"> </TD> <TD ALIGN="LEFT"> </TD> </TR> </TABLE> </DIV> <A NAME="ex-fmt-file"> </A></TD></TR> </TABLE> </DIV> <BR> <P> A copy of this format file will be put in the working directis available in the file: <UL> <LI><TT>$MIDASHOME/$MIDVERS/stdred/optopus/incl/opto.fmt</TT> (UNIX) <LI><TT>MID_DISK:[MIDASHOME.MIDVERS.STDRED.OPTOPUS.INCL]OPTO.FMT</TT> (VAX/VMS) </UL>so that it can be copied to the user's working directory and subsequently modified according to the positions and field widths in his/her ASCII file. You can copy the format file into your working directory with the <TT>CREATE/OPTOPUS</TT> command itself. To do so give the third parameter <TT>fmt_file</TT> in the command the value <TT>copy</TT>. However, a copy will not be made if a file with the name <TT>opto.fmt</TT> is already present. <P> In case the targets are already stored in a MIDAS table the user should check if the table columns have the correct labels. If required, modifications in the table can be made by using one or more commands for table manipulation. <P> The equinox of the data has to be stored in the descriptor <TT>TABEQUI</TT> of the MIDAS table. It is important to verify whether the equatorial coordinates have been precessed or not. In fact, next step in this ``building-up'' of the Optopus session is the command:<BLOCKQUOTE> <TT><TT>PRECESS/OPTOPUS [inp_tab] [new_equinox]</TT>,</TT></BLOCKQUOTE>which corrects the right ascension and declination for precession to the date of the observation (this is the default, which can be changed by defining the parameter <TT>NEWEQ</TT>), and updates the value of the double precision descriptor <TT>TABEQUI</TT>. To limit the number of files created in an Optopus session, this command will not to create a new table, but will add two new columns <TT>:RA</TT> and <TT>:DEC</TT> in the table created by <TT>CREATE/OPTOPUS</TT>. The old columns <TT>:RA</TT> and <TT>:DEC</TT> are renamed to <TT>:OLDRA</TT> and <TT>:OLDDEC</TT>, respectively. Note, that in this table the equatorial coordinates are in decimal format. <P> <HR> <!--Navigation Panel--> <A NAME="tex2html8201" HREF="node542.html"> <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="icons.gif/next_motif.gif"></A> <A NAME="tex2html8198" HREF="node540.html"> <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="icons.gif/up_motif.gif"></A> <A NAME="tex2html8192" HREF="node540.html"> <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="icons.gif/previous_motif.gif"></A> <A NAME="tex2html8200" HREF="node1.html"> <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="icons.gif/contents_motif.gif"></A> <BR> <B> Next:</B> <A NAME="tex2html8202" HREF="node542.html">The Optopus session</A> <B> Up:</B> <A NAME="tex2html8199" HREF="node540.html">Using the Optopus Package</A> <B> Previous:</B> <A NAME="tex2html8193" HREF="node540.html">Using the Optopus Package</A> <!--End of Navigation Panel--> <ADDRESS> <I>Petra Nass</I> <BR><I>1999-06-15</I> </ADDRESS> </BODY> </HTML>
