metadata_for_receivers: get metadata for receivers

In MotusWTS/motusServer: Operate a server to process data for http://motus.org

get metadata for receivers

Description

get metadata for receivers

Usage

metadata_for_receivers(env)

Arguments

deviceIDs;

integer vector of motus device IDs; receiver metadata will only be returned for receivers whose project has indicated their metadata are public, or receivers in one of the projects the user has permissions to.

Value

a list with these items:

• recvDeps; a list with these vector items:

  • deployID; integer deployment ID (internal to motus, but links to antDeps)

  • projectID; integer ID of project that deployed the receiver

  • serno; character serial number, e.g. "SG-1214BBBK3999", "Lotek-8681"

  • receiverType; character "SENSORGNOME" or "LOTEK"

  • deviceID; integer device ID (internal to motus)

  • status; character deployment status

  • name; character; typically a site name

  • fixtureType; character; what is the receiver mounted on?

  • latitude; numeric (initial) location, degrees North

  • longitude; numeric (initial) location, degrees East

  • elevation; numeric (initial) location, metres ASL

  • isMobile; integer non-zero means a mobile deployment

  • tsStart; numeric; timestamp of deployment start

  • tsEnd; numeric; timestamp of deployment end, or NA if ongoing

• antDeps; a list with these vector items:

  • deployID; integer, links to deployID in recvDeps table

  • port; integer, which receiver port (USB for SGs, BNC for Lotek) the antenna is connected to

  • antennaType; character; e.g. "Yagi-5", "omni"

  • bearing; numeric compass angle at which antenna is pointing; degrees clockwise from magnetic north

  • heightMeters; numeric height of main antenna element above ground

  • cableLengthMeters; numeric length of coaxial cable from antenna to receiver, in metres

  • cableType: character; type of cable; e.g. "RG-58"

  • mountDistanceMeters; numeric distance of mounting point from receiver, in metres

  • mountBearing; numeric compass angle from receiver to antenna mount; degrees clockwise from magnetic north

  • polarization2; numeric angle giving tilt from "normal" position, in degrees

  • polarization1; numeric angle giving rotation of antenna about own axis, in degrees.

• projs; a list with these columns:

  • id; integer motus project id

  • name; character full name of motus project

  • label; character short label for motus project; e.g. for use in plots

Note

only metadata which are public, or which are from projects the user has permission to are returned.

MotusWTS/motusServer documentation built on Oct. 13, 2024, 7:31 p.m.