Powrót do SRP - strony głównej.

1.  Przygotowanie za pierwszym razem

1. Sprawdzić czy posiadamy zainstalowane następujące pakiety linuxa"

• gcc wersja 4.3.3
• cfitsio wersja 3.13
• pgplot wersja 5.2.2
• gfortran wersja 4.4.1
• libx11-dev wersja 1.2.2
• make wersja 3.81

2. Pakiet SRP jest testowany na systemie Kubuntu 10.4. W tym systemie instalację w/w pakietów można przeprowadzić wpisując w okno terminala:

sudo apt-get install pgplot5 libcfitsio3-dev libx11-dev gcc make

3. Pobrać plik .... i rozpakować. Powinien powstać nowy katalog o nazwie zaczynającej się od "SRP" z następującymi plikami:

• biac.c, bias.h
• combine_thars.c, combine_thars.h
• contrem.c, contrem.h
• cosmic.c, cosmic.h
• flat.c, flat.h
• flat_56.fits_trace lub flat_64.fits_trace
• header.c, header.h
• iniread.c, iniread.h
• login.cl
• makefile
• makeone.c, makeone.h
• mycommon.c, mycommon.h
• newtmin.c, newtmin.h
• oned.c, oned.h
• psf.c, psf.h
• readme.txt
• red.c, red.h
• reidentify.c, reidentify.h
• start
• toiraf.c, toiraf.h
• trace.c, trace.h
• wav.c, wav.h
• wildcard.c, wildcard.h

Poza tym powinny się w nim znajdować następujące podkatalogi z plikami:

• ini
  • contrem.ini
  • flat.ini
  • id_56.txt
  • makeone.ini
  • start.ini
  • thar_list.txt
• uparm
  • oncrspect.par

4. Skompilować pakiet wpisując w konsoli (terminalu) komendę:

make

Kompilacja powinna nie generować żadnych komunikatów o błędach ani żadnych ostrzeżeń. Pojawienie się takowych oznacza zazwyczaj brak niezbędnych do działania programu bibliotek, wymienionych wyżej. Po udanej kompilacji powstanie m. in. nowy plik o nazwie "red", który jest głównym plikiem pakietu SRP.

5. Utworzyć katalog roboczy do redukcji widm i skopiować do niego pliki *.fits z widmami jednego obiektu, wraz z odpowiadającymi im ramkami korekcyjnymi typu offset (bias), płaskie pole (flat) oraz widmami lampy kalibracyjnej (comp).

6. Skopiować do katalogu roboczego następujące pliki i katalogi z katalogu w którym został skompilowany pakiet SRP:

• red
• start
• login.cl - opcjonalnie
• flat_56.fits_trace lub flat_64.fits_trace - opcjonalnie
• ini (katalog)
• uparm (katalog) - opcjonalnie

Pliki lub katalogi opcjonalne są niezbędne tylko w pewnych okolicznościach. Umieszczenie ich w katalogu roboczym jest zupełnie bezpieczne nawet jeśli nie planujemy ich używać. Brak tych plików oznacza konieczność utworzenia nowego pliku typu *_trace podczas wykonywania redukcji (patrz ...) oraz całkowicie samodzielnego uruchamiania IRAFa po jej zakończeniu (patrz ... ).

W przypadku pojawienia się nowej wersji pakietu SRP nie należy używać plików konfiguracyjnych (*.ini i innych) z poprzednich wersji programu.

2.  Przygotowanie za kolejnym razem

Jeśli wykonaliśmy już kiedyś udaną redukcję pakietem SRP to przygotowanie kolejnej redukcji jest prostsze i składa się z następujących kroków:

1. Utworzyć katalog roboczy do redukcji widm i skopiować do niego pliki *.fits z widmami jednego obiektu, wraz z odpowiadającymi im ramkami korekcyjnymi typu offset (bias), płaskie pole (flat) oraz widmami lampy kalibracyjnej (comp).

2. Skopiować do katalogu roboczego następujące pliki i katalogi z poprzedniego katalogu z ukończoną redukcją:

• red
• start
• login.cl - opcjonalnie
• flat_56.fits_trace lub flat_64.fits_trace - opcjonalnie
• ini (katalog)
• uparm (katalog) - opcjonalnie

Pliki lub katalogi opcjonalne są niezbędne tylko w pewnych okolicznościach. Umieszczenie ich w katalogu roboczym jest zupełnie bezpieczne nawet jeśli nie planujemy ich używać. Brak tych plików oznacza konieczność utworzenia nowego pliku typu *_trace podczas wykonywania redukcji (patrz ...) oraz całkowicie samodzielnego uruchamiania IRAFa po jej zakończeniu (patrz ... ).

W przypadku pojawienia się nowej wersji pakietu SRP nie należy używać plików konfiguracyjnych (*.ini i innych) z poprzednich wersji programu.

3.  Przed uruchomieniem programu

1. Przed każdą redukcją należy przejrzeć i w razie potrzeby zmodyfikować plik start.ini (w katalogu ini). W przypadku wykonywania redukcji widm wykonanych spektroskopem PST większość opcji jest już ustawiona optymalnie, jednak nadal niektóre trzeba koniecznie przejrzeć i ewentualnie zmodyfikować:

• obj_name = muEri*.fits - należy podać właściwą maskę nazw plików z widmami obiektów do redukcji;
• iraf_name = muEri - należy podać wybraną przez użytkownika nazwę plików wynikowych;
• observer = KK - należy podać symbol, inicjały lub inny identyfikator obserwatora;
• ra = 2.3975 - rektascencja w godzinach z ułamkiem;
• dec = 55.3647 - deklinacja w stopniach z ułamkiem;

2. Dalej w pliku start.ini należy wybrać które procedury redukcyjne mają być wykonane (0-nie robić, 1-wykonać):

• fits_header = 1
• bias = 1
• master_bias = 1
• debias = 1
• cosmic = 1
• trace_selected = 0
• psf = 1
• oned = 1
• master_flat = 1
• flatcor = 1
• reidentify = 1
• wav = 1
• contrem = 1
• makeone = 1
• toiraf = 1

3. Następnie należy przejrzeć opcje poszczególnych procedur i zmodyfikować w razie potrzeby, w szczególności:

• *_inter = yes - czy dana procedura ma być wykonana interaktywnie (yes) czy automatycznie (no)
• trace_name = auto - nazwa pliku dla którego wykonywany jest trace (jeśli w ogóle ma być wykonywany)
• flat_mode = 0 - czy master flat jest normalizowany do 1.0 przed użyciem (0) czy nie (1)
• flat_lambda = yes - czy tworzyć master flata i go używać w skali długości fali (yes) czy w skali pozycji piksela (no)
• wav_system = 2 - metoda wyznaczania długości fali na podstawie widm kalibracyjnych (od 1 do 5)

Pełna lista wszystkich opcji dostępnych w pliku start.ini z opisami jest zamieszczona tutaj ... lub w opisach poszczególnych procedur.

4.  W trakcie pracy programu

Część procedur przeprowadzanych jest całkowicie automatycznie i nie wymagana a nawet uniemożliwia interakcję w trakcie działania programu. Są to:

• combine_thars
• fits_header
• master_bias
• debias
• cosmic_flat
• cosmic_obj
• psf*

Procedury zaznaczone gwiazdką potrafią wyświetlać na ekranie obrazki kontrolne, które można jedynie zaakceptować lub przerwać działanie programu. Jedyną możliwością zmiany działania tych procedur jest zmiana parametrów w pliku start.ini lub z linii komend.

Pozostałe procedury posiadają pewne elementy interakcji, które umożliwiają modyfikację ich działania za pomocą klawiatury i niekiedy również myszki. Każda z tych procedur może wykonywać swoją pracę całkowicie automatycznie, jeśli parametr sterujący, którego nazwa zakończona jest wyrażeniem _inter jest ustawiony na no.

5.  Po zakończeniu pracy programu

Po przeprowadzeniu pełnej redukcji za pomocą pakietu SRP w katalogu roboczym powinny powstać:

• katalog ps z obrazkami kontrolnymi w plikach *.ps (poprzedni katalog ps jest zawsze nadpisywany)
• dwa pliki z logami: log_big.txt, log_short.txt (poprzednie pliki są nadpisywane)
• pliki typu *.fits z wynikami pośrednimi, danymi kontrolnymi oraz wynikami ostatecznymi redukcji (poprzednie pliki są nadpisywane)
• pliki typu *.txt z wynikami ostatecznymi redukcji w postaci tekstowej, gotowej do importu do IRAFa (poprzednie pliki są nadpisywane)