Ing. David Motl
C-Munipack 1.1 Uživatelský manuál
c 2011 Ing. David Motl Copyright Verze 1.9, 6. února 2011 Je povoleno kopírovat, šíˇrit a/nebo upravovat tento dokument za podmínek GNU Free Documentation License, verze 1.2 vydané nadací Free Software Foundation; bez nemˇenných oddíl˚u, bez text˚u pˇredních desek a bez text˚u zadních desek. Plné originální znˇení licence je uvedeno v pˇríloze.
Úvod Na zaˇcátku 21. století nastal v astronomické fotometrii pomˇernˇe zásadní zlom. Na úkor vizuálního a fotoelektrického pozorování se zaˇcalo cˇ ím dál tím více prosazovat používání CCD kamer. Jejich ceny za posledních nˇekolik let klesly natolik, že si je mohou dovolit poˇrídit i amatérští pozorovatelé. Souˇcasnˇe vznikla poptávka po softwarovém nástroji na zpracování pozorování poˇrízených CCD kamerami, který by byl pro amatérského astronoma dostupný, jednoduchý na ovládání, ale zároveˇn obsahující kvalitní algoritmy. V dubnu 2003 vznikl projekt C-Munipack, jehož cílem je nabídnout astronom˚um silný ale zároveˇn uživatelsky jednoduchý nástroj pro zpracování jejich CCD pozorování. V dobˇe, kdy projekt zaˇcal, existovaly dva obdobné programy: MuniDOS, který pracuje v textovém režimu, cˇ ímž jsou dány omezené možnosti uživatelského rozhraní. Program navíc podle autor˚u neobsahuje moderní algoritmy a neuvažuje se o jeho dalším vývoji. Druhým dostupným software je Munipack, který je napsán z cˇ ásti ve Fortranu a z cˇ ásti v jazyce C. Tento program je sice moderní a udržovaný, ale má zase tu nevýhodu, že uživatelé operaˇcního systému Windows budou mít velké problémy s jeho pˇrekladem, a grafické rozhraní, které projekt nabízí, je možné použít pouze na unixových systémech. Na trhu jsou k dispozici samozˇrejmˇe i nˇekteré velmi dobré komerˇcní produkty, ale ty si amatérský astronom, který vše platí ze své kapsy, nem˚uže dovolit. Pˇri návrhu projektu jsem se snažil spojit výhody výše popsaných stávajících program˚u a zároveˇn co nejlépe využít možnosti, které operaˇcní systém nabízí. Vycházel jsem pˇritom ze své nˇekolikaleté praxe pˇri práci se CCD kamerou SBIG ST-7 na hvˇezdárnˇe ve Vyškovˇe, kde se vˇenuji pozorování promˇenných hvˇezd. Tato knížka je uživatelským návodem k celému projektu C-Munipack. V její první cˇ ásti je popsáno ovládání grafického uživatelského rozhraní, programu Muniwin. Druhá cˇ ást je vˇenována program˚um spouštˇeným z pˇríkazové ˇrádky. V této doplnˇené verzi byl do návodu zaˇrazen také jednoduchý základní postup pˇri zpracování pozorování promˇenné hvˇezdy. Na internetových stránkách projektu si m˚užete stáhnout nˇekolik ukázkových snímk˚u a uvedený postup si vyzkoušet v praxi. Nˇekdy v budoucnu by také mˇela vzniknout podrobnˇejší dokumentace všech cˇ ástí systému a použitých algoritm˚u. Rád bych na tomto místˇe podˇekoval všem koleg˚um, kteˇrí pˇrispˇeli svými nápady, radami a pˇripomínkami k vytvoˇrení tohoto programu. Jmenovitˇe Filipu Hrochovi za poskytnutí zdrojového kódu Munipacku a pomoc pˇri jeho pˇrevodu z Fortranu do jazyka C, Lukáši Královi za poskytnutí zdrojového kódu programu Varfind a dále Miloslavu Zejdovi, Ondˇreji Pejchovi, Jitce Kudrnáˇcové, Petru Lut’chovi a Petru Svobodovi za pomoc pˇri testování programu, jazykové korektury anglické verze manuálu a nápovˇedy a za cenné pˇripomínky k uživatelskému rozhraní. Brno, kvˇeten 2006
Autor
Obsah 1
Základní informace
4
2
Program Muniwin
5
2.1
Základní postup pˇri zpracování pozorování . . . . . . . . . . . . . . . . . . . . . . .
5
2.2
Hlavní okno aplikace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
10
2.2.1
Tabulka vstupních soubor˚u . . . . . . . . . . . . . . . . . . . . . . . . . . .
10
2.2.2
Náhledové okno . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
12
Nabídka Files (Soubory) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
15
2.3.1
Clear files (Vymazat soubory) . . . . . . . . . . . . . . . . . . . . . . . . .
15
2.3.2
Add files (Pˇridat soubory) . . . . . . . . . . . . . . . . . . . . . . . . . . .
15
2.3.3
Remove files (Odstranˇení soubor˚u) . . . . . . . . . . . . . . . . . . . . . . .
16
2.3.4
Fetch/Convert files (Pˇrevod soubor˚u) . . . . . . . . . . . . . . . . . . . . . .
16
2.3.5
Open file (Otevˇrít soubor) . . . . . . . . . . . . . . . . . . . . . . . . . . .
17
2.3.6
Exit (Konec) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
17
Nabídka Corrections (Korekce) . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
17
2.4.1
ˇ Time correction (Casová korekce) . . . . . . . . . . . . . . . . . . . . . . .
17
2.4.2
Dark correction (Korekce temným snímkem) . . . . . . . . . . . . . . . . .
17
2.4.3
Flat correction (Korekce svˇetlým snímkem) . . . . . . . . . . . . . . . . . .
18
Nabídka Photometry (Fotometrie) . . . . . . . . . . . . . . . . . . . . . . . . . . .
19
2.5.1
Photometry (Fotometrie) . . . . . . . . . . . . . . . . . . . . . . . . . . . .
19
Nabídka Matching (Skládání) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
20
2.6.1
Match stars (Skládání hvˇezd) . . . . . . . . . . . . . . . . . . . . . . . . . .
20
Nabídka Plotting (Kreslení) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
21
2.7.1
Choose stars (Výbˇer hvˇezd) . . . . . . . . . . . . . . . . . . . . . . . . . .
21
2.7.2
Enter object’s coordinates (Zadání souˇradnic objektu) . . . . . . . . . . . . .
22
2.7.3
Plot curve (Zobrazení svˇetelné kˇrivky) . . . . . . . . . . . . . . . . . . . . .
23
2.7.4
View chart (Zobrazení mapky) . . . . . . . . . . . . . . . . . . . . . . . . .
24
Nabídka Tools (Nástroje) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
24
2.8.1
Master-dark (Skládání temných korekˇcních snímk˚u) . . . . . . . . . . . . . .
24
2.8.2
Master-flat (Skládání svˇetlých korekˇcních snímk˚u) . . . . . . . . . . . . . .
25
2.8.3
Find variables (Hledání promˇenných hvˇezd) . . . . . . . . . . . . . . . . . .
25
2.8.4
Plot track list (Zobrazení grafu posun˚u) . . . . . . . . . . . . . . . . . . . .
26
2.8.5
Process new files (Zpracování nových soubor˚u) . . . . . . . . . . . . . . . .
27
2.8.6
Express reduction (Expresní zpracování) . . . . . . . . . . . . . . . . . . . .
27
2.8.7
Make catalogue file (Vytvoˇrení katalogového souboru) . . . . . . . . . . . .
28
2.3
2.4
2.5
2.6
2.7
2.8
2.8.8
Preferences (Nastavení) . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
28
Nabídka Windows (Okna) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
31
2.9.1
Show message log (Zobrazit poslední výpis zpráv) . . . . . . . . . . . . . .
31
2.9.2
Show results (Zobrazit výstupní soubory) . . . . . . . . . . . . . . . . . . .
31
2.9.3
Show catalogue files (Zobrazit katalogové soubory) . . . . . . . . . . . . . .
32
2.10 Nabídka Help (Nápovˇeda) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
32
2.10.1 Open help (Otevˇrít nápovˇedu) . . . . . . . . . . . . . . . . . . . . . . . . .
32
2.10.2 About Muniwin (O programu Muniwin) . . . . . . . . . . . . . . . . . . . .
32
2.9
3
Programy spouštˇené z pˇríkazové rˇ ádky
33
3.1
Základní parametry, pravidla a použité formáty . . . . . . . . . . . . . . . . . . . .
33
3.2
Programy pro redukci snímk˚u . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
33
3.2.1
Konve (konverze snímk˚u) . . . . . . . . . . . . . . . . . . . . . . . . . . .
33
3.2.2
Timebat (ˇcasová korekce) . . . . . . . . . . . . . . . . . . . . . . . . . . .
34
3.2.3
Darkbat (korekce temným snímkem) . . . . . . . . . . . . . . . . . . . . . .
35
3.2.4
Flatbat (korekce svˇetlým snímkem) . . . . . . . . . . . . . . . . . . . . . .
35
3.2.5
Muniphot (fotometrie) . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
36
3.2.6
Munimatch (skládání fotometrických soubor˚u) . . . . . . . . . . . . . . . .
37
3.2.7
Munilist (generování svˇetelné kˇrivky) . . . . . . . . . . . . . . . . . . . . .
37
Ostatní programy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
38
3.3.1
Autoflat (skládání svˇetlých snímk˚u) . . . . . . . . . . . . . . . . . . . . . .
38
3.3.2
Meandark (skládání temných snímk˚u) . . . . . . . . . . . . . . . . . . . . .
39
3.3.3
Helkor (heliocentrická korekce) . . . . . . . . . . . . . . . . . . . . . . . .
40
3.3.4
Munifind (hledání promˇenných hvˇezd) . . . . . . . . . . . . . . . . . . . . .
41
3.3.5
Airmass (Výpoˇcet koeficientu vzdušné hmoty) . . . . . . . . . . . . . . . .
42
3.3
4
Knihovna C-Munipack
45
4.1
Funkce pro obecné použití . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
45
4.1.1
Funkce pro pˇrevod souˇradnic . . . . . . . . . . . . . . . . . . . . . . . . . .
45
4.1.2
Funkce pro pˇrevod data a cˇ asu . . . . . . . . . . . . . . . . . . . . . . . . .
47
4.1.3
Matematické funkce . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
48
4.1.4
Astronomické funkce . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
48
Funkce pro redukci snímk˚u . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
49
4.2.1
Konverze snímk˚u do pracovního formátu . . . . . . . . . . . . . . . . . . .
49
4.2.2
ˇ Casová korekce . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
51
4.2.3
Korekce temným snímkem . . . . . . . . . . . . . . . . . . . . . . . . . . .
51
4.2.4
Korekce svˇetlým snímkem . . . . . . . . . . . . . . . . . . . . . . . . . . .
51
4.2.5
Fotometrie snímk˚u . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
52
4.2
3
4.3
4.4
5
4.2.6
Skládání fotometrických soubor˚u . . . . . . . . . . . . . . . . . . . . . . .
52
4.2.7
Generování výstupního souboru . . . . . . . . . . . . . . . . . . . . . . . .
53
Ostatní funkce . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
54
4.3.1
Skládání temných snímk˚u . . . . . . . . . . . . . . . . . . . . . . . . . . .
54
4.3.2
Skládání svˇetlých snímk˚u . . . . . . . . . . . . . . . . . . . . . . . . . . .
54
4.3.3
Hledání promˇenných hvˇezd . . . . . . . . . . . . . . . . . . . . . . . . . .
54
Použité datové typy a konstanty . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
56
4.4.1
Konstanty chybových kód˚u . . . . . . . . . . . . . . . . . . . . . . . . . . .
56
4.4.2
Konstanty formát˚u vstupních soubor˚u . . . . . . . . . . . . . . . . . . . . .
57
4.4.3
Režimy konverze . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
57
4.4.4
Konstanty formát˚u výstupních soubor˚u . . . . . . . . . . . . . . . . . . . .
57
Soubory
58
5.1
Vstupní soubory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
58
5.2
Výstupní soubory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
58
5.2.1
Svˇetelná kˇrivka . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
58
5.2.2
Tabulka posun˚u (Track-list) . . . . . . . . . . . . . . . . . . . . . . . . . . .
59
5.2.3
Výstup programu Munifind . . . . . . . . . . . . . . . . . . . . . . . . . . .
59
5.3
Fotometrické soubory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
60
5.4
Katalogové soubory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
61
5.5
Konfiguraˇcní soubory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
62
5.5.1
Pr˚umˇery clonek (Apertures.ini) . . . . . . . . . . . . . . . . . . . . . . . .
62
5.5.2
Parametry pro skládání svˇetlých snímk˚u (Autoflat.ini) . . . . . . . . . . . . .
63
5.5.3
Parametry pro hledání promˇenných (Munifind.ini) . . . . . . . . . . . . . .
63
5.5.4
Parametry výstupních soubor˚u (Munilist.ini) . . . . . . . . . . . . . . . . .
63
5.5.5
Parametry funkce skládání (Munimatch.ini) . . . . . . . . . . . . . . . . . .
63
5.5.6
Nastavení fotomterie (Muniphot.ini) . . . . . . . . . . . . . . . . . . . . . .
63
Slovník chybových hlášení
64
Použité zdroje
70
1
Základní informace
C-Munipack je soubor program˚u, které tvoˇrí ucelený systém pro redukci snímk˚u poˇrízených CCD kamerou se zamˇeˇrením na fotometrii promˇenných hvˇezd. Jednotlivé programy lze volat z pˇríkazové ˇrádky nebo prostˇrednictvím grafického uživatelského rozhraní. Pro vývojáˇre je k dispozici také dynamicky linkovaná knihovna. Projekt C-Munipack vychází z balíku Munipack, jednotlivé programy mají stejné názvy, ale na rozdíl od nˇej je implementován v jazyce C a obsahuje také nˇekolik funkcí a nástroj˚u navíc. Ve vˇetšinˇe pˇrípad˚u je také dodržena syntaxe parametr˚u pˇredávaných na pˇríkazové ˇrádce a formát konfiguraˇcních soubor˚u. Grafické uživatelské rozhraní, program Muniwin, vychází z koncepce programu Munidos, ale plnˇe využívá výhod grafického prostˇredí, takže nabízí uživateli vˇetší komfort a lepší kontrolu nad procesem zpracování snímk˚u než p˚uvodní textové rozhraní. Internetové stránky projektu Nejnovˇejší verzi programu a dokumentaci k programu lze stáhnout z internetových stránek projektu, které jsou umístˇeny na adrese:
http://c-munipack.sourceforge.net/ Autoˇri Vedoucím projektu a autorem velké cˇ ásti zdrojových kód˚u je David Motl. Nˇekolik cˇ ástí zdrojových kód˚u byly pˇrevzaty z originálního Munipacku, jejichž autorem je Filip Hroch. Použité algoritmy pro redukci snímk˚u vychází z algoritm˚u použitých v projektu Munipack. Algoritmus použitý v programu Munifind vychází z programu Varfind, jehož autorem je Lukáš Král. V projektu byla použita knihovna FITSIO (Dr. William Pence, NASA), knihovna EXPAT jejíž autorem je James Clark a knihovna FreeImage, kterou udržuje Hervé Drolon. Odkazy na všechny použité zdroje jsou uvedeny v kapitole Použité zdroje na konci tohoto návodu. Licence k software Tento program je distribuován BEZ JAKÉKOLIV ZÁRUKY. M˚užete si jej stáhnout, používat a dále šíˇrit za podmínek Obecné veˇrejné licence GNU verze 2. Originální znˇení licence GNU GPL verze 2 je k dispozici na výše uvedených webových stránkách projektu a také na adrese http://www.gnu.org/licenses/gpl.html. Licence k dokumentaci Je povoleno kopírovat, šíˇrit a/nebo upravovat tento dokument za podmínek GNU Free Documentation License, verze 1.2 vydané nadací Free Software Foundation; bez nemˇenných oddíl˚u, bez text˚u pˇredních desek a bez text˚u zadních desek. Plné znˇení licence v cˇ eském jazyce nebylo v dobˇe pˇrípravy textu k dispozici, plné znˇení licence v angliˇctinˇe je dostupné na Internetu.
2
Program Muniwin
Program Muniwin je grafické uživatelské rozhraní, které umožˇnuje uživateli provést redukci CCD snímk˚u (zpracování CCD pozorování) od konverze vstupních snímk˚u do pracovního formátu až po sestavení svˇetelné kˇrivky vybrané hvˇezdy aniž by musel znát syntaxi jednotlivých pˇríkaz˚u.
2.1
Základní postup pˇri zpracování pozorování
Následující postup je základním pracovním postupem pˇri zpracování pozorování krátkoperiodické promˇenné hvˇezdy pomocí programu Muniwin. Z internetových stránek projektu si m˚užete stáhnout balíˇcek s demonstraˇcními daty, na kterých si m˚užete uvedeny postup vyzkoušet. Stažený archív nejprve rozbalte do libovolného prázdného adresáˇre na disk. 1. Spust’te program Muniwin – otevˇrete nabídku Start, složku Programy, a ve složce Muniwin kliknˇete na ikonu Muniwin.
2. Z nabídky Files vyberte volbu Clear files. Program se zeptá na potvrzení, stisknˇete tlaˇcítko Yes. Tabulka soubor˚u v hlavním oknˇe programu by mˇela být nyní prázdná. 3. Z nabídky Files vyberte volbu Add files. Pomocí tohoto dialogu se vkládají snímky do tabulky vstupních soubor˚u. V levém oknˇe vyhledejte adresáˇr, ve kterém máte pˇripraveny snímky (v demonstraˇcních datech jsou snímky uloženy v podadresáˇri data). Chcete-li do projektu vložit všechny snímky z adresáˇre, stisknˇete tlaˇcítko All. V opaˇcném pˇrípadˇe oznaˇcte soubory v tabulce myší. M˚užete také použít dialog pro výbˇer soubor˚u na základˇe vlastností, který se spouští tlaˇcítkem Select.
6
2. PROGRAM MUNIWIN
4. Stisknˇete tlaˇcítko Add. Chcete-li najednou zpracovat data z více adresáˇru˚ , vložte stejným zp˚usobem do projektu další soubory. Až budete mít v tabulce zaˇrazené všechny soubory, které chcete zpracovat, zavˇrete dialog tlaˇcítkem Close.
5. Nyní proved’te konverzi vstupních soubor˚u do formátu FITS a uložení snímk˚u do adresáˇre pro doˇcasné soubory. Tento krok je nutné provést i tehdy, když zdrojové soubory jsou již uloženy ve formátu FITS (program provede pouze zkopírování soubor˚u do doˇcasného adresáˇre). Z nabídky Files vyberte volbu Fetch/convert files a v dialogu stisknˇete tlaˇcítko OK.
6. Bˇehem pˇrevodu se otevˇre nové okno, ve kterém se zobrazuje stav procesu a vypisují se do nˇej také veškeré informace. Toto okno se po dokonˇcení procesu automaticky zavˇre. Poˇckejte, než se pˇrevod soubor˚u dokonˇcí. Po dokonˇcení se v tabulce soubor˚u u všech ˇrádk˚u zmˇení ikona a název souboru a doplní se údaje o okamžiku pozorování, délce expozice a použitém filtru. V pˇrípadˇe, že se nˇekterý ze soubor˚u nepovedlo pˇrevést, soubor bude oznaˇcen speciální ikonou a do sloupce Results se uloží chybové hlášení.
ˇ ZPRACOVÁNÍ POZOROVÁNÍ 2.1. ZÁKLADNÍ POSTUP PRI
7
7. V dalším kroku proved’te všechny potˇrebné korekce snímk˚u. U demonstraˇcních dat je potˇreba provést pouze korekci svˇetlým snímkem, protože ostatní korekce již byly provedeny automaticky bˇehem pozorování. Z nabídky Corrections vyberte volbu Flat field. Vyhledejte a oznaˇcte soubor, který obsahuje svˇetlý korekˇcní snímek (v demonstraˇcních datech použijte soubor flat20v.st7 z podadresáˇre flat) a dialog zavˇrete tlaˇcítkem OK.
8. Po provedení potˇrebných korekcí následuje fotometrie snímk˚u, tj. vyhledání hvˇezd a urˇcení jejich jasností. Z nabídky Photometry vyberte volbu Photometry a v dialogu stisknˇete tlaˇcítko OK. Po dokonˇcení zpracování snímk˚u se do tabulky soubor˚u doplní poˇcet nalezených hvˇezd na každém snímku.
8
2. PROGRAM MUNIWIN
9. Nyní se provede složení fotometrických soubor˚u vytvoˇrených v pˇredchozím kroku, to znamená nalezení odpovídajících hvˇezd na snímcích v˚ucˇ i jednomu vybranému snímku. Z nabídky Matching vyberte volbu Match stars. V dialogovém oknˇe kliknˇete na volbu Reference frame a oznaˇcte snímek, který chcete použít jako referenˇcní a potvrd’te tlaˇcítkem OK. U demonstraˇcních dat použijte snímek tmp00006.srt. Nejlepší referenˇcní snímek bývá obvykle ten, který má ze série nejvíce hvˇezd a v náhledu zobrazeném v pravém dolním rohu dialogu není nijak viditelnˇe poškozen.
10. Posledním krokem redukce je sestavení svˇetelné kˇrivky hvˇezdy – v nabídce Plotting kliknˇete na položku Choose stars. V dialogovém oknˇe se zobrazí referenˇcní snímek, kˇrížkem je vyznaˇcena hvˇezda nejblíže ke kurzoru myši. Na snímku kliknˇete myší postupnˇe na mˇeˇrenou (promˇennou) hvˇezdu, srovnávací hvˇezdu a m˚užete také zadat nˇekolik kontrolních hvˇezd. U demonstraˇcních snímk˚u použijte hvˇezdy podle následujícího obrázku:
9
ˇ ZPRACOVÁNÍ POZOROVÁNÍ 2.1. ZÁKLADNÍ POSTUP PRI
11. Výbˇer hvˇezd potvrd’te tlaˇcítkem OK. Program vypoˇcte jasnosti vybraných hvˇezd a zobrazí svˇetelnou kˇrivku – graf relativní jasnosti promˇenné hvˇezdy v˚ucˇ i srovnávací hvˇezdˇe v závislosti na cˇ ase vyjádˇreném pomocí zkráceného juliánského data (JD-2400000.0).
12. Stisknˇete tlaˇcítko Save data. Vyhledejte adresáˇr, do kterého chcete výsledný datový soubor uložit a zadejte jméno cílového souboru. Dialog zavˇrete tlaˇcítkem Close. Výstupní soubor obsahuje na prvních dvou ˇrádcích záhlaví, pak následuje tabulka s daty. Každému snímku odpovídá jeden ˇrádek tabulky, v prvním sloupci je uvedeno plné juliánské datum, druhý sloupec obsahuje jasnost promˇenné hvˇezdy v˚ucˇ i srovnávací a tˇretí sloupec chybu jasnosti. V dalších sloupcích jsou uvedeny jasnosti a chyby srovnávací a kontrolních hvˇezd (podrobnˇejší popis formátu je uveden u popisu programu Munilist). JD V-C s1 V-C1 s2 V-C2 s3 C-C1 s4 C-C2 s5 C1-C2 s6 Aperture: 1, Filter: Clear, JD: geocentric 2452909.31733 -0.528 0.007 -1.822 0.014 -2.024 0.016 2452909.35161 -0.465 0.007 -1.721 0.015 -1.977 0.016 2452909.39432 -0.371 0.007 -1.644 0.014 -1.871 0.016 2452909.43330 -0.253 0.006 -1.549 0.011 -1.758 0.012 2452909.47561 -0.084 0.007 -1.364 0.013 -1.588 0.015 2452909.52520 0.140 0.006 -1.167 0.010 -1.364 0.012 2452909.55612 0.226 0.006 -1.062 0.011 -1.292 0.012 2452909.58279 0.165 0.006 -1.136 0.011 -1.334 0.012 2452909.60958 0.034 0.006 -1.244 0.011 -1.451 0.012 2452909.63300 -0.059 0.007 -1.356 0.012 -1.566 0.014 2452909.65845 -0.167 0.011 -1.445 0.023 -1.665 0.027
-1.294 -1.256 -1.273 -1.296 -1.280 -1.307 -1.288 -1.301 -1.278 -1.297 -1.278
0.014 0.015 0.014 0.011 0.013 0.010 0.011 0.011 0.011 0.012 0.023
-1.496 -1.512 -1.500 -1.505 -1.504 -1.504 -1.518 -1.499 -1.485 -1.507 -1.498
0.016 0.017 0.016 0.012 0.015 0.012 0.012 0.012 0.012 0.014 0.027
-0.202 -0.256 -0.227 -0.209 -0.224 -0.197 -0.230 -0.198 -0.207 -0.210 -0.220
0.020 0.021 0.020 0.015 0.018 0.014 0.015 0.015 0.015 0.017 0.034
10
2. PROGRAM MUNIWIN
2.2 Hlavní okno aplikace Pˇri spuštˇení programu Muniwin se otevˇre hlavní okno aplikace, které obsahuje nabídku funkcí, ovládací panel s tlaˇcítky pro rychlý pˇrístup k cˇ asto používaným funkcím a tabulku vstupních soubor˚u. Program pr˚ubˇežnˇe ukládá sv˚uj stav do souboru, takže pˇri spuštˇení se automaticky obnoví poslední stav.
2.2.1 Tabulka vstupních souboru˚ Hlavní okno programu Muniwin obsahuje tabulku vstupních soubor˚u (Input files). Na zaˇcátku zpracování uživatel vloží do této tabulky seznam soubor˚u, se kterými se budou provádˇet veškeré operace. Soubory vložené do tabulky se mohou fyzicky nacházet v r˚uzných adresáˇrích – lze proto najednou zpracovat pozorování z nˇekolika nocí aniž by bylo nutné všechny soubory fyzicky „sesypat“ do jednoho adresáˇre. Pro každý vstupní soubor si program pamatuje ˇradu údaj˚u, které se postupnˇe bˇehem zpracování doplˇnují. Kdykoliv bˇehem zpracování lze pomocí kontextové nabídky zobrazit libovolný snímek na obrazovce nebo zkontrolovat jeho parametry, stav zpracování atd. Kontextová nabídka, která se otevírá stiskem pravého tlaˇcítka myši v prostoru okna, obsahuje nˇekolik užiteˇcných nastavení, které umožˇnují modifikovat vzhled okna. Vstupní soubory mohou být zobrazeny v jednom ze tˇrí režim˚u (položka Window style). Režim Table (tabulka)
V tomto režimu je v oknˇe programu zobrazena tabulku všech vstupních soubor˚u. Obsahuje nˇekolik sloupc˚u se základními údaji o každém snímku. V prvním sloupci tabulky je zobrazena ikona indikující stav pˇrípadnˇe chybu v posledním provedeném kroku redukce. Více informací o jednotlivých snímcích se dozvíte v dialogu Properties, který se otevírá dvojklikem na nˇekterém ˇrádku v tabulce. Pravým tlaˇcítkem myši otevˇrete kontextovou nabídku funkcí, pomocí které m˚užete zobrazit snímek nebo odpovídající fotometrický soubor apod. Stavový ˇrádek u dolního okraje okna zobrazuje plnou cestu a jméno zdrojového souboru k oznaˇcenému snímku. Je-li oznaˇceno více soubor˚u, zobrazuje se jejich poˇcet. Potˇrebujete-li zobrazit v tabulce jiné údaje než standardní (napˇr. juliánské datum, teplota apod.), otevˇrete pravým tlaˇcítkem myši kontextovou nabídku, v ní kliknˇete na položku Data shown a v dialogu zatrhnˇete sloupce, které chcete zobrazit. Potvrd’te tlaˇcítkem OK. Režim Previews (náhledy) Okno obsahuje malé náhledy na snímky zaˇrazené do tabulky vstupních soubor˚u. Pro provedení jednoho kroku redukce se automaticky náhledy obnoví, zobrazuje se vždy výstup z posledního kroku redukce. Obdobnˇe jako v ˇradˇe dalších dialog˚u lze volbami v kontextové nabídce zmˇenit vlastnosti ukázky:
2.2. HLAVNÍ OKNO APLIKACE
11
• Autocontrast – zapíná a vypíná automatický výpoˇcet jasu a kontrastu snímku. Pokud je tato funkce vypnuta, použijí se hodnoty uložené v souboru. • Invert – pˇrepíná pozitivní a negativní zobrazení snímku.
12
2. PROGRAM MUNIWIN
Režim Slideshow (prohlížeˇc) Okno obsahuje vždy jeden snímek z tabulky vstupních soubor˚u v plném rozlišení. Po provedení jednoho kroku redukce se automaticky náhled obnoví, zobrazuje se vždy výstup z posledního kroku redukce. Tlaˇcítky se šipkami na panelu v pravé cˇ ásti okna m˚užete pˇrejít na první, pˇredchozí, následující resp. poslední snímek v tabulce. Pomocí výbˇerového pole s názvem snímku (vpravo nahoˇre) lze rychle pˇrejít na kterýkoliv snímek v sérii. Obdobnˇe jako v ˇradˇe dalších dialog˚u lze volbami v kontextové nabídce zmˇenit vlastnosti ukázky: • Autocontrast – zapíná a vypíná automatický výpoˇcet jasu a kontrastu snímku. Pokud je tato funkce vypnuta, použí se hodnoty uložené v souboru. • Invert – pˇrepíná pozitivní a negativní zobrazení snímku.
2.2.2 Náhledové okno Dvojklikem myší na vybraném ˇrádku v tabulce vstupních soubor˚u se otevˇre nové dialogové okno, ve kterém je zobrazen vybraný snímek. Podle stavu zpracování snímku program automaticky urˇcí, zda se má otevˇrít originální soubor, snímek v pracovním formátu nebo fotometrický soubor. Náhledové okno lze také otevˇrít z kontextové nabídky, která se otevírá pravým tlaˇcítkem myši, položka Open. V tomto pˇrípadˇe si režim náhledu volí uživatel kliknutím na odpovídající položku v nabídce. Dialog se zavírá tlaˇcítkem Close. K dispozici je také funkce Export pro uložení snímku do souboru ve formátu JPEG, PNG, TIFF nebo BMP. Snímek lze vytisknout na pˇripojené tiskárnˇe stisknutím tlaˇcítka Print.
2.2. HLAVNÍ OKNO APLIKACE
13
Náhled na CCD snímek Informace ze souboru jsou prezentovány na tˇrech stránkách, které se pˇrepínají záložkami v levé horní cˇ ásti dialogu. Na první stránce je zobrazen CCD snímek. Druhá stránka obsahuje struˇcný pˇrehled základních informací o snímku. Kompletní výpis všech záznam˚u v hlaviˇcce souboru je k dispozici na tˇretí stranˇe ve formˇe tabulky. V dolní cˇ ásti pravého panelu je umístˇen informaˇcní panel, který také obsahuje vybrané základní údaje. Ovládacími prvky v pravé cˇ ásti okna lze nastavit zp˚usob zobrazení snímku: • Zoom – tato sekce je urˇcena pro volbu zvˇetšení, které lze nastavit bud’ výbˇerem nˇekteré z položek ve výbˇerovém poli nebo zatrhnutím položky Fit to window – zvˇetšení snímku se automaticky pˇrizp˚usobí velikosti okna. Zvˇetšení 100% znamená, že jeden obrazový bod na snímku odpovídá jednomu bodu na obrazovce. • Autocontrast – zapíná a vypíná automatický výpoˇcet jasu a kontrastu snímku. Pokud je tato funkce vypnuta, použijí se hodnoty uložené v souboru. • Invert – pˇrepíná pozitivní a negativní zobrazení snímku. • Show bad pixels – zapíná zvýrazˇnování pˇreexponovaných a špatných obrazových bod˚u na ˇ snímku. Cervenou barvou se obarví body, jejichž hodnota je rovna nastavenému maximu (obvykle 65535), je rovna nule nebo je záporná. • Pseudocolors – je-li tato volba zatržena, snímek v náhledovém oknˇe je zobrazen v nepravých barvách. Tato funkce je vhodná pro kontrolu, zda pozadí snímku po korekcích je rovnomˇerné. • Show scale – zobrazí stupnici intenzit pixel˚u a popisky v ADU v dolní cˇ ásti náhledového okna. • Show apertures – je-li tato volba zapnuta, zobrazuje se kolem vybrané hvˇezdy kružnice kreslené plnou cˇ arou znázorˇnující velikost zvolené standardní clonky. Dvˇe kružnice kreslené pˇrerušovanou cˇ arou vymezují mezikruží, které se používá pro výpoˇcet jasu pozadí (oblohy).
Dialog umožˇnuje jednoduchým zp˚usobem urˇcit základní fotometrické parametry o hvˇezdách na snímku ještˇe pˇred provedením vlastní fotometrie. Tyto údaje jsou vhodné pro kontrolu, zda hvˇezda není pˇreexponovaná a pro urˇcení pˇribližné hodnoty FWHM (Full Width at Half Maximum). Výpoˇcet se spustí kliknutím myši v prostoru snímku. Program automaticky vyhledá lokální maximum v blízkém okolí místa, kde uživatel kliknul, a provede jednoduchou fotometrii. Výsledek je vypsán v informaˇcním panelu v pravé dolní cˇ ásti okna. • Center(x), Center(y) – poloha centroidu (stˇredu hvˇezdy) v obrazových bodech vzhledem k levému hornímu okraji snímku.
14
2. PROGRAM MUNIWIN
• Max – hodnota obrazového bodu v lokálním maximu v ADU • Sky val. – stˇrední úroveˇn jasu oblohy v okolí hvˇezdy v ADU, poˇcítaná pomocí mediánu. • Std. dev. – stˇrední chyba jasu oblohy v okolí hvˇezdy v ADU. • FWHM(x), FWHM(y), FWHM – pološíˇrka profilu hvˇezdy ve vodorovném smˇeru, ve svislém smˇeru a pr˚umˇer pˇredchozích dvou hodnot v obrazových bodech. • SNR – pomˇer celkového signálu hvˇezdy v˚ucˇ i stˇrední chybˇe jasu oblohy v okolí vyjádˇrený v magnitudách (hodnota SNR = -2,5 mag. znamená, že signál hvˇezdy je 10x vetší než šum pozadí). Náhled na fotometrický soubor Informace ze souboru jsou prezentovány na dvou stránkách, které se pˇrepínají záložkami v levé horní cˇ ásti dialogu. Na první stránce je zobrazena mapka s nalezenými hvˇezdami. Velikost kotouˇcku je ˇ úmˇerná instrumentální jasnosti hvˇezdy. Cervenou barvou jsou vykresleny hvˇezdy, jejichž velikost se nepodaˇrilo urˇcit. Druhá stránka obsahuje výpis všech parametr˚u uvedených v hlaviˇcce fotometrického souboru ve formˇe tabulky.
Kliknutím na nˇekterou z hvˇezd na mapce se zobrazí podrobné informace o vybrané hvˇezdˇe v informaˇcním panelu umístˇeném v levé dolní cˇ ásti náhledového okna. Vybrané hvˇezda se zvýrazní na mapce žlutou barvou a oznaˇcí se poˇradovým cˇ íslem hvˇezdy ve fotometrickém souboru. Pomocí výbˇerového pole Aperture lze nastavit cˇ íslo clonky používané pˇri vykreslení mapky.
2.3. NABÍDKA FILES (SOUBORY)
15
2.3 Nabídka Files (Soubory) 2.3.1 Clear files (Vymazat soubory) Tato funkce vymaže všechny položky uložené v tabulce vstupních soubor˚u a vymaže obsah adresáˇre pro pˇrechodné soubory. V žádném pˇrípadˇe nemaže pˇrímo vstupní soubory. Chcete-li odstranit z tabulky pouze nˇekteré soubory, použijte funkci Remove files.
2.3.2 Add files (Pˇridat soubory) Otevírá dialog pro vkládání soubor˚u do tabulky vstupních soubor˚u. Používá se vždy na zaˇcátku procesu zpracování, nebo pˇred použitím nástroje Process new files. Standardním zp˚usobem, jak vkládat soubory do tabulky je pomocí dialogu Add files, alternativními zp˚usoby jsou funkce Drag & drop a vložení pˇres zásobník. Dialog Add files Kliknutím na položku Add files v nabídce Files otevˇrete dialogové okno. V nˇem nejprve vyhledejte adresáˇr se snímky a pak v prostˇrední cˇ ásti okna vyberte soubory, které chcete zpracovat. Tlaˇcítkem Add je zaˇrad’te do projektu. Program automaticky kontroluje, zda soubor není zaˇrazen do tabulky dvakrát. Dialog z˚ustává otevˇrený, takže pokud potˇrebujete zpracovat soubory z nˇekolika adresáˇru˚ , stejným zp˚usobem m˚užete do tabulky vložit další soubory. Dialog zavˇrete až stiknutím tlaˇcítka Close.
Pro výbˇer vˇetšího množství snímk˚u lze použít bud’to standardní postup s využitím kláves Ctrl a Shift, nebo m˚užete využít funkˇcní tlaˇcítka: • All – oznaˇcí všechny soubory • Invert – invertujete oznaˇcení soubor˚u • Select – selektivní výbˇer soubor˚u na základˇe zadaných vlastností (datum a cˇ as pozorování, použitý filtr, jméno souboru) Oznaˇcíte-li v seznamu soubor˚u jednu položku, v levé dolní cˇ ásti dialogového okna se zobrazí ukázka snímku vˇcetnˇe struˇcných informací. Dvojklikem na ukázce se otevˇre okno se snímkem v plném rozlišení. Zatržítky m˚užete zmˇenit vlastnosti ukázky: • Preview – zapíná a vypíná zobrazování ukázky. Na pomalých poˇcítaˇcích je vhodné tuto volbu vypnout.
16
2. PROGRAM MUNIWIN
• Autocontrast – zapíná a vypíná automatický výpoˇcet jasu a kontrastu snímku. Pokud je tato funkce vypnuta, použijí se hodnoty uložené v souboru. • Invert – pˇrepíná pozitivní a negativní zobrazení snímku.
Funkce Drag & drop V pr˚uzkumníku systému Windows (Tento poˇcítaˇc) pˇrejdˇete do adresáˇre, ve kterém máte umístˇeny snímky ke zpracování. Oznaˇcte snímky, které chcete zpracovat, stisknˇete a podržte levé tlaˇcítko myši. Pˇretáhnˇete soubory na ikonu programu Muniwin na systémové lištˇe. Chvíli poˇckejte až se program pˇrepne na popˇredí, myší pˇrejed’te na jeho hlavní okno a pak tlaˇcítko myši pust’te. Obdobným zp˚usobem m˚užete vložit soubory i z nˇekterých souborových manažer˚u.
Vložení pˇres zásobník V pr˚uzkumníku systému Windows (Tento poˇcítaˇc) pˇrejdˇete do adresáˇre, ve kterém máte umístˇeny snímky ke zpracování. Oznaˇcte snímky, které chcete zpracovat, stisknˇete pravé tlaˇcítko myši. V kontextové nabídce vyberte funkci Kopírovat. Pˇrepnˇete se zpˇet do programu Muniwin, v jeho hlavním oknˇe opˇet stisknˇete pravé tlaˇcítko myši a v kontextové nabídce vyberte funkci Paste from clipboard. Obdobným zp˚usobem m˚užete vložit soubory i z nˇekterých souborových manažer˚u.
2.3.3 Remove files (Odstranˇení souboru) ˚ Tato funkce odstraní z tabulky vstupních soubor˚u (v hlavním oknˇe programu) vybrané položky. Jeli okno v režimu Slideshow, odstraní se právˇe zobrazený soubor. V žádném pˇrípadˇe nemaže pˇrímo vstupní soubory. Pro vymazání všech soubor˚u použijte radˇeji funkci Clear files.
2.3.4 Fetch/Convert files (Pˇrevod souboru) ˚ Tato funkce zahajuje proces redukce CCD pozorování. Provádí se vždy po vložení zdrojových soubor˚u do tabulky. Program provede pˇrevedení vstupních soubor˚u do pracovního formátu a uloží je do adresáˇre pro pˇrechodné soubory. Další funkce a nástroje programu již pracují výhradnˇe s tˇemito pˇrechodnými soubory. Tuto funkci musíte použít na zaˇcátku zpracování i v pˇrípadˇe, že vstupní soubory jsou již uloženy ve formátu FITS. Kliknutím na položku Fetch/convert files v nabídce Files otevˇrete jednoduché dialogové okno obsahující jedinou volbu – zda se mají zpracovat všechny soubory zaˇrazené do projektu nebo jen soubory oznaˇcené v tabulce vstupních soubor˚u. Tlaˇcítkem OK dialog zavˇrete a zahájíte pˇrevod soubor˚u.
2.4. NABÍDKA CORRECTIONS (KOREKCE)
17
2.3.5 Open file (Otevˇrít soubor) Tato funkce se nepoužívá pˇrímo v procesu redukce snímk˚u. Je to pomocná funkce umožˇnující uživateli prohlédnout si obsah libovolného souboru. Ten musí obsahovat bud’ CCD snímek, fotometrický nebo katalogový soubor, pˇrípadnˇe textovou tabulku v nˇekterém z podporovaných formát˚u (viz formáty soubor˚u). Kliknutím na položku Open file v nabídce Files otevˇrete dialog Open file. V dialogu vyberte disk a vyhledejte adresáˇr. V prostˇrední cˇ ásti okna kliknˇete na soubor, který chcete otevˇrít a stisknˇete tlaˇcítko OK. Program pˇreˇcte jeho obsah, automaticky urˇcí typ souboru a formát uložených dat a otevˇre odpovídající náhledové okno. Náhled zavˇrete tlaˇcítkem Close.
2.3.6 Exit (Konec) Kliknutím na položku Exit v nabídce Files ukonˇcíte program Muniwin.
2.4 Nabídka Corrections (Korekce) ˇ 2.4.1 Time correction (Casová korekce) Tato funkce se používá pro zmˇenu data nebo cˇ asu pozorování pˇriˇctením nebo odeˇctením zadaného cˇ asového intervalu od okamžiku pozorování zapsaného v souborech. Korekci lze nˇekolikrát opakovat, pˇriˇcemž korekce se vzájemnˇe sˇcítají. Pokud tedy provedete korekci o 60 sekund a po té o 40 sekund, bude výsledný cˇ as pozorování vˇetší o 100 sekund než p˚uvodní cˇ as zapsaný v originálním souboru. Kliknutím na položku Time correction v nabídce Corrections otevˇrete dialogové okno. Chcete-li zadat cˇ asový posun pˇrímo jako hodnotu v sekundách, oznaˇcte první volbu (by ... seconds) a do editaˇcního pole zadejte poˇcet sekund. V pˇrípadˇe, že je pro Vás výhodnˇejší zadat cˇ asový interval pomocí dvou cˇ asových okamžik˚u, oznaˇcte druhou možnost (by differention of dates:) a do editaˇcních polí zadejte dva cˇ asové údaje. Pokud potˇrebujete zmˇenit cˇ as pozorování jen u cˇ ásti soubor˚u, oznaˇcte v hlavním oknˇe programu soubory, které chcete modifikovat, v dialogovém oknˇe pak v dolní cˇ ásti oznaˇcte volbu Modify – selected files only. Tento postup opakujte podle potˇreby.
2.4.2 Dark correction (Korekce temným snímkem) Tato funkce provede korekci CCD snímk˚u odeˇctením tzv. temného snímku. Ten se snímá se zavˇrenou závˇerkou kamery. Pro snížení náhodného šumu je vhodné složit nˇekolik temných snímk˚u pomocí nástroje Master-dark. Nˇekteré typy kamer umožˇnují provést tuto korekci automaticky pˇred uložením snímku do souboru, v takovém pˇrípadˇe tento krok redukce pˇreskoˇcte, ale lepších výsledk˚u dosáhnete poˇrízením pˇeti až deseti temných snímk˚u na konci pozorování, kdy je cˇ ip kamery dobˇre a rovnomˇernˇe vychlazen. Korekˇcní snímek musí být uložen v nˇekterém z podporovaných formát˚u, pˇred korekcí program automaticky pˇrevede snímek do pracovního formátu.
18
2. PROGRAM MUNIWIN
V nabídce kliknˇete na volbu Dark correction v nabídce Corrections, tím otevˇrete pˇríslušné dialogové okno. V nˇem vyberte disk a vyhledejte adresáˇr, ve kterém se nachází korekˇcní snímek. Soubor se snímkem oznaˇcte v prostˇredím oknˇe a stisknˇete tlaˇcítko OK. Zpracováváte-li pozorování z nˇekolika nocí, je nutné použít pro každou sérii dat odpovídající temný korekˇcní snímek. V takovém pˇrípadˇe proved’te korekci v nˇekolika krocích. V tabulce vstupních oznaˇcte soubory poˇrízené bˇehem jedné pozorovací noci, v dialogovém oknˇe vyberte odpovídající korekˇcní snímek a v dolní cˇ ásti okna oznaˇcte volbu Modify – selected files only. Tento postup opakujte pro všechny série snímk˚u. Oznaˇcíte-li v seznamu soubor˚u nˇekterou položku, v levé dolní cˇ ásti dialogového okna se zobrazí ukázka snímku vˇcetnˇe struˇcných informací. Zatržítky m˚užete zmˇenit vlastnosti ukázky: • Preview – zapíná a vypíná zobrazování ukázky. Na pomalých poˇcítaˇcích je vhodné tuto volbu vypnout. • Autocontrast – zapíná a vypíná automatický výpoˇcet jasu a kontrastu snímku. Pokud je tato funkce vypnuta, použijí se hodnoty uložené v souboru. • Invert – pˇrepíná pozitivní a negativní zobrazení snímku.
2.4.3 Flat correction (Korekce svˇetlým snímkem) Tato korekce se provádí vždy až po korekci temným snímkem. Funkce provede korekci snímk˚u vydˇelením tzv. svˇetlým snímkem. Svˇetlý korekˇcní by mˇel být poˇrízen nasnímáním rovnomˇernˇe osvˇetleného pozadí. Eliminuje se tím nerovnomˇernost citlivosti obrazových element˚u v kameˇre a také nerovnomˇernosti celé optické soustavy. Pro získání kvalitních korekˇcních snímk˚u m˚užete zkombinovat nˇekolik snímk˚u nástrojem Master-flat. Korekˇcní snímek musí být uložen v nˇekterém z podporovaných formát˚u, pˇred korekcí program automaticky pˇrevede snímek do pracovního formátu. V nabídce Corrections kliknˇete na volbu Flat correction, tím otevˇrete pˇríslušné dialogové okno. V nˇem vyberte disk a vyhledejte adresáˇr, ve kterém se nachází korekˇcní snímek. Soubor se snímkem oznaˇcte v prostˇredím oknˇe a stisknˇete tlaˇcítko OK. Zpracováváte-li pozorování z nˇekolika období, je vhodné použít pro každou sérii dat odpovídající svˇetlý korekˇcní snímek. V takovém pˇrípadˇe proved’te korekci v nˇekolika krocích. V tabulce vstupních oznaˇcte soubory poˇrízené bˇehem jednoho období, v dialogovém oknˇe vyberte odpovídající korekˇcní snímek a v dolní cˇ ásti okna oznaˇcte volbu Modify – selected files only. Tento postup opakujte pro všechny série snímk˚u.
2.5. NABÍDKA PHOTOMETRY (FOTOMETRIE)
19
Oznaˇcíte-li v seznamu soubor˚u nˇekterou položku, v levé dolní cˇ ásti dialogového okna se zobrazí ukázka snímku vˇcetnˇe struˇcných informací. Zatržítky m˚užete zmˇenit vlastnosti ukázky: • Preview – zapíná a vypíná zobrazování ukázky. Na pomalých poˇcítaˇcích je vhodné tuto volbu vypnout. • Autocontrast – zapíná a vypíná automatický výpoˇcet jasu a kontrastu snímku. Pokud je tato funkce vypnuta, použijí se hodnoty uložené v souboru. • Invert – pˇrepíná pozitivní a negativní zobrazení snímku.
2.5 Nabídka Photometry (Fotometrie) 2.5.1 Photometry (Fotometrie) Tato funkce provede aperturní fotometrii snímk˚u. Spouští se vždy až po provedení všech potˇrebných korekcí. Výsledek zpracování se uloží do tzv. fotometrických soubor˚u, které obsahují informace o polohách a jasnostech hvˇezd na snímcích. Tyto soubory jsou uloženy v adresáˇri pro pˇrechodné soubory a mají pˇríponu srt. V nabídce Photometry kliknˇete na volbu Photometry. Chcete-li zpracovat všechny soubory v projektu, nemusíte v dialogu nic nastavovat, jen stiskem tlaˇcítka OK spust’te zpracování soubor˚u. Po jeho dokonˇcení se do tabulky vstupních soubor˚u do sloupce Stars doplní poˇcet detekovaných hvˇezd na každém snímku.
Chcete-li provést fotometrii jen u cˇ ásti snímk˚u zaˇrazených v projektu, napˇríklad po zmˇenˇe parametr˚u, vyberte v hlavním oknˇe programu soubory, které chcete zpracovat a v dialogovém oknˇe oznaˇcte volbu Modify – selected files only.
20
2. PROGRAM MUNIWIN
Protože snímky v pracovním formátu z˚ustávají v adresáˇri pro pˇrechodné soubory, m˚užete v pˇrípadˇe potˇreby opakovat fotometrii nˇekolikrát po sobˇe, aniž by bylo nutné soubory znovu pˇrevádˇet a provádˇet potˇrebné korekce. Chcete-li si prohlédnout výsledek fotometrie snímku, dvakrát kliknˇete na pˇríslušný rˇádek v tabulce vstupních soubor˚u. Otevˇre se náhledové okno, ve kterém jsou vykresleny všechny nalezené hvˇezdy. ˇ Velikost kotouˇcku odpovídá jasnosti hvˇezdy. Cervenou barvou jsou znázornˇeny hvˇezdy, u kterých se nepovedlo urˇcit jasnost (vˇetšinou pˇreexponované hvˇezdy).
2.6 Nabídka Matching (Skládání) 2.6.1 Match stars (Skládání hvˇezd) Skládání snímk˚u je proces, pˇri kterém program vyhledává odpovídající hvˇezdy ve vstupním a tzv. referenˇcním fotometrickém souboru. Výsledkem skládání je opˇet fotometrický soubor v nˇemž jsou hvˇezdy ze vstupního souboru uloženy na stejných ˇrádcích (tj. ve stejném poˇradí) jako odpovídající hvˇezdy v referenˇcním souboru. Referenˇcní soubor je obvykle jeden ze snímk˚u ze zpracovávané série. Místo nˇej lze použít tzv. katalogový soubor obsahující kromˇe polohy hvˇezd také další dodateˇcné informace užiteˇcné pˇri dalších zpracování dat (viz funkce Výbˇer hvˇezd). V nabídce Matching kliknˇete na volbu Match stars, tím otevˇrete pˇríslušné dialogové okno. Chcete-li pro skládání použít jako referenˇcní jeden snímek ze zpracovávané série, oznaˇcte volbu Use – reference file a v tabulce vyberte soubor, který chcete použít jako referenˇcní snímek. Podobnˇe jako v ostatních funkcích se v dolní levé cˇ ásti okna se zobrazí náhled na vybraný snímek. Nejlepší referenˇcní snímek je obvykle ten, který obsahuje nejvíce hvˇezd a pˇritom není nˇejak viditelnˇe poškozen; proto program zobrazuje v tabulce soubor˚u také poˇcet hvˇezd. Máte-li v katalogu uložen odpovídající katalogový soubor pro toto pole, oznaˇcte v dialogu volbu Use – catalogue file a v tabulce oznaˇcte odpovídající katalogový soubor. V dolní cˇ ásti okna se opˇet zobrazuje náhled. Dvojklikem na ukázce se otevˇre okno se snímkem v plném rozlišení. Dialog zavˇrete tlaˇcítkem OK, tak spustíte proces skládání snímk˚u. Po dokonˇcení procesu se v tabulce vstupních soubor˚u zmˇení hodnota ve sloupci Stars na zlomek x/y, kde x je poˇcet úspˇešnˇe identifikovaných hvˇezd na snímku a y je poˇcet hvˇezd v p˚uvodním fotometrickém souboru. Protože funkce nepˇrepisuje p˚uvodní fotometrické soubory, m˚užete v pˇrípadˇe potˇreby opakovat kládání nˇekolikrát po sobˇe, aniž by bylo nutné soubory znovu pˇrevádˇet, provádˇet potˇrebné korekce a fotometrii.
2.7. NABÍDKA PLOTTING (KRESLENÍ)
21
2.7 Nabídka Plotting (Kreslení) 2.7.1 Choose stars (Výbˇer hvˇezd) Posledním krokem pˇri zpracování pozorování promˇenné hvˇezdy je sestavení její svˇetelné kˇrivky. Pomocí tohoto dialogu uživatel sdˇelí programu, která hvˇezda ve fotometrických souborech je promˇenná, které hvˇezdy mají být použity jako srovnávací pˇrípadnˇe kontrolní. Kliknutím na položku Choose stars v nabídce Plotting otevˇrete dialogové okno, na jehož pracovní ploše je zobrazen použitý referenˇcní snímek respektive mapka sestavená podle katalogového souboru. Postupnˇe levým tlaˇcítkem myši kliknˇete na promˇennou hvˇezdu (bude znaˇcena jako var), srovnávací hvˇezdu (comp) a pˇrípadnˇe nˇekolik kontrolních hvˇezd (chk1, chk2, atd.). Pokud byl pˇri skládání použit katalogový soubor, pak pˇri otevˇrení dialogu by mˇely být promˇenná a srovnávací hvˇezdy automaticky oznaˇceny, takže staˇcí výbˇer hvˇezd zkontrolovat. Je-li v nastavení výstupu zadán formát „instrumentální magnitudy“, (viz nastavení výstupu) provádí se výbˇer stejným zp˚usobem, ale hvˇezdy se na snímku oznaˇcí s1, s2, ...
Chcete-li zadat jiný výbˇer, stisknˇete tlaˇcítko Clear a zadejte nový výbˇer hvˇezd. Tlaˇcítkem Reset se vrátíte zpˇet k výbˇeru uloženému v katalogovém souboru. V pˇrípadˇe, že potˇrebujete najít hvˇezdu nacházející se ve fotometrických souborech na urˇcitém ˇrádku, stisknˇete tlaˇcítko Show a v dialogu zadejte cˇ íslo hvˇezdy. Stisknutím a podržením pravého tlaˇcítka myši skryjete jmenovky u vybraných hvˇezd.
22
2. PROGRAM MUNIWIN
Dialogové okno zavˇrete tlaˇcítkem OK. Program vygeneruje tabulku mˇeˇrení a automaticky zobrazí okno s grafem svˇetelné kˇrivky (viz dále). Stisknutím tlaˇcítkem Stars se zvýrazní žlutými kotouˇcky všechny správnˇe zmˇerˇené hvˇezdy na referˇ enˇcním snímku. Cervenými kotouˇcky jsou oznaˇceny hvˇezdy u nichž nebylo možné provést fotometrii. Opˇetovným stiskem tlaˇcítka se tato funkce vypne.
2.7.2
Enter object’s coordinates (Zadání souˇradnic objektu)
Tato položka se objeví v nabídce pouze tehdy, je-li v konfiguraci programu nastaveno ukládání takových údaj˚u, které vyžadují znalost polohy pozorovaného objektu (heliocetnrická korekce a koeficient vzdušné hmoty). Polohu objektu lze zadat dvˇema zp˚usoby: ruˇcnˇe nebo vyhledáním v katalozích. První zp˚usob použijte v pˇrípadˇe, že znáte rovníkové souˇradnice pozorovaného objektu. Druhý zp˚usob je vhodný pˇri pozorování promˇenných hvˇezd. Program umí vyhledávat hvˇezdy v nˇekolika nejˇcastˇeji používaných katalozích, tyto katalogy však nejsou souˇcástí instalaˇcního balíku programu CMunipack. Proto je pˇred prvním použitím této funkce nutné nastavit cesty k soubor˚um v konfiguraci programu (viz. dialog Preferencies, záložka Catalogues). Zadání souˇradnic ruˇcnˇe V nabídce Plotting kliknˇete na položku Enter object’s coordinates. Otevˇre se nové dialogové okno, v jeho horní cˇ ásti vyberte možnost Enter R.A. and Dec. manually a do editaˇcních polí v dolní cˇ ásti dialogu vložte rektascenzi a deklinaci objektu. Pˇríklady: 23 57 23.5, +43 49 15; 235723.5, +43 49 15 nebo 23.95653, 43.8208. M˚užete také vyplnit název objektu, napˇríklad jméno promˇenné hvˇezdy. Zadaný ˇretˇezec se uvede pˇri tisku svˇetelné kˇrivky nebo mapky. Dialog zavˇrete tlaˇcítkem OK.
Vyhledání souˇradnic v katalozích V nabídce Plotting kliknˇete na položku Enter object’s coordinates. Otevˇre se nové dialogové okno, v jeho horní cˇ ásti vyberte možnost Search star catalogues a do editaˇcního pole Search zadejte oznaˇcení promˇenné hvˇezdy nebo jeho cˇ ást, minimálnˇe 3 znaky. Stisknˇete tlaˇcítko Enter. Program vyhledá v dostupných katalozích všechny záznamy, které obsahují zadaný text. Velikost písmen, mezery a další oddˇelovaˇce se automaticky ignorují. Výsledek hledání se zobrazí v tabulce, která obsahuje všechny nalezené záznamy. V prvním sloupci je uveden pˇresné oznaˇcení promˇenné hvˇezdy, její rektascenzi a deklinaci. Ve sloupci zdroj je uveden název katalogu, ze kterého údaje pochází. Poslední sloupec, Comments, obsahuje doplˇnkové informace, nejˇcastˇeji další varianty oznaˇcení téže hvˇezdy. Prohlédnˇete obsah tabulky a myší oznaˇcte nejvhodnˇejší ˇrádek. Pokud Vám výsledky hledání nevyhovují, m˚užete do editaˇcního pole zadat jiný text a hledání opakovat. Dialog zavˇrete tlaˇcítkem OK.
2.7. NABÍDKA PLOTTING (KRESLENÍ)
2.7.3
23
Plot curve (Zobrazení svˇetelné kˇrivky)
Klinutím na položku Plot curve v nabídce otevˇrete okno, ve kterém je zobrazen graf poslední vygenerované svˇetelné kˇrivky. Pomocí ovládacích prvk˚u m˚užete data uložit do souboru nebo vytisknout na tiskárnˇe. Datový soubor obsahuje nejen svˇetelnou kˇrivku promˇenné hvˇezdy v˚ucˇ i srovnávací hvˇezdˇe, ale také údaje o jasnosti promˇenné v˚ucˇ i všem kontrolním hvˇezdám a také vzájemné jasnosti srovnávací a všech kontrolních hvˇezd. Tyto údaje slouží pˇredevším k tomu, aby uživatel mohl zkontrolovat, zda použitá srovnávací hvˇezda není náhodou také promˇenná. V dolní cˇ ásti ovládacího panelu se nachází tabulka, ve kterém je zobrazen seznam dostupných údaj˚u v souboru. Po otevˇrení okna je vždy implicitnˇe zobrazen první sloupec údaj˚u v souboru. Pro zobrazení jiné svˇetelné kˇrivky kliknˇete na pˇríslušný ˇrádek v tabulce. Pˇrepnutím volby Show errors m˚užete také zapnout nebo vypnout zobrazování chybových úseˇcek. Vygenerovaný soubor se svˇetelnou kˇrivkou je výsledkem celého procesu zpracování CCD pozorování. Datový soubor si uložte do adresáˇre na disk a vhodnˇe pojmenujte. Je vhodné si data ukládat pˇrímo do složky ke zdrojovým soubor˚um nebo do zvláštního adresáˇre. V dialogu stisknˇete tlaˇcítko Save data a zadejte umístˇení a jméno cílového souboru. Standardnˇe se datové soubory ukládají do podadresáˇre results v hlavním adresáˇri programu. Soubory v této složce jsou pˇrístupné pˇrímo v programu v oknˇe Results. Kliknutím na nˇekterý bod na svˇetelné kˇrivce se zobrazí podrobné informace do informaˇcního panelu v pravé dolní cˇ ásti okna. Vybraný bod se zvýrazní žlutým koleˇckem.
24
2. PROGRAM MUNIWIN
Chcete-li zobrazený graf vytisknout na tiskárnˇe, stisknˇete tlaˇcítko Print graph. Program otevˇre náhledové okno, v nˇem stisknˇete tlaˇcítko Print. Tlaˇcítkem OK zahájíte tisk. Graf m˚užete také uložit do souboru jako obrázek ve formátu JPEG, PNG, TIFF nebo BMP. Tato funkce se spouští tlaˇcítkem Save image.
2.7.4
View chart (Zobrazení mapky)
Identifikaˇcní mapku s vyznaˇcením naposled použitého výbˇeru hvˇezd si m˚užete prohlédnout v dialogu, který se otevírá položkou View chart v hlavní nabídce. V dialogovém oknˇe je zobrazen referenˇcní snímek respektive katalogový soubor. Hvˇezdy jsou oznaˇceny stejným zp˚usobem jako v dialogu Choose stars. Zobrazenou mapku m˚užete uložit do souboru jako obrázek nebo vytisknout na tiskárnˇe. Pomocí tohoto dialogu lze také vygenerovat katalogový soubor.
Pro uložení mapky do souboru stisknˇete tlaˇcítko Save image V dialogovém oknˇe zadejte umístˇení a jméno cílového souboru a potvrd’te tlaˇcítkem Uložit. Mapky se standardnˇe ukládají do stejného adresáˇre jako datové soubory (podadresáˇr results v hlavním adresáˇri). Soubory v této složce jsou pˇrístupné pˇrímo v programu v oknˇe Results. Chcete-li mapku vytisknout na tiskárnˇe, stisknˇete tlaˇcítko Print chart. Program otevˇre náhledové okno, v nˇem stisknˇete tlaˇcítko Print. Tlaˇcítkem OK zahájíte tisk.
2.8 Nabídka Tools (Nástroje) 2.8.1 Master-dark (Skládání temných korekˇcních snímku) ˚ Tento nástroj slouží ke skládání temných korekˇcních snímk˚u. Pro dosažení lepších výsledk˚u je vhodné pro korekci použít temný snímek složený z nˇekolika (cca pˇeti) snímk˚u poˇrízených na konci pozorování, kdy je kamera dobˇre a rovnomˇernˇe vychlazena. Zdrojové snímky mohou být uloženy v libovolném podporovaném formátu, výsledný soubor je vždy ve formátu FITS. Do tabulky vstupních soubor˚u (v hlavním oknˇe programu) vložte temné snímky, které chcete použít pro výpoˇcet výsledného snímku a proved’te jejich konverzi. V nabídce Tools kliknˇete na položku Master-dark. V dialogovém oknˇe zadejte, zda se mají zpracovat všechny soubory zaˇrazené do projektu nebo jen soubory oznaˇcené v tabulce vstupních soubor˚u. Stisknˇete tlaˇcítko OK. V následujícím dialogovém oknˇe vyhledejte adresáˇr, do kterého chcete uložit výsledný snímek a zadejte jméno souboru. Potvrd’te tlaˇcítkem Uložit.
2.8. NABÍDKA TOOLS (NÁSTROJE)
25
2.8.2 Master-flat (Skládání svˇetlých korekˇcních snímku) ˚ Tento nástroj slouží ke skládání svˇetlých korekˇcních snímk˚u. Postup pro poˇrízení kvalitních korekˇcních snímk˚u je pˇredmˇetem mnoha diskuzí a pˇresahuje rámec této pˇríruˇcky. Tento jednoduchý nástroj umožˇnuje složit nˇekolik snímk˚u dohromady. Zdrojové snímky mohou být uloženy v libovolném podporovaném formátu, výsledný soubor je vždy ve formátu FITS. Do tabulky vstupních soubor˚u v hlavním oknˇe programu vložte svˇetlé snímky, které chcete použít pro výpoˇcet výsledného snímku, proved’te jejich konverzi. Vhodné je provést také korekci temným snímkem. V nabídce Tools kliknˇete na položku Master-flat. V dialogovém oknˇe zadejte, zda se mají zpracovat všechny soubory zaˇrazené do projektu nebo jen soubory oznaˇcené v tabulce vstupních soubor˚u. Stisknˇete tlaˇcítko OK. V následujícím dialogovém oknˇe vyhledejte adresáˇr, do kterého chcete uložit výsledný snímek a zadejte jméno souboru. Potvrd’te tlaˇcítkem Uložit.
2.8.3 Find variables (Hledání promˇenných hvˇezd) Výhodou pozorování pomocí CCD kamery je, že umožˇnuje najednou mˇeˇrit jasnost všech hvˇezd, které se nachází v zorném poli pˇrístroje. Je proto možné, že na nˇejaké sérii snímk˚u zachytíte nejen pozorovanou hvˇezdu, ale také jinou promˇennou – napˇríklad známou promˇennou hvˇezdu nacházející se v okolí pozorované hvˇezdy. S trochou štˇestí se m˚uže stát, že na snímcích zachytíte zmˇenu jasnosti u hvˇezdy jejíž promˇennost ještˇe není známa. Nástroj Find variables je pom˚ucka pro vyhledávání promˇenných hvˇezd na sérii snímk˚u. Využívá k tomu graf závislosti smˇerodatné odchylky jasnosti hvˇezdy na její stˇrední jasnosti. Pˇri výpoˇctu se ˇ je hvˇezda automaticky vyˇrazují hvˇezdy, které na vˇetší cˇ ásti snímk˚u chybí (viz nastavení nástroje). Cím slabší, tím víc se u ní projevují r˚uzné náhodné chyby a odchylka je proto vˇetší, popsaný graf má proto tvar cˇ ásti paraboly. Promˇennou hvˇezdu lze v takovém grafu identifikovat tak, že její smˇerodatná odchylka je vˇetší než odchylka podobnˇe jasných hvˇezd. Nejprve proved’te všechny kroky redukce CCD pozorování až po složení fotometrických soubor˚u. V nabídce Tools kliknˇete na položku Find variables. Program naˇcte údaje o jasnostech všech hvˇezd na všech snímcích a automaticky zvolí jednu hvˇezdu jako srovnávací. Otevˇre se dialogové okno nástroje, jehož pracovní plocha je logicky rozdˇelena do tˇrí cˇ ástí. V levém horním výˇrezu je zobrazen graf na jehož vodorovnou osu se vynáší stˇrední jasnost hvˇezdy a na vodorovnou osu její smˇerodatná odchylky. V pravé cˇ ásti dialogového okna je zobrazena identifikaˇcní mapka a vyznaˇcena zvolená srovnávací hvˇezda.
Kliknˇete myší na libovolný bod v grafu. Ten se vyznaˇcí cˇ ervenou barvou se jmenovkou var. Stejným zp˚usobem se oznaˇcí odpovídající hvˇezda na mapce a v dolní cˇ ásti dialogu se zobrazí graf svˇetelné kˇrivky vybrané hvˇezdy. Tímto zp˚usobem m˚užete jednoduše zkontrolovat všechny hvˇezdy, které by
26
2. PROGRAM MUNIWIN
mohly být promˇenné – body v grafu, které jsou v grafu výše než hvˇezdy podobné jasnosti, viz následující obrázek. V nˇekterých pˇrípadech nemusí být automaticky vybraná srovnávací hvˇezda ideální. (Na mapce je vyznaˇcena zelenou barvou s popiskou Comp.) V takovém pˇrípadˇe m˚užete manuálnˇe zmˇenit srovnávací hvˇezdu: v ovládacím panelu stisknˇete tlaˇcítko Comp, a na identifikaˇcní mapce kliknˇete na novou srovnávací hvˇezdu. Pomocí dalších tlaˇcítek na ovládacím panelu m˚užete uložit graf, mapku nebo svˇetelnou kˇrivku do souboru nebo vytisknout na tiskárnˇe. Postup je shodný s postupy uvedenými u pˇredchozích dialog˚u.
2.8.4 Plot track list (Zobrazení grafu posunu) ˚ Graf posun˚u (track-list) názornˇe zobrazuje informace o posunu hvˇezd na snímcích v˚ucˇ i referenˇcnímu snímku ve vodorovném resp. svislém smˇeru. Takový graf lze použít pro výpoˇcet velikosti periodické chyby pohonu dalekohledu. Klinutím na položku Plot track list v nabídce Tools otevˇrete okno, ve kterém je zobrazen graf posun˚u. Na vodorovné ose je vyneseno juliánské datum snímku a na svislé ose posun v pixelech. V dolní cˇ ásti ovládacího panelu je zobrazen seznam dostupných údaj˚u v souboru. Kliknutím na položku v seznamu lze pˇrepnout zobrazovaný údaj: • OFFSETX – vodorovný smˇer, kladné hodnoty smˇerem doprava, záporné smˇerem doleva. • OFFSETY – svislý smˇer, kladné hodnoty smˇerem dol˚u, záporné smˇerem nahoru. Vygenerovaný soubor m˚užete tlaˇcítkem Save data uložit na disk. Standardnˇe se datové soubory ukládají do podadresáˇre Results v hlavním adresáˇri programu. Soubory v této složce jsou pˇrístupné pˇrímo v programu v oknˇe Results. Kliknutím na nˇekterý bod na svˇetelné kˇrivce se zobrazí podrobné informace do informaˇcního panelu v pravé dolní cˇ ásti okna. Vybraný bod se zvýrazní žlutým koleˇckem. Chcete-li zobrazený graf vytisknout na tiskárnˇe, stisknˇete tlaˇcítko Print graph. Program otevˇre náhledové okno, v nˇem stisknˇete tlaˇcítko Print. Tlaˇcítkem OK zahájíte tisk. Graf m˚užete také uložit do souboru jako obrázek ve formátu JPEG, PNG, TIFF nebo BMP. Tato funkce se spouští tlaˇcítkem Save image.
2.8. NABÍDKA TOOLS (NÁSTROJE)
27
2.8.5 Process new files (Zpracování nových souboru) ˚ Nástroj je urˇcen pˇredevším pro pozorovatele krátkoperiodických promˇenných hvˇezd. Bˇehem pozorování m˚užete pr˚ubˇežnˇe kontrolovat, jak se promˇenná chová a rozhodnout se, zda je nutné pozorování pokraˇcovat nebo zda m˚užete mˇeˇrení ukonˇcit. Pˇri prvním pr˚ubˇežném zpracování postupujte stejným zp˚usobem, tak jak bylo popsáno v kapitole 2.1 až po výbˇer hvˇezd a sestavení svˇetelné kˇrivky. Pak m˚užete program klidnˇe ukonˇcit, protože si vždy pamatuje sv˚uj poslední stav. Po poˇrízení nˇekolika dalších snímk˚u opˇet spust’te program Muniwin, otevˇrete nabídku Tools a kliknˇete na položku Process new files. V dialogu vyberte dolní variantu. Do editaˇcního pole zadejte cestu do adresáˇre, do kterého ukládáte bˇehem pozorování nové snímky. V pˇrípadˇe, že bˇehem noci provádíte pozorování nˇekolika polí nebo používáte nˇekolik barevných filtr˚u, zadejte v dialogovém oknˇe také podmínky pro výbˇer soubor˚u (masku a název filtru).
Dialog zavˇrete tlaˇcítkem OK. Program automaticky provede všechny potˇrebné korekce, fotometrii, složení s referenˇcním snímkem a otevˇre okno se svˇetelnou kˇrivkou. Stejným zp˚usobem m˚užete pokraˇcovat dál až do ukonˇcení pozorování.
2.8.6 Express reduction (Expresní zpracování) Umožˇnuje provést všechny kroky redukce CCD pozorování dávkovým zp˚usobem. Pˇri bˇežném postupu zpracování je uživatel nucen spouštˇet veškeré kroky redukce ruˇcnˇe, vždy chvíli cˇ eká na dokonˇcení procesu. Tento dialog umožˇnuje uživateli nejprve zadat všechny potˇrebné údaje a program potom provede všechny požadované kroky najednou. Nejprve vložte vstupní soubory známým zp˚usobem do projektu. Potom v nabídce Tools kliknˇete na položku Express reduction. V dialogovém oknˇe zadejte, zda chcete zpracovat všechny soubory v tabulce nebo jen vybrané soubory.
Chcete-li provést konverzi soubor˚u a naˇctení do pracovního adresáˇre, zatrhnˇete volbu Fetch/convert files. Jestliže má být u snímk˚u provedena cˇ asová korekce, zatrhnˇete volbu Do time correction a do editaˇcního pole zadejte cˇ asový interval v sekundách. Obdobným zp˚usobem zadejte všechny kroky redukce, které chcete provést. Zpracování soubor˚u zahájíte tlaˇcítkem Process.
28
2. PROGRAM MUNIWIN
2.8.7 Make catalogue file (Vytvoˇrení katalogového souboru) Katalogový soubor lze vytvoˇrit následujím postupem: Klinutím na položku Make catalogue file v nabídce Tools otevˇrete dialog. V nˇem vyplˇnte do editaˇcních polí základní informace o pozorovaném objektu a použitém vybavení. Povinné je pouze pole název promˇenné, ale pokud uvažujete o tom, že budete katalogové soubory sdílet s dalšími pozorovateli, vyplˇnte také ostatní údaje. Usnadníte tím orientaci ostatním koleg˚um. Dialog zavˇrete tlaˇcítkem OK. Katalogový soubor se automaticky uloží do pˇríslušné složky (standardnˇe podadresáˇr cat v hlavním adresáˇri).
2.8.8 Preferences (Nastavení) Tato položka v nabídce otevírá konfiguraˇcní dialog, ve které se konfiguruje prostˇredí programu Muniwin a nastavují parametry používané pˇri zpracování snímk˚u. Volby jsou pˇrehlednˇe rozdˇeleny podle funkˇcních blok˚u do nˇekolika sekcí, v každé sekci je na panelu k dispozici tlaˇcítko Set defaults, které nastaví parametry v aktuálnˇe vybrané sekci na standardní hodnoty, které jsou dále v textu vysázeny v [hranatých závorkách]. Záloha konfigurace V nˇekterých pˇrípadech je potˇreba experimentovat s nastavením parametr˚u fotometrie pro dosažení nejlepších výsledk˚u. Jednoduchým zp˚usobem lze vytvoˇrit zálohu stávajícího nastavení programu a v pˇrípadˇe potˇreby se vrátit konfiguraˇcní soubory zpˇet do adresáˇre programu. To lze provést bud’to ruˇcnˇe, vytvoˇrením kopie všech soubor˚u s pˇríponou ini v adresáˇri programu Muniwin nebo pomocí tlaˇcítka v dialogu Preferencies. Stisknutím tlaˇcítkem Backup se otevˇre standardní dialog pro uložení soubor˚u. Pˇrejdˇete do adresáˇre, do kterého chcete vytvoˇrit zálohu konfigurace a potvrd’te jej tlaˇcítkem Uložit. Obdobným zp˚usobem se provede obnovení soubor˚u ze zálohy. V dialogu Preferencies stisknˇete tlaˇcítko Restore. Otevˇre se standardní dialog pro otevˇrení soubor˚u. Pˇrejdˇete do adresáˇre, ve kterém se nachází záloha konfigurace. Stisknˇete tlaˇcítko Otevˇrít. General options (Nastavení) V této sekci se konfiguruje prostˇredí programu Muniwin. • Save process logs to file – zapíná ukládání hlášení ze zpracování do soubor˚u s pˇríponou .log v pˇrechodném adresáˇri. [vypnuto] • Debug mode (verbose process logs) – zapíná ladící režim zpracování. V tomto režimu je rozšíˇren výpis hlášení o informace užiteˇcné pˇri ladˇení programu. [vypnuto]
2.8. NABÍDKA TOOLS (NÁSTROJE)
29
• Do not save image files to catalogue folder – zatržením této volby zakážete ukládání snímk˚u do složky pro katalogové soubory. [vypnuto] • Directory with temp. files – adresáˇr pro ukládání doˇcasných (pracovních) soubor˚u, standardnˇe je to podadresáˇr tmp v instalaˇcním adresáˇri. • Directory with cat. files – adresáˇr s katalogovými soubory, standardnˇe je to podadresáˇr cat. • Directory with res. files – adresáˇr, do kterého se ukládají výstupní soubory, standardnˇe je to podadresáˇr results. • Electronic help language – jazyk elektronické nápovˇedy.
Photometry options (Nastavení fotometrie) V tomto konfiguraˇcním dialogu se nastavují parametry fotometrie. Zejména hodnoty FWHM (Full Width at Half Maximum) a Threshold je nutné pro daný pˇrístroj urˇcit pro dosažení nejlepších výsledk˚u fotometrie. Oba parametry ovlivˇnují pˇredevším detekci hvˇezd na CCD snímcích. Zmenšením hodnoty FWHM lze dosáhnout zmˇeˇrení i slabých hvˇezd, ale pˇríliš malá hodnota zp˚usobí to, že za hvˇezdy bude program považovat i r˚uzné artefakty na pozadí. Parametrem Threshold nastavujete minimální odstup nejslabších detekovaných hvˇezd od šumu oblohy, hodnota parametru se udává v násobcích sigma. • Read noise – úroveˇn šumu v e- [15.00] • Gain – poˇcet elektron˚u na ADU, mˇela by se doplnit správná hodnota podle dokumentace k CCD kameˇre. • Low good datum – nejmenší platná hodnota pixelu [7.00] • High good datum – nejvˇetší platná hodnota pixelu [65535.00 = 16 bit˚u)] • FWHM of object – pˇredpokládaná šíˇrka objektu v polovinˇe úrovnˇe od maxima v pixelech (Full Width at Half Maximum), pro kterou má být výpoˇcet optimalizován, pro první pokusy zkuste použít hodnotu 3.00 • Threshold – práh urˇcující jak slabé hvˇezdy nad úrovní šumu pozadí budou detekovány, pro první pokusy zkuste použít hodnotu 4.00 • Low sharpness cutoff – dolní omezení ostrosti hvˇezd [0.20] • High sharpness cutoff – horní omezení ostrosti hvˇezd, [1.00] • Low roundness cutoff – dolní omezení soumˇernosti hvˇezd, [−1.00] • High roundness cutoff – horní omezení soumˇernosti hvˇezd, [1.00]
Aperture options (Nastavení clonek) V této sekci konfiguraˇcního dialogu se nastavují polomˇery clonek pro aperturní fotometrii. Polomˇer se udává vždy v obrazových bodech (pixelech). Doporuˇcený polomˇer clonky je 1.1 až 1.4 násobek hodnoty FWHM (viz kapitola 2.8.8). • Aperture #1..#12 – pr˚umˇery clonek cˇ íslo 1 až 12 • Inner sky radius – vnitˇrní pr˚umˇer clonky pro mˇeˇrení jasu oblohy [20.0] • Outer sky radius – vnˇejší pr˚umˇer clonky pro mˇeˇrení jasu oblohy [30.0]
30
2. PROGRAM MUNIWIN
Matching options (Nastavení skládání) V této sekci konfiguraˇcního dialogu se nastavují parametry používané pˇri sestavování svˇetelné kˇrivky a generování výstupních dat. • No. of stars used in matching – poˇcet hvˇezd ze vstupního a referenˇcního snímku, které budou použity pro skládání [10] • No. of identification stars – poˇcet vrchol˚u hledaných n-úhelníku [5] • Sigma clipping factor – práh pˇri urˇcovaní nepˇresností n-úhelník˚u, v násobcích sigma [2.5] Plotting options (Nastavení výstupu) V tomto konfiguraˇcním dialogu se nastavují parametry používané pˇri sestavování svˇetelné kˇrivky a generování výstupních dat. • Default aperture – standardnˇe používaná clonka (viz nastavení clonek) [1] • Output format – formát výstupního souboru [differential magnitudes] • Date & time format – formát data a cˇ asu [geocentric julian date] • Include heliocentric correction – je-li toto políˇcko zaškrtnuto, výstupní soubor bude obsahovat také hodnotu heliocentrické korekce [ne] • Include air-mass coefficient – je-li toto políˇcko zaškrtnuto, výstupní soubor bude obsahovat také koeficient vzdušné hmoty [ne] • Observatory – název pozorovacího stanovištˇe (volitelné) [žádné] • Longitude – zemˇepisná délka stanovištˇe, napˇríklad E 16 02 45, +160245 nebo +16.0458. Kladné hodnoty odpovídají délkám smˇerem na východ a záporné smˇerem na západ od nultého poledníku. [žádné] • Latitude – zemˇepisná šíˇrka stanovištˇe, napˇríklad N 49 13 00, +491300 nebo +49.2167. Kladné hodnoty odpovídají šíˇrkám smˇerem na sever a záporné smˇerem na jih od rovníku. [žádné] Poznámka 1: Instrumentální magnitudy ve výstupním souboru neodpovídají absolutním hvˇezdným velikostem. Tento výstupní formát je urˇcen pouze jako mezivýsledek pro další zpracování. Poznámka 2: Pole jméno pozorovacího stanovištˇe je vždy volitelné. Souˇradice stanovištˇe jsou vyžadována pouze pokud je zapnuta funkce poˇcítání koeficientu vzdušné hmoty. Tato funkce je standardnˇe vypnuta. Tools (Nastavení nástroju) ˚ V této cˇ ásti konfiguraˇcního dialogu se nastavují parametry pomocných nástroj˚u, které jsou pˇrístupné v nabídce Tools. Jejich význam je uveden v popisu jednotlivých nástroj˚u (kapitola 2.8). Catalogues (Katalogy promˇenných hvˇezd) Údaje v této cˇ ásti konfiguraˇcního dialogu jsou urˇcené pozorovatel˚um promˇenných hvˇezd. Je nutné je vyplˇnovat pouze v pˇrípadˇe, že potˇrebujete pˇri zpracování pozorování zadávat souˇradnice objektu pro výpoˇcet heliocentrické korekce nebo koeficientu vzdušné hmoty. Program Muniwin umožˇnuje vyhledat souˇradnice v nˇekolika cˇ asto používaných katalozích promˇenných hvˇezd. Instalace programu katalogy neobsahuje, uživatel je m˚uže získat na internetu na adresách uvedených v referencích (viz pˇrílohy). Po rozbalení soubor˚u na disk se uloží cesty k soubor˚um do konfiguraˇcního dialogu programu Muniwin.
2.9. NABÍDKA WINDOWS (OKNA)
31
2.9 Nabídka Windows (Okna) 2.9.1 Show message log (Zobrazit poslední výpis zpráv) Chcete-li si prohlédnout výpis hlášení z posledního provedeného kroku redukce, kliknˇete v nabídce Windows na položku Show message log. Dialogové okno obsahuje jednoduchou kontextovou nabídku, která umožˇnuje obsah okna zkopírovat do zásobníku. Pokud používáte výpisy k dalšímu zpracování, m˚užete v programu nastavit, že se mají výpisy všech proces˚u uložit také do soubor˚u do adresáˇre pro pˇrechodné soubory. V nabídce Files kliknˇete na položku Edit options a zatrhnˇete volbu Save process logs to file. Soubory mají vždy pˇríponu log.
2.9.2 Show results (Zobrazit výstupní soubory) V tomto oknˇe je zobrazen obsah adresáˇre pro výstupní soubory. Standardnˇe je to podadresáˇr results v hlavním adresáˇri programu. V nastavení programu (v sekci General položka Directory with res. files lze umístˇení této složky zmˇenit. Dvojklikem na nˇekterém souboru otevˇrete odpovídající náhledové okno podle typu dat. Pravým tlaˇcítkem myši otevˇrete kontextovou nabídku funkcí.
Po dokonˇcení zpracování (napˇr pozorování z jedné noci) je vhodné pˇresunout soubory z této složky do jiného umístˇení, aby nedošlo k nechtˇenému pˇrepsání soubor˚u pˇri zpracování dalších pozorování. K tomu je možné použít jeden ze tˇrí zp˚usob˚u: zkopírování soubor˚u do vybraného adresáˇre pomocí dialogu Save files, pˇretáhnutí oznaˇcených soubor˚u pomocí funkce Drag-and-drop nebo zkopírování soubor˚u pomocí zásobníku. Dialog Save files V tabulce výstupních soubor˚u oznaˇcte soubory, které chcete zkopírovat do jiného adresáˇre. Stisknutím pravého tlaˇcítka myši otevˇrete kontextovou nabídku, v ní vyberte položku Save files. V dialogu vyhledejte adresáˇr, do kterého chcete soubory uložit, a potvrd’te tlaˇcítkem Uložit. Funkce Drag-and-Drop V pr˚uzkumníku systému Windows (Tento poˇcítaˇc) pˇrejdˇete do adresáˇre, do kterého chcete soubory uložit. V programu Muniwin v tabulce výstupních soubor˚u oznaˇcte soubory, které chcete zkopírovat. Stisknˇete a podržte levé tlaˇcítko myši. Pˇretáhnˇete soubory na ikonu adresáˇre na systémové lištˇe. Chvíli poˇckejte až se adresáˇr pˇrepne na popˇredí, myší pˇrejed’te do prostoru okna a pak tlaˇcítko myši pust’te. Obdobným zp˚usobem m˚užete zkopírovat soubory i do nˇekterých souborových manažer˚u.
32
2. PROGRAM MUNIWIN
Kopírování pˇres zásobník V tabulce výstupních soubor˚u oznaˇcte soubory, které chcete zkopírovat do jiného adresáˇre, a stisknˇete pravé tlaˇcítko myši. V kontextové nabídce vyberte funkci Copy to clipboard. V pr˚uzkumníku systému Windows pˇrejdˇete do adresáˇre, do kterého chcete soubory uložit, opˇet stisknˇete pravé tlaˇcítko myši a v nabídce vyberte položku <em>Vložit. Obdobným zp˚usobem m˚užete vložit soubory i z nˇekterých souborových manažer˚u.
2.9.3 Show catalogue files (Zobrazit katalogové soubory) V tomto oknˇe je zobrazen obsah adresáˇre pro katalogové soubory. Standardnˇe je to podadresáˇr cat v hlavním adresáˇri programu. V nastavení programu (v dialogu Edit options položka Directory with cat. files lze umístˇení této složky zmˇenit. Dvojklikem na nˇekterém souboru otevˇrete náhledové okno s identifikaˇcní mapkou nebo snímkem a vyznaˇcenými hvˇezdami.
2.10
Nabídka Help (Nápovˇeda)
2.10.1 Open help (Otevˇrít nápovˇedu) Kliknutím na tuto položku v nabídce otevˇrete elektronickou nápovˇedu k programu Muniwin. Kontextovou nápovˇedu k právˇe otevˇrenému dialogu otevˇrete stiskem klávesy F1 kdekoliv v programu. Jazyk nápovˇedy m˚užete nastavit v dialogu Preferences v sekci General
2.10.2 About Muniwin (O programu Muniwin) Otevírá dialogové okno se základními informacemi o programu Muniwin.
3
Programy spouštˇené z pˇríkazové rˇ ádky
V této kapitole najdete popis ovládání program˚u z balíku C-Munipack, které se volají z pˇríkazové ˇrádky. Jsou urˇceny pro uživatele, kteˇrí chtˇejí spouštˇet jednotlivé kroky redukce snímk˚u ze své aplikace, z pˇríkazové ˇrádky nebo pomocí dávky cˇ i skriptu. V následujícím textu jsou strojopisným písmem vyznaˇcena klíˇcová slova a kurzívou jsou vysázeny texty, za které se doplˇnuje konkrétní hodnota parametru (ˇcíslo, název souboru apod.) V [hranatých závorkách] jsou uvedeny pˇreddefinované hodnoty, které program použije, pokud daný parametr není uveden.
3.1
Základní parametry, pravidla a použité formáty
Parametrem mask lze u nˇekterých program˚u zmˇenit zp˚usob pojmenování výstupních soubor˚u. Maska se zadává pomocí písmen, cˇ íslic a dalších povolených znak˚u. Zvláštní význam má znak otazník, za který se dosadí poˇradové cˇ íslo snímku od spuštˇení programu. Je-li v masce uvedeno nˇekolik otazník˚u za sebou, doplní se poˇradové cˇ íslo snímku zleva nulami na odpovídající poˇcet míst. Napˇríklad zadáte-li masku dout????.fts, budou výsledné soubory pojmenovány dout0001.fts, dout0002.fts, dout0003.fts atd. Všechny dále uvedené programy podporují následující základní parametry: -h, - -help -l, - -licence -v, - -version -q, - -quiet - -debug
vytiskne struˇcnou nápovˇedu vytiskne licenci k programu vytiskne informaci o verzi programu tichý režim – omezí výpisy na obrazovku ladící režim – rozšíˇrí výpisy na obrazovku
Seznam vstupních soubor˚u lze vložit pˇrímo do pˇríkazové ˇrádky, jednotlivé položky se oddˇelují mezerou. Pokud jméno souboru obsahuje mezeru, pak se celý parametr uzavˇre do úvozovek. Pokud je soubor˚u vˇetší množství, je vhodné využít znak˚u otazník (nahrazuje jediný znak) nebo hvˇezdiˇcka (nahrazuje libovolný poˇcet znak˚u). Další možností, jak zpracovat vˇetší množství soubor˚u najednou, je uložit seznam soubor˚u uložit do textového souboru. Tento soubor, napˇr. dirfile.txt, obsahuje na každém ˇrádku jméno vstupního souboru. Pokud se soubory nenachází pˇrímo v pracovním adresáˇri, je nutné v ˇrádku specifikovat i cestu a to bud’ v plném nebo relativním tvaru. Takový soubor lze vytvoˇrit napˇr. pˇríkazem: dir /b *.st7 > dirfile.txt.
3.2 Programy pro redukci snímku˚ 3.2.1 Konve (konverze snímku) ˚ Program Konve je urˇcen pro pˇrevod CCD snímk˚u uložených v souborech ve formátu, který používá software pro ovládání kamery (napˇr. Ccdops) do formátu FITS. Umožˇnuje bˇehem konverze provést cˇ asovou korekci pˇrípadnˇe pˇrevrácení snímku. Program je možné spustit v nˇekolika pracovních režimech, které se volí pˇrepínaˇci pˇredávanými z pˇríkazové ˇrádky. Mimo „normální“ konverzní režim umožˇnuje také pˇrevod pouze hlaviˇcek soubor˚u a výpis struˇcných nebo detailních informací o snímcích. Souˇcasná verze programu podporuje formát soubor˚u, který používají kamery firmy SBIG (ST-xx) a OES. Vstupem mohou být také soubory ve formátu FITS. Pˇrevod FITS do FITS lze využít pro sesbírání vstupních soubor˚u z nˇekolika adresáˇru˚ a jejich systematické pojmenování, což zjednoduší pˇrípravu k dalšímu zpracování.
34
ˇ ˇ ˇ 3. PROGRAMY SPOUŠTENÉ Z PRÍKAZOVÉ RÁDKY
Parametry: @dirfile @ par=file mask=mask tcor=sec flip=xy image1 ... -pfile -omask -cx -flipxy -header -info -details
jméno souboru se seznamem vstupních soubor˚u seznam vstupních soubor˚u se má naˇcíst ze std. vstupu jméno souboru s uživatelskými parametry, které se mají vložit do výstupního souboru [žádný] maska jmen výstupních soubor˚u [kout????.fts] cˇ asová korekce v sekundách [0] pˇrevrácení snímku (povolené hodnoty jsou ’x’, ’y’, ’xy’) jména vstupních soubor˚u jméno souboru s uživatelskými parametry (ekvivalent k ’par=’) maska jmen výstupních soubor˚u (ekvivalent k ’mask=’) poˇcáteˇcní hodnota cˇ ítaˇce snímk˚u [1] pˇrevrácení snímk˚u (ekvivalent k ’flip=’) pˇrevede pouze hlaviˇcky nikoliv data vytiskne struˇcné informace ze vstupních soubor˚u vytiskne detailní informace ze vstupních soubor˚u
Konfiguraˇcní soubory: Žádné Pˇríklad: Pˇrevod vstupních soubor˚u crcas01.st7, crcas02.st7 a crcas03.st7 do výstupních soubor˚u kout0001.fts, kout0002.fts a kout0003.fts. Jména vstupních soubor˚u se pˇredávají pˇres pˇríkazovou ˇrádku. C:\cmunipack\bin>konve crcas01.st7 crcas02.st7 crcas03.st7 KONVE Version 1.0.10 -------------------------------------------(crcas01.st7) -> (kout0001.fts) File format: ST-7 Compressed Image Image size : 382 x 255 pixels Date & time: 2003-09-26 19:36:47 UT Exposure : 20.00 s Filter : Clear -------------------------------------------(crcas02.st7) -> (kout0002.fts) File format: ST-7 Compressed Image Image size : 382 x 255 pixels Date & time: 2003-09-26 20:00:24 UT Exposure : 20.00 s Filter : Clear -------------------------------------------(crcas03.st7) -> (kout0003.fts) File format: ST-7 Compressed Image Image size : 382 x 255 pixels Date & time: 2003-09-26 20:26:09 UT Exposure : 20.00 s Filter : Clear C:\Munipack\bin>_
3.2.2 Timebat (ˇcasová korekce) Program Timebat provádí cˇ asovou korekci snímk˚u. To znamená, že pˇriˇcte k cˇ as˚um pozorování ve zdrojových souborech poˇcet sekund, pˇredaných pomocí parametru. Program nemˇení obsah obrazové cˇ ásti snímku ani jiné parametry v jeho hlaviˇcce. Zdrojové snímky musí být uloženy ve formátu FITS, výstupní snímek je též ve formátu FITS. Parametry: @dirfile @ tcor=sec
jméno souboru se seznamem vstupních soubor˚u seznam vstupních soubor˚u se má naˇcíst ze std. vstupu cˇ asová korekce v sekundách
˚ 3.2. PROGRAMY PRO REDUKCI SNÍMKU
mask=mask image1 ... -tsec -omask -cx
35
maska jmen výstupních soubor˚u [tout????.fts] jména vstupních soubor˚u cˇ asová korekce v sekundách (ekvivalent k ’tcor=’) maska jmen výstupních soubor˚u (ekvivalent k ’mask=’) poˇcáteˇcní hodnota cˇ ítaˇce snímk˚u [1]
Konfiguraˇcní soubory: Žádné Pˇríklad: Posunutí cˇ asu pozorování o 1 hodinu vpˇred ve vstupním souboru kout0001.fts do výstupního souboru tout0001.fts. C:\cmunipack\bin>timebat tcor=3600 kout0001.fts Time correction: 3600 s (kout0001.fts) => (tout0001.fits) C:\Munipack\bin>_
3.2.3 Darkbat (korekce temným snímkem) Program Darkbat provádí korekci vstupních snímk˚u tzv. temným snímkem (dark-frame). To znamená, že odeˇcte hodnoty obrazových bod˚u temného snímku od odpovídajících bod˚u vstupního snímku. Vstupní soubory i korekˇcní snímek musí být ve formátu FITS a musí mít stejné rozmˇery. Výsledný snímek bude uložen ve stejném formátu. Parametry: @dirfile @ dark=file mask=mask image1 ... -dfile -omask -cx
jméno souboru se seznamem vstupních soubor˚u seznam vstupních soubor˚u se má naˇcíst ze std. vstupu jméno souboru s temným snímkem maska jmen výstupních soubor˚u [dout????.fts] jména vstupních soubor˚u jméno souboru s temným snímkem (ekvivalent k dark=) maska jmen výstupních soubor˚u (ekvivalent k mask=) poˇcáteˇcní hodnota cˇ ítaˇce snímk˚u [1]
Konfiguraˇcní soubory: Žádné Pˇríklad: Pˇríkaz provede korekci vstupního souboru kout0001.fts temným snímkem, který je uložen v souboru dark.fts, a výsledek uloží do souboru dout0001.fts. C:\Munipack\bin>darkbat dark=dark.fts dout0001.fts Using dark frame: dark.fts (kout0001.fts) => (dout0001.fts) C:\Munipack\bin>_
3.2.4 Flatbat (korekce svˇetlým snímkem) Program Flatbat provádí korekci snímk˚u tzv. svˇetlým snímkem (flat-frame). To znamená, že dˇelí hodnoty obrazových bod˚u vstupního snímku odpovídajícími hodnotami svˇetlého snímku. Výsledek se ještˇe násobí mediánem svˇetlého snímku. Vstupní soubory i korekˇcní snímek musí být ve formátu FITS a musí mít stejné rozmˇery. Výsledný snímek bude uložen ve stejném formátu.
36
ˇ ˇ ˇ 3. PROGRAMY SPOUŠTENÉ Z PRÍKAZOVÉ RÁDKY
Parametry: @dirfile @ flat=file mask=mask image1 ... -ffile -omask -cx
jméno souboru se seznamem vstupních soubor˚u seznam vstupních soubor˚u se má naˇcíst ze std. vstupu jméno souboru se svˇetlým snímkem maska jmen výstupních soubor˚u [dout????.fts] jména vstupních soubor˚u jméno souboru se svˇetlým snímkem (ekvivalent k flat=) maska jmen výstupních soubor˚u (ekvivalent k mask=) poˇcáteˇcní hodnota cˇ ítaˇce snímk˚u [1]
Konfiguraˇcní soubory: Žádné Pˇríklad: Pˇríkaz provede korekci vstupního souboru dout0001.fts svˇetlým snímkem, který je uložen v souboru flat.fts, a výsledek uloží do souboru fout0001.fts. C:\cmunipack\bin>flatbat flat=flat.fts fout0001.fts Using flat frame: flat.fts (dout0001.fts) => (fout0001.fts) C:\Munipack\bin>_
3.2.5 Muniphot (fotometrie) Program Muniphot provádí fotometrii CCD snímk˚u. Výstup ukládá do textových soubor˚u (v dokumentaci dále oznaˇcených jako fotometrické soubory). Souˇcasná verze podporuje pouze aperturní fotometrii. Vstupní soubory musí být ve formátu FITS. Výstupní soubory jsou v textovém tvaru kompatibilním se soubory používanými v programu Daophot. Narozdíl od p˚uvodního Muniphotu z balíku Munipack se z úsporných d˚uvod˚u nevytváˇrí soubory .coo a .ap. Jména výstupních soubor˚u se tvoˇrí tak, že se použije jméno vstupního souboru a zmˇení se pˇrípona na srt. Parametry: @dirfile @ par=file ap=file image1 ...
jméno souboru se seznamem vstupních soubor˚u seznam vstupních soubor˚u se má naˇcíst ze std. vstupu jméno souboru s parametry [muniphot.ini] soubor s definicemi clonek [apertures.ini] jména vstupních soubor˚u
Konfiguraˇcní soubory: Muniphot.ini, Apertures.ini Pˇríklad:
Pˇríkaz provede fotometrii snímku tmp0001.fts a výsledek uloží do souboru tmp0001.srt.
C:\cmunipack\bin>muniphot tmp0001.fts -------------------------------------------Image file : tmp0001.fts Date & time : 2003-09-26 19:36:47 UT Picture size : 382 x 255 pixels Sky value : 310.7 +- 25.7 ADU Mean & median: 310.7, 310.7 ADU Rel. error : 1.07 Stars found : 354 Mag. limit : 18.1 +- 0.2 per star in aperture #1. C:\cmunipack\bin>type tmp0001.srt NL NX NY LOWBAD HIGHBAD THRESH
AP1
PH/ADU
RNOISE...
37
˚ 3.2. PROGRAMY PRO REDUKCI SNÍMKU
2
382
255
314.7 65000.0
110.15
2.00
2.30
15.00...
0
380.349 26.646 466.192 22.23 0.00
11.673 0.002
99.999 9.999
99.999 9.999
99.999... 9.999...
1
47.193 24.184 462.042 17.61 0.00
12.447 0.002
12.299 0.002
12.229 0.002
12.199... 0.002...
2
317.126 232.323 459.838 20.55 0.00
12.588 0.003
12.408 0.002
12.317 0.002
12.279... 0.003...
C:\Munipack\bin>_
3.2.6 Munimatch (skládání fotometrických souboru) ˚ Program Munimatch hledá odpovídající hvˇezdy ve dvou fotometrických souborech hvˇezd. Jeden ze soubor˚u je oznaˇcen jako referenˇcní, druhý je vstupní. Výstupem programu je opˇet fotometrický soubor, ve kterém se nacházejí hvˇezdy ze vstupního snímku, ale jejich pozice ve výstupním souboru odpovídá pozici odpovídajících hvˇezd na referenˇcním snímku. Místo referenˇcního souboru, což je obvykle jeden ze snímk˚u ze zpracovávané série, lze použít tzv. katalogový soubor. Jména výstupních soubor˚u se tvoˇrí tak, že se použije jméno vstupního souboru a zmˇení se pˇrípona srt na mat. Parametry: @dirfile @ par=file ref=file image1 ...
jméno souboru se seznamem vstupních soubor˚u seznam vstupních soubor˚u se má naˇcíst ze std. vstupu jméno souboru s parametry [munimatch.ini] jméno referenˇcního souboru jména vstupních soubor˚u
Konfiguraˇcní soubory: Munimatch.ini
Pˇríklad: Pˇríkaz provede pˇreskládání hvˇezd v souboru tmp0001.srt podle referenˇcního souboru ref.srt a výsledek uloží do výstupního souboru tmp0001.mat. C:\cmunipack\bin>munimatch ref=ref.srt tmp0001.srt Reference file: ref.srt ------------------------------(tmp0001.srt) -> (tmp0001.mat) Number of matched stars : 268 from 354 (76\%) Sum of square in the better case : 0.1979 Tolerance : 0.50 Transformation matrix : 1.000 0.001 15.407 -0.001 1.000 -11.320 0.000 0.000 1.000 C:\Munipack\bin>_
3.2.7 Munilist (generování svˇetelné kˇrivky) Program Munilist naˇcte informace o instrumentálních hvˇezdných velikostech ze vstupních soubor˚u a sestaví tabulku jasností vybraných hvˇezd, kterou uloží do souboru. Formát výstupu se ˇrídí pˇredanými parametry na pˇríkazové ˇrádce. Seznam vybraných hvˇezd se pˇredává pomocí parametr˚u z pˇríkazové ˇrádky. Hvˇezda se identifikuje poˇradím záznamu v souboru (nikoliv identifikaˇcním cˇ íslem uvedeným na zaˇcátku prvního ˇrádku), první hvˇezda v souboru má cˇ íslo 1, zapoˇcítávají se také prázdné ˇrádky.
38
ˇ ˇ ˇ 3. PROGRAMY SPOUŠTENÉ Z PRÍKAZOVÉ RÁDKY
Parametry: @dirfile @ src=file var ... par=file out=file ap=n image1 ... -os -of -oa -ot -jdhel -helcor -airmass ra=hh:mm:ss.s dec=-ddd:mm:ss lon=dd:mm:ss lat=dd:mm:ss -pfile
jméno souboru se seznamem vstupních soubor˚u seznam vstupních soubor˚u se má naˇcíst ze std. vstupu použít vstupní soubor ve formátu Readall poˇradí promˇenné, srovnávací a kontrolních hvˇezd soubor s parametry [munilist.ini] jméno výstupního souboru, [data.dat] cˇ íslo clonky [1] jména vstupních soubor˚u výstupní formát – diferenciální jasnosti výstupní formát – instrumentální jasnosti výstupní formát – ’read-all’ výstupní formát – ’track-list’ pˇrepoˇcítat cˇ as pozorování na heliocentrické JD zahrnout do výstupu také hodnotu heliocentrické korekce (helcor) zahrnout do výstupu také koeficient vzdušné hmoty (airmass) rektascenze pozorovaného objektu deklinace pozorovaného objektu (souˇradnice objektu jsou vyžadovány pouze pro výpoˇcet hel. kor. a vzd. hm.) zemˇepisná délka pozorovacího stanovištˇe (kladná na východ od Greenwiche) zemˇepisná šíˇrka pozorovacího stanovištˇe (kladná na sever od rovníku) (poloha pozorovatele je vyžadována pouze pro výpoˇcet vzdušné hmoty) jméno souboru s parametry (ekvivalent k ’par=’)
Konfiguraˇcní soubory: munilist.ini
Pˇríklad: Následující pˇríkaz sestaví tabulku jasností hvˇezdy 2 (uložené ve vstupních souborech na druhém místˇe) s použitím srovnávací hvˇezdy 3. Výstup bude ve struˇcném formátu; hvˇezdná velikost promˇenné, uvedená ve sloupci (V-C) bude relativní v˚ucˇ i srovnávací hvˇezdˇe. C:\cmunipack\bin>munilist 2 3 test1.mat test2.mat test3.mat test1.mat test2.mat test3.mat C:\cmunipack\bin>type data.dat JD V-C s1 Aperture: 2.00, Filter: Clear 2452909.31733 -0.134 0.004 2452909.33373 -0.147 0.004 2452909.35161 -0.164 0.004 C:\Munipack\bin>_
3.3 Ostatní programy 3.3.1 Autoflat (skládání svˇetlých snímku) ˚ Program Autoflat provádí skládání nˇekolika svˇetlých korekˇcních snímk˚u do jednoho „pr˚umˇerného“ snímku (tzv. master-flat). Vstupní soubory se nejprve normalizují na zadanou úroveˇn jasu a po té se pomocí operace medián aplikovaná postupnˇe na všechny obrazové body snímk˚u vytvoˇrí výsledný složený snímek. Pˇri splnˇení urˇcitých pˇredpoklad˚u je možné tímto postupem získat kvalitní svˇetlé snímky a zpˇresnit tak výsledky pozorování. Vstupní soubory musí být ve formátu FITS, výsledný snímek bude uložen ve stejném formátu. Vždy by mˇely být použity pouze snímky poˇrízené se stejným barevným filtrem a délkou expozice. U delších expozicí je vhodné provést pˇredem korekci temným snímkem.
3.3. OSTATNÍ PROGRAMY
39
Parametry:
@dirfile @ par=file out=file image1 ... -ofile -pfile
jméno souboru se seznamem vstupních soubor˚u seznam vstupních soubor˚u se má naˇcíst ze std. vstupu jméno souboru s parametry [autoflat.ini] jméno výstupního souboru [autoflat.fts] jména vstupních soubor˚u jméno výstupního souboru (ekvivalent k out=) jméno souboru s parametry (ekvivalent k ’par=’)
Konfiguraˇcní soubory: Žádné
Pˇríklad: Následující pˇríkaz spoˇcítá medián snímk˚u test1.fts, test2.fts a test3.fts; výsledek normalizuje na úroveˇn 10000 ADU a uloží do souboru autoflat.fts.
C:\Munipack\bin>autoflat test1.fts test2.fts test3.fts Image file : test1.fts Median : 459.0565 Skysig : 18.4670 ------------------------------Image file : test2.fts Median : 475.4877 Skysig : 18.6898 ------------------------------Image file : test3.fts Median : 496.4252 Skysig : 18.0923 ------------------------------Output file : autoflat.fts Final median : 10350.3 Final skysig : 9.8 C:\Munipack\bin>_
3.3.2 Meandark (skládání temných snímku) ˚ Program Meandark provádí skládání nˇekolika temných korekˇcních snímk˚u do jednoho snímku, tzv. master-dark. Tímto postupem lze snížit šum snímku a tím zpˇresnit výsledek fotometrie. Pro každý obrazový bod výstupního snímku se vypoˇcítá medián odpovídajících obrazových bod˚u na vstupních snímcích. Vstupní soubory musí být ve formátu FITS, výsledný snímek bude uložen ve stejném formátu. Vždy by mˇely být použity pouze snímky poˇrízené se stejnou délkou expozice.
Parametry:
@dirfile @ out=file image1 ... -ofile
jméno souboru se seznamem vstupních soubor˚u seznam vstupních soubor˚u se má naˇcíst ze std. vstupu jméno výstupního souboru, [meandark.fts] jména vstupních soubor˚u jméno výstupního souboru (ekvivalent k ’out=’)
Konfiguraˇcní soubory: Žádné
40
ˇ ˇ ˇ 3. PROGRAMY SPOUŠTENÉ Z PRÍKAZOVÉ RÁDKY
Pˇríklad: Následující pˇríkaz spoˇcítá pr˚umˇer snímk˚u test1.fts, test2.fts a test3.fts a výstup uloží do souboru meandark.fts. C:\Munipack\bin>meandark test1.fts test2.fts test3.fts MEANDARK Version 1.0.10 ------------------------------Image file : test1.fts ------------------------------Image file : test2.fts ------------------------------Image file : test3.fts ------------------------------Output file : meandark.fts C:\Munipack\bin>_
3.3.3 Helkor (heliocentrická korekce) Program Helkor pˇrevádí geocentrické juliánské datum (jdgeo) na heliocentrické datum (jdhel) a zpˇet. Program pracuje bud’to v dávkovém režimu, ve kterém pˇrevede tabulku uloženou v textovém formátu v souboru, nebo v terminálovém režimu, kdy uživatel vkládá data a nˇekolik jednoduchých pˇríkaz˚u z klávesnice. Pˇri pˇrevodu tabulky v souboru program oˇcekává hodnotu JD v prvním sloupci každého ˇrádku, v plném nebo zkráceném tvaru. Desetinná místa musí být oddˇelena teˇckou. Do výstupu program uloží beze zmˇeny ˇrádky, které neobsahují na zaˇcátku platnou hodnotu JD. V ostatních ˇrádcích vypoˇcte heliocentrickou korekci, podle nastavení pˇrepínaˇcu˚ zmˇení datum a do výstupu uloží nové JD v p˚uvodním formátu (dodrží plný nebo zkrácený formát a poˇcet desetinných míst), za které pˇripojí zbytek ˇrádku ze vstupu. V terminálovém režimu program zobrazí výzvu a cˇ eká na vstup od uživatele. Nejprve je nutné specifikovat souˇradnice pozorovaného objektu pomocí rektascenze (R.A.) a potvrdit klávesou Enter. Stejným zp˚usobem se zadává i hodnota deklinace (DEC.). Program vždy jako odpovˇed’ na zadaný pˇríkaz vypíše zadanou hodnotu ve formátu hh mm dd respektive +ddd mm ss. Po zadání souˇradnic program oˇcekává zadání juliánského data pozorování (JDgeo nebo JDhel). Po potvrzení klávesou Enter program spoˇcítá a vypíše hodnotu heliocentrické korekce, geocentrické a heliocentrické datum v juliánském i obˇcanském tvaru. Pro zmˇenu souˇradnic lze použít nˇekolik jednoduchých pˇríkaz˚u, které jsou uvedeny v následující tabulce. Zadáním pˇríkazu q se program ukonˇcí. Parametry: @dirfile @ mask=mask file1 ... ra=hhmmss de=+ddmmss -omask -cx -r
jméno souboru se seznamem vstupních soubor˚u seznam vstupních soubor˚u se má naˇcíst ze std. vstupu maska jmen výstupních soubor˚u [hkor????.dat] jména vstupních soubor˚u rektascenze objektu (hhmmss nebo hhmm) deklinace objektu (ddmmss, ddmm, +ddmmss nebo +ddmm) maska jmen výstupních soubor˚u (ekvivalent k ’mask=’) poˇcáteˇcní hodnota cˇ ítaˇce soubor˚u [1] obrácený pˇrevod (jdhel → jdgeo)
Konfiguraˇcní soubory: Žádné Pˇríkazy terminálového režimu: r n ra hhmm de ddmm
Nastaví pˇrevádˇení jdhel → jdgeo Nastaví pˇrevádˇení jdgeo → jdhel Nastaví rektascenzi objektu (hhmmss nebo hhmm) Nastaví deklinaci objektu (ddmm, ddmmss, +ddmm nebo +ddmmss)
41
3.3. OSTATNÍ PROGRAMY
h nebo ? Vytiskne struˇcnou nápovˇedu prázdný rˇádek Vytiskne aktuální nastavení q Konec programu
Pˇríklad 1: Program pˇrevede geocentrická juliánská data v souboru data.dat na heliocentrická a výstup uloží do souboru helioc.dat. Souˇradnice pozorovaného objektu jsou α = 22h 00m , δ = +58◦ 100.
C:\cmunipack\bin>helkor mask=helioc.dat ra=2200 de=5810 data.dat HELKOR Version 1.0.17 data.dat -> helioc.dat C:\cmunipack\bin>type data.dat JD V-C s1 V-C1 s2 V-C2 s3 C-C1 s4 Aperture: 2.00, Filter: Clear 2452909.31733 -0.134 0.004 -0.212 2452909.33373 -0.147 0.004 -0.220 2452909.35161 -0.164 0.004 -0.236 C:\cmunipack\bin>type helioc.dat JD V-C s1 V-C1 s2 V-C2 s3 C-C1 s4 Aperture: 2.00, Filter: Clear 2452909.31478 -0.134 0.004 -0.212 2452909.33118 -0.147 0.004 -0.220 2452909.34906 -0.164 0.004 -0.236
C-C2 s5 C1-C2 s6 0.004 ... 0.004 ... 0.004 ...
C-C2 s5 C1-C2 s6 0.004 ... 0.004 ... 0.004 ...
C:\Munipack\bin>_
Pˇríklad 2: Pˇrevod GJD = 2452909.31733 na heliocentrické juliánské datum a zpˇet pomocí terminálového režimu. Souˇradnice pozorovaného objektu jsou α = 22h 00m , δ = +58◦ 100 .
C:\Munipack\bin>helcor helcor (C-Munipack) 1.1.8 This is terminal mode. Enter ’h’ command for help or ’q’ for exit. Object’s coordinates have not been set yet. R.A.:2200[Enter] R.A. = 22 00 00 DEC.:+5810[Enter] DEC. = +58 10 00 JDgeo:2452909.31733[Enter] -----------------------------------------------JD (geoc.) : 2452909.31733 Date & time : 2003-09-26 19:36:57.312 UT Hel. corr. : 0.00267 d = 3 min 50.909 s JD (hel.) : 2452909.32000 Date & time : 2003-09-26 19:40:48.221 UT -----------------------------------------------JDhel:q[Enter] Exiting terminal mode. C:\Munipack\bin>_
3.3.4 Munifind (hledání promˇenných hvˇezd) Program Munifind je pom˚ucka pro vyhledávání promˇenných hvˇezd. Program naˇcte údaje o jasnosti hvˇezd na všech snímcích a sestaví tabulku, která obsahuje stˇrední jasnost každé hvˇezdy a její standardní odchylku. Jasnosti hvˇezd se poˇcítají vždy jako relativní v˚ucˇ i jedné srovnávací hvˇezdˇe. Tu je možné urˇcit expliticnˇe pomocí parametr˚u nebo ji program urˇcí automaticky. Vstupní fotometrické soubory musí být složené, napˇríklad programem Munimatch. Výstupem je textový soubor s tabulkou, ve které ˇrádky odpovídají hvˇezdám ve fotometrických souborech ve stejném poˇradí.
42
ˇ ˇ ˇ 3. PROGRAMY SPOUŠTENÉ Z PRÍKAZOVÉ RÁDKY
Parametry: @dirfile @ src=file ref=n thr=x par=file out=file ap=file image1 ... -ofile -afile -pfile
jméno souboru se seznamem vstupních soubor˚u seznam vstupních soubor˚u se má naˇcíst ze std. vstupu použít vstupní soubor ve formátu Readall poˇradí srovnávací hvˇezdy [autodetekce] práh v procentech [60] soubor s parametry [munifind.ini] jméno výstupního souboru, [munifind.dat] cˇ íslo clonky [1] jména vstupních soubor˚u jméno výstupního souboru (ekvivalent k ’out=’) jméno vstupního souboru (ekvivalent k ’src=’) jméno souboru s parametry (ekvivalent k ’par=’)
Konfiguraˇcní soubory: munifind.ini
Pˇríklad: Následující pˇríkaz sestaví tabulku pro hledání promˇenných hvˇezd z fotometrických soubor˚u test1.mat, test2.mat a test3.mat. C:\Munipack\bin>munifind test1.mat test2.mat test3.mat test1.mat test2.mat test3.mat --------------------------------------------Number of analyzed stars: 588 (+ reference star #1) Number of source files: 3 Total number of data points: 1013 Reference star used: 1 Reference star errors: 0 (0%) Number of good points required: 2 Number of stars written to output: 347 (59%) Number of points ruled out: 0 (0%) --------------------------------------------Output file: munifind.dat C:\Munipack\bin>_
3.3.5 Airmass (Výpoˇcet koeficientu vzdušné hmoty) Program Airmass poˇcítá pro zadané juliánské datum a souˇradnice objektu a pozorovatele odpovídající koeficient vzdušné hmoty. Program m˚uže pracovat bud’to v dávkovém režimu, ve kterém pˇrevede tabulku uloženou v textovém formátu v souboru (napˇr. výstup z programu Muniwin), nebo v terminálovém režimu, kdy uživatel vkládá data pomocí nˇekolika jednoduchých pˇríkaz˚u z klávesnice. Pˇri pˇrevodu tabulky v souboru program oˇcekává hodnotu JD v prvním sloupci každého ˇrádku, v plném nebo zkráceném tvaru. Desetinná místa musí být oddˇelena teˇckou. Do výstupu program uloží beze zmˇeny ˇrádky, které nejsou záhlavím tabulky nebo neobsahují na zaˇcátku platnou hodnotu JD. V ostatních ˇrádcích vypoˇcte hodnotu koeficientu vzdušné hmoty a tuto hodnotu pˇripojí jako poslední sloupec do tabulky. Na ˇrádek se záhlavím tabulky se na konec doplní jeden sloupec s názvem AIRMASS. V terminálovém režimu program zobrazí výzvu a cˇ eká na vstup od uživatele. Nejprve je nutné specifikovat rektascenzi pozorovaného objektu a potvrdit klávesou Enter. Stejným zp˚usobem se zadává i hodnota deklinace (DEC.). Program vždy jako odpovˇed’ na zadaný pˇríkaz vypíše zadanou hodnotu ve formátu hh mm dd respektive +ddd mm ss. Stejným postupem se specifikuje také poloha pozorovatele pomocí zemˇepisné délky (LON.) a šíˇrky (LAT.). Kladná zemˇepisná šíˇrka se poˇcítá smˇerem na východ od nultého poledníku. Po zadání všech souˇradnic program oˇcekává zadání juliánského data pozorování (JD). Po potvrzení klávesou Enter program spoˇcítá a vypíše azimut, úhlovou výšku objektu a koeficient vzdušné hmoty. Pro zmˇenu souˇradnic lze použít nˇekolik jednoduchých pˇríkaz˚u, které jsou uvedeny v následující tabulce. Zadáním pˇríkazu q se program ukonˇcí.
3.3. OSTATNÍ PROGRAMY
43
Parametry: @dirfile @ mask=mask file1 ... ra=hhmmss dec=+ddmmss lon=+dddmmss lat=+dddmmss -omask -cx
jméno souboru se seznamem vstupních soubor˚u seznam vstupních soubor˚u se má naˇcíst ze std. vstupu maska jmen výstupních soubor˚u [amass????.dat] jména vstupních soubor˚u rektascenze objektu deklinace objektu délka pozorovatele šíˇrka pozorovatele maska jmen výstupních soubor˚u (ekvivalent k ’mask=’) poˇcáteˇcní hodnota cˇ ítaˇce soubor˚u [1]
Konfiguraˇcní soubory: Žádné Pˇríkazy terminálového režimu: ra hhmmss dec +ddmmss lon +dddmmss lat +dddmmss h nebo ? prázdný rˇádek q
Nastaví rektascenzi objektu Nastaví deklinaci objektu Nastaví délku pozorovatele Nastaví šíˇrku pozorovatele Vytiskne struˇcnou nápovˇedu Vytiskne aktuální nastavení Konec programu
Pˇríklad 1: Program doplní hodnoty koeficientu vzdušné hmoty do tabulky v souboru data.dat s pozorováním hvˇezdy V1011 Her (α = 18h 29m 32s , δ = +22◦ 340 2400 ) a výsledek uloží do souboru ˇ amass0001.dat. Pozorovatel se nachází v Brnˇe, Ceská republika (λ = 16◦ 400 = 16.6667◦ východnˇe od ◦ 0 ◦ nultého poledníku, φ = 49 13 = 49.2167 severnˇe od rovníku). C:\cmunipack\bin>airmass lon=16.6667 lat=49.2167 ra=182932 dec=223424 data.dat airmass (C-Munipack) 1.1.7 data.dat -> amass0001.dat C:\cmunipack\bin>type data.dat JD V-C s1 V-C1 s2 V-C2 s3 C-C1 s4 C-C2 s5 C1-C2 s6 Aperture: 1, Filter: I, JD: geocentric 2453868.39368 -1.164 0.017 -1.750 0.025 ... 2453868.39484 -1.191 0.018 -1.706 0.025 ... 2453868.39598 -1.138 0.017 -1.736 0.026 ... C:\cmunipack\bin>type amass0001.dat JD V-C s1 V-C1 s2 V-C2 s3 C-C1 s4 C-C2 s5 C1-C2 s6 AIRMASS Aperture: 1, Filter: I, JD: geocentric 2453868.39368 -1.164 0.017 -1.750 0.025 ... 1.949 2453868.39484 -1.191 0.018 -1.706 0.025 ... 1.933 2453868.39598 -1.138 0.017 -1.736 0.026 ... 1.918 C:\Munipack\bin>_
Pˇríklad 2: Výpoˇcet hodnoty koeficientu vzdušné hmoty pro hvˇezdu V1011 Her (α = 18h 29m 32s , ˇ δ = +22◦ 3402400 ), pozorovatele nacházejícího se v Brnˇe, Ceská republika (λ = 16◦ 400 = 16.6667◦ vý◦ 0 ◦ chodnˇe od nultého poledníku, φ = 49 13 = 49.2167 severnˇe od rovníku). Juliánské datum pozorování je 2453868.39368 UT. C:\cmunipack\bin>airmass airmass (C-Munipack) 1.1.7 This is terminal mode. Enter ’h’ command for help or ’q’ for exit.
44 Object’s coordinates have not been set yet. R.A.:182932[Enter] R.A. = 18 29 32 DEC.:223424[Enter] DEC. = +22 34 24 LON.:16.6667[Enter] LON. = E 16 40 00 LAT.:49.2167[Enter] LAT. = N 49 13 00 JD:2453868.39368[Enter] -----------------------------------------------Julian date: 2453868.3937 Date & time: 2006-05-12 21:26:53.952 UT Az. & alt. : 270 22 45 (E), 30 47 18 Airmass (X): 1.949 -----------------------------------------------JD:q[Enter] Exiting terminal mode. C:\Munipack\bin>_
ˇ ˇ ˇ 3. PROGRAMY SPOUŠTENÉ Z PRÍKAZOVÉ RÁDKY
4
Knihovna C-Munipack
Veškeré funkce provádˇející operace s daty jsou soustˇredˇeny do dynamicky linkované knihovny. Ta je využívána zejména programem Muniwin, který poskytuje grafické rozhraní pro volání jednotlivých funkcí. Knihovna je urˇcena také všem vývojáˇru˚ m, kteˇrí chtˇejí pro zpracování svých pozorování vytvoˇrit specializované uživatelské rozhraní. Na operaˇcních systémech Windows se binární kód knihovny pˇreloží do souboru cmunipack.dll. Pro manipulaci se soubory ve formátu FITS využívá knihovna funkcí z dynamicky linkované knihovny Fitsio. Je proto nutné, aby soubor cfitsio.dll byl umístˇen nˇekde, kde jej systém m˚uže nalézt, nejlépe ve stejném adresáˇri jako cmunipack.dll. Pˇri pˇrekladu pomocí pˇrekladaˇce gcc se vytvoˇrí také importní knihovna, zjednodušující sestavení uživatelského programu. Na ostatních operaˇcních systémech (Linux apod.) se obvykle využívá odlišný systém dynamicky linkovaných knihoven. Binární kód knihovny je sestaven do souboru libcmunipack.
.so a pˇri sestavení uživatelského programu provede pˇrekladaˇc automaticky potˇrebné navázání. Také v tomto pˇrípadˇe je nutné mít nainstalovanou knihovnu cfitsio. Definice použitých datových typ˚u, konstant a prototypy veˇrejných funkcí jsou pˇrístupné v hlaviˇckovém souboru cmunipack.h.
4.1
Funkce pro obecné použití
void cmpack_getversionid(char *buf, int buflen); Do alokované pamˇeti uloží text s verzí knihovny. V parametru buf se pˇredává odkaz na alokovanou pamˇet’ pro uložení ˇretˇezce, buflen je velikost alokovaného prostoru v bytech. void cmpack_formaterror(char *buf, int buflen, int code); Pˇrekládá cˇ íselný chybový kód do textového tvaru. Parametr buf je odkaz na alokovanou pamˇet’ pro uložení ˇretˇezce, buflen je velikost bufferu v bytech. Parametr code urˇcuje chybový kód. Funkci lze použít pouze pro pˇreklad chybových kód˚u C-Munipacku (>1000), knihovna Fitsio má svou vlastní funkci pro pˇreklad chybových kód˚u. int cmpack_setoutput(cmpack_cbtype *cbproc, int level); Nastavuje zp˚usob vypisování hlášení. Všechny výpisy jsou pˇredávány pomocí funkce zpˇetného volání. Funkce zpracovávající zpˇetné volání musí mít jeden parametr typu const char *, ve kterém se pˇredává ˇretˇezec se zprávou. Volaný proces nesmí alokovanou pamˇet’ uvolˇnovat. Funkce nevrací žádnou návratovou hodnotu. V prvním parametru funkce cmpack_setoutput se pˇredává ukazatel na funkci, která musí být typu cmpack_cbtype. Je-li hodnota parametru NULL, všechna hlášení se budou zahazovat. Hlášení se nezpracovávají také do prvního volání funkce. Druhým parametrem se specifikuje úroveˇn hlášení, viz konstanty MPK_LEVEL_xxx. Funkce vrací pˇredchozí úroveˇn hlášení.
4.1.1 Funkce pro pˇrevod souˇradnic int cmpack_strtora(const char *buf, double *ra); Pˇrevádí ˇretˇezcový zápis rektascenze objektu na reálné cˇ íslo v úhlových hodinách. Parametr buf je odkaz na vstupní ˇretˇezec ukonˇcený nulovým znakem, v druhém parametru se pˇredává odkaz na promˇennou, do které se má uložit výsledná hodnota. Pokud došlo k chybˇe, pˇredá jako návratovou hodnotu chybový kód MPK_INVALID_PAR, v pˇrípadˇe úspˇechu vrací nulu. Povolené formáty jsou hh mm ss.s, hhmmss.s nebo hh.hhhhh.
46
4. KNIHOVNA C-MUNIPACK
int cmpack_strtodec(const char *buf, double *dec); Pˇrevádí ˇretˇezcový zápis deklinace objektu na reálné cˇ íslo v úhlových stupních. Parametr buf je odkaz na vstupní ˇretˇezec ukonˇcený nulovým znakem, v druhém parametru se pˇredává odkaz na promˇennou, do které se má uložit výsledná hodnota. Pokud došlo k chybˇe, pˇredá jako návratovou hodnotu chybový kód MPK_INVALID_PAR. Povolené formáty jsou -ddd mm ss.s, -dddmmss.s nebo -dd.dddd. void cmpack_ratostr(double ra, char *buf); Pˇrevádí rektascenzi objektu v úhlových hodinách na ˇretˇezec. Parametr ra je vstupní hodnota, v druhém parametru se pˇredává odkaz na alokovanou pamˇet’ (alespoˇn 9 byt˚u), do které se uloží rektascenze ve formátu hh mm ss. void cmpack_dectostr(double dec, char *buf); Pˇrevádí deklinaci objektu v úhlových stupních na ˇretˇezec. Parametr dec je vstupní hodnota, v druhém parametru se pˇredává odkaz na alokovanou pamˇet’ (alespoˇn 11 byt˚u), do které se uloží deklinace ve formátu +ddd mm ss. int cmpack_strtolat(const char *buf, double *lat); Pˇrevádí ˇretˇezcový zápis zemˇepisné šíˇrky na reálné cˇ íslo v úhlových stupních. Parametr buf je odkaz na vstupní ˇretˇezec ukonˇcený nulovým znakem, v druhém parametru se pˇredává odkaz na promˇennou, do které se má uložit výsledná hodnota. Pokud došlo k chybˇe, pˇredá jako návratovou hodnotu chybový kód MPK_INVALID_PAR. Povolené formáty jsou N dd mm ss, Nddmmss, +dd mm ss, +ddmmss, +dd.dddd, S dd mm ss, Sddmmss, -dd mm ss, -ddmmss nebo -dd.dddd. Kladné hodnoty šíˇrky jsou smˇerem na sever a záporné smˇerem na jih od rovníku. int cmpack_strtolon(const char *buf, double *lon); Pˇrevádí rˇetˇezcový zápis zemˇepisné délky na reálné cˇ íslo v úhlových stupních. Parametr buf je odkaz na vstupní rˇetˇezec ukonˇcený nulovým znakem, v druhém parametru se pˇredává odkaz na promˇennou, do které se má uložit výsledná hodnota. Pokud došlo k chybˇe, pˇredá jako návratovou hodnotu chybový kód MPK_INVALID_PAR. Povolené formáty jsou E ddd mm ss, Edddmmss, +ddd mm ss, +dddmmss, +ddd.dddd, W ddd mm ss, Wdddmmss, -ddd mm ss, -dddmmss nebo -ddd.dddd. Kladné hodnoty jsou smˇerem na východ a záporné smˇerem na západ od nultého poledníku. void cmpack_lattostr(double lat, char *buf); Pˇrevádí zemˇepisnou šíˇrku objektu v úhlových stupních na ˇretˇezec. Parametr dec je vstupní hodnota, v druhém parametru se pˇredává odkaz na alokovanou pamˇet’ (alespoˇn 11 byt˚u), do které se uloží šíˇrka ve formátu D dd mm ss. void cmpack_lontostr(double lon, char *buf); Pˇrevádí zemˇepisnou délku objektu v úhlových stupních na ˇretˇezec. Parametr dec je vstupní hodnota, v druhém parametru se pˇredává odkaz na alokovanou pamˇet’ (alespoˇn 12 byt˚u), do které se uloží délka ve formátu D ddd mm ss. void cmpack_aztostr(double az, char *buf); Pˇrevádí azimut objektu v úhlových stupních na rˇetˇezec. Parametr az je vstupní hodnota, v druhém parametru se pˇredává odkaz na alokovanou pamˇet’ (alespoˇn 16 byt˚u), do které se uloží azimut ve formátu ddd mm ss (XXX). void cmpack_alttostr(double alt, char *buf); Pˇrevádí úhlovou výšku objektu v úhlových stupních na ˇretˇezec. Parametr alt je vstupní hodnota, v druhém parametru se pˇredává odkaz na alokovanou pamˇet’ (alespoˇn 10 byt˚u), do které se uloží azimut ve formátu -dd mm ss.
4.1. FUNKCE PRO OBECNÉ POUŽITÍ
4.1.2
47
Funkce pro pˇrevod data a cˇ asu
void cmpack_strtodate(const char *datestr, int *year, int *month, int *day); Pˇrevádí ˇretˇezcový zápis data na celoˇcíselné hodnoty. Parametr datestr je odkaz na vstupní ˇretˇezec ukonˇcený nulovým znakem. V dalších tˇrech parametrech se pˇredávají zpˇet roky, mˇesíce a dny. Povolený formát: YYYY-MM-DD. void cmpack_strtotime(const char *timestr, int *hour, int *minute, int *second, int *milisecond); Pˇrevádí rˇetˇezcový zápis cˇ asu na celoˇcíselné hodnoty. Parametr timestr je odkaz na vstupní rˇetˇezec ukonˇcený nulovým znakem. V dalších cˇ tyˇrech parametrech se pˇredávají zpˇet hodiny, minuty, sekundy a milisekundy. Povolené formáty: HH:MM:SS nebo HH:MM:SS.SSS. double cmpack_strtojd(const char *datestr, const char *timestr); Pˇrevádí ˇretˇezcové zápisy data a cˇ asu na juliánské datum ve formˇe reálného cˇ ísla. Parametr datestr je ˇ ezce musí odkaz na ˇretˇezec obsahující datum, parametr timestr je odkaz na ˇretˇezec obsahující cˇ as. Retˇ být zakonˇceny nulovým znakem. Funkce vrací juliánské datum nebo 0 pokud bˇehem pˇrevodu došlo k chybˇe. Povolené formáty: YYYY-MM-DD pro datum a HH:MM:SS nebo HH:MM:SS.SSS pro cˇ as. double cmpack_encodejd(int year, int month, int day, int hour, int minute, int second, int milisecond); Pˇrevádí cˇ íselný zápis data a cˇ asu na juliánské datum ve formˇe reálného cˇ ísla. Parametry funkce specifikují datum a cˇ as v rocích, mˇesících, dnech, hodinách, minutách, sekundách a milisekundách. Funkce vrací juliánské datum nebo 0 pokud bˇehem pˇrevodu došlo k chybˇe. void cmpack_datetostr(int year, int month, int day, char *datestr); Pˇrevádí cˇ íselný zápis data na ˇretˇezec. První tˇri parametry specifikují datum v rocích, mˇesících a dnech. V parametru datestr se pˇredává odkaz na alokovanou pamˇet’ (alespoˇn 11 byt˚u), do které se uloží datum ve formátu YYYY-MM-DD. void cmpack_timetostr(int hour, int minute, int second, int msec, char *timestr); Pˇrevádí cˇ íselný zápis cˇ asu na rˇetˇezec. První cˇ tyˇri parametry specifikují cˇ as v hodinách, minutách, sekundách a milisekundách. V parametru timestr se pˇredává odkaz na alokovanou pamˇet’ (alespoˇn 13 byt˚u), do které se uloží cˇ as ve formátu HH:MM:SS.SSS. void cmpack_decodejd(double jd, int *year, int *month, int *day, int *hour, int *minute, int *second, int *milisecond); Pˇrevádí juliánské datum ve formˇe reálného cˇ ísla na cˇ íselný zápis data a cˇ asu. První parametr je datum a cˇ as ve formˇe juliánského data, v následujících parametrech se pˇredávají odkazy na promˇenné, do kterých se uloží datum v rocích, mˇesících a dnech a cˇ as v hodinách, minutách, sekundách a milisekundách. void cmpack_jdtostr(double jd, char *datestr, char *timestr); Pˇrevádí juliánské datum ve formˇe reálného cˇ ísla na ˇretˇezcový zápis data a cˇ asu. První parametr je datum a cˇ as ve formˇe juliánského data, v následujících parametrech se pˇredávají odkazy na dvˇe alokované pamˇeti (alespoˇn 11 a 13 byt˚u), do kterých se uloží datum ve formátu YYYY-MM-DD a cˇ as ve formátu HH:MM:SS.SSS.
48
4.1.3
4. KNIHOVNA C-MUNIPACK
Matematické funkce
void cmpack_robustmean(int n, float *A, float *mean, float *sig); Výpoˇcet robustní stˇrední hodnoty z n hodnot uložených v poli A. Do parametru mean se uloží vypoˇctená stˇrední hodnota, do sig se zapíše smˇerodatná odchylka. void cmpack_fastsky(int nx, int ny, float *ccd, int nmax, float lobad, float hibad, float *skymed, float *skysig); Funkce poˇcítá odhad stˇrední úroveˇn jasu oblohy na snímku pomocí operace medián a její smˇerodatnou odchylku. Výsledkem je pouze rychlý odhad, protože pro výpoˇcet nepoužívá všechny obrazové body snímku, ale jen maximálnˇe nmax bod˚u. Body, které mají být zahrnuty do výpoˇctu se vybírají pravidelnˇe, potˇrebný krok si funkce sama vypoˇcítá. Vyˇrazují se všechny body, jejichž hodnota je menší nebo rovna lobad nebo vˇetší nebo rovna hibad. V parametrech nx a ny se pˇredává rozmˇer snímku v bodech, hodnoty jsou uloženy v poli ccd. Vypoˇctené hodnoty se pˇredávají pomocí parametr˚u skymed (stˇrední hodnota) a skysig (smˇerodatná odchylka). void cmpack_fullsky(int nx, int ny, float *ccd, float *skymed, float *skysig); Funkce poˇcítá stˇrední úroveˇn jasu oblohy na snímku pomocí robustní stˇrední hodnoty a její standardní odchylku. Narozdíl od pˇredchozí funkce používá pˇri výpoˇctu všechny obrazové body snímku. V parametrech nx a ny se pˇredává rozmˇer snímku v bodech, hodnoty jsou uloženy v poli ccd. Vypoˇctené hodnoty se pˇredávají pomocí parametr˚u skymed (stˇrední hodnota) a skysig (smˇerodatná odchylka).
4.1.4
Astronomické funkce
double cmpack_siderealtime(double jd); Poˇcítá stˇrední hvˇezdný cˇ as pro nultý poledník (S). Vstupním parametrem funkce je datum a cˇ as ve formˇe juliánského data. Výsledkem výpoˇctu je hvˇezdný cˇ as ve dnech(!). double cmpack_airmass(double jd, double obj_ra, double obj_dec, double obs_lon, double obs_lat); Poˇcítá koeficient vzdušné hmoty (X). Vstupními parametry funkce jsou datum a cˇ as ve formˇe juliánského data, rovníkové souˇradnice pozorovaného objektu (v úhlových hodinách a stupních) a zemˇepisné souˇradnice pozorovatele (v úhlových stupních). Výsledek funkce je kladný, je-li objekt nad obzorem nebo záporná, je-li pod obzorem. void cmpack_rdtolb(double obj_ra, double obj_de, double *obj_la, double *obj_be); Pˇrevádí rovníkové souˇradnice na ekliptikální souˇradnice. Vstupními parametry funkce jsou rovníkové souˇradnice pozorovaného objektu (v úhlových hodinách a stupních), další dva parametry odkazují na promˇenné, do kterých se uloží ekliptikální souˇradnice (obˇe v úhlových stupních). void cmpack_sun(double jd, double *sun_ls, double *sun_rs); Poˇcítá polohu Slunce na obloze. Vstupním parametrem funkce je datum a cˇ as ve formˇe juliánského data, další dva parametry odkazují na promˇenné, do kterých se uloží ekliptikální délka Slunce ve stupních a vzdálenost Slunce od Zemˇe v astronomických jednotkách. double cmpack_hcor(double obj_la, double obj_be, double sun_ls, double sun_rs); Funkce poˇcítá hodnotu heliocentrické korekce pro daný objekt. Vstupními parametry funkce jsou ekliptikální souˇradnice pozorovaného objektu ve stupních, ekliptikální délka Slunce ve stupních a vzdálenost Slunce od Zemˇe v astronomických jednotkách. Výsledek výpoˇctu je ve dnech.
˚ 4.2. FUNKCE PRO REDUKCI SNÍMKU
49
4.2 Funkce pro redukci snímku˚ 4.2.1 Konverze snímku˚ do pracovního formátu Funkce používané pˇri konverzi snímk˚u do pracovního formátu FITS, jednotné rozhraní pro získávání obrazových dat a informací. int konv_format(const char *filename, int *format); Funkce otevˇre soubor filename a zjistí, zda soubor je v nˇekterém z podporovaných formát˚u (v souˇcasné ˇ dobˇe SBIG a FITS). Císlo formátu vrací v parametru format. Pokud došlo k chybˇe, pˇredá jako návratovou hodnotu odpovídající chybový kód. ˇ Císla formát˚u jsou definovány v hlaviˇckovém souboru comfun.h a jsou také uvedeny v pˇríloze. int konv_init(const char *parfile, int flipx, int flipy, long tcor, int mode); Voláním této funkce se inicializuje pˇrevod snímk˚u do pracovního formátu. Funkce pˇreˇcte obsah konfiguraˇcního souboru a nastaví hodnoty interních promˇenných. Na konci procesu je nutné alokovanou pamˇet’ uvolnit zavoláním funkce konv_clean. Pokud došlo k chybˇe, pˇredá funkce jako svou návratovou hodnotu odpovídající chybový kód. Jméno konfiguraˇcního souboru se pˇredává v parametru parfile. Tento soubor m˚uže obsahovat dodateˇcné parametry, které mají být uloženy do výstupního souboru. Parametry flipx resp. flipy urˇcují, zda se má snímek pˇrevrátit podle svislé resp. vodorovné osy. Parametr tcor je cˇ asová korekce okamžiku pozorování v sekundách, standardnˇe je jeho hodnota 0. Mode urˇcuje režim práce, odpovídající konstanty jsou definovány hlaviˇckovém souboru comfun.h. int konv(const char *in, const char *out); Provede pˇrevod snímku v souboru in do souboru out. Vstupní soubor m˚uže být v libovolném podporovaném formátu, výstupní snímek je vždy ve formátu FITS. int konv_clean(void); Uvolní pamˇet’ alokovanou v interních strukturách funkcemi konv_init a konv. Typická posloupnost volání pˇri konverzi množiny zdrojových snímk˚u vypadá následovnˇe: (Jména zdrojových resp. cílových soubor˚u jsou uložena v poli in resp. out.) konv_init(NULL, 0, 0, 0, 0, NULL); for (i=0;i
int konv_open(void **handle, const char *filename); Funkce otevˇre vstupní soubor se snímkem. Jméno vstupního souboru se pˇredává v parametru filename. Automaticky detekuje formát souboru. Pokud akce probˇehla v poˇrádku, alokuje interní strukturu umožˇnující pˇrístup k dat˚um a ukazatel na tuto strukturu uloží do promˇenné, jejíž adresa byla pˇredána v parametru handle, a vrací nulu. V pˇrípadˇe chyby je návratový kód nenulový a do ukazatele se uloží hodnota NULL. K prvk˚um interní struktury lze pˇristupovat pouze pomocí následujících veˇrejných funkcí. Po skonˇcení práce je nutné alokovanou pamˇet’ uvolnit voláním funkce konv_close. int konv_openf(void **handle, const char *filename, int format); Funkce otevˇre vstupní soubor se snímkem. Jméno vstupního souboru se pˇredává v parametru filename, konstantu urˇcující formát souboru je nutné pˇredat v parametru format. Pokud akce probˇehla v poˇrádku, alokuje interní strukturu umožˇnující pˇrístup k dat˚um a ukazatel na tuto strukturu uloží do promˇenné, jejíž adresa byla pˇredána v parametru handle, a vrací nulu. V pˇrípadˇe chyby je návratový kód nenulový a do ukazatele se uloží hodnota NULL. K prvk˚um interní struktury lze pˇristupovat pouze pomocí následujících veˇrejných funkcí. Po skonˇcení práce je nutné alokovanou pamˇet’ uvolnit voláním funkce konv_close.
50
4. KNIHOVNA C-MUNIPACK
int konv_gets(void *handle, const char *key, char *buf, int buflen); Vrací textový údaj z hlaviˇcky souboru. V parametru handle se pˇredává ukazatel vrácený nˇekterou z funkcí konv_open*, parametr key specifikuje klíˇc položky. Ukazatel na alokovanou pamˇet’ pro uložení hodnoty se pˇredává v parametru buf a buflen udává velikost tohoto bufferu v bytech. V pˇrípadˇe úspˇechu vrací funkce nulu, v opaˇcném pˇrípadˇe jeden z chybových kód˚u. Kromˇe klíˇcu˚ použitých ve vstupním souboru (jejich jména jsou závislá na použitém formátu) je podporována sada "virtuálních"klíˇcu˚ - viz. tabulka 4.1. int konv_getl(void *handle, const char *key, long *val); Vrací cˇ íselný údaj (celé cˇ íslo) z hlaviˇcky souboru. V parametru handle se pˇredává ukazatel vrácený nˇekterou z funkcí konv_open*, parametr key specifikuje klíˇc položky. Ukazatel na promˇennou, do které se má uložit hodnota promˇenné se pˇredává v parametru val. V pˇrípadˇe úspˇechu vrací funkce nulu, v opaˇcném pˇrípadˇe jeden z chybových kód˚u. Kromˇe klíˇcu˚ použitých ve vstupním souboru (jejich jména jsou závislá na použitém formátu) je podporována sada "virtuálních"klíˇcu˚ - viz. tabulka 4.1. int konv_getd(void *handle, const char *key, double *val); Vrací cˇ íselný údaj (reálné cˇ íslo) z hlaviˇcky souboru. V parametru handle se pˇredává ukazatel vrácený nˇekterou z funkcí konv_open*, parametr key specifikuje klíˇc položky. Ukazatel na promˇennou, do které se má uložit hodnota promˇenné se pˇredává v parametru val. V pˇrípadˇe úspˇechu vrací funkce nulu, v opaˇcném pˇrípadˇe jeden z chybových kód˚u. Kromˇe klíˇcu˚ použitých ve vstupním souboru (jejich jména jsou závislá na použitém formátu) je podporována sada "virtuálních"klíˇcu˚ - viz. tabulka 4.1. Klíˇc _background_ _bitpix_ _date_ _exposure_ _filter_ _height_ _magic_ _range_ _temperature_ _time_ _width_
Datový typ reálné cˇ íslo celé cˇ íslo ˇretˇezec reálné cˇ íslo ˇretˇezec celé cˇ íslo ˇretˇezec reálné cˇ íslo reálné cˇ íslo ˇretˇezec celé cˇ íslo
Význam Úroveˇn pozadí v ADU Poˇcet bit˚u na vzorek (pixel) Datum ve formátu YYYY-MM-DD Délka expozice v sekundách Použitý barevný filtr Výška snímku v pixelech Popis formátu souboru Rozsah hodnot v ADU Teplota cˇ ipu ve stupních Celsia ˇ ve formátu HH:MM:SS.SSS Cas Šíˇrka snímku v pixelech
Tabulka 4.1: Virtuální klíˇce pro cˇ tení informací ze vstupního souboru int konv_gkyn(void *handle, int index, char *key, int keylen, char *val, int vallen, char *com, int comlen); Tato funkce je urˇcena pro pˇreˇctení všech definovaných klíˇcu˚ a jejich hodnot ze vstupního souboru. Formátovˇe nezávislé virtuální klíˇce se ve výˇctu neobjeví. V parametru handle se pˇredává ukazatel vrácený nˇekterou z funkcí konv_open*, index je poˇradí záznamu poˇcítané od 0. Následující parametry specifikují tˇri buffery a jejich délky v bytech, do kterých se uloží klíˇc (key, keylen), hodnota (val, vallen) a poznámka (com, comlen). V pˇrípadˇe úspˇechu vrací funkce nulu, pokud je hodnota index mimo rozsah definovaných položek, vrací funkce nenulovou hodnotu. int konv_g2de(void *handle, float *buf, int flipx, int flipy); Funkce pˇreˇcte ze souboru obrazová data a nakopíruje je do pamˇeti. V parametru handle se pˇredává ukazatel vrácený nˇekterou z funkcí konv_open*. Parametr buf specifikuje ukazatel na alokovaný pamˇet’ový prostor, který musí být dostateˇcnˇe velký pro uložení celého snímku, rozmˇery snímku lze pˇreˇcíst pomocí funkce konv_getl. Je-li parametr flipx nenulový, snímek se pˇri pˇrevodu pˇrevrátí podle svislé osy, podobnˇe nenulová hodnota parametru flipy zp˚usobí pˇrevrácení podle vodorovné osy.
˚ 4.2. FUNKCE PRO REDUKCI SNÍMKU
51
int konv_close(void *handle); Tato funkce uzavírá sekvenci cˇ tení dat ze vstupního souboru. Uvolˇnuje všechny prostˇredky a alokované pamˇeti spojené se vstupním souborem. V parametru handle se pˇredává ukazatel vrácený nˇekterou z funkcí konv_open*, po jejím skonˇcení není ukazatel platný.
ˇ 4.2.2 Casová korekce Funkce pro korekci cˇ asu pozorování. Zdrojové a cílové soubory již musí být pˇrevedeny do pracovního formátu. int tcor_init(long tcor); Voláním této funkce se inicializuje proces korekce cˇ asu. Parametr tcor je poˇcet sekund, o které má být cˇ as pozorování posunut vpˇred (v pˇrípadˇe kladných hodnot) nebo vzad (v pˇrípadˇe záporných hodnot). int tcor(const char *sci, const char *out, char *date, char *time); Voláním této funkce se provede cˇ asová korekce jednoho snímku. Parametr sci je jméno vstupního souboru, výstup se uloží do souboru out. Pokud je parametr out roven NULL, pak se jen zmˇení pˇríslušné ˇrádky v hlaviˇcce vstupního souboru. Jako tˇretí a cˇ tvrtý parametr je možné pˇredat odkazy na alokovanou pamˇet’, do kterých funkce uloží kopii nového data a cˇ as pozorování. Pokud takový výstup není požadován, zapíše se hodnota NULL. int tcor_clean(void); Uvolní pamˇet’ alokovanou v interních strukturách funkcemi tcor_init a tcor.
4.2.3 Korekce temným snímkem Funkce pro korekci temným snímkem. Všechny soubory již musí být pˇrevedeny do pracovního formátu. int dark_init(const char *drk); Voláním této funkce se inicializuje proces korekce temným snímkem. Parametr drk je název souboru, ve kterém je uložen temný snímek. int dark(const char *sci, const char *out); Voláním této funkce se provede korekce jednoho snímku. Parametr sci je jméno vstupního souboru, výstup se uloží do souboru out. Pokud je parametr out roven NULL, pak se výstupem pˇrepíše vstupní soubor. int dark_clean(void); Uvolní pamˇet’ alokovanou v interních strukturách funkcemi dark_init a dark.
4.2.4 Korekce svˇetlým snímkem Funkce pro korekci svˇetlým snímkem. Všechny soubory již musí být pˇrevedeny do pracovního formátu. int flat_init(const char *flt); Voláním této funkce se inicializuje proces korekce svˇetlým snímkem. Parametr flt je název souboru, ve kterém je uložen svˇetlý snímek. int flat(const char *sci, const char *out); Voláním této funkce se provede korekce jednoho snímku. Parametr sci je jméno vstupního souboru, výstup se uloží do souboru out. Pokud je parametr out roven NULL, pak se výstupem pˇrepíše vstupní soubor.
52
4. KNIHOVNA C-MUNIPACK
int flat_clean(void); Uvolní pamˇet’ alokovanou v interních strukturách funkcemi flat_init a flat.
4.2.5 Fotometrie snímku˚ Funkce pro fotometrii snímk˚u. Vstupní soubor musí být v pracovním formátu a musí být provedeny všechny potˇrebné korekce. int mphot_init(const char *optfile, const char *apfile); Voláním této funkce se inicializuje proces fotometrie. Funkce pˇreˇcte obsah konfiguraˇcních soubor˚u a nastaví hodnoty interních promˇenných. Na konci procesu je nutné alokovanou pamˇet’ uvolnit zavoláním funkce mphot_clean. Pokud došlo k chybˇe, pˇredá funkce jako svou návratovou hodnotu odpovídající chybový kód. Jména konfiguraˇcních soubor˚u se pˇredávají pomocí parametr˚u parfile (soubor s parametry) a apfile (pr˚umˇery clonek). Pokud je pˇredána hodnota NULL, program použije pˇreddefinované hodnoty parametr˚u. int mphot(const char *sci, const char *out, double *jd, int *nostar); Voláním této funkce se provede fotometrie jednoho snímku. Parametr sci je jméno vstupního souboru, výstup se uloží do souboru out. Pomocí parametr˚u jd a nostar lze pˇredat reference na promˇenné, do kterých se má uložit cˇ as pozorování (juliánské datum) a poˇcet nalezených a zmˇeˇrených hvˇezd. Pokud takový výstup není požadován, zapíše se hodnota NULL. int mphot_clean(void); Uvolní pamˇet’ alokovanou v interních strukturách funkcí mphot_init.
4.2.6 Skládání fotometrických souboru˚ Funkce pro skládání fotometrických soubor˚u. Vstupní soubor musí být výstup z fotometrie, referenˇcní soubor m˚uže být fotometrický soubor nebo katalogový soubor. int match_init(const char *reffile, const char *optfile); Voláním této funkce se inicializuje proces skládání. Funkce pˇreˇcte obsah referenˇcního a konfiguraˇcního souboru a nastaví hodnoty interních promˇenných. Na konci procesu je nutné alokovanou pamˇet’ uvolnit zavoláním funkce match_clean. Pokud došlo k chybˇe, pˇredá funkce jako svou návratovou hodnotu odpovídající chybový kód. Jméno konfiguraˇcního souboru se pˇredávají pomocí parametr˚u optfile. Pokud je pˇredána hodnota NULL, program použije pˇreddefinované hodnoty parametr˚u. int match(const char *infile, const char *outfile, int *mstar); Voláním této funkce se provede složení jednoho snímku. Parametr in je jméno vstupního souboru, výstup se uloží do souboru out. Pokud je parametr out roven NULL, pak se výstupem pˇrepíše vstupní soubor. Pomocí parametru mstar lze pˇredat referenci na promˇennou, do které se uloží poˇcet hvˇezd, které se podaˇrilo identifikovat. Pokud takový výstup není požadován, zapíše se hodnota NULL. int match_clean(void); Uvolní pamˇet’ alokovanou v interních strukturách funkcí match_init.
˚ 4.2. FUNKCE PRO REDUKCI SNÍMKU
53
4.2.7 Generování výstupního souboru int mlist_init(const char *optfile, int aper, int outfrm, int nstar, int *stars, const char *ra, const char *dec, const char *lon, const char *lat); Funkce inicializuje proces generování výstupního souboru. Pˇreˇcte obsah konfiguraˇcního souboru a nastaví interní promˇenné a alokuje potˇrebnou pamˇet’. Na konci procesu je nutné alokovanou pamˇet’ uvolnit zavoláním funkce match_clean. Pokud došlo k chybˇe, pˇredá funkce jako svou návratovou hodnotu odpovídající chybový kód. Jméno konfiguraˇcního souboru se specifikuje pomocí parametru optfile. Pokud je pˇredána hodnota NULL, program použije pˇreddefinované hodnoty parametr˚u. Parametr aper specifikuje poˇradí clonky, v parametru outfrm se pˇredává bitová maska urˇcující požadovaný formát výstupního souboru. Parametr nstar urˇcuje poˇcet platných položek v poli stars – tedy poˇcet hvˇezd, které mají být uloženy do výstupního souboru, v parametru stars se pˇredává ukazatel na pole s poˇradovými cˇ ísly hvˇezd (promˇenná, srovnávací hvˇezda, kontrolní hvˇezda 1, atd.). Další cˇ tyˇri parametry jsou urˇceny pro pˇredání souˇradnic pozorovaného objektu a zemˇepisné polohy pozorovatele; pokud výstupní formát tyto údaje nevyžaduje, mohou tyto hodnoty být NULL. int mlist_read(const char *infile, int frame); Tato funkce se volá pro každý vstupní soubor. Pˇreˇcte se jeho obsah a potˇrebné údaje se uloží do pamˇeti. Jméno vstupního fotometrického souboru (výsledek skládání) se pˇredává v parametru infile. V druhém parametru, frame, lze nepovinnˇe pˇredat cˇ íslo snímku. Toto cˇ íslo je uloženo spolu s údaji do pamˇeti a lze jej zpˇetnˇe pˇreˇcíst voláním funkce mlist_getx. int mlist_getpar(int *ncols, int *nrows); Voláním této funkce lze pˇreˇcíst poˇcet sloupc˚u a poˇcet ˇrádk˚u tabulky výstupních dat uložených v pamˇeti. Poˇcet sloupc˚u se uloží do parametru ncols, poˇcet ˇrádk˚u do parametru nrows. int mlist_getcol(int col, char *buf); Funkce vrací jméno (text v záhlaví) sloupce s indexem col. Sloupce se cˇ íslují od 0. V parametru buf se pˇredává ukazatel na alokovanou pamˇet’, do které se uloží text zakonˇcený nulovým znakem. int mlist_getx(int *frm, double *jd, double *hcor, double *amass); Funkce vrací údaje z tabulky. V parametrech se pˇredávají ukazatele na pole, jejichž délka musí být alespoˇn rovna poˇctu ˇrádk˚u v tabulce. Do pole frm se uloží identifikaˇcní cˇ íslo snímku pˇredané pˇri volání funkce mlist_read, do pole jd se uloží datum a cˇ as pozorování ve formˇe juliánského data, pole hcor je urˇceno pro uložení heliocentrické korekce (pokud byla tato funkce ve specifikaci výstupního formátu povolena) a do pole amass se uloží hodnoty koeficientu vzdušné hmoty (musí být specifikováno ve formátu). int mlist_gety(int col, double *val, double *err); Funkce vrací údaje z jednoho sloupce tabulky. V parametru col se pˇredává poˇradí sloupce od 0, a v parametrech val a err se pˇredávají ukazatele na pole, jejichž délka musí být alespoˇn rovna poˇctu ˇrádk˚u tabulky. Do tˇechto polí se uloží relativní jasnost hvˇezdy v magnitudách a její chyba. int mlist_write(const char *outfile); Uloží data naˇctená v pamˇeti do výstupního souboru. int mlist_clean(void); Uvolˇnuje pamˇet’ alokovanou voláním pˇredchozích funkcí.
54
4. KNIHOVNA C-MUNIPACK
4.3 Ostatní funkce 4.3.1 Skládání temných snímku˚ Funkce pro skládání temných snímk˚u. Vstupní soubory musí být pˇrevedeny do pracovního formátu. int mdark_init(const char *optfile); Voláním této funkce se inicializuje proces skládání. Na konci procesu je nutné alokovanou pamˇet’ uvolnit zavoláním funkce mdark_clean. Pokud došlo k chybˇe, pˇredá funkce jako svou návratovou hodnotu odpovídající chybový kód. Parametr optfile zatím není využit, je urˇcen pro další rozšíˇrení. int mdark_read(const char *infile); Voláním této funkce se do pamˇeti naˇcte jeden vstupní snímek. Parametr infile je jméno vstupního souboru. int mdark_write(const char *outfile); Funkce provede složení všech vstupních snímk˚u a výstup uloží do souboru s názvem outfile. int mdark_clean(void); Uvolní pamˇet’ alokovanou v interních strukturách pˇredchozími funkcemi.
4.3.2 Skládání svˇetlých snímku˚ Funkce pro skládání svˇetlých snímk˚u. Vstupní soubory musí být pˇrevedeny do pracovního formátu. int aflat_init(const char *optfile); Voláním této funkce se inicializuje proces skládání. Na konci procesu je nutné alokovanou pamˇet’ uvolnit zavoláním funkce aflat_clean. Pokud došlo k chybˇe, pˇredá funkce jako svou návratovou hodnotu odpovídající chybový kód. Parametr optfile urˇcuje jméno konfiguraˇcního souboru. Pokud je pˇredána hodnota NULL, program použije pˇreddefinované hodnoty parametr˚u. int aflat_read(const char *infile); Voláním této funkce se do pamˇeti naˇcte jeden vstupní snímek. Parametr infile je jméno vstupního souboru. int aflat_write(const char *outfile, float *skymed, float *skysig); Funkce provede složení všech vstupních snímk˚u a výstup uloží do souboru s názvem outfile. Pomocí parametr˚u skymed a skysig lze pˇredat reference na promˇenné, do kterých se má uložit stˇrední úroveˇn jasu a jeho standardní odchylka na výstupním snímku. Pokud takový výstup není požadován, zapíše se hodnota NULL. int aflat_clean(void); Uvolní pamˇet’ alokovanou v interních strukturách pˇredchozími funkcemi.
4.3.3 Hledání promˇenných hvˇezd Funkce pro hledání promˇenných hvˇezd v sérii složených fotometrických soubor˚u. Všechny funkce jsou deklarovány v hlaviˇckovém souboru mfind.h. int mfind_init(const char *optfile, int ap, int thr); Inicializuje vnitˇrní promˇenné. Alokovanou pamˇet’ je nutné uvolnit voláním funkce mfind_clean. Pokud došlo k chybˇe, pˇredá funkce jako svou návratovou hodnotu odpovídající chybový kód.
4.3. OSTATNÍ FUNKCE
55
Parametr ap urˇcuje cˇ íslo clonky, která se má použít pˇri cˇ tení fotometrických soubor˚u, parametr thr je práh v procentech (viz. 3.3.4). int mfind_readsrt(const char *srtfile); Voláním této funkce se do pamˇeti naˇcte jeden vstupní soubor. Parametr srtfile je jméno vstupního souboru. int mfind_readall(const char *srcfile); Voláním této funkce se do pamˇeti naˇctou fotometrická data uložená v souboru ve formátu readall. Parametr srcfile je jméno vstupního souboru. int mfind_compute(int ref); Funkce provede výpoˇcet stˇredních magnitud a jejich smˇerodatných odchylek. Parametr ref urˇcuje poˇradí hvˇezdy, která se má použít jako srovnávací hvˇezda (poˇcítáno od 1). Pokud je jeho hodnota 0, pak se srovnávací hvˇezda urˇcí automaticky. int mfind_getpar(int *nstars, int *nimages, int *ref); Vrací hodnoty interních promˇenných. Do parametru nstars se zapíše poˇcet bod˚u (hvˇezd) na kˇrivce. Do parametru nimages se zapíše poˇcet vstupních soubor˚u. V ref se vrací cˇ íslo použité srovnávací hvˇezdy. int mfind_get(double *mag, double *stddev); ˇ Ctení obsahu interní tabulky obsahující stˇrední jasnosti a smˇerodatné odchylky mˇeˇrených hvˇezd. Pomocí parametr˚u mag resp. stdev se pˇredává odkaz na alokované pole pro uložení magnitud resp. chyb. Poˇcet ˇrádk˚u tabulky je možné pˇredem zjistit voláním funkce mfind_getpar, parametr nstars. int mfind_gdata(int star, double *jd, double *mag, double *err); Funkce vytvoˇrí tabulku se svˇetelnou kˇrivkou zvolené hvˇezdy. Parametr star urˇcuje poˇradí hvˇezdy, jejíž data jsou požadována, do parametr˚u jd, mag resp. err se zapíší odkazy na alokovaná pole pro uložení juliánského data, magnitudy resp. chyby. Poˇcet ˇrádk˚u tabulky je možné pˇredem zjistit voláním funkce mfind_getpar, parametr nimages. Jasnosti hvˇezd jsou vždy relativní v˚ucˇ i zvolené srovnávací hvˇezdˇe (viz funkce mfind_compute). int mfind_write(const char *outfile); Funkce uloží tabulku s kˇrivkou mag x stderr do souboru. Parametr outfile urˇcuje jméno výstupního souboru. int mfind_wdata(int star, const char *outfile); Funkce uloží tabulku se svˇetelnou kˇrivkou vybrané hvˇezdy do souboru. Parametr star urˇcuje poˇradí hvˇezdy, jejíž data jsou požadována. Jméno výstupního souboru se pˇredává v parametru outfile. int mfind_clean(void); Uvolní pamˇet’ alokovanou v interních strukturách pˇredchozími funkcemi.
56
4. KNIHOVNA C-MUNIPACK
4.4 Použité datové typy a konstanty 4.4.1 Konstanty chybových kódu˚ Pokud není uvedeno jinak, vrací funkce z knihovny C-Munipack nulu v pˇrípadˇe úspˇešného provedení operace a nenulovou hodnotu v pˇrípadˇe chyby. Je-li návratová hodnota rovna nebo vˇetší než 1000, jedná se o chybový kód knihovny C-Munipack. V pˇrípadˇe, že funkce vrátí hodnotu od 1 do 999, jedná se o zprostˇredkovaný chybový kód z knihovny Fitsio. Funkce z této knihovny tedy mohou vrátit jak chyby knihovny Fitsio (napˇr. pokud dojde k chybˇe bˇehem cˇ tení ze souboru) tak kódy definované v hlaviˇckovém souboru cmunipack.h. Jejich pˇrehled je uveden v tabulce 4.2. Konstanta MPK_MEMORY MPK_CANNOT_OPEN_SRC MPK_CANNOT_OPEN_OUT MPK_CANNOT_OPEN_PAR MPK_NO_DIRFILE MPK_NO_INPUT_FILES MPK_NO_DATA MPK_UNKNOWN_FORMAT MPK_INVALID_SIZE MPK_INVALID_PAR MPK_INVALID_DATA MPK_INVALID_HEADER MPK_INVALID_DATE MPK_ERROR MPK_KEY_NOT_FOUND MPK_DATA_OVERFLOW MPK_DATA_UNDERFLOW MPK_CLOSED_FILE MPK_FRAME_NOT_FOUND MPK_INVALID_OBJRA MPK_INVALID_OBJDEC MPK_INVALID_OBSLON MPK_INVALID_OBSLAT MPK_MISSING_OBJCOORDS MPK_MISSING_OBSCOORDS DRK_CANNOT_OPEN_DRK DRK_DIFFERENET_SIZE FLT_CANNOT_OPEN_FLT FLT_DIFFERENET_SIZE FLT_MEAN_ZERO FLT_DIVZERO MAT_CANNOT_OPEN_REF MAT_FEW_POINTS_REF MAT_FEW_POINTS_SRC MAT_MATCH_NOT_FOUND MAT_XML_PARSE AFL_DIFFERENET_SIZE MDK_DIFFERENET_SIZE MFI_TOO_FEW_DATA MFI_REF_NOT_FOUND
Význam Nedostateˇcná pamˇet’ Nelze otevˇrít vstupní soubor Nelze otevˇrít výstupní soubor Nelze otevˇrít soubor s parametry Soubor se seznamem vstupních soubor˚u neexistuje Nebyl definován žádný vstupní soubor Žádná data ve vstupním souboru Neznámý formát vstupního souboru Chybná velikost snímku Chybná hodnota parametru Chybná hodnota ve vstupních datech Chyba v hlaviˇcce vstupního souboru Neplatné datum nebo cˇ as Jiná chyba Požadovaný klíˇc nebyl nalezen Bˇehem výpoˇctu došlo k pˇreteˇcení rozsahu Bˇehem výpoˇctu došlo k podteˇcení rozsahu Tato operace není povolena na zavˇreném souboru Požadovaný snímek neexistuje Chybná hodnota rektascenze Chybná hodnota deklinace Chybná hodnota zemˇepisné délky Chybná hodnota zemˇepisné šíˇrky Chybí souˇradnice objektu Chybí souˇradnice pozorovatele Temný snímek nebyl nalezen Rozdílná velikost vstupního a temného snímku Svˇetlý snímek nebyl nalezen Rozdílná velikost vstupního a svˇetlého snímku Stˇrední úroveˇn snímku je 0 (nelze dˇelit nulou) Svˇetlý snímek obsahuje pixel s hodnotou 0 Referenˇcní soubor nebyl nalezen Pˇríliš málo hvˇezd v referenˇcním souboru Pˇríliš málo hvˇezd ve vstupním souboru Skládání nebylo úspˇešné Chyba pˇri cˇ tení katalogového souboru Všechny snímky nemají stejnou velikost Všechny snímky nemají stejnou velikost Pˇríliš málo dat ve vstupních souborech Referenˇcní hvˇezda nebyla nalezena
Tabulka 4.2: Konstanty chybových kód˚u
57
4.4. POUŽITÉ DATOVÉ TYPY A KONSTANTY
4.4.2 Konstanty formátu˚ vstupních souboru˚ Konstanty, definované v hlaviˇckovém souboru cmunipack.h se používají pro identifikaci formátu vstupních soubor˚u se snímky. Jejich pˇrehled je uveden v tabulce 4.3 Konstanta MPK_FORMAT_UNKNOWN MPK_FORMAT_FITS MPK_FORMAT_SBIG MPK_FORMAT_OES
Význam Neznámý formát Formát FITS Formát SBIG Formát OES Astro
Tabulka 4.3: Konstanty formát˚u vstupních soubor˚u
4.4.3 Režimy konverze Konstanty, definované v hlaviˇckovém souboru cmunipack.h se používají pro specifikaci režimu funkcí konv_*. Konstanta MPK_CONVERT_NORMAL MPK_CONVERT_HEADER MPK_CONVERT_INFO MPK_CONVERT_DETAILS
Význam Pˇrevede hlaviˇcku i obrazová data Pˇrevede pouze hlaviˇcku Vytiskne struˇcnou informaci Vypíše kompletní obsah hlaviˇcky
Tabulka 4.4: Konstanty pro volbu režimu konverze
4.4.4 Konstanty formátu˚ výstupních souboru˚ Konstanty, definované v hlaviˇckovém souboru cmunipack.h se používají pro specifikaci formátu výstupního souboru a jeho modifikací. Hodnota parametru pˇredávaná ve funkci mlist_init by mˇela být bitová maska složená z právˇe jedné konstanty urˇcující formát souboru k níž lze volitelnˇe pˇripojit nˇekolik modifikátor˚u (tabulka 4.5). Kategorie Formáty soubor˚u
Modifikátory
Konstanta MPK_FORMAT_DIFFMAG MPK_FORMAT_INSTMAG MPK_FORMAT_READALL MPK_FORMAT_TRACKLST MPK_FORMAT_JDHEL MPK_FORMAT_HELCOR MPK_FORMAT_AIRMASS
Význam Diferenciální magnitudy Instrumentální magnitudy Formát „read-all“ Track-list (tabulka posun˚u) Datum a cˇ as ukládat jako helioc. JD Do výstupu uložit také velikost helioc. kor. Do výstupu uložit také koef. vzdušné hmoty
Tabulka 4.5: Konstanty základních formát˚u výstupních soubor˚u
5
Soubory
Tato kapitola je vˇenována popisu použitých souborových formát˚u. Text je pˇrehlednˇe rozdˇelen do cˇ tyˇr cˇ ástí. V první cˇ ásti najde cˇ tenáˇr struˇcný pˇrehled všech podporovaných formát˚u vstupních soubor˚u. Následující cˇ ást se mnohem podrobnˇeji vˇenuje formát˚um výstupních soubor˚u. Navazující kapitola obsahuje popis fotometrických a katalogových soubor˚u. Formát konfiguraˇcních soubor˚u vˇcetnˇe významu jednotlivých parametr˚u je detailnˇe popsán v poslední závˇereˇcné cˇ ásti. Pˇri sazbˇe textu byla použita následující konvence: kurzívou jsou vysázena vˇcechna klíˇcová slova, tj. nemˇenné texty, které jsou uloženy pˇrímo v souboru. Jména soubor˚u, adresáˇru˚ , kláves a ˇrídících znak˚u jsou tištˇena strojopisem. Standardní hodnoty parametr˚u, které se použijí v pˇrípadˇe, že popisovaný parametr není uveden nebo jeho hodnota je neplatná, jsou uvedeny v [hranatých závorkách].
5.1
Vstupní soubory
V této sekci je uveden struˇcný pˇrehled souborových formát˚u používaných pro uložení snímk˚u z astronomických CCD kamer, které lze zpracovat pomocí program˚u z projektu C-Munipack. Nejrozšíˇrenˇejším formátem, který se v dnešní dobˇe stal prakticky standardem, je formát FITS. Tento formát je také použit jako pracovní formát pro pˇredávání snímk˚u mezi jednotlivými cˇ ástmi softwarového ˇretˇezce pro redukci CCD dat. Formát Flexible Image Transport System (zkrácenˇe FITS) je v souˇcasné dobˇe udržován dr. Williamem Pencem z NASA. Podrobnou specifikaci formátu lze nalézt na internetu. Protože specifikace je obecná, neurˇcuje formát, v jakém by mˇel být uložen v souboru datum a cˇ as pozorovaní. To pˇrináší v praxi ˇradu problém˚u, nebot’ se používá celá ˇrada r˚uzných tvar˚u, nˇekteré programy pro poˇrizování CCD snímk˚u umožˇnují kódování data a cˇ asu nastavit. Programy z projektu C-Munipack umí automaticky rozpoznat a zpracovat nˇekolik nejˇcastˇeji používaných formát˚u. V projektu C-Munipack byla použita pro cˇ tení a zápis soubor˚u knihovna Cfitsio verze 3.006. Program CCDOPS používá sv˚uj vlastní formát dat. Výhodou tohoto formátu je použitá komprese obrazové cˇ ásti, která snižuje velikost výsledného souboru. Rovnˇež starší modely kamer vyrobených firmou OES GmbH v Nˇemecku používají sv˚uj vlastní formát pro uložení CCD dat. Oba tyto formátu ˇ lze pomocí program˚u z projektu C-Munipack zpracovat pˇrevedením na formát FITS. Ctení tˇechto formát˚u je ˇrešeno implementací vlastního kódu, který vychází z dostupné dokumentace.
5.2 Výstupní soubory V této sekci je uveden podrobný popis formát˚u soubor˚u používaných pro uložení výsledk˚u redukce CCD snímk˚u. Formáty byly navrženy tak, aby byly pokud možno kompatibilní s ostatními používanými systémy pro redukci CCD snímk˚u a aby bylo možné je naˇcíst do program˚u pro zpracování tabulek nebo kreslení graf˚u.
5.2.1 Svˇetelná kˇrivka Soubor se svˇetelnou kˇrivkou je produktem programu Munilist a obvykle je to také výstup celého rˇetˇezce pro redukci dat. Obsahuje tabulku s cˇ asovým údajem, jasnostmi vybraných hvˇezd a jejich chybách. Hvˇezdné velikosti mohou být bud’to diferenciální, kdy se uvádí rozdíl jasností dvou hvˇezd nebo instrumentální, kdy jsou pˇrímo uvedeny jasnosti zmˇeˇrené pˇri fotometrii. Instrumentální jasnosti vyžadují další zpracování, aby se z nich získaly skuteˇcné hvˇezdné velikosti porovnatelné s údaji uloženými v katalozích. Soubor má textový tvar, jednotlivé ˇrádky jsou oddˇeleny dvojicí znak˚u CR+LF, pˇrípadnˇe znakem CR nebo LF podle zvyklostí v použitém operaˇcním systému. První ˇrádek obsahuje klíˇcová slova oddˇelená alespoˇn jednou mezerou a tvoˇrí záhlaví tabulky. Pˇrehled použitých klíˇcových slov a jejich význam je
59
5.2. VÝSTUPNÍ SOUBORY
uveden v tabulce 5.1. Druhý ˇrádek je informativní a obsahuje informace o polomˇeru použité clonky, barevném filtru, délce expozice apod. Tˇretí a následující rˇádky obsahují vlastní data uspoˇrádané v textové tabulce. Jednotlivé údaje jsou oddˇeleny alespoˇn jednou mezerou. Význam údaj˚u je dán odpovídajícím klíˇcovým slovem v záhlaví. Každý ˇrádek v tabulce odpovídá jedné položce v tabulce vstupních soubor˚u, pokud se nˇejaký CCD ˇ snímek nepovedlo zpracovat, objeví se na jeho místˇe ve výstupním souboru prázdný ˇrádek. Rádek se vynechá také v pˇrípadˇe, že se nepodaˇrilo vypoˇcítat jasnost vybrané promˇenné nebo srovnávací hvˇezdy. Formát Spoleˇcná cˇ ást
Klíˇc. slovo JD JDHEL HELCOR AIRMASS V-C s1 V-C1 s2 ... MAG0 ERR0 MAG1 ERR1 ...
Diferenciální hv. velikosti
Instrumentální hv. velikosti
Význam Geocentrické datum a cˇ as pozorování ve formátu JD Heliocentrické datum a cˇ as pozorování ve formátu JD Heliocentrické korekce ve dnech Koeficient vzdušné hmoty Rozdíl promˇenné a srovnávací hvˇezdy v magnitudách Chyba pˇredchozího údaje Rozdíl srovnávací a první kontrolní hvˇezdy Chyba pˇredchozího údaje ... Velikost první hvˇezdy v magnitudách Chyba pˇredchozího údaje Velikost druhé hvˇezdy v magnitudách Chyba pˇredchozího údaje ...
Tabulka 5.1: Význam údaj˚u ve výstupním souboru
5.2.2 Tabulka posunu˚ (Track-list) Tabulka vzájemných posun˚u snímk˚u (tzv. track-list) je výstupem programu Munilist. Obsahuje tabulku s relativní pozicí hvˇezd na snímku v˚ucˇ i odpovídajícím hvˇezdám na vybranému referenˇcnímu snímku. Soubor má textový tvar, jednotlivé ˇrádky jsou oddˇeleny dvojicí znak˚u CR+LF, pˇrípadnˇe znakem CR nebo LF podle zvyklostí v použitém operaˇcním systému. První ˇrádek je uvozen mˇrížkou a jednou mezerou. Následující klíˇcová slova oddˇelená právˇe jednou mezerou tvoˇrí záhlaví tabulky. Pˇrehled použitých klíˇcových slov a jejich význam je uveden v tabulce 5.2. Druhý ˇrádek je vždy prázdný. Tˇretí a následující rˇádky obsahují vlastní data uspoˇrádané v textové tabulce. Jednotlivé údaje jsou oddˇeleny jednou mezerou, význam údaj˚u je dán odpovídajícím klíˇcovým slovem v záhlaví. Každý ˇrádek v tabulce odpovídá jedné položce v tabulce vstupních soubor˚u, pokud se nˇejaký CCD snímek nepovedlo zpracovat, objeví se na jeho místˇe ve výstupním souboru prázdný ˇrádek. Klíˇc. slovo JD OFFSETX OFFSETY
Význam Geocentrické datum a cˇ as pozorování ve formátu JD Relativní posun snímku ve vodorovném smˇeru v pixelech Relativní posun snímku ve svislém smˇeru v pixelech
Tabulka 5.2: Význam údaj˚u ve výstupním souboru
5.2.3 Výstup programu Munifind Výstupní soubor programu Munifind obsahuje tabulku stˇredních hvˇezdných velikostí a stˇredních kvadratických odchylek hvˇezd.
60
5. SOUBORY
Soubor má textový tvar, jednotlivé ˇrádky jsou oddˇeleny dvojicí znak˚u CR+LF, pˇrípadnˇe znakem CR nebo LF podle zvyklostí v použitém operaˇcním systému. První ˇrádek obsahuje klíˇcová slova oddˇelená alespoˇn jednou mezerou a tvoˇrí záhlaví tabulky. Pˇrehled použitých klíˇcových slov a jejich význam je uveden v tabulce 5.3. Druhý ˇrádek je informativní. Tˇretí a následující rˇádky obsahují vlastní data uspoˇrádané v textové tabulce. Jednotlivé údaje jsou oddˇeleny alespoˇn jednou mezerou. Význam údaj˚u je dán odpovídajícím klíˇcovým slovem v záhlaví. První sloupec obsahuje identifikaˇcní cˇ íslo hvˇezdy v referenˇcním souboru. Je-li k dispozici pro danou hvˇezdu ménˇe dat než vyžaduje parametr threshold, v druhém ˇrádku je uvedena hodnota 99.999 a ve tˇretím ˇrádku 9.999. Pˇri vytváˇrení grafu je nutné takové ˇrádky vypustit. Klíˇc. slovo INDEX MEAN_MAG STDEV GOODPOINTS
Význam Identifikaˇcní cˇ íslo hvˇezdy na referenˇcním snímku Stˇrední hodnota relativní velikosti hvˇezdy Stˇrední kv. odchylka relativní velikosti hvˇezdy Poˇcet mˇeˇrení použitých pro výpoˇcet pˇredchozích údaj˚u
Tabulka 5.3: Význam údaj˚u ve výstupu z programu Munifind
5.3 Fotometrické soubory Fotometrický soubor je výstup z procesu fotometrie (programu Muniphot) a z rutiny pro skládání (program Munimatch) v projektu C-Munipack. Zároveˇn je používán jako vstup pro další fázi redukce CCD dat. Soubor obsahuje tabulku všech hvˇezd detekovaných na jednom snímku, pro každou hvˇezdu obsahuje její polohu, hvˇezdnou velikost a její chybu pˇrípadnˇe další údaje. Je-li soubor výstupem fotometrie, má pˇríponu SRT. Soubory, které jsou výsledkem skládání, mají pˇríponu MAT. Stávající formát fotometrických soubor˚u je kompatibilní s formátem použitým v programu Munipack. Soubor má textový tvar, jednotlivé ˇrádky jsou oddˇeleny dvojicí znak˚u CR+LF, pˇrípadnˇe jedním znakem CR nebo LF podle zvyklostí v použitém operaˇcním systému. První tˇri ˇrádky souboru tvoˇrí jeho hlaviˇcku, která je složena z dvojic klíˇc a hodnota. Klíˇc urˇcuje význam hodnoty, seznam používaných klíˇcových slov je uveden v následující tabulce 5.4. Klíˇcové slovo je uvedeno vždy v prvním ˇrádku a je nutné dodržet jeho pozici v ˇrádku uvedenou v tabulce, zarovnání textu m˚uže být vpravo nebo vlevo, volné místo se doplní mezerami. Obdobným zp˚usobem jsou uspoˇrádány hodnoty parametr˚u, které jsou uvedeny na stejných pozicích v druhém ˇrádku. Následující tˇretí ˇrádek je vždy prázdný. Poznámka: Protože tento formát není dále rozšíˇritelný, pˇripravuje se do verze 1.2 jeho nahrazení novým formátem založeným na standardu XML. Klíˇcové slovo NL NX NY LOWBAD HIGHBAD THRESH AP1 PH/ADU RNOISE JD FILTER EXPTIME FWHM
Pozice 1–3 5–8 10 – 13 15 – 21 23 – 29 31 – 37 39 – 45 47 – 53 55 – 61 63 – 77 79 – 94 96 – 105 107 – 113
Význam Verze formátu, vždy hodnota 2 Šíˇrka snímku v pixelech Výška snímku v pixelech Nejnižší platná hodnota obrazového bodu v ADU Nejvyšší platná hodnota obrazového bodu v ADU ??? Polomˇer clonky 1 v pixelech Pˇrevodní pomˇer AD pˇrevodníku (e-/ADU) ??? Datum a cˇ as stˇredu expozice vyjádˇrený v JD Použitý barevný filtr Expoziˇcní doba v sekundách Stˇrední hodnota FWHM hvˇezd
Tabulka 5.4: Význam údaj˚u v hlaviˇcce fotometrických soubor˚u
61
5.4. KATALOGOVÉ SOUBORY
Od cˇ tvrtého rˇádku dále jsou uvedeny informace o nalezených hvˇezdách. Každé hvˇezdˇe odpovídají tˇri po sobˇe následující ˇrádky, pˇriˇcemž první dva ˇrádky obsahují údaje a tˇretí ˇrádek je vždy prázdný. Údaje musí být v ˇrádku uloženy na pozicích uvedených v tabulce 5.5, pˇriˇcemž mohou být zarovnány vpravo nebo vlevo a volné místo je vždy doplnˇeno mezerami. ˇ Rádek ˇ Rádek 1
ˇ Rádek 2
Pozice 1–6 8 – 15 17 – 24 26 – 33 35 – 42 44 – ... 1 – 13 15 – 19 21 – 25 26 – 33 35 – 42 44 – ...
Význam Pˇridˇelené identifikaˇcní cˇ íslo hvˇezdy Vodorovná pozice stˇredu hvˇezdy v pixelech Svislá pozice stˇredu hvˇezdy v pixelech Instrumentální velikost hvˇezdy v magnitudách (clonka 1) Instrumentální velikost hvˇezdy v magnitudách (clonka 2) ... Úroveˇn pozadí v mezikruží v ADU (tj. jas oblohy) Stˇrední chyba úrovnˇe pozadí Nepoužito, vždy 0 Chyba hvˇezdné velikosti (clonka 1) Chyba hvˇezdné velikosti (clonka 2) ...
Tabulka 5.5: Význam údaj˚u o hvˇezdách fotometrických soubor˚u
5.4 Katalogové soubory Katalogové soubory zjednodušují práci s programem Muniwin pˇri pravidelném pozorování jednoho hvˇezdného pole, napˇr. pˇri dlouhodobém sledování promˇenné hvˇezdy. V souboru je kromˇe tabulky hvˇezd uložen také zadaný výbˇer hvˇezd. Pˇri použití katalogové souboru místo referenˇcního souboru pˇri skládání, výbˇer hvˇezd je automaticky naˇcten do pamˇeti. Uživatel pak jen výbˇer zkontroluje a potvrdí v dialogu pro výbˇer hvˇezd. Katalogový soubor lze vytvoˇrit pomocí programu Muniwin, kliknutím v nabídce Tools na položku Make catalogue file. V projektu C-Munipack byla pro cˇ tení soubor˚u ve formátu XML použita knihovna Expat (viz reference). Zápis soubor˚u se provádí pomocí vlastního kódu. Struktura souboru˚ Katalogové soubory jsou uloženy v jazyce XML. cat_file - výchozí element celého dokumentu. Atributy: Žádné. Model: (info, selection, stars) info - základní údaje o souboru. Atributy: Žádné. Model: (object?, ra2000?, dec2000?, observer?, observatory?, telescope?, camera?, filter?, fov?, orientation?, comment?) object, ra2000, dec2000 - oznaˇcení, souˇradnice objektu (napˇr. promˇenné hvˇezdy). Atributy: Žádné. Model: #PCDATA observer, observatory - jméno pozorovatele, název pozorovacího stanovištˇe. Atributy: Žádné. Model: #PCDATA telescope, camera, filter - popis použitého dalekohledu, CCD kamery, barevný filtr. Atributy: Žádné. Model: #PCDATA
62
5. SOUBORY
fov, orientation - informativní údaje o úhlové velikost zorné pole (šíˇrka x výška), natoˇcení pˇrípadnˇe zrcadlení snímku. Atributy: Žádné. Model: #PCDATA comment - komentáˇr, libovolný text Atributy: Žádné. Model: #PCDATA selection - tabulka vybraných hvˇezd Atributy: Žádné. Model: (select*) select - element pˇriˇrazuje hvˇezdˇe podle jejího identifikaˇcního cˇ ísla oznaˇcení. Promˇenná hvˇezda má oznaˇcení "var", srovnávací hvˇezda "comp", kontrolní hvˇezdy "chk1", chk2"atd. Atributy: id - identifikaˇcní cˇ íslo hvˇezdy, label - oznaˇcení hvˇezdy Model: Prázdný. stars - tabulka všech hvˇezd na referenˇcním snímku Atributy: width, height - šíˇrka a výška snímku v obrazových bodech Model: (s*) s - referenˇcní poloha a velikost hvˇezdy. Atributy: id - identifikaˇcní cˇ íslo hvˇezdy; x, y - poloha v obrazových bodech vzhledem k levému hornímu rohu snímku, m - instrumentální hvˇezdná velikost v magnitudách, e - chyba urˇcení hv. velikosti Model: Prázdný.
5.5 Konfiguraˇcní soubory Konfiguraˇcní soubory program˚u z projektu C-Munipack mají textový formát, každý parametr je zapˇ sán na samostatném ˇrádku. Rádek je ukonˇcen dvojicí znak˚u CR+LF, pˇrípadnˇe znakem CR nebo LF podle zvyklostí v použitém operaˇcním systému. Na zaˇcátku ˇrádku je vždy uveden název parametru (klíˇcové slovo), následuje rovnítko a hodnota parametru. Hodnota m˚uže být uzavˇrena v úvozovkách nebo apostrofech. Pˇrípadné mezery, tabulátory apod. na zaˇcátku ˇrádku, kolem rovnítka cˇ i na konci ˇrádku se ignorují. Není-li uvedeno jinak, poˇradí parametr˚u není rozhodující. V pˇrípadˇe, že nˇekterý z parametr˚u není v souboru uveden, nebo jeho hodnota je neplatná, použije se standardní hodnota uvedená v následujícím pˇrehledu v hranatých závorkách. Do souboru je možné vkládat také poznámky – za poznámku se považuje veškerý text od znaku ˇ mˇrížka (#) do konce ˇrádku. Rádky, které jsou prázdné pˇrípadnˇe obsahují pouze mezery cˇ i poznámku se ignorují.
5.5.1 Prumˇ ˚ ery clonek (Apertures.ini) V souboru Apertures.Ini jsou uloženy definice clonek používaných v aperturní fotometrii. ˇ Polomˇery jsou uvedeny vždy v obrazových bodech (pixelech). Rádky není nutné definovat všechny, nepoužívané clonky se vynechají nebo se hodnota nastaví na 0 pixel˚u, v tˇechto pˇrípadech nebude jasnost hvˇezdy pro tuto clonku urˇcována. • A1, A2, ... A12 – polomˇer clonek cˇ íslo 1 až 12 [0] • IS – vnitˇrní polomˇer clonky pro mˇeˇrení jasu oblohy [20] • OS – vnˇejší polomˇer clonky pro mˇeˇrení jasu oblohy [30]
ˇ SOUBORY 5.5. KONFIGURACNÍ
63
5.5.2 Parametry pro skládání svˇetlých snímku˚ (Autoflat.ini) Konfiguraˇcní parametry pro skládání svˇetlých snímk˚u jsou uloženy v souboru Autoflat.Ini. • MAXSKY – max. poˇcet obrazových bod˚u používaných pro výpoˇcet stˇr. jasu snímku [10000] • LEVEL – požadovaná stˇrední úroveˇn jasu výstupního snímku v ADU [10000.0]
5.5.3 Parametry pro hledání promˇenných (Munifind.ini) V tomto souboru jsou uloženy parametry pro funkci hledání promˇenných hvˇezd. • APERTURE – cˇ íslo používané clonky (od 1 do 12) [1] • THRESHOLD – tato hodnota urˇcuje, kolik procent musí mít minimálnˇe daná hvˇezda dobrých mˇeˇrení z celkového poˇctu zpracovávaných snímk˚u, aby byla zaˇrazena do výstupního souboru, v procentech [30]
5.5.4 Parametry výstupních souboru˚ (Munilist.ini) V tomto souboru jsou uloženy parametry pro sestavování výstupních soubor˚u. • APERTURE – cˇ íslo používané clonky (od 1 do 12) [1] • OUTFORM – formát výstupního souboru [0]
5.5.5 Parametry funkce skládání (Munimatch.ini) V tomto souboru jsou uloženy parametry pro skládání fotometrických soubor˚u. • RSTARS – poˇcet hvˇezd ze vstup. a ref. snímku, které budou použity pro skládání [10] • ISTARS – poˇcet vrchol˚u hledaných n-úhelníku [5] • CLIP – práh pˇri urˇcovaní nepˇresností n-úhelník˚u, v násobcích sigma [2.5]
5.5.6 Nastavení fotomterie (Muniphot.ini) Soubor obsahuje konfiguraˇcní parametry používané pˇri fotometrii. • READNS – úroveˇn šumu v e-, mˇela by se doplnit správná hodnota podle dokumentace k CCD kameˇre [15.0] • GAIN – poˇcet elektron˚u na ADU, mˇela by se doplnit správná hodnota podle dokumentace k CCD kameˇre. [2.30] • LODATA – nejmenší platná hodnota pixelu [7.00] • HIDATA – nejvˇetší platná hodnota pixelu [65535.00 (tj. 16 bit˚u)] • FWHM – pˇredpokládaná šíˇrka objektu v polovinˇe úrovnˇe od maxima v pixelech (Full Width at Half Maximum), pro kterou má být výpoˇcet optimalizován [3.00] • THRESH – práh urˇcující jak slabé hvˇezdy nad úrovní šumu pozadí budou detekovány [4.00] • LOSHARP – dolní omezení ostrosti hvˇezd [0.20] • HISHARP – horní omezení ostrosti hvˇezd [1.00] • LOROUND – dolní omezení soumˇernosti hvˇezd [−1.00] • HIROUND – horní omezení soumˇernosti hvˇezd [1.00]
Slovník chybových hlášení A Aperture radii must be between 1.0 and outer sky radius Polomˇer nˇekteré z clonek je menší než jeden obrazový bod nebo vˇetší než vnˇejší polomˇer mezikruží pro výpoˇcet oblohy. Pravdˇepodobnˇe se zmenšil rozmˇer mezikruží, ale nˇekteré clonky jsou vˇetší než povolený rozmˇer. Zkontrolujte zadané polomˇery clonek a velikost mezikruží.
C Cannot open the destination file Cílový soubor nelze vytvoˇrit nebo zmˇenit. Zkontrolujte, že: a) cílový disk a adresáˇr jsou správné a nejsou chránˇeny proti zápisu, b) soubor není otevˇren v jiné aplikaci, c) máte oprávnˇení pro zápis do cílového adresáˇre a d) jméno souboru i adresáˇre jsou zapsány správnˇe. Cannot open the parameter file Konfiguraˇcní soubor nelze otevˇrít pro cˇ tení. Zkontrolujte, že: a) jméno souboru i adresáˇre jsou zapsány správnˇe a soubor existuje, b) soubor není otevˇren v jiné aplikaci, c) máte oprávnˇení pro cˇ tení souboru. Pokud se toto hlášení objeví v programu Muniwin, jedná se pravdˇepodobnˇe o chybu v programu, pošlete prosím hlášení autorovi. Cannot open the source file Zdrojový soubor nelze otevˇrít pro cˇ tení. Zkontrolujte, že: a) soubor není otevˇren v jiné aplikaci, b) jméno souboru i adresáˇre jsou zapsány správnˇe a soubor existuje a c) máte oprávnˇení pro cˇ tení souboru. Coincidences not found Nebyla nalezena shoda mezi referenˇcním a zdrojovým souborem hvˇezd. Ve vˇetšinˇe pˇrípad˚u toto ˇ hlášení znamená, že posun mezi snímky je pˇríliš velký. Castou pˇríˇcinou je také zamíchání snímk˚u r˚uzných hvˇezdných polí. Nejedná se o kritickou chybu, ale tento snímek bude vyˇrazen z dalšího zpracování. Cannot copy file ... to ... Nelze zkopírovat soubor uvedený na prvním místˇe do cílového umístˇení. Zkontrolujte, že: a) cesty a jména soubor˚u jsou zapsány správnˇe a zdrojový soubor existuje, b) cílový disk a adresáˇr není chránˇen proti zápisu, c) máte oprávnˇení pro cˇ tení a zápis soubor˚u, c) soubory nejsou otevˇreny v jiné aplikaci.
D Dark frame not found Zadaný soubor s temným korekˇcním snímkem nelze otevˇrít pro cˇ tení. Zkontrolujte, že: a) soubor není otevˇren v jiné aplikaci, b) jméno souboru i adresáˇre jsou zapsány správnˇe a soubor existuje a c) máte oprávnˇení pro cˇ tení souboru. Pokud se toto hlášení objeví v programu Muniwin, jedná se pravdˇepodobnˇe o chybu v programu, pošlete prosím hlášení autorovi. Data overflow has been occurred during computation Výsledek výpoˇctu je menší než povolený rozsah hodnot. Není to kritická chyba, ale jeden nebo více obrazových bod˚u v cílovém snímku nebudou mít platné hodnoty a budou pˇri dalším zpracování vyˇrazeny. Obvykle tato chyba indikuje špatnou kvalitu použitého temného nebo svˇetlého korekˇcního snímku.
65 Data underflow has been occurred during computation Výsledek výpoˇctu je vˇetší než povolený rozsah hodnot. Není to kritická chyba, ale jeden nebo více obrazových bod˚u v cílovém snímku nebudou mít platné hodnoty a budou pˇri dalším zpracování vyžazeny. Obvykle tato chyba indikuje špatnou kvalitu použitého temného nebo svˇetlého korekˇcního snímku. Default directory ... could not be created Jeden z požadovaných adresáˇru˚ zadaných v konfiguraci neexistuje a nelze jej ani vytvoˇrit. Otevˇrete prosím konfiguraˇcní dialog "Preferencies"v nabídce "Tools"a zkontrolujte nastavení adresáˇru˚ . Dimensions of dark-frame and scientific image are different Nelze provést korekci zadaným temným snímkem, protože korekˇcní a zdrojový snímek mají r˚uzné rozmˇery (šíˇrku nebo výšku). Dimensions of flat-frame and scientific image are different Nelze provést korekci zadaným svˇetlým snímkem, protože korekˇcní a zdrojový snímek mají r˚uzné rozmˇery (šíˇrku nebo výšku). Directory ... could not be created Uvedený adresáˇr neexistuje a nelze jej ani vytvoˇrit. Zkontrolujte, že: a) cílový disk a adresáˇr jsou správné a nejsou chránˇeny proti zápisu, b) máte oprávnˇení pro zápis do cílového adresáˇre a c) jméno adresáˇre i cesta jsou zadány správnˇe. Dirfile not found Zadaný soubor se seznamem vstupních snímk˚u nelze otevˇrít pro cˇ tení. Zkontrolujte, že: a) soubor není otevˇren v jiné aplikaci, b) jméno souboru i adresáˇre jsou zapsány správnˇe a soubor existuje a c) máte oprávnˇení pro cˇ tení souboru.
E Error in header of the source file Záhlaví zdrojového souboru má nesprávný formát, obsahuje neplatné klíˇcové slovo nebo hodnotu. Tato chyba m˚uže znamenat, že zdrojový soubor byl poškozen. Error while reading file V pr˚ubˇehu cˇ tení zdrojového souboru došlo k chybˇe.
F File is open in read-only mode Zobrazení této chyby znamená, že se jedná o chybu v programu. Pošlete prosím hlášení autorovi. Flat frame not found Zadaný soubor se svˇetlým korekˇcním snímkem nelze otevˇrít pro cˇ tení. Zkontrolujte, že: a) soubor není otevˇren v jiné aplikaci, b) jméno souboru i adresáˇre jsou zapsány správnˇe a soubor existuje a c) máte oprávnˇení pro cˇ tení souboru. Pokud se toto hlášení objeví v programu Muniwin, jedná se pravdˇepodobnˇe o chybu v programu, pošlete prosím hlášení autorovi. Frame not found Požadovaný snímek není k dispozici. Pokud se toto hlášení objeví v programu Muniwin, jedná se urˇcitˇe o chybu v programu, pošlete prosím hlášení autorovi.
66
SLOVNÍK CHYBOVÝCH HLÁŠENÍ
G General error Blíže nespecifikovaná kritická chyba. Pokud se toto hlášení objeví v programu Muniwin, jedná se urˇcitˇe o chybu v programu, pošlete prosím hlášení autorovi.
I Input frames are not compatible (different sizes) Operaci není možné dokonˇcit, protože nˇekteré snímky v sadˇe mají r˚uzné rozmˇery (šíˇrku nebo výšku). Toto hlášení znamená, že se pokoušíte vytvoˇrit pr˚umˇerný korekˇcní snímek ze sady snímk˚u poˇrízených r˚uznými pˇrístroji nebo s odlišným nastavením rozlišení (binování). Insufficient memory Pˇridˇelení pamˇet’ového prostoru selhalo. Tato chyba m˚uže indikovat chybnou hodnotu uvedenou ve vstupním souboru, na pˇríklad pˇríliš velký rozmˇer snímku. Soubor mohl být poškozen. Pokud se toto hlášení objeví v programu Muniwin, jedná se pravdˇepodobnˇe o chybu v programu, pošlete prosím hlášení autorovi. Invalid data in source file Tˇelo zdrojového souboru má nesprávný formát nebo obsahuje neplatnou hodnotu. Tato chyba m˚uže znamenat, že zdrojový soubor byl poškozen. Invalid dimensions of image Rozmˇery zadaného snímku (šíˇrka nebo výška) nejsou platné hodnoty. Tato chyba pravdˇepodobnˇe znamená, že vstupní soubor byl poškozen. Invalid format of date or time of observation Použitý zp˚usob zápisu data nebo cˇ asu se liší od formát˚u, které program dokáže rozpoznat. M˚uže to také znamenat, že vstupní soubor byl poškozen. Bohužel neexistuje žádný standardní zp˚usob pro zápis data a cˇ asu. Aˇckoliv souˇcasná verze programu dokáže automaticky rozpoznat mnoho r˚uzných formát˚u, je možné, že váš program používá jiný. Pošlete prosím autorovi programu jeden nebo dva snímky jako vzorek. Pokud to je možné, bude Váš formát zaˇrazen do nejbližší následující verze. Invalid format of time of observation Použitý zp˚usob zápisu data pozorování není správný. Podívejte se do uživatelské pˇríruˇcky na požadovaný formát data a cˇ asu. Invalid format of latitude Použitý zp˚usob zápisu zemˇepisné šíˇrky není správný. Podívejte se do uživatelské pˇríruˇcky na požadovaný formát zemˇepisných souˇradnic. Invalid format of longitude Použitý zp˚usob zápisu zemˇepisné délky není správný. Podívejte se do uživatelské pˇríruˇcky na požadovaný formát zemˇepisných souˇradnic. Invalid format of declination Použitý zp˚usob zápisu deklinace objektu není správný. Podívejte se do uživatelské pˇríruˇcky na požadovaný formát rovníkových souˇradnic. Invalid format of right ascension Použitý zp˚usob zápisu rektascenze objektu není správný. Podívejte se do uživatelské pˇríruˇcky na požadovaný formát rovníkových souˇradnic.
67 Invalid value of parameter Toto chybové hlášení znamená, že nˇekterý ze zadaných parametr˚u nebo parametr˚u v konfiguraˇcním souboru má neplatnou hodnotu nebo jeho hodnota je mimo povolený rozsah. Zkontrolujte nastavení a podívejte se do uživatelské pˇríruˇcky na význam a rozsah parametr˚u. Pokud se toto hlášení objeví v programu Muniwin, jedná se pravdˇepodobnˇe o chybu v programu, pošlete prosím hlášení autorovi. Invalid format of time of observation Použitý zp˚usob zápisu data pozorování není správný. Podívejte se do uživatelské pˇríruˇcky na požadovaný formát data a cˇ asu. It is not allowed to delete the reference file Nelze vymazat tento snímek z tabulky vstupních soubor˚u, protože to je referenˇcní snímek.
K Key not found Požadovaný parametr nebyl nalezen. Pokud se toto hlášení objeví v programu Muniwin, jedná se urˇcitˇe o chybu v programu, pošlete prosím hlášení autorovi.
M Mean value of flat frame is zero Použitý snímek není použitelný pro korekci svˇetlým snímkem, protože všechny obrazové body mají nulovou hodnotu. Missing object’s coordinates Pro dokonˇcení této operace je nutné znát souˇradnice pozorovaného objektu, ale ty nebyly zadány. Missing observer’s coordinates Pro dokonˇcení této operace je nutné znát souˇradnice pozorovatele, ale ty nebyly zadány. Poloha pozorovatele se zadává v dialogu "Preferencies"v nabídce "Tools".
N No data loaded in memory Program požaduje cˇ tení údaj˚u z prázdné tabulky. Pokud se toto hlášení objeví v programu Muniwin, jedná se urˇcitˇe o chybu v programu, pošlete prosím hlášení autorovi. No file was successfully processed Operace byla dokonˇcena bez kritické chyby, ale žádný snímek nebyl zpracován správnˇe. No input files Nebyl zadán žádný vstupní snímek na pˇríkazové ˇrádce nebo v souboru se seznamem vstupních snímk˚u. Podívejte se do uživatelské pˇríruˇcky na syntaxi pˇríkazu. No stars selected Nelze provést požadovanou operaci, protože nebyl zadán žádný výbˇer hvˇezd. Spust’te dialog "Choose stars"z nabídky "Plotting".
68
SLOVNÍK CHYBOVÝCH HLÁŠENÍ
O Operation not allowed on closed file Program zkouší cˇ íst nebo zapisovat do souboru, který není otevˇren. Pokud se toto hlášení objeví v programu Muniwin, jedná se urˇcitˇe o chybu v programu, pošlete prosím hlášení autorovi.
R Reference file was not found Zadaný referenˇcní nebo katalogový soubor nelze otevˇrít pro cˇ tení. Zkontrolujte, že: a) soubor není otevˇren v jiné aplikaci, b) jméno souboru i adresáˇre jsou zapsány správnˇe a soubor existuje a c) máte oprávnˇení pro cˇ tení souboru. Pokud se toto hlášení objeví v programu Muniwin, jedná se pravdˇepodobnˇe o chybu v programu, pošlete prosím hlášení autorovi. Reference star was not found Zadaná referenˇcní nebo srovnávací hvˇezda nebyla nalezena v souboru hvˇezd. Pokud se toto hlášení objeví v programu Muniwin, jedná se pravdˇepodobnˇe o chybu v programu, pošlete prosím hlášení autorovi. Resulting image cannot be empty Rozmˇer (šíˇrka nebo výška) výsledného snímku nebo obrázku je nulový. Zkontrolujte zadané parametry. Resulting image is too large Rozmˇer (šíˇrka nebo výška) výsledného snímku nebo obrázku je pˇríliš velký. Zkontrolujte zadané rozmˇery parametry.
S Syntax error in the catalogue file Zadaný katalogový soubor nelze použít, protože obsahuje syntaktickou chybu. Tato chyba m˚uže znamenat, že katalogový soubor je uložen ve formátu, který neumí program pˇreˇcíst nebo soubor byl poškozen.
T There are no valid entries in table of input files Tuto operaci nelze provést, protože tabulka vstupních snímk˚u je prázdná. Použijte dialog "Add files"v nabídce "Files"pro vložení snímk˚u do tabulky. Too few data in source files Tuto operaci nelze provést, protože tabulka vstupních soubor˚u obsahuje pˇríliš málo použitelných snímk˚u. Podívejte se do uživatelské pˇríruˇcky na požadavky této funkce. Too few stars in the reference file Zadaný referenˇcní nebo katalogový soubor obsahuje pˇríliš málo hvˇezd pro provedení této operace. Ve vˇetšinˇe pˇrípad˚u tato chyba znamená, že byl vybrán nevhodný referenˇcní snímek (oblaˇcnost, zavˇrená závˇerka, apod.). Vyberte jiný snímek a zkuste provést seskládání ještˇe jednou. Too few stars in the source file Zdrojový fotometrický soubor obsahuje pˇríliš málo hvˇezd pro provedení této operace. Ve vˇetšinˇe pˇrípad˚u tato chyba indikuje, že zdrojový snímek má velmi špatnou kvalitu (oblaˇcnost, zavˇrená závˇerka, apod.). Toto není kritická chyba, ale tento snímek bude vyˇrazen z dalšího zpracování.
69
U Unknown error status Blíže nespecifikovaná chyba. Nˇekterý programový modul pˇredal kód výsledku operace, který není uveden v interní tabulce chybových kód˚u. Jedná se urˇcitˇe o chybu v programu, pošlete prosím hlášení autorovi. Unknown format of source file Zadaný vstupní soubor je zapsán ve formátu, který není v programu podporován. Tato chyba m˚uže znamenat, že vstupní soubor byl poškozen.
Z Zero value has been occurred on flat frame (can’t divide by zero) Výsledek výpoˇctu není platný, protože by došlo k dˇelení nulou. Toto není kritická chyba, m˚uže se objevit v pˇrípadˇe, že nˇekterý obrazový bod svˇetlého korekˇcního snímku je nulový. Tento pixel bude vyˇrazen z dalšího zpracování.
Použité zdroje Použité algoritmy a knihovny: Algoritmy použité pro redukci CCD snímk˚u pochází pˇrevážnˇe z originálního balíku Munipack, který je dostupný zdarma pod licencí GNU GPL. Grafické uživatelské rozhraní bylo inspirováno programem Munidos. • Pence, William Dr.: CFITSIO library, http://heasarc.gsfc.nasa.gov/fitsio/ • Clark, James: EXPAT library, http://www.libexpat.org/ • Hroch, Filip: Munipack, http://munipack.astronomy.cz/ • Novák, R. and Král L.: Munidos, http://munipack.astronomy.cz/ • Král, Lukáš: Varfind, soukromé sdˇelení • Bakis, Volcan: Air-mass computation algorithm, soukromé sdˇelení • Pokorný, Zdenˇek Dr.: Astronomické algoritmy pro kalkulátory, HaP hl. m. Prahy, 1984 • Drolon, Hervé et al.: FreeImage project, http://freeimage.sourceforge.net/ Vývojové nástroje: Pˇri vývoji software byl použit volnˇe dostupný pˇrekladaˇc z projektu Minimalist GNU for Windows. Grafické uživatelské rozhraní bylo vytvoˇreno v prostˇredí Borland Delphi 7. Binární instalaˇcní balíˇcky byly vytvoˇreny pomocí systému Nullsoft NSIS. Pro pˇreklad elektronické nápovˇedy byl použit volnˇe dostupný program HTML Help Workshop firmy Microsoft. Dokumentace byla vysázena v prostˇredí LATEX. • MinGW - Minimalist GNU for Windows, http://www.mingw.org/ • Nullsoft Scriptable Installation System, http://nsis.sf.net • MiKTeX project, http://www.miktex.org/ Katalogy promˇenných hvˇezd: Program umí vyhledádat souˇradnice promˇenných hvˇezd v následujících katalozích. Katalogy nejsou souˇcástí distribuce. Uživatelé je mohou zdarma získat na následujících adresách: • Sternberg Astronomical Institute: General Catalogue Of Variable Stars, http://www.sai.msu.su/groups/cluster/gcvs/gcvs/index.htm • Zejda, M. a kol.: Katalog BRKA, http://var.astro.cz/brno/