README.txt

   1
   2 README file for CADS/UVS Stellar Spectrum Calculator
   3 ----------------------------------------------------
   4
   5 1. BUILD/INSTALL
   6 ----------------
   7
   8   Follow these 4 steps:
   9
  10   1. `cd' to the directory containing the package's source code and type
  11      `./configure' to configure the package for your system.
  12
  13      Running `configure' takes a few seconds.  While running, it prints some
  14      messages telling which features it is checking for.
  15
  16   2. Type `make' to compile the package.
  17
  18   3. Type `make install' to install the programs and any data files and
  19      documentation. By default, the binary is copied to /usr/local/bin.
  20      You may change this destination by passing on the following
  21      argument to configure:
  22
  23              --prefix=/your/chosen/destination
  24
  25      Which would result in the binary in /your/chosen/destination/bin
  26      You may need to ensure that in $PATH to run the program.
  27
  28   4. You can remove the program binaries and object files from the
  29      source code directory by typing `make clean'.
  30
  31 You may read more about configure script and others in the accompanying
  32 file named `INSTALL'.
  33
  34
  35 2. USAGE
  36 --------
  37 All input parameters are read from an input parameter file named
  38 stellarspec_initparams.txt. The general usage pattern is:
  39
  40   uvs_stellar_spectrum [options]
  41
  42   Options are:
  43     -h help
  44     -g Generates a well documented default parameter file
  45
  46 Once you have the default parameter file, you can edit it as per your needs
  47 and run the program without any arguments to generate the stellar spectrum.
  48
  49 NOTE: This program requires the kurucz model datafiles to simulate stellar
  50 spectrum. If you have installed it right, these files would be installed in
  51 <prefix>/share/cads/data/ and the default parameter file is aware of the
  52 location. These datafiles are also available in the subdirectory named
  53 "spectral_data" inside the source distribution as well.
  54
  55
  56 3. DOCUMENTATION
  57 ----------------
  58 Documentation and test cases are available at
  59 http://cads.iiap.res.in/software
  60
  61
  62 4. LICENSE
  63 ----------
  64 GPL [See the file COPYING.txt for details]
  65
  66
  67 5. DISCLAIMER
  68 -------------
  69 You may encounter bugs in this software. If you do, please
  70 report them. Your bug reports are valuable contributions,
  71 since they allow us to notice and fix problems on machines
  72 we don't have and/or remained un-noticed.
  73
  74
  75 6. REPORTING BUGS
  76 -----------------
  77 You can register with the cads bug reporting tool:
  78 http://cads.iiap.res.in/bugzilla/
  79 and file a bug report.
  80
  81 If you are too lazy, drop in an email to: cads_AT_iiap.res.in
  82
  83 Either way, please include as many details as possible.
  84
  85 -----------------------------------------------------------
  86 Reks, 01 July 2012. <reks_at_iiap.res.in>
  87