This section covers externally sourced software not addressed in previous sections.
The NCCS is written primarily in C. The compiler is GNU C.
For information on the GNU
libc C library currently used by Linux:
dselect(as root) to install
info libcthen displays the documentation on C.
link to a list of C resources on the web at http://www.lysator.liu.se/c/c-www.html.
Links to on-line courses in C:
Steve Holmes' course at http://www.strath.ac.uk/CC/Courses/newCourse/ccourse.html
A variety of tutorials on programming on Unix and Unix-like systems is available online.
Little Unix Programmers Group (LUPG)'s Little Site at http://users.actcom.co.il/ choo/lupg/tutorials/index.html has info on compiling C/C++, debugging with dbg, compiling with Makefiles, creating and using C libraries, Unix system programming, using sockets, multi-process programming and more.
The NCCS computers all run on the Debian distribution of Linux.
link to Debian/GNU Linux at http://www.debian.org
Data will be exportable in FITS-format files, amongst others. The format for internal data files is not finalised. The libraries CFITSIO, FITSIO (now superceded by CFITSIO) and FTOOLS are available for working with FITS files. CFITSIO is installed, FTOOLS is present but not installed. The source code and information is all in /usr/local/src/fits/.
Links to external FITS documentation:
FITS Support Office home page at http://fits.gsfc.nasa.gov/
Representations of celestial coordinates in FITS, updated regularly, by E W Greisen and M Calabretta, in http://www.aoc.nrao.edu/ egreisen/inFITS.html
Also look at Representations of celestial coordinates in FITS, updated regularly, by E W Greisen and M Calabretta, in http://www.aoc.nrao.edu/ egreisen/ or
Representations of celestial coordinates in FITS, updated regularly, by E W Greisen and M Calabretta, in http://www.atnf.csiro.au/ mcalabre/
index to documentation on FITS usage for the GBT at http://www.gb.nrao.edu/GBT/MC/doc/index/spn_doc_index/
links to external FITS software:
FTOOLS - A General Package of Software to Manipulate FITS Files home page at http://heasarc.gsfc.nasa.gov/docs/software/ftools/ftools_menu.html
CFITSIO - A FITS File Subroutine Library home page at http://heasarc.gsfc.nasa.gov/docs/software/fitsio/fitsio.html
fv: The Interactive FITS File Editor home page at http://heasarc.gsfc.nasa.gov/docs/software/ftools/fv/
Links to local copies of FITS documentation (note that some of these may be out of date or have been replaced with updated versions):
Definition of the FITS standard for data files, NOST 100-2.0 of 1999/03/29, in /usr/local/src/fits/fits_standard.ps
FITS User's Guide, Version 4.0 of 1997/04/14, in /usr/local/src/fits/users_guide.ps
CFITSIO User's Guide, Version 2.0 of 1998/11, for C programmers, in /usr/local/src/fits/cfitsio-v2027/cfitsio.ps
The FITSIO Cookbook, Version 1.1 of 1995/04, for Fortran programmers, in /usr/local/src/fits/fitsio-v503/cookbook.ps
Users' Guide to FTOOLS, Version 3.5 of 1996/03/29, in /usr/local/src/fits/ftools-v35/users.v3.5.ps Note that this version is now out of date.
Setting up for fv, Version 2.5 of 1999/04/30, in /usr/local/src/fits/fv/fv.setup. "fv" is a FITS file viewer and editor.
PGPLOT is in use for plotting data from analysis software such as PLOTA, LINES and WIP. It could be used by observing programs for plotting data.
link to manual on PGPLOT graphics functions callable from C and Fortran, installed at HartRAO, at http://astro.caltech.edu/ tjp/pgplot/
link to homepage of WIP, an interactive plotting frontend using PGPLOT and particularly useful with FITS images, installed at HartRAO, at http://bima.astro.umd.edu/bima/wip/wip.html
SLALIB is the astronomical coordinate transformation library from Starlink. The original (free) version is in Fortran, but a (proprietary) C version has been obtained from the author.
** Note that routine sla_DAT has to be updated on each occasion that a leap second is announced, and programs using it relinked.
The 'C' version of 2000/03/16 is installed in /usr/local/src/slalib_c. The C version of the library is in /usr/local/lib/libcsla.a and the requisite function prototypes are in the header file /usr/local/include/slalib.h
The fortran slalib of 1999/06/29 was obtained from the starlink archive and installed in /usr/local/src/star/. The Fortran library is installed in /usr/local/lib/libsla.a
The fortran slalib of 2000/03/13 was obtained from the starlink archive and installed in /usr/local/src/sla2000/
SLALIB documentation, of 2000/03/13, in ../nccs/doc/slalib/sun67.htx/sun67.html
SLALIB documentation, of 2000/03/13, in ../nccs/doc/slalib/sun67.ps
SLALIB C function prototypes, of 2000/03/13, in ../nccs/doc/slalib/slalib.fp, from slalib.h
link to Starlink home page, at http://star-www.rl.ac.uk/
SGML is the standard documentation format for the NCCS, from which
postscript, latex, plain text etc. can be produced. Plain ascii is the
quick alternative. Use
dselect to install
This defines a suitable layout for documentation, and has tools to convert
SGML to the other formats.
SGML-Tools User's Guide, html version 0.99.0 of 1996/11/29, in ../nccs/doc/sgmltools/guide.html.gz, taken from the SGML-Tools distribution.
link to the SGML-Tools User's Guide, html revision 1.3 of 1997/11/10 at http://www.sgmltools.org/guide/guide.html
SGML-Tools User's Guide, plain text revision 1.3 of 1997/11/10, in ../nccs/doc/sgmltools/guide.txt. This version is best printed on a dot-matrix printer, being apparently formatted as a MAN page.
sgmltools/example.sgml for an SGML example. It is not viewable
link to the SGML-Tools home page at http://www.sgmltools.org
link to the SGML/XML home page at http://www.oasis-open.org/cover/sgml-xml.html
link to Debian/GNU Linux and SGML at http://www.debian.org/News/1999/19990330
TK/Tcl (or Tcl/TK) is one choice for the graphical user interface (GUI) to the NCCS. It is used for the GBT GUI.
/usr/lib/tk8.0/demos/ contains examples such as "widget".