get_cattle: Retrieve cattle information from the DataMuster MongoDB...

View source: R/get_cattle.R

get_cattleR Documentation

Retrieve cattle information from the DataMuster MongoDB database.

Description

This function provides a search tool to retrieve cattle information from the Cattle collection in the DataMuster MongoDB database. It also allows the user to define what fields should be returned. If you need assistance please email info@datamuster.net.au to seek help or suggest improvements.

Usage

get_cattle(
  RFID = NULL,
  MTag = NULL,
  property = NULL,
  sex = NULL,
  category = NULL,
  paddock = NULL,
  alms = NULL,
  autodraft = NULL,
  weaned = NULL,
  id = NULL,
  almsasset_id = NULL,
  autodraftasset_id = NULL,
  exstation = NULL,
  exitdate = NULL,
  entrydate = NULL,
  deathdate = NULL,
  timezone = NULL,
  prevpaddock = NULL,
  active = NULL,
  fields = NULL,
  username = NULL,
  password = NULL
)

Arguments

RFID

a list of cattle RFID number/s

MTag

a list of cattle management tag number/s. Property must be specified in order to search using this field

property

the name of the property to search for

sex

male or female

category

the class of cattle either (breeding or growing)

paddock

the name of the paddock to search for

alms

TRUE or FALSE, if true filters the data for cattle currently allocated to an alms unit

autodraft

TRUE or FALSE, if true filters the data for cattle currently allocated to an auto drafting unit

weaned

TRUE if the animal/s are weaned or FALSE if animal/s are not weaned

id

ID of the animal

almsasset_id

ID of the ALMS unit

autodraftasset_id

ID of the auto drafting unit

exstation

the former property of the animal

exitdate

the date that the animal left the property in date format

entrydate

the date that the animal entered the property in date format

deathdate

the date that the animal died

timezone

the local timezone of the property, see https://en.wikipedia.org/wiki/List_of_tz_database_time_zones for the list of accepted timezones

prevpaddock

the former paddock of the animal

active

TRUE or FALSE, if true filters the data for cattle that are currently active

fields

a list of headers from the Cattle collection in the DataMuster MongoDB database to be returned. If not specified, the RFID, MTag, property, sex, paddock, category, and static weight will be returned

username

if you don't have a username set up using the dmaccess function you can pass a username, if no value added then the function looks for a value from dmaccess via keyring

password

if you include a username you will also need to add a password contact Lauren O'Connor if you don't have access

Value

a list of cattle RFID numbers with the list of fields defined in the inputs and searched using the search terms

Author(s)

Dave Swain d.swain@cqu.edu.au, Lauren O'Connor l.r.oconnor@cqu.edu.au, and Anita Chang a.chang@cqu.edu.au


PrecisionLivestockManagement/DMMongoDB documentation built on Aug. 22, 2023, 10:57 a.m.