Skip to content

Repository files navigation

Contributors Forks Stargazers Issues MIT License LinkedIn


Logo

Pando Image Sequencing

An image-sequencing algorithm for the Pando Photographic Survey
Explore the docs »

View Demo · Report Bug · Request Feature

Table of Contents
  1. About The Project
  2. Getting Started
  3. Usage
  4. Roadmap
  5. Contributing
  6. License
  7. Contact
  8. Acknowledgments

About The Project

Photo of the Pando Photographic Survey

Development of software for the alignment of images in the Pando Photographic Survey with incorrect timestamps.

(back to top)

Getting Started

🚧 Under Construction 🚧

Prerequisites

This pipeline is designed to run on Unix infrastructure; it will work natively on macOS and Linux, but Windows users should install Windows Subsystem for Linux. You will need the following command-line tools installed:

  • exiftool
  • conda (See install docs here, select the version for your OS)
  • grip (if editing markdown files)

Installation

macOS

  1. Ensure the above command-line tools are installed (e.g., using homebrew).
  2. Create a conda environment using Python 3.12.3 for your Pando tools with
conda create --name pando python=3.12.3
  1. Activate the environment with
conda activate pando
  1. Install pip with
conda install pip
  1. Clone the PandoImageSequencing repository with
git clone git@github.com:Pando-Software-Group/PandoImageSequencing.git
  1. cd into the repository and install dependencies with
pip install -r requirements
  1. Compile the documentation with
PYTHONPATH=. pdoc ../PandoImageSequencing/ -o ./docs/

Problems with Tkinter

If you're having issues with installing tkinter on Linux, try

sudo apt-get install python3-tk

Problems with LibGL

If you're having issues with libGL on Linux, try

sudo apt-get install ffmpeg libsm6 libxext6

(back to top)

Usage

To start the pipeline, ensure you have your JPG and DNG files for a route downloaded, and run

python pipeline.py

in the ./PandoImageSequencing/ directory. Follow the on-screen steps in sequence to perform the sequencing.

Roadmap

  • Test on additional datasets
  • Develop front-facing user-interface
  • Make globally installable
    • Windows/Linux

See the open issues for a full list of proposed features (and known issues).

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

(back to top)

License

Distributed under the GPLv3 License. See LICENSE.txt for more information.

(back to top)

Contact

Lance Oditt - @iamthepandotree - lance@friendsofpando.com

Project Link: https://github.com/Pando-Software-Group/PandoImageSequencing

(back to top)

Acknowledgments

(back to top)

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

2 watching

Forks

Releases

Packages

Used by

Contributors

Languages