The ESI Spectrograph Online Documentation

Agents in Drawing esi...

Wed 1999 Sep 22 14:15:45 PDT

Drawings included in this Document:

esi.dca.figdisp
Title Unknown (Anonymous)
ESI.focus.proposal
Title Unknown (Anonymous)
ESI.hardware.conn
Title Unknown (Anonymous)
esi.init
Title Unknown (Anonymous)
esi.init.dispatcher
Title Unknown (Anonymous)
esi.init.figdisp
Title Unknown (Anonymous)
esi.init.infoman
Title Unknown (Anonymous)
esi.init.lickserv
Title Unknown (Anonymous)
esi.init.traffic
Title Unknown (Anonymous)
esi.init.watch_ccd
Title Unknown (Anonymous)

Agent List:

Cassegrain Focus (Hardware, Keck)
Cassegrain focus of the Keck telescope.
Created by CARA, current rev is .
Cassegrain Focus's roles:
CCDcrate (Hardware, Generic)
VME computer which contains Leach hardware that controls a CCD and dewar.
Created by LOEL/Kibrick, current rev is .
CCDcrate's roles:
ccdserv (Daemon, Generic)
Process running on CCD VME crate which accepts and transmits CCD control information via MUSIC.
Written in C by Kibrick et al.. Current release is .
ccdserv's roles:
Control Room (Hardware, Keck)
Control room of the Keck telescope
Created by CARA, current rev is .
Control Room's roles:
Controllers (Hardware, DEIMOS)
A generic meme for the ensemble of DEIMOS motor controllers. Includes the Lantronix and the Galil cards. For a detail diagram they need individual names.
Created by LOEL/Tucker, current rev is .
Controllers's roles:
Cspot ({User Tool}, esifocus)
Centroid on reference spots, adjust collimator to optimal tip/tilt. Or let user manually adjust.
Written in IDL/IRAF/Tcl by Kibrick/Phillips?. Current release is .
Cspot's roles:
CspotCentroid ({Function or feature}, esifocus)
Analyze image and compute centroids and dx dy to optimal position
Neither hardware nor software, release/authorship info is irrelevant.
CspotCentroid's roles:
CspotMapCoords ({Function or feature}, esifocus)
Map image coords to collimator tip/tilt values
Neither hardware nor software, release/authorship info is irrelevant.
CspotMapCoords's roles:
CspotUI ({Function or feature}, esifocus)
Allow user to override the automatic optimization and specify an offset manually
Neither hardware nor software, release/authorship info is irrelevant.
CspotUI's roles:
Dashboard ({User Tool}, KTL)
GUI builder for any KTL system. Knowledge-based (gets meme info from database).
Written in TclTk by Clarke. Current release is 1.26 DBII-1-4a. See ronin.ucolick.org:/a/local/CVS/deimos/swCDR/essays/de/Dashboard for more information.

Dashboard's roles:
dashboard.sh (Command, Generic)
startup script for Dashboard
Written in Bourne shell by Allen. Current release is .
dashboard.sh's roles:
DataBase (Daemon, )
Sybase dataserver, commercial product..
Written in C by Sybase. Current release is . See http://www.sybase.com for more information.

DataBase's roles:
DataTakingComputer (Hardware, Generic)
Computer used by astronomer for instrument control and quick look. For HIRES/LRIS this was called InstrumentComputer.
Created by Sun/Dec/etc., current rev is .
DataTakingComputer's roles:
DCS (Daemon, )
Keck Drive and Control System which points the telecopse.
Written in C by CARA. Current release is .
DCS's roles:
Disk (Daemon, Generic)
A disk file which has multiple readers and/or writers.
Written in kernel by Unix. Current release is .
Disk's roles:
dispatcher2.0 (Daemon, esi)
Dispatcher #0 for ESI
Written in C by Tucker. Current release is .
dispatcher2.0's roles:
dispatcher2.1 (Daemon, esi)
Dispatcher #1 for ESI
Written in C by Tucker. Current release is .
dispatcher2.1's roles:
dispatcher2.sh (Command, Generic)
startup script for dispatcher(s)
Written in Bourne shell by Allen. Current release is .
dispatcher2.sh's roles:
dispatchers (Daemon, DEIMOS)
A generic meme for the ensemble of processes which run in the DEIMOS supervisory computer and talk to DEIMOS motor controllers. For a detail diagram they need individual names.
Written in C by Tucker. Current release is .
dispatchers's roles:
dome_public_net (Hardware, esi)
The CARA-supplied public network in the control room
Created by , current rev is .
dome_public_net's roles:
electrolog.sh (Command, Generic)
startup script for electrolog
Written in Bourne shell by Allen. Current release is .
electrolog.sh's roles:
esi (Command, ESI)
master control script for starting, stopping, and examining the ESI processes
Written in Bourne shell by Allen. Current release is .
esi's roles:
esi5c (Hardware, esi)
CCD Crate for ESI. Oversees the control of the CCD subsystems.
Created by Lick/SDSU/Force, current rev is VxWorks 5.2.
esi5c's ports:
  • le0 (AUI ethernet (f))
  • Rx (62.5um fiber 50Mb/s)
  • Tx (62.5um fiber 4Mb/s t)

esi5c's roles:
esi5cMAU (Hardware, esi)
connector between AUI port on ESI CCD crate and the CAT5/RJ45 cable to the ESI private network switch (all in the control room)
Created by , current rev is .
esi5cMAU's ports:
  • AUI (AUI ethernet (m))
  • RJ45 (10 base T (f))

esi5cMAU's roles:
esiCCD (Hardware, esi)
The ESI CCD dewar and electronics
Created by Lick/SDSU, current rev is .
esiCCD's ports:
  • 17p (17-pin MilSpec (m))
  • 61p (61-pin MilSpec (m))
  • v1 (VIDEO 1 BNC (m))
  • v2 (VIDEO 2 BNC (m))

esiCCD's roles:
esiCCDctrl (Hardware, esi)
The ESI CCD controller (at the Cassegrain focus)
Created by Lick/SDSU, current rev is .
esiCCDctrl's ports:
  • 17p (17-pin MilSpec (m))
  • 61p (61-pin MilSpec (m))
  • Rx (62.5um fiber 4Mb/s r)
  • Tx (62.5um fiber 50Mb/s)
  • v1 (Video 1 BNC (m))
  • v2 (Video 2 BNC (m))

esiCCDctrl's roles:
esiLantronMAU (Hardware, esi)
connector between AUI port on ESI Lantronix (at the Cassegrain focus) and 10B2 coax which threads through the cable wrap down to the ESI private net in the control room.
Created by , current rev is .
esiLantronMAU's ports:
  • AUI (AUI ethernet (m))
  • BNC (10 base 2 coax (m))

esiLantronMAU's roles:
esinst (Hardware, esi)
Instrument Computer for ESI. Runs data capture and other observer-related proceses. Sun Ultra 2 UPA/SBus (2 X UltraSPARC 168MHz)
Created by Sun Microsystems, current rev is Solaris 2.5.1.
esinst's ports:
  • hme0 (RJ45 10/100 (f))
  • hme1 (RJ45 10/100 (f))

esinst's roles:
esirepeater (Hardware, esi)
connector between ESI private net (CAT5/RJ45 in control room) and 10B2 coax which threads through the cable wrap to ESI at the Cassegrain focus
Created by , current rev is .
esirepeater's ports:
  • BNC (10 base 2 coax (m))
  • RJ45 (10 base T (f))

esirepeater's roles:
esiswitch (Hardware, esi)
10/100 Mbit/s network switch at the core of the ESI private network.
Created by Cisco, current rev is Micro Switch 10/100.
esiswitch's ports:
  • RJ45a (10/100bT RJ45(f) 1)
  • RJ45b (10/100bT RJ45(f) 2)
  • RJ45c (10/100bT RJ45(f) 3)
  • RJ45d (10/100bT RJ45(f) 4)

esiswitch's roles:
esupv (Hardware, esi)
Supervisory Computer for ESI. Runs most non-user processes. Sun Ultra 1 SBus (UltraSPARC 143MHz)
Created by Sun Microsystems, current rev is Solaris 2.5.1.
esupv's ports:
  • hme0 (10/100 Mb/s AUI(f))
  • le0 (10 Mb/s AUI(f))

esupv's roles:
figdisp.sh (Command, Generic)
startup script for kfigdisp
Written in Bourne shell by Allen. Current release is .
figdisp.sh's roles:
GALIL0 (Hardware, esi)
Galil Controller #0 for ESI
Created by Galil Motion Control, current rev is DMC 1580 Rev 2.0h.
GALIL0's ports:
  • aux (aux DB9 serial (f))
  • main (main DB9 serial (m))

GALIL0's roles:
GALIL1 (Hardware, esi)
Galil Controller #1 for ESI
Created by Galil Motion Control, current rev is DMC1580 Rev 2.0h.
GALIL1's ports:
  • aux (aux DB9 serial (f))
  • main (main DB9 serial (m))

GALIL1's roles:
HWengineer (Person, )
A Hardware Engineer, responsible for design, drawings, fabrication, installation, test, debug, documentation.
Neither hardware nor software, release/authorship info is irrelevant.
HWengineer's roles:
idFilter ({Function or feature}, esifocus)
Determine thickness of filter by filter name
Neither hardware nor software, release/authorship info is irrelevant.
idFilter's roles:
infoman (Daemon, music)
Preserves state information of instrument across restarts of the music clients.
Written in C by Stover/Kibrick. Current release is .
infoman's roles:
infoman.sh (Command, Generic)
startup script for Infoman
Written in Bourne shell by Allen. Current release is .
infoman.sh's roles:
IRAF ({User Tool}, Generic)
Image Reduction and Analysis Facility
Written in SPP/C by NOAO. Current release is 2.11. See http://iraf.noao.edu for more information.

IRAF's roles:
kfigdisp ({User Tool}, Generic)
Figdisp is the official real time image display for optical instruments at Keck Observatory.
Written in C by CIT/Lick. Current release is .
kfigdisp's roles:
Kroot.Data (Repository, KTL)
This is the directory where many KTL config files can be found.
Neither hardware nor software, release/authorship info is irrelevant.
Kroot.Data's roles:
Kroot.Log (Repository, KTL)
This is not really one simple directory, but a concept: kroot/ktl configuration mechanisms tell apps where to log. Except for lickserv.
Neither hardware nor software, release/authorship info is irrelevant.
Kroot.Log's roles:
Lantronix1 (Hardware, esi)
Lantronix Network TS #1 for ESI
Created by Lantronix, current rev is V3.5/1 (970325).
Lantronix1's ports:
  • 1 (RJ45 serial 1)
  • 2 (RJ45 serial 2)
  • 3 (RJ45 serial 3)
  • 4 (RJ45 serial 4)
  • AUI (10 Mbps AUI(f))

Lantronix1's roles:
libdcs2_keyword ({shareable object library}, KTL)
The KTL keyword service library for 2nd generation DCS. Is really just a link to the EPICS Channel Access keyword service library (libcake_keyword).
Neither hardware nor software, release/authorship info is irrelevant.
libdcs2_keyword's roles:
libDV ({shareable object library}, Generic)
a fictional amalgam of DataViews shared libraries for the sake of simplicity
Neither hardware nor software, release/authorship info is irrelevant.
libDV's roles:
libesi_keyword ({shareable object library}, KTL)
The KTL keyword service library for ESI.
Neither hardware nor software, release/authorship info is irrelevant.
libesi_keyword's roles:
libktl ({shareable object library}, KTL)
The KTL library.
Neither hardware nor software, release/authorship info is irrelevant.
libktl's roles:
libmusic ({shareable object library}, music)
The MUSIC library.
Neither hardware nor software, release/authorship info is irrelevant.
libmusic's roles:
libTclTk ({shareable object library}, Generic)
a fictional amalgam of Tcl/Tk shared libraries for the sake of simplicity
Neither hardware nor software, release/authorship info is irrelevant.
libTclTk's roles:
libX11 ({shareable object library}, Generic)
a fictional amalgam of X11 libraries for the sake of simplicity
Neither hardware nor software, release/authorship info is irrelevant.
libX11's roles:
lickserv (Daemon, music)
The Data Capture Agent for Keck HIRES/LRIS and similar instruments. Receives image from CCD VME crate, obtains header from watch_ccd, writes FITS file, writes shmem and X properties for display.
Written in C by Kibrick. Current release is .
lickserv's roles:
lickserv.sh (Command, Generic)
startup script for lickserv
Written in Bourne shell by Allen. Current release is .
lickserv.sh's roles:
mFigdisp ({User Tool}, DEIMOS)
Figdisp, modified to handle mosaic CCD images.
Written in C by CIT/Lick. Current release is .
mFigdisp's roles:
OA/TT (Person, )
Observing Assistant/Telescope Technician.
Neither hardware nor software, release/authorship info is irrelevant.
OA/TT's roles:
Observer (Person, )
The observer on the summit (or remote) who is in control of the observing session.
Neither hardware nor software, release/authorship info is irrelevant. See home page for more information.

Observer's roles:
OSinit (Command, Generic)
The initialization procedure run by the operating system of a machine as a part of its boot.
Written in any OS langu by any OS author. Current release is .
OSinit's roles:
rccd (Daemon, Generic)
Process running on CCD VME crate which reads out CCD and transmits image to instrument computer.
Written in C by Kibrick et al.. Current release is .
rccd's roles:
rfits (Command, Generic)
FITS file interface to figdisp
Written in C by Cromer et al.. Current release is .
rfits's roles:
rfits.tcl (Command, Generic)
GUI interface to rfits
Written in Tcl/Tk by Cromer/Deich. Current release is .
rfits.tcl's roles:
ShMem (Daemon, Generic)
A segment of shared memory in the sense defined by XPG4
Written in kernel by X/Open. Current release is .
ShMem's roles:
STB (Daemon, )
Save The Bits archiving system from NOAO
Written in C by NOAO. Current release is .
STB's roles:
SupervisoryComputer (Hardware, Generic)
Computer which supervises the operation of the instrument's VME crates.
Created by Sun/Dec/etc., current rev is .
SupervisoryComputer's roles:
traffic (Daemon, )
The central agent in the MUSIC messaging system developed at Lick and also used at Keck.
Written in C by Stover/Kibrick. Current release is .
traffic's roles:
traffic.sh (Command, Generic)
startup script for traffic
Written in Bourne shell by Allen. Current release is .
traffic.sh's roles:
watch_ccd (Daemon, music)
gathers FITS header information at beginning and end of a CCD exposure
Written in C by Kibrick et al.. Current release is .
watch_ccd's roles:
watch_ccd.sh (Command, Generic)
startup script for watch_ccd
Written in Bourne shell by Allen. Current release is .
watch_ccd.sh's roles:
watch_coll (Daemon, esifocus)

Written in C or Tcl by Kibrick. Current release is .
watch_coll's roles:
WC_flex ({Function or feature}, esifocus)
Model flexure correction based on EL and rotation.
Neither hardware nor software, release/authorship info is irrelevant.
WC_flex's roles:
WC_piston ({Function or feature}, esifocus)
Apply focus correction based on filter thickness
Neither hardware nor software, release/authorship info is irrelevant.
WC_piston's roles:
ximtool ({User Tool}, Generic)
The image display currently in use with IRAF.
Written in C by NOAO. Current release is .
ximtool's roles:
Xserver (Daemon, Generic)
The observer's X server
Written in C by MIT/XC/XOpen. Current release is .
Xserver's roles:
The Observer documents are hand-written. The Technical Documents are produced from plain text files in the CVS source tree by some Tcl scripts written at UCO/Lick Observatory. The Reference Documents are mostly generated by software from data in a relational database. Individual authors are responsible for the content of the Observer and Technical Documentation. The Lick SPG as a whole is responsible for the content of the Reference doco. Send mail to de@ucolick.org to report inconsistencies or errors in the documentation.