This FITCH_readme_20201211.txt file was generated on 20201211 by Kyle Fitch Links to Publication Field updated. 2021-12-09, BP ------------------- GENERAL INFORMATION ------------------- 1. Title of Dataset MATLAB code for "Arctic observations and numerical simulations of surface wind effects on Multi-Angle Snowflake Camera measurements" 2. Author Information Fitch, Kyle E. and Hang, Chaoxun and Talaei, Ahmad and Garrett, Timothy J. Principal Investigator Contact Information Name: Tim Garrett Institution: Dept. of Atmospheric Sciences, University of Utah Address: 135 S 1460 E, William Browning Building, Salt Lake City, UT 84112 Email: tim.garrett@utah.edu Associate or Co-investigator Contact Information Name: Kyle Fitch Institution: Dept. of Engineering Physics, Air Force Institute of Technology Address: 2950 Hobson Way, Building 640, Wright-Patterson AFB, OH 45433 Email: kyle.fitch@afit.edu Associate or Co-investigator Contact Information Name: Ahmad Talaei Institution: Dept. of Atmospheric Sciences, University of Utah Address: 135 S 1460 E, William Browning Building, Salt Lake City, UT 84112 Email: ahmad.talaei@utah.edu Associate or Co-investigator Contact Information Name: Chaoxun Hang Institution: School of Oceanography, Shanghai Jiao Tong University Address: Shanghai, 200240, China Email: chaoxunhang@gmail.com 3. Date of data collection (single date, range, approximate date) Code creation dates from 20120521 to 20201211 4. Geographic location of data collection (where was data collected?): N/A 5. Information about funding sources that supported the collection of the data: This work was supported by the Department of Energy Atmospheric System Research program Grant DE-SC0016282 and the National Science Foundation (NSF) Physical and Dynamic Meteorology program award number 1841870 -------------------------- SHARING/ACCESS INFORMATION -------------------------- 1. Licenses/restrictions placed on the data: CC BY NC - Allows others to use and share your data non-commercially and with attribution. 2. Links to publications that cite or use the data: Fitch, K. E., Hang, C., Talaei, A., & Garrett, T. J. (2021). Arctic observations and numerical simulations of surface wind effects on Multi-Angle Snowflake Camera measurements. Atmospheric Measurement Techniques, 14(2), 1127-1142. https://doi.org/10.5194/amt-14-1127-2021 3. Links to other publicly accessible locations of the data: None 4. Links/relationships to ancillary data sets: This code is used for analysis and generation of figures in the related manuscript. 5. Was data derived from another source? If yes, list source(s): One of the scripts ('tight_subplot.m') is part of a collection of code used for displaying figures with minimal spacing. It was written by Pekka Kumpulainen, Tampere University of Technology. 6. Recommended citation for the data: Fitch, Kyle E., Hang, Chaoxun, Talaei, Ahmad and Timothy J. Garrett. 2020. MATLAB code for "Arctic observations and numerical simulations of surface wind effects on Multi-Angle Snowflake Camera measurements." HIVE Research Data Repository, University of Utah, Salt Lake City, UT. --------------------- DATA & FILE OVERVIEW --------------------- 1. File List A. Folder Name: plots Short description: this is the main folder from which the data analysis and figure generation is carried out. This is done by executing 'wind_effects_plots3.m'. This script depends on all other files in the folder, most of which are subroutines. One file, called 'oli_data_windeffects.mat' contains the data that is read into the main routine during execution. All other files have descriptions and advice in the comments for running the program. Files include: - wind_effects_plots3.m - calcLinFit.m - calcLocMin2.m - calcRe2.m - calcSlope.m - clipLabEnds.m - isMyMax.m - tight_subplot.m - oli_data_windeffects.mat B. Folder Name: loadstats Short description: for those users wishing to generate the Multi-Angle Snowflake Camera (MASC) and other Atmospheric Radiation Measurement (ARM) data from scratch, this program is executed by running 'loadstats_windeffects.m' and requires raw data from the ARM archive (https://adc.arm.gov/discovery/#/results/). All other files in this folder are subroutines of the main program and have descriptions and advice in the comments for running the program. Files include: - loadstats_windeffects.m - cam_params.m - label_params.m - matchMASC.m - matchMASC2.m - uploaddirs_ARM3.m - uploaddirs.m - windeffects_paths.m 2. Relationship between files: All files in each of the two folders are used to run the respective programs, but the primary files are 'wind_effects_plots3.m' in the 'plots' folder and 'loadstats_windeffects.m' in the 'loadstars' folder. 3. Additional related data collected that was not included in the current data package: Raw data are available at the ARM data archive: https://adc.arm.gov/discovery/#/results/. 4. Are there multiple versions of the dataset? no If yes, list versions: Name of file that was updated: i. Why was the file updated? ii. When was the file updated? Name of file that was updated: i. Why was the file updated? ii. When was the file updated? -------------------------- METHODOLOGICAL INFORMATION -------------------------- 1. Description of methods used for collection/generation of data: Raw MASC data must first be processed using the 'mascpy' program (https://doi.org/10.7278/S50DVA5JK2PD) before running 'loadstats_windeffects.m'. Alternatively, users can download pre-processed particle data directly from the ARM data archive by choosing the 'MASC Particles Value-Added Product'. The program processes the raw data according to the method documented in the DOE ARM MASC Particle Analysis Value-Added Product Technical Report located at https://www.arm.gov/publications/tech_reports/doe-sc-arm-tr-187.pdf 2. Methods for processing the data: See #1 above 3. Instrument- or software-specific information needed to interpret the data: The technical specifications of the MASC are documented in the DOE ARM MASC Instrument Handbook located at https://www.arm.gov/publications/tech_reports/handbooks/masc_handbook.pdf The mascpy program is run with Python 4. Standards and calibration information, if appropriate: See #3 above 5. Environmental/experimental conditions: Meteorological conditions vary by date and time and can be retrieved in a separate dataset on the ARM archive available at http://dx.doi.org/10.5439/1025220 6. Describe any quality-assurance procedures performed on the data: See #1 above 7. People involved with sample collection, processing, analysis and/or submission: These scripts were written primarily by Kyle Fitch, with some originally written by Tim Garrett and later modified by Kyle Fitch. ----------------------------------------- DATA-SPECIFIC INFORMATION FOR: [FILENAME] ----------------------------------------- 1. Number of variables: 2. Number of cases/rows: 3. Variable List A. Name: [variable name] Description: [description of the variable] Value labels if appropriate B. Name: [variable name] Description: [description of the variable] Value labels if appropriate 4. Missing data codes: Code/symbol Definition Code/symbol Definition 5. Specialized formats of other abbreviations used