Open Photogrammetry Format (OPF)
This repository contains the specification for the Open Photogrammetry Format, also known as OPF.
The Open Photogrammetry Format is an open format for interchange of photogrammetry data.
The specification defines the core elements of photogrammetry projects, such as the input and output of photogrammetric calibration and dense reconstruction. The format is designed to be modular and extensible. Typically, a project is made of a "project container" file (
.opf) which references the other project components, such as the files storing the camera parameters or point clouds.
The following are defined in this specification:
- Project container
- Control points
- Geo-referencing information
- Point cloud and tracks
A glossary is provided.
Examples of OPF files are available under the
JSON files used throught this specification have the following restrictions on formatting and encoding.
- JSON must use UTF-8 encoding
- All strings defined in this spec (properties names, enums) use only ASCII charset and must be written as plain text.
- Names (keys) within JSON objects must be unique, i.e., duplicate keys aren't allowed.
This specification uses URI references (RFC3986) to reference content.
Purpose of extensions
OPF extensions enable OPF implementers to create new functionalities or to expand functionalities of the OPF core specification. Extensions may expose features supported by a single vendor, but they can have multiple implementations. To ease discovery, vetted extensions may become part of the OPF extension registry. Extensions are written against a specific version of the OPF specification and may be promoted to the core OPF specification in a later OPF specification version.
Extensions extend the base model format. Extensions can introduce new properties (including properties that reference external data, and the extension can define the format of those data).
All object properties have an optional
extensions object property that can contain new extension-specific properties. This allows extensions to extend any part of OPF.
Extensions can't remove or redefine existing properties to mean something else.
Extensions may add new properties and values. As much as possible these feature additions are designed to allow safe fallback consumption in tools that do not recognize an extension. In case an application imports a OPF project with an unknown extension and re-exports it, it is desirable to preserve the extension. Extensions should be designed to be resilient to changes to their parent objects.
As per convention, the extension schema should allow additional properties to allow future extensibility of the extension.
Where an extension is meant to share data between teams or with a third party, its format should be specified and documented. The specification of the extenstion should be documented under the "/extensions//" folder.
Extensions names must be of the form:
<UPPERCASE prefix>_<extension name>
Names MUST use lowercase snake-case following the prefix, e.g.
JSON schema is the source of truth regarding conformance with the specification, with the caveat that not all the semantics in the specification can be captured in a schema. The schemas are located in the
Note that by convention schemas of this specification always allow additional properties, this is required to suppport forward compatibility of the format. Such additionnal properties are strictly reserved for future version of the specification and shall not be used for the purpose of extensions. Extensions of the specification are provided through the extensions mechanism exclusively.
Custom extensions to JSON schema
In some instances we have slightly extended the JSON schema vocabularies in order to add additional data that may be used to further validate a compliance with the specification. These extensions are described below:
- New properties in project.schema.json :
optional_sources_per_item_typedictionnaries describe which resources and which sources are required and optional for a given item type.
In addition, in the spirit of forward compatibility, we relax the requirement of JSON schemas with respect to the
enum keyword, which we redefine as an open-ended list of values for the purpose of this specification.
- PIX4Dmatic: import and export (commercial, free for visualisation, since v1.46)
If you use the OPF specification in your research or projects, we kindly request that you cite it as follows:
The Open Photogrammetry Format Specification, Grégoire Krähenbühl, Klaus Schneider-Zapp, Bastien Dalla Piazza, Juan Hernando, Juan Palacios, Massimiliano Bellomo, Mohamed-Ghaïth Kaabi, Christoph Strecha, Pix4D, 2023, retrived from https://pix4d.github.io/opf-spec/
Copyright (c) 2023 Pix4D SA
This specification and all the associated files, including but not limited to the markdown files, json schemas and any automatically generated HTML and PDF files are licensed under the Creative Commons Attribution 4.0 International License (CC BY-SA 4.0).
All scripts and/or code contained in this repository are licensed under Apache License 2.0.
Third party documents or tools that are used or referred to in this specification are licensed under their own terms by their respective copyright owners.