% @(#)test.twh 17.1.1.1 (ESO-IPG) 01/25/02 17:48:02 %+++++++++++++++ %.IDENTIFICATION test.twh %.AUTHOR Francois Ochsenbein [ESO - IPG] %.LANGUAGE TeX-like %.KEYWORDS Hierarchical Help using TermWindows %.ENVIRONMENT TermWindows %.VERSION 1.1 05-Dec-1988: Creation %.COMMENTS Example of Help using Hierarchical TeX-like. %--------------- \input{tw.def} \def\TeX{{\bf TeX}} \def\LaTeX{{\bf LaTeX}} \def\dots{...} \def\eg{e.g.} \def\TW{{\sl TermWindows} } \def\tt{} \def\eos#1{\EOF} %\def\EOF{} \Help{0}{TEST}{TEST}{} Date = \today \quad Time = \time \hfill {{\bf\now}} \\ Throughout this manual you will find several {\em figures}, delimited by two horizontal lines. These contain the text which will be displayed on your screen when you use the {\em help} command. An example is given in this page. STARCAT should be self-explaining and you should not need to extensively use this manual. However, all the commands available are fully described in the following chapters. \SkipLine \begin{enumerate} \item Test item, which is two lines wide. Is it OK ? Look, it {\bf must} require {\bf two} lines. OK ??? \item Test item, which is two lines wide. Is it OK ? Look, it {\bf must} require {\bf two} lines. OK ??? \item Test item, which is two lines wide. Is it OK ? Look, it {\bf must} require {\bf two} lines. OK ??? \item Test item, which is two lines wide. Is it OK ? Look, it {\bf must} require {\bf two} lines. OK ??? \item Test item, which is two lines wide. Is it OK ? Look, it {\bf must} require {\bf two} lines. OK ??? \item Test item, which is two lines wide. Is it OK ? Look, it {\bf must} require {\bf two} lines. OK ??? \item Test item, which is two lines wide. Is it OK ? Look, it {\bf must} require {\bf two} lines. OK ??? \item Test item, which is two lines wide. Is it OK ? Look, it {\bf must} require {\bf two} lines. OK ??? \end{enumerate} \eos{SMB} \Help{1}{Modes}{Dialogue / Keypad / Command Modes}{} Starcat provides full screen display with the following command / parameter interfaces: \BeginItems \Item Dialogue - question and answer; program guides user unless responses provided on command line; \Item Cursor and Keypad - cursor position selects item, keypad identifies function (Catalogs querying); \Item Command/qualifiers to be implemented. \EndItems Please experiment with Starcat and let us know of problems and preferences, e.g. use the Report command to send mail to ESOMC1::DMF. \CentreLine{See also: {\sl Introduction.}} \eos{Modes} The STARCAT program can be run by typing {\it\uif} to your VMS prompt. Remember that you MUST be logged to MC1: having access to MC0 is not sufficient. \Help{1}{Overview}{User Interface Overview}{} STARCAT is the user interface to the Data Management Facility (DMF) of the Hubble Space Telescope and to the ESO and Software Catalogues. It shall provide the following major facilities for General Observers and Archival Researchers: \BeginItems \Item Queries on the contents of the Catalogues. \Item Files retrieved by name from the Archive. \EndItems Currently, only the first facility is provided; the Archive will not be available for some time. Queries can be entered via the CATALOGS command, with an option to output files for MIDAS consumption. Note that a Report facility is available, by which you may convey comments about this program to the software developer(s); you may also contact: \CentreLine{\fbox{ G. Russo (tel.365), F. Ochsensbein (346) or A. Richmond (433)}} \eos{Overview} The on--line `help' present a subset of this User Guide; the sections headed `Help topic' show you the on-line help displays. The first screen displayed on starting \uif\ corresponds to the command {\tt Help Introduction}. \Help{1}{News}{--- News --- News --- News --- News ---}{} Latest Developments: \BeginItems \Item We are currently (last week of September 1986) adding new catalogues to the IDM, and modifying the existing one to have an homogeneous description of the coordinates. Right ascension and declination will always be represented as HHMMSS.SSS and SDDMMSS.SSS. \Item DOC command: this will display the astronomical documentation available for a catalogue, which therefore will NOT be available through the HELP command, as before. \Item Terminal output: STARCAT uses now the terminal independent TermWindows library but the SMARTCALL module has still to be replaced \Item The 1986 version of COCO, the STARLINK COordinate COnversion program has been added with a very simple interface, to be replaced with a full integration into the STARCAT environment. \Item {\bf SIMBAD}, the Stellar Data Center data-base containing roughly 600,000 stars and 70,000 galaxies with regularly updated bibliography, is now {\bf directly accessible} through STARCAT. \EndItems \eos{Introduction} The on--line user help is derived directly from the user guide, which is written in \LaTeX. \iffalse Each help display (which may occupy more than one screen) is identified by Proteus by the marker {\bf$\backslash$screen\{} at the beginning, and {\bf\backslash end\{} at the end . \fi \Help{1}{Introduction}{The first display}{} \CentreLine{\bf Welcome to S T A R C A T} If you are using this system for the first time then: \CentreLine{$>==>$ type: \fbox{HELP}} Note that you may abbreviate commands and parameters, as long as the abbreviation is unique. Also, you may enter parameters on the same line as the command, instead of being prompted for them. {\bf SIMBAD}, the largest astronomical data-base regularly updated, is now accessible via STARCAT. Follow \fbox{Help SIMBAD} or \fbox{Help SMB....} \eos{Help} \Help{1}{Help}{Help Help result ...}{} This command requires a {\sl topic} parameter. {\sl Topic} may be one of the following: \BeginTable{|l|l|}{16,24} \Rule \ Commands & Calculator \\ & SIMBAD \\ & Exit \\ & Help \\ & IQL \\ & Read\_File \\ & Report \\ & Setup \\ & Spawn \\ \Rule Introduction & \\ Modes & \\ News & \\ Overview & \\ \LastRule \EndTable \eos{Help} \Help{1}{Commands}{What is recognised by STARCAT}{} You may enter one of the following command names, or an abbreviation. If you know the prompts that follow a command, then you may also enter your responses on the same input line, e.g. REA myfile.lis will read the file for further commands. CAT GTO will select the GTO catalogue. \BeginTable{| l | l |}{14,50} \Rule Command name & \Centre{Purpose} \\ \Rule \${\sl command} &\ Immediate execution of in-line command.\\ SIMBAD &\ Connection to the {\bf SIMBAD} data-base \\ EXIT &\ Exit this program. \\ HELP &\ Display detailled help. \\ READ\_FILE &\ Takes commands from a file. \\ REPORT &\ To invoke Digital's Mail utility. \\ SETUP &\ To change program parameters. \\ SORT &\ To sort a file retrieved by STARCAT. \\ SPAWN &\ To pass control to DCL (LOgout to exit).\\ \LastRule \EndTable \eos{Commands} \Help{2}{Exit}{If you really need to exit...}{} Syntax: EXIT or CNTRL/z This command terminates a Starcat session, clearing the screen except for the `title' line, and returning you to the host operating system user command level (e.g. DCL). CNTRL/Z (Control key + z at the same time: \^{ }z) is equivalent to EXIT. \eos{Exit} \Help{2}{Read_File}{How to use an input file instead of typing...}{} Syntax: READ\_FILE {\sl file\_name} This command requires a file name as parameter. The named file may contain any commands that you would type on-line (except those using the keypad). This facility allows you to repeat common sequences of commands, without having to type them every time. In particular, if the file is called STARCAT.INI, then the commands in it will be obeyed when you start Starcat. For example, if you normally work with the GTO catalogue, then it may be convenient for you to edit STARCAT.INI, and enter CAT GTO into it; this will cause Starcat to go directly into the GTO catalogue. \eos{Read_File} \Help{2}{Setup}{Dynamic parameter modifications}{} Syntax: SETUP {\sl mode}* EXIT (* = repeated zero or more times) where {\sl mode} is: \BeginItems \Item LOG {\sl level} where level is in range -31 to 31. \Item MODE changes between prompting and menu. \EndItems The monitoring level is for checking program execution; each level is associated with a software module. Higher numbers correspond to lower levels; the range is 0:31 Negative numbers select ALL levels from 0 to the absolute value of the number. \eos{Setup} \Help{2}{Spawn}{Executing OS functions}{} Syntax: SPAWN This command creates a new user process, in which DCL (Digital Command Language) commands may be given; it must be terminated with the LOG command. \eos{Spawn} \Help{2}{Report}{Please, let know your problems, questions ...}{} Syntax: REPORT Currently, this simply invokes Digital's MAIL facility, supplying destinations as DMF and CATALOG, and the subject as `Starcat comments'. You only need to enter your comments, and exit with CTRL/Z. The VAX/VMS Personal Mail Utility (MAIL) is used to send messages to other users of the system. For a complete description of the VAX/VMS Personal Mail Utility, including information about the MAIL command and its qualifiers, see the VAX/VMS Utilities Reference Volume. \eos{Report} \chapter{Conversion of celestial coordinates} \section{COCO} The COCO program (supplied by STARLINK) converts star coordinates from one system to another. Both the improved IAU system (post 1976) and the old system are supported. COCO can perform transformations between the following coordinate systems: \begin{enumerate} \item mean RA,Dec, old system, with E-terms (loosely FK4) \item mean RA,Dec, old system, no E-terms (some radio positions) \item mean RA,Dec, new system (loosely FK5) \item geocentric apparent RA,Dec, new system \item ecliptic longitude,latitude, new system (mean of date) \item galactic longitude,latitude, IAU 1958 system \end{enumerate} The input/output arrangements of COCO are flexible, to allow a variety of operating styles - interactive, input from a file, report to a file, batch, etc. Also, in addition to the report which is produced, the results of the conversions are also available in a raw form, to a fixed resolution and free from extraneous formatting; this file is intended to be read easily by other programs. COCO offers control over report resolution, and has a help facility. All input is free format, and defaults are provided where this is meaningful. In order to comply with the IAU 1976 recommendations, all position data published from 1984 on should be given in the new system, using equinox J2000.0. However, for many years to come positions will be given in the old system, using equinox B1950.0. Discriminating astronomers and astrophysicists are strongly urged to give both B1950 and J2000 positions for every source mentioned in their publications; the conversion can be done using COCO. \par In a typical COCO run, the first step would be to specify the input and output coordinate systems by means of the I and O commands, and then to enter the coordinates to be transformed. For example, suppose that we wish to convert a QSO position measured from a plate taken in mid-1976 and using reference stars from the SAO catalogue to 2000 coordinates in the new system. The following commands could be used: \begin{verbatim} I 4 1950 1976.5 * input system is B1950; epoch is 1976.5 O 5 * output system is J2000 12 43 25.3 +32 15 29 * measured 1950 position; no proper motion \end{verbatim} \par On startup, COCO is set to input FK4 B1950 and output FK5 J2000, with medium report resolution. % %---------------------- ARCHIVE HELP --------------------------- % \iffalse \Help{1}{A2.Help}{The screen displayed when ARCHIVE is called}{} Phase 2 of Archiving mainly consists in retrieving the TARGET name and position in J2000 of the observed objects. The {\bf SIMBAD} data-base is used for this purpose. The following menu is available: \BeginItems \Item {\bf C}: Question SIMBAD from coordinates \Item {\bf D}: Delete this object (transform to Calibration data) \Item {\bf I}: Question SIMBAD from a user-supplied designation \Item {\bf H}: Help on this phase \Item {\bf L}: Insert a comment in the FITS header \Item {\bf =}: Last displayed designation is target. \Item {\bf N}: Provide a name to the target (without SIMBAD) \Item {\bf Q}: Quit this object (try to solve next) \Item {\bf R}: Read a file \Item {\bf \$}: Spawn \Item {\bf S}: Setup \EndItems \eos{} \fi \Help{2}{ARCHIVESO}{The screen displayed when ARCHIVESO is called}{} \iffalse The {\bf ESO Archive} presently includes observations at {\bf EFOSC} (ESO Faint Object and Camera) instrument, at 3.6m La Silla telescope. It is not yet possible to ask for copies of existing images; ask to the observer for copies. \fi We would appreciate, if the EFOSC observers have time to scan what is presently displayed on the screen, and {\sl contact Francois Ochsenbein} (account {\sl FRANCOIS} or {\sl CATALOG}) for all required modifications (wrong target names, useless files, etc...). This would help to keep {\sl useful Archives}. \CentreLine{{\bf Thank You}!} \eos{} % % ------------------- S I M B A D Help ----------------------------- % \Help{1}{SIMBAD}{The screen displayed when SIMBAD is called}{} \Rule To connect to the SIMBAD data-base, simply issue the command {\em SIMBAD}. \Rule {\bf SIMBAD} is the data-base created by the Centre de Donnees Stellaires (CDS) which contains, for about 600,000 stars and 70,000 galaxies, the following information: \BeginItems \Item {\bf Fundamental Data}, including position(s), magnitudes, spectral or morphological classifications, and {\bf all designations}. \Item {\bf Data} or measurements from several catalogues \Item {\bf Bibliography} continuously updated: all papers quoting the specified object (star or galaxy) are listed under the bibliographical part. \EndItems \Rule At the main question {\em *Ident / Coord / SEL / END}, you may answer: \BeginItems \Item {\bf MSG}, to send a message to CDS \Item {\bf .Help}, to get {\Vu local} help; \Item {\bf HELP}, to get {\Vu SIMBAD} help; \Item {\bf INFO}, to get details about catalogues \Item An {Astronomical designation}, like {\bf V* RR LYR} or {\bf 3C 273} \Item {A position} (default equinox 1950.0), like {\bf 12 34 25.1 +60 34 12} \Item {\bf SEL} to enter the {\bf Selection} mode. \EndItems \eos{} \iffalse%------------- Same screen as SIMBAD --------------------------- \Help{2}{Introduction}{The screen displayed when SIMBAD is called}{} {\bf SIMBAD} is the data-base created and maintained by the Centre de Donnees Stellaires (CDS) which contains, for about 600,000 stars and 70,000 galaxies, the following information: \begin{alphaenumerate} \Item {\bf Fundamental Data}, including position(s), magnitudes, spectral or morphological classifications, and {\bf all designations}. \Item {\bf Data} or measurements from several catalogues \Item {\bf Bibliography} continuously updated: all papers quoting the specified object (star or galaxy) are listed under the bibliographical part. \end{alphaenumerate} At the main question {\em *Ident / Coord / SEL / END}, you may answer: \BeginItems \Item {\bf MSG}, to send a message to CDS \Item {\bf .Help}, to get {\Vu local} help; \Item {\bf HELP}, to get {\Vu SIMBAD} help; \Item {\bf INFO}, to get details about catalogues \Item An {Astronomical designation}, like {\bf V* RR LYR} or {\bf 3C 273} \Item {A position} (default equinox 1950.0), like {\bf 12 34 25.1 +60 34 12} \Item {\bf SEL} to enter the {\bf Selection} mode. \EndItems \eos{} \fi \Help{2}{Local}{Summary of available Local Facilities}{} \BeginTable{|lp{30em}|}{22,} \Rule Type & To get \\ \Rule {\bf .H Introduction} & SIMBAD Introduction screen \\ {\bf .H Identifications} & How to specify astronomical identification(s) \\ {\bf .H Coordinates} & How to enter a position \\ {\bf .H Measure}& How to answer to the {\em *Measurements} prompt \\ {\bf .H Biblio} & How to answer to the {\em *References} prompt \\ \Rule {\bf .H INFO} & How to get more information about the CDS, astronomical catalogues, SIMBAD bibliography, the abbreviations used for catalogues, etc... \\ \Rule {\bf .H SEL}& How to start Selection on SIMBAD \\ {\bf .H SEL.Description} & How to enter selection criteria, \\ {\bf .H SEL.List} & Display the list of available sampling criteria.\\ \Rule {\bf .W} {\sl seconds} & Modify the time-out after which the line is cleared (default is 90s) \LastRule \EndTable \eos{} \Help{2}{SMB}{Summary of INFO commands}{} \BeginTable{|l|p{20em}|}{20,} \Rule If you type & You will get help or details about: \\ \Rule .H INFO.CDS & Address of C.D.S \\ .H INFO.CMD & Special commands list \\ .H INFO.GRQ & Coding of greek letters \\ .H INFO.MES & List of catalogs with measurements \\ .H INFO.MODP & How to modify some parameters during SIMBAD session \\ .H INFO.BIB & Journals used for the bibliography \\ .H INFO.AMAS & Star cluster names \\ \Rule INFO {\sl name} & Description of measurements from catalogue {\sl name}\\ INFO CATA {\sl name}\& & Search on catalogues by first author \\ INFO CATI {\sl name}\& & Search on catalogues by catalogue name \\ INFO CATO {\sl type} & Search on catalogues by object type \\ INFO CATF {\sl type} & Search on objects by identification format \\ INFO REF {\sl aa.nnnnn} & Search on bibliography by reference code \\ INFO AUT {\sl y1,y2} {\sl name} & Search for papers over the [{\sl y1,y2}] period with first author {\sl name} specified\\ INFO REF {\sl aa.nnnnn} & Search on bibliography by reference code \\ \LastRule \EndTable Now, continuation of text... \eos{} \Help{2}{INFO}{Details of INFO command}{} The {\em INFO} commands allows to retrieve may details. \Help{3}{CDS}{Details about CDS}{} \BeginTable{|ll|}{24,40} \Rule Address of C.D.S. & Observatoire Astronomique \\ & Centre de Donnees Stellaires \\ & 11, rue de l'universite\\ & F - 67000 {\Vu STRASBOURG} \\ & France\\ & \\ & Telex: 890 506 \\ \Rule {BitNet (EARN)} address & Node {\sl FRCCSC21}, userid {\sl U01117} \\ \Rule {\bf C. Jaschek} , Director & +33.88 35 82 20 \\ P. Dubois & +33.88 35 82 00 \\ D. Egret & +33.88 35 82 00 \\ A. Heck & +33.88 25 82 22 \\ M. Wenger & +33.88 25 82 19 \\ \LastRule \EndTable \eos{} \Help{3}{CMD}{List of special commands}{} The following special commands are available: \BeginTable{|l|l|}{6,35} \Rule \ NEWS & \ print the "hot-news" \\ \ INFO & \ print different informations. \\ \ TIME & \ give the actual time. \\ \ TSUP & \ print computer time \\ \ CT & \ print active counters \\ \ STOP & \ stops execution immediatly \\ \ MODP & \ modify parameters (see INFO.MODP) \\ \ MSG & \ send message to SIMBAD staff \\ \LastRule \EndTable \eos{} \Help{3}{GRQ}{How to write greek letters}{} The coding of greek letters is as follows: \BeginTable{|rlrlrl|}{10,5,10,5,10,5} \Rule alpha:&\ ALF & iota:&\ IOT & rho:&\ RHO \\ beta:&\ BET & kappa:&\ KAP & sigma:&\ SIG \\ gamma:&\ GAM & lambda:&\ LAM & tau:&\ TAU \\ delta:&\ DEL & mu:&\ MU. & upsilon:&\ UPS \\ epsilon:&\ EPS & nu:&\ NU. & phi:&\ PHI \\ zeta:&\ ZET & xi:&\ KSI & khi:&\ KHI \\ eta:&\ ETA & omicron:&\ OMI & psi:&\ PSI \\ theta:&\ TET & pi:&\ PI. & omega:&\ OME \\ \LastRule \EndTable \eos{} \Help{3}{MES}{List of available astronomical data in SIMBAD}{} \BeginTable{ll}{6} {\bf CEL} &Ultraviolet photometry from "Celescope" \\ {\bf GCRV} &Radial velocities\\ {\bf GEN} &U B B1 B2 V1 V2 G photometry in Geneva 7-colour system\\ {\bf GJ} &Absolute magnitudes and spatial velocities of nearby stars. \\ {\bf HGAM} &H-gamma equivalent width \\ {\bf Hbet} &H-beta index (used in connection with Stroemgren's photometry)\\ {\bf IRC} &KI photometry from "Two Micron Sky Survey"\\ {\bf JP11} &UBVRIJKLMNH 11-colour Johnson's photometry\\ {\bf MK} &Stellar spectral classification in Morgan-Keenan system \\ {\bf PLX} &Trigonometric parallaxes \\ {\bf ROT} &Rotational velocities (v*sin(i)) \\ {\bf RVEL} &Radial velocities of extragalactic objects (quasars and galaxies)\\ {\bf SAO} &Positions and proper motions from SAO catalogue. \\ {\bf TD1} &Ultraviolet magnitudes from TD1 experiment\\ {\bf UBV} &3-colour (UBV) photometry in Johnson's system\\ {\bf V*} &Data related to variable stars\\ {\bf pm} &Proper motions (in 1950 equatorial frame)\\ {\bf pos} &Equatorial positions \\ {\bf uvby} &Photometry in Stroemgren's system\\ {\bf z} &Redshifts (galaxies and quasars) \EndTable \eos{} \Help{3}{BIBA}{List of Journals surveyed}{} \BeginTable{|lr|}{48,12} \Rule Title & \Centre{range} \\ \Rule Abatsumanakaja Astrof. Obs. Gora Kanobili Bull. &17501-17750 \\ Acta Astron. &14001-14250\\ Acta Astron. Sinica &19001-19250\\ Ann. Tokyo Astron. Obs. &19501-19750\\ Arkiv for Astron. &13751-14000\\ Astrofiz. Issledovanija &18001-18250\\ Astrofizika &11751-12000\\ Astron. Astrophys. & 1001- 1500\\ Astron. Astrophys., Suppl. Ser. & 1501- 2000\\ Astron. Circ. &20001-20250\\ Astron. Express & 7001- 7499\\ Astron. J. & 2001- 2500\\ Astron. Nachr. &11251-11500\\ Astron. Tsirk. &10251-10500\\ Astron. Zu. & 4501- 5000\\ Astronomy &25001-25250\\ Astrophys. J. & 1-\ \ 500\\ & 9001-10000\\ Astrophys. J., Suppl. Ser. & 501- 1000\\ Astrophys. Lett. &12001-12250\\ Astrophys. Space Sci. & 4001- 4500\\ Australian J. Phys. &25251-25500\\ Bol. Inst. Tonantzintla &25501-25750\\ Bull. American Astron. Soc. &17251-17500\\ Bull. Astron. Inst. Czech. &13001-13250\\ Bull. Astron. Obs. R. Belgique &25751-26000\\ Bull. Inf. Centre Donnees Stellaires &32001-32250\\ Bull. Obs. Astron. Beograd &26001-26250\\ C.R. Acad. Sci. & 5001- 5500\\ Chinese Astron. &19251-19500\\ Circ. Bureau Central Telegrammes &20251-20500\\ Griffith Obs. &26251-26500\\ IAU Inform. Bull. Var. Stars &14501-14750\\ Icarus &22251-22500\\ Irish Astron. J. &26501-26750\\ Izv. Krym. Astrofiz. Obs. &15251-15500\\ J. Astron. Astrophys. &23501-23750\\ J. Astronomes Francais &23751-24000\\ J. Br. Astron. Soc. &10751-11000\\ J. R. Astron. Soc. Can. &12501-12750\\ L'astronomie &20501-20750\\ La Recherche &20751-21000\\ Lick Obs. Bull. &27001-27250\\ Lowell Obs. Bull. &27251-27500\\ Mem. R. Astron. Soc. &16001-16250\\ Mem. Soc. Astron. Ital. &12251-12500\\ Mercury &22501-22750\\ Mitt. Veraenderliche Sterne &11501-11750\\ Mitteil. Astron. Gesellschaft &28001-28250\\ Mon. Not. R. Astron. Soc. & 2501- 3000\\ Mon. Notes Astron. Soc. South Afr. &14251-14500\\ Nature &11001-11250\\ New Scientist &23251-23500\\ Observatory &10501-10750\\ Occasional Reports R. Obs. &28251-28500\\ Perem. Zvezdy Prilozh. &16501-16750\\ Perm. Zvezdy &16251-16500\\ Philos. Tr. R. Soc. London &28501-28750\\ Physics Today & 6001- 6500\\ Pis'ma Astron. Zu. &17751-18000\\ Proc. Astron. Soc. Aust. &16751-17000\\ Publ. Astron. Soc. Jap. &13251-13500\\ Publ. Astron. Soc. Pac. & 3001- 3250\\ Publ. David Dunlap Obs. &27501-27750\\ Publ. Dominion Astrophys. Obs. Victoria &12751-13000\\ Publ. Obs. Geneve &15001-15250\\ Publ. Obs. Haute-Provence &29251-29500\\ Publ. Obs. Strasbourg &29501-29750\\ Publ. R. Obs. Edinburgh. &28751-29000\\ Publ. Tartuskoj Astrofiz. Obs. &18251-18500\\ Quart. J. R. Astron. Soc. &29001-29250\\ R. Obs. Bull. &14751-15000\\ Rev. Mex. Astron. &13501-13750\\ Ricerche Astron. &29751-30000\\ Science & 5501- 6000\\ Scientific American &22751-23000\\ Sky Telesc. &10000-10250\\ Soobshch. Gos. Astron. Inst. P.PK. Shterberga &15501-15750\\ Sov. Astron. & 3501- 4000\\ Soviet Astron. Lett. & 3251- 3500\\ Space Sci. Reviews &27751-28000\\ Sterne und Weltraum &22001-22250\\ The Messenger &23001-23250\\ Tokyo Astron. Bull. &19751-20000\\ Urania &18751-19000\\ Vatican Obs. Publ. &17001-17250\\ Veroeff. Sternwarte Sonneberg &15751-16000\\ Vilnius Astron. Obs. Biul. &18501-18750\\ \LastRule \EndTable \eos{} \Help{3}{MODP}{How to modify some parameters}{} Some parameters can be modified during a SIMBAD session with the following command: \CentreLine{\em MODP\quad keyword \quad value(s)} \CentreLine{or} \CentreLine{\em MODP\quad +/- \quad keyword [,keyword ...] } \BeginTable{|ccc|}{29,9,29} \Rule Parameter & keyword & value \\ \Rule dialogue language & LGUE & E (engl.) / F(french) \\ equat. coord. equinoxes & EQUI & year1 year2 \\ format descriptor & EDIT & format descriptor name \\ \Rule compressed displaying & +/- & COMPRESS \\ continuous displaying & +/- & CONT \\ statistics & +/- & STAT \\ \LastRule \EndTable \eos{} \Help{3}{AMAS}{Designation of Clusters}{} \BeginTable{lll}{17,15,26} ABELL & HOGG & BERKELEY\\ ALTER & ISKURZDAJAN & COLLINDER\\ APRIAMASWILI & KING & MELOTTE \\ ARP & LYNGA & RUPRECHT\\ BAADE & MARKARJAN & VAN\_DEN\_BERGH-HAGEN \\ BARHATOVA & PALOMAR & \crule \\ BASEL & PISMIS & {\sl Notice}: \\ BIURAKAN & ROSLUND & \\ BLANCO & SHER & +NGC\ \ 869 = h Per \\ CZERNIK & STEPHENSON & +NGC\ \ 884 = chi Per \\ DEJE & STOCK & +NGC 2632 = Praesepe\\ DOLIDZE & SAHLBAJAN & +AMAS BLANCO 1 = zeta Scl\\ DOLODZE-DZIM & TERZAN & +AMAS MEL\ \ 20 = alpha Per\\ DUFAY & TOMBAUGH & +AMAS MEL\ \ 22 = Pleiades\\ FEINSTEIN & TRUMPLER & +AMAS MEL\ \ 25 = Hyades \\ GINGERICH & UPGREN & +AMAS MEL 111 = Coma Ber\\ GRAFF & VAN\_DEN\_BERGH & \crule \\ HAFFNER & WESTERLUND & \\ HARVARD & ZWICKY & \\ HAUTE-PROVENCE & BOCHUM & \EndTable \eos{} \Help{2}{Coordinates}{How to query from Coordinates}{} Searching all objects contained within a small cercle around a position specified by its {\sl alpha} and {\sl delta} coordinates ({\sl equinox} specified or default: 1950) and of {\sl radius} given in parameter (default: 10'). Equinox and radius parameters {\bf remain unchanged until} new values are provided. {\sl Example}: To get objects closer than 20' around the position (12h 34mn +56 degrees) specified in 1985 equinox, type \CentreLine{{\em 12 34 +56 R 0 20 E 1985.0}} Using the defaults 1950 equinox and 10' radius, type simply \CentreLine{{\em 12 34 +56}} \eos{} \Help{2}{Identifications}{How to query from Astronomical Designations}{} Identifications list may have one of the following structure: \BeginTable{|l|l|l|}{20,30} \Rule {Type} & {Format} & \Centre{Example} \\ \Rule Elementary & Cat designation & V* RR LYR \\ List & Cat n1, n2, ... & BD +60 12, +59 234 \\ Repetitive part & Cat part: n1, n2, ... & BD -00: 10,54,128 \\ Generic & Cat [rep:] n1, n2 -> n3 & BD -07: 1,2 -> 10 \\ Whole & Cat * & M * \\ \LastRule \EndTable {\em Suffixes}: a single identification can be followed by: {\bf\&}\quad for getting all objects from the one asked. \\ {\bf!}\quad for getting all objects in a group (ex: NGC 2244!). \eos{} \Help{2}{Measurements}{How to answer to *Measurements prompt}{} \ \ \\ At the prompt {\em *Measurements}, the answers may be: \BeginTable{|lp{20em}|}{5} \Rule {\bf Y !} & List continuously all available measurements. \\ {\bf N} & No measurement will be displayed. SIMBAD skips directly to the bibliography. \\ {\bf NN} & Display is interrupted (No measurements, nor bibliography will be displayed). \\ {\bf L } & The program displays the list of measurement catalogs available for this star with, for each catalog, in brackets, the number of measurements. {\bf(default}) \\ {\bf {\sl name}}& The {\sl name} measurements are displayed. \\ \LastRule \EndTable Note that \BeginItems \Item {\bf .Help INFO.Meas} displays a short explanation for all available measurements; \Item {\bf INFO {\sl name}} displays complete explanations about {\sl name} measurements. \EndItems \eos{} \Help{2}{References}{How to answer to {\em *References} prompt}{} At the prompt {\em *References }, the answers may be: \BeginTable{|lr|p{20em}|}{2,13} \Rule {\bf Y} & (yes) & Display next reference \\ {\bf N} & (no) & Stop displaying the bibliography.\\ {\bf C} & (continuous) & Display all references in a continuous, not interruptible, mode.\\ {\bf P} & (page) & Pages of references are diplayed. \\ \Rule & {\sl y1} & Selection of references published from the year {\sl y1} inclusive. \\ & {\sl y1,y2} & Selection of references published between years {\sl y1} and {\sl y2}.\\ \LastRule \EndTable \eos{} \Help{2}{SEL}{How to start a Selection}{} After the choice of the {\em SEL} command, the possibilities are: \BeginTable{|ll|}{14} \Rule DEFC &{\bf DEF}inition of {\bf C}riteria. You will be prompted for criteria. \\ ADC &{\bf AD}dition of {\bf C}riteria to the existing set.\\ EDC &{\bf ED}ition of {\bf C}riteria. \\ OMIT &Exit from selection facilities \\ RES &{\bf RES}et the list of criteria (empty sample) \\ GO &Use the defined set of criteria to create the sample. \\ COPY {\sl name}&Save the sample as {\sl name} (12 alphabetic characters max)\\ GET {\sl name}&Recall a previously saved sample.\\ EDIT &Display the objects contained in the sample (see {\bf .Help SEL.Edit}) \\ DEL {\sl n1[,n2]} &Delete, in the current sample, objects number {\sl n1} to {\sl n2}.\\ OP & Logical operation between samples; (see {\bf .Help SEL.OP}) \\ \LastRule \EndTable \eos{} \Help{3}{ED}{Edition of a sample}{} The edition of a sample is activated by the {\bf EDIT} command, which has one optional parameter: \BeginTable{|ll|}{8} \Rule EDIT & Standard display: you are prompted for the object number, or for the next one. \\ EDIT {\bf 1} & Display one line per object (fundamental data) \\ EDIT {\bf 2} & Display two lines per object (fundamental data + identifications) \\ EXIT {\bf C} & continuous display (may be very long!) \\ \LastRule \EndTable \eos{} \Help{3}{OP}{Operations between samples}{} A logical operation between the {\sl current} sample and a {\sl named} one (saved with a previous COPY command) may be performed with the {\bf OP} command; this command has 2 parameters: \BeginTable{|lp{30em}|}{10} \Rule OP {\bf A} {\sl name} & Logical {\bf AND} operation (intersection): objects common to both samples are kept. \\ OP {\bf O} {\sl name} & Logical {\bf OR} operation (union): objects belonging to any of the 2 samples are kept. \\ OP {\bf X} {\sl name} & Logical {\bf Exclusive OR} operation: objects belonging only to one of the 2 samples are kept. \\ \LastRule \EndTable As an example, to get the set {\sl S3} of objects belonging to {\sl S1}, but not to {\sl S2}, use the following operations ( {\sl S3} = {\sl S1} {\bf X} ({\sl S1} {\bf A} {\sl S2}) \BeginItems \Item GET {\sl S1} \Item OP A {\sl S2} \Item OP X {\sl S1} \Item COPY {\sl S3} \EndItems \eos{} \Help{3}{List}{List of available Selection Criteria}{} For any selection possibility listed below, \BeginItems \Item lower and upper limits are separated by a {\bf/}, eg A0/F8 for spectral types in this range \Item alternatives are separated by {\bf,} eg B8/B9,K5/M0 for spectral types {\sl either} in the hot B8 to A0 spectral range, {\sl or} in the cold K5 to M0 range. \EndItems \BeginTable{|lll|}{10,32} \Rule Name & Meaning & Possibilities \\ \Rule OBJECT &object type & {\bf*},{bf G} or {\bf?} (stars, galaxies, other)\\ RA &right ascension & decimal or sexagesimal hours\\ DEC &declination & decimal or sexagesimal degrees\\ GL &galactic longitude & decimal or sexagesimal degrees\\ GB &galactic latitude & decimal or sexagesimal degrees\\ EL &ecliptic longitude & decimal or sexagesimal degrees\\ EB &ecliptic latitude & decimal or sexagesimal degrees\\ \Rule RADIUS &radius & decimal or sexagesimal degrees \\ DIM &rectangular field & {\bf width/heigth} in degrees \\ CENTER &equat. coord. center & alpha delta, eg {\sl 12 34.1 -0 12}\\ GCENTER &galact. coord. center & l b, eg {\sl 359.1 +0.1 } \\ ECENTER &eclipt. coord. center & l b, eg {\sl 359.1 +0.1 } \\ EQUINOX &equinox for CENTER & year, eg {\sl 1985.0} \\ \Rule PM &proper motions & unit is {\sl "/yr} \\ MB &B magnitude & (2 decimal digits max.) \\ MV &V magnitude & (2 decimal digits max.) \\ B-V &color index B-V & (2 decimal digits max.) \\ \Rule SP &spectral type & ex: {\sl K0III/K8III} \\ SPT &sp: temp. class & ex: {\sl K0 / K8} \\ SPL &sp: lum. class & ex: {\sl III / IV} \\ SPP &sp: partic. & ex: {\sl m} \\ MTYPE &morphological type (gal.) & ex: {\sl Sa / Sc }\\ \Rule ID &membership of a catalog & cat name, eg {\sl NGC, IC} \\ DATA &presence of measures & name, eg {\sl UBV} \\ \Rule BIB &presence of bibliography & Limits, eg {\sl 83/85} \\ DATABIB &Data from a reference & ex: {\sl UBV 68.123} \\ \Rule AMV &absolute magnitude & ex: {\sl -5 / 0} \\ ADM &apparent distance modulus & ex: {\sl 5 / 8} \\ \LastRule \EndTable \eos{} \Help{3}{Definition}{How to Enter Selection Criteria Definitions}{} You entered the {\em DEFC} (Definition of Criteria) or {\em ADC} (addition of criteria) command. The possibilities are: \BeginTable{|lp{30em}|}{15} \Rule MAX {\sl n1/n2} & Maxima of objects to select / of objects to read \\ SORT {\sl c1,...} & Sorting parameters (max 6), eg {\sl SORT RA,-DEC} \\ {\bf*}{\sl crit} & Enter a {\bf permanent} criterion.\\ {\sl crit} & Enter a {\bf temporary} criterion. \\ {\bf-}{\sl crit} & {\bf Delete} the named criterion. \\ DC {\sl n} & Delete criterion number {\sl n}. (The criteria are renumbered after this command).\\ \Rule EDC & Display list of criteria.\\ END & Stop entering criteria.\\ V & Validate the list of criteria.\\ N & Exit from the criteria definition loop.\\ RES &Reset criteria list and sample.\\ \LastRule \EndTable The list of criteria with their description can be obtained with the help {\bf SEL.List}. \eos{}