v1.3.11

V1.3.11

1.0 Fixes bug where running the script for the first time from the installation directory would fail
2.0 Deals with the case where the filter names in the light frames have trailing white spaces.
3.0 Modified script to take a new default parameter for the config file
The parameter is USEOBSDATE and if set to True, the actual date of the observation session is used when aggregating
data for the Astrobin .csv output. If this parameter is set to False, then the date the observation session was started is used.
4.0 Added progress counter to the HFR processing section of the screen output

v1.3.10

Version 1.3.10

• Corrected utf-8 encoding error with logging
• Reset index on group in summarise session such that group['target'].iloc[0] returns the correct value
• formatted time output seconds are now shown to 2dp
• allow the script to be called from an image directory and process the images in that directory but allows for calibration directories to be passed as arguments e.g. AstroBinUploadv1_3_7.py "." /home/user/images/calibration
• output files are written to the current image directory under a directory called "AstroBinUpload"
• modification to accept .fits files from MaximDL and ACP
• handle the case where a fractional part of a second is present in some date-obs keyword but not in others
• handle the case where the filter names in the l.fits files have trailing white spaces.

v1.3.3

Minor bug fix.

• Program halted when there were no MASTER calibration files found

v1.3.2- Feature enhancements and bug fixes

Contains the following changes:

Version 1.3.1

27th February 2024

• Modified debugging file dumps, so they occur after the data has been processed not all at the the end

Version 1.3.2

29th February 2024

• Code added to handle FOCUSER and SITENAME SGP-PRO keywords
• Code added to deal with situation where keyword pairs conflict with each other
• 'EXPTIME' and 'EXPOSURE' in the same data frame
• 'LAT-OBS' and 'SITELAT' in the same data frame
• Handles multiple MasterFlat frames for same filter
• Correctly total MasterFlat frames in summary and astrobin output
• Ensure all calibration frame locations are set equal to the nearest light frame location
• Stop calibration frames generating their own site location

v1.3.0

Release version 1.3.0 features

This release adds a number of features to the previous scripts functionality. The main aim of this release has been to augment the AstroBin upload capability with a more detailed observation session summary reporting capability.

Key features include:

• The ability to pass multiple directories via the command line: Multiple directories can be passed to the script via the command line. All images results contained within the directories will be accumulated as part of the target.

• Structured and unstructured directories: Image files, including calibration files, can be collected into a single directory, the root directory. The root directory structure can be flat or contain sub-directories.

• Symbolic links to directories: Symbolic links can be used within the root directory or passed directly via the command line, this is useful when reusing calibration directories. The first directory passed should be the root directory.

• MASTER calibration files: If MASTER calibration files are found, these will be used. If the non-MASTER versions of the MASTER files are also found, the non-MASTER versions will be ignored.Only MASTER files that can be matched with LIGHT file are processed.

• Processing of PixInsight's Weighted Batch Pre-processing (WBPP) output: When the target is a WBPP directory the script will use the calibrated LIGHT frames as well as any MASTER calibration files found in the directory. MASTERLIGHT or processed image files are ignored.

• Multiple panel mosaic imaging sessions: Mosaic imaging sessions are detected from the OBJECT entry in the FITS headers. LIGHT frames are processed on a per-panel basis, whilst calibration data is processed per target.

• Multiple site support: Multi-site collaborative target acquisition or remote observatory image capture is supported. Site location data is reverse-geocoded from HEADER location data. Data from multiple sites is reported with summary outputs that correctly identify the site contribution, for instance equipment, LIGHT, and calibration data. All data is, however, aggregated in the AstroBin.csv file for the image target.

• Support for multiple file formats: Extracts headers for all FITS/FIT/FTS/XISF files in specified directories. Directories can have a mix of files.

• Accepts files generated by N.I.N.A, SGPro and PixInsight

• Sky Quality Retrieval: Recovers SQM and Bortle scale classification based on the observation location coordinates.

• Auxiliary Parameter Calculation: Calculates additional parameters like Image Scale (IMSCALE), and Full-width Half Maximum (FWHM) from measured/estimated HFR values for each image.

• AstroBin Compatibility: Formats aggregated data for upload to AstroBin's import CSV file dialogue.

• Target summary: Creates a detailed summary text file for a target acquisition session. Caters for single or multi-site data as well as single or mosaic imaging data.

• **Logging and debugging file output **: Creates a detailed .log file as well as data dumps to .csv file if required

Release v1.0.4

Version 1.0.4
6th December 2023 changes

1.No longer required to manually create configuration csv files.
Checks if csv files exist and creates them if they do not exist.
Default values can still be edited in csv files but also in the configurations dictionary at the start of the code.
Default keywords changed to lower case
To ensure csv edits don't cause issues the data read from files is:
stripped of leading and trailing spaces
keywords are converted to upper case to match FITS header keywords
column names are converted to lower case to ensure code can work with them
corrected data frames are saved back to csv files to format issues are resolved
2. Improved extract header function
converts floats to 4 decimal places
converts dates to format %Y-%m-%d, rounds input to microseconds to ensure conversion works
creates a subset of the header data that matches AstroBin requirements
3.Sites.csv file latitudes and longitudes saved with 4 decimal places but processed to 2 decimal
places to ensure the same site is not recorded multiple times.
4. Corrected issue with Bortle and SQM values not being updated correctly
5. Corrected issue with Keywords from .XISF files not being read correctly
6. Improved code to correct file data reading and saving logic
7. Runtime option to stop program if new csv files are created to edit them.
8. Corrected program logic related to import, access and storage of external parmeters.
9. Refactored code to improve readability
10. Updated docstrings
11. Works with files generated by both Sequence Generator Pro (SGP) and NINA (.FITS, .FIT, .FTS, .XISF)
12. Looks for filter in FITS headers and converts them to 5 digit codes used by AstroBin ( use to be four digit codes)

AstroBin CSV uploader script v1.0.3

version 1.0.3

28th November 2023 release changes:

1. Handles pre and post text spaces in data from csv files
2. Can process FITS and XIFS files or a mixture of both
3. Focal ratio now extracted from header and reported.
4. Exports a session summary report

AstroBinUploader.py v1.02

Major changes to how the code handles missing Keywords from FITS headers.
The code use a defaults.csv to enable the user to configure values for missing keywords
These default keywords are then applied to all missing header keywords allowing for a more complete upload of information to AstroBin.
HFR is also recovered from the defaults.csv file, instead of the command line entry.
The changes attempt to make the code agnostic to the types of FITS headers processed.
ReadMe.md has been updated to reflect the changes

AstroBinUploaderv1.01

1. Code only checks LIGHT frames to determine if FITS was generated by NINA

AstroBin CSV Uploader

First release of AstroBinUpload.py