IBHS Hail Disdrometer Readme
***************************************************************
Raw impact .txt files
Raw files have a GPS header and footer at the beginning and end of the file that provides a date/time stamp, Lat/Lon, elevation

Column headers
2.5 kHz sampling
1. Time between samples (microseconds)
2. Bits (0-1023, corresponds to a 0-3.3V range)
****************************************************************

Processed .csv files
Filenaming:  P1XX_IOPXX_Processed.csv
Column headers
1 second data
Very small hail < 0.5 cm is filtered out in post-processing and considered not-detectable after time histories are processed to remove bias error and RF signal noise from electronics, lightning, power supply etc. 
*****************************************************************

1. Hour (UTC) - from entered start time (either from probe GPS or estimated from record, see summary for notes)
2. Minute (UTC) - from entered start time (either from probe GPS or estimated from record, see summary for notes)
3. Seconds (UTC) - from entered start time (either from probe GPS or estimated from record, see summary for notes)
4. Maximum detected size per second (cm)
5. Kinetic energy flux (J ft-2 s-1) - Summed kinetic energy over 1 second time interval per square foot (impact plate surface area)
6. Total hail impacts per second per square foot 
7. Number impacts Bin 1
8. Number impacts Bin 2
9. Number impacts Bin 3
10. Number impacts Bin 4
11. Number impacts Bin 5
12. Number impacts Bin 6
13. Number impacts Bin 7
14. Number impacts Bin 8
15. Volumetric concentration bin 1    (particles m-3 s-1, estimated assuming constant distribution in space/time)
16. Volumetric concentration bin 2
17. Volumetric concentration bin 3
18. Volumetric concentration bin 4
19. Volumetric concentration bin 5
20. Volumetric concentration bin 6
21. Volumetric concentration bin 7
22. Volumetric concentration bin 8
23. 1 Hz mean BP (hPa)
24. 1 Hz mean T (C)
25. 1 Hz mean RH (%)

Bin particle sizes:
Bin 1: <1 cm
Bin 2: 1-2 cm
Bin 3: 2-3 cm
Bin 4: 3-4 cm
Bin 5: 4-5 cm
Bin 6: 5-6 cm
Bin 7: 6-7 cm
Bin 8: > 7
******************************************************************
Processed KE .csv files
Filenaming: P1XX_IOPXX_KE.csv
KE files represent a time history of all impact kinetic energies detected during post-processing. 
Very small hail < 0.5 cm is filtered out in post-processing and considered not-detectable after time histories are processed to remove bias error and RF signal noise from electronics, lightning, power supply etc.  

Column headers

1. Hour (UTC) - derived from entered start time
2. Minute (UTC) - derived from entered start time
3. Second (UTC) - derived from entered start time
4. Impact kinetic energy

******************************************************************
NOTES:

-Probes are calibrated to kinetic energy. An integrated bits over the impact signal packet is used in relation to the known impact kinetic energy in laboratory calibration. Laboratory hailstones used in calbration 
are spheres but are representative in strength and density to natural hailstones based on the test protocol and manufacturing process described in Brown-Giammanco et al. (2021) - Natural Hazards Review. Probes calibration curves are constructed using 20 impacts per size of the following: 0.75 in., 1 in., 1.25 in., 1.5 in., 1.75 in., 2 in., 2.25 in.
-Processed data from 2015 - 2023, Max Diameter to kinetic energy relationship from Heymsfield et al. (2014), 
 representing mean hailstone relationship. These data do not have thermodynamic variables.
-Processed data from 2024-present processed using max diameter to kinetic energy relationship from Heymsfield et al. (2018), these data also have thermodynamic variables included in processed datafiles.
-Kinetic energy data file represents the estimated kinetic energy of each detected impact's after post-processing the original bit (proxy voltage time) history. 

******************************************************************
Disdrometer IOP Summary files (.xls)
IOP summary files provide basic information and summary statistics from the disdrometer deployments during the associated IOP. All dates/times in UTC
Column headers
1. Probe ID (i.e. 101, 102...125)
2. Deployment date (ddmmyy)
3. Probe deployment latitude (decimal degrees)
4. Probe deployment longitude (decimal degrees, i.e. -103.4089 '-' for western hemisphere)
5. Elevation (elevation of probe determined through probe GPS header or footer fix)
6. Start time (hhmmss - UTC, time the probe began data collection)
7. Stop time (hhmmss - UTC, time the probe ended data collection)
8. Impacts detected in the raw data (Yes or No: Y/N, determined from visual inspection of the raw disdrometer time history)
9. Impacts recorded in processed data (Yes or No: Y/N, determined from processed data)
10. Total impacts resolved in processed data
11. Maximum size detected in full record (cm)
12. Collection/measurement location ID (if measurement/collection was colocated)
13. Notes - Notes include qualtiative QA/QC descriptions, known instrument issues, known data file issues, GPS issues etc.