cars 1.0.0a2__tar.gz → 1.0.0a4__tar.gz

{cars-1.0.0a2 → cars-1.0.0a4}/.gitlab-ci.yml

@@ -81,6 +81,8 @@ unit-test:
     paths:
       - ./pytest-report.xml
       - ./coverage.xml
+      - tests/data/intermediate_data
+    when: always
     expire_in: 1 day
 
 
@@ -105,7 +107,7 @@ test-end2end:
   # Use dedicated runner for end2end tests
   tags:
     - ${TEST_RUNNER_TAG}
-  timeout: 80 minutes 
+  timeout: 120 minutes
   extends:
     - .cars-python-job
   script:
@@ -116,6 +118,13 @@ test-end2end:
       - tests/data/intermediate_data
     when: always
     expire_in: 1 day
+  rules:
+    - if: '$CI_PIPELINE_SOURCE == "merge_request_event"'
+      changes:
+       - "tests/test_end2end.py"
+       - "cars/**/*"
+
+    - if: '$CI_COMMIT_REF_NAME == "master"'
 
 
 
@@ -158,4 +167,4 @@ github-sync:
 
   variables:
     BRANCH: "master"
-    GITHUB_URL: github.com/CNES/cars.git
+    GITHUB_URL: github.com/CNES/cars.git

{cars-1.0.0a2 → cars-1.0.0a4}/CONTRIBUTING.md

@@ -31,15 +31,15 @@ The Merge Request shall have a short description of the proposed changes. If it
 Likewise, if you work on a branch (which is recommended), prefix the branch's name by `xx-` in order to link it to the xx issue.
 
 CARS Classical workflow is :
-* Check Licence and sign [Contributor Licence Agreement](#contribution-license-agreement) (Individual or Corporate)
-* Create an issue (or begin from an existing one)
-* Create a Merge Request from the issue: a MR is created accordingly with "WIP:", "Closes xx" and associated "xx-name-issue" branch
-* CARS hacking code from a local working directory or from the forge (less possibilities) following [Developer manual](./docs/source/developer.rst)
-* Git add, commit and push from local working clone directory or from the forge directly
+* Check Licence and sign [Contributor Licence Agreement](#contribution-license-agreement) (Individual or Corporate).
+* Create an issue (or begin from an existing one).
+* Create a Merge Request from the issue: a MR is created accordingly with "WIP:", "Closes xx" and associated "xx-name-issue" branch.
+* CARS hacking code from a local working directory or from the forge (less possibilities) following developer guide from [user guide](https://cars.readthedocs.io/).
+* Git add, commit and push from local working clone directory or from the forge directly.
 * Follow [Conventional commits](https://www.conventionalcommits.org/) specifications for commit messages
-* Beware that quality pre-commit tools are installed in continuous integration with classical quality code tools (see [Developer manual](./docs/source/developer.rst)).
-* Launch the [tests](./docs/source/developer.rst) on your modifications (or don't forget to add ones).
-* When finished, change your Merge Request name (erase "WIP:" in title ) and ask `@cars` to review the code (see below Merge request acceptation process)
+* Beware that quality pre-commit tools are installed in continuous integration with classical quality code tools (see [user guide](https://cars.readthedocs.io/)).
+* Launch the tests on your modifications (or don't forget to add ones).
+* When finished, change your Merge Request name (erase "WIP:" in title ) and ask `@cars` to review the code (see below Merge request acceptation process).
 
 
 # Contribution license agreement
@@ -66,8 +66,7 @@ file](./AUTHORS.md).
 
 The Merge Request will be merged into master after being reviewed by CARS steering committee (core committers) composed of:
 * David Youssefi (CNES)
-* Emmanuelle Sarrazin (CNES)
-* Emmanuel Dubois (CNES)
+* Valentine Bellet (CNES)
 
 Only the members of this committee can merge into master.
 

{cars-1.0.0a2 → cars-1.0.0a4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: cars
-Version: 1.0.0a2
+Version: 1.0.0a4
 Summary: A satellite multi view stereo pipeline
 Keywords: cars,3D,DEM,pandora,photogrammetry
 Author-Email: CNES <cars@cnes.fr>
@@ -39,18 +39,19 @@ Requires-Dist: urllib3<2.0,>=1.21.1
 Requires-Dist: laspy[laszip]
 Requires-Dist: tbb==2020.3.254
 Requires-Dist: numba
-Requires-Dist: pandora[sgm]==1.7.1a1
+Requires-Dist: pandora[sgm]==1.7.1
 Requires-Dist: cars-rasterize==0.2.*
 Requires-Dist: cars-resample==0.1.*
 Requires-Dist: cars-filter==0.2.*
 Requires-Dist: vlsift==0.1.*
-Requires-Dist: shareloc==0.2.9
+Requires-Dist: shareloc==0.2.10
 Requires-Dist: bulldozer-dtm==1.1.*
 Requires-Dist: xdem==0.1.*
 Requires-Dist: geopandas<=1.0.1
 Provides-Extra: dev
 Requires-Dist: pytest; extra == "dev"
 Requires-Dist: pytest-cov; extra == "dev"
+Requires-Dist: pytest-check; extra == "dev"
 Requires-Dist: pre-commit; extra == "dev"
 Requires-Dist: isort>=5.8.0; extra == "dev"
 Requires-Dist: black>=24.1a1; extra == "dev"
@@ -59,7 +60,7 @@ Requires-Dist: flake8-pyproject; extra == "dev"
 Requires-Dist: flake8-comprehensions>=3.4.0; extra == "dev"
 Requires-Dist: flake8-bugbear<24.0.0,>=21.4.3; extra == "dev"
 Requires-Dist: jupyter_contrib_nbextensions; extra == "dev"
-Requires-Dist: pylint<3.0.0,>=2.8.12; extra == "dev"
+Requires-Dist: pylint<4.0.0,>=2.8.12; extra == "dev"
 Requires-Dist: setuptools_scm; extra == "dev"
 Requires-Dist: virtualenv; extra == "dev"
 Requires-Dist: configupdater; extra == "dev"
@@ -75,12 +76,12 @@ Requires-Dist: dash; extra == "dev"
 Requires-Dist: plotly; extra == "dev"
 Requires-Dist: build; extra == "dev"
 Provides-Extra: docs
-Requires-Dist: astroid<3.0.0; extra == "docs"
+Requires-Dist: astroid<4.0.0; extra == "docs"
 Requires-Dist: sphinx; extra == "docs"
 Requires-Dist: sphinx-rtd-theme; extra == "docs"
 Requires-Dist: sphinx_autoapi; extra == "docs"
 Requires-Dist: graphviz; extra == "docs"
-Requires-Dist: sphinx_tabs==3.4.0; extra == "docs"
+Requires-Dist: sphinx_tabs; extra == "docs"
 Requires-Dist: sphinx-copybutton; extra == "docs"
 Provides-Extra: notebook
 Requires-Dist: notebook; extra == "notebook"
@@ -95,115 +96,196 @@ Description-Content-Type: text/markdown
 <div align="center">
 <a target="_blank" href="https://github.com/CNES/cars">
 <picture>
-  <source
-    srcset="https://raw.githubusercontent.com/CNES/cars/master/docs/source/images/picto_dark.png"
-    media="(prefers-color-scheme: dark)"
-  />
   <img
-    src="https://raw.githubusercontent.com/CNES/cars/master/docs/source/images/picto_light.png"
+    src="https://raw.githubusercontent.com/CNES/cars/master/docs/source/images/cars_picto.svg"
     alt="CARS"
-    width="40%"
+    width="50%"
   />
 </picture>
 </a>
 
 <h4>CARS, a satellite multi view stereo framework </h4>
 
-[![Python](https://img.shields.io/badge/python-v3.9+-blue.svg)](https://www.python.org/downloads/release/python-390/)
+[![Python](https://img.shields.io/badge/python-v3.10+-blue.svg)](https://www.python.org/downloads/release/python-390/)
 [![Contributions welcome](https://img.shields.io/badge/contributions-welcome-orange.svg)](CONTRIBUTING.md)
 [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0/)
 [![Documentation](https://readthedocs.org/projects/cars/badge/?version=latest)](https://cars.readthedocs.io/?badge=latest)
 [![Github Action](https://github.com/CNES/cars/actions/workflows/cars-ci.yml/badge.svg?branch=master)](https://github.com/CNES/cars/actions)
+[![pypi](https://badge.fury.io/py/cars.svg)](https://pypi.org/project/cars/)
+[![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)
 
 <p>
   <a href="#overview">Overview</a> •
   <a href="#quick-start">Quick Start</a> •
   <a href="#documentation">Documentation</a> •
+  <a href="#license">License</a> •
   <a href="#contribution">Contribution</a> •
+  <a href="#help">Help</a> •
+  <a href="#credits">Credits</a> •
+  <a href="#contact">Contact</a> •
   <a href="#references">References</a>
 </p>
 </div>
 
-## Overview
-
-From stereo images  |  CARS produces a Digital Surface Model (DSM)
-:-------------------------:|:-------------------------:
-<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%"/>
+# 🌐 **Overview**
 
+<div align="center">
+<table style="display: inline-block;">
+  <tr>
+    <td align="center">
+      <div  style="font-size:2em; margin-bottom:10px;"><strong>🎞️ From Stereo Images</strong></div><br>
+      <img src="https://raw.githubusercontent.com/CNES/cars/master/docs/source/images/animation_sat.gif"
+           alt="Stereo images animation" width="95%"><br>
+      <em>Input stereo image pairs</em>
+    </td>
+    <td align="center">
+      <div  style="font-size:2em; margin-bottom:10px;"><strong>🌍 To Digital Surface Model (DSM)</strong></div><br>
+      <img src="https://raw.githubusercontent.com/CNES/cars/master/docs/source/images/overview_dsm_3d.gif"
+           alt="DSM overview" width="95%"><br>
+      <em>Output 3D surface reconstruction</em>
+    </td>
+  </tr>
+</table>
+</div>
 
 **CARS** is an open source 3D tool dedicated to produce **Digital Surface Models** from satellite imaging by photogrammetry.
 This Multiview Stereo framework is intended for massive DSM production with a robust, performant and modular design.
 
 **CARS** is currently under active development and integrated into various projects & missions:
 
-- <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>
-- <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>
-- <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>
+<div align="center">
+<p align="center">
+  <a href="https://co3d.cnes.fr/en/co3d-0" target="_blank">
+    <img src="https://raw.githubusercontent.com/CNES/cars/master/docs/source/images/logo_co3D_cnes.png"
+         alt="CO3D project" height="70">
+  </a>
+  &nbsp;&nbsp;&nbsp;&nbsp;
+  <a href="https://www.ai4geo.eu" target="_blank">
+    <img src="https://raw.githubusercontent.com/CNES/cars/master/docs/source/images/logo-ai4geo.png"
+         alt="AI4GEO project" height="75">
+  </a>
+  &nbsp;&nbsp;&nbsp;&nbsp;
+  <a href="https://www.evo-land.eu" target="_blank">
+    <img src="https://raw.githubusercontent.com/CNES/cars/master/docs/source/images/logo-evoland.png"
+         alt="Evoland project" height="60">
+  </a>
+</p>
+</div>
+
+<br>
 
 Its roadmap and implemented functionalities are evolving regularly depending on specific project requirements.
 
-## Quick start
+# 🚀 **Quick start**
+
+
+### △ On the way to the Pyramids...
+---
+
+You want to build the pyramids by yourself? 
+
+
+<div align="center">
+<table style="display: inline-block;">
+  <tr>
+    <td align="center">
+      <img src="https://raw.githubusercontent.com/CNES/cars/master/docs/source/images/dsm.png"
+           alt="Dsm" width="400"><br>
+    </td>
+    <td align="center">
+      <img src="https://raw.githubusercontent.com/CNES/cars/master/docs/source/images/clr.png"
+           alt="Color" width="400"><br>
+    </td>
+     <td align="center">
+      <img src="https://raw.githubusercontent.com/CNES/cars/master/docs/source/images/dsm_clr.png"
+           alt="Color" width="400"><br>
+    </td>
+  </tr>
+</table>
+</div>
+
+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!
+
 
-### CARS Docker Image
+### 🐋 with Docker
+---
 
-[![Docker Status](http://dockeri.co/image/cnes/cars)](https://hub.docker.com/r/cnes/cars)
+#### 🛠 Installation
 
 CARS is available on Docker Hub and can be downloaded by:
 ``` bash
 docker pull cnes/cars
 ```
 
-### One main pipeline to generate DSM
+#### ⚙ Run CARS
 
 You only need to launch one command:
 
 ```
-docker run -w /data -v "$(pwd)"/data_gizeh:/data cnes/cars /data/configfile.json
+docker run -w /data -v "$(pwd)"/data_gizeh:/data cnes/cars /data/configfile.yaml
 ```
 
-with one configuration input file ("configfile.json") located in a "data" folder to be consistent with the previous command lines:
-```
-{
-    "inputs": {
-        "sensors" : {
-            "one": {
-                "image": "img1.tif",
-                "geomodel": "img1.geom"
-            },
-            "two": {
-                "image": "img2.tif",
-                "geomodel": "img2.geom"
-            }
-        }
-    },
-    "output": {
-        "directory": "outresults"
-    }
-}
+### 🐍 with pip
+---
+
+#### 🛠 Installation
 
+CARS can also be downloaded using the pip install command:
+
+``` bash 
+pip install cars 
 ```
 
-### On the way to the Pyramids...
+#### ⚙ Run CARS
+
+Once you moved to the data_gizeh directory:
 
-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!
+``` bash 
+cars configfile.yaml
+```
 
-## Documentation
+# 📚 **Documentation**
 
 Go to [CARS Main Documentation](https://cars.readthedocs.io/?badge=latest).
 
+# 📜 **License**
+
+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.
 
-## Contribution
+# 🤝 **Contribution**
 
-To do a bug report or a contribution, see the [**Contribution Guide**](https://github.com/CNES/cars/blob/master/CONTRIBUTING.md).
+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).
 
-For project evolution, see [**Changelog**](https://github.com/CNES/cars/blob/master/CHANGELOG.md).
+# 🆘 **Help**
 
-## Credits
+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.
+
+You can also ask your questions on the corresponding [slack](https://join.slack.com/t/cars-community/shared_invite/zt-2uw6usog1-~TT~m8BxO9faMXpP7tpz2Q).
+
+# ✒️ **Credits**
+
+If you use CARS in your research, please cite the following paper:
+
+```
+@INPROCEEDINGS{9324020,
+  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},
+  booktitle={IGARSS 2020 - 2020 IEEE International Geoscience and Remote Sensing Symposium}, 
+  title={CARS: A Photogrammetry Pipeline Using Dask Graphs to Construct A Global 3D Model}, 
+  year={2020},
+  volume={},
+  number={},
+  pages={453-456},
+  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},
+  doi={10.1109/IGARSS39084.2020.9324020}}
+```
 
 See [Authors file](https://github.com/CNES/cars/blob/master/AUTHORS.md)
 
+# ✉️ **Contact**
+
+You can contact us on the following mail adress: cars@cnes.fr
 
-## References
+# 🔗 **References**
 
 - [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)
 - [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/)

cars-1.0.0a4/README.md

@@ -0,0 +1,196 @@
+<div align="center">
+<a target="_blank" href="https://github.com/CNES/cars">
+<picture>
+  <img
+    src="https://raw.githubusercontent.com/CNES/cars/master/docs/source/images/cars_picto.svg"
+    alt="CARS"
+    width="50%"
+  />
+</picture>
+</a>
+
+<h4>CARS, a satellite multi view stereo framework </h4>
+
+[![Python](https://img.shields.io/badge/python-v3.10+-blue.svg)](https://www.python.org/downloads/release/python-390/)
+[![Contributions welcome](https://img.shields.io/badge/contributions-welcome-orange.svg)](CONTRIBUTING.md)
+[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0/)
+[![Documentation](https://readthedocs.org/projects/cars/badge/?version=latest)](https://cars.readthedocs.io/?badge=latest)
+[![Github Action](https://github.com/CNES/cars/actions/workflows/cars-ci.yml/badge.svg?branch=master)](https://github.com/CNES/cars/actions)
+[![pypi](https://badge.fury.io/py/cars.svg)](https://pypi.org/project/cars/)
+[![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)
+
+<p>
+  <a href="#overview">Overview</a> •
+  <a href="#quick-start">Quick Start</a> •
+  <a href="#documentation">Documentation</a> •
+  <a href="#license">License</a> •
+  <a href="#contribution">Contribution</a> •
+  <a href="#help">Help</a> •
+  <a href="#credits">Credits</a> •
+  <a href="#contact">Contact</a> •
+  <a href="#references">References</a>
+</p>
+</div>
+
+# 🌐 **Overview**
+
+<div align="center">
+<table style="display: inline-block;">
+  <tr>
+    <td align="center">
+      <div  style="font-size:2em; margin-bottom:10px;"><strong>🎞️ From Stereo Images</strong></div><br>
+      <img src="https://raw.githubusercontent.com/CNES/cars/master/docs/source/images/animation_sat.gif"
+           alt="Stereo images animation" width="95%"><br>
+      <em>Input stereo image pairs</em>
+    </td>
+    <td align="center">
+      <div  style="font-size:2em; margin-bottom:10px;"><strong>🌍 To Digital Surface Model (DSM)</strong></div><br>
+      <img src="https://raw.githubusercontent.com/CNES/cars/master/docs/source/images/overview_dsm_3d.gif"
+           alt="DSM overview" width="95%"><br>
+      <em>Output 3D surface reconstruction</em>
+    </td>
+  </tr>
+</table>
+</div>
+
+**CARS** is an open source 3D tool dedicated to produce **Digital Surface Models** from satellite imaging by photogrammetry.
+This Multiview Stereo framework is intended for massive DSM production with a robust, performant and modular design.
+
+**CARS** is currently under active development and integrated into various projects & missions:
+
+<div align="center">
+<p align="center">
+  <a href="https://co3d.cnes.fr/en/co3d-0" target="_blank">
+    <img src="https://raw.githubusercontent.com/CNES/cars/master/docs/source/images/logo_co3D_cnes.png"
+         alt="CO3D project" height="70">
+  </a>
+  &nbsp;&nbsp;&nbsp;&nbsp;
+  <a href="https://www.ai4geo.eu" target="_blank">
+    <img src="https://raw.githubusercontent.com/CNES/cars/master/docs/source/images/logo-ai4geo.png"
+         alt="AI4GEO project" height="75">
+  </a>
+  &nbsp;&nbsp;&nbsp;&nbsp;
+  <a href="https://www.evo-land.eu" target="_blank">
+    <img src="https://raw.githubusercontent.com/CNES/cars/master/docs/source/images/logo-evoland.png"
+         alt="Evoland project" height="60">
+  </a>
+</p>
+</div>
+
+<br>
+
+Its roadmap and implemented functionalities are evolving regularly depending on specific project requirements.
+
+# 🚀 **Quick start**
+
+
+### △ On the way to the Pyramids...
+---
+
+You want to build the pyramids by yourself? 
+
+
+<div align="center">
+<table style="display: inline-block;">
+  <tr>
+    <td align="center">
+      <img src="https://raw.githubusercontent.com/CNES/cars/master/docs/source/images/dsm.png"
+           alt="Dsm" width="400"><br>
+    </td>
+    <td align="center">
+      <img src="https://raw.githubusercontent.com/CNES/cars/master/docs/source/images/clr.png"
+           alt="Color" width="400"><br>
+    </td>
+     <td align="center">
+      <img src="https://raw.githubusercontent.com/CNES/cars/master/docs/source/images/dsm_clr.png"
+           alt="Color" width="400"><br>
+    </td>
+  </tr>
+</table>
+</div>
+
+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!
+
+
+### 🐋 with Docker
+---
+
+#### 🛠 Installation
+
+CARS is available on Docker Hub and can be downloaded by:
+``` bash
+docker pull cnes/cars
+```
+
+#### ⚙ Run CARS
+
+You only need to launch one command:
+
+```
+docker run -w /data -v "$(pwd)"/data_gizeh:/data cnes/cars /data/configfile.yaml
+```
+
+### 🐍 with pip
+---
+
+#### 🛠 Installation
+
+CARS can also be downloaded using the pip install command:
+
+``` bash 
+pip install cars 
+```
+
+#### ⚙ Run CARS
+
+Once you moved to the data_gizeh directory:
+
+``` bash 
+cars configfile.yaml
+```
+
+# 📚 **Documentation**
+
+Go to [CARS Main Documentation](https://cars.readthedocs.io/?badge=latest).
+
+# 📜 **License**
+
+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.
+
+# 🤝 **Contribution**
+
+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).
+
+# 🆘 **Help**
+
+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.
+
+You can also ask your questions on the corresponding [slack](https://join.slack.com/t/cars-community/shared_invite/zt-2uw6usog1-~TT~m8BxO9faMXpP7tpz2Q).
+
+# ✒️ **Credits**
+
+If you use CARS in your research, please cite the following paper:
+
+```
+@INPROCEEDINGS{9324020,
+  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},
+  booktitle={IGARSS 2020 - 2020 IEEE International Geoscience and Remote Sensing Symposium}, 
+  title={CARS: A Photogrammetry Pipeline Using Dask Graphs to Construct A Global 3D Model}, 
+  year={2020},
+  volume={},
+  number={},
+  pages={453-456},
+  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},
+  doi={10.1109/IGARSS39084.2020.9324020}}
+```
+
+See [Authors file](https://github.com/CNES/cars/blob/master/AUTHORS.md)
+
+# ✉️ **Contact**
+
+You can contact us on the following mail adress: cars@cnes.fr
+
+# 🔗 **References**
+
+- [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)
+- [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/)

{cars-1.0.0a2 → cars-1.0.0a4}/cars/applications/__init__.py

@@ -30,9 +30,6 @@ from . import dense_matching  # noqa: F401
 from . import dsm_filling  # noqa: F401
 from . import grid_generation  # noqa: F401
 from . import ground_truth_reprojection  # noqa: F401
-from . import hole_detection  # noqa: F401
-from . import point_cloud_denoising  # noqa: F401
-from . import point_cloud_fusion  # noqa: F401
 from . import point_cloud_outlier_removal  # noqa: F401
 from . import rasterization  # noqa: F401
 from . import resampling  # noqa: F401

{cars-1.0.0a2 → cars-1.0.0a4}/cars/applications/application.py

@@ -26,6 +26,8 @@ This module contains class application factory.
 # Standard imports
 import logging
 
+from cars.applications.application_template import ScalingApplicationTemplate
+
 # CARS imports
 from cars.conf.input_parameters import ConfigType
 
@@ -46,6 +48,7 @@ class Application:
         cls,
         app_name: str,
         cfg: ConfigType = None,
+        scaling_coeff: float = 1,
     ):
         """
         Return the instance of application associated with the application
@@ -55,12 +58,14 @@ class Application:
         :type app_name: str
         :param cfg: configuration {'matching_cost_method': value}
         :type cfg: dictionary
+        :param scaling_coeff: scaling factor for resolution
+        :type scaling_coeff: float
         """
 
-        return cls.create_app(app_name, cfg)
+        return cls.create_app(app_name, cfg, scaling_coeff)
 
     @classmethod
-    def create_app(cls, name: str, cfg: ConfigType):
+    def create_app(cls, name: str, cfg: ConfigType, scaling_coeff: float = 1):
         """Factory command to create the application
         Return the instance of application associated with the application
         name given as parameter
@@ -69,16 +74,19 @@ class Application:
         :type app_name: str
         :param cfg: configuration {'matching_cost_method': value}
         :type cfg: dictionary
+        :param scaling_coeff: scaling factor for resolution
+        :type scaling_coeff: float
         """
-        app = None
-
         try:
             app_class = cls.available_applications[name]
         except KeyError:
             logging.error("No application named {0} supported".format(name))
             return None
-        app = app_class(conf=cfg)
-        return app
+
+        if issubclass(app_class, ScalingApplicationTemplate):
+            return app_class(scaling_coeff=scaling_coeff, conf=cfg)
+
+        return app_class(conf=cfg)
 
     @classmethod
     def print_applications(cls):