Trap Night Partial Effort Term Tool

Description

Return full nights plus summed partial hours divided by hours per night.

Wildlife survey effort can use observer-hours, trap-nights, observation windows, or repeated visits. Equivalent effort applies a declared reporting rule and does not automatically correct detection probability.

Return full nights plus summed partial hours divided by hours per night.

When to use this tool

Use Trap Night Partial Effort Term when you need one explicit herpetological survey-effort component.

How to use the tool and how it works

Enter fullNights, partialHours, suppliedHoursPerNight. Use the units and conventions below.
Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
Read equivalentNights. Use the output convention below.

Require nonnegative integer fullNights, positive suppliedHoursPerNight, and partialHours within that duration. Return full nights plus summed partial hours divided by hours per night.^[1]

Input field	Meaning and units	Accepted input
fullNights	Full Nights	Required. Safe integer; minimum 0.
partialHours	Partial Hours	Required. Array of finite number; maximum items 256.
suppliedHoursPerNight	Supplied Hours Per Night	Required. Finite number; strictly above 0.

Output field	Interpretation	Returned shape
equivalentNights	Equivalent Nights	Required. Finite number.

json

{
  "input": {
    "fullNights": 3,
    "partialHours": [
      4,
      2
    ],
    "suppliedHoursPerNight": 12
  },
  "output": {
    "equivalentNights": 3.5
  }
}

Limitations and assumptions

The night definition is supplied rather than astronomical; equivalent effort does not correct detection probability, trap function, or survey representativeness.
Inputs must satisfy both the field types and the cross-field conditions above. Invalid input causes an error; a successful false flag or documented placeholder is a different result.
Numeric calculations use binary floating point unless exact decimal-integer arithmetic is explicitly stated. No hidden measurement tolerance or decimal rounding is added; nonfinite or out-of-contract results are rejected. Numeric signed-zero results are exported as zero.

Alternative or Complementary methods

Review the complete survey design, environmental conditions, detection methods, and appropriate wildlife protocols.

References

Calculation and input contract: herpetology/trap-night-partial-effort-term — tool.io

Similar or alternative tools

Survey Cover Object Exposure
Multiply nonnegative integer objects and visits with exact integer intermediates, require unavailableObjectVisits within that product, and subtract unavailable visits for usableObjectVisits.
Herpetofauna Survey Effort Hour Factor
Sum nonnegative observerMinutes and divide by positive minutesPerHour.