Detection Data

Filename: detectiondata.csv

The detectiondata template captures analysis parameters and acoustic detection results. Each row represents a detection period for a specific sound source and call type. The detectiondata template is required for all PARS submissions.

Download Blank Detection Data Template

Quick Reference
Field Details

deployment_code

Required Data Type: Code

Unique identifier of the deployment for this analysis. Must match a corresponding row in the metadata table.

Examples
WHOI_GOM_202310_WE03
WHOI_MA-RI_202210_WE16
NEFSC_MA-RI_202110_NS01
NEFSC_MA-RI_202202_COX02

analysis_organization_code

Required Data Type: Code Reference Table: Organizations

Code of the organization that conducted the analysis.

Examples
NEFSC
WHOI

analysis_sound_source_codes

Required Data Type: Code List Reference Table: Sound Sources

Species or detected sound(s) the analysis was conducted for. Multiple entries separated by commas allowed. For example, for an analysis that looked for both MIWH and HUWH simultaneously, enter "MIWH,HUWH".

Examples
RIWH
HUWH
HUWH,RIWH,MIWH,SEWH,FIWH

analysis_start_datetime

Required Data Type: Timestamp

Start date and time for detection analysis (i.e., the start date and time for when the data were analyzed by human analyst or detector).

Examples
2025-03-26T15:34:27-0500
2025-03-26T20:34:27Z

analysis_end_datetime

Required Data Type: Timestamp

End date and time for detection analysis (i.e., the end date and time for when the data were analyzed by human analyst or detector).

Examples
2025-09-17T07:54:28-0500
2025-09-17T12:54:28Z

analysis_sample_rate_khz

Required Data Type: Float Constraint: ≥ 0

Sample rate (in kHz) of acoustic data used for detector and analysis, this may be a resampled rate than the original recordings.

Examples
1
10.5

analysis_min_frequency_khz

Required Data Type: Float Constraint: ≥ 0 Default: 0

The minimum frequency (in kHz) used for the analysis, if applicable (default value is "0").

Examples
2

analysis_max_frequency_khz

Required Data Type: Float Constraint: ≥ 0

The maximum frequency used for the analysis. The value is relative to the recording's sample rate. If the original recordings had a sample rate of 48kHz, and the data was either resampled to 2kHz for the analysis, or only viewed at up to 1kHz, then this value would be "1". The value for this field would be "24" if the sampling rate and analysis viewing window was kept at 48kHz.

Examples
1
24

analysis_processing_code

Required Data Type: Code Reference Table: Analysis Processing Types

Indicates if the analysis conducted in real-time, or after the audio recording was retrieved (i.e., post-processed).

Examples
POST_PROCESSED
REAL_TIME

analysis_protocol_reference

Required Data Type: Text

Citation with URL and/or DOI (if available) for published paper for detector and the document with the analysis methods used for validating the data (published protocols are preferred, but can refer to a name of an internal document that is not currently published). Separate multiple entries with semicolons.

Examples
NEFSC Whale Presence Analysis Protocol
Baumgartner and Mussoline 2011, doi:10.1121/1.3562166
FPOD manual 2.0

analysis_citations

Optional Data Type: Text

Preferred citation(s) for this analysis and its detection results. These citations will be displayed in the citations list on PACM. Separate multiple entries with semicolons. Please use standard Harvard format for all citations and include a URL and/or DOI, if available.

Examples
Davis, G.E., Tennant, S.C. and Van Parijs, S.M., 2025. Upcalling behaviour and patterns in North Atlantic right whales, implications for monitoring protocols during wind energy development. ICES Journal of Marine Science, 82(4), https://doi.org/p.fsad174

analysis_detector_code

Required Data Type: Code Reference Table: Detectors

The detector(s) used for the analysis. Usually, only one detector is specified, but in some cases multple detectors can be specified when used for a single analysis (e.g., both the Whistly & Moan and the Click detectors in PAMGuard).

Examples
LFDCS
MANUAL
ISRAT_COD
PAMGUARD_WHISTLE_MOAN, PAMGUARD_CLICK
MIWH_DNN

analysis_detector_version

Required Data Type: Text

The version of the detector used for the analysis.

Examples
2
beta

detection_start_datetime

Required Data Type: Timestamp

Start date and time for the time period for the detection event or time bin depending on analysis granularity.

Examples
2025-03-26T15:34:27-0500
2025-03-26T20:34:27Z

detection_end_datetime

Required Data Type: Timestamp

End date and time for the time period for the detection event or time bin depending on analysis granularity. If detection is for a single point in time, the start and end datetimes can be the same.

Examples
2025-03-26T15:34:27-0500
2025-03-26T20:34:30Z

detection_effort_secs

Required Data Type: Float Constraint: ≥ 0

The amount of time (in seconds) the effort occurred in. This would translate to encounter or event duration for encounter/event level data. If the entire period was analyzed, enter total duration between the detection start and end datetimes. If the first 5 minutes of every hourly analysis bin was analyzed, this number would be "300". If the full hour of every hourly analysis bin was analyzed, this number would be "3600".

Examples
300
3600

detection_sound_source_code

Conditionally Required: detection_result_code=DETECTED,POSSIBLY_DETECTED Data Type: Code Reference Table: Sound Sources

The species or sound source that was analyzed for during the detection period.

Examples
RIWH
HUWH
STDO
NA

detection_call_type_code

Conditionally Required: detection_result_code=DETECTED,POSSIBLY_DETECTED Data Type: Code Reference Table: Call Types

The call/click type used for presence determination for the detection period.

Examples
RW_UPCALL
HUWH_SONG
OD_WHIS_HF

detection_n_validated

Conditionally Required: detection_result_code=DETECTED,POSSIBLY_DETECTED Data Type: Integer Constraint: ≥ 0

Number of actual detections that have been validated to be correct in the detection time period.

Examples
3
258

detection_result_code

Required Data Type: Code Reference Table: Detection Result Types

Detection result indicating if the species was detected or not.

Examples
DETECTED
POSSIBLY_DETECTED
NOT_DETECTED

localization_method_code

Optional Data Type: Code Reference Table: Localization Methods

Method used to localize the position of the animal(s).

Examples
3D_SIMPLEX
DMON_REAL-TIME
SHIP_POSITION

localization_latitude

Optional Data Type: Float Constraint: -90 ≤ value ≤ 90

Estimated localized latitude in decimal degrees.

Examples
41.141289

localization_longitude

Optional Data Type: Float Constraint: -180 ≤ value ≤ 180

Estimates localized longitude in decimal degrees. Negative values for locations in the western hemisphere.

Examples
-71.102908

localization_distance_m

Optional Data Type: Float Constraint: ≥ 0

Estimated range of detection (in meters) to the animal from the recording platform

Examples
3
60.5