Skip to content

Collecting Events

Collecting events record the activity, collection methods, personnel, environmental conditions, astronomy, and media for a period of work at a site. Specimens link to a collecting event rather than directly to a site, so the event connects each specimen to its site, coordinate, method, and collector.

Configure event controlled vocabularies and visible environmental fields before fieldwork in Settings > Events:

  1. Open Settings from the home screen menu, the project Dashboard menu, or the Tools dock.
  2. Select Events.
  3. Customize the controlled vocabularies for Primary Activities, Collection Methods, and Personnel Roles.
  4. Under Environmental data fields, toggle which built-in fields appear on event forms (defaults: Ambient temperature, Ambient humidity, Cloud cover, Rainfall, and Notes).

Default controlled vocabularies:

  • Primary Activities: Collecting, Recording, and Observing. Other is omitted by default, but you can add it or any protocol-specific activity. Previously stored values stay selectable even if removed from the vocabulary.
  • Collection Methods: Hands, Mist net, Sweep net, Snap trap, Cage trap, Pitfall, Malaise trap, Light trap, Beating sheet, Aspirator, Local snare, Pellet gun, and Other.
  • Personnel Roles: Leader and Helper (add roles such as driver, recorder, or observer as needed).

Open an event and use its three-dot menu to manage records:

ActionWhat it does
Create eventAdds a new event.
Duplicate eventCopies site, times, activity, notes, ID suffix, collection methods, and personnel; advances Start Date and End Date by one day and creates a blank environmental-data record.
Sort recordsChooses the sort field and direction for the event list.
Show QRDisplays the event as a QR code for another device to scan.
Export eventSaves the event as JSON, or as a ZIP or TAR.GZ archive when it includes media.
Scan QRCreates or replaces an event from an event QR code (Android, iOS, macOS, and web).
Import eventCreates or replaces an event from an exported JSON file or archive.
Delete recordDeletes the event with its collection methods, event personnel, environmental data, and media, and detaches associated data. Blocked while any specimen references the event.
Delete all recordsDeletes every event in the project after referencing specimens have been moved or deleted.

When importing an event, choose whether to create a new event or update an existing one, then confirm the linked site and personnel.

  1. Open the Events page from the navigation bar.

  2. Select the add icon A at the top right (or open the three-dot menu and choose Create event).

  3. Select Site ID C.

  4. Enter Start Date and End Date D (future dates cannot be chosen). NAHPU generates Event ID B as {Site ID}-{Start Date}.

  5. Optionally tap the edit icon beside Event ID to add an ID suffix when multiple events share the same site and start date (for example, day vs. night sessions).

  6. Enter Start Time and End Time.

  7. Choose Primary activity E and add any activity Notes.

Event Identity stores Event ID, Site ID, Start Date, End Date, Start Time, and End Time.

When the active catalog format is Mammalogy, the Start Date picker defaults to the previous day and time pickers start at 07:00 to match overnight trap checks. For other catalog formats, date and time pickers default to the current date and time.

The Activity card records the broad purpose of the event:

  • Primary activity E: chosen from the controlled vocabulary in Settings > Events (existing stored values remain selectable even if no longer in the vocabulary).
  • Notes: free-text details about protocols, secondary activities, or why Other was used.

Create separate events whenever different activities need their own collection methods, personnel, or environmental context.

An event can hold multiple collection-method records so specimens can reference the exact gear used.

  1. Select Add collection method F.
  2. Choose Method (from the controlled vocabulary in Settings > Events) and enter Count (number of traps, nets, recorders, or other units).
  3. Under Method details, optionally add Brand and Model, Size, and Notes.
  4. Save the method.

Use the edit icon on any row to update it, or use Select to delete methods. Specimen capture records can pick any of the event's methods as Method.

The event tab panel has three icon tabs: people (Event Personnel), cloud (Environmental Data), and storage (Associated Data). Events also include a media section for photos, video, audio, and files.

  1. Open the people tab in the event panel and select Add personnel G.
  2. Choose a person from Personnel (project personnel list).
  3. Choose a Role (from the controlled vocabulary in Settings > Events).

Use Select to remove personnel rows from the event. Include everyone who contributed (collectors, leaders, helpers, drivers, observers, or recorders). Specimen capture records select their Collector from this event personnel list.

NAHPU creates one environmental-data record H per collecting event. Toggle visible built-in fields in Settings > Events; hiding a field only changes the form and never deletes stored values or removes them from exports.

Enter astronomy values from field observations or a documented source—NAHPU does not calculate sunrise, sunset, or moon phase. Record times in the project's local time zone and leave unmeasured fields blank. Values save as you edit; check any validation message before leaving the form.

GroupBuilt-in fieldsNotes & units
TemperatureDay Lowest, Day Highest, Night Lowest, Night Highest, Ambient temperatureMeasured in °C.
HumidityAverage, Dew Point, Ambient humidityHumidity in % (0–100); dew point in °C.
WeatherCloud cover (oktas), RainfallCloud cover 0 (clear) to 8 (overcast), or 9 (obscured); rainfall in mm.
Aquatic DataWater temperature, pH, Dissolved oxygen, Dissolved oxygen saturation, Conductivity, Flow velocity°C, pH (0–14), mg/L, % (0–500), µS/cm, and m/s.
AstronomySunrise, Sunset, Moon phaseLocal times; 8 standard moon phases from New Moon through Waning Crescent.
Notes & Custom fieldsNotes, custom fieldsAdd installation-wide or project-scoped fields with Add custom field or Manage custom fields.

Environmental custom fields belong to each event, are not filtered by catalog format, and are included in event, specimen, document, Darwin Core, record-exchange, and project-transfer exports. Environmental data is never copied when duplicating an event.

A specimen's Capture records card pulls its context from the collecting event:

  • Site ID filters available events.
  • Event ID links the specimen to the event.
  • Method comes from the event's collection methods.
  • Collector comes from the event's personnel list.
  • Coordinate ID comes from coordinates on the event's site.

Changing a specimen's event clears event-dependent fields (Method, Collector, and Coordinate ID) while keeping the capture date and time.