Skip to contents

Get data for acoustic receivers, with options to filter results.

Usage

get_acoustic_receivers(connection = con, receiver_id = NULL, status = NULL)

Arguments

connection

A connection to the ETN database. Defaults to con.

receiver_id

Character (vector). One or more receiver identifiers.

status

Character. One or more statuses, e.g. available or broken.

Value

A tibble with acoustic receiver data, sorted by receiver_id. See also field definitions. Values for owner_organization will only be visible if you are member of the group.

Examples

# Set default connection variable
con <- connect_to_etn()

# Get all acoustic receivers
get_acoustic_receivers(con)
#> # A tibble: 13,336 × 23
#>    receiver_id  manufacturer receiver_model receiver_serial_number modem_address
#>    <chr>        <chr>        <chr>          <chr>                  <chr>        
#>  1 ADTT-3       THELMA BIOT… ADTT           3                      NA           
#>  2 ADTT-4       THELMA BIOT… ADTT           4                      NA           
#>  3 ADTT-LP-7-3… THELMA BIOT… ADTT           LP-7-3-3               NA           
#>  4 ADTT-LP-7-3… THELMA BIOT… ADTT           LP-7-3-4               NA           
#>  5 AMAR-197     INNOVASEA    AMAR           197                    NA           
#>  6 AMAR-388     INNOVASEA    AMAR           388                    NA           
#>  7 AMAR-404     INNOVASEA    AMAR           404                    NA           
#>  8 AQUAMEASURE… INNOVASEA    AQUAMEASURE D… 670285                 NA           
#>  9 AQUAMEASURE… INNOVASEA    AQUAMEASURE D… 670286                 NA           
#> 10 AQUAMEASURE… INNOVASEA    AQUAMEASURE D… 670287                 NA           
#> # ℹ 13,326 more rows
#> # ℹ 18 more variables: status <chr>, battery_estimated_life <chr>,
#> #   owner_organization <chr>, financing_project <chr>,
#> #   built_in_acoustic_tag_id <chr>, ar_model <chr>, ar_serial_number <chr>,
#> #   ar_battery_estimated_life <chr>, ar_voltage_at_deploy <chr>,
#> #   ar_interrogate_code <chr>, ar_receive_frequency <chr>,
#> #   ar_reply_frequency <chr>, ar_ping_rate <chr>, …

# Get lost and broken acoustic receivers
get_acoustic_receivers(con, status = c("lost", "broken"))
#> # A tibble: 309 × 23
#>    receiver_id  manufacturer receiver_model receiver_serial_number modem_address
#>    <chr>        <chr>        <chr>          <chr>                  <chr>        
#>  1 HR2-180K-10… INNOVASEA    HR2-180K-100-… 461210                 NA           
#>  2 NEXTRAK-800… INNOVASEA    NA             800392                 NA           
#>  3 TBR 800 REL… THELMA BIOT… TBR 800 RELEA… 2597                   NA           
#>  4 TBR700-0011… THELMA BIOT… TBR700         001195                 NA           
#>  5 TBR700-0011… THELMA BIOT… TBR700         001197                 NA           
#>  6 TBR700-0017… THELMA BIOT… TBR700         001768                 NA           
#>  7 TBR700-158   THELMA BIOT… NA             158                    NA           
#>  8 TBR700-558   THELMA BIOT… NA             558                    NA           
#>  9 TBR700-720   THELMA BIOT… NA             720                    NA           
#> 10 TBR700-722   THELMA BIOT… NA             722                    NA           
#> # ℹ 299 more rows
#> # ℹ 18 more variables: status <chr>, battery_estimated_life <chr>,
#> #   owner_organization <chr>, financing_project <chr>,
#> #   built_in_acoustic_tag_id <chr>, ar_model <chr>, ar_serial_number <chr>,
#> #   ar_battery_estimated_life <chr>, ar_voltage_at_deploy <chr>,
#> #   ar_interrogate_code <chr>, ar_receive_frequency <chr>,
#> #   ar_reply_frequency <chr>, ar_ping_rate <chr>, …

# Get a specific acoustic receiver
get_acoustic_receivers(con, receiver_id = "VR2W-124070")
#> # A tibble: 1 × 23
#>   receiver_id manufacturer receiver_model receiver_serial_number modem_address
#>   <chr>       <chr>        <chr>          <chr>                  <chr>        
#> 1 VR2W-124070 INNOVASEA    VR2W           124070                 NA           
#> # ℹ 18 more variables: status <chr>, battery_estimated_life <chr>,
#> #   owner_organization <chr>, financing_project <chr>,
#> #   built_in_acoustic_tag_id <chr>, ar_model <chr>, ar_serial_number <chr>,
#> #   ar_battery_estimated_life <chr>, ar_voltage_at_deploy <chr>,
#> #   ar_interrogate_code <chr>, ar_receive_frequency <chr>,
#> #   ar_reply_frequency <chr>, ar_ping_rate <chr>, ar_enable_code_address <chr>,
#> #   ar_release_code <chr>, ar_disable_code <chr>, ar_tilt_code <chr>, …