Skip to main content
https://badge.fury.io/py/thetaexif.svg https://travis-ci.org/regen100/thetaexif.svg?branch=master

thetaexif is a Python library for RICOH THETA image. It provides a EXIF reader class and a rectification tool.

Requirements

  • Python 3.6 or later

  • Pillow

  • Scipy

Setup

$ pip install thetaexif

Usage

In Python

>>> from thetaexif import ExifReader, tag
>>> reader = ExifReader('image.jpg')
>>> reader.makernote[tag.FIRMWARE_VERSION]
b'Rev0102'
>>> reader.theta[tag.ZENITH_ES]
(Fraction(20, 1), Fraction(-24, 1))

Show Theta EXIF

$ theta-tool info image.jpg
RICOH Marker Note
0x0001 [MakerNoteType]: Rdc
0x0002 [FirmwareVersion]: Rev0102
0x0005 [SerialNumber]: 0000000000102690
0x1000 [RecordingFormat]: 2

THETA Subdir
0x0001 [RicohCameraType]: 1
0x0002 [HDRType]: 0
0x0003 [ZenithEs]: (20, -24)
0x0004 [CompassEs]: 45/2
0x0005 [AbnormalAcceleration]: 0
0x0101 [FilmISO]: (100, 0, 100, 0)
0x0102 [Aperture]: (21/10, 21/10)
0x0103 [ExposureTime]: (1/4000, 1/4000)
0x0104 [SensorSerial1]: A0015348
0x0105 [SensorSerial2]: A0015357

Rectification

rectify command reads gyroscope and compass data and rotate images to rectify camera pose.

Rectify image.jpg and save to image_rectified.jpg:

$ theta-tool rectify image.jpg

Rectify image.jpg using compass data (rotate image to face the north):

$ theta-tool rectify -c image.jpg

Keep EXIF and rectify:

$ theta-tool rectify -e image.jpg

Changelog

0.2 (2019-05-02)

  • Support Python 3.x

  • Remove the dependency on Cython

0.1 (2014-06-22)

  • Initial release

Release files for thetaexif 0.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for thetaexif 0.2
File Size Uploaded
thetaexif-0.2.tar.gz 7.7 kB Details

Release files / thetaexif-0.2.tar.gz

Download URL thetaexif-0.2.tar.gz
Size 7.7 kB
Tags Source
SHA-256 checksum
How to use checksums
6d085df69f0c67076db2712db2ae70363620c4098bde5338ab31838034287b40
BLAKE2b-256 checksum
How to use checksums
35b8191425013638e6db57ba06930872ca141338cd30a056cc005143eea812a2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/1.13.0 pkginfo/1.5.0.1 requests/2.21.0 setuptools/41.0.1 requests-toolbelt/0.9.1 tqdm/4.28.1 CPython/3.7.3

Release history Release notifications | RSS feed

This release

0.2 This release

1 release file

0.1

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page