.. _python_API_use_cloud:

.. currentmodule:: flow360

**************************
Use cloud project
**************************

This example demonstrates retrieving an existing Flow360 project from the cloud using its unique identifier. It illustrates how to access the project's geometry, define new simulation parameters (specifically modifying freestream conditions in this instance), and submit a subsequent simulation case associated with this project. This process allows users to build upon existing cloud assets, such as geometries or meshes, for further analysis or parameter variations.

.. literalinclude:: ../../../../../Flow360/examples/workflow_management/project_management/use_cloud_project.py
  :language: python
  :linenos:

Notes
=====

- The ``Project.from_cloud`` method is used to instantiate a ``Project`` object linked to an existing cloud project, identified by its unique ID.
- Project assets, such as the geometry, can be accessed via attributes like ``my_project.geometry``.
- Submitting a new case via ``my_project.run_case`` utilizes the project structure. Flow360 will attempt to reuse existing compatible assets (e.g., surface or volume meshes) based on the provided ``SimulationParams``, potentially skipping mesh generation steps if suitable assets are found within the project tree.