<commit_before>
********************************************
openMVG_main_ComputeStructureFromKnownPoses
********************************************

This application compute corresponding features and robustly triangulate them according the geometry of the known camera intrinsics & poses.

Algorithm of the application

.. code-block:: c++

  Require: internal + external camera calibration
  Require: image description regions (features + descriptors)
  Ensure: 3D point cloud
  compute image visibility
    list all the pair that share common visual content
      - camera frustum based
      - or structure visbility (SfM tracks) based
  list triplets of view from pairs
   for each triplets compute 3 view tracks
     if tracks triangulable add correspondences to p
  link 3 views validated matches (p) as tracks
    robustly triangulate them

Information and usage
========================

The chain is designed to run on a sfm_data.json file and some pre-computed matches.
The sfm_data file should contains:
- valid view with some defined intrinsics and camera poses,
- (optional existing structure).

  .. code-block:: c++
  
    $ openMVG_main_ComputeStructureFromKnownPoses -i Dataset/out_Reconstruction/sfm_data.json -o Dataset/out_Reconstruction/robustFitting.json

Arguments description:

**Required parameters:**

  - **[-i|--input_file]**

    - a SfM_Data file with valid intrinsics and poses and optional structure

  - **[-m|--matchdir]**

    - path were image descriptions were stored

  - **[-o|--outdir]**

    - path where the updated scene data will be stored

**Optional parameters:**

  - **[-f|--match_file]**

    - path to a matches file (pairs of the match files will be listed and used)

  - **[-p|--pair_file]**

    - path to a pairs file (only those pairs will be considered to compute the structure)
      The pair file is a list of view indexes, one pair on each line

  - **[-b|--bundle_adjustment]**

    - perform a bundle adjustment on the scene (OFF by default)

  - **[-r|--residual_threshold]**

    - maximal pixels reprojection error that will be considered for triangulations (4.0 by default)


<commit_msg>[doc] Update ComputeStructureFromKnownPoses.rst (#1587)<commit_after>
********************************************
openMVG_main_ComputeStructureFromKnownPoses
********************************************

This application computes corresponding features and robustly triangulates them according to the geometry of the known camera intrinsics & poses.

Algorithm of the application

.. code-block:: c++

  Require: internal + external camera calibration
  Require: image description regions (features + descriptors)
  Ensure: 3D point cloud
  compute image visibility
    list all the pair that share common visual content
      - camera frustum based
      - or structure visbility (SfM tracks) based
  list triplets of view from pairs
   for each triplets compute 3 view tracks
     if tracks triangulable add correspondences to p
  link 3 views validated matches (p) as tracks
    robustly triangulate them

Information and usage
========================

The chain is designed to run on a sfm_data.json file and some pre-computed matches.
The sfm_data file should contain:
- valid view with some defined intrinsics and camera poses,
- (optional existing structure).

  .. code-block:: c++
  
    $ openMVG_main_ComputeStructureFromKnownPoses -i Dataset/out_Reconstruction/sfm_data.json -o Dataset/out_Reconstruction/robustFitting.json

Argument descriptions:

**Required parameters:**

  - **[-i|--input_file]**

    - a SfM_Data file with valid intrinsics and poses and optional structure

  - **[-m|--matchdir]**

    - path were image descriptions were stored

  - **[-o|--outdir]**

    - path where the updated scene data will be stored

**Optional parameters:**

  - **[-f|--match_file]**

    - path to a matches file (pairs of the match files will be listed and used)

  - **[-p|--pair_file]**

    - path to a pairs file (only those pairs will be considered to compute the structure)
      The pair file is a list of view indexes, one pair on each line

  - **[-b|--bundle_adjustment]**

    - perform a bundle adjustment on the scene (OFF by default)

  - **[-r|--residual_threshold]**

    - maximal pixels reprojection error that will be considered for triangulations (4.0 by default)



{'fraction_non_alphanumeric': 0.12436897659476824, 'fraction_numerical': 0.0032124827902707664, 'mean_word_length': 3.8219026548672566, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 3, 'https://': 0, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '4152992', 'n_tokens_mistral': 1216, 'n_tokens_neox': 1127, 'n_words': 484}