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

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

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

help(Cam.plot)    # shows quick-guide for plot key bindings
cam.plot()        # interactive plot for image filtering
cam.save()        # creates a .sav file that can be loaded
cam.export()      # images and .csv file are exported 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.

Source Distribution

gamecam-sdrabing-0.7.1.tar.gz (16.6 kB view hashes)

Uploaded Source

Built Distribution

gamecam_sdrabing-0.7.1-py3-none-any.whl (17.6 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page