Skip to main content

Remote-camera software suite.

Project description

gamecam

Filter out trail-camera images that don't contain an animal (eventually will be able to label exported images as well).

Motivation

While working for the Francis Ecology Lab, a problem was presented to me. In 2018, there were 800,000+ remote camera images collected for a single experiment. The majority turned out to be false triggers - photos of grass and bushes swaying.

Instead of going through them one by one, I developed this program. Once coded, it only took a week to generate a data table with all the images that contained animals, labeled to genus or species, and that had detection numbers corresponding to one of two common schemes. The data table can be converted into observational units of detections instead of individual images.

Installation

Use the package manager pip to install gamecam.

pip install gamecam-sdrabing

Usage

from gamecam import pyrcolate as pyr

# creates data table from folder
jpg_data = pyr.construct_jpg_data(pyr.input_directory())

# Cam objects store all relevant metadata
cam = pyr.Cam(jpg_data)

help(Cam.plot)                     # shows quick-guide for key bindings
cam.plot()                         # interactive plot for image filtering
cam.save(pyr.input_filename())     # creates a .sav file that can be loaded
cam.export(pyr.input_directory())  # exports images and a .csv file to folder

To-Do

Finish gamecam.classipy, which will allow for rapid labeling of exported images.

Contributing

This is my first project, so I have no idea what I'm doing. If you have suggestions or tips, please tell me!

License

MIT © Shane Drabing 2019

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for gamecam-sdrabing, version 0.8.3
Filename, size File type Python version Upload date Hashes
Filename, size gamecam_sdrabing-0.8.3-py3-none-any.whl (16.5 kB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size gamecam-sdrabing-0.8.3.tar.gz (15.6 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page