PEPI

“A Portable, Extensible Photogrammetry Instrument.”

PEPI is a software platform that enables remote command and control of servers with connected cameras. PEPI is used for the purposes of acquiring stereo-photogrammetry imagery. It seamlessly supports any number of connected servers without any required manual setup.

PEPI is designed to be expanded upon. The implementation in this repo is purely Python-based for a Raspberry Pi with Camera Module, but it is built upon Apache Thrift. Therefore, any correct implementation in an Apache Thrift supported language should work out of the box. This means that as long as you can write a camera ‘adapter’ that adheres to the PEPI standard, you can use it with PEPI.

Links

• PEPI is licensed under the Apache-2.0 license.
• PEPI’s source code is available on GitHub.
• PEPI’s documentation is available on ReadTheDocs.
• PEPI uses a continuous integration and testing system provided by Travis CI.

Built With

• Python 2 & 3 - This implementation is built on Python 2.7 and should be compatible with Python 3.6. Python is not strictly, should the use of another language be desirable.
• Apache Thrift - A software framework for scalable, cross-language services
• PiCamera - A pure Python interface to the Raspberry Pi Camera Module
• Flask - A web microframework for Python, used for the included user interface
• ..and many more packages gracefully provided by the Python community.

Authors & Acknowledgements

• Claudio Pizzolato - Initial work and proof of concept
• Curtis West- Development from proof of concept through to version 2.0
• Griffith University - For supporting the project

Table of Contents

• 1. About PEPI
  • 1.1. What is PEPI?
  • 1.2. Terminology
  • 1.3. PEPI’s Structure
  • 1.4. Hardware
  • 1.5. Motivations
• 2. Installation
  • 2.1. Prerequisites
    • 2.1.1. Python
    • 2.1.2. Raspberry Pi
    • 2.1.3. Camera Module
    • 2.1.4. SSH Keys
  • 2.2. Client Installation
  • 2.3. Raspberry Pi Server Installation
    • 2.3.1. Downloading & Installing
    • 2.3.2. Duplicating SD cards
• 3. Using PEPI
  • 3.1. Setup Panel
  • 3.2. Control Panel
  • 3.3. Servers Panel
• 4. Extending PEPI
  • 4.1. PEPI Theory
    • 4.1.1. Languages
  • 4.2. Writing New Servers
    • 4.2.1. Interface Definition File
    • 4.2.2. Python’s BaseCameraServer
  • 4.3. Writing New Cameras
    • 4.3.1. Testing Your Camera Implementation
  • 4.4. Raspi Server Implementation
• 5. Testing
  • 5.1. Running Tests
  • 5.2. Testing Camera Components
    • 5.2.1. Python Cameras
    • 5.2.2. Non-Python Cameras
  • 5.3. Testing Servers
    • 5.3.1. Python Servers
    • 5.3.2. Non-Python Servers
• 6. pepi
  • 6.1. raspi_server package
    • 6.1.1. Submodules
    • 6.1.2. raspi_server.raspi_camera module
    • 6.1.3. raspi_server.raspi_server module
    • 6.1.4. raspi_server.run module
    • 6.1.5. Module contents
  • 6.2. server package
    • 6.2.1. Subpackages
    • 6.2.2. Submodules
    • 6.2.3. server.abstract_camera module
    • 6.2.4. server.base_camera_server module
    • 6.2.5. server.dummy_camera module
    • 6.2.6. server.iptools module
    • 6.2.7. server.pepi_thrift_loader module
    • 6.2.8. server.stream module
    • 6.2.9. Module contents

Indices and Tables

• Index
• Module Index
• Search Page