Tenmon pomocník

Tenmon slúži primárne na zobrazenie astronomických fotiek a obrázkov. Dokáže otvoriť nasledovné formáty:

• FITS 8, 16, 32 bitové celočíselné 32 a 64 bitové s plávajúcou čiarkou
• XISF 8, 16, 32 bitové celočíselné 32 a 64 bitové s plávajúcou čiarkou
• JPEG, PNG, BMP, GIF, PBM, PGM, PPM a SVG obrázky
• CR2, CR3, NEF, DNG raw obrázky

Hlavné okno

V hlavnom okne sa zobrazujú načítané obrázky. Naľavo sú potom Informácie o obrázku kde sa zobrazujú podrobné informácie o aktuálnom obrázku a Zoznam súborov 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 Panel úrovní. Všetky panely sa dajú zavrieť a presúvať. Zatvorený panel sa dá znova zobraziť v menu Dokovacie panely.

Na spodnom okraji okna je lišta v ktorej sa ukazuje aktuálna hodnota pixelu pod kurzorom a ak má obrázok WCS dátá aj aktuálne celestiálne koordináty.

Otváranie a ukladanie obrázkov

Otvoriť obrázok je možné v menu Súbor->Otvoriť. Po vybraní súboru ktorý sa má otvoriť je tento zobrazený v hlavnom okne. Taktiež sú v panely Súborový systém zobrazené ďalšie obrázky v adresári kde sa nachádza zobrazený obrázok.

Aktuálne zobrazený obrázok je možné uložiť v inom formáte cez voľbu Súbor->Ulož ako. 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í.

Zobrazenie

Menu Zobrazenie ovplyvňuje veľkosť a škálu zobrazovaných obrázkov. Priblížiť/Oddialiť zväčší a zmenší obrázok. Na toto tiež slúži aj kolečko myši. Najlepšia veľkosť zobrazí obrázok tak aby bol zobrazený na celú plochu. 100% zobrazí obrázok v pomere 1:1. Celá obrazovka zobrazí hlavné okno na celú obrazovku. Náhľady zobrazí malé náhľady pre všetky obrázky z aktuálneho adresára.

Panel úrovní

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.

• čierny bod - všetky pixeli s hodnotou menšou ako nastavená budú zobrazené ako čierne
• stredný bod - pixeli s touto hodnotou budú zobrazené ako 50% šedá
• biely bod - pixeli nad touto hodnotou budú zobrazené ako biele

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ášť.

Označovanie obrázkov

Obrázky je možné si označiť cez menu Výber. Zoznam takto označených obrázkov sa dá zobraziť cez Výber->Ukázať označené. 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 Súbor->Skopírovať/Presunúť označené súbory. 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í.

Ď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 Shift a následne kliknutím ľavým tlačítkom myši sa daný obrázok označí. Pre odznačenie je treba držať Ctrl

Databáza FITS/XISF súborov

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 Súbor->Indexovať adresár. 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 Súbor->Reindex. 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.

Pre zobrazenie databázy je treba zobraziť jej panel cez Dokovacie panely->Databáza FITS/XISF súborov. 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.

Zastupné znaky:

• % (percent) je zastupný znak reprezentujúci žiadný alebo hocikoľko znakov.
• _ (underscore) je zastupný znak nahrádzajúci presne jeden znak.
• Bez zástupných znako sa hľadá presná zhoda.

Hromadné spracovanie

for(file in files)
{
    if(file.suffix() == "fits")
    {
        core.log(file.fileName());
        file.convert(file.relativeFilePath(), "XISF");
    }
}

core

• log(message) vypíše message do okna záznamu.
• mark(file) označí súbor rovnako ako cez GUI. Parameter je objekt typu File.
• unmark(file) odznačí súbor rovnako ako cez GUI. Parameter je objekt typu File.
• isMarked(file) overenie či je súbor označený. Parameter je objekt typu File.
• setMaxThread(maxthread) nastavý maximálny počet paralelných vlákien pri vykonávaní asynchrónnych úloh.
• sync() počká kým sa dokončia všetky asynchrónne úlohy.
• getString(label = "", text = "") 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 getString() je valdiné. Metoda vracia textový retazec alebo Undefined ak bolo stlačené tlačidlo zrušiť.
• getInt(label = "", value = 0) 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.
• getFloat(label = "", value = 0, decimals = 3) 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.
• getItem(items) 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.
• setStartingSolution(solution) with this you can set starting point and image scale. It accepth object with attributes "ra", "dec", "pixscale". Same object as returned by File.solve() method. You can also call it without paramer in which case it will clear any previously set values.
• getSolverProfile() return solver profile as Object.

  var profile = core.getSolverProfile();
  core.log(JSON.stringify(profile));

• setSolverProfile(index) set solver profile by index. Valid values are from 1 to 8 as in GUI.
• setSolverProfile(profile) set solver profile. Parameter is same as object returned by getSolverProfile() method
• question(question, buttons, title = "") show dialog with question. First argument question is string. Second argument buttons is array of following strings. "ok", "yes", "no", "yesall", "noall", "abort", "retry", "ignore", "cancel", "discard", "apply", "reset" Third argument title is optional string that show in title bar. It return button that was clicked as a string.

  var button = core.question("Apply to all files?", ["yes", "no"]);

• plot(graph) this method show graph defined by JS object.

  var chart = {
      "title": "Chart title", // Title that will show on top of chart
      "legend":
      {
          "visible": true,// default is true
          "align": "left" // allowed values are "top", "right", "bottom", "left". default is "top"
      },
      "series":[ // array of data series
          {
              "title": "HFR",
              "type": "bar", // type of the serie. Can be one of "line", "points", "linePoints", "bar"
              "y":[2.5,3.1,2.6,2.2] // array of values
          },
          {
              "title": "Ecc",
              "y":[0.37, 0.4, 0.35, 0.25],
              "color": "red" // color of serie. It can be name of color like "green" or RGB hex value "#ccddff"
          },
          {
              "title": "Stars",
              "type": "points", // type of serie. can be "line", "points", "linePoints" and "bar". Default is "line"
              "shape": "star", // shape of markers. valid only for points
              "x":[1, 2.5, 3.5, 6],// line, points and linePoints can also have "x" values. Otherwise it assume sequence 0,1,2 ...
              "y":[523,412,487,510],
              "y2": true, // if set to true this serie will use secondary Y axis
              "bestFit": true, // show best fit line
              "color": "#0000ff"
          }
      ]
  };
  
  core.plot(chart);
  

File

• fileName() returns the name of the file, excluding the path.
• absoluteFilePath() returns an absolute path including the file name.
• absolutePath() returns an absolute path without the file name
• relativeFilePath() 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 C:/images/lights/red/M42_001.fits then this method will return lights/red/M42_001.fits
• relativePath() return same path as previous method just without file name. lights/red
• baseName() return file name up to the first dot. For example for some.file.name.fits it will return some
• completeBaseName() return file name up to the last dot. For example for some.file.name.fits it will return some.file.name
• suffix() return string after last dot in file name. For example fits
• size() return size of file in bytes.
• fitsKeywords() return array of strings with every keyword that is in header. SIMPLE,BITPIX,NAXIS,NAXIS1,NAXIS2,EXTEND,COMMENT
• fitsValue(key) return value for keyword. In case that there is multiple occurrences it return last one.
• fitsValues(key) return array of values for keyword.
• fitsRecords() return array of objects with properties key, value and comment
• modifyFITSRecords(FITSRecordModify) modify FITS header by adding, removing or updating FITS record. Return true on success. Refer to FITSRecordModify
• isMarked() return true if file is marked.
• copy(newpath) copy file to new location. It return instance of new File object that represent this copied file. This path can be relative or absolute. In case that newpath parameter is relative path then it "Output directory" from GUI windows is used as base directory. Parameter newpath can absolute path. File is then copied to this path. In case that copy fail it return null.
• move(newpath) 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 newpath parameter is relative path then it "Output directory" from GUI windows is used as base directory. Parameter newpath can be absolute path. File is then moved to this path.
• convert(outpath, format, params) convert image file from any format that program is able to open into FITS, XISF, JPEG, PNG, BMP. Parameters are: outputpath path where converted image will be saved. It automatically replace suffix according to format. format one of "FITS" "XISF", "JPG", "PNG", "TIFF" or "BMP". params 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 File that point to converted file.

  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");

• convertAsync(outpath, format, params) 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 core.sync(); to ensure that conversion is done and destination file exists.

  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
  }

• stats() calculate basic images statistics and return them as object with attributes "mean", "stddev", "median", "min", "max" and "mad".

  let s = file.stats();
  core.log("Median value is " + s.median);

• solve(updateHeader) 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.
• extractStars(hfr) 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.

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);
}