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.
- cars/__init__.py +3 -3
- cars/applications/__init__.py +0 -3
- cars/applications/application_template.py +20 -0
- cars/applications/auxiliary_filling/abstract_auxiliary_filling_app.py +12 -2
- cars/applications/auxiliary_filling/auxiliary_filling_algo.py +2 -2
- cars/applications/auxiliary_filling/auxiliary_filling_from_sensors_app.py +80 -36
- cars/applications/dem_generation/dem_generation_algo.py +1 -1
- cars/applications/dem_generation/dem_generation_wrappers.py +23 -57
- cars/applications/dem_generation/dichotomic_generation_app.py +3 -3
- cars/applications/dem_generation/rasterization_app.py +100 -41
- cars/applications/dense_match_filling/__init__.py +1 -1
- cars/applications/dense_match_filling/abstract_dense_match_filling_app.py +2 -15
- cars/applications/dense_match_filling/fill_disp_algo.py +32 -373
- cars/applications/dense_match_filling/fill_disp_wrappers.py +0 -343
- cars/applications/dense_match_filling/zero_padding_app.py +10 -5
- cars/applications/dense_matching/abstract_dense_matching_app.py +2 -1
- cars/applications/dense_matching/census_mccnn_sgm_app.py +38 -39
- cars/applications/dense_matching/cpp/dense_matching_cpp.cp313-win_amd64.dll.a +0 -0
- cars/applications/dense_matching/cpp/dense_matching_cpp.cp313-win_amd64.pyd +0 -0
- cars/applications/dense_matching/dense_matching_algo.py +48 -14
- cars/applications/dense_matching/dense_matching_wrappers.py +11 -3
- cars/applications/dense_matching/disparity_grid_algo.py +84 -62
- cars/applications/dense_matching/loaders/pandora_loader.py +91 -33
- cars/applications/dsm_filling/border_interpolation_app.py +1 -7
- cars/applications/dsm_filling/bulldozer_filling_app.py +2 -8
- cars/applications/dsm_filling/exogenous_filling_app.py +4 -9
- cars/applications/grid_generation/abstract_grid_generation_app.py +1 -1
- cars/applications/grid_generation/epipolar_grid_generation_app.py +4 -2
- cars/applications/grid_generation/grid_correction_app.py +4 -1
- cars/applications/grid_generation/grid_generation_algo.py +7 -2
- cars/applications/ground_truth_reprojection/abstract_ground_truth_reprojection_app.py +1 -1
- cars/applications/ground_truth_reprojection/direct_localization_app.py +2 -2
- cars/applications/ground_truth_reprojection/ground_truth_reprojection_algo.py +2 -1
- cars/applications/point_cloud_fusion/abstract_pc_fusion_app.py +0 -155
- cars/applications/point_cloud_fusion/mapping_to_terrain_tiles_app.py +0 -658
- cars/applications/point_cloud_fusion/pc_fusion_algo.py +0 -1339
- cars/applications/point_cloud_fusion/pc_fusion_wrappers.py +0 -869
- cars/applications/point_cloud_outlier_removal/abstract_outlier_removal_app.py +2 -1
- cars/applications/point_cloud_outlier_removal/outlier_removal_algo.py +9 -8
- cars/applications/point_cloud_outlier_removal/small_components_app.py +96 -267
- cars/applications/point_cloud_outlier_removal/statistical_app.py +116 -275
- cars/applications/rasterization/abstract_pc_rasterization_app.py +1 -1
- cars/applications/rasterization/rasterization_algo.py +18 -6
- cars/applications/rasterization/rasterization_wrappers.py +2 -1
- cars/applications/rasterization/simple_gaussian_app.py +60 -113
- cars/applications/resampling/abstract_resampling_app.py +1 -1
- cars/applications/resampling/bicubic_resampling_app.py +3 -1
- cars/applications/resampling/resampling_algo.py +16 -4
- cars/applications/resampling/resampling_wrappers.py +3 -1
- cars/applications/sparse_matching/abstract_sparse_matching_app.py +1 -1
- cars/applications/sparse_matching/sift_app.py +3 -3
- cars/applications/sparse_matching/sparse_matching_algo.py +3 -2
- cars/applications/sparse_matching/sparse_matching_wrappers.py +1 -1
- cars/applications/triangulation/abstract_triangulation_app.py +1 -1
- cars/applications/triangulation/line_of_sight_intersection_app.py +13 -11
- cars/applications/triangulation/pc_transform.py +552 -0
- cars/applications/triangulation/triangulation_algo.py +6 -4
- cars/applications/triangulation/triangulation_wrappers.py +1 -0
- cars/bundleadjustment.py +6 -6
- cars/cars.py +11 -9
- cars/core/cars_logging.py +80 -49
- cars/core/constants.py +0 -1
- cars/core/datasets.py +5 -2
- cars/core/geometry/abstract_geometry.py +256 -25
- cars/core/geometry/shareloc_geometry.py +110 -82
- cars/core/inputs.py +57 -19
- cars/core/outputs.py +1 -1
- cars/core/preprocessing.py +17 -3
- cars/core/projection.py +9 -6
- cars/core/tiling.py +10 -3
- cars/data_structures/cars_dataset.py +5 -5
- cars/data_structures/corresponding_tiles_tools.py +0 -103
- cars/data_structures/format_transformation.py +4 -1
- cars/devibrate.py +6 -3
- cars/extractroi.py +20 -21
- cars/orchestrator/cluster/abstract_cluster.py +15 -5
- cars/orchestrator/cluster/abstract_dask_cluster.py +6 -2
- cars/orchestrator/cluster/dask_jobqueue_utils.py +1 -1
- cars/orchestrator/cluster/log_wrapper.py +148 -21
- cars/orchestrator/cluster/mp_cluster/multiprocessing_cluster.py +11 -3
- cars/orchestrator/cluster/mp_cluster/multiprocessing_profiler.py +2 -2
- cars/orchestrator/cluster/pbs_dask_cluster.py +1 -1
- cars/orchestrator/cluster/sequential_cluster.py +5 -4
- cars/orchestrator/cluster/slurm_dask_cluster.py +1 -1
- cars/orchestrator/orchestrator.py +14 -3
- cars/orchestrator/registry/id_generator.py +1 -0
- cars/orchestrator/registry/saver_registry.py +2 -2
- cars/pipelines/conf_resolution/conf_final_resolution.json +5 -3
- cars/pipelines/default/default_pipeline.py +462 -1073
- cars/pipelines/parameters/advanced_parameters.py +74 -64
- cars/pipelines/parameters/advanced_parameters_constants.py +2 -5
- cars/pipelines/parameters/application_parameters.py +71 -0
- cars/pipelines/parameters/depth_map_inputs.py +0 -314
- cars/pipelines/parameters/dsm_inputs.py +40 -4
- cars/pipelines/parameters/output_parameters.py +2 -2
- cars/pipelines/parameters/sensor_inputs.py +30 -75
- cars/pipelines/parameters/sensor_inputs_constants.py +0 -2
- cars/pipelines/parameters/sensor_loaders/__init__.py +4 -3
- cars/pipelines/parameters/sensor_loaders/basic_classif_loader.py +106 -0
- cars/pipelines/parameters/sensor_loaders/{basic_sensor_loader.py → basic_image_loader.py} +16 -22
- cars/pipelines/parameters/sensor_loaders/pivot_classif_loader.py +121 -0
- cars/pipelines/parameters/sensor_loaders/{pivot_sensor_loader.py → pivot_image_loader.py} +10 -21
- cars/pipelines/parameters/sensor_loaders/sensor_loader.py +4 -6
- cars/pipelines/parameters/sensor_loaders/sensor_loader_template.py +1 -3
- cars/pipelines/pipeline_template.py +1 -3
- cars/pipelines/unit/unit_pipeline.py +527 -1016
- cars/starter.py +4 -3
- cars-1.0.0a4.dist-info/DELVEWHEEL +2 -0
- {cars-1.0.0a3.dist-info → cars-1.0.0a4.dist-info}/METADATA +135 -53
- {cars-1.0.0a3.dist-info → cars-1.0.0a4.dist-info}/RECORD +115 -131
- cars.libs/libgcc_s_seh-1-b2494fcbd4d80cf2c98fdd5261f6d850.dll +0 -0
- cars.libs/libstdc++-6-e9b0d12ae0e9555bbae55e8dfd08c3f7.dll +0 -0
- cars.libs/libwinpthread-1-7882d1b093714ccdfaf4e0789a817792.dll +0 -0
- cars/applications/dense_match_filling/cpp/__init__.py +0 -0
- cars/applications/dense_match_filling/cpp/dense_match_filling_cpp.cp313-win_amd64.dll.a +0 -0
- cars/applications/dense_match_filling/cpp/dense_match_filling_cpp.cp313-win_amd64.pyd +0 -0
- cars/applications/dense_match_filling/cpp/dense_match_filling_cpp.py +0 -72
- cars/applications/dense_match_filling/cpp/includes/dense_match_filling.hpp +0 -46
- cars/applications/dense_match_filling/cpp/meson.build +0 -9
- cars/applications/dense_match_filling/cpp/src/bindings.cpp +0 -11
- cars/applications/dense_match_filling/cpp/src/dense_match_filling.cpp +0 -142
- cars/applications/dense_match_filling/plane_app.py +0 -556
- cars/applications/hole_detection/__init__.py +0 -30
- cars/applications/hole_detection/abstract_hole_detection_app.py +0 -125
- cars/applications/hole_detection/cloud_to_bbox_app.py +0 -346
- cars/applications/hole_detection/hole_detection_algo.py +0 -144
- cars/applications/hole_detection/hole_detection_wrappers.py +0 -53
- cars/applications/point_cloud_denoising/__init__.py +0 -29
- cars/applications/point_cloud_denoising/abstract_pc_denoising_app.py +0 -273
- cars/applications/point_cloud_fusion/__init__.py +0 -30
- cars/applications/point_cloud_fusion/cloud_fusion_constants.py +0 -39
- cars/applications/sparse_matching/pandora_sparse_matching_app.py +0 -0
- cars/pipelines/parameters/depth_map_inputs_constants.py +0 -25
- cars-1.0.0a3.dist-info/DELVEWHEEL +0 -2
- cars.libs/libgcc_s_seh-1-ca70890bbc5723b6d0ea31e9c9cded2b.dll +0 -0
- cars.libs/libstdc++-6-00ee19f73d5122a1277c137b1c218401.dll +0 -0
- cars.libs/libwinpthread-1-f5042e8e3d21edce20c1bc99445f551b.dll +0 -0
- {cars-1.0.0a3.dist-info → cars-1.0.0a4.dist-info}/WHEEL +0 -0
- {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
|
-
|
|
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
|
-
|
|
52
|
+
geomodel = None
|
|
53
53
|
else:
|
|
54
54
|
raise ValueError(absfilename + " not supported")
|
|
55
55
|
|
|
56
56
|
sensor["image"] = absfilename
|
|
57
|
-
|
|
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.
|
|
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.
|
|
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.
|
|
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<
|
|
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<
|
|
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
|
|
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/
|
|
100
|
+
src="https://raw.githubusercontent.com/CNES/cars/master/docs/source/images/cars_picto.svg"
|
|
104
101
|
alt="CARS"
|
|
105
|
-
width="
|
|
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
|
-
[](https://www.python.org/downloads/release/python-390/)
|
|
113
110
|
[](CONTRIBUTING.md)
|
|
114
111
|
[](https://opensource.org/licenses/Apache-2.0/)
|
|
115
112
|
[](https://cars.readthedocs.io/?badge=latest)
|
|
116
113
|
[](https://github.com/CNES/cars/actions)
|
|
114
|
+
[](https://pypi.org/project/cars/)
|
|
115
|
+
[](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
|
-
|
|
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
|
-
|
|
140
|
-
|
|
141
|
-
|
|
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
|
+
|
|
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
|
+
|
|
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
|
-
|
|
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
|
-
###
|
|
210
|
+
### 🐋 with Docker
|
|
211
|
+
---
|
|
148
212
|
|
|
149
|
-
|
|
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
|
-
|
|
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.
|
|
225
|
+
docker run -w /data -v "$(pwd)"/data_gizeh:/data cnes/cars /data/configfile.yaml
|
|
162
226
|
```
|
|
163
227
|
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
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
|
-
|
|
239
|
+
#### ⚙ Run CARS
|
|
240
|
+
|
|
241
|
+
Once you moved to the data_gizeh directory:
|
|
187
242
|
|
|
188
|
-
|
|
243
|
+
``` bash
|
|
244
|
+
cars configfile.yaml
|
|
245
|
+
```
|
|
189
246
|
|
|
190
|
-
|
|
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
|
-
|
|
255
|
+
# 🤝 **Contribution**
|
|
196
256
|
|
|
197
|
-
To do a
|
|
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
|
-
|
|
259
|
+
# 🆘 **Help**
|
|
200
260
|
|
|
201
|
-
|
|
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
|
-
|
|
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/)
|