Документ взят из кэша поисковой машины. Адрес оригинального документа : http://www.stsci.edu/ftp/software/ASpec/documents/help/aspec_install.asc Дата изменения: Thu Dec 12 21:27:29 1996 Дата индексирования: Sun Dec 23 18:22:00 2007 Кодировка: Поисковые слова: ngc 6559

Installation Guide

Installation of ASpec 1.0 (Beta) is straightforward. It is done
within the IRAF 2.10.3 (or higher) environment. This chapter is intended
as a cookbook to help you do a ASpec installation.

------------------------
The Installation Process
------------------------

To install ASpec, you must:

"Obtain the ASpec distribution"

"Create the top-level directory for ASpec"

"Modify your IRAF environment"

"Install the ASpec source code from the tar files"

"Build ASpec"

"Modify the help database"

"Test the ASpec installation"

-----------------------------
Obtain the ASpec distribution
-----------------------------

Just point your web browser to http://www.stsci.edu/software/ASpec and
follow the links to the tar files. We provide the tar files in compressed
(gzip) and uncompressed formats--choose the one that's right for you. Put
the tar file somewhere. (In the rest of this installation guide we assume the
tar file can be found in WHEREVER_THE_TAR_FILE_LIVES/
aspec.tar-we don't care, of course, what the actual name of the directory
is, as long as you know what it is). Uncompress the file if you downloaded
the gzipped version:

% gunzip aspec.tar.gz

----------------------------------------
Create the top-level directory for ASpec
----------------------------------------

Make a new directory to hold the ASpec code. IRAF suggests placing
external packages under the PATH/iraf/extern directory: in this case you
would make a directory called PATH/iraf/extern/aspec. It's not important
where this lives as long as there exists a directory call SOMEPATH/aspec
(where SOMEPATH is specific to you environment).

----------------------------
Modify your IRAF environment
----------------------------

Leave the following modifications up to you local IRAF system adminis-
trator or whoever has the necessary access to these files.

% cl

cl> cd hlib$

cl> edit extern.pkg

Add the following lines to the extern.pkg file:

reset aspec = SOMEPATH/aspec/

task aspec.pkg = aspec$aspec.cl

Add these at the end of your external package definitions.

Also add the following to the definition of the help search path:

aspec$lib/helpdb.mip

Check out this example extern.pkg file:

# External (non core-system) packages. To install a new
# package, add the two statements to define the package
# root directory and package task,
# then add the package helpdb to the `helpdb' list.

reset noao = iraf$noao/
task noao.pkg = noao$noao.cl

reset local = iraf$local/
#reset local = /u2/kpnolocal/

task local.pkg = local$src/local.cl

reset stsdas = /usr/stsci/stsdas/
task stsdas.pkg = stsdas$stsdas.cl

reset tables = /usr/stsci/tables/
task tables.pkg = tables$tables.cl

reset aspec = /usr/stsci/aspec/
task aspec.pkg = aspec$aspec.cl

reset crrefer = /data/cdbs1/

reset helpdb = "lib$helpdb.mip\
,noao$lib/helpdb.mip\
,local$lib/helpdb.mip\
,stsdas$lib/helpdb.mip\
,tables$lib/helpdb.mip\
,aspec$lib/helpdb.mip\
"
keep

------------------------------------------------
Install the ASpec source code from the tar files
------------------------------------------------

Assuming you have the tar file and have uncompressed it (with gunzip)
change directory to your newly defined ASpec top directory and untar the
file. Since you are in IRAF you can use the rtar task in the softools pack-
age. Just type:

cl> softools

cl> cd $aspec

cl> rtar -xtvf WHEREVER_THE_TAR_FILE_LIVES/aspec.tar

[Note: If you wish, you can untar outside of IRAF:

% cd SOMEPATH/aspec

% tar xvf WHEREVER_THE_TAR_FILE_LIVES/aspec.tar

]

------------
Build ASpec
------------

Fist make sure that your bin directory for ASpec points to the correct sys-
tem architecture bin directory:

cl> cd $aspec

cl> mkpkg arch

"arch" just reflects you system architecture. For example, arch = ssun for
Sun machines running Solaris. This really depends on your IRAF installa-
tion but if you get stuck just check where the bin directory under IRAF
points. For example, on this same Sun/Solaris configuration you would find
bin being soft linked to bin.ssun.

Now for the building:

LOG OUT OF IRAF AND THEN RESTART IRAF!

cl> log

% cl

cl> aspec

cl> cd $aspec

cl> mkpkg -p aspec -p tables >& spool &

When this job is finished extract a summary of the installation from the
spool file:

cl> mkpkg summary > summary.aspec

Read the summary.aspec file to review the installation.

------------------------
Modify the help database
------------------------

cl> softools

cl> mkhelpdb helpdir=aspec$lib/root.hd \

>>> helpdb=aspec$lib/helpdb.mip

Customize the vuespec task graphical user interface

There are a couple of things to be modified in the vuespec.gui file that
describes the graphical user interface. To configure things properly, do the
following:

cl>set clobber = yes

cl>install_gui netscape

The value for the required parameter should be the command you use (out-
side of IRAF) to launch your favorite web browser. This is used by vuespec
only to display the on-line help.

---------------------------
Test the ASpec installation
---------------------------

As a sanity check to see that the basic system is working correctly type:

cl> aspec

cl> test_aspec

The output from this task should look like the this:

#Begin testing aspec installation
Check for aspec package definition
aspec package definition ok
Check for autospec task definition
autospec task definition ok
Check for vuespec task definition
vuespec task definition ok
Execute autospec task using test data
autospec aspec$data/test0.tab aspec$data/test_db.tab
Fit domain is: 4950:5050
iterations = 375 chisq = 51.03782
autospec execution complete
ASpec basic system successfully installed.
#End testing aspec installation

If your output doesn't look like this, double check that you did everything
you were supposed to do and try again. If you get stuck send us email
describing the problem and we will assist you in getting ASpec up and run-
ning.

---------
Problems?
---------

If you have any problems installing or using ASpec, contact us via e-mail
at: aspec@stsci.edu.