Skip to main content

Imaging Client GUI for manual classification

Project description

Client Graphical User Interface

This client GUI is used for manual imaging target classification through the BYU AUVSI imaging server.



If you just want to use the client to classify images, and don't plan on doing any development with it, here's how you can set it up.


sudo apt install python3-pip python3-tk
pip3 install byu-auvsi-imaging-client

And to run you can simply enter:


You may also consider adding ~/.local/bin/ to your PATH:

export PATH="$HOME/.local/bin:$PATH"


To develop and contribute to this gui, clone the imaging repository.

This gui was built with tkinter in python3 and relies on a few packages

sudo apt install python3-tk python3-tk


For development you should run the gui in its local directory:

cd ...../src/imaging/client

If installed via pip, simply run it as a script:


Sub Functions

This gui is built with with a tkinter tab framework. Each tab is initialized at startup which creates each container label and widget on each tab. Only one tab runs at a time.

lib/ contains all functions that interact with the server
lib/ contains the functions for tab X
lib/ contains helper functions used by multiple tabs

Releasing on Pypi

Travis takes care of most of the heavy lifting when you want to release a new version of the gui onto pip/Pypi. In order to release a new version, you need to do two things:

  1. Update the VERSION variable in client/ to whatever the new version is going to be called. If you dont do this, the new code will NOT be uploaded onto Pypi!

  2. Update the self.version_num at the top of the file client/lib/ to display on the gui the correct current version number.

  3. Create a release tag on github that matches the VERSION. (Goto Releases->Create a new Release). Once a commit is tagged as a release, Travis will kick off a 'deploy' build for the current code, sending it to PyPi and thus to pip.

Future Updates

The header of each file contains possible future improvements

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 byu-auvsi-imaging-client, version 0.1.8
Filename, size File type Python version Upload date Hashes
Filename, size byu_auvsi_imaging_client-0.1.8-py3-none-any.whl (250.3 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size byu-auvsi-imaging-client-0.1.8.tar.gz (188.3 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page