dbernardes / ffile_man

FITS file manager

Welcome to the FITS File Manager repository

The FITS File Manager (ffile_man) is a package developed to assist you in the management of large sets of image files. Using ffile_man, the data can be sorted into file groups, according to their purpose, like calibration and scientific data. For that, ffile_man looks for the DATE-OBS and OBSTYPE keywords in the image header. The former is the timestamp in which the image was acquired and it is used to sort the images as a function of time. The latter is used to sort by the type of the observation.

In this article, we will give you the basics of how to start using ffile_man.

Installing the package

Use the pip command to install the package into your local computer.

pip install ffile-man

How to use this package

To see how the package works, we prepared a ZIP file named example.zip that you can download in this link. This ZIP file has an script named example.ipynb and a folder containing a set of dummy images that can be provided to the package. Once you have this package installed, you will be able to open the file example.ipynb found in the root folder. Opening this file you will see three cell containing some examples of how to use the package. These examples use the set of FITS files present in the ./FITS folder.

• The first example will print all the files found in the folder.
• The second will print the files with a timestamp greater than 2024-7-17T12:11:00 (isot).
• The third will print the files whose OBSTYPE keyword matches the FLAT and ZERO strings.

How to cite

Was this package useful for you? Think about citing us!

Following are two examples of how this package can be cited.

Plain text

Denis and Balaji-0-5, “FITS File Manager”. Zenodo, July 17, 2024. doi: 10.5281/zenodo.12763958.

Bibtex code

@software{denis_2024_12763958,
  author       = {Denis and
                  Balaji-0-5},
  title        = {FITS File Manager},
  month        = Jul,
  year         = 2024,
  publisher    = {Zenodo},
  version      = {v0.1.1},
  doi          = {10.5281/zenodo.12763958},
  url          = {https://doi.org/10.5281/zenodo.12763958}
}