Skip to content

Commit

Permalink
publish OPF 1.0.2 (#7)
Browse files Browse the repository at this point in the history
  • Loading branch information
krahenbuhl authored May 25, 2023
1 parent f3a0abf commit af910e1
Show file tree
Hide file tree
Showing 26 changed files with 104 additions and 138 deletions.
6 changes: 5 additions & 1 deletion docs/_sources/index.rst.txt
Original file line number Diff line number Diff line change
Expand Up @@ -17,8 +17,10 @@ Features
- Based as much as possible on simple human readable JSON files, leverage efficient binary formats where a text-based representation would be impractical (for example for the point cloud data)
- OPF organizes photogrammetry data in a structured manner, allowing for easy access and retrieval of information.
- The data model includes information on both input and output of the photogrametry process:

- The input data include information about input cameras (camera list, input camera parameters), coordinate reference system, control points, scale and orientation constraints, etc.
- The output data include information about camera calibration (sparse point cloud, calibrated cameras) and the dense reconstructed point clouds.

- Efficient Storage of point clouds: The point cloud format for ATPs (sparse point cloud) and dense point cloud included in this specification is based on the open standard `GlTF <https://www.khronos.org/gltf/>`_ and is designed to be memory-mappable and spatially partitioned, enabling both efficient processing and progressive rendering of massive point clouds. The format retains information on the point visibiliy on images, normals, custom attributes, and more.
- Flexible Extension System: OPF is designed to be highly extensible and customizable, allowing for easy expansion of data representation as needed.
- OPF will be improved on an on-going basis to support additional photogrammetric outputs.
Expand Down Expand Up @@ -51,16 +53,18 @@ Existing tooling
We try to maintain here a non-comprehensive list of tools that implement the OPF specification. If you have a tool that implements OPF and you would like it to be listed here, please reach out to us!

- The `OPF GitHub <https://github.com/Pix4D/opf-spec>`_ repository, containing

- the source of the `the OPF specification and documentation <https://github.com/Pix4D/opf-spec/tree/main/docs>`_.
- JSON `schemas <https://github.com/Pix4D/opf-spec/tree/main/schema>`_.

- `Pix4Dmatic <https://www.pix4d.com/download/pix4dmatic/>`_ (commercial software). Minimum version required: v1.46.

Citation
==========

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 http://developer.pix4d.com/opf-spec/`
`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/`


License
Expand Down
4 changes: 2 additions & 2 deletions docs/_static/css/theme.css

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion docs/_static/documentation_options.js
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
var DOCUMENTATION_OPTIONS = {
URL_ROOT: document.getElementById("documentation_options").getAttribute('data-url_root'),
VERSION: '',
VERSION: '1.0.2',
LANGUAGE: 'None',
COLLAPSE_INDEX: false,
BUILDER: 'html',
Expand Down
10 changes: 4 additions & 6 deletions docs/annexes.html
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@

<meta name="viewport" content="width=device-width, initial-scale=1.0">

<title>Annexes &mdash; Open Photogrammetry Format Specification documentation</title>
<title>Annexes &mdash; Open Photogrammetry Format Specification 1.0.2 documentation</title>



Expand Down Expand Up @@ -45,7 +45,7 @@
<div class="globalNav">
<a class="homeLogo" href="index.html">

<li>Open Photogrammetry Format</li>
Open Photogrammetry Format
</a>
<ul>
<li class="version-switcher-placeholder"></li>
Expand Down Expand Up @@ -387,19 +387,17 @@
<li>OPF /</li>

<li>
Version /
Version 1.0.2 /
</li>

<li class="dateInfo">None</li>
<li class="dateInfo">May 2023</li>




<li class="wy-breadcrumbs-aside">


<a href="_sources/annexes.rst.txt" rel="nofollow"> View page source</a>


</li>

Expand Down
10 changes: 4 additions & 6 deletions docs/calibration.html
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@

<meta name="viewport" content="width=device-width, initial-scale=1.0">

<title>Calibration &mdash; Open Photogrammetry Format Specification documentation</title>
<title>Calibration &mdash; Open Photogrammetry Format Specification 1.0.2 documentation</title>



Expand Down Expand Up @@ -45,7 +45,7 @@
<div class="globalNav">
<a class="homeLogo" href="index.html">

<li>Open Photogrammetry Format</li>
Open Photogrammetry Format
</a>
<ul>
<li class="version-switcher-placeholder"></li>
Expand Down Expand Up @@ -387,19 +387,17 @@
<li>OPF /</li>

<li>
Version /
Version 1.0.2 /
</li>

<li class="dateInfo">None</li>
<li class="dateInfo">May 2023</li>




<li class="wy-breadcrumbs-aside">


<a href="_sources/calibration.rst.txt" rel="nofollow"> View page source</a>


</li>

Expand Down
10 changes: 4 additions & 6 deletions docs/cameras.html
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@

<meta name="viewport" content="width=device-width, initial-scale=1.0">

<title>Cameras &mdash; Open Photogrammetry Format Specification documentation</title>
<title>Cameras &mdash; Open Photogrammetry Format Specification 1.0.2 documentation</title>



Expand Down Expand Up @@ -45,7 +45,7 @@
<div class="globalNav">
<a class="homeLogo" href="index.html">

<li>Open Photogrammetry Format</li>
Open Photogrammetry Format
</a>
<ul>
<li class="version-switcher-placeholder"></li>
Expand Down Expand Up @@ -387,19 +387,17 @@
<li>OPF /</li>

<li>
Version /
Version 1.0.2 /
</li>

<li class="dateInfo">None</li>
<li class="dateInfo">May 2023</li>




<li class="wy-breadcrumbs-aside">


<a href="_sources/cameras.rst.txt" rel="nofollow"> View page source</a>


</li>

Expand Down
8 changes: 4 additions & 4 deletions docs/genindex.html
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@

<meta name="viewport" content="width=device-width, initial-scale=1.0">

<title>Index &mdash; Open Photogrammetry Format Specification documentation</title>
<title>Index &mdash; Open Photogrammetry Format Specification 1.0.2 documentation</title>



Expand Down Expand Up @@ -43,7 +43,7 @@
<div class="globalNav">
<a class="homeLogo" href="index.html">

<li>Open Photogrammetry Format</li>
Open Photogrammetry Format
</a>
<ul>
<li class="version-switcher-placeholder"></li>
Expand Down Expand Up @@ -385,10 +385,10 @@
<li>OPF /</li>

<li>
Version /
Version 1.0.2 /
</li>

<li class="dateInfo">None</li>
<li class="dateInfo">May 2023</li>



Expand Down
32 changes: 15 additions & 17 deletions docs/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@

<meta name="viewport" content="width=device-width, initial-scale=1.0">

<title>Open Photogrammetry Format (OPF) Specification &mdash; Open Photogrammetry Format Specification documentation</title>
<title>Open Photogrammetry Format (OPF) Specification &mdash; Open Photogrammetry Format Specification 1.0.2 documentation</title>



Expand Down Expand Up @@ -44,7 +44,7 @@
<div class="globalNav">
<a class="homeLogo" href="#">

<li>Open Photogrammetry Format</li>
Open Photogrammetry Format
</a>
<ul>
<li class="version-switcher-placeholder"></li>
Expand Down Expand Up @@ -386,19 +386,17 @@
<li>OPF /</li>

<li>
Version /
Version 1.0.2 /
</li>

<li class="dateInfo">None</li>
<li class="dateInfo">May 2023</li>




<li class="wy-breadcrumbs-aside">


<a href="_sources/index.rst.txt" rel="nofollow"> View page source</a>


</li>

Expand All @@ -421,16 +419,16 @@ <h1>What is OPF?<a class="headerlink" href="#what-is-opf" title="Permalink to th
</div>
<div class="section" id="features">
<h1>Features<a class="headerlink" href="#features" title="Permalink to this headline"></a></h1>
<ul class="simple">
<ul>
<li><p>Based as much as possible on simple human readable JSON files, leverage efficient binary formats where a text-based representation would be impractical (for example for the point cloud data)</p></li>
<li><p>OPF organizes photogrammetry data in a structured manner, allowing for easy access and retrieval of information.</p></li>
<li><dl class="simple">
<dt>The data model includes information on both input and output of the photogrametry process:</dt><dd><ul>
<li><p>The data model includes information on both input and output of the photogrametry process:</p>
<blockquote>
<div><ul class="simple">
<li><p>The input data include information about input cameras (camera list, input camera parameters), coordinate reference system, control points, scale and orientation constraints, etc.</p></li>
<li><p>The output data include information about camera calibration (sparse point cloud, calibrated cameras) and the dense reconstructed point clouds.</p></li>
</ul>
</dd>
</dl>
</div></blockquote>
</li>
<li><p>Efficient Storage of point clouds: The point cloud format for ATPs (sparse point cloud) and dense point cloud included in this specification is based on the open standard <a class="reference external" href="https://www.khronos.org/gltf/">GlTF</a> and is designed to be memory-mappable and spatially partitioned, enabling both efficient processing and progressive rendering of massive point clouds. The format retains information on the point visibiliy on images, normals, custom attributes, and more.</p></li>
<li><p>Flexible Extension System: OPF is designed to be highly extensible and customizable, allowing for easy expansion of data representation as needed.</p></li>
Expand All @@ -455,14 +453,14 @@ <h1>Content of the specification<a class="headerlink" href="#content-of-the-spec
<div class="section" id="existing-tooling">
<h1>Existing tooling<a class="headerlink" href="#existing-tooling" title="Permalink to this headline"></a></h1>
<p>We try to maintain here a non-comprehensive list of tools that implement the OPF specification. If you have a tool that implements OPF and you would like it to be listed here, please reach out to us!</p>
<ul class="simple">
<li><dl class="simple">
<dt>The <a class="reference external" href="https://github.com/Pix4D/opf-spec">OPF GitHub</a> repository, containing</dt><dd><ul>
<ul>
<li><p>The <a class="reference external" href="https://github.com/Pix4D/opf-spec">OPF GitHub</a> repository, containing</p>
<blockquote>
<div><ul class="simple">
<li><p>the source of the <a class="reference external" href="https://github.com/Pix4D/opf-spec/tree/main/docs">the OPF specification and documentation</a>.</p></li>
<li><p>JSON <a class="reference external" href="https://github.com/Pix4D/opf-spec/tree/main/schema">schemas</a>.</p></li>
</ul>
</dd>
</dl>
</div></blockquote>
</li>
<li><p><a class="reference external" href="https://www.pix4d.com/download/pix4dmatic/">Pix4Dmatic</a> (commercial software). Minimum version required: v1.46.</p></li>
</ul>
Expand Down Expand Up @@ -545,4 +543,4 @@ <h1>Contact<a class="headerlink" href="#contact" title="Permalink to this headli
</script>

</body>
</html>
</html>
Binary file modified docs/objects.inv
Binary file not shown.
10 changes: 4 additions & 6 deletions docs/scene_reference_frame.html
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@

<meta name="viewport" content="width=device-width, initial-scale=1.0">

<title>Scene reference frame &mdash; Open Photogrammetry Format Specification documentation</title>
<title>Scene reference frame &mdash; Open Photogrammetry Format Specification 1.0.2 documentation</title>



Expand Down Expand Up @@ -45,7 +45,7 @@
<div class="globalNav">
<a class="homeLogo" href="index.html">

<li>Open Photogrammetry Format</li>
Open Photogrammetry Format
</a>
<ul>
<li class="version-switcher-placeholder"></li>
Expand Down Expand Up @@ -387,19 +387,17 @@
<li>OPF /</li>

<li>
Version /
Version 1.0.2 /
</li>

<li class="dateInfo">None</li>
<li class="dateInfo">May 2023</li>




<li class="wy-breadcrumbs-aside">


<a href="_sources/scene_reference_frame.rst.txt" rel="nofollow"> View page source</a>


</li>

Expand Down
8 changes: 4 additions & 4 deletions docs/search.html
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@

<meta name="viewport" content="width=device-width, initial-scale=1.0">

<title>Search &mdash; Open Photogrammetry Format Specification documentation</title>
<title>Search &mdash; Open Photogrammetry Format Specification 1.0.2 documentation</title>



Expand Down Expand Up @@ -43,7 +43,7 @@
<div class="globalNav">
<a class="homeLogo" href="index.html">

<li>Open Photogrammetry Format</li>
Open Photogrammetry Format
</a>
<ul>
<li class="version-switcher-placeholder"></li>
Expand Down Expand Up @@ -385,10 +385,10 @@
<li>OPF /</li>

<li>
Version /
Version 1.0.2 /
</li>

<li class="dateInfo">None</li>
<li class="dateInfo">May 2023</li>



Expand Down
2 changes: 1 addition & 1 deletion docs/searchindex.js

Large diffs are not rendered by default.

Loading

0 comments on commit af910e1

Please sign in to comment.