216 lines
16 KiB
Plaintext
216 lines
16 KiB
Plaintext
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd">
|
|
<head>
|
|
<style type="text/css">
|
|
h1, h2, h3, h4 { padding:0px; margin:10px; }
|
|
p { padding:0px; margin:5px 5px 10px 5px; }
|
|
</style>
|
|
</head>
|
|
<body>
|
|
<h2>Tenmon pomocník</h2>
|
|
|
|
<p>Tenmon slúži primárne na zobrazenie astronomických fotiek a obrázkov. Dokáže otvoriť nasledovné formáty:
|
|
<ul>
|
|
<li>FITS 8, 16, 32 bitové celočíselné 32 a 64 bitové s plávajúcou čiarkou</li>
|
|
<li>XISF 8, 16, 32 bitové celočíselné 32 a 64 bitové s plávajúcou čiarkou</li>
|
|
<li>JPEG, PNG, BMP, GIF, PBM, PGM, PPM a SVG obrázky</li>
|
|
<li>CR2, CR3, NEF, DNG raw obrázky</li>
|
|
</ul>
|
|
</p>
|
|
|
|
<h3>Hlavné okno</h3>
|
|
<p>V hlavnom okne sa zobrazujú načítané obrázky. Naľavo sú potom <i>Informácie o obrázku</i> kde sa zobrazujú podrobné
|
|
informácie o aktuálnom obrázku a <i>Zoznam súborov</i> kde sú všetky obrázky z adresára kde je aktuálne zobrazený obrázok.
|
|
Hore je hlavné menu a pod ním je <i>Panel úrovní</i>. Všetky panely sa dajú zavrieť a presúvať. Zatvorený panel sa dá znova
|
|
zobraziť v menu <i>Dokovacie panely</i>.
|
|
</p>
|
|
|
|
<h3>Otváranie a ukladanie obrázkov</h3>
|
|
<p>Otvoriť obrázok je možné v menu <i>Súbor->Otvoriť</i>. Po vybraní súboru ktorý sa má otvoriť je
|
|
tento zobrazený v hlavnom okne. Taktiež sú v panely <i>Súborový systém</i> zobrazené ďalšie obrázky v
|
|
adresári kde sa nachádza zobrazený obrázok.</p>
|
|
<p>Aktuálne zobrazený obrázok je možné uložiť v inom formáte cez voľbu <i>Súbor->Ulož ako</i>. Dá sa vybrať
|
|
formát JPEG, PNG, FITS a XISF. V prípade JPEG alebo PNG sa aplikuje funkcia na úpravu úrovní. Pri FITS a XISF
|
|
sa dáta skonvertujú bez zmeny úrovní.</p>
|
|
|
|
<h3>Zobrazenie</h3>
|
|
<p>Menu <i>Zobrazenie</i> ovplyvňuje veľkosť a škálu zobrazovaných obrázkov.
|
|
<i>Priblížiť/Oddialiť</i> zväčší a zmenší obrázok. Na toto tiež slúži aj kolečko myši. <i>Najlepšia veľkosť</i> zobrazí
|
|
obrázok tak aby bol zobrazený na celú plochu. <i>100%</i> zobrazí obrázok v pomere 1:1. <i>Celá obrazovka</i> zobrazí
|
|
hlavné okno na celú obrazovku. <i>Náhľady</i> zobrazí malé náhľady pre všetky obrázky z aktuálneho adresára.
|
|
</p>
|
|
|
|
<h3>Panel úrovní</h3>
|
|
<p>
|
|
Tento panel umožňuje upraviť spôsob ako sa zobrazujú obrazové dáta. Ako prvá je na tomto panely posuvná škála
|
|
na ktorej sa dajú nastaviť tri body.
|
|
<br><br><img src=":/about/stretch-panel.png">
|
|
<ul>
|
|
<li>čierny bod - všetky pixeli s hodnotou menšou ako nastavená budú zobrazené ako čierne</li>
|
|
<li>stredný bod - pixeli s touto hodnotou budú zobrazené ako 50% šedá</li>
|
|
<li>biely bod - pixeli nad touto hodnotou budú zobrazené ako biele</li>
|
|
</ul>
|
|
Prvé tlačidlo prepína prepojenie nastavenia čierneho, stretdného a bieleho bodu. Po prepnutí sa dá každý farebný kanál nastaviť
|
|
samostatne.
|
|
Nasleduje tlačidlo ktoré nastaví hodnoty čierneho a stredného bodu tak aby bol obrázok zobrazený optimálnym jasom.
|
|
Druhé tlačidlo resetuje hodnoty pre čierny, stredný a biely bod na východzie hodnoty. Invertovanie farieb zobrazí obrázok ako negatív.
|
|
Falošné farby zobraí čiernobiele obrázky vo farebnej škále.
|
|
Prevoď CFA na farbu prevedie demozaikovanie čiernobieleho obrázku na farebný.
|
|
Posledné tlačidlo zapína a vypína nastavovanie optimálnych hodnôt úrovní pre každý obrázok zvlášť.</p>
|
|
|
|
<h3>Označovanie obrázkov</h3>
|
|
<p>Obrázky je možné si označiť cez menu <i>Výber</i>. Zoznam takto označených obrázkov sa dá zobraziť cez
|
|
<i>Výber->Ukázať označené</i>. V tomto dialógu sa dá tiež tento zoznam upraviť. Okrem toho sa pri označených
|
|
obrázkoch zobrazuje znak * v záhlaví hlavného okna. Takto označené obrázky je potom možné skopírovať alebo
|
|
presunúť do vybraného adresára pomocou <i>Súbor->Skopírovať/Presunúť označené súbory</i>. Po skopírovaní alebo
|
|
presunutú sa zoznam označených obrázkov vymaže. Program si tento zoznam pamätá aj po svojom ukončení.</p>
|
|
<p>Ďalší spôsob ako označiť obrázky je cez databázu FITS/XISF kde je možné vybrať jednotlivé riadky. Potom stačí
|
|
vybrať označit alebo odznačiť v kontextovom menu. Označené súbory budú zobrazené tučným textom. Tretí spôsob na označenie
|
|
obrázkov je možné cez náhľady. Držaním <i>Shift</i> a následne kliknutím ľavým tlačítkom myši sa daný obrázok označí.
|
|
Pre odznačenie je treba držať <i>Ctrl</i></p>
|
|
|
|
<h3>Databáza FITS/XISF súborov</h3>
|
|
<p>Program vie prehľadať adresár a indexovať meta údaje z FIST a XISF obrázkov do internej databázy v ktorej sa dá
|
|
následne vyhľadávať. Najprv je treba indexovať adresár s FIST/XISF obrázkami <i>Súbor->Indexovať adresár</i>.
|
|
Vybraný adresár je prehľadaný a meta údaje z FIST a XISF obrázkov sú uložené do databázy. Na kontrolu a obnovu datábazy
|
|
je možné spustiť re-indexáciu <i>Súbor->Reindex</i>. Toto obnoví zmenené údaje a odstráni záznamy o už neexistujúcich súboroch.
|
|
Pre indexovanie nových súborov je treba znova pustiť indexáciu.</p>
|
|
<p>Pre zobrazenie databázy je treba zobraziť jej panel cez <i>Dokovacie panely->Databáza FITS/XISF súborov</i>. Databáza je zobrazená vo forme tabuľky
|
|
kde sú jednotlivé stĺpcoch zobrazené vybrané vlastnosti. V spodnej časti panelu je tlačidlo ktoré zobrazí dialóg na výber zobrazovaných
|
|
sĺpcov. Nasledujú tri výberové a textové polia. Tieto slúžia na vyhľadávanie v databáze. Výberové pole určuje stĺpec v ktorom sa
|
|
má vyhľadávať a do textového poľa sa zadáva hodnota na vyhľadanie.
|
|
|
|
<p>Zastupné znaky:
|
|
<ul>
|
|
<li><b>%</b> (percent) je zastupný znak reprezentujúci žiadný alebo hocikoľko znakov.</li>
|
|
<li><b>_</b> (underscore) je zastupný znak nahrádzajúci presne jeden znak.</i>
|
|
<li>Bez zástupných znako sa hľadá presná zhoda.</li>
|
|
</ul>
|
|
</p>
|
|
|
|
<br><img src=":/about/filter.png"><br>
|
|
V nasledovnom príklade sa vyhľadajú súbory ktoré majú v mene súboru "Bias", OBJECT je M_42 a DATE začína reťazcom 2022. Znak % sa berie ako
|
|
zástupný znak za hocijaký reťazec znakov aj žiadny. Znak _ je tiež zástupný znak zastupujúci práve jeden znak.
|
|
Bez použitia zástupných znakov sa vyhľadá iba presný výskyt.</p>
|
|
|
|
<h3>Hromadné spracovanie</h3>
|
|
|
|
Tento modul umožnuje písanie skriptov v JavaScripte ktoré spracujú súbory obrázkov. Okno Hromadného spracovanie pozostáva z troch častí. Navrchu je zoznam vstupných súborov a adresárov.
|
|
Do zoznamu môžete pridať adresáre alebo jednotlivé súbory. Adresáre sú rekurzívne prehľadané na všetky súbory. Zoznam súborov je potom predaný do skriptu ako pole nazvané <b>files</b>.
|
|
V skripte potom cez toto pole iteruje nasledovne.
|
|
<pre>for(file in files)
|
|
{
|
|
if(file.suffix() == "fits")
|
|
{
|
|
core.log(file.fileName());
|
|
file.convert(file.relativeFilePath(), "XISF");
|
|
}
|
|
}
|
|
</pre>
|
|
|
|
<h4>core</h4>
|
|
V skripte je dostupný globálny objekt nazvaný <b>core</b> ktorý má nasledovné metódy.
|
|
<ul>
|
|
<li><b>log(message)</b> vypíše message do okna záznamu.</li>
|
|
<li><b>mark(file)</b> označí súbor rovnako ako cez GUI. Parameter je objekt typu <i>File</i>.</li>
|
|
<li><b>unmark(file)</b> odznačí súbor rovnako ako cez GUI. Parameter je objekt typu <i>File</i>.</li>
|
|
<li><b>isMarked(file)</b> overenie či je súbor označený. Parameter je objekt typu <i>File</i>.</li>
|
|
<li><b>setMaxThread(maxthread)</b> nastavý maximálny počet paralelných vlákien pri vykonávaní asynchrónnych úloh.</li>
|
|
<li><b>sync()</b> počká kým sa dokončia všetky asynchrónne úlohy.</li>
|
|
<li><b>getString(label = "", text = "")</b> ukáže dialóg pre získanie textovej hodnoty od používateľa. Prvý parameter je textový popis. Druhý parameter je východzia hodnota. Obydva parametre sú voliteľné takže aj volanie <i>getString()</i> je valdiné.
|
|
Metoda vracia textový retazec alebo Undefined ak bolo stlačené tlačidlo zrušiť.</li>
|
|
<li><b>getInt(label = "", value = 0)</b> ukáže diálog pre získanie celočíselnej hodnoty. Prvý parameter je textový popis. Druhý parameter je východzia hodnota. Obydva parametre sú voliteľné. Vracia zadané číslo alebo ak je stlačené tlačidlo zrušiť vráti Undefined.</li>
|
|
<li><b>getFloat(label = "", value = 0, decimals = 3)</b> ukáže diálog pre získanie reálneho čísla. Prvý parameter je textový popis. Druhý parameter je východzia hodnota. Tretí parameter je počet desatinných miest.
|
|
Obydva parametre sú voliteľné. Vracia zadané číslo alebo ak je stlačené tlačidlo zrušiť vráti Undefined.</li>
|
|
<li><b>getItem(items)</b> ukáže dialog pre výber jednej hodnoty z poľa hodnôt. Vracia vybranú hodnotu ako String alebo ak je stlačené tlačidlo zrušiť vráti Undefined.</li>
|
|
<li><b>setStartingSolution(solution)</b> with this you can set starting point and image scale. It accepth object with attributes "ra", "dec", "pixscale".
|
|
Same object as returned by <i>File.solve()</i> method. You can also call it without paramer in which case it will clear any previously set values.</li>
|
|
</ul>
|
|
|
|
<h4>File</h4>
|
|
V poli <b>files</b> sú inštancie objektu typu <b>File</b> ktorý ma nasledovné metódy.
|
|
<ul>
|
|
<li><b>fileName()</b> returns the name of the file, excluding the path.</li>
|
|
<li><b>absoluteFilePath()</b> returns an absolute path including the file name.</li>
|
|
<li><b>absolutePath()</b> returns an absolute path without the file name</li>
|
|
<li><b>relativeFilePath()</b> return relative path including file name relative to directory that was in list of directories to be scanned. For example you add C:/images as input directory. In this directory there
|
|
is file <i>C:/images/lights/red/M42_001.fits</i> then this method will return <i>lights/red/M42_001.fits</i></li>
|
|
<li><b>relativePath()</b> return same path as previous method just without file name. <i>lights/red</i></li>
|
|
<li><b>baseName()</b> return file name up to the first dot. For example for <i>some.file.name.fits</i> it will return <i>some</i></li>
|
|
<li><b>completeBaseName()</b> return file name up to the last dot. For example for <i>some.file.name.fits</i> it will return <i>some.file.name</i></li>
|
|
<li><b>suffix()</b> return string after last dot in file name. For example <i>fits</i></li>
|
|
<li><b>size()</b> return size of file in bytes.</li>
|
|
<li><b>fitsKeywords()</b> return array of strings with every keyword that is in header. <i>SIMPLE,BITPIX,NAXIS,NAXIS1,NAXIS2,EXTEND,COMMENT</i></li>
|
|
<li><b>fitsValue(key)</b> return value for keyword. In case that there is multiple occurrences it return last one.</li>
|
|
<li><b>fitsValues(key)</b> return array of values for keyword.</li>
|
|
<li><b>fitsRecords()</b> return array of objects with properties <b>key, value</b> and <b>comment</b> </li>
|
|
<li><b>modifyFITSRecords(FITSRecordModify)</b> modify FITS header by adding, removing or updating FITS record. Return true on success. Refer to <i>FITSRecordModify</i></li>
|
|
<li><b>isMarked()</b> return true if file is marked.</li>
|
|
<li><b>copy(newpath)</b> copy file to new location. It return instance of new <i>File<i> object that represent this copied file. This path can be relative or absolute. In case that <i>newpath</i> parameter is relative
|
|
path then it "Output directory" from GUI windows is used as base directory. Parameter <i>newpath</i> can absolute path. File is then copied to this path. In case that copy fail it return null.</li>
|
|
<li><b>move(newpath)</b> move file to new location. It return false if move failed. This can happend if destination is not writable but also if destination file already exist. This functions does not overwrite existing file.
|
|
This path can be relative or absolute. In case that <i>newpath</i> parameter is relative path then it "Output directory" from GUI windows is used as base directory. Parameter <i>newpath</i> can be absolute path.
|
|
File is then moved to this path.</li>
|
|
<li><b>convert(outpath, format, params)</b> convert image file from any format that program is able to open into FITS, XISF, JPEG, PNG, BMP.
|
|
Parameters are: <i>outputpath</i> path where converted image will be saved. It automatically replace suffix according to format. <i>format</i> one of "FITS" "XISF", "JPG", "PNG" or "BMP". <i>params</i> object with attributes "compressionType" and "compressionLevel".
|
|
Valid values for compressionType are be "gzip" or "rice" when converting to FITS. When converting to XISF compressionType can be "zlib", "lz4", "lz4hc", "zstd", "zlib+sh", "lz4+sh", "lz4hc+sh", "zstd+sh".
|
|
It is recommended to use "+sh" variants of compression.
|
|
XISF format also accept "compressionLevel" in range 0-100 where zero is fastest compression and 100 slowest. If you omit this attribute or set it to -1 then default compression level will be used.
|
|
It return new instance of <i>File</i> that point to converted file.
|
|
<pre>file.convert("converted_file.xisf", "xisf", {"compressionType": "zstd+sh", "compressionLevel": 70});
|
|
file.convert("converted_file.fits", "fits", {"compressionType": "rice"});
|
|
file.convert("converted_file.jpg", "png");</pre>
|
|
</li>
|
|
<li><b>convertAsync(outpath, format, params)</b> same as previous method but it does conversion in separated thread asynchronously and in parallel. Before calling any method on object returned by this method you must call
|
|
<code>core.sync();</code> to ensure that conversion is done and destination file exists.
|
|
<pre>let compression = {"compressionType": "zstd+sh"};
|
|
let convertedFiles = [];
|
|
for(file of files)
|
|
{
|
|
if(file.suffix() == "fits")
|
|
convertedFiles.push(file.convertAsync("xisf/" + file.fileName(), "XISF", compression));
|
|
}
|
|
core.sync(); // ensure that files exist
|
|
for(file of convertedFiles)// now we can iterate over the files
|
|
{
|
|
core.log(file.fileName() + " " + file.size()); // let print compressed file sizes
|
|
}</pre></li>
|
|
<li><b>stats()</b> calculate basic images statistics and return them as object with attributes "mean", "stddev", "median", "min", "max" and "mad".
|
|
<pre>let s = file.stats();
|
|
core.log("Median value is " + s.median);</pre></li>
|
|
<li><b>solve(updateHeader)</b> this method will run plate solving on this image and will return solution in form of object with these attributes "ra" and "dec" which are center coordinates of image
|
|
"fieldWidth" and "fieldHeight" which is FOV of image in arcseconds, "orientation" is degrees east of north, "pixscale" scale of image in arcseconds per pixel,
|
|
"parity" true false value if the image was flipped in vertical direction, "raError" and "decError" deviation from starting point.
|
|
When updateHeader is set to true it update FITS header for file with this solution. Default value is false.</li>
|
|
<li><b>extractStars(hfr)</b> extract stars will run extraction of stars. When parameter hfr is set to true it will fit HFR on every star.
|
|
It return array of objects representing extracted stars. Each object in array
|
|
will have these attributes "x" and "y" pixel coordinates of center of star, "mag" relative magnitude of star, "flux" total flux, "peak" peak value of star, "HFR" half flux radius of star,
|
|
"a" and "b" semi major and minor axis of star, "theta" angle of orientation of the star, "ra" and "dec" coordinates of star, "numPixels" number of pixel occupied by the star in image.</li>
|
|
</ul>
|
|
|
|
<h4>FITSRecordModify</h4>
|
|
This class is used to define modify operation FITS header in FITS and XISF files. It can remove update and add records. Order of operation is also remove then update and last add.
|
|
The keyword names may be up to 8 characters long and can only contain uppercase letters, the digits 0-9, the hyphen, and the underscore character.
|
|
<pre>let modify = new FITSRecordModify();
|
|
modify.updateKeyword("OBJECT", "M42");
|
|
modify.updateKeyword("MYTILE", "PART1", "adding custom keyword so WBPP can group it");
|
|
modify.removeKeyword("OBJECT");
|
|
// doesn't matter that it is specified as last. This will first remove
|
|
// existing OBJECT record and then add again OBJECT=M42
|
|
for(file in files)
|
|
{
|
|
file.modifyFITSRecords(modify);
|
|
}</pre>
|
|
|
|
<ul>
|
|
<li><b>new FITSRecordModify()</b> create new instance of object.</li>
|
|
<li><b>removeKeyword(key);</b> specify removing of record with <i>key</i> as keyword.</li>
|
|
<li><b>updateKeyword(key, value, comment = "")</b> specify updating existing keyword with value and comment. Comment is optional parameter. If record with keyword doesn't exist then it will add new one.
|
|
Unless you want to have multiple records with same keyword (for example HISTORY) always use this method and not addKeyword.</li>
|
|
<li><b>addKeyword(key, value, comment = "")</b> specify adding new keyword</li>
|
|
</ul>
|
|
|
|
|
|
<p><small>PS: Kanji v ikone programu znamená "astronomia" v Japončine</small></p>
|
|
</body>
|
|
</html>
|