asi_core.calibration.process_self_calibration

Tools to process and validate the all-sky imager geometric self calibration

Functions

calibrate_from_images(last_timestamp_calibration)	Main function for ASI self calibration (when used as a batch processing tool).
validate_from_images(last_timestamp_calibration[, ...])	Test a camera's IOR and EOR based on a csv of orb positions which were detected in advance
calibrate_from_csv()	Determine a camera's IOR and EOR based on a csv of orb positions which were detected in advance
validate_from_csv()	Test a camera's IOR and EOR based on a csv of orb positions which were detected in advance
sort_out_imgs_manually(calib, orb_data)	Use this function to copy images in which orbs were detected to the working dir. Then manually erase invalid images.
filter_detected_orbs(cfg_calib, orb_data)	Filter out low-quality orb observations.

Module Contents

asi_core.calibration.process_self_calibration.calibrate_from_images(last_timestamp_calibration)

Main function for ASI self calibration (when used as a batch processing tool).

Instantiate the self calibration process and determine the ASI’s calibration (IOR + EOR).

Parameters:

last_timestamp_calibration – Timestamp indicating the end of the calibration period

asi_core.calibration.process_self_calibration.validate_from_images(last_timestamp_calibration, path_calib_results=None)

Test a camera’s IOR and EOR based on a csv of orb positions which were detected in advance

Parameters:

• last_timestamp_calibration – tz-aware datetime, last timestamp included in the calibration to be validated

• path_calib_results – str, path to mat file of calibration results to be validated

asi_core.calibration.process_self_calibration.calibrate_from_csv()

Determine a camera’s IOR and EOR based on a csv of orb positions which were detected in advance

asi_core.calibration.process_self_calibration.validate_from_csv()

Test a camera’s IOR and EOR based on a csv of orb positions which were detected in advance

asi_core.calibration.process_self_calibration.sort_out_imgs_manually(calib, orb_data)

Use this function to copy images in which orbs were detected to the working dir. Then manually erase invalid images.

If you may run calibrate_from_csv twice on the same set of images and you have already sorted out the images manually in the first run answer ‘no’ to the question ‘Do you really want to copy images to used_imgs folder?’.

If the RMSD is larger then around 6 consider manually sorting out images with clouds in the area around the sun and images where the sun disk would be cut/ obscured by the mask boundary. Otherwise you can save time and skip the manual sorting.

Parameters:

• calib – Calibration instance

• orb_data – Dataframe of astronomically expected and image-processing-based orb positions

Returns:

Dataframe orb_data without rows for which the corresponding images were sorted out manually

asi_core.calibration.process_self_calibration.filter_detected_orbs(cfg_calib, orb_data)

Filter out low-quality orb observations.

Parameters:

• cfg_calib – Dictionary with configuration parameters

• orb_data – Dataframe of orb observations

Returns:

Filtered of with orb observations