formats and headers supported / required by Siril?

Software Siril
1

Hi all,

I’m writing a no-frills (GPLv3) image capture (and guiding) app for the raspberry pi that resembles a DSLR interface.

I want to make sure that I include all the information I can for Siril. Can somebody please direct me to the part of the code (or docs) that lists all the headers / metadata that Siril expects? I know the code is here FA / Siril · GitLab and I have it checked out but after inspecting it for a little while I’m lost and can’t see where the headers are being loaded.

I’m most like going to be using FITs, but I’m considering using TIF… which would require some hacks to set custom metadata.

2

Once I figured out that EXPTIME is a known header value, I was able to find

File: src/io/fits_keywords.c
File: src/io/image_format_fits.c

which has some more headers in there. I guess I just need to read the code to find out what is supported and do each one at a time.

It’s still not clear to me what is required, or if everything is effectively optional.

3

Hi,

For the format, you can use tiff and use the description field to make the images follow the astro-tiff format: Astro-TIFF — Siril 1.4.0-beta1 documentation

Still, bear in mind users will then need to convert said tiff to fits to work within siril. Whereas fits can be linked to without conversion using symbolink links.

Then, regarding what’s necessary, there’s no such list because it would depend on what is the intended use. So Siril does not require “strictly” anything except dimensions and bitdepth, i think. The rest is then up to you.
A few recommendations though:

  • BAYERPAT and ROW-ORDER for proper debayering handling
  • DATE-OBS (required for comets)
  • EXPOSURE (required for dark optimization)
  • CVF (for photometry)
  • RA, DEC (for astrometry position)
  • FOCALLEN, BINX, PIXSZX for astrometry sampling calc
  • SITELAT, SITELIN, SITEELEV for solar system objects epehemerides
    Nice to have if relevant to organize masters
  • GAIN
  • OFFSET
  • SET-TEMP
  • FILTER

Check the exact syntax there: FITS — Siril 1.4.0-beta1 documentation

Cheers

C.

1 Like
4

fits turned out to be super easy to create with fitsio and the python wrapper even automatically converted my numpy arrays to calculate BZERO. My files load just fine in Siril so it seems that everything is optional! That said, I’m populating as much as I can :slight_smile: