BovHEAT

Bovine Heat Analysis Tool (BovHEAT) - Automated Heat detection and analysis tool for "SCR Heatime" (SCR Engineers Ltd., Netanya, Israel) a neck-mounted accelerometer for automated activity monitoring in cows. This tool analyses the raw data and performs error detection and correction. Additional data sources will be supported in the future.

We provide a one-file executable, which reads and processes SCR files automatically. The user can define the desired threshold for estrus detection and the observation period. Results are delivered as a wide and long formatted XLSX file and a PDF with activity line graph visualizations for each cow.

How to cite

upcoming

Demo

Output

Example output as XLSX and PDF files can be examined at example/output/. For this example an observation period of 5 days before till 30 days after calving was selected. The estrus detection threshold was set at 35.

Data

To try BovHEAT on your machine and generate the output for yourself, download the zipped example data from example/output/data_zipped.zip. Run the BovHeat in parent folder according to the steps below. The column language is eng.

Usage

1. Download

We provide a one-file executable for Windows, Linux and macOS. Download the zipped executable corresponding to your OS from the latest BovHEAT release.

2. SCR files and folder structure

Place the BovHEAT executable in the folder containing SCR files in the XLSX or XLS format. Alternatively, you can group SCR files in folders and put BovHEAT in the parent folder. Cow IDs have to be unique in the data or unique within folders. Therefore, we recommend you use one of the following two folder structures.

├── farm1                          OR           ├── farm1_scr_file1.xlsx 
│   ├── farm1_scr_file1.xlsx                    ├── farm1_scr_file2.xlsx 
│   └── farm1_scr_file2.xlsx                    ├── farm1_scr_file3.xlsx 
├── farm2                                       └── BovHEAT executable 
│   ├── farm2_scr_file1.xlsx    
│   └── farm2_scr_file2.xlsx    
└── BovHEAT executable

3. Run BovHEAT and select parameters

Execute BovHEAT, wait a few seconds for it to start and enter the following information.

Column header language
Column language of the SCR files

Start and Stop DIM
Choose the start and stop DIM to select the observation interval.
As an example: Start -5 and Stop 35 would include 5 days before till 35 days after calving.

Threshold
Choose the desired threshold for estrus detection. Recommended is a threshold of 35.

4. Processing and results

Observe the progress on screen. Results are delivered as a wide and long formatted XLSX file and a PDF file with activity line graph visualizations for each cow.

Requirements and constraints

SCR file requirements

The following columns are required to be present in all SCR files:

"Cow Number"
"Date"
"Time"
"Activity Change"
"Lactation Number"
"Days in Lactation"

OS Requirements

The one-file executable of BovHEAT using x64 Python is built through GitHub Actions. Therefore, the highest compatibility is achieved on these x64 OS versions and up:

macos-10.15
windows-2019
ubuntu-18.04

Development

To set up the development environment install poetry. And run:

poetry install

Start the program:

poetry run python bovheat_src/bovheat.py

Optional/Extras

To install packages related to testing:

poetry install -E pytest-testing

Linting:

poetry install -E pylint

anubrag / bovheat