Package: odmax
ODMaxODMaxis a utility to extract still frames from 360-degree video platforms such as GoPro or Insta.ODMaxpreserves the geoghraphical information
in videos and adds the geolocation to stills so that they can be used for geospatial applications such as geospatial photogrammetry with OpenDroneMap, or Streetview applications.We are seeking funding for the following frequently requested functionalities:seamless processing via command-line to WebODM instancesseamless processing to streetview productsfiltering options such as cloud masking, vegetation segmentation or other featuresvariable frame interval detection, based on feature changes (currently a fixed frame interval must be set)If you wish to fund this or other work on features, please contact us atinfo@rainbowsensing.com.note:For instructions how to get Anaconda (with lots of pre-installed libraries) or Miniconda (light weight) installed, please go tohttps://docs.conda.io/projects/conda/en/latest/manual:A full manual with examples can be found onhttps://odmax.readthedocs.io/compatibility:At this momentODMaxworks with GoPro videos. It may or may not work with other 360 degree camera brands and models but this has not been tested.InstallationTo get started withODMax, we recommend to setup a python virtual environment.
We recommend using a Miniconda or Anaconda environment as this will ease installation, and will allow you to use all
functionalities without any trouble. Especially geographical plotting withcartopycan be difficult to get installed.
With acondaenvironment this is solved. We have also conveniently packaged all dependencies for you.
In the subsections below, you can find specific instructions.Installation for direct useIf you simply want to addODMaxto an existing python installation or virtual environment, then follow these
instructions.First activate the environment you wantODMaxto be installed in (if you don't care about virtual environments, then
simply skip this step)Then installODMaxas follows:pip install odmaxThat's it! You are good to go!Installation from code baseTo installODMaxfrom scratch in a new virtual environment from the code base, go through these steps. Logical cases
when you wish to install from the code base are:You wish to have the very latest non-released versionYou wish to develop on the codeYou want to use our pre-packaged conda environment with all dependencies to setup a good virtual environmentFirst, clone the code withgitand move into the cloned folder.git clone https://github.com/localdevices/ODMax.git
cd ODMaxIf you want, setup a virtual environment as follows:conda env create -f environment.ymlNow install theODMaxpackage. If you want to developODMaxplease typepip install -e .If you just want to use the latesODMaxcode base (without the option to develop on the code) type:pip install .That's it, you are good to go.Installation of exiftool for metadata extractionEspecially for photogrammetry or 360 streetview applications, it is essential to have time stamps and geographical
coordinates embedded in the extracted stills. ODMax automatically extracts such information from 360-video files if
these are recorded by the device used. In order to do this, ODMax requiresexiftoolto be installed and available on
the path. To installexiftoolin Windows, please follow the download and installation instructions for Windows onhttps://exiftool.org/install.html. For Linux, you can also follow the download and installation instructions, or simply
acquire a stable version from the package manager of your installed distribution.Using ODMaxTo useODMax, go to a command line and typeodmax --helpThis will provide an overview of the most up-to-date command line options.
Alternatively, use our jupyter notebook examples to see common use cases on command-line as
well as directly in the API.AcknowledgementThe development of ODMax has been supported by the Australian National University - Research School of Biology through
funding provided by the National Collaborative Research Infrastructure Strategy (NCRIS), Australian Plant Phenomics
Facility (APPF), and the Australian Scalabel Drone Cloud (ASDC).LicenseODMaxis licensed under AGPL Version 3 (seeLICENSEfile).ODMaxuses the following libraries and software with said licenses.
py360convert is not being maintained actively, therefore the py360convert code has been integrated into theODMaxcode base.PackageVersionLicensenumpy1.21.4BSD Licenseopencv-python-headless4.5.4.60MIT Licensegpxpy1.5.0Apache License, Version 2.0tqdm4.62.3MIT License; Mozilla Public License 2.0 (MPL 2.0)piexif1.1.3MIT Licensematplotlib3.5.1Python Software Foundation Licensegeopandas0.10.2BSD Licensepandas1.3.5BSD LicensePillow8.4.0Historical Permission Notice and Disclaimer (HPND)py360convert0.1.0MIT LicenseProject organisation.
├── README.md
├── LICENSE
├── setup.py            <- setup script compatible with pip
├── environment.yml     <- YML-file for setting up a conda environment with dependencies
├── docs                <- Sphinx documentation source code
    ├── ...             <- Sphinx source code files
├── examples            <- Small example files used in notebooks
    ├── ...             <- individual .jpg and .mp4 files
├── notebooks           <- Jupyter notebooks with examples how to use the API
    ├── ...             <- individual Jupyter notebooks
├── odmax               <- odmax library and CLI
    ├── ...             <- odmax functions and CLI main function .py files