cars 1.0.0a3__cp313-cp313-win_amd64.whl → 1.0.0a4__cp313-cp313-win_amd64.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.


This version of cars might be problematic. Click here for more details.

Files changed (139) hide show
  1. cars/__init__.py +3 -3
  2. cars/applications/__init__.py +0 -3
  3. cars/applications/application_template.py +20 -0
  4. cars/applications/auxiliary_filling/abstract_auxiliary_filling_app.py +12 -2
  5. cars/applications/auxiliary_filling/auxiliary_filling_algo.py +2 -2
  6. cars/applications/auxiliary_filling/auxiliary_filling_from_sensors_app.py +80 -36
  7. cars/applications/dem_generation/dem_generation_algo.py +1 -1
  8. cars/applications/dem_generation/dem_generation_wrappers.py +23 -57
  9. cars/applications/dem_generation/dichotomic_generation_app.py +3 -3
  10. cars/applications/dem_generation/rasterization_app.py +100 -41
  11. cars/applications/dense_match_filling/__init__.py +1 -1
  12. cars/applications/dense_match_filling/abstract_dense_match_filling_app.py +2 -15
  13. cars/applications/dense_match_filling/fill_disp_algo.py +32 -373
  14. cars/applications/dense_match_filling/fill_disp_wrappers.py +0 -343
  15. cars/applications/dense_match_filling/zero_padding_app.py +10 -5
  16. cars/applications/dense_matching/abstract_dense_matching_app.py +2 -1
  17. cars/applications/dense_matching/census_mccnn_sgm_app.py +38 -39
  18. cars/applications/dense_matching/cpp/dense_matching_cpp.cp313-win_amd64.dll.a +0 -0
  19. cars/applications/dense_matching/cpp/dense_matching_cpp.cp313-win_amd64.pyd +0 -0
  20. cars/applications/dense_matching/dense_matching_algo.py +48 -14
  21. cars/applications/dense_matching/dense_matching_wrappers.py +11 -3
  22. cars/applications/dense_matching/disparity_grid_algo.py +84 -62
  23. cars/applications/dense_matching/loaders/pandora_loader.py +91 -33
  24. cars/applications/dsm_filling/border_interpolation_app.py +1 -7
  25. cars/applications/dsm_filling/bulldozer_filling_app.py +2 -8
  26. cars/applications/dsm_filling/exogenous_filling_app.py +4 -9
  27. cars/applications/grid_generation/abstract_grid_generation_app.py +1 -1
  28. cars/applications/grid_generation/epipolar_grid_generation_app.py +4 -2
  29. cars/applications/grid_generation/grid_correction_app.py +4 -1
  30. cars/applications/grid_generation/grid_generation_algo.py +7 -2
  31. cars/applications/ground_truth_reprojection/abstract_ground_truth_reprojection_app.py +1 -1
  32. cars/applications/ground_truth_reprojection/direct_localization_app.py +2 -2
  33. cars/applications/ground_truth_reprojection/ground_truth_reprojection_algo.py +2 -1
  34. cars/applications/point_cloud_fusion/abstract_pc_fusion_app.py +0 -155
  35. cars/applications/point_cloud_fusion/mapping_to_terrain_tiles_app.py +0 -658
  36. cars/applications/point_cloud_fusion/pc_fusion_algo.py +0 -1339
  37. cars/applications/point_cloud_fusion/pc_fusion_wrappers.py +0 -869
  38. cars/applications/point_cloud_outlier_removal/abstract_outlier_removal_app.py +2 -1
  39. cars/applications/point_cloud_outlier_removal/outlier_removal_algo.py +9 -8
  40. cars/applications/point_cloud_outlier_removal/small_components_app.py +96 -267
  41. cars/applications/point_cloud_outlier_removal/statistical_app.py +116 -275
  42. cars/applications/rasterization/abstract_pc_rasterization_app.py +1 -1
  43. cars/applications/rasterization/rasterization_algo.py +18 -6
  44. cars/applications/rasterization/rasterization_wrappers.py +2 -1
  45. cars/applications/rasterization/simple_gaussian_app.py +60 -113
  46. cars/applications/resampling/abstract_resampling_app.py +1 -1
  47. cars/applications/resampling/bicubic_resampling_app.py +3 -1
  48. cars/applications/resampling/resampling_algo.py +16 -4
  49. cars/applications/resampling/resampling_wrappers.py +3 -1
  50. cars/applications/sparse_matching/abstract_sparse_matching_app.py +1 -1
  51. cars/applications/sparse_matching/sift_app.py +3 -3
  52. cars/applications/sparse_matching/sparse_matching_algo.py +3 -2
  53. cars/applications/sparse_matching/sparse_matching_wrappers.py +1 -1
  54. cars/applications/triangulation/abstract_triangulation_app.py +1 -1
  55. cars/applications/triangulation/line_of_sight_intersection_app.py +13 -11
  56. cars/applications/triangulation/pc_transform.py +552 -0
  57. cars/applications/triangulation/triangulation_algo.py +6 -4
  58. cars/applications/triangulation/triangulation_wrappers.py +1 -0
  59. cars/bundleadjustment.py +6 -6
  60. cars/cars.py +11 -9
  61. cars/core/cars_logging.py +80 -49
  62. cars/core/constants.py +0 -1
  63. cars/core/datasets.py +5 -2
  64. cars/core/geometry/abstract_geometry.py +256 -25
  65. cars/core/geometry/shareloc_geometry.py +110 -82
  66. cars/core/inputs.py +57 -19
  67. cars/core/outputs.py +1 -1
  68. cars/core/preprocessing.py +17 -3
  69. cars/core/projection.py +9 -6
  70. cars/core/tiling.py +10 -3
  71. cars/data_structures/cars_dataset.py +5 -5
  72. cars/data_structures/corresponding_tiles_tools.py +0 -103
  73. cars/data_structures/format_transformation.py +4 -1
  74. cars/devibrate.py +6 -3
  75. cars/extractroi.py +20 -21
  76. cars/orchestrator/cluster/abstract_cluster.py +15 -5
  77. cars/orchestrator/cluster/abstract_dask_cluster.py +6 -2
  78. cars/orchestrator/cluster/dask_jobqueue_utils.py +1 -1
  79. cars/orchestrator/cluster/log_wrapper.py +148 -21
  80. cars/orchestrator/cluster/mp_cluster/multiprocessing_cluster.py +11 -3
  81. cars/orchestrator/cluster/mp_cluster/multiprocessing_profiler.py +2 -2
  82. cars/orchestrator/cluster/pbs_dask_cluster.py +1 -1
  83. cars/orchestrator/cluster/sequential_cluster.py +5 -4
  84. cars/orchestrator/cluster/slurm_dask_cluster.py +1 -1
  85. cars/orchestrator/orchestrator.py +14 -3
  86. cars/orchestrator/registry/id_generator.py +1 -0
  87. cars/orchestrator/registry/saver_registry.py +2 -2
  88. cars/pipelines/conf_resolution/conf_final_resolution.json +5 -3
  89. cars/pipelines/default/default_pipeline.py +462 -1073
  90. cars/pipelines/parameters/advanced_parameters.py +74 -64
  91. cars/pipelines/parameters/advanced_parameters_constants.py +2 -5
  92. cars/pipelines/parameters/application_parameters.py +71 -0
  93. cars/pipelines/parameters/depth_map_inputs.py +0 -314
  94. cars/pipelines/parameters/dsm_inputs.py +40 -4
  95. cars/pipelines/parameters/output_parameters.py +2 -2
  96. cars/pipelines/parameters/sensor_inputs.py +30 -75
  97. cars/pipelines/parameters/sensor_inputs_constants.py +0 -2
  98. cars/pipelines/parameters/sensor_loaders/__init__.py +4 -3
  99. cars/pipelines/parameters/sensor_loaders/basic_classif_loader.py +106 -0
  100. cars/pipelines/parameters/sensor_loaders/{basic_sensor_loader.py → basic_image_loader.py} +16 -22
  101. cars/pipelines/parameters/sensor_loaders/pivot_classif_loader.py +121 -0
  102. cars/pipelines/parameters/sensor_loaders/{pivot_sensor_loader.py → pivot_image_loader.py} +10 -21
  103. cars/pipelines/parameters/sensor_loaders/sensor_loader.py +4 -6
  104. cars/pipelines/parameters/sensor_loaders/sensor_loader_template.py +1 -3
  105. cars/pipelines/pipeline_template.py +1 -3
  106. cars/pipelines/unit/unit_pipeline.py +527 -1016
  107. cars/starter.py +4 -3
  108. cars-1.0.0a4.dist-info/DELVEWHEEL +2 -0
  109. {cars-1.0.0a3.dist-info → cars-1.0.0a4.dist-info}/METADATA +135 -53
  110. {cars-1.0.0a3.dist-info → cars-1.0.0a4.dist-info}/RECORD +115 -131
  111. cars.libs/libgcc_s_seh-1-b2494fcbd4d80cf2c98fdd5261f6d850.dll +0 -0
  112. cars.libs/libstdc++-6-e9b0d12ae0e9555bbae55e8dfd08c3f7.dll +0 -0
  113. cars.libs/libwinpthread-1-7882d1b093714ccdfaf4e0789a817792.dll +0 -0
  114. cars/applications/dense_match_filling/cpp/__init__.py +0 -0
  115. cars/applications/dense_match_filling/cpp/dense_match_filling_cpp.cp313-win_amd64.dll.a +0 -0
  116. cars/applications/dense_match_filling/cpp/dense_match_filling_cpp.cp313-win_amd64.pyd +0 -0
  117. cars/applications/dense_match_filling/cpp/dense_match_filling_cpp.py +0 -72
  118. cars/applications/dense_match_filling/cpp/includes/dense_match_filling.hpp +0 -46
  119. cars/applications/dense_match_filling/cpp/meson.build +0 -9
  120. cars/applications/dense_match_filling/cpp/src/bindings.cpp +0 -11
  121. cars/applications/dense_match_filling/cpp/src/dense_match_filling.cpp +0 -142
  122. cars/applications/dense_match_filling/plane_app.py +0 -556
  123. cars/applications/hole_detection/__init__.py +0 -30
  124. cars/applications/hole_detection/abstract_hole_detection_app.py +0 -125
  125. cars/applications/hole_detection/cloud_to_bbox_app.py +0 -346
  126. cars/applications/hole_detection/hole_detection_algo.py +0 -144
  127. cars/applications/hole_detection/hole_detection_wrappers.py +0 -53
  128. cars/applications/point_cloud_denoising/__init__.py +0 -29
  129. cars/applications/point_cloud_denoising/abstract_pc_denoising_app.py +0 -273
  130. cars/applications/point_cloud_fusion/__init__.py +0 -30
  131. cars/applications/point_cloud_fusion/cloud_fusion_constants.py +0 -39
  132. cars/applications/sparse_matching/pandora_sparse_matching_app.py +0 -0
  133. cars/pipelines/parameters/depth_map_inputs_constants.py +0 -25
  134. cars-1.0.0a3.dist-info/DELVEWHEEL +0 -2
  135. cars.libs/libgcc_s_seh-1-ca70890bbc5723b6d0ea31e9c9cded2b.dll +0 -0
  136. cars.libs/libstdc++-6-00ee19f73d5122a1277c137b1c218401.dll +0 -0
  137. cars.libs/libwinpthread-1-f5042e8e3d21edce20c1bc99445f551b.dll +0 -0
  138. {cars-1.0.0a3.dist-info → cars-1.0.0a4.dist-info}/WHEEL +0 -0
  139. {cars-1.0.0a3.dist-info → cars-1.0.0a4.dist-info}/entry_points.txt +0 -0
cars/starter.py CHANGED
@@ -44,17 +44,18 @@ def inputfilename_to_sensor(inputfilename):
44
44
  if basename.startswith("DIM") and basename.endswith("XML"):
45
45
  geomodel = os.path.join(dirname, "RPC" + basename[3:])
46
46
  if os.path.exists(geomodel) is False:
47
- raise FileNotFoundError(geomodel + " does not exist")
47
+ geomodel = None
48
48
 
49
49
  elif basename.endswith(".tif"):
50
50
  geomodel = os.path.splitext(absfilename)[0] + ".geom"
51
51
  if os.path.exists(geomodel) is False:
52
- raise FileNotFoundError(geomodel + " does not exist")
52
+ geomodel = None
53
53
  else:
54
54
  raise ValueError(absfilename + " not supported")
55
55
 
56
56
  sensor["image"] = absfilename
57
- sensor["geomodel"] = geomodel
57
+ if geomodel is not None:
58
+ sensor["geomodel"] = geomodel
58
59
 
59
60
  return sensor
60
61
 
@@ -0,0 +1,2 @@
1
+ Version: 1.11.2
2
+ Arguments: ['C:\\Users\\runneradmin\\AppData\\Local\\Temp\\cibw-run-2hzkxr3d\\cp313-win_amd64\\build\\venv\\Scripts\\delvewheel', 'repair', '-w', 'C:\\Users\\runneradmin\\AppData\\Local\\Temp\\cibw-run-2hzkxr3d\\cp313-win_amd64\\repaired_wheel', 'C:\\Users\\runneradmin\\AppData\\Local\\Temp\\cibw-run-2hzkxr3d\\cp313-win_amd64\\built_wheel\\cars-1.0.0a4-cp313-cp313-win_amd64.whl']
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.1
2
2
  Name: cars
3
- Version: 1.0.0a3
3
+ Version: 1.0.0a4
4
4
  Summary: A satellite multi view stereo pipeline
5
5
  Keywords: cars,3D,DEM,pandora,photogrammetry
6
6
  Author-Email: CNES <cars@cnes.fr>
@@ -39,18 +39,19 @@ Requires-Dist: urllib3<2.0,>=1.21.1
39
39
  Requires-Dist: laspy[laszip]
40
40
  Requires-Dist: tbb==2020.3.254
41
41
  Requires-Dist: numba
42
- Requires-Dist: pandora[sgm]==1.7.1a1
42
+ Requires-Dist: pandora[sgm]==1.7.1
43
43
  Requires-Dist: cars-rasterize==0.2.*
44
44
  Requires-Dist: cars-resample==0.1.*
45
45
  Requires-Dist: cars-filter==0.2.*
46
46
  Requires-Dist: vlsift==0.1.*
47
- Requires-Dist: shareloc==0.2.9
47
+ Requires-Dist: shareloc==0.2.10
48
48
  Requires-Dist: bulldozer-dtm==1.1.*
49
49
  Requires-Dist: xdem==0.1.*
50
50
  Requires-Dist: geopandas<=1.0.1
51
51
  Provides-Extra: dev
52
52
  Requires-Dist: pytest; extra == "dev"
53
53
  Requires-Dist: pytest-cov; extra == "dev"
54
+ Requires-Dist: pytest-check; extra == "dev"
54
55
  Requires-Dist: pre-commit; extra == "dev"
55
56
  Requires-Dist: isort>=5.8.0; extra == "dev"
56
57
  Requires-Dist: black>=24.1a1; extra == "dev"
@@ -59,7 +60,7 @@ Requires-Dist: flake8-pyproject; extra == "dev"
59
60
  Requires-Dist: flake8-comprehensions>=3.4.0; extra == "dev"
60
61
  Requires-Dist: flake8-bugbear<24.0.0,>=21.4.3; extra == "dev"
61
62
  Requires-Dist: jupyter_contrib_nbextensions; extra == "dev"
62
- Requires-Dist: pylint<3.0.0,>=2.8.12; extra == "dev"
63
+ Requires-Dist: pylint<4.0.0,>=2.8.12; extra == "dev"
63
64
  Requires-Dist: setuptools_scm; extra == "dev"
64
65
  Requires-Dist: virtualenv; extra == "dev"
65
66
  Requires-Dist: configupdater; extra == "dev"
@@ -75,12 +76,12 @@ Requires-Dist: dash; extra == "dev"
75
76
  Requires-Dist: plotly; extra == "dev"
76
77
  Requires-Dist: build; extra == "dev"
77
78
  Provides-Extra: docs
78
- Requires-Dist: astroid<3.0.0; extra == "docs"
79
+ Requires-Dist: astroid<4.0.0; extra == "docs"
79
80
  Requires-Dist: sphinx; extra == "docs"
80
81
  Requires-Dist: sphinx-rtd-theme; extra == "docs"
81
82
  Requires-Dist: sphinx_autoapi; extra == "docs"
82
83
  Requires-Dist: graphviz; extra == "docs"
83
- Requires-Dist: sphinx_tabs==3.4.0; extra == "docs"
84
+ Requires-Dist: sphinx_tabs; extra == "docs"
84
85
  Requires-Dist: sphinx-copybutton; extra == "docs"
85
86
  Provides-Extra: notebook
86
87
  Requires-Dist: notebook; extra == "notebook"
@@ -95,115 +96,196 @@ Description-Content-Type: text/markdown
95
96
  <div align="center">
96
97
  <a target="_blank" href="https://github.com/CNES/cars">
97
98
  <picture>
98
- <source
99
- srcset="https://raw.githubusercontent.com/CNES/cars/master/docs/source/images/picto_dark.png"
100
- media="(prefers-color-scheme: dark)"
101
- />
102
99
  <img
103
- src="https://raw.githubusercontent.com/CNES/cars/master/docs/source/images/picto_light.png"
100
+ src="https://raw.githubusercontent.com/CNES/cars/master/docs/source/images/cars_picto.svg"
104
101
  alt="CARS"
105
- width="40%"
102
+ width="50%"
106
103
  />
107
104
  </picture>
108
105
  </a>
109
106
 
110
107
  <h4>CARS, a satellite multi view stereo framework </h4>
111
108
 
112
- [![Python](https://img.shields.io/badge/python-v3.9+-blue.svg)](https://www.python.org/downloads/release/python-390/)
109
+ [![Python](https://img.shields.io/badge/python-v3.10+-blue.svg)](https://www.python.org/downloads/release/python-390/)
113
110
  [![Contributions welcome](https://img.shields.io/badge/contributions-welcome-orange.svg)](CONTRIBUTING.md)
114
111
  [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0/)
115
112
  [![Documentation](https://readthedocs.org/projects/cars/badge/?version=latest)](https://cars.readthedocs.io/?badge=latest)
116
113
  [![Github Action](https://github.com/CNES/cars/actions/workflows/cars-ci.yml/badge.svg?branch=master)](https://github.com/CNES/cars/actions)
114
+ [![pypi](https://badge.fury.io/py/cars.svg)](https://pypi.org/project/cars/)
115
+ [![Docker pulls](https://img.shields.io/badge/dynamic/json?formatter=metric&color=blue&label=Docker%20pull&query=%24.pull_count&url=https://hub.docker.com/v2/repositories/cnes/cars)](https://hub.docker.com/r/cnes/cars)
117
116
 
118
117
  <p>
119
118
  <a href="#overview">Overview</a> •
120
119
  <a href="#quick-start">Quick Start</a> •
121
120
  <a href="#documentation">Documentation</a> •
121
+ <a href="#license">License</a> •
122
122
  <a href="#contribution">Contribution</a> •
123
+ <a href="#help">Help</a> •
124
+ <a href="#credits">Credits</a> •
125
+ <a href="#contact">Contact</a> •
123
126
  <a href="#references">References</a>
124
127
  </p>
125
128
  </div>
126
129
 
127
- ## Overview
128
-
129
- From stereo images | CARS produces a Digital Surface Model (DSM)
130
- :-------------------------:|:-------------------------:
131
- <img src="https://raw.githubusercontent.com/CNES/cars/master/docs/source/images/animation_sat.gif" alt="drawing" width="100%"/> | <img src="https://raw.githubusercontent.com/CNES/cars/master/docs/source/images/overview_dsm_3d.gif" alt="drawing" width="100%"/>
130
+ # 🌐 **Overview**
132
131
 
132
+ <div align="center">
133
+ <table style="display: inline-block;">
134
+ <tr>
135
+ <td align="center">
136
+ <div style="font-size:2em; margin-bottom:10px;"><strong>🎞️ From Stereo Images</strong></div><br>
137
+ <img src="https://raw.githubusercontent.com/CNES/cars/master/docs/source/images/animation_sat.gif"
138
+ alt="Stereo images animation" width="95%"><br>
139
+ <em>Input stereo image pairs</em>
140
+ </td>
141
+ <td align="center">
142
+ <div style="font-size:2em; margin-bottom:10px;"><strong>🌍 To Digital Surface Model (DSM)</strong></div><br>
143
+ <img src="https://raw.githubusercontent.com/CNES/cars/master/docs/source/images/overview_dsm_3d.gif"
144
+ alt="DSM overview" width="95%"><br>
145
+ <em>Output 3D surface reconstruction</em>
146
+ </td>
147
+ </tr>
148
+ </table>
149
+ </div>
133
150
 
134
151
  **CARS** is an open source 3D tool dedicated to produce **Digital Surface Models** from satellite imaging by photogrammetry.
135
152
  This Multiview Stereo framework is intended for massive DSM production with a robust, performant and modular design.
136
153
 
137
154
  **CARS** is currently under active development and integrated into various projects & missions:
138
155
 
139
- - <a href="https://co3d.cnes.fr/en/co3d-0">CO3D project &nbsp;&nbsp;&nbsp; <img src="https://raw.githubusercontent.com/CNES/cars/master/docs/source/images/logo_co3D_cnes.jpg" height="20"/></a>
140
- - <a href="https://www.ai4geo.eu">AI4GEO project &nbsp;&nbsp;&nbsp; <img src="https://raw.githubusercontent.com/CNES/cars/master/docs/source/images/logo-ai4geo.png" height="20"/> </a>
141
- - <a href="https://www.evo-land.eu">Evoland project &nbsp;&nbsp;&nbsp; <img src="https://raw.githubusercontent.com/CNES/cars/master/docs/source/images/logo-evoland.png" height="20"/> </a>
156
+ <div align="center">
157
+ <p align="center">
158
+ <a href="https://co3d.cnes.fr/en/co3d-0" target="_blank">
159
+ <img src="https://raw.githubusercontent.com/CNES/cars/master/docs/source/images/logo_co3D_cnes.png"
160
+ alt="CO3D project" height="70">
161
+ </a>
162
+ &nbsp;&nbsp;&nbsp;&nbsp;
163
+ <a href="https://www.ai4geo.eu" target="_blank">
164
+ <img src="https://raw.githubusercontent.com/CNES/cars/master/docs/source/images/logo-ai4geo.png"
165
+ alt="AI4GEO project" height="75">
166
+ </a>
167
+ &nbsp;&nbsp;&nbsp;&nbsp;
168
+ <a href="https://www.evo-land.eu" target="_blank">
169
+ <img src="https://raw.githubusercontent.com/CNES/cars/master/docs/source/images/logo-evoland.png"
170
+ alt="Evoland project" height="60">
171
+ </a>
172
+ </p>
173
+ </div>
174
+
175
+ <br>
142
176
 
143
177
  Its roadmap and implemented functionalities are evolving regularly depending on specific project requirements.
144
178
 
145
- ## Quick start
179
+ # 🚀 **Quick start**
180
+
181
+
182
+ ### △ On the way to the Pyramids...
183
+ ---
184
+
185
+ You want to build the pyramids by yourself?
186
+
187
+
188
+ <div align="center">
189
+ <table style="display: inline-block;">
190
+ <tr>
191
+ <td align="center">
192
+ <img src="https://raw.githubusercontent.com/CNES/cars/master/docs/source/images/dsm.png"
193
+ alt="Dsm" width="400"><br>
194
+ </td>
195
+ <td align="center">
196
+ <img src="https://raw.githubusercontent.com/CNES/cars/master/docs/source/images/clr.png"
197
+ alt="Color" width="400"><br>
198
+ </td>
199
+ <td align="center">
200
+ <img src="https://raw.githubusercontent.com/CNES/cars/master/docs/source/images/dsm_clr.png"
201
+ alt="Color" width="400"><br>
202
+ </td>
203
+ </tr>
204
+ </table>
205
+ </div>
206
+
207
+ Download our [open licence](https://www.etalab.gouv.fr/licence-ouverte-open-licence) Pleiades [data sample](https://raw.githubusercontent.com/CNES/cars/master/tutorials/data_gizeh.tar.bz2) to give CARS a try!
208
+
146
209
 
147
- ### CARS Docker Image
210
+ ### 🐋 with Docker
211
+ ---
148
212
 
149
- [![Docker Status](http://dockeri.co/image/cnes/cars)](https://hub.docker.com/r/cnes/cars)
213
+ #### 🛠 Installation
150
214
 
151
215
  CARS is available on Docker Hub and can be downloaded by:
152
216
  ``` bash
153
217
  docker pull cnes/cars
154
218
  ```
155
219
 
156
- ### One main pipeline to generate DSM
220
+ #### Run CARS
157
221
 
158
222
  You only need to launch one command:
159
223
 
160
224
  ```
161
- docker run -w /data -v "$(pwd)"/data_gizeh:/data cnes/cars /data/configfile.json
225
+ docker run -w /data -v "$(pwd)"/data_gizeh:/data cnes/cars /data/configfile.yaml
162
226
  ```
163
227
 
164
- with one configuration input file ("configfile.json") located in a "data" folder to be consistent with the previous command lines:
165
- ```
166
- {
167
- "inputs": {
168
- "sensors" : {
169
- "one": {
170
- "image": "img1.tif",
171
- "geomodel": "img1.geom"
172
- },
173
- "two": {
174
- "image": "img2.tif",
175
- "geomodel": "img2.geom"
176
- }
177
- }
178
- },
179
- "output": {
180
- "directory": "outresults"
181
- }
182
- }
228
+ ### 🐍 with pip
229
+ ---
230
+
231
+ #### 🛠 Installation
183
232
 
233
+ CARS can also be downloaded using the pip install command:
234
+
235
+ ``` bash
236
+ pip install cars
184
237
  ```
185
238
 
186
- ### On the way to the Pyramids...
239
+ #### Run CARS
240
+
241
+ Once you moved to the data_gizeh directory:
187
242
 
188
- You want to build the pyramids by yourself? Download our [open licence](https://www.etalab.gouv.fr/licence-ouverte-open-licence) Pleiades [data sample](https://raw.githubusercontent.com/CNES/cars/master/tutorials/data_gizeh.tar.bz2) to give CARS a try!
243
+ ``` bash
244
+ cars configfile.yaml
245
+ ```
189
246
 
190
- ## Documentation
247
+ # 📚 **Documentation**
191
248
 
192
249
  Go to [CARS Main Documentation](https://cars.readthedocs.io/?badge=latest).
193
250
 
251
+ # 📜 **License**
252
+
253
+ CARS is licensed under [Apache License v2.0](https://www.apache.org/licenses/LICENSE-2.0). Please refer to the [LICENSE](https://gitlab.cnes.fr/dali/cars-park/cars/-/blob/1214-mise-a-jour-du-readme-pour-la-nouvelle-version-1-0-0/LICENSE) file for more details.
194
254
 
195
- ## Contribution
255
+ # 🤝 **Contribution**
196
256
 
197
- To do a bug report or a contribution, see the [**Contribution Guide**](https://github.com/CNES/cars/blob/master/CONTRIBUTING.md).
257
+ To do a contribution, see the [Contribution Guide](https://github.com/CNES/cars/blob/master/CONTRIBUTING.md). For project evolution, see [Changelog](https://github.com/CNES/cars/blob/master/CHANGELOG.md).
198
258
 
199
- For project evolution, see [**Changelog**](https://github.com/CNES/cars/blob/master/CHANGELOG.md).
259
+ # 🆘 **Help**
200
260
 
201
- ## Credits
261
+ For issues, questions, or feature requests, please open an issue on our [GitHub Issues](https://github.com/CNES/cars/issues) page or check the [documentation](https://cars.readthedocs.io/en/stable/index.html) for additional resources.
262
+
263
+ You can also ask your questions on the corresponding [slack](https://join.slack.com/t/cars-community/shared_invite/zt-2uw6usog1-~TT~m8BxO9faMXpP7tpz2Q).
264
+
265
+ # ✒️ **Credits**
266
+
267
+ If you use CARS in your research, please cite the following paper:
268
+
269
+ ```
270
+ @INPROCEEDINGS{9324020,
271
+ author={Youssefi, David and Michel, Julien and Sarrazin, Emmanuelle and Buffe, Fabrice and Cournet, Myriam and Delvit, Jean-Marc and L'Helguen, Céline and Melet, Olivier and Emilien, Aurélie and Bosman, Julien},
272
+ booktitle={IGARSS 2020 - 2020 IEEE International Geoscience and Remote Sensing Symposium},
273
+ title={CARS: A Photogrammetry Pipeline Using Dask Graphs to Construct A Global 3D Model},
274
+ year={2020},
275
+ volume={},
276
+ number={},
277
+ pages={453-456},
278
+ keywords={Automobiles;Geometry;Three-dimensional displays;Computational modeling;Estimation;Stereo image processing;Task analysis;Image processing;Photogrammetry;Stereovision;Digital Surface Model;High Performance Computing;Cloud Computing;Dask},
279
+ doi={10.1109/IGARSS39084.2020.9324020}}
280
+ ```
202
281
 
203
282
  See [Authors file](https://github.com/CNES/cars/blob/master/AUTHORS.md)
204
283
 
284
+ # ✉️ **Contact**
285
+
286
+ You can contact us on the following mail adress: cars@cnes.fr
205
287
 
206
- ## References
288
+ # 🔗 **References**
207
289
 
208
290
  - [Youssefi D., Michel, J., Sarrazin, E., Buffe, F., Cournet, M., Delvit, J., L’Helguen, C., Melet, O., Emilien, A., Bosman, J., 2020. Cars: A photogrammetry pipeline using dask graphs to construct a global 3d model. IGARSS - IEEE International Geoscience and Remote Sensing Symposium.](https://ieeexplore.ieee.org/document/9324020)
209
291
  - [Michel, J., Sarrazin, E., Youssefi, D., Cournet, M., Buffe, F., Delvit, J., Emilien, A., Bosman, J., Melet, O., L’Helguen, C., 2020. A new satellite imagery stereo pipeline designed for scalability, robustness and performance. ISPRS - International Archives of the Photogrammetry, Remote Sensing and Spatial Information Sciences.](https://www.isprs-ann-photogramm-remote-sens-spatial-inf-sci.net/V-2-2020/171/2020/)