Merge pull request #7 from alicevision/WIP-Update-node-reference

[WIP] Update node-reference

Author: simogasp

README.md

@@ -6,16 +6,13 @@
 
 # About
 
+Read the latest version on https://meshroom-manual.readthedocs.io/en/latest/ 
+download the PDF from https://readthedocs.org/projects/meshroom-manual/downloads/
+
 **This is documentation is work in progress.**
 
 See [Project ToDo](https://github.com/alicevision/meshroom-manual/projects) for details.
 
-# Next update
-+ capturing images for photogrammetry chapters
-+ MR2019.2 updates
-+ improved layout
-+ readthedocs release (including pdf) https://meshroom-manual.readthedocs.io
-
 # How to contribute
 
 -   make yourself familiar with ReStructuredText and Sphinx
@@ -24,6 +21,7 @@ See [Project ToDo](https://github.com/alicevision/meshroom-manual/projects) for
 
 We could use some help with:
 - optimizing the formatting for pdf&html
+- checking grammar and spelling, fixing typos
 - anything listed here https://github.com/alicevision/meshroom-manual/projects
 
 # How to build on windows

source/about/manual/manual.rst

@@ -1,19 +1,10 @@
 About the manual
 ================
 
-This manual is a compilation of the resources found on alicevision.github.io, breadcrumbs of information collected from github issues, other web resources and new content, created for this manual.
-
-WORK IN PROGRESS! 
-(last update 03.06.19)
-
-
-
-
-You want to help? Missing something?
+This manual is a compilation of the resources found on alicevision.github.io, information collected from github issues, other web resources and new content, created for this manual. This manual is work in progress.
 
 You are welcome to comment and contribute. 
-This document is in “Suggest edits” mode.
-
+Check out https://github.com/alicevision/meshroom-manual/ for details.
 
 
 This work is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License.
@@ -23,4 +14,4 @@ This is a Meshroom community project.
 
 
 
-All product names, logos, and brands are property of their respective owners. All company, product and service names used in this document are for identification purposes only. Use of these names, logos, and brands does not imply endorsement.
+All product names, logos, and brands are property of their respective owners. All company, product and service names used in this document are for identification purposes only. Use of these names, logos, and brands does not imply endorsement.

source/capturing/capturing.rst

@@ -24,10 +24,8 @@ Basics
 
 
 
-Details
--------
+**Details**
 
 
-Tutorials
----------
+**Tutorials**
 

source/gui/augment-reconstruction/augment-reconstruction.rst

@@ -1,3 +1,5 @@
+.. _augment-reconstruction:
+
 Augment Reconstruction
 ======================
 

source/gui/live-reconstruction/live-reconstruction.rst

@@ -1,3 +1,5 @@
+.. _live-reconstruction:
+
 Live Reconstruction
 ===================
 

source/node-reference/connect-nodes/connect-nodes.rst

@@ -13,9 +13,13 @@ This image illustrates the default graph with node connections on the origin nod
 .. image:: default-node-graph-color.jpg
 
 
-Draft Meshing
--------------
+How to use Draft Meshing
+------------------------
+
+.. image:: draft-meshing-node-graph-color.jpg
+
 
-.. image:: draft-meshing-node-graph.jpg
+Panorama graph
+------------------------
 
-.. image:: draft-meshing-node-graph-color.jpg
+.. image:: panorama-node-graph.JPG

source/node-reference/connect-nodes/draft-meshing-node-graph.jpg

@@ -5,14 +5,19 @@ List with all the nodes
 
 .. note::
 
-   Some parameters are exposed for development purposes and are not supported/implemented in the current release.
+   Some *experimental/debug/advanced* parameters are only visible with "Advanced Attributes" enabled.
+   To enable "Advanced Attributes", click on the three vertical dots in the upper right corner of the node settings and activate the check box. Some features, settings and nodes are only available in the latest build or developer version.
+
+   
+ 
 
 .. toctree::
    :maxdepth: 1
    :hidden:
    :caption: Node Reference
 
    nodes/CameraCalibration
+   nodes/CameraDownscale
    nodes/CameraInit
    nodes/CameraLocalization
    nodes/CameraRigCalibration
@@ -22,9 +27,12 @@ List with all the nodes
    nodes/DepthMapFilter
    nodes/ExportAnimatedCamera
    nodes/ExportColoredPointCloud
+   nodes/ExportMatches
    nodes/ExportMaya
    nodes/FeatureExtraction
    nodes/FeatureMatching
+   nodes/GlobalSfM
+   nodes/HDRIstitching
    nodes/ImageMatching
    nodes/ImageMatchingMultiSfM
    nodes/KeyframeSelection
@@ -34,10 +42,16 @@ List with all the nodes
    nodes/MeshFiltering
    nodes/MeshResampling
    nodes/Meshing
+   nodes/PanoramaCompositing
+   nodes/PanoramaEstimation
+   nodes/PanoramaExternalInfo
+   nodes/PanoramaWarping
    nodes/PrepareDenseScene
    nodes/Publish
-   nodes/SfMAlingnment
+   nodes/SfMAlignment
+   nodes/SfMTransfer
    nodes/SfMTransform
+   nodes/SketchfabUpload
    nodes/StructureFromMotion
    nodes/Texturing
 

source/node-reference/connect-nodes/panorama-node-graph.JPG

@@ -4,7 +4,10 @@ CameraCalibration
 **Description**
 
 .. Note:: 
-   This node requires AliceVision compiled with OpenCV.
+   At the moment this node can not directly be connected to the SfM pipeline in the UI. That would be obviously a nice feature to have.   
+   The camera models and parameters can be manually copied to the CameraInit settings.
+   This node just needs a bit more work before using it directly into the Meshroom graph. If someone is interested to contribute to this
+   feature, we would be glad to provide assistance.
 
 The internal camera parameters can be calibrated from multiple views of a checkerboard. This allows to retrieve focal length, principal point and distortion parameters. A detailed explanation is presented in [opencvCameraCalibration].
 
@@ -14,16 +17,32 @@ The internal camera parameters can be calibrated from multiple views of a checke
 Name                      Description
 ========================= =============================================================================================================================
 Input                     Input images in one of the following form: - folder containing images - image sequence like "/path/to/[email protected]" - video file
-Pattern                   Type of pattern (camera calibration patterns) - **CHESSBOARD** - CIRCLES - ASYMMETRIC\ *CIRCLES - ASYMMETRIC*\ CCTAG
+Pattern                   Type of pattern (camera calibration patterns) - **CHESSBOARD** - CIRCLES - ASYMMETRIC CIRCLES - ASYMMETRIC CCTAG
 Size                      (Size of the Pattern) - Number of inner corners per one of board dimension like Width (**7**) Height (**5**) (0-10000)
 Square Size               Size of the grid's square cells (0-100mm) (**1**)
 Nb Distortion Coef        Number of distortion coefficient (0-5) (**3**)
 Max Frames                Maximal number of frames to extract from the video file (0-5) (**0**)
-Calib Grid Size           Define the number of cells per edge (0-50)
 Max Calib Frames          Maximal number of frames to use to calibrate from the selected frames (0-1000)
+Calib Grid Size           Define the number of cells per edge (0-50)
 Min Input Frames          Minimal number of frames to limit the refinement loop (0-100)
 Max Total Average Error   Max Total Average Error (0-1)
 Debug Rejected Img Folder Folder to export delete images during the refinement loop
 Debug Selected Img Folder Folder to export debug images
 Output                    Output filename for intrinsic [and extrinsic] parameters (default filename cameraCalibration.cal)
 ========================= =============================================================================================================================
+
+**Details**
+
+**Patterns**
+
+CHESSBOARD https://github.com/artoolkit/artoolkit5/blob/master/doc/patterns/Calibration%20chessboard%20(A4).pdf 
+
+Chessboard calibration video sample https://vimeo.com/141414129
+
+CIRCLES
+
+ASYMMETRIC_CIRCLES https://nerian.com/support/resources/patterns/
+
+ASYMMETRIC_CCTAG https://github.com/alicevision/CCTag
+
+A list with other camera calibration tools and patterns can be found here https://github.com/natowi/CameraCalibTools