Differences

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

--- zsf [2024/01/09 19:25] – created andrew
+++ zsf [2026/02/10 16:36] (current) – andrew
@@ Line 9: / Line 9: @@
 ==== Data Processing ====
-To begin making the new zenith sky coefficients you must first create a test file directory and then a unique file in that directory for each brewer being analyzed. You can host the test file wherever is most convenient for you, ie /Desktop or /Documents. Populate the new brewer file with the following;
+New zenith sky coefficients should be done with data after a transfer or absolute calibration has been done with up to 1 year of data but can be performed with a few months of processed, cleaned DS O3 with ZS data. It is important that the files must contain both the cleaned DS and ZS data for creating new constants as the calibration needs to fit the ZS data to the DS.
-  * ds2zs.exe
-  * ds2zs.cfg
-  * ICF file for the Brewer being analyzed
-  * Relevant B-files for the brewer being analyzed
-Open the ds2zs.cfg file in the test directory you created with notepad or another text editor. Edit the file with the following parameters:
-  * files: change the b file naming to reflect the brewer being analyzed as displayed above
-  * icf: enter the icf file to use in re-processing
-  * zsf: refers to one of the following 4 models based on location. Set to &II
-  * dtime: maximum time difference between ZS and DS (default 10)
-  * min mu: minimum air mass factor for DS/ZS pairs (default 1.2)
-  * max mu: maximum air mass factor for DS/ZS pairs (default 4.2)
-  * max std: max DS/ZS ozone standard deviation within the measurement (default 2.5)
-  * 03 height above station (km): ozone layer height above the station (default 22km)
-  * Rayleigh height (km): effective air height for Rayleigh calculations (default 5km)
-  * Difference between 03ETC and SLR6: the difference between O3ETC and SLR6 at calibration. This number can be found in the brewer’s icf file near the bottom of the text file. Refer to figure 3.
-Save the newly updated cfg file to the test directory and rename it ds2zsxxx.cfg.\\
+You will have to merge the .dat files using the merge function under ‘tools’ drop-down menu in the matlab software. Select the files you wish to combine and press okay. Upload the file to be used for the calibration in the 'clean o3 data file' section of the 'Sky Calibration tab'.
-\\
-Highlight and drag the newly created cfg file and drag it into the ds2zs.exe file.\\
-\\
-The ds2zs.exe program will execute its routine and create two files in the test directory.
-  * ds2zs.dat: file contains the ozone data that was used in the processing and reprocessed ZS data with the new calculated coefficients.
-  * ds2zs.zsf: file contains the newly calculated coefficients and statistics for the ZS processing. This file is used by the operation Brewer software once it has been renamed.
-If the program does not run or create the two files above run the program in a command line. To do this type ‘cmd’ into the navigation bar in the ‘Test’ directory you created or navigate with a new command terminal. Once in the correct directory write ‘ds2zsxxx.cfg ds2zs.exe’ and the program will run in your command terminal. From here you can see why the program failed. In cases where it does not provide an explanation it is possible that the program did not create the two new files because there is not enough data for the coefficients.\\
+{{ :zsf-sky_calibration_window_1.png?600 |}}
-Rename the ds2zs.zsf file to zsfJJJyy.xxx. Once this is done repeat for every brewer you wish to analyze in the respected folder.
-==== Testing ====
-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.\\
+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 |}}
+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.
+{{ :zsf-options.png?600 |}}
+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.
+{{ :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.