Canadian Brewer Spectrometer Network

User Tools

Site Tools

Trace:
zsf

Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
zsf [2026/02/10 15:17] – andrewzsf [2026/02/10 16:36] (current) – andrew
Line 13: Line 13:
 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'. 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'.
  
-{{ :zsf-sky_calibration_window.png?600 |}}+{{ :zsf-sky_calibration_window_1.png?600 |}}
  
  
 +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 |}}
-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.\\+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.
  
-Rename the ds2zs.zsf file to zsfJJJyy.xxx. Once this is done repeat for every brewer you wish to analyze in the respected folder. +{{ :zsf-options.png?600 |}}
-==== 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.\\+
  
-Create a new directory in the file that houses BFilePro and add the following files: +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. 
-  * 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. +
-  * 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.
  
zsf.1770736640.txt.gz · Last modified: 2026/02/10 15:17 by andrew