Ugoku-kun 0.1.2

A package to control cannon camera and keigan motor for structure from motion

ugoku-kun

This is a Python library for controlling Cannon cameras and Keigan Motor for SfM (Structure from Motion) applications.

This Python library is built as part of an internship project at the National Agriculture and Food Research Organization (NARO) in Japan.

Important Notice

I do NOT own any compatible hardware myself. Unfortunately, support for this project will be limited.

If you are interested in forking this project, please let me know. I will reference your fork here and on the documentation so others can be aware of it.

Documentation

Please refer to the documentation for more details.

Documentation

Install

PyPI

pip install Ugoku-kun

Codemap

• README.md: This file.
• src/ugokukun/: The main package.
  • __init__.py
  • cannon_wrapper.py: The camera module CannonWrapper.
  • keigan_wrapper.py: The Keigan Motor module KeiganWrapper.
  • ugoku_kun.py: The main module UgokuKun.
  • ugoku_helers.py: The utility module UgokuHelpers.
• docs/*: Documentation.
• tests/*: Tests, nothing is automated so this could be improved.
• readme_demo/: Read this for quick start.
  • readme.ipynb: READ THIS FIRST.
  • conf/*: Task CSV files and device list JSON file.
  • dump/*: Output files such as log files.
  • importers.py: Helper functions for importing modules.

Dependencies

This Python library is built on top of official APIs provided by Cannon and Keigan.

• Cannon's ccapi
• Keigan's pykeigan

Tested on:

• Ubuntu 22.04
• Python 3.10.12
• Cannon EOS R100 firmware 1.6.0
• Keigan Motor KM-1S-M6829-TS
• pykeigan-motor 2.4.0 installed via pip

Should work on Windows too. ccapi is platform independent.