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.
upcoming
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.
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.
We provide a one-file executable for Windows, Linux and macOS. Download the zipped executable corresponding to your OS from the latest BovHEAT release.
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
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.
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.
The following columns are required to be present in all SCR files:
"Cow Number"
"Date"
"Time"
"Activity Change"
"Lactation Number"
"Days in Lactation"
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
To set up the development environment install poetry. And run:
poetry install
Start the program:
poetry run python bovheat_src/bovheat.py
To install packages related to testing:
poetry install -E pytest-testing
Linting:
poetry install -E pylint