Differences

This shows you the differences between two versions of the page.

--- zsf [2026/02/10 15:28] – andrew
+++ zsf [2026/02/10 16:36] (current) – andrew
@@ Line 16: / Line 16: @@
-Select which instrument you wish to calibrate and then select the appropriate region that the instrument operates in.
+Select which instrument you wish to calibrate and then select the appropriate region that the instrument operates in to use the correct albedo for creating the new coefficients.
 {{ :zsf-albeto.png?600 |}}
-==== Testing ====
+You then select the calculation parameters. Most of the preset options are standard and what you will use to create the new ZSF file, you will need to select the correct date range. Use a date that starts close to the most recent calibration to insure the most accurate DS data is used to create the new coefficients.
-Once a new zsf file is created it is important to make sure that the newly created coefficients and statistics for the ZS processing improves the results for ZS measurements. To do this the old zsf file and new zsf file must be compared in BFilePro or another data processing software. For this example we will be using BFilePro and Brewer #039.\\
-Create a new directory in the file that houses BFilePro and add the following files:
+{{ :zsf-options.png?600 |}}
-  * dcfJJJYY.xxx
-  * dcfJJJYY.xxx.dwl
-  * etcYYYY.xxx
-  * ICFJJJYY.xxx
-  * UVRJJJYY.xxx
-  * zsfJJJYY.xxx
-Make sure that your data processing software is set up. In BFilePro make sure that the following options are selected in the 'Options' menu under the 'Calculations' window.
+Select 'Run ZSF fitting' to begin the program. After you've selected to run the program you will jump to the 'Sky Calibration Plot' page of the software. Once the process is complete the graphs will populate with data to show how the new ZSF calibration will change the fitting of the ZS data.
-  * Recalculate b-files
-  * Calculate aerosol
-  * Apply SL correction
-In the 'Instrument constants' window select ‘Add a new calibration’ and a new window will pop up. Set the calibration start date to the same day as the date in the ICF file. Eg ICF09623.xxx you would set the date to 096 Julian day (April 6th) 2023. Be aware that if it’s a leap year it will affect the Julian day/calendar date. \\
-Link the correct files to the ‘Calibration Details’ window, these will be the same files that you transferred over during the beginning of the ‘Testing’ process. All the files should be assigned except the ‘Neutral filters’ which can be left blank.
-Once the files to use are selected, select the ‘OK’ button and it will return you to the previous window. There are two boxes highlighted below that need to be calculated. To do this you must go into the instruments ICF file and navigate to the bottom of the text file and take note of two numbers at line 61 and 62.\\
-\\
-To calculate to value for the first box to the right of ‘SL’ take the number above the box being calculated, for this example it is 3180, and subtract it by the number found on line 61 of the ICF file, 1238 for this example, and fill in the box with the difference. For the second box to the right of ‘SL’ take the number above the box being calculated and subtract it by the number found on line 62 of the ICF file. Check the box ‘Save these options’ and press ‘OK’.
-Direct BFilePro to the directory that stores all the B-files for the instrument you are analyzing. \\
-\\
-{{:bfilepro_instrument_constants.jpg?400|}}{{:txt_file_instrument_constants.jpg?300|}} \\
-This will populate the window on the left-hand side of BFilePro with the available files for that instrument. Highlight b-files that will provide both ZS and DS measurements for your instrument and click ‘Process’ at the bottom of the panel. Take note of what date range you are analyzing, if there isn’t Ds and Zs data during this time, clear the graph and select a new time. \\
-\\
-Select ‘New’ in plot results and toggle ‘Zs’ on and off to find a good couple days to compare data. Use a marquee select dragging left to right to zoom in on desired period and once this is found note the difference between the ‘Ds’ and ‘Zs’ measurements, how well does the data agree? \\
-\\
-{{:bfilepro_old_zsf.png?500|}} \\
-\\
-After taking note of the relationship, clear the graph by selecting the ‘Clear Graph’ button. You are now going to see how the Zs data changes in relation to the Ds data with the new zsf file you created in the ‘Data Processing’ section of this document. \\
-\\
-{{:bfilepro_new_zsf.png?500|}} \\
-\\
-Open the ‘Options’ menu from the top left-hand side of BFilePro. In the ‘Instrument constants’ section select ‘Edit this Calibration’ and change the pathway to the ZS file to the new zsf file you created in the previous step.  Click ‘Ok’ to close the edit calibration window and ‘Ok’ and save changes in the ‘Options’ menu.\\
-\\
-Re process the graph and look how the new zsf coefficients affect the relationship between the Ds and Zs data. Do the new zsf coefficients improve how well the Zs measurements relate to the Ds? If so that means the new zsf coefficients are an improvement and should be used going forward.
+{{ :zsf-sky_calibration_plots.png?600 |}}
+If the new ZSF improve the agreement between ZS and DS data by ~5% apply the new calibration to the instrument.