SkyFit2 - Revision history

Dvida: /* Create or Upgrade a Plate with SkyFit2 */

2023-03-10T15:39:13Z

Create or Upgrade a Plate with SkyFit2

← Older revision		Revision as of 10:39, 10 March 2023
Line 146:		Line 146:
	python -m Utils.SkyFit2 /PATH/TO/DATA/DIRECTORY/ --config . --timebeg 20230214_021629.0		python -m Utils.SkyFit2 /PATH/TO/DATA/DIRECTORY/ --config . --timebeg 20230214_021629.0

	If you are using just one image, SkyFit will ask which image to open (you should have only one in the directory, together with the config file).		If you are using just one image, use the command above and SkyFit will ask which image to open (you should have only one in the directory, together with the config file).

	== Creating a Plate ==		== Creating a Plate ==

Dvida: /* Using arbitrary video data */

2023-03-10T15:38:50Z

Using arbitrary video data

← Older revision		Revision as of 10:38, 10 March 2023
Line 97:		Line 97:


	=== Using arbitrary video data ===		=== Using arbitrary video or image data ===

	~~If you~~ are using a video from e.g. a security camera in either a .avi, .mp4, or in a .mov format, ~~you~~ will need to make a custom configuration file and know the absolute time of the first frame.		This section applies if:
			a) You are using a video from e.g. a security camera in either a .avi, .mp4, or in a .mov format.
			b) Or you are using a sequence of images (make sure their names are sorted alphabetically, e.g. frame001.png, frame002.png, etc.). Using just one image works too, then SkyFit2 will run in a special "single-image mode".

			You will need to make a custom configuration file and know the absolute time of the first frame.

	First, copy the .config file from the RMS source directory to the directory with the video and rename it with the name of the station (we'll use "London" as the station name), e.g. london.config. Then open this file and change the following entries:		First, copy the .config file from the RMS source directory to the directory with the video and rename it with the name of the station (we'll use "London" as the station name), e.g. london.config. Then open this file and change the following entries:
Line 138:		Line 142:


			If you are using a sequence of images, then give it the path to the directory which contains the images:

			python -m Utils.SkyFit2 /PATH/TO/DATA/DIRECTORY/ --config . --timebeg 20230214_021629.0

			If you are using just one image, SkyFit will ask which image to open (you should have only one in the directory, together with the config file).

	== Creating a Plate ==		== Creating a Plate ==

Dvida at 21:24, 9 March 2023

2023-03-09T21:24:27Z

← Older revision		Revision as of 16:24, 9 March 2023
Line 2:		Line 2:

	We aim to make SkyFit as user-friendly and universal as possible. It aims to support all optical meteor data formats in existence (videos and still images), as well as calibrating dashcams.		We aim to make SkyFit as user-friendly and universal as possible. It aims to support all optical meteor data formats in existence (videos and still images), as well as calibrating dashcams.

			A full video tutorial is available on [https://www.youtube.com/watch?v=ao3J9Jf0iLQ YouTube].

Dvida at 18:41, 6 March 2023

2023-03-06T18:41:05Z

← Older revision		Revision as of 13:41, 6 March 2023
Line 2:		Line 2:

	We aim to make SkyFit as user-friendly and universal as possible. It aims to support all optical meteor data formats in existence (videos and still images), as well as calibrating dashcams.		We aim to make SkyFit as user-friendly and universal as possible. It aims to support all optical meteor data formats in existence (videos and still images), as well as calibrating dashcams.


			=== Example data ===

			Here is some data if you don't have any of your own yet: [https://www.dropbox.com/s/gy023qg7bsobrjp/RU_fireball_20190910.zip?dl=0 data link]
			This is data from one fireball observed over the Caucasus Mountains in 2019. You should have everything here for a trajectory solution, and one is already provided in the software. Note that the .config files might be hidden - files beginning with a dot are hidden by default in Linux.

	= SkyFit2 Anatomy =		= SkyFit2 Anatomy =

Dvida at 14:46, 2 March 2023

2023-03-02T14:46:02Z

← Older revision		Revision as of 09:46, 2 March 2023
Line 1:		Line 1:
			SkyFit2 is a tool used to make astrometric plates and photometric calibrations. An astrometric plate is used to convert measurements on the image to coordinates in the sky (e.g. right ascension and declination). Photometric calibration converts the image pixel intensity to magnitude.

			We aim to make SkyFit as user-friendly and universal as possible. It aims to support all optical meteor data formats in existence (videos and still images), as well as calibrating dashcams.

	= SkyFit2 Anatomy =		= SkyFit2 Anatomy =

Dvida: /* Create or Upgrade a Plate with SkyFit2 */

2023-03-02T14:41:42Z

Create or Upgrade a Plate with SkyFit2

← Older revision		Revision as of 09:41, 2 March 2023
Line 30:		Line 30:
	= Create or Upgrade a Plate with SkyFit2 =		= Create or Upgrade a Plate with SkyFit2 =

	This page seeks to walkthrough how to create a new plate or upgrade an old plate using RMS~~' Sky``Fit2~~ GUI.		This page seeks to walkthrough how to create a new plate or upgrade an old plate using RMS SkyFit2 GUI.

	== Getting Started ==		== Getting Started ==

Dvida at 15:57, 21 February 2023

2023-02-21T15:57:51Z

@@ Line 40: / Line 40: @@
 This opens the Sky``Fit2 GUI with whatever data is in the directory specified by "INPUT_PATH". Alternatively, can also be a path to a video file or a state file. Make sure to customize the config file to the proper specifications before running this program. The most common options are detailed below:
- * Config: Path to the directory containing the appropriate .config file. Default to the DETECTION_PATH.
+* Config: Path to the directory containing the appropriate .config file. Default to the DETECTION_PATH.
- * Timebeg: Beginning time of the detection in YYYYMMDD_hhmmss.uuuuuu format.
+* Timebeg: Beginning time of the detection in YYYYMMDD_hhmmss.uuuuuu format.
- * Fps: Frames per second when images are used. This option overrides the framerate read in from the config file.
+* Fps: Frames per second when images are used. This option overrides the framerate given in from the config file.
- * Gamma: Camera gamma value (typically 0.45 or 1.0). This option overrides the framerate read in from the config file
+* Gamma: Camera gamma value (typically 0.45 or 1.0). This option overrides the framerate read in from the config file
 Upon opening, a request for a plate (platepar .cal file) will occur. If you wish to update a plate, select this here. If you wish to make a new plate, simply close this window.
 == Creating a Plate ==

Pquigley at 14:12, 15 November 2022

2022-11-15T14:12:59Z

← Older revision		Revision as of 09:12, 15 November 2022
Line 26:		Line 26:

	[[File:WikiSettingsTab2.png]]		[[File:WikiSettingsTab2.png]]


			= Create or Upgrade a Plate with SkyFit2 =

			This page seeks to walkthrough how to create a new plate or upgrade an old plate using RMS' Sky``Fit2 GUI.

			== Getting Started ==

			To run SkyFit2, first install the RMS git repository and environment. Then run the command

			python -m Utils.SkyFit2 INPUT_PATH [-c/--config CONFIG_PATH][-t/--timebeg TIME][-f/--fps FPS][-g/--gamma GAMMA]

			This opens the Sky``Fit2 GUI with whatever data is in the directory specified by "INPUT_PATH". Alternatively, can also be a path to a video file or a state file. Make sure to customize the config file to the proper specifications before running this program. The most common options are detailed below:

			* Config: Path to the directory containing the appropriate .config file. Default to the DETECTION_PATH.
			* Timebeg: Beginning time of the detection in YYYYMMDD_hhmmss.uuuuuu format.
			* Fps: Frames per second when images are used. This option overrides the framerate read in from the config file.
			* Gamma: Camera gamma value (typically 0.45 or 1.0). This option overrides the framerate read in from the config file

			Upon opening, a request for a plate (platepar .cal file) will occur. If you wish to update a plate, select this here. If you wish to make a new plate, simply close this window.

			== Creating a Plate ==

			*NOTE: When entering hotkey commands in SkyFit2, you must be in the main frame/viewer.

			Adjust the levels on the right as required or automatically set them by pressing ctrl+A. Once you are happy, begin to rotate the catalog stars into an approximately correct position using your keyboard. A/D control the azimuth, S/W control the altitude, Q/E control the position angle, and Up/Down controls the scale. Don't worry about getting them exactly, just get them close enough to the image for the program to associate the observed stars with the catalog stars when manually picking.

			To enter star picking mode, press ctrl+R. This should bring up an annulus around your reticle, whose size you can control by holding ctrl and scrolling with the mouse wheel. To pick a star, click on the star and the program should automatically snap the point to the centroid. If you are unhappy with its choice, you can force the centroid position by holding ctrl and clicking. The position will appear as an orange cross. Your pick of star will automatically associate with the nearest catalog star (which will be filled with a blue X). If you wish to choose a different catalog star, simply click this again and notice as the blue X switches. To accept a pair, press Enter or Space.

			Once you have a centroided a number of stars (minimum 5 to adjust pointing, 12 to adjust distortion), you can fit the plate by clicking "Fit Parameters">"Fit" on the sidebar or ctrl+Z. The green numbers that appear are the star magnitudes and the white numbers are the magnitude errors. The bars represent the fitting errors (magnitude and direction). This will print a residual table to the console, as well as the average error and FOV.

			Under the "Fit Parameters" tab, there are several options to adjust to improve your astrometry. The refraction correction should be checked for all camera. If the camera is older and does not have square pixels, uncheck equal aspect. If you suspect that the lens is not completely flat with the sensor (nearly always), check the asymmetry correction. The older distortion models are the poly3+radial models. It is preferable to use the radial-odd models as they do not require stars in all parts of the field to accurately model the distortion. To see which you should use, begin with the lowest order model and check the astrometry residuals by clicking "Fit Parameters">"Astrometry" or by pressing the L key. If there is structure to the residuals, then increase the order until the structure disappears.

			Fixed vignetting should only be enabled for cameras with well-measured vignetting. This is preferable to the modeled vignetting parameter, but unless it has been measured in the lab or under controlled conditions it will worsen the photometry fit. Extinction values also typically vary between 0.6 and 1.0 and should be measured on a per-camera basis. Both of these effects increase with distance from the center of the lens, as can be seen by clicking "Fit Parameters">"Photometry" or by pressing the P key. Adjust the extinction until it follows the downward curved line.

			After creating a plate, it can be useful to remove high residual error stars. You can filter stars by adjusting "Settings">"Filter Mag Err". Manual add and remove stars until you obtain a fit you are satisfied with. You can check the RMSD to get an idea of how good the fit is.

Pquigley at 14:05, 15 November 2022

2022-11-15T14:05:10Z

← Older revision		Revision as of 09:05, 15 November 2022
Line 1:		Line 1:
	= SkyFit2 Anatomy		= SkyFit2 Anatomy =

	This section describes the various physical features of the SkyFit2 GUI.		This section describes the various physical features of the SkyFit2 GUI.

Pquigley at 14:05, 15 November 2022

2022-11-15T14:05:01Z

← Older revision		Revision as of 09:05, 15 November 2022
Line 1:		Line 1:
	= SkyFit2 Anatomy		= SkyFit2 Anatomy

	This section describes the various physical features of the ~~Sky``Fit2~~ GUI.		This section describes the various physical features of the SkyFit2 GUI.

	== SkyFit Mode ==		== SkyFit Mode ==
Line 7:		Line 7:
	=== Image Display & Levels ===		=== Image Display & Levels ===

	{{File:WikiImgDisplay.png}}		[[File:WikiImgDisplay.png]]

	=== Fit Parameters Tab ===		=== Fit Parameters Tab ===

	{{File:WikiFitParams.png}}		[[File:WikiFitParams.png]]

	=== Settings Tab ===		=== Settings Tab ===

	{{File:WikiSettingsTab.png}}		[[File:WikiSettingsTab.png]]

	== ManualReduction Mode ==		== ManualReduction Mode ==
Line 21:		Line 21:
	=== Image Display & Levels ===		=== Image Display & Levels ===

	{{File:WikiImgDisplay2.png}}		[[File:WikiImgDisplay2.png]]

	=== Settings Tab ===		=== Settings Tab ===

	{{File:WikiSettingsTab2.png}}		[[File:WikiSettingsTab2.png]]