Use of semantic versioning began with v2.0.0. A description follows; see https://semver.org/ for further details.,,,,,
"Major changes (indicated by X in version X.Y.Z): not backwards compatible. In the context of NWSS DCIPHER data submission, these are changes that would cause submission (see note on Submission Requirements) of a data file, if unaltered, to fail upload. These may include addition of required fields or name changes to required fields.",,,,,
"Minor changes (indicated by Y in version X.Y.Z): backwards compatible functionality added. In the context of NWSS DCIPHER data submission, these may be additions of non-required fields, name changes to non-required fields, or changes to value sets, which will not prohibit upload but will be flagged in on-platform QC checks.",,,,,
"Patches (indicated by Z in version X.Y.Z): backwards compatible bug fixes. In the context of NWSS DCIPHER data submission, these may be clarifications of field descriptions, additions to value sets, or reorganization of the metadata.",,,,,
,,,,,
Date of change,New file name,Version,Major changes,Minor changes,Patches
20200923,NWSS_DCIPHERForm_DataDictionary_Sent-to-states_9.23.20,0.1.0,NA,NA,NA
20201020,NWSS_DCIPHERForm_DataDictionary_20201020,0.2.0,None,"1. Changed to allow for sampling location not associated with treatment plant;
2. EPAID no longer required
",Description of treatment plant changed to be 'identifiable name'
20201021,NWSS_DCIPHERForm_DataDictionary_20201021,0.3.0,Replaced Pascal Case variable names with snake case variable names to align with bulk upload template variables ,None,Added red to data source color scheme to denote DCIPHER generated variables.
20201103,NWSS_DCIPHERForm_DataDictionary_20201103,0.3.1,None,None,Clarified that state variable response for WWTP should be 2-letter abbreviation.
20201105,NWSS_DCIPHERForm_DataDictionary_20201104,0.4.0,None,"A number of changes were made to reflect the shift from form-based data submission, which had built-in validation prior to submission, to CSV file submission to DCIPHER:
1. Recharacterized ""Pre-populated value set"" values as ""Allowed values"";
2. Added variable type column","A number of changes were made to reflect the shift from form-based data submission, which had built-in validation prior to submission, to CSV file submission:
1. Changed ""Forced column"" to ""Required Field"";
2. Changed possible responses for ""Required Field"" to ""Not required"" and ""Required"";
3. Changed ""DCIPHER Form Format"", ""DCIPHER Form Pre-populated Value Set"", and ""DCIPHER Form Data Validation"" column names to denote Internal-Use only;
4. Made all values lower case (not a major change because all values are cast to lower during file parsing); "
20201201,NWSS_DCIPHERForm_DataDictionary_20201201,0.5.0,"Changed ""Required Field"" value for the 'state' variable in the ""Wastewater Treatment Plant"" table from blank to ""Required""",,
20201204,NWSS_DCIPHERForm_DataDictionary_20201204,1.0.0,None,"Changed 'composite_freq' from ""Required"" (if composite) to ""Not required""",
20201215,NWSS_DCIPHERForm_DataDictionary_20201215,1.0.1,None,None,"Changed 'pcr_target_ref' description to ""A publication, website, or description of the PCR gene target used"""
20201218,NWSS_DCIPHERForm_DataDictionary_20201218,1.0.2,None,None,"Changed ""Allowed values"" from ""[any]"" to ""0-100"" for 'industrial_input' to clarify percentage units"
20210111,NWSS_DCIPHERForm_DataDictionary_20210111,1.0.3,None,None,"Changed ""Tooltip / descriptive text"" for standard error and confidence interval fields so that '-1' is only entered when these values cannot be calculated"
202101222,NWSS_DCIPHERForm_DataDictionary_20210122,1.0.4,None,None,"Changed ""Tooltip / descriptive text"" for 'ntc_amplify' field to be more specific: ""For qPCR, did any no-template controls on this instrument run have a Ct value less than 40? For ddPCR, did any no-template controls on this instrument run have 3 or more positive droplets?"" This definition aligns with the definition of positivity given on the NWSS webpage for Data Reporting and Analytics, and aligns with guidance provided by a ddPCR instrument manufacturer."
202101225,NWSS_DCIPHERForm_DataDictionary_20210125,1.0.5,None,None,"Added clarification to ""Tooltip / descriptive text"" for 'population_served' field to consider population estimates for upstream sampling locations: ""if the sampling location is upstream of a treatment plant (i.e., sample_location = ""upstream""), please use the estimated population served by the corresponding service area"""
20210127,NWSS_DCIPHERForm_DataDictionary_20210127,1.0.6,None,None,"Added additional text and example to ""Tooltip / descriptive text"" for 'composite_freq' to clarify definition"
202102110,NWSS_DCIPHERForm_DataDictionary_20210210,1.0.7,None,None,"1. Removed ""Internal Use"" columns;
2. Updated ""Allowed values"" column to make 'suggested' values more explicit (e.g., for fields that do not have a finite value set but have values that are commonly used) and to indicate where '-1' should be used to indicate unavailable data for required numeric fields;
3. Added ""Notes"" column to provide additional guidance, such as where appropriate to leave blank;
4. Clarified ""Tooltip / descriptive text"" for 'sars_cov2_std_error' and 'tss';
5. Changed ""Display Variable Name"" for 'population_served' for clarity"
20210319,NWSS_DCIPHER_Data_Dictionary_v2.0.0_20210323,2.0.0,"1. New required fields (3): 'institution_type', 'sample_id', 'lab_id';
2. Name changes to required fields (2): 'state' changed to 'wwtp_jurisdiction', 'reporting_state' changed to 'reporting_jurisdiction';","1. Important description change relevant for upstream sites for 3 fields: 'county_names', 'other_jurisdiction', and 'sewage_travel_time' (these previously pertained to the treatment plant but have been changed to pertain to the sampling site, which is more relevant);
2. Removal and addition of values in value sets (>2 fields): 'sample_location' (""primary influent"" and ""primary sludge"" changed to ""wwtp""), 'rec_eff_target_name' (""bovine coronavirus"" changed to ""bcov vaccine""), other fields where similar values with the same meaning were submitted have been consolidated into one value, and will be indicated in QC checks;
3. Addition of non-required fields (3): 'pasteurized', 'time_zone', 'solids_separation'
4. Name changes to non-required fields (4): 'hum_frac_target_phys' changed to 'other_norm_name', 'hum_frac_target_phys_ref' changed to 'other_norm_ref', 'hum_frac_phys_conc' changed to 'other_norm_conc', 'hum_frac_phys_unit' changed to 'other_norm_unit'
",
20210416,NWSS_DCIPHER_Data_Dictionary_v2.0.1_20210416,2.0.1,None,None,"1. Additions to Value Sets:
'sample_type' now allows composite sample values for any integer duration from 1 to 30 hrs;
'flow_rate' now allows empty values to accommodate a 'sample_matrix' that is not a flowing liquid, such as ""primary sludge"" or ""holding tank"";
'concentration_method' now allows values that capture when solids and liquid are separated but both are tested, e.g., ""membrane filtration with addition of mgcl2, membrane recombined with separated solids"";
'pcr_target' now allows these additional values: ""n"", ""s,"" ""orf1a"";
'rec_eff_spike_matrix' now allows [empty] values;
'hum_frac_target_chem' now allows [empty] values;
'hum_frac_target_mic' now allows [empty] values;
'other_norm_name' now allows [empty] values;
'hum_frac_mic_unit' now allows [empty] values;
'hum_frac_chem_unit' now allows [empty] values;
'other_norm_unit' now allows [empty] values;
2. Description clarification:
'other_jurisdiction' has been further clarified to indicate that this refers to locations that exist outside of county boundaries;
'sample_id' has been clarified to indicate that PII must not be included in this field;
'lab_id' has been clarified to indicate that PII is discouraged from being included in this field;
the 'jurisdiction id' data type description has been modified to explicitly state that is is not case sensitive, which was previously and is still described in the note on all data types in the Read Me tab"
20210512,NWSS_DCIPHER_Data_Dictionary_v2.0.2_20210512,2.0.2,None,None,"1. Additions to Value Sets:
'extraction_method' now allows ""chemagic viral dna/rna 300 kit"", ""trizol, zymo mag beads w/ zymo clean and concentrator"", ""4s method (https://www.protocols.io/view/v-4-direct-wastewater-rna-capture-and-purification-bpdfmi3n)"";
'pcr_target' now allows ""ddcov_n"" and ""ddcov_e"""
20210621,NWSS_DCIPHER_Data_Dictionary_v2.0.3_20210621,2.0.3,None,None,"1. Additions to Value Sets:
'rec_eff_spike_matrix' now allows ""dewatered solids"";
'flow_rate' now allows empty values when SARS-CoV-2 units are provided on a per mass sludge basis;
'concentration_method' now allows ""innovaprep ultrafiltration"";
'extraction_method' now allows ""qiagen qiaamp buffers with epoch columns"";
'hum_frac_target_mic' and 'other_norm_name' both now allow ""f+ rna coliphage"" and ""f+ dna coliphage"";
2. Description clarification:
'pretreatment' has been clarified to indicate that this field pertains to both chemicals added to the sample and chemicals added as part of the treatment train upstream of the sample collection point, but that pasteurization should be specified in the 'pasteurized' field"
20210818,NWSS_DCIPHER_Data_Dictionary_v2.1.0_20210818,2.1.0,None,"1. Addition of non-required fields:
'qc_ignore' has been added to allow samples to be intentionally excluded from the DCIPHER QC report;
'analysis_ignore' has been added to allow samples to be intentionally excluded from DCIPHER data analysis;
'dashboard_ignore' has been added to allow samples to be intentionally excluded from the DCIPHER dashboard;
'major_lab_method' has been added to allow reporting jurisdictions to identify major lab methods in their data, which may be useful for determining groups of SARS-CoV-2 results that can be reasonably compared;
'major_lab_method_desc' has been added to allow a brief description of the rationale for assigning a 'major_lab_method'.","1. Additions to Value Sets:
'extraction_method' now allows ""zymo quick-rna fungal/bacterial miniprep #r2014"";
'pcr_target' now allows ""ip2 and ip4 combined"";
'sars_cov2_below_lod' now allows [empty] values;
'concentration_method' now allows ""ceres nanotrap"";
2. Corrections to Value Sets (value yet to be used):
'reporting_jurisdiction' value for Arkansas has been corrected to ""AR"";
'extraction_method' value ""qiange allprep dna/rna kit"" has been corrected to ""qiagen allprep dna/rna kit"";
3. Dependent Fields clarification:
Dependent Fields for 'flow_rate' has been clarified to indicate that 'flow_rate' can have an [empty] value when SARS-CoV-2 RNA is measured on a per unit wastewater solids basis, rather than a per volume wastewater basis;
4. Dependent Fields change:
All uncertainty fields now allow [empty] values, regardless of the values submitted for the other uncertainty fields. In other words, the three fields 'sars_cov2_std_error', 'sars_cov2_cl_95_lo', and 'sars_cov2_cl_95_up' are now all allowed to be [empty];
5. Requirement dropped:
'sars_cov2_std_error', 'sars_cov2_cl_95_lo', 'sars_cov2_cl_95_up', and 'sars_cov2_below_lod' are no longer required."
20211028,NWSS_DCIPHER_Data_Dictionary_v2.1.1_20211028,2.1.1,None,None,"1. Additions to Value Sets:
'concentration_method' now allows ""aloh3 precipitation"";
'rec_eff_target_name' now allows ""heat inactivated sars-cov-2 virus"";
'extraction_method' now allows ""qiagen ez1 virus mini kit v2.0"" and ""thermo magmax microbiome ultra nucleic acid isolation kit"";
'sample_type' now allows composite sample values for any integer duration from 1 to 48 hrs;
'vs_rec_eff_target_name' now allows ""bcov culture"" and ""brsv culture"";
'extraction_method' now allows ""zymo environ water rna kit/ zymo environ water rna kit (cat. r2042)"";
'concentration_method' now allows ""zymo environ water rna kit/ zymo environ water rna kit (cat. r2042)"";
2. Description clarification:
'capacity_mgd' has been clarified to indicate that this should be the capacity for which the plant is permitted;
3. Description change:
'county_names' has been changed to ask for FIPS codes rather than names; it also now takes values for both counties and county equivalents;
'other_jurisdiction' has been deprecated, since all jurisdictions previously specified in this field should now be specified in the 'county_names' field. Submitting this field will not interfere with data upload, but this field will no longer be used;
4. Requirement dropped:
'other_jurisdiction' is no longer required;"
2021202,NWSS_DCIPHER_Data_Dictionary_v3.0.0_2021202,3.0.0,"1. Addition of a new required field 'pcr_gene_target' which should contain the information previously captured in 'pcr_target'.
2. Renaming of fields:
'sars_cov2_units' renamed to 'pcr_target_units'
'sars_cov2_avg_conc' renamed to 'pcr_target_avg_conc'
'sars_cov2_std_error' renamed to 'pcr_target_std_error'
'sars_cov2_cl_95_lo' renamed to 'pcr_target_cl_95_lo'
'sars_cov2_cl_95_up' renamed to 'pcr_target_cl_95_up'
'sars_cov2_below_lod' renamed to 'pcr_target_below_lod'","1. Repurposing of existing fields:
'pcr_target' will be repurposed from the field where PCR gene target information is submitted to now capturing what the overall PCR target was. For example, 'n1' was previously submitted to indicate the target gene for total SARS-CoV-2 was n1. Now that information will be captured in 'pcr_gene_target' and 'pcr_target' will be 'sars-cov-2'. For variants, you would put the variant target gene in 'pcr_gene_target' and 'pcr_target' would be the variant name (currently 'delta' or 'omicron').","1. Additions to Value Sets:
'vs_other_norm_name' now allows ""rnase p"";
'vs_institution_type' now allows 'other_worksite'
'vs_pcr_gene_target' now allows 'delta' and 'omicron' genes targets. See 'vs_pcr_gene_target' for the updated valueset options
'vs_pcr_target' now only allows 'sars-cov-2', 'delta', and 'omicron'
2. Field description modifications:
Many PCR fields have been modified to reflect the new PCR targets now able to be submitted using the dynamic 'pcr_target' fields as opposed to the total SARS-CoV-2 specific descriptions."
20211208,NWSS_DCIPHER_Data_Dictionary_v3.1.0_20211208,3.1.0,"1. Renaming of fields:
'pcr_target_ref' renamed to 'pcr_gene_target_ref'",None,None
20220524,NWSS_DCIPHER_Data_Dictionary_v3.1.1_20220524,3.1.1,None,None,"1.Additions to Value Sets:
'vs_concentration_method' now allows 'membrane filtration with addition of mgcl3'
'vs_extraction_method' now allows 'luminultra wastewater extraction kit', 'qiaamp viral rna kit', 'trizol and RNA purificaton kit', 'trizol, garnet bead beating, alcohol precipitation', 'zymo quick-rna viral 96 kit #r1041', 'zymo quick-rna viral kit #r1035', 'qiagen qiaamp dsp viral rna mini kit'
'vs_pcr_gene_target' now allows 'wt214', 'ins214epe', 'del142-144', 'del156-157', 'del31-33'
'vs_pcr_type' now allows 'qiagen dpcr', 'fluidigm dpcr', 'life technologies dpcr', 'raindance dpcr', 'dpcr'
'vs_rec_eff_target_name' now allows 'murine hepatitis virus'
'vs_reporting_jurisdiction' now allows 'AP', 'CN', 'CVBPI', 'EBCI', 'GTBI', 'MAT', 'NPT', 'OMT', 'SBT', 'TRIT', 'ZP'
'vs_sample_type' now allows '120-hr passive sample', from '48-hr passive sample' to '1-hr passive sample' in one hour increments
2. Field description modified:
'pcr_gene_target' description modified to clarify different gene target concentrations should not be averaged"
,,3.1.2,none,none,"1. Additons to Value Sets: 'pcr_gene_target' now allows 'CDC N1 (GT-Digital)', 'CDC N2 (GT-Digital)', 'N2 (PREvalence)', 'E (PREvalence)'. 'rec_eff_target_name' now allows: 'MHV (PREvalence)', 'BCoV (GT-Digital)'. 'hum_frac_target_mic' now allows: 'PMMoV (GT-Digital)'"
20220906,NWSS Data Dictionary_v3_1_3_20220906,3.1.3,none,none,"1. Additions to Value Sets: 'pcr_target' now allows: 'hMPXV', 'hMPXV Clade I', and 'hMPXV Clade II'. 'rec_eff_target_name' now allows: parapoxvirus'. 'pcr_gene_target' now allows: 'E9L�NVAR', 'G2R_G'� 'G2R_WA', 'C3L�, 'E9L-OPX�', 'B6R', 'B2R', and 'gtmol_hMPXV'"
20221018,NWSS Data Dictionary_v3_1_4_20221018,3.1.4,none,none,1. Additions to Value Sets: 'pcr_gene_target' now allows 'a67v/del69/del70'. Reporting_jurisdiction now allows: 'PBCI'.
20221122,NWSS Data Dictionary_v3_1_5_20221122,3.1.5,none,none,1. Addition to Value Sets:'concentration_methods' now allows: 'water concentrating buffer (R2042-1)'; 'extraction_method' now allows 'monarch total RNA miniprep kit (new england biolabs) + onestep PCR inhibitor removal kit (zymo)'; 'pcr_gene_target' now includes 'p13L'; 'sample_type' now includes '72-hr time-weighted composite'.
20230322,NWSS Data Dictionary_v4.0.0_20230322,4.0.0,"1. Changing existing fields to required (5): 'epaid', 'pretreatment', 'pasteurized', 'major_lab_method', 'major_lab_method_desc'
","1. Changes to value sets: 'pcr_target' now allows 'caur', 'NoV GI', 'NoVGII', 'FLUAV', 'FLUBV', 'NVO', 'Cjejuni', 'HAdV-F', 'Col', 'Gly', 'Bla', 'Integrase', 'Tet'. 'pcr_gene_target' now allows 'MCR-1.1', 'VanA-A', 'blaNDM', 'blaKPC', 'blaOXA-48', 'blaVIM', 'blaCTX-M-1', 'blaCMY', 'blaTEM', 'Class I Integrase', 'blaSHV', 'TetW', 'blaIMP', 'caur', 'NoV GI', 'NoV GII', 'InfA1', 'InfA2', 'InfB', 'Cjejuni', 'HAdv-F'. 'sample_type' now allows '72-hr time-weighted composite'. 'pasteurized' no longer allows [empty]. 'pretreatment' no longer allows [empty]. 'extraction_method' now allows 'exclusions based sample preparation (ESP)'
2. Changes to dependencies of existing field: 'pcr_type' must be a type of dpcr if 'pcr_target' is not 'sars-covs-2', 'delta', 'omicron', '
3. Added 'epa_registry_id' field","1. Clarifications of field or value set descriptions (2): 'zipcode', 'capacity_mdg', 'test_result_date', 'pcr_target_avg_conc', 'pcr_target_std_error', 'pcr_target_cl_95_lo', 'pcr_target_cl_95_up'
2. Added website to look-up NPDES ID and EPA Registry ID to 'Read Me' and to description in 'Metadata' tabs.
3. Removed space from ""other long term care"" value for 'institution type'"
20230606,NWSS Data Dictionary_v5.0.0_2023-06-06,5.0.0,,"1. Changes to value sets: 'extraction_method' now allows 'sciencell viral rna isolation kit', 'thermo magmax viral/pathogen nucleic acid isolation kit', and 'nucleomag (ref. 744220.4) using kingfisher automated instrument'; 'pcr_target' now allows 'RSV'; 'pcr_gene_target' now allows 'InfA1 and InfA2 combined' and 'RSV-A and RSV-B combined'.",
20230710,NWSS Data Dictionary_v5.0.0_2023-07-10,5.1.0,"1. Add new required field: 'site_id'
","1. Changes to value sets: 'extraction_method' now allows 'sciencell viral rna isolation kit', 'thermo magmax viral/pathogen nucleic acid isolation kit', and 'nucleomag (ref. 744220.4) using kingfisher automated instrument'",
¹ú²ú¾«Æ·¾Ã¾Ã¾Ã¾Ã¾ÃÒ»¼¶Ã«Æ¬