From 280c320ee29a19fd473ba4208bc801ec7af953f6 Mon Sep 17 00:00:00 2001
From: Renaud <38732257+renaudjester@users.noreply.github.com>
Date: Thu, 12 Sep 2024 09:07:48 +0200
Subject: [PATCH] chore: add more return metadata and dry run (#129)

have a defined return object with more information and a dry run to access this object without downloading anything
---
 copernicusmarine/__init__.py                  |   8 +
 copernicusmarine/catalogue_parser/models.py   |   2 +
 .../catalogue_parser/request_structure.py     |   2 +
 .../command_line_interface/group_get.py       |  13 +-
 .../command_line_interface/group_subset.py    |  13 +-
 copernicusmarine/core_functions/get.py        |  10 +-
 copernicusmarine/core_functions/models.py     |  75 ++-
 copernicusmarine/core_functions/subset.py     |   9 +-
 copernicusmarine/core_functions/utils.py      |   4 -
 .../download_arco_series.py                   |  52 +-
 .../download_original_files.py                |  38 +-
 copernicusmarine/download_functions/utils.py  |  91 ++-
 copernicusmarine/python_interface/get.py      |  11 +-
 copernicusmarine/python_interface/subset.py   |  11 +-
 doc/_build/doctrees/environment.pickle        | Bin 42150 -> 62201 bytes
 doc/_build/doctrees/index.doctree             | Bin 4654 -> 4682 bytes
 .../usage/command-line-interface.doctree      | Bin 113715 -> 118277 bytes
 .../doctrees/usage/python-interface.doctree   | Bin 297083 -> 314202 bytes
 .../doctrees/usage/response_types.doctree     | Bin 0 -> 49110 bytes
 doc/_build/html/_sources/index.rst.txt        |   1 +
 .../_sources/usage/response_types.rst.txt     |  63 +++
 doc/_build/html/genindex.html                 | 135 ++++-
 doc/_build/html/index.html                    |   6 +
 doc/_build/html/objects.inv                   | Bin 1441 -> 1785 bytes
 doc/_build/html/py-modindex.html              |   1 +
 doc/_build/html/search.html                   |   1 +
 doc/_build/html/searchindex.js                |   2 +-
 .../html/usage/command-line-interface.html    |  28 +-
 doc/_build/html/usage/installation.html       |   1 +
 doc/_build/html/usage/python-interface.html   |  31 +-
 doc/_build/html/usage/quickstart.html         |   1 +
 doc/_build/html/usage/response_types.html     | 517 ++++++++++++++++++
 doc/index.rst                                 |   1 +
 doc/usage/response_types.rst                  |  63 +++
 poetry.lock                                   | 136 ++++-
 pyproject.toml                                |   1 +
 .../test_help_command_interface.ambr          |   2 +
 tests/test_command_line_interface.py          |  49 ++
 tests/test_get_direct_download.py             |   5 +-
 tests/test_get_index_files_insitu.py          |   7 +-
 tests/test_python_interface.py                |   9 +-
 41 files changed, 1316 insertions(+), 83 deletions(-)
 create mode 100644 doc/_build/doctrees/usage/response_types.doctree
 create mode 100644 doc/_build/html/_sources/usage/response_types.rst.txt
 create mode 100644 doc/_build/html/usage/response_types.html
 create mode 100644 doc/usage/response_types.rst

diff --git a/copernicusmarine/__init__.py b/copernicusmarine/__init__.py
index f6547ed4..0e67bbc7 100644
--- a/copernicusmarine/__init__.py
+++ b/copernicusmarine/__init__.py
@@ -9,6 +9,14 @@
 logging.config.dictConfig(logging_configuration_dict)
 logging.Formatter.converter = time.gmtime
 
+from copernicusmarine.core_functions.models import (
+    DatasetCoordinatesExtent,
+    FileGet,
+    GeographicalExtent,
+    ResponseGet,
+    ResponseSubset,
+    TimeExtent,
+)
 from copernicusmarine.python_interface.describe import describe
 from copernicusmarine.python_interface.get import get
 from copernicusmarine.python_interface.login import login
diff --git a/copernicusmarine/catalogue_parser/models.py b/copernicusmarine/catalogue_parser/models.py
index 656f2f5e..3896caef 100644
--- a/copernicusmarine/catalogue_parser/models.py
+++ b/copernicusmarine/catalogue_parser/models.py
@@ -1,4 +1,6 @@
 import re
+
+# TODO: change to pydantic
 from dataclasses import dataclass
 from enum import Enum
 from typing import Optional, Type, TypeVar, Union
diff --git a/copernicusmarine/catalogue_parser/request_structure.py b/copernicusmarine/catalogue_parser/request_structure.py
index 6643ed00..e316b204 100644
--- a/copernicusmarine/catalogue_parser/request_structure.py
+++ b/copernicusmarine/catalogue_parser/request_structure.py
@@ -75,6 +75,7 @@ class SubsetRequest:
     netcdf_compression_enabled: bool = False
     netcdf_compression_level: Optional[int] = None
     netcdf3_compatible: bool = False
+    dry_run: bool = False
 
     def update(self, new_dict: dict):
         """Method to update values in SubsetRequest object.
@@ -217,6 +218,7 @@ class GetRequest:
     sync_delete: bool = False
     index_parts: bool = False
     direct_download: Optional[list[str]] = None
+    dry_run: bool = False
 
     def update(self, new_dict: dict):
         """Method to update values in GetRequest object.
diff --git a/copernicusmarine/command_line_interface/group_get.py b/copernicusmarine/command_line_interface/group_get.py
index 19dd62b1..19210ac8 100644
--- a/copernicusmarine/command_line_interface/group_get.py
+++ b/copernicusmarine/command_line_interface/group_get.py
@@ -30,6 +30,7 @@
 )
 
 logger = logging.getLogger("copernicusmarine")
+blank_logger = logging.getLogger("copernicusmarine_blank_logger")
 
 
 @click.group()
@@ -224,6 +225,13 @@ def cli_get() -> None:
     default=False,
     help="Option to get the index files of an INSITU dataset. Temporary option.",
 )
+@click.option(
+    "--dry-run",
+    type=bool,
+    is_flag=True,
+    default=False,
+    help="Runs query without downloading data.",
+)
 @tqdm_disable_option
 @click.option(
     "--log-level",
@@ -265,6 +273,7 @@ def get(
     sync: bool,
     sync_delete: bool,
     index_parts: bool,
+    dry_run: bool,
     disable_progress_bar: bool,
     log_level: str,
     staging: bool,
@@ -285,7 +294,7 @@ def get(
         create_get_template()
         return
 
-    return get_function(
+    result = get_function(
         dataset_id=dataset_id,
         force_dataset_version=dataset_version,
         force_dataset_part=dataset_part,
@@ -307,6 +316,8 @@ def get(
         sync=sync,
         sync_delete=sync_delete,
         index_parts=index_parts,
+        dry_run=dry_run,
         disable_progress_bar=disable_progress_bar,
         staging=staging,
     )
+    blank_logger.info(result.model_dump_json(indent=2))
diff --git a/copernicusmarine/command_line_interface/group_subset.py b/copernicusmarine/command_line_interface/group_subset.py
index 337eb77b..381a15c4 100644
--- a/copernicusmarine/command_line_interface/group_subset.py
+++ b/copernicusmarine/command_line_interface/group_subset.py
@@ -41,6 +41,7 @@
 )
 
 logger = logging.getLogger("copernicusmarine")
+blank_logger = logging.getLogger("copernicusmarine_blank_logger")
 
 
 @click.group()
@@ -314,6 +315,13 @@ def cli_subset() -> None:
         "quotes ' in the request."
     ),
 )
+@click.option(
+    "--dry-run",
+    type=bool,
+    is_flag=True,
+    default=False,
+    help="Runs query without downloading data.",
+)
 @tqdm_disable_option
 @click.option(
     "--log-level",
@@ -390,6 +398,7 @@ def subset(
     motu_api_request: Optional[str],
     force_download: bool,
     overwrite_output_data: bool,
+    dry_run: bool,
     disable_progress_bar: bool,
     log_level: str,
     staging: bool = False,
@@ -410,7 +419,7 @@ def subset(
         create_subset_template()
         return
 
-    subset_function(
+    response = subset_function(
         dataset_id,
         dataset_version,
         dataset_part,
@@ -437,9 +446,11 @@ def subset(
         motu_api_request,
         force_download,
         overwrite_output_data,
+        dry_run,
         disable_progress_bar,
         staging,
         netcdf_compression_enabled,
         netcdf_compression_level,
         netcdf3_compatible=netcdf3_compatible,
     )
+    blank_logger.info(response.model_dump_json(indent=2))
diff --git a/copernicusmarine/core_functions/get.py b/copernicusmarine/core_functions/get.py
index d8a99ad5..0c7608fc 100644
--- a/copernicusmarine/core_functions/get.py
+++ b/copernicusmarine/core_functions/get.py
@@ -2,7 +2,7 @@
 import logging
 import os
 import pathlib
-from typing import List, Optional
+from typing import Optional
 
 from copernicusmarine.catalogue_parser.request_structure import (
     GetRequest,
@@ -12,6 +12,7 @@
 from copernicusmarine.core_functions.credentials_utils import (
     get_and_check_username_password,
 )
+from copernicusmarine.core_functions.models import ResponseGet
 from copernicusmarine.core_functions.services_utils import (
     CommandType,
     RetrievalService,
@@ -48,9 +49,10 @@ def get_function(
     sync: bool,
     sync_delete: bool,
     index_parts: bool,
+    dry_run: bool,
     disable_progress_bar: bool,
     staging: bool,
-) -> List[pathlib.Path]:
+) -> ResponseGet:
     VersionVerifier.check_version_get(staging)
     if staging:
         logger.warning(
@@ -119,6 +121,8 @@ def get_function(
         direct_download_files = get_direct_download_files(file_list_path)
         if direct_download_files:
             get_request.direct_download = direct_download_files
+    if create_file_list or dry_run:
+        get_request.dry_run = True
 
     return _run_get_request(
         username=username,
@@ -139,7 +143,7 @@ def _run_get_request(
     credentials_file: Optional[pathlib.Path],
     disable_progress_bar: bool,
     staging: bool = False,
-) -> List[pathlib.Path]:
+) -> ResponseGet:
     logger.debug("Checking username and password...")
     username, password = get_and_check_username_password(
         username, password, credentials_file
diff --git a/copernicusmarine/core_functions/models.py b/copernicusmarine/core_functions/models.py
index efd6fed1..e345a610 100644
--- a/copernicusmarine/core_functions/models.py
+++ b/copernicusmarine/core_functions/models.py
@@ -1,4 +1,7 @@
-from typing import Literal, get_args
+import pathlib
+from typing import Literal, Optional, get_args
+
+from pydantic import BaseModel, model_serializer
 
 FileFormat = Literal["netcdf", "zarr"]
 DEFAULT_FILE_FORMAT: FileFormat = "netcdf"
@@ -15,3 +18,73 @@
 BoundingBoxMethod = Literal["inside", "nearest", "outside"]
 DEFAULT_BOUNDING_BOX_METHOD: BoundingBoxMethod = "inside"
 DEFAULT_BOUNDING_BOX_METHODS = list(get_args(BoundingBoxMethod))
+
+
+class FileGet(BaseModel):
+    #: Full url of the location of the file server side.
+    url: str
+    #: Size of the file in MB.
+    size: float
+    #: Last modified date.
+    last_modified: str
+    #: Path to the local downloaded file
+    output: pathlib.Path
+
+
+class ResponseGet(BaseModel):
+    """Metadata returned when using :func:`~copernicusmarine.get`"""
+
+    #: Description of the files concerned by the query
+    files: list[FileGet]
+
+
+class GeographicalExtent(BaseModel):
+    """Interval for geographical coordinates."""
+
+    minimum: Optional[float]
+    maximum: Optional[float]
+
+
+class TimeExtent(BaseModel):
+    """Interval for time coordinate."""
+
+    minimum: Optional[str]
+    maximum: Optional[str]
+
+
+class DatasetCoordinatesExtent(BaseModel):
+    #: Longitude Interval of the subsetted data.
+    longitude: GeographicalExtent
+    #: Latitude Interval of the subsetted data.
+    latitude: GeographicalExtent
+    #: Time Interval of the subsetted data in iso8601 string
+    time: TimeExtent
+    #: Depth Interval of the subsetted data.
+    depth: Optional[GeographicalExtent] = None
+    #: Elevation Interval of the subsetted data.
+    #: Is relevant if data are requested for elevation
+    #: instead of depth
+    elevation: Optional[GeographicalExtent] = None
+
+    @model_serializer(mode="wrap")
+    def _serialize(self, handler):
+        d = handler(self)
+        if not self.depth:
+            del d["depth"]
+        if not self.elevation:
+            del d["elevation"]
+        return d
+
+
+class ResponseSubset(BaseModel):
+    """Metadata returned when using :func:`~copernicusmarine.subset`"""
+
+    #: Path to the result file.
+    output: pathlib.Path
+    #: Estimation of the size of the final result file in MB.
+    size: Optional[float]
+    #: Estimation of the maximum amount of data needed to
+    #: get the final result in MB.
+    data_needed: Optional[float]
+    #: The bounds of the subsetted dataset.
+    coodinates_extent: DatasetCoordinatesExtent
diff --git a/copernicusmarine/core_functions/subset.py b/copernicusmarine/core_functions/subset.py
index ac9d5846..6ba64eae 100644
--- a/copernicusmarine/core_functions/subset.py
+++ b/copernicusmarine/core_functions/subset.py
@@ -18,6 +18,7 @@
 )
 from copernicusmarine.core_functions.models import (
     BoundingBoxMethod,
+    ResponseSubset,
     SubsetMethod,
 )
 from copernicusmarine.core_functions.services_utils import (
@@ -68,12 +69,13 @@ def subset_function(
     motu_api_request: Optional[str],
     force_download: bool,
     overwrite_output_data: bool,
+    dry_run: bool,
     disable_progress_bar: bool,
     staging: bool,
     netcdf_compression_enabled: bool,
     netcdf_compression_level: Optional[int],
     netcdf3_compatible: bool,
-) -> pathlib.Path:
+) -> ResponseSubset:
     VersionVerifier.check_version_subset(staging)
     if staging:
         logger.warning(
@@ -120,6 +122,7 @@ def subset_function(
         "netcdf_compression_enabled": netcdf_compression_enabled,
         "netcdf_compression_level": netcdf_compression_level,
         "netcdf3_compatible": netcdf3_compatible,
+        "dry_run": dry_run,
     }
     subset_request.update(request_update_dict)
     if not subset_request.dataset_id:
@@ -189,7 +192,7 @@ def subset_function(
             retrieval_service.service_format
             == CopernicusMarineServiceFormat.ZARR
         ):
-            output_path = download_zarr(
+            response = download_zarr(
                 username,
                 password,
                 subset_request,
@@ -200,7 +203,7 @@ def subset_function(
             )
     else:
         raise ServiceNotSupported(retrieval_service.service_type)
-    return output_path
+    return response
 
 
 def create_subset_template() -> None:
diff --git a/copernicusmarine/core_functions/utils.py b/copernicusmarine/core_functions/utils.py
index 57a3e70a..33b786b4 100644
--- a/copernicusmarine/core_functions/utils.py
+++ b/copernicusmarine/core_functions/utils.py
@@ -101,10 +101,6 @@ def next_or_raise_exception(
         raise exception_to_raise from exception
 
 
-def flatten(list: list[list[_T]]) -> list[_T]:
-    return [item for sublist in list for item in sublist]
-
-
 def construct_url_with_query_params(url, query_params: dict) -> Optional[str]:
     req = PreparedRequest()
     req.prepare_url(url, query_params)
diff --git a/copernicusmarine/download_functions/download_arco_series.py b/copernicusmarine/download_functions/download_arco_series.py
index d5dba516..b69933fd 100644
--- a/copernicusmarine/download_functions/download_arco_series.py
+++ b/copernicusmarine/download_functions/download_arco_series.py
@@ -9,7 +9,10 @@
 from copernicusmarine.catalogue_parser.models import CopernicusMarineService
 from copernicusmarine.catalogue_parser.request_structure import SubsetRequest
 from copernicusmarine.core_functions import custom_open_zarr
-from copernicusmarine.core_functions.models import BoundingBoxMethod
+from copernicusmarine.core_functions.models import (
+    BoundingBoxMethod,
+    ResponseSubset,
+)
 from copernicusmarine.core_functions.utils import (
     FORCE_DOWNLOAD_CLI_PROMPT_MESSAGE,
     add_copernicusmarine_version_in_dataset_attributes,
@@ -29,6 +32,9 @@
 from copernicusmarine.download_functions.subset_xarray import subset
 from copernicusmarine.download_functions.utils import (
     FileFormat,
+    get_approximation_size_data_downloaded,
+    get_approximation_size_final_result,
+    get_dataset_coordinates_extent,
     get_filename,
     get_message_formatted_dataset_size_estimation,
     timestamp_or_datestring_to_datetime,
@@ -77,9 +83,10 @@ def download_dataset(
     netcdf_compression_level: Optional[int],
     netcdf3_compatible: bool,
     service: CopernicusMarineService,
-    force_download: bool = False,
-    overwrite_output_data: bool = False,
-):
+    dry_run: bool,
+    force_download: bool,
+    overwrite_output_data: bool,
+) -> ResponseSubset:
     dataset = _rechunk(
         open_dataset_from_arco_series(
             username=username,
@@ -98,13 +105,20 @@ def download_dataset(
 
     filename = get_filename(output_filename, dataset, dataset_id, file_format)
     output_path = pathlib.Path(output_directory, filename)
+    final_result_size_estimation = get_approximation_size_final_result(dataset)
+    data_needed_approximation = get_approximation_size_data_downloaded(
+        dataset, service
+    )
+    message_formatted_dataset_size_estimation = (
+        get_message_formatted_dataset_size_estimation(
+            final_result_size_estimation, data_needed_approximation
+        )
+    )
     if not output_directory.is_dir():
         pathlib.Path.mkdir(output_directory, parents=True)
     if not force_download:
         logger.info(dataset)
-        logger.info(
-            get_message_formatted_dataset_size_estimation(dataset, service)
-        )
+        logger.info(message_formatted_dataset_size_estimation)
         click.confirm(
             FORCE_DOWNLOAD_CLI_PROMPT_MESSAGE,
             default=True,
@@ -112,15 +126,22 @@ def download_dataset(
             err=True,
         )
     else:
-        logger.info(
-            get_message_formatted_dataset_size_estimation(dataset, service)
-        )
-    logger.info("Writing to local storage. Please wait...")
+        logger.info(message_formatted_dataset_size_estimation)
 
     output_path = get_unique_filename(
         filepath=output_path, overwrite_option=overwrite_output_data
     )
+    response = ResponseSubset(
+        output=output_path,
+        size=final_result_size_estimation,
+        data_needed=data_needed_approximation,
+        coodinates_extent=get_dataset_coordinates_extent(dataset),
+    )
 
+    if dry_run:
+        return response
+
+    logger.info("Writing to local storage. Please wait...")
     delayed = get_delayed_download(
         dataset,
         output_path,
@@ -131,7 +152,7 @@ def download_dataset(
     download_delayed_dataset(delayed, disable_progress_bar)
     logger.info(f"Successfully downloaded to {output_path}")
 
-    return output_path
+    return response
 
 
 def download_zarr(
@@ -142,7 +163,7 @@ def download_zarr(
     disable_progress_bar: bool,
     dataset_valid_start_date: Optional[Union[str, int]],
     service: CopernicusMarineService,
-):
+) -> ResponseSubset:
     geographical_parameters = GeographicalParameters(
         latitude_parameters=LatitudeParameters(
             minimum_latitude=subset_request.minimum_latitude,
@@ -182,7 +203,7 @@ def download_zarr(
     variables = subset_request.variables
     force_download = subset_request.force_download
 
-    output_path = download_dataset(
+    response = download_dataset(
         username=username,
         password=password,
         dataset_id=dataset_id,
@@ -201,9 +222,10 @@ def download_zarr(
         netcdf_compression_enabled=subset_request.netcdf_compression_enabled,
         netcdf_compression_level=subset_request.netcdf_compression_level,
         netcdf3_compatible=subset_request.netcdf3_compatible,
+        dry_run=subset_request.dry_run,
         service=service,
     )
-    return output_path
+    return response
 
 
 def open_dataset_from_arco_series(
diff --git a/copernicusmarine/download_functions/download_original_files.py b/copernicusmarine/download_functions/download_original_files.py
index 49b3c632..c274f6a7 100644
--- a/copernicusmarine/download_functions/download_original_files.py
+++ b/copernicusmarine/download_functions/download_original_files.py
@@ -21,12 +21,12 @@
 from copernicusmarine.core_functions.environment_variables import (
     COPERNICUSMARINE_GET_CONCURRENT_DOWNLOADS,
 )
+from copernicusmarine.core_functions.models import FileGet, ResponseGet
 from copernicusmarine.core_functions.sessions import (
     get_configured_boto3_session,
 )
 from copernicusmarine.core_functions.utils import (
     FORCE_DOWNLOAD_CLI_PROMPT_MESSAGE,
-    flatten,
     get_unique_filename,
     parse_access_dataset_url,
     timestamp_parser,
@@ -48,7 +48,7 @@ def download_original_files(
     get_request: GetRequest,
     disable_progress_bar: bool,
     create_file_list: Optional[str],
-) -> list[pathlib.Path]:
+) -> ResponseGet:
     files_not_found: list[str] = []
     filenames_in_sync_ignored: list[str] = []
     total_size: float = 0.0
@@ -110,7 +110,7 @@ def download_original_files(
         elif not get_request.direct_download or len(files_not_found) == len(
             get_request.direct_download
         ):
-            return []
+            return ResponseGet(files=[])
     message = _create_information_message_before_download(
         filenames_in, sizes, last_modified_datetimes, total_size
     )
@@ -124,6 +124,22 @@ def download_original_files(
             else False
         ),
     )
+    response = ResponseGet(
+        files=[
+            FileGet(
+                url=s3_url,
+                size=size_to_MB(size),
+                last_modified=last_modified.to_iso8601_string(),
+                output=filename_out,
+            )
+            for s3_url, size, last_modified, filename_out in zip(
+                filenames_in,
+                sizes,
+                last_modified_datetimes,
+                filenames_out,
+            )
+        ]
+    )
     if not get_request.force_download and total_size:
         logger.info(message)
     if get_request.show_outputnames:
@@ -150,7 +166,7 @@ def download_original_files(
     if not total_size:
         logger.info("No data to download")
         if not files_to_delete:
-            return []
+            return ResponseGet(files=[])
     if not get_request.force_download:
         click.confirm(
             FORCE_DOWNLOAD_CLI_PROMPT_MESSAGE,
@@ -164,7 +180,9 @@ def download_original_files(
     if get_request.sync_delete and files_to_delete:
         for file_to_delete in files_to_delete:
             file_to_delete.unlink()
-    return download_files(
+    if get_request.dry_run:
+        return response
+    download_files(
         username,
         endpoint,
         bucket,
@@ -172,6 +190,7 @@ def download_original_files(
         filenames_out,
         disable_progress_bar,
     )
+    return response
 
 
 def _get_files_to_delete_with_sync(
@@ -199,7 +218,7 @@ def download_files(
     filenames_in: List[str],
     filenames_out: List[pathlib.Path],
     disable_progress_bar: bool,
-) -> list[pathlib.Path]:
+) -> None:
     nfiles_per_process, nfiles = 1, len(filenames_in)
     indexes = append(
         arange(0, nfiles, nfiles_per_process, dtype=int),
@@ -246,14 +265,13 @@ def download_files(
                 groups_out_files,
             ),
         )
-    download_summary = list(
+    list(
         tqdm(
             download_summary_list,
             total=len(groups_in_files),
             disable=disable_progress_bar,
         )
     )
-    return flatten(download_summary)
 
 
 def _download_header(
@@ -637,3 +655,7 @@ def format_file_size(
         size /= step
 
     return ("%." + str(decimals) + "f %s") % (size, largest_unit)
+
+
+def size_to_MB(size: float) -> float:
+    return size / 1024**2
diff --git a/copernicusmarine/download_functions/utils.py b/copernicusmarine/download_functions/utils.py
index 8245c8e9..838a6cc1 100644
--- a/copernicusmarine/download_functions/utils.py
+++ b/copernicusmarine/download_functions/utils.py
@@ -2,7 +2,7 @@
 import logging
 import math
 from pathlib import Path
-from typing import Optional
+from typing import Any, Optional
 
 import xarray
 from pendulum import DateTime
@@ -13,7 +13,10 @@
 )
 from copernicusmarine.core_functions.models import (
     DEFAULT_FILE_EXTENSIONS,
+    DatasetCoordinatesExtent,
     FileFormat,
+    GeographicalExtent,
+    TimeExtent,
 )
 from copernicusmarine.core_functions.utils import (
     timestamp_or_datestring_to_datetime,
@@ -95,14 +98,14 @@ def _build_filename_from_dataset(
     return filename + get_file_extension(file_format)
 
 
-def _get_min_coordinate(dataset: xarray.Dataset, coordinate: str):
+def _get_min_coordinate(dataset: xarray.Dataset, coordinate: str) -> Any:
     for coord_label in COORDINATES_LABEL[coordinate]:
         if coord_label in dataset.sizes:
             return min(dataset[coord_label].values)
     return None
 
 
-def _get_max_coordinate(dataset: xarray.Dataset, coordinate: str):
+def _get_max_coordinate(dataset: xarray.Dataset, coordinate: str) -> Any:
     for coord_label in COORDINATES_LABEL[coordinate]:
         if coord_label in dataset.sizes:
             return max(dataset[coord_label].values)
@@ -176,13 +179,65 @@ def _format_datetimes(
         return formatted_datetime
 
 
-def get_message_formatted_dataset_size_estimation(
+def get_dataset_coordinates_extent(
     dataset: xarray.Dataset,
-    service: CopernicusMarineService,
+) -> DatasetCoordinatesExtent:
+    minimum_time = _get_min_coordinate(dataset, "time")
+    if minimum_time:
+        minimum_time = timestamp_or_datestring_to_datetime(
+            minimum_time
+        ).to_iso8601_string()
+    maximum_time = _get_max_coordinate(dataset, "time")
+    if maximum_time:
+        maximum_time = timestamp_or_datestring_to_datetime(
+            maximum_time
+        ).to_iso8601_string()
+    coordinates_extent = DatasetCoordinatesExtent(
+        longitude=GeographicalExtent(
+            minimum=_get_min_coordinate(dataset, "longitude"),
+            maximum=_get_max_coordinate(dataset, "longitude"),
+        ),
+        latitude=GeographicalExtent(
+            minimum=_get_min_coordinate(dataset, "latitude"),
+            maximum=_get_max_coordinate(dataset, "latitude"),
+        ),
+        time=TimeExtent(
+            minimum=minimum_time,
+            maximum=maximum_time,
+        ),
+    )
+    if "depth" in dataset.sizes:
+        coordinates_extent.depth = GeographicalExtent(
+            minimum=_get_min_coordinate(dataset, "depth"),
+            maximum=_get_max_coordinate(dataset, "depth"),
+        )
+    elif "elevation" in dataset.sizes:
+        coordinates_extent.elevation = GeographicalExtent(
+            minimum=_get_min_coordinate(dataset, "depth"),
+            maximum=_get_max_coordinate(dataset, "depth"),
+        )
+    return coordinates_extent
+
+
+def get_message_formatted_dataset_size_estimation(
+    estimation_size_final_result: Optional[float],
+    estimation_data_downloaded: Optional[float],
 ) -> str:
-    # TODO: probably should try except this
-    # We don't want this to block the user if it fails
-    estimated_size_message = "Estimated size of the dataset file is "
+    return (
+        f"Estimated size of the dataset file is "
+        f"{estimation_size_final_result:.3f} MB"
+        f"\nEstimated size of the data that needs "
+        f"to be downloaded to obtain the result:"
+        f" {estimation_data_downloaded:.0f} MB"
+        "\nThis a very rough estimation and usually"
+        " its higher than the actual size of the"
+        " data that needs to be downloaded."
+    )
+
+
+def get_approximation_size_final_result(
+    dataset: xarray.Dataset,
+) -> Optional[float]:
     coordinates_size = 1
     for coordinate_name in dataset.sizes:
         coordinates_size *= dataset[coordinate_name].size
@@ -192,8 +247,12 @@ def get_message_formatted_dataset_size_estimation(
         * dataset[list(dataset.data_vars)[0]].dtype.itemsize
         / 1048e3
     )
-    estimated_size_message += f"{estimate_size:.3f} MB"
+    return estimate_size
+
 
+def get_approximation_size_data_downloaded(
+    dataset: xarray.Dataset, service: CopernicusMarineService
+) -> Optional[float]:
     temp_dataset = dataset.copy()
     if "elevation" in dataset.sizes:
         temp_dataset["elevation"] = temp_dataset.elevation * (-1)
@@ -227,7 +286,7 @@ def get_message_formatted_dataset_size_estimation(
                 temp_dataset, coordinate, chunking_length
             )
             if number_of_chunks_needed is None:
-                return early_exit_message(estimated_size_message)
+                return None
             coordinates_size *= number_of_chunks_needed * chunking_length
         download_estimated_size += (
             coordinates_size
@@ -235,17 +294,7 @@ def get_message_formatted_dataset_size_estimation(
             / 1048e3
         )
 
-    estimated_size_message += (
-        f"\nEstimated size of the data that needs "
-        f"to be downloaded to obtain the result:"
-        f" {download_estimated_size:.0f} MB"
-    )
-    estimated_size_message += (
-        "\nThis a very rough estimation and usually"
-        " its higher than the actual size of the"
-        " data that needs to be downloaded."
-    )
-    return estimated_size_message
+    return download_estimated_size
 
 
 def get_number_of_chunks_for_coordinate(
diff --git a/copernicusmarine/python_interface/get.py b/copernicusmarine/python_interface/get.py
index 741c2720..82d946da 100644
--- a/copernicusmarine/python_interface/get.py
+++ b/copernicusmarine/python_interface/get.py
@@ -1,5 +1,5 @@
 import pathlib
-from typing import List, Optional, Union
+from typing import Optional, Union
 
 from copernicusmarine.core_functions.deprecated import (
     deprecated_python_option,
@@ -10,6 +10,7 @@
     DEPRECATED_OPTIONS,
 )
 from copernicusmarine.core_functions.get import get_function
+from copernicusmarine.core_functions.models import ResponseGet
 from copernicusmarine.python_interface.exception_handler import (
     log_exception_and_exit,
 )
@@ -39,9 +40,10 @@ def get(
     index_parts: bool = False,
     sync: bool = False,
     sync_delete: bool = False,
+    dry_run: bool = False,
     disable_progress_bar: bool = False,
     staging: bool = False,
-) -> List[pathlib.Path]:
+) -> ResponseGet:
     """
     Fetches data from the Copernicus Marine server based on the provided parameters.
 
@@ -85,6 +87,10 @@ def get(
     :type sync: bool, optional
     :param sync_delete: If True, delete local files that are not present on the remote server while applying sync.
     :type sync_delete: bool, optional
+    :param dry_run: If True, runs query without downloading data..
+    :type dry_run: bool, optional
+    :param disable_progress_bar: Flag to hide progress bar.
+    :type disable_progress_bar: bool, optional
 
     :returns: A list of paths to the downloaded files.
     :rtype: List[pathlib.Path]
@@ -131,6 +137,7 @@ def get(
         index_parts=index_parts,
         sync=sync,
         sync_delete=sync_delete,
+        dry_run=dry_run,
         disable_progress_bar=disable_progress_bar,
         staging=staging,
     )
diff --git a/copernicusmarine/python_interface/subset.py b/copernicusmarine/python_interface/subset.py
index bb8ac324..a71bf10d 100644
--- a/copernicusmarine/python_interface/subset.py
+++ b/copernicusmarine/python_interface/subset.py
@@ -12,6 +12,7 @@
     DEFAULT_SUBSET_METHOD,
     BoundingBoxMethod,
     FileFormat,
+    ResponseSubset,
     SubsetMethod,
 )
 from copernicusmarine.core_functions.subset import subset_function
@@ -50,12 +51,13 @@ def subset(
     motu_api_request: Optional[str] = None,
     force_download: bool = False,
     overwrite_output_data: bool = False,
+    dry_run: bool = False,
     disable_progress_bar: bool = False,
     staging: bool = False,
     netcdf_compression_enabled: bool = False,
     netcdf_compression_level: Optional[int] = None,
     netcdf3_compatible: bool = False,
-) -> pathlib.Path:
+) -> ResponseSubset:
     """
     Extracts a subset of data from a specified dataset using given parameters.
 
@@ -111,6 +113,8 @@ def subset(
     :type file_format: str, optional
     :param motu_api_request: MOTU API request string.
     :type motu_api_request: str, optional
+    :param dry_run: If True, runs query without downloading data.
+    :type dry_run: bool, optional
     :param netcdf_compression_enabled: Enable compression level 1 to the NetCDF output file. Use 'netcdf_compression_level' option to customize the compression level.
     :type netcdf_compression_enabled: bool, optional
     :param netcdf_compression_level: Specify a compression level to apply on the NetCDF output file. A value of 0 means no compression, and 9 is the highest level of compression available.
@@ -118,8 +122,8 @@ def subset(
     :param netcdf3_compatible: Enable downloading the dataset in a netCDF 3 compatible format.
     :type netcdf3_compatible: bool, optional
 
-    :returns: Path to the generated subsetted data file.
-    :rtype: pathlib.Path
+    :returns: A description of the downloaded data and its destination
+    :rtype: ResponseSubset
     """  # noqa
     request_file = pathlib.Path(request_file) if request_file else None
     output_directory = (
@@ -159,6 +163,7 @@ def subset(
         motu_api_request,
         force_download,
         overwrite_output_data,
+        dry_run,
         disable_progress_bar,
         staging=staging,
         netcdf_compression_enabled=netcdf_compression_enabled,
diff --git a/doc/_build/doctrees/environment.pickle b/doc/_build/doctrees/environment.pickle
index b4f2cc4c33af61dc04b507689b9747538a0ee127..7b53938fd68a5cd7713eabb4f9d34ce04133514a 100644
GIT binary patch
literal 62201
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

literal 42150
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
S9rcweJ26`nDPqHgng0)g>jky|

diff --git a/doc/_build/doctrees/index.doctree b/doc/_build/doctrees/index.doctree
index 3bad08cd7e6c9055549f9dd68c61c3213f4db619..7eea22ce5fe2a67ea096349d7b06ccff5d60faab 100644
GIT binary patch
delta 105
zcmZ3da!Q4zfpx0=MwWLR;(k3MrNxQqsrp5!#Rd6!#i{Wnl?AEAlizd5F=Z^9%*$EN
zxMp)NrxP>dyUiDP9x$sO%-EMvlTlgP!<m<un+jGurFM!&#=*{vnvT*8Nf3MA=Bomc
Fi~x2PDs%t<

delta 62
zcmV-E0KxytB(5X`fCZH!u>|f2lMD$PlPL**0jjg92|@z_?6d3)-~$7{XuOlp5ETu-
UiD-O?b!ZuVlqhJtv+)pF0nXSM6951J

diff --git a/doc/_build/doctrees/usage/command-line-interface.doctree b/doc/_build/doctrees/usage/command-line-interface.doctree
index 8af8963008a93dde12202a946c85983033e92607..94d71ed95f6b357fe9f31bb68a66bc0761012967 100644
GIT binary patch
delta 12226
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
JJaZUk{5Q=98x;Tm

delta 10103
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

diff --git a/doc/_build/doctrees/usage/python-interface.doctree b/doc/_build/doctrees/usage/python-interface.doctree
index 924f7e715f8204051c259e26a7391a81b5ca4698..491d07ab5ba13c4a6a3ac4aa225de16cd2fbaab6 100644
GIT binary patch
literal 314202
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
X&;4Mw%&@>+QDQ1DE_fz|A13}2Y1{mY

delta 38757
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
W9(uD+VM#9jyE(V4{2SgO>i+>jaJi8H

diff --git a/doc/_build/doctrees/usage/response_types.doctree b/doc/_build/doctrees/usage/response_types.doctree
new file mode 100644
index 0000000000000000000000000000000000000000..4077a3615821fb0b8efc41c8764096bd0a251970
GIT binary patch
literal 49110
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

literal 0
HcmV?d00001

diff --git a/doc/_build/html/_sources/index.rst.txt b/doc/_build/html/_sources/index.rst.txt
index 85c4f95a..22c8531e 100644
--- a/doc/_build/html/_sources/index.rst.txt
+++ b/doc/_build/html/_sources/index.rst.txt
@@ -19,3 +19,4 @@ documentation for details.
    usage/quickstart
    usage/command-line-interface
    usage/python-interface
+   usage/response_types
diff --git a/doc/_build/html/_sources/usage/response_types.rst.txt b/doc/_build/html/_sources/usage/response_types.rst.txt
new file mode 100644
index 00000000..9a6793fe
--- /dev/null
+++ b/doc/_build/html/_sources/usage/response_types.rst.txt
@@ -0,0 +1,63 @@
+=================
+Response Types
+=================
+
+The Copernicus Marine Toolbox commands return some information about the download.
+It can contain useful metadata for the user.
+
+For the CLI, all the returned data will be in a form of a json sent to stdout.
+You can easily save it locally by doing, for example:
+
+.. code-block:: bash
+
+    copernicusmarine get -i cmems_mod_glo_phy-thetao_anfc_0.083deg_P1M-m > my_json.json
+
+
+.. note::
+   For the "get" and "subset" commands you can get those metadata without
+   downloading anything by using the ``dry_run`` option (or ``--dry-run`` flag for the CLI).
+
+-------------------
+Commands Response
+-------------------
+
+.. autoclass:: copernicusmarine.ResponseGet()
+    :members:
+    :undoc-members:
+    :exclude-members: model_computed_fields, model_config, model_fields
+    :member-order: bysource
+
+.. autoclass:: copernicusmarine.ResponseSubset()
+    :members:
+    :undoc-members:
+    :exclude-members: model_computed_fields, model_config, model_fields
+    :member-order: bysource
+
+--------------
+Subtypes
+--------------
+
+.. autoclass:: copernicusmarine.FileGet()
+    :members:
+    :undoc-members:
+    :exclude-members: model_computed_fields, model_config, model_fields
+    :member-order: bysource
+
+.. autoclass:: copernicusmarine.DatasetCoordinatesExtent()
+    :members:
+    :undoc-members:
+    :exclude-members: model_computed_fields, model_config, model_fields
+    :member-order: bysource
+
+
+.. autoclass:: copernicusmarine.GeographicalExtent()
+    :members:
+    :undoc-members:
+    :exclude-members: model_computed_fields, model_config, model_fields
+    :member-order: bysource
+
+.. autoclass:: copernicusmarine.TimeExtent()
+    :members:
+    :undoc-members:
+    :exclude-members: model_computed_fields, model_config, model_fields
+    :member-order: bysource
diff --git a/doc/_build/html/genindex.html b/doc/_build/html/genindex.html
index 55945b85..80c30bbe 100644
--- a/doc/_build/html/genindex.html
+++ b/doc/_build/html/genindex.html
@@ -202,6 +202,7 @@
 <li class="toctree-l1"><a class="reference internal" href="usage/quickstart.html">Quick Start</a></li>
 <li class="toctree-l1"><a class="reference internal" href="usage/command-line-interface.html">CLI</a></li>
 <li class="toctree-l1"><a class="reference internal" href="usage/python-interface.html">Python Interface</a></li>
+<li class="toctree-l1"><a class="reference internal" href="usage/response_types.html">Response Types</a></li>
 </ul>
 
 </div>
@@ -239,13 +240,20 @@
 
 <section class="genindex-section">
   <h1 id="index">Index</h1>
-  <div class="genindex-jumpbox"><a href="#Symbols"><strong>Symbols</strong></a> | <a href="#C"><strong>C</strong></a> | <a href="#D"><strong>D</strong></a> | <a href="#G"><strong>G</strong></a> | <a href="#L"><strong>L</strong></a> | <a href="#M"><strong>M</strong></a> | <a href="#O"><strong>O</strong></a> | <a href="#R"><strong>R</strong></a> | <a href="#S"><strong>S</strong></a></div>
+  <div class="genindex-jumpbox"><a href="#Symbols"><strong>Symbols</strong></a> | <a href="#C"><strong>C</strong></a> | <a href="#D"><strong>D</strong></a> | <a href="#E"><strong>E</strong></a> | <a href="#F"><strong>F</strong></a> | <a href="#G"><strong>G</strong></a> | <a href="#L"><strong>L</strong></a> | <a href="#M"><strong>M</strong></a> | <a href="#O"><strong>O</strong></a> | <a href="#R"><strong>R</strong></a> | <a href="#S"><strong>S</strong></a> | <a href="#T"><strong>T</strong></a> | <a href="#U"><strong>U</strong></a></div>
 </section>
 <section id="Symbols" class="genindex-section">
   <h2>Symbols</h2>
   <table style="width: 100%" class="indextable genindextable"><tr>
     <td style="width: 33%; vertical-align: top;"><ul>
         <li>
+    --bounding-box-method
+
+        <ul>
+          <li><a href="usage/command-line-interface.html#cmdoption-copernicusmarine-subset-bounding-box-method">copernicusmarine-subset command line option</a>
+</li>
+        </ul></li>
+        <li>
     --configuration-file-directory
 
         <ul>
@@ -320,6 +328,15 @@ <h2>Symbols</h2>
           <li><a href="usage/command-line-interface.html#cmdoption-copernicusmarine-get-disable-progress-bar">copernicusmarine-get command line option</a>
 </li>
           <li><a href="usage/command-line-interface.html#cmdoption-copernicusmarine-subset-disable-progress-bar">copernicusmarine-subset command line option</a>
+</li>
+        </ul></li>
+        <li>
+    --dry-run
+
+        <ul>
+          <li><a href="usage/command-line-interface.html#cmdoption-copernicusmarine-get-dry-run">copernicusmarine-get command line option</a>
+</li>
+          <li><a href="usage/command-line-interface.html#cmdoption-copernicusmarine-subset-dry-run">copernicusmarine-subset command line option</a>
 </li>
         </ul></li>
         <li>
@@ -546,6 +563,8 @@ <h2>Symbols</h2>
           <li><a href="usage/command-line-interface.html#cmdoption-copernicusmarine-subset-x">copernicusmarine-subset command line option</a>
 </li>
         </ul></li>
+    </ul></td>
+    <td style="width: 33%; vertical-align: top;"><ul>
         <li>
     --motu-api-request
 
@@ -553,8 +572,6 @@ <h2>Symbols</h2>
           <li><a href="usage/command-line-interface.html#cmdoption-copernicusmarine-subset-motu-api-request">copernicusmarine-subset command line option</a>
 </li>
         </ul></li>
-    </ul></td>
-    <td style="width: 33%; vertical-align: top;"><ul>
         <li>
     --netcdf-compression-enabled
 
@@ -874,6 +891,8 @@ <h2>Symbols</h2>
   <h2>C</h2>
   <table style="width: 100%" class="indextable genindextable"><tr>
     <td style="width: 33%; vertical-align: top;"><ul>
+        <li><a href="usage/response_types.html#copernicusmarine.ResponseSubset.coodinates_extent">coodinates_extent (copernicusmarine.ResponseSubset attribute)</a>
+</li>
         <li>
     copernicusmarine
 
@@ -934,6 +953,8 @@ <h2>C</h2>
           <li><a href="usage/command-line-interface.html#cmdoption-copernicusmarine-get-dataset-version">--dataset-version</a>
 </li>
           <li><a href="usage/command-line-interface.html#cmdoption-copernicusmarine-get-disable-progress-bar">--disable-progress-bar</a>
+</li>
+          <li><a href="usage/command-line-interface.html#cmdoption-copernicusmarine-get-dry-run">--dry-run</a>
 </li>
           <li><a href="usage/command-line-interface.html#cmdoption-copernicusmarine-get-file-list">--file-list</a>
 </li>
@@ -1013,6 +1034,8 @@ <h2>C</h2>
     copernicusmarine-subset command line option
 
         <ul>
+          <li><a href="usage/command-line-interface.html#cmdoption-copernicusmarine-subset-bounding-box-method">--bounding-box-method</a>
+</li>
           <li><a href="usage/command-line-interface.html#cmdoption-copernicusmarine-subset-create-template">--create-template</a>
 </li>
           <li><a href="usage/command-line-interface.html#cmdoption-copernicusmarine-subset-credentials-file">--credentials-file</a>
@@ -1024,6 +1047,8 @@ <h2>C</h2>
           <li><a href="usage/command-line-interface.html#cmdoption-copernicusmarine-subset-dataset-version">--dataset-version</a>
 </li>
           <li><a href="usage/command-line-interface.html#cmdoption-copernicusmarine-subset-disable-progress-bar">--disable-progress-bar</a>
+</li>
+          <li><a href="usage/command-line-interface.html#cmdoption-copernicusmarine-subset-dry-run">--dry-run</a>
 </li>
           <li><a href="usage/command-line-interface.html#cmdoption-copernicusmarine-subset-T">--end-datetime</a>
 </li>
@@ -1130,15 +1155,51 @@ <h2>C</h2>
   <h2>D</h2>
   <table style="width: 100%" class="indextable genindextable"><tr>
     <td style="width: 33%; vertical-align: top;"><ul>
+        <li><a href="usage/response_types.html#copernicusmarine.ResponseSubset.data_needed">data_needed (copernicusmarine.ResponseSubset attribute)</a>
+</li>
+        <li><a href="usage/response_types.html#copernicusmarine.DatasetCoordinatesExtent">DatasetCoordinatesExtent (class in copernicusmarine)</a>
+</li>
+    </ul></td>
+    <td style="width: 33%; vertical-align: top;"><ul>
+        <li><a href="usage/response_types.html#copernicusmarine.DatasetCoordinatesExtent.depth">depth (copernicusmarine.DatasetCoordinatesExtent attribute)</a>
+</li>
         <li><a href="usage/python-interface.html#copernicusmarine.describe">describe() (in module copernicusmarine)</a>
 </li>
     </ul></td>
   </tr></table>
 </section>
 
+<section id="E" class="genindex-section">
+  <h2>E</h2>
+  <table style="width: 100%" class="indextable genindextable"><tr>
+    <td style="width: 33%; vertical-align: top;"><ul>
+        <li><a href="usage/response_types.html#copernicusmarine.DatasetCoordinatesExtent.elevation">elevation (copernicusmarine.DatasetCoordinatesExtent attribute)</a>
+</li>
+    </ul></td>
+  </tr></table>
+</section>
+
+<section id="F" class="genindex-section">
+  <h2>F</h2>
+  <table style="width: 100%" class="indextable genindextable"><tr>
+    <td style="width: 33%; vertical-align: top;"><ul>
+        <li><a href="usage/response_types.html#copernicusmarine.FileGet">FileGet (class in copernicusmarine)</a>
+</li>
+    </ul></td>
+    <td style="width: 33%; vertical-align: top;"><ul>
+        <li><a href="usage/response_types.html#copernicusmarine.ResponseGet.files">files (copernicusmarine.ResponseGet attribute)</a>
+</li>
+    </ul></td>
+  </tr></table>
+</section>
+
 <section id="G" class="genindex-section">
   <h2>G</h2>
   <table style="width: 100%" class="indextable genindextable"><tr>
+    <td style="width: 33%; vertical-align: top;"><ul>
+        <li><a href="usage/response_types.html#copernicusmarine.GeographicalExtent">GeographicalExtent (class in copernicusmarine)</a>
+</li>
+    </ul></td>
     <td style="width: 33%; vertical-align: top;"><ul>
         <li><a href="usage/python-interface.html#copernicusmarine.get">get() (in module copernicusmarine)</a>
 </li>
@@ -1149,8 +1210,16 @@ <h2>G</h2>
 <section id="L" class="genindex-section">
   <h2>L</h2>
   <table style="width: 100%" class="indextable genindextable"><tr>
+    <td style="width: 33%; vertical-align: top;"><ul>
+        <li><a href="usage/response_types.html#copernicusmarine.FileGet.last_modified">last_modified (copernicusmarine.FileGet attribute)</a>
+</li>
+        <li><a href="usage/response_types.html#copernicusmarine.DatasetCoordinatesExtent.latitude">latitude (copernicusmarine.DatasetCoordinatesExtent attribute)</a>
+</li>
+    </ul></td>
     <td style="width: 33%; vertical-align: top;"><ul>
         <li><a href="usage/python-interface.html#copernicusmarine.login">login() (in module copernicusmarine)</a>
+</li>
+        <li><a href="usage/response_types.html#copernicusmarine.DatasetCoordinatesExtent.longitude">longitude (copernicusmarine.DatasetCoordinatesExtent attribute)</a>
 </li>
     </ul></td>
   </tr></table>
@@ -1159,6 +1228,20 @@ <h2>L</h2>
 <section id="M" class="genindex-section">
   <h2>M</h2>
   <table style="width: 100%" class="indextable genindextable"><tr>
+    <td style="width: 33%; vertical-align: top;"><ul>
+        <li><a href="usage/response_types.html#copernicusmarine.GeographicalExtent.maximum">maximum (copernicusmarine.GeographicalExtent attribute)</a>
+
+        <ul>
+          <li><a href="usage/response_types.html#copernicusmarine.TimeExtent.maximum">(copernicusmarine.TimeExtent attribute)</a>
+</li>
+        </ul></li>
+        <li><a href="usage/response_types.html#copernicusmarine.GeographicalExtent.minimum">minimum (copernicusmarine.GeographicalExtent attribute)</a>
+
+        <ul>
+          <li><a href="usage/response_types.html#copernicusmarine.TimeExtent.minimum">(copernicusmarine.TimeExtent attribute)</a>
+</li>
+        </ul></li>
+    </ul></td>
     <td style="width: 33%; vertical-align: top;"><ul>
         <li>
     module
@@ -1178,6 +1261,14 @@ <h2>O</h2>
         <li><a href="usage/python-interface.html#copernicusmarine.open_dataset">open_dataset() (in module copernicusmarine)</a>
 </li>
     </ul></td>
+    <td style="width: 33%; vertical-align: top;"><ul>
+        <li><a href="usage/response_types.html#copernicusmarine.FileGet.output">output (copernicusmarine.FileGet attribute)</a>
+
+        <ul>
+          <li><a href="usage/response_types.html#copernicusmarine.ResponseSubset.output">(copernicusmarine.ResponseSubset attribute)</a>
+</li>
+        </ul></li>
+    </ul></td>
   </tr></table>
 </section>
 
@@ -1186,6 +1277,12 @@ <h2>R</h2>
   <table style="width: 100%" class="indextable genindextable"><tr>
     <td style="width: 33%; vertical-align: top;"><ul>
         <li><a href="usage/python-interface.html#copernicusmarine.read_dataframe">read_dataframe() (in module copernicusmarine)</a>
+</li>
+    </ul></td>
+    <td style="width: 33%; vertical-align: top;"><ul>
+        <li><a href="usage/response_types.html#copernicusmarine.ResponseGet">ResponseGet (class in copernicusmarine)</a>
+</li>
+        <li><a href="usage/response_types.html#copernicusmarine.ResponseSubset">ResponseSubset (class in copernicusmarine)</a>
 </li>
     </ul></td>
   </tr></table>
@@ -1194,6 +1291,14 @@ <h2>R</h2>
 <section id="S" class="genindex-section">
   <h2>S</h2>
   <table style="width: 100%" class="indextable genindextable"><tr>
+    <td style="width: 33%; vertical-align: top;"><ul>
+        <li><a href="usage/response_types.html#copernicusmarine.FileGet.size">size (copernicusmarine.FileGet attribute)</a>
+
+        <ul>
+          <li><a href="usage/response_types.html#copernicusmarine.ResponseSubset.size">(copernicusmarine.ResponseSubset attribute)</a>
+</li>
+        </ul></li>
+    </ul></td>
     <td style="width: 33%; vertical-align: top;"><ul>
         <li><a href="usage/python-interface.html#copernicusmarine.subset">subset() (in module copernicusmarine)</a>
 </li>
@@ -1201,6 +1306,30 @@ <h2>S</h2>
   </tr></table>
 </section>
 
+<section id="T" class="genindex-section">
+  <h2>T</h2>
+  <table style="width: 100%" class="indextable genindextable"><tr>
+    <td style="width: 33%; vertical-align: top;"><ul>
+        <li><a href="usage/response_types.html#copernicusmarine.DatasetCoordinatesExtent.time">time (copernicusmarine.DatasetCoordinatesExtent attribute)</a>
+</li>
+    </ul></td>
+    <td style="width: 33%; vertical-align: top;"><ul>
+        <li><a href="usage/response_types.html#copernicusmarine.TimeExtent">TimeExtent (class in copernicusmarine)</a>
+</li>
+    </ul></td>
+  </tr></table>
+</section>
+
+<section id="U" class="genindex-section">
+  <h2>U</h2>
+  <table style="width: 100%" class="indextable genindextable"><tr>
+    <td style="width: 33%; vertical-align: top;"><ul>
+        <li><a href="usage/response_types.html#copernicusmarine.FileGet.url">url (copernicusmarine.FileGet attribute)</a>
+</li>
+    </ul></td>
+  </tr></table>
+</section>
+
 
         </article>
       </div>
diff --git a/doc/_build/html/index.html b/doc/_build/html/index.html
index f27ca9fc..0bbd7c40 100644
--- a/doc/_build/html/index.html
+++ b/doc/_build/html/index.html
@@ -204,6 +204,7 @@
 <li class="toctree-l1"><a class="reference internal" href="usage/quickstart.html">Quick Start</a></li>
 <li class="toctree-l1"><a class="reference internal" href="usage/command-line-interface.html">CLI</a></li>
 <li class="toctree-l1"><a class="reference internal" href="usage/python-interface.html">Python Interface</a></li>
+<li class="toctree-l1"><a class="reference internal" href="usage/response_types.html">Response Types</a></li>
 </ul>
 
 </div>
@@ -273,6 +274,11 @@ <h1>Copernicus Marine Toolbox documentation<a class="headerlink" href="#copernic
 <li class="toctree-l2"><a class="reference internal" href="usage/python-interface.html#copernicusmarine.subset"><code class="docutils literal notranslate"><span class="pre">subset()</span></code></a></li>
 </ul>
 </li>
+<li class="toctree-l1"><a class="reference internal" href="usage/response_types.html">Response Types</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="usage/response_types.html#commands-response">Commands Response</a></li>
+<li class="toctree-l2"><a class="reference internal" href="usage/response_types.html#subtypes">Subtypes</a></li>
+</ul>
+</li>
 </ul>
 </div>
 </section>
diff --git a/doc/_build/html/objects.inv b/doc/_build/html/objects.inv
index c1fd9725ff9cdb9212a81084c1eafb9432dadaa9..10410cf81e0f9db8ca2358179781c36ddcb14e12 100644
GIT binary patch
delta 1668
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
O*~z0jw)h`S6*<rLn@g$y

delta 1322
zcmV+_1=afb4WSE=h<}?+kJ~B~hWGgumhRm$_g39?+to<7Qmc-twwsCoanN9J0q0|W
z{l#EA@g&By$-&)C{PDhz`8tQ=F;O+sl9R?%SaZpW`uMI=v=OZMw`dG5*+2EsZk0q_
zTBbLcu!pU!#9!ee^ml<)<dwz)Wrk?J_F|hx63dk=-bCfD>VK5X-YOwf$>psg?zj9w
zvBl<gAk8rKS{se4n_I{<>)V-7-(L?15hX3=(iFzhcch}K9*GiFRajCa+S^`94_Bi}
z14L%*DK~iShE=UqshKfojWrO;RjW81mqav_AuI$C6iz2VJEo0OgX*f@YOqNo>!t}b
z)nJoI<qriEV1KYPr!=-_cHApXp<8UQNu&C+MweU0kzhLpHSbRPQ4YM!v?n=NV;6MW
zIN;)xWoX0Q3Msg;_a$&1mkx6*mQ}TIe}JJ31~C%Kq~%x`4-SGdc9>-8RzSq*{VDjo
zZH+a+pctvoGIWav97b<2O#+^;c$~ykB`^Wb*@VgJE`M=~Al9w!j4#@AyG5l?>ou39
z8%EY0l*`g+RyG1_#13`ac_0JUd9XtSM`^<Th^ad!S$+a{JZdk6!T>AjEBzS`!}N|5
zfUshwow=m!;Csyg1d=oHNdlncuJw=Rb-`UKx4vpdtkRqTG=Yrtx@v6Q*unpJe|Hrz
zcavkUIe$b#HAoLn=;mVr$>{Q>scLLYyJNaP$e=vw9oF;QVM4Q?4Ko%fwH>KXGAywK
znyuP*V?yEzViCA-m}WUj0^r}OMm^oGP%wzK;9Pu?pmE*aHq8C)2jwYmo^$&oY1ROv
zat0KWY0mnRekfIMc-d&|@Aq31pg`&!<9-oNpnvoxKt&Urp5PStE}sDc>XcbTpkTsl
z0Eh+H-rqd)8u5)^Alic^qs|9{X2L1L2D2Onn%IKa`2%H!34<fN&w{S`1(%ev-#HIp
z<?jSETl^b{pz41e3r{k?e<`7}pQ|QZkbsmDUcp4F2`3)#ieL|wSQH${n6q+E!Yr>~
zhJWu<)ZPcojnWl{88PSjQ4Zi**sl)Y3>C587{-uwvA)A*OJlESK(>Y*jEVXKrEr~h
zG>01)DtzD-7H%t5+bsyk_auK8D!FYaOgDT>Lr}7WWB5AH&{WHIgY#dy8(M@VyMasK
z+3=F&584gKGz8FYILtGE&W4vH|E0SDe1A5~bc3=D!Zq(}tRM&%CNUz(ETJ2xRrN1D
zUH;kTt1!7l#O@a<;lli+**xJ}f0rBMYoMLy6`L3p?0c(@Nu?mPS^xbjC4Gh(CxEGv
z^iQAqvg(ot?k(DHv%wVmI-FRwZy<nsx7AV1z1|u~mfOY{>o%jXHGp_j=pzZUTYm*J
z7RC-S7ML1q=N~Jw4g@>*8$+$=ySO#emXkJrb^}5BScDBynwMN+A&zZTi8cf%TBo~5
zp5ZBf4eM+Ejn23H`@8S?ceR`R;hX2LnydV2lF1)sZ2q{i%fEsi^6&DF`8T&O*|zi{
zCf&dE{pG6Hm;0NPO!|Lz^vVLS+kbuCo1#DJC5p%P&(-NNsz`g$*%j{x>Ec899`i{l
zu~vt|UE8=|Y5kk~Ri)?^xB7_s6G84n_>wdDo}Hb!?W6y6aD2C6Sd;De#&9g$^EsUV
z=$dgAYs~WppKbKw{eO?08ka766#@^RaE&z1&-QKYk8oK|H|py8my(zAS0lfr?3?Ma
gKibLtY&d!LsrIGN>0FTb)c!6$w+B}L1E$1xJKC9|UH||9

diff --git a/doc/_build/html/py-modindex.html b/doc/_build/html/py-modindex.html
index c3c9cc81..806dd4c4 100644
--- a/doc/_build/html/py-modindex.html
+++ b/doc/_build/html/py-modindex.html
@@ -202,6 +202,7 @@
 <li class="toctree-l1"><a class="reference internal" href="usage/quickstart.html">Quick Start</a></li>
 <li class="toctree-l1"><a class="reference internal" href="usage/command-line-interface.html">CLI</a></li>
 <li class="toctree-l1"><a class="reference internal" href="usage/python-interface.html">Python Interface</a></li>
+<li class="toctree-l1"><a class="reference internal" href="usage/response_types.html">Response Types</a></li>
 </ul>
 
 </div>
diff --git a/doc/_build/html/search.html b/doc/_build/html/search.html
index a918e1b4..83e5b92d 100644
--- a/doc/_build/html/search.html
+++ b/doc/_build/html/search.html
@@ -204,6 +204,7 @@
 <li class="toctree-l1"><a class="reference internal" href="usage/quickstart.html">Quick Start</a></li>
 <li class="toctree-l1"><a class="reference internal" href="usage/command-line-interface.html">CLI</a></li>
 <li class="toctree-l1"><a class="reference internal" href="usage/python-interface.html">Python Interface</a></li>
+<li class="toctree-l1"><a class="reference internal" href="usage/response_types.html">Response Types</a></li>
 </ul>
 
 </div>
diff --git a/doc/_build/html/searchindex.js b/doc/_build/html/searchindex.js
index 6e429ecd..80efa28d 100644
--- a/doc/_build/html/searchindex.js
+++ b/doc/_build/html/searchindex.js
@@ -1 +1 @@
-Search.setIndex({"alltitles": {"CLI": [[1, null]], "Contents:": [[0, null]], "Copernicus Marine Toolbox documentation": [[0, null]], "Create an account on Copernicus Marine website": [[2, "create-an-account-on-copernicus-marine-website"]], "Installing Copernicus Marine Toolbox": [[2, null]], "Python Interface": [[3, null]], "Quick Start": [[4, null]], "Via conda (conda-forge channel)": [[2, "via-conda-conda-forge-channel"]], "Via docker": [[2, "via-docker"]], "Via pip": [[2, "via-pip"]], "cli-describe": [[1, "copernicusmarine-cli-describe"]], "cli-get": [[1, "copernicusmarine-cli-get"]], "cli-login": [[1, "copernicusmarine-cli-login"]], "cli-subset": [[1, "copernicusmarine-cli-subset"]], "copernicusmarine": [[1, "copernicusmarine"]], "describe": [[1, "copernicusmarine-describe"]], "get": [[1, "copernicusmarine-get"]], "login": [[1, "copernicusmarine-login"]], "subset": [[1, "copernicusmarine-subset"]]}, "docnames": ["index", "usage/command-line-interface", "usage/installation", "usage/python-interface", "usage/quickstart"], "envversion": {"sphinx": 62, "sphinx.domains.c": 3, "sphinx.domains.changeset": 1, "sphinx.domains.citation": 1, "sphinx.domains.cpp": 9, "sphinx.domains.index": 1, "sphinx.domains.javascript": 3, "sphinx.domains.math": 2, "sphinx.domains.python": 4, "sphinx.domains.rst": 2, "sphinx.domains.std": 2}, "filenames": ["index.rst", "usage/command-line-interface.rst", "usage/installation.rst", "usage/python-interface.rst", "usage/quickstart.rst"], "indexentries": {"--configuration-file-directory": [[1, "cmdoption-copernicusmarine-login-configuration-file-directory", false]], "--contains": [[1, "cmdoption-copernicusmarine-describe-c", false]], "--create-file-list": [[1, "cmdoption-copernicusmarine-get-create-file-list", false]], "--create-template": [[1, "cmdoption-copernicusmarine-get-create-template", false], [1, "cmdoption-copernicusmarine-subset-create-template", false]], "--credentials-file": [[1, "cmdoption-copernicusmarine-get-credentials-file", false], [1, "cmdoption-copernicusmarine-subset-credentials-file", false]], "--dataset-id": [[1, "cmdoption-copernicusmarine-get-i", false], [1, "cmdoption-copernicusmarine-subset-i", false]], "--dataset-part": [[1, "cmdoption-copernicusmarine-get-dataset-part", false], [1, "cmdoption-copernicusmarine-subset-dataset-part", false]], "--dataset-version": [[1, "cmdoption-copernicusmarine-get-dataset-version", false], [1, "cmdoption-copernicusmarine-subset-dataset-version", false]], "--disable-progress-bar": [[1, "cmdoption-copernicusmarine-describe-disable-progress-bar", false], [1, "cmdoption-copernicusmarine-get-disable-progress-bar", false], [1, "cmdoption-copernicusmarine-subset-disable-progress-bar", false]], "--end-datetime": [[1, "cmdoption-copernicusmarine-subset-T", false]], "--file-format": [[1, "cmdoption-copernicusmarine-subset-file-format", false]], "--file-list": [[1, "cmdoption-copernicusmarine-get-file-list", false]], "--filter": [[1, "cmdoption-copernicusmarine-get-filter", false]], "--filter-with-globbing-pattern": [[1, "cmdoption-copernicusmarine-get-filter", false]], "--filter-with-regular-expression": [[1, "cmdoption-copernicusmarine-get-regex", false]], "--force-dataset-part": [[1, "cmdoption-copernicusmarine-get-dataset-part", false], [1, "cmdoption-copernicusmarine-subset-dataset-part", false]], "--force-dataset-version": [[1, "cmdoption-copernicusmarine-get-dataset-version", false], [1, "cmdoption-copernicusmarine-subset-dataset-version", false]], "--force-download": [[1, "cmdoption-copernicusmarine-get-force-download", false], [1, "cmdoption-copernicusmarine-subset-force-download", false]], "--force-service": [[1, "cmdoption-copernicusmarine-get-s", false], [1, "cmdoption-copernicusmarine-subset-s", false]], "--include-all": [[1, "cmdoption-copernicusmarine-describe-a", false]], "--include-all-versions": [[1, "cmdoption-copernicusmarine-describe-include-versions", false]], "--include-datasets": [[1, "cmdoption-copernicusmarine-describe-include-datasets", false]], "--include-description": [[1, "cmdoption-copernicusmarine-describe-include-description", false]], "--include-keywords": [[1, "cmdoption-copernicusmarine-describe-include-keywords", false]], "--include-versions": [[1, "cmdoption-copernicusmarine-describe-include-versions", false]], "--index-parts": [[1, "cmdoption-copernicusmarine-get-index-parts", false]], "--log-level": [[1, "cmdoption-copernicusmarine-describe-log-level", false], [1, "cmdoption-copernicusmarine-get-log-level", false], [1, "cmdoption-copernicusmarine-login-log-level", false], [1, "cmdoption-copernicusmarine-subset-log-level", false]], "--maximal-depth": [[1, "cmdoption-copernicusmarine-subset-Z", false]], "--maximal-latitude": [[1, "cmdoption-copernicusmarine-subset-Y", false]], "--maximal-longitude": [[1, "cmdoption-copernicusmarine-subset-X", false]], "--maximum-depth": [[1, "cmdoption-copernicusmarine-subset-Z", false]], "--maximum-latitude": [[1, "cmdoption-copernicusmarine-subset-Y", false]], "--maximum-longitude": [[1, "cmdoption-copernicusmarine-subset-X", false]], "--minimal-depth": [[1, "cmdoption-copernicusmarine-subset-z", false]], "--minimal-latitude": [[1, "cmdoption-copernicusmarine-subset-y", false]], "--minimal-longitude": [[1, "cmdoption-copernicusmarine-subset-x", false]], "--minimum-depth": [[1, "cmdoption-copernicusmarine-subset-z", false]], "--minimum-latitude": [[1, "cmdoption-copernicusmarine-subset-y", false]], "--minimum-longitude": [[1, "cmdoption-copernicusmarine-subset-x", false]], "--motu-api-request": [[1, "cmdoption-copernicusmarine-subset-motu-api-request", false]], "--netcdf-compression-enabled": [[1, "cmdoption-copernicusmarine-subset-netcdf-compression-enabled", false]], "--netcdf-compression-level": [[1, "cmdoption-copernicusmarine-subset-netcdf-compression-level", false]], "--netcdf3-compatible": [[1, "cmdoption-copernicusmarine-subset-netcdf3-compatible", false]], "--no-directories": [[1, "cmdoption-copernicusmarine-get-nd", false]], "--output-directory": [[1, "cmdoption-copernicusmarine-get-o", false], [1, "cmdoption-copernicusmarine-subset-o", false]], "--output-filename": [[1, "cmdoption-copernicusmarine-subset-f", false]], "--overwrite": [[1, "cmdoption-copernicusmarine-get-overwrite-output-data", false], [1, "cmdoption-copernicusmarine-subset-overwrite-output-data", false]], "--overwrite-configuration-file": [[1, "cmdoption-copernicusmarine-login-overwrite", false]], "--overwrite-output-data": [[1, "cmdoption-copernicusmarine-get-overwrite-output-data", false], [1, "cmdoption-copernicusmarine-subset-overwrite-output-data", false]], "--password": [[1, "cmdoption-copernicusmarine-get-password", false], [1, "cmdoption-copernicusmarine-login-password", false], [1, "cmdoption-copernicusmarine-subset-password", false]], "--regex": [[1, "cmdoption-copernicusmarine-get-regex", false]], "--request-file": [[1, "cmdoption-copernicusmarine-get-request-file", false], [1, "cmdoption-copernicusmarine-subset-request-file", false]], "--service": [[1, "cmdoption-copernicusmarine-get-s", false], [1, "cmdoption-copernicusmarine-subset-s", false]], "--show-outputnames": [[1, "cmdoption-copernicusmarine-get-show-outputnames", false]], "--skip-if-user-logged-in": [[1, "cmdoption-copernicusmarine-login-skip-if-user-logged-in", false]], "--start-datetime": [[1, "cmdoption-copernicusmarine-subset-t", false]], "--subset-method": [[1, "cmdoption-copernicusmarine-subset-subset-method", false]], "--sync": [[1, "cmdoption-copernicusmarine-get-sync", false]], "--sync-delete": [[1, "cmdoption-copernicusmarine-get-sync-delete", false]], "--username": [[1, "cmdoption-copernicusmarine-get-username", false], [1, "cmdoption-copernicusmarine-login-username", false], [1, "cmdoption-copernicusmarine-subset-username", false]], "--variable": [[1, "cmdoption-copernicusmarine-subset-v", false]], "--version": [[1, "cmdoption-copernicusmarine-V", false]], "--vertical-dimension-as-originally-produced": [[1, "cmdoption-copernicusmarine-subset-vertical-dimension-as-originally-produced", false]], "-a": [[1, "cmdoption-copernicusmarine-describe-a", false]], "-c": [[1, "cmdoption-copernicusmarine-describe-c", false]], "-f": [[1, "cmdoption-copernicusmarine-subset-f", false]], "-i": [[1, "cmdoption-copernicusmarine-get-i", false], [1, "cmdoption-copernicusmarine-subset-i", false]], "-nd": [[1, "cmdoption-copernicusmarine-get-nd", false]], "-o": [[1, "cmdoption-copernicusmarine-get-o", false], [1, "cmdoption-copernicusmarine-subset-o", false]], "-overwrite": [[1, "cmdoption-copernicusmarine-login-overwrite", false]], "-s": [[1, "cmdoption-copernicusmarine-get-s", false], [1, "cmdoption-copernicusmarine-subset-s", false]], "-t": [[1, "cmdoption-copernicusmarine-subset-T", false], [1, "cmdoption-copernicusmarine-subset-t", false]], "-v": [[1, "cmdoption-copernicusmarine-V", false], [1, "cmdoption-copernicusmarine-subset-v", false]], "-x": [[1, "cmdoption-copernicusmarine-subset-X", false], [1, "cmdoption-copernicusmarine-subset-x", false]], "-y": [[1, "cmdoption-copernicusmarine-subset-Y", false], [1, "cmdoption-copernicusmarine-subset-y", false]], "-z": [[1, "cmdoption-copernicusmarine-subset-Z", false], [1, "cmdoption-copernicusmarine-subset-z", false]], "copernicusmarine": [[3, "module-copernicusmarine", false]], "copernicusmarine command line option": [[1, "cmdoption-copernicusmarine-V", false]], "copernicusmarine-describe command line option": [[1, "cmdoption-copernicusmarine-describe-a", false], [1, "cmdoption-copernicusmarine-describe-c", false], [1, "cmdoption-copernicusmarine-describe-disable-progress-bar", false], [1, "cmdoption-copernicusmarine-describe-include-datasets", false], [1, "cmdoption-copernicusmarine-describe-include-description", false], [1, "cmdoption-copernicusmarine-describe-include-keywords", false], [1, "cmdoption-copernicusmarine-describe-include-versions", false], [1, "cmdoption-copernicusmarine-describe-log-level", false]], "copernicusmarine-get command line option": [[1, "cmdoption-copernicusmarine-get-create-file-list", false], [1, "cmdoption-copernicusmarine-get-create-template", false], [1, "cmdoption-copernicusmarine-get-credentials-file", false], [1, "cmdoption-copernicusmarine-get-dataset-part", false], [1, "cmdoption-copernicusmarine-get-dataset-version", false], [1, "cmdoption-copernicusmarine-get-disable-progress-bar", false], [1, "cmdoption-copernicusmarine-get-file-list", false], [1, "cmdoption-copernicusmarine-get-filter", false], [1, "cmdoption-copernicusmarine-get-force-download", false], [1, "cmdoption-copernicusmarine-get-i", false], [1, "cmdoption-copernicusmarine-get-index-parts", false], [1, "cmdoption-copernicusmarine-get-log-level", false], [1, "cmdoption-copernicusmarine-get-nd", false], [1, "cmdoption-copernicusmarine-get-o", false], [1, "cmdoption-copernicusmarine-get-overwrite-output-data", false], [1, "cmdoption-copernicusmarine-get-password", false], [1, "cmdoption-copernicusmarine-get-regex", false], [1, "cmdoption-copernicusmarine-get-request-file", false], [1, "cmdoption-copernicusmarine-get-s", false], [1, "cmdoption-copernicusmarine-get-show-outputnames", false], [1, "cmdoption-copernicusmarine-get-sync", false], [1, "cmdoption-copernicusmarine-get-sync-delete", false], [1, "cmdoption-copernicusmarine-get-username", false]], "copernicusmarine-login command line option": [[1, "cmdoption-copernicusmarine-login-configuration-file-directory", false], [1, "cmdoption-copernicusmarine-login-log-level", false], [1, "cmdoption-copernicusmarine-login-overwrite", false], [1, "cmdoption-copernicusmarine-login-password", false], [1, "cmdoption-copernicusmarine-login-skip-if-user-logged-in", false], [1, "cmdoption-copernicusmarine-login-username", false]], "copernicusmarine-subset command line option": [[1, "cmdoption-copernicusmarine-subset-T", false], [1, "cmdoption-copernicusmarine-subset-X", false], [1, "cmdoption-copernicusmarine-subset-Y", false], [1, "cmdoption-copernicusmarine-subset-Z", false], [1, "cmdoption-copernicusmarine-subset-create-template", false], [1, "cmdoption-copernicusmarine-subset-credentials-file", false], [1, "cmdoption-copernicusmarine-subset-dataset-part", false], [1, "cmdoption-copernicusmarine-subset-dataset-version", false], [1, "cmdoption-copernicusmarine-subset-disable-progress-bar", false], [1, "cmdoption-copernicusmarine-subset-f", false], [1, "cmdoption-copernicusmarine-subset-file-format", false], [1, "cmdoption-copernicusmarine-subset-force-download", false], [1, "cmdoption-copernicusmarine-subset-i", false], [1, "cmdoption-copernicusmarine-subset-log-level", false], [1, "cmdoption-copernicusmarine-subset-motu-api-request", false], [1, "cmdoption-copernicusmarine-subset-netcdf-compression-enabled", false], [1, "cmdoption-copernicusmarine-subset-netcdf-compression-level", false], [1, "cmdoption-copernicusmarine-subset-netcdf3-compatible", false], [1, "cmdoption-copernicusmarine-subset-o", false], [1, "cmdoption-copernicusmarine-subset-overwrite-output-data", false], [1, "cmdoption-copernicusmarine-subset-password", false], [1, "cmdoption-copernicusmarine-subset-request-file", false], [1, "cmdoption-copernicusmarine-subset-s", false], [1, "cmdoption-copernicusmarine-subset-subset-method", false], [1, "cmdoption-copernicusmarine-subset-t", false], [1, "cmdoption-copernicusmarine-subset-username", false], [1, "cmdoption-copernicusmarine-subset-v", false], [1, "cmdoption-copernicusmarine-subset-vertical-dimension-as-originally-produced", false], [1, "cmdoption-copernicusmarine-subset-x", false], [1, "cmdoption-copernicusmarine-subset-y", false], [1, "cmdoption-copernicusmarine-subset-z", false]], "describe() (in module copernicusmarine)": [[3, "copernicusmarine.describe", false]], "get() (in module copernicusmarine)": [[3, "copernicusmarine.get", false]], "login() (in module copernicusmarine)": [[3, "copernicusmarine.login", false]], "module": [[3, "module-copernicusmarine", false]], "open_dataset() (in module copernicusmarine)": [[3, "copernicusmarine.open_dataset", false]], "read_dataframe() (in module copernicusmarine)": [[3, "copernicusmarine.read_dataframe", false]], "subset() (in module copernicusmarine)": [[3, "copernicusmarine.subset", false]]}, "objects": {"": [[3, 0, 0, "-", "copernicusmarine"]], "copernicusmarine": [[3, 1, 1, "", "describe"], [3, 1, 1, "", "get"], [3, 1, 1, "", "login"], [3, 1, 1, "", "open_dataset"], [3, 1, 1, "", "read_dataframe"], [3, 1, 1, "", "subset"], [1, 2, 1, "cmdoption-copernicusmarine-V", "--version"], [1, 2, 1, "cmdoption-copernicusmarine-V", "-V"]], "copernicusmarine-describe": [[1, 2, 1, "cmdoption-copernicusmarine-describe-c", "--contains"], [1, 2, 1, "cmdoption-copernicusmarine-describe-disable-progress-bar", "--disable-progress-bar"], [1, 2, 1, "cmdoption-copernicusmarine-describe-a", "--include-all"], [1, 2, 1, "cmdoption-copernicusmarine-describe-include-versions", "--include-all-versions"], [1, 2, 1, "cmdoption-copernicusmarine-describe-include-datasets", "--include-datasets"], [1, 2, 1, "cmdoption-copernicusmarine-describe-include-description", "--include-description"], [1, 2, 1, "cmdoption-copernicusmarine-describe-include-keywords", "--include-keywords"], [1, 2, 1, "cmdoption-copernicusmarine-describe-include-versions", "--include-versions"], [1, 2, 1, "cmdoption-copernicusmarine-describe-log-level", "--log-level"], [1, 2, 1, "cmdoption-copernicusmarine-describe-a", "-a"], [1, 2, 1, "cmdoption-copernicusmarine-describe-c", "-c"]], "copernicusmarine-get": [[1, 2, 1, "cmdoption-copernicusmarine-get-create-file-list", "--create-file-list"], [1, 2, 1, "cmdoption-copernicusmarine-get-create-template", "--create-template"], [1, 2, 1, "cmdoption-copernicusmarine-get-credentials-file", "--credentials-file"], [1, 2, 1, "cmdoption-copernicusmarine-get-i", "--dataset-id"], [1, 2, 1, "cmdoption-copernicusmarine-get-dataset-part", "--dataset-part"], [1, 2, 1, "cmdoption-copernicusmarine-get-dataset-version", "--dataset-version"], [1, 2, 1, "cmdoption-copernicusmarine-get-disable-progress-bar", "--disable-progress-bar"], [1, 2, 1, "cmdoption-copernicusmarine-get-file-list", "--file-list"], [1, 2, 1, "cmdoption-copernicusmarine-get-filter", "--filter"], [1, 2, 1, "cmdoption-copernicusmarine-get-filter", "--filter-with-globbing-pattern"], [1, 2, 1, "cmdoption-copernicusmarine-get-regex", "--filter-with-regular-expression"], [1, 2, 1, "cmdoption-copernicusmarine-get-dataset-part", "--force-dataset-part"], [1, 2, 1, "cmdoption-copernicusmarine-get-dataset-version", "--force-dataset-version"], [1, 2, 1, "cmdoption-copernicusmarine-get-force-download", "--force-download"], [1, 2, 1, "cmdoption-copernicusmarine-get-s", "--force-service"], [1, 2, 1, "cmdoption-copernicusmarine-get-index-parts", "--index-parts"], [1, 2, 1, "cmdoption-copernicusmarine-get-log-level", "--log-level"], [1, 2, 1, "cmdoption-copernicusmarine-get-nd", "--no-directories"], [1, 2, 1, "cmdoption-copernicusmarine-get-o", "--output-directory"], [1, 2, 1, "cmdoption-copernicusmarine-get-overwrite-output-data", "--overwrite"], [1, 2, 1, "cmdoption-copernicusmarine-get-overwrite-output-data", "--overwrite-output-data"], [1, 2, 1, "cmdoption-copernicusmarine-get-password", "--password"], [1, 2, 1, "cmdoption-copernicusmarine-get-regex", "--regex"], [1, 2, 1, "cmdoption-copernicusmarine-get-request-file", "--request-file"], [1, 2, 1, "cmdoption-copernicusmarine-get-s", "--service"], [1, 2, 1, "cmdoption-copernicusmarine-get-show-outputnames", "--show-outputnames"], [1, 2, 1, "cmdoption-copernicusmarine-get-sync", "--sync"], [1, 2, 1, "cmdoption-copernicusmarine-get-sync-delete", "--sync-delete"], [1, 2, 1, "cmdoption-copernicusmarine-get-username", "--username"], [1, 2, 1, "cmdoption-copernicusmarine-get-i", "-i"], [1, 2, 1, "cmdoption-copernicusmarine-get-nd", "-nd"], [1, 2, 1, "cmdoption-copernicusmarine-get-o", "-o"], [1, 2, 1, "cmdoption-copernicusmarine-get-s", "-s"]], "copernicusmarine-login": [[1, 2, 1, "cmdoption-copernicusmarine-login-configuration-file-directory", "--configuration-file-directory"], [1, 2, 1, "cmdoption-copernicusmarine-login-log-level", "--log-level"], [1, 2, 1, "cmdoption-copernicusmarine-login-overwrite", "--overwrite-configuration-file"], [1, 2, 1, "cmdoption-copernicusmarine-login-password", "--password"], [1, 2, 1, "cmdoption-copernicusmarine-login-skip-if-user-logged-in", "--skip-if-user-logged-in"], [1, 2, 1, "cmdoption-copernicusmarine-login-username", "--username"], [1, 2, 1, "cmdoption-copernicusmarine-login-overwrite", "-overwrite"]], "copernicusmarine-subset": [[1, 2, 1, "cmdoption-copernicusmarine-subset-create-template", "--create-template"], [1, 2, 1, "cmdoption-copernicusmarine-subset-credentials-file", "--credentials-file"], [1, 2, 1, "cmdoption-copernicusmarine-subset-i", "--dataset-id"], [1, 2, 1, "cmdoption-copernicusmarine-subset-dataset-part", "--dataset-part"], [1, 2, 1, "cmdoption-copernicusmarine-subset-dataset-version", "--dataset-version"], [1, 2, 1, "cmdoption-copernicusmarine-subset-disable-progress-bar", "--disable-progress-bar"], [1, 2, 1, "cmdoption-copernicusmarine-subset-T", "--end-datetime"], [1, 2, 1, "cmdoption-copernicusmarine-subset-file-format", "--file-format"], [1, 2, 1, "cmdoption-copernicusmarine-subset-dataset-part", "--force-dataset-part"], [1, 2, 1, "cmdoption-copernicusmarine-subset-dataset-version", "--force-dataset-version"], [1, 2, 1, "cmdoption-copernicusmarine-subset-force-download", "--force-download"], [1, 2, 1, "cmdoption-copernicusmarine-subset-s", "--force-service"], [1, 2, 1, "cmdoption-copernicusmarine-subset-log-level", "--log-level"], [1, 2, 1, "cmdoption-copernicusmarine-subset-Z", "--maximal-depth"], [1, 2, 1, "cmdoption-copernicusmarine-subset-Y", "--maximal-latitude"], [1, 2, 1, "cmdoption-copernicusmarine-subset-X", "--maximal-longitude"], [1, 2, 1, "cmdoption-copernicusmarine-subset-Z", "--maximum-depth"], [1, 2, 1, "cmdoption-copernicusmarine-subset-Y", "--maximum-latitude"], [1, 2, 1, "cmdoption-copernicusmarine-subset-X", "--maximum-longitude"], [1, 2, 1, "cmdoption-copernicusmarine-subset-z", "--minimal-depth"], [1, 2, 1, "cmdoption-copernicusmarine-subset-y", "--minimal-latitude"], [1, 2, 1, "cmdoption-copernicusmarine-subset-x", "--minimal-longitude"], [1, 2, 1, "cmdoption-copernicusmarine-subset-z", "--minimum-depth"], [1, 2, 1, "cmdoption-copernicusmarine-subset-y", "--minimum-latitude"], [1, 2, 1, "cmdoption-copernicusmarine-subset-x", "--minimum-longitude"], [1, 2, 1, "cmdoption-copernicusmarine-subset-motu-api-request", "--motu-api-request"], [1, 2, 1, "cmdoption-copernicusmarine-subset-netcdf-compression-enabled", "--netcdf-compression-enabled"], [1, 2, 1, "cmdoption-copernicusmarine-subset-netcdf-compression-level", "--netcdf-compression-level"], [1, 2, 1, "cmdoption-copernicusmarine-subset-netcdf3-compatible", "--netcdf3-compatible"], [1, 2, 1, "cmdoption-copernicusmarine-subset-o", "--output-directory"], [1, 2, 1, "cmdoption-copernicusmarine-subset-f", "--output-filename"], [1, 2, 1, "cmdoption-copernicusmarine-subset-overwrite-output-data", "--overwrite"], [1, 2, 1, "cmdoption-copernicusmarine-subset-overwrite-output-data", "--overwrite-output-data"], [1, 2, 1, "cmdoption-copernicusmarine-subset-password", "--password"], [1, 2, 1, "cmdoption-copernicusmarine-subset-request-file", "--request-file"], [1, 2, 1, "cmdoption-copernicusmarine-subset-s", "--service"], [1, 2, 1, "cmdoption-copernicusmarine-subset-t", "--start-datetime"], [1, 2, 1, "cmdoption-copernicusmarine-subset-subset-method", "--subset-method"], [1, 2, 1, "cmdoption-copernicusmarine-subset-username", "--username"], [1, 2, 1, "cmdoption-copernicusmarine-subset-v", "--variable"], [1, 2, 1, "cmdoption-copernicusmarine-subset-vertical-dimension-as-originally-produced", "--vertical-dimension-as-originally-produced"], [1, 2, 1, "cmdoption-copernicusmarine-subset-T", "-T"], [1, 2, 1, "cmdoption-copernicusmarine-subset-X", "-X"], [1, 2, 1, "cmdoption-copernicusmarine-subset-Y", "-Y"], [1, 2, 1, "cmdoption-copernicusmarine-subset-Z", "-Z"], [1, 2, 1, "cmdoption-copernicusmarine-subset-f", "-f"], [1, 2, 1, "cmdoption-copernicusmarine-subset-i", "-i"], [1, 2, 1, "cmdoption-copernicusmarine-subset-o", "-o"], [1, 2, 1, "cmdoption-copernicusmarine-subset-s", "-s"], [1, 2, 1, "cmdoption-copernicusmarine-subset-t", "-t"], [1, 2, 1, "cmdoption-copernicusmarine-subset-v", "-v"], [1, 2, 1, "cmdoption-copernicusmarine-subset-x", "-x"], [1, 2, 1, "cmdoption-copernicusmarine-subset-y", "-y"], [1, 2, 1, "cmdoption-copernicusmarine-subset-z", "-z"]]}, "objnames": {"0": ["py", "module", "Python module"], "1": ["py", "function", "Python function"], "2": ["std", "cmdoption", "program option"]}, "objtypes": {"0": "py:module", "1": "py:function", "2": "std:cmdoption"}, "terms": {"": 1, "0": [1, 3], "00": 1, "01": 1, "01t00": 1, "08": 1, "083deg_pt6h": 1, "1": [1, 3], "12": 1, "17": 1, "180": 1, "2022": 1, "2gb": [], "3": [1, 2, 3], "30": 1, "31t23": 1, "35": 1, "36": 1, "360": 1, "3d": 1, "5": 1, "59": 1, "6": 1, "75": 1, "9": [1, 2, 3], "A": [1, 3], "And": [], "Be": [], "By": 1, "For": [1, 3], "If": [1, 3], "It": [1, 3], "Or": [], "The": [1, 3], "There": 2, "These": [1, 3], "To": 2, "_netrc": 1, "abl": 2, "abov": [], "absolut": 1, "accept": 1, "access": 3, "account": 0, "across": [], "action": [1, 3], "add": 0, "advis": [], "after": [], "all": [1, 3], "allow": 1, "alreadi": [1, 3], "also": 3, "among": 1, "an": [0, 1, 3], "anaconda": [], "ani": 3, "api": [1, 3], "appli": [1, 3], "applic": [], "apt": [], "ar": [1, 2, 3], "arco": [1, 3], "arg": 1, "argument": 1, "ask": [1, 3], "attempt": [1, 3], "attribut": 1, "authent": 3, "avail": [1, 3], "avoid": 3, "awar": [], "axi": 1, "bar": 1, "base": [1, 3], "bash": [], "befor": [1, 3], "below": [], "block": [], "bool": 3, "both": [], "bound": 3, "brew": [], "bug": [], "build": [], "c": [1, 2], "call": 3, "can": [1, 2, 3], "care": 3, "catalog": 1, "catalogu": [1, 3], "caution": 1, "cd": [], "channel": 0, "check": [], "choco": [], "choos": [], "cli": 0, "clone": [], "cmems_mod_glo_phi": 1, "cmems_mod_nws_bgc": 1, "cmu": [], "code": [], "com": [], "command": 1, "commun": [], "compat": [1, 3], "complet": 1, "compress": [1, 3], "comput": 3, "concaten": 1, "conda": 0, "configur": [1, 3], "configuration_file_directori": [1, 3], "confirm": [1, 3], "consol": 1, "consolid": 1, "construct": 4, "contain": [1, 3], "copernicu": [1, 3], "copernicusmarin": [0, 2, 3], "copernicusmarine_service_password": [1, 3], "copernicusmarine_service_usernam": [1, 3], "correspond": 1, "creat": [0, 1, 3], "create_file_list": [1, 3], "credenti": [1, 3], "credentials_fil": [1, 3], "critic": 1, "csv": 1, "current": [1, 3], "custom": [1, 3], "d": 1, "data": [1, 3], "data_fold": [], "databas": [], "dataclass": 1, "datafram": 3, "dataset": [1, 3], "dataset_id": [1, 3], "dataset_part": [1, 3], "dataset_vers": [1, 3], "datasetid": 1, "date": 1, "datetim": [1, 3], "debug": 1, "default": [1, 3], "delet": [1, 3], "depend": [], "depth": [1, 3], "descend": 1, "describ": [0, 3], "descript": [1, 3], "destin": 1, "detail": [0, 1], "develop": [], "diato_p1m": 1, "dict": 3, "dictionari": 3, "differ": [], "dimens": [1, 3], "directli": [1, 3], "directori": [1, 3], "disabl": 1, "disable_progress_bar": 3, "displai": [1, 3], "do": [], "doc": [], "docker": 0, "dockerhub": 2, "document": 1, "done": [], "doubl": 1, "download": [1, 3], "download_file_list": 3, "e": 1, "each": 3, "either": 3, "els": [1, 3], "enabl": [1, 3], "encapsul": 1, "end": [1, 3], "end_datetim": [1, 3], "ensur": 1, "entir": 3, "environ": [1, 3], "equival": 1, "error": 1, "exact": 1, "exampl": 1, "exclus": 1, "execut": 3, "exist": [1, 3], "exit": 1, "express": [1, 3], "extens": 3, "extract": 3, "f": 1, "fals": 3, "fetch": [1, 3], "file": [1, 3], "file_format": [1, 3], "file_list": [1, 3], "filenam": [1, 3], "filter": [1, 3], "find": [1, 3], "flag": [1, 3], "flexibl": [], "float": [1, 3], "folder": 1, "follow": 1, "forc": [1, 3], "force_download": 3, "force_servic": 3, "forg": 0, "format": [1, 3], "former": [], "found": [1, 3], "from": [1, 3], "full": [], "func": [], "function": [1, 3], "ge": [], "gener": 3, "geo": [1, 3], "geograph": 3, "geoseri": 1, "get": [0, 3], "get_templ": 1, "getrequest": 1, "git": [], "github": [], "given": [1, 3], "glo": 1, "glob": 1, "global": [], "gz": [], "h": 1, "ha": 1, "have": 2, "here": 2, "hide": 1, "hierarchi": 1, "higher": 2, "highest": [1, 3], "home": 1, "howev": [], "html": [], "http": [], "hub": [], "i": [1, 3], "id": [1, 3], "identifi": 3, "imag": [], "immedi": 3, "inc": [], "includ": [1, 3], "include_al": 3, "include_dataset": 3, "include_descript": 3, "include_keyword": 3, "include_vers": 3, "index": [1, 3], "index_part": 3, "individu": 1, "info": 1, "inform": [1, 3], "ini": 1, "input": [1, 3], "insid": [1, 3], "insitu": [1, 3], "instal": 0, "instead": [1, 3], "int": 3, "interfac": 0, "interv": 1, "invok": [], "issu": [], "item": 3, "its": 1, "json": 1, "keyword": [1, 3], "kind": [], "l4": 1, "larg": [], "latest": [], "latex": [], "latexpdf": [], "latitud": [1, 3], "latter": [], "lazi": 3, "least": [], "less": [], "level": [1, 3], "librari": 1, "line": [1, 3], "lineno": [], "list": [1, 3], "liter": 3, "load": 3, "local": [1, 3], "log": [1, 3], "log_level": 1, "login": [0, 3], "longitud": [1, 3], "look": 1, "m": 1, "mai": 3, "main": [], "mainli": [], "maintain": [], "make": [], "manag": 3, "mandatori": 3, "marin": [1, 3], "match": [1, 3], "maxim": 1, "maximum": [1, 3], "maximum_depth": [1, 3], "maximum_latitud": [1, 3], "maximum_longitud": [1, 3], "mean": [1, 3], "memori": 3, "metadata": 3, "method": [1, 3], "metoffic": 1, "micromamba": [], "miniconda": [], "miniforg": [], "minim": 1, "minimum": [1, 3], "minimum_depth": [1, 3], "minimum_latitud": [1, 3], "minimum_longitud": [1, 3], "mode": 3, "modern": [], "more": [1, 3], "most": [], "motu": [1, 3], "motu_api_request": [1, 3], "motucli": 1, "multipl": 1, "must": [1, 3], "mutual": 1, "name": [1, 3], "nc": 1, "nd": 1, "nearest": [1, 3], "need": [1, 2], "netcdf": [1, 3], "netcdf3": 1, "netcdf3_compat": 3, "netcdf_compression_en": 3, "netcdf_compression_level": [1, 3], "netrc": 1, "new": 1, "no_directori": 3, "non": [], "none": [1, 3], "note": 1, "nrt": 1, "number": [], "o": 1, "ob": 1, "ograph": [], "omi": 1, "onc": [], "one": 1, "ones": 1, "onli": [1, 3], "open_dataset": [0, 3], "optim": 3, "option": [1, 3], "organ": 3, "origin": [1, 3], "other": [1, 3], "ouput": 1, "out": [], "output": [1, 3], "output_directori": [1, 3], "output_filenam": [1, 3], "outputnam": 1, "over": 1, "overview": [], "overwrit": [1, 3], "overwrite_configuration_fil": 3, "overwrite_output_data": 3, "overwritten": 1, "packag": [], "page": [], "panda": 3, "param": [], "paramet": 3, "part": [1, 3], "parti": [], "pass": 1, "password": [1, 3], "path": [1, 3], "pathlib": 3, "pattern": 1, "pdf": [], "perform": [1, 3], "pft_myint_7km": 1, "pin": [], "pip": 0, "place": [], "pleas": [1, 3], "port": [], "posit": 1, "posixpath": 3, "possibl": 1, "pre": [], "preced": 1, "prefer": 3, "present": [1, 3], "print": 1, "process": [1, 3], "produc": [1, 3], "product": [1, 3], "progress": 1, "project": [], "protocol": 3, "provid": [1, 3], "publish": [], "purpos": [], "py312": [], "pypi": 2, "pyproject": [], "python": [0, 1, 2], "python3": [], "python312": [], "python3x": [], "quick": 0, "quickstart": [], "quiet": 1, "quot": 1, "r": [], "ram": 3, "rang": [1, 3], "rapid": 3, "read": [], "read_datafram": [0, 3], "readm": [1, 3], "rebuild": [], "recognit": [], "recommend": [], "recreat": 1, "recurs": 1, "reduc": 1, "refer": [1, 3], "regex": [1, 3], "regist": 2, "regular": [1, 3], "releas": [], "remot": [1, 3], "replac": 1, "repo": [], "repositori": [], "request": [1, 3], "request_fil": [1, 3], "requir": [1, 2, 3], "restructuredtext": 0, "retriev": 3, "return": [1, 3], "rjester": 3, "rm": [], "rtype": [], "run": 2, "save": 3, "search": [1, 3], "see": [0, 1, 3], "select": 1, "separ": [], "seri": [1, 3], "server": [1, 3], "servic": [1, 3], "set": [1, 3], "sever": [1, 2], "short": 1, "should": 1, "show": 1, "show_outputnam": 3, "simpli": [], "singl": 1, "skip": [1, 3], "skip_if_user_logged_in": 3, "snapshot": [], "so": [], "soon": 3, "sourc": 3, "spatial": 3, "specif": [1, 3], "specifi": [1, 3], "speech": [], "sphinx": [], "sphinxdoc": [], "sst": 1, "stabl": [], "stage": 3, "standard": 1, "start": [0, 1, 3], "start_datetim": [1, 3], "static": 1, "store": [1, 3], "str": 3, "strict": [1, 3], "strictli": [1, 3], "string": [1, 3], "structur": 1, "subset": [0, 3], "subset_method": [1, 3], "subset_templ": 1, "subsetrequest": 1, "sudo": [], "support": 3, "sync": [1, 3], "sync_delet": 3, "synchron": [1, 3], "syntax": 0, "system": [], "t": 1, "take": 1, "tar": [], "target": [1, 3], "templat": 1, "tempor": [1, 3], "temporari": [1, 3], "texliv": [], "text": [], "them": [1, 3], "thetao": 1, "thetao_anfc_0": 1, "thi": [1, 3], "third": [], "through": 1, "time": [1, 3], "timeseri": 1, "token": 1, "toml": [], "tool": [], "toolbox": [1, 3], "toolkit": [], "true": [1, 3], "two": [], "txt": [1, 3], "type": 3, "u": [], "under": [1, 4], "union": 3, "uniqu": [1, 3], "unlik": 3, "up": [], "url": 1, "us": [0, 1, 2, 3], "usag": 3, "user": [1, 3], "usernam": [1, 3], "usual": [], "v": 1, "v2": 1, "valid": 1, "valu": [1, 3], "variabl": [1, 3], "variou": 3, "venv": [], "veri": [], "version": [1, 3], "vertic": [1, 3], "vertical_dimension_as_originally_produc": [1, 3], "via": [0, 1], "wai": 2, "want": [], "warn": 1, "websit": 0, "well": [], "when": [1, 3], "where": [1, 3], "whether": 3, "which": [1, 3], "while": [1, 3], "within": 1, "work": [], "would": [], "write": [1, 3], "x": 1, "xarrai": 3, "y": 1, "you": [1, 2, 3], "your": [0, 1, 3], "yum": [], "z": 1, "zarr": [1, 3], "zip": []}, "titles": ["Copernicus Marine Toolbox documentation", "CLI", "Installing Copernicus Marine Toolbox", "Python Interface", "Quick Start"], "titleterms": {"account": 2, "an": 2, "cento": [], "channel": 2, "chocolatei": [], "cli": 1, "command": [], "conda": 2, "content": 0, "copernicu": [0, 2], "copernicusmarin": 1, "creat": 2, "debian": [], "describ": 1, "develop": [], "distribut": [], "docker": 2, "document": 0, "forg": 2, "from": [], "get": 1, "group": [], "homebrew": [], "instal": 2, "interfac": 3, "latest": [], "line": [], "linux": [], "login": 1, "maco": [], "macport": [], "manag": [], "marin": [0, 2], "method": [], "o": [], "other": [], "packag": [], "pip": 2, "pypi": [], "python": 3, "quick": 4, "releas": [], "rhel": [], "sourc": [], "specif": [], "sphinx": [], "start": 4, "subset": 1, "toolbox": [0, 2], "ubuntu": [], "via": 2, "websit": 2, "window": []}})
+Search.setIndex({"alltitles": {"CLI": [[1, null]], "Commands Response": [[5, "commands-response"]], "Contents:": [[0, null]], "Copernicus Marine Toolbox documentation": [[0, null]], "Create an account on Copernicus Marine website": [[2, "create-an-account-on-copernicus-marine-website"]], "Installing Copernicus Marine Toolbox": [[2, null]], "Python Interface": [[3, null]], "Quick Start": [[4, null]], "Response Types": [[5, null]], "Subtypes": [[5, "subtypes"]], "Via conda (conda-forge channel)": [[2, "via-conda-conda-forge-channel"]], "Via docker": [[2, "via-docker"]], "Via pip": [[2, "via-pip"]], "cli-describe": [[1, "copernicusmarine-cli-describe"]], "cli-get": [[1, "copernicusmarine-cli-get"]], "cli-login": [[1, "copernicusmarine-cli-login"]], "cli-subset": [[1, "copernicusmarine-cli-subset"]], "copernicusmarine": [[1, "copernicusmarine"]], "describe": [[1, "copernicusmarine-describe"]], "get": [[1, "copernicusmarine-get"]], "login": [[1, "copernicusmarine-login"]], "subset": [[1, "copernicusmarine-subset"]]}, "docnames": ["index", "usage/command-line-interface", "usage/installation", "usage/python-interface", "usage/quickstart", "usage/response_types"], "envversion": {"sphinx": 62, "sphinx.domains.c": 3, "sphinx.domains.changeset": 1, "sphinx.domains.citation": 1, "sphinx.domains.cpp": 9, "sphinx.domains.index": 1, "sphinx.domains.javascript": 3, "sphinx.domains.math": 2, "sphinx.domains.python": 4, "sphinx.domains.rst": 2, "sphinx.domains.std": 2}, "filenames": ["index.rst", "usage/command-line-interface.rst", "usage/installation.rst", "usage/python-interface.rst", "usage/quickstart.rst", "usage/response_types.rst"], "indexentries": {"--bounding-box-method": [[1, "cmdoption-copernicusmarine-subset-bounding-box-method", false]], "--configuration-file-directory": [[1, "cmdoption-copernicusmarine-login-configuration-file-directory", false]], "--contains": [[1, "cmdoption-copernicusmarine-describe-c", false]], "--create-file-list": [[1, "cmdoption-copernicusmarine-get-create-file-list", false]], "--create-template": [[1, "cmdoption-copernicusmarine-get-create-template", false], [1, "cmdoption-copernicusmarine-subset-create-template", false]], "--credentials-file": [[1, "cmdoption-copernicusmarine-get-credentials-file", false], [1, "cmdoption-copernicusmarine-subset-credentials-file", false]], "--dataset-id": [[1, "cmdoption-copernicusmarine-get-i", false], [1, "cmdoption-copernicusmarine-subset-i", false]], "--dataset-part": [[1, "cmdoption-copernicusmarine-get-dataset-part", false], [1, "cmdoption-copernicusmarine-subset-dataset-part", false]], "--dataset-version": [[1, "cmdoption-copernicusmarine-get-dataset-version", false], [1, "cmdoption-copernicusmarine-subset-dataset-version", false]], "--disable-progress-bar": [[1, "cmdoption-copernicusmarine-describe-disable-progress-bar", false], [1, "cmdoption-copernicusmarine-get-disable-progress-bar", false], [1, "cmdoption-copernicusmarine-subset-disable-progress-bar", false]], "--dry-run": [[1, "cmdoption-copernicusmarine-get-dry-run", false], [1, "cmdoption-copernicusmarine-subset-dry-run", false]], "--end-datetime": [[1, "cmdoption-copernicusmarine-subset-T", false]], "--file-format": [[1, "cmdoption-copernicusmarine-subset-file-format", false]], "--file-list": [[1, "cmdoption-copernicusmarine-get-file-list", false]], "--filter": [[1, "cmdoption-copernicusmarine-get-filter", false]], "--filter-with-globbing-pattern": [[1, "cmdoption-copernicusmarine-get-filter", false]], "--filter-with-regular-expression": [[1, "cmdoption-copernicusmarine-get-regex", false]], "--force-dataset-part": [[1, "cmdoption-copernicusmarine-get-dataset-part", false], [1, "cmdoption-copernicusmarine-subset-dataset-part", false]], "--force-dataset-version": [[1, "cmdoption-copernicusmarine-get-dataset-version", false], [1, "cmdoption-copernicusmarine-subset-dataset-version", false]], "--force-download": [[1, "cmdoption-copernicusmarine-get-force-download", false], [1, "cmdoption-copernicusmarine-subset-force-download", false]], "--force-service": [[1, "cmdoption-copernicusmarine-get-s", false], [1, "cmdoption-copernicusmarine-subset-s", false]], "--include-all": [[1, "cmdoption-copernicusmarine-describe-a", false]], "--include-all-versions": [[1, "cmdoption-copernicusmarine-describe-include-versions", false]], "--include-datasets": [[1, "cmdoption-copernicusmarine-describe-include-datasets", false]], "--include-description": [[1, "cmdoption-copernicusmarine-describe-include-description", false]], "--include-keywords": [[1, "cmdoption-copernicusmarine-describe-include-keywords", false]], "--include-versions": [[1, "cmdoption-copernicusmarine-describe-include-versions", false]], "--index-parts": [[1, "cmdoption-copernicusmarine-get-index-parts", false]], "--log-level": [[1, "cmdoption-copernicusmarine-describe-log-level", false], [1, "cmdoption-copernicusmarine-get-log-level", false], [1, "cmdoption-copernicusmarine-login-log-level", false], [1, "cmdoption-copernicusmarine-subset-log-level", false]], "--maximal-depth": [[1, "cmdoption-copernicusmarine-subset-Z", false]], "--maximal-latitude": [[1, "cmdoption-copernicusmarine-subset-Y", false]], "--maximal-longitude": [[1, "cmdoption-copernicusmarine-subset-X", false]], "--maximum-depth": [[1, "cmdoption-copernicusmarine-subset-Z", false]], "--maximum-latitude": [[1, "cmdoption-copernicusmarine-subset-Y", false]], "--maximum-longitude": [[1, "cmdoption-copernicusmarine-subset-X", false]], "--minimal-depth": [[1, "cmdoption-copernicusmarine-subset-z", false]], "--minimal-latitude": [[1, "cmdoption-copernicusmarine-subset-y", false]], "--minimal-longitude": [[1, "cmdoption-copernicusmarine-subset-x", false]], "--minimum-depth": [[1, "cmdoption-copernicusmarine-subset-z", false]], "--minimum-latitude": [[1, "cmdoption-copernicusmarine-subset-y", false]], "--minimum-longitude": [[1, "cmdoption-copernicusmarine-subset-x", false]], "--motu-api-request": [[1, "cmdoption-copernicusmarine-subset-motu-api-request", false]], "--netcdf-compression-enabled": [[1, "cmdoption-copernicusmarine-subset-netcdf-compression-enabled", false]], "--netcdf-compression-level": [[1, "cmdoption-copernicusmarine-subset-netcdf-compression-level", false]], "--netcdf3-compatible": [[1, "cmdoption-copernicusmarine-subset-netcdf3-compatible", false]], "--no-directories": [[1, "cmdoption-copernicusmarine-get-nd", false]], "--output-directory": [[1, "cmdoption-copernicusmarine-get-o", false], [1, "cmdoption-copernicusmarine-subset-o", false]], "--output-filename": [[1, "cmdoption-copernicusmarine-subset-f", false]], "--overwrite": [[1, "cmdoption-copernicusmarine-get-overwrite-output-data", false], [1, "cmdoption-copernicusmarine-subset-overwrite-output-data", false]], "--overwrite-configuration-file": [[1, "cmdoption-copernicusmarine-login-overwrite", false]], "--overwrite-output-data": [[1, "cmdoption-copernicusmarine-get-overwrite-output-data", false], [1, "cmdoption-copernicusmarine-subset-overwrite-output-data", false]], "--password": [[1, "cmdoption-copernicusmarine-get-password", false], [1, "cmdoption-copernicusmarine-login-password", false], [1, "cmdoption-copernicusmarine-subset-password", false]], "--regex": [[1, "cmdoption-copernicusmarine-get-regex", false]], "--request-file": [[1, "cmdoption-copernicusmarine-get-request-file", false], [1, "cmdoption-copernicusmarine-subset-request-file", false]], "--service": [[1, "cmdoption-copernicusmarine-get-s", false], [1, "cmdoption-copernicusmarine-subset-s", false]], "--show-outputnames": [[1, "cmdoption-copernicusmarine-get-show-outputnames", false]], "--skip-if-user-logged-in": [[1, "cmdoption-copernicusmarine-login-skip-if-user-logged-in", false]], "--start-datetime": [[1, "cmdoption-copernicusmarine-subset-t", false]], "--subset-method": [[1, "cmdoption-copernicusmarine-subset-subset-method", false]], "--sync": [[1, "cmdoption-copernicusmarine-get-sync", false]], "--sync-delete": [[1, "cmdoption-copernicusmarine-get-sync-delete", false]], "--username": [[1, "cmdoption-copernicusmarine-get-username", false], [1, "cmdoption-copernicusmarine-login-username", false], [1, "cmdoption-copernicusmarine-subset-username", false]], "--variable": [[1, "cmdoption-copernicusmarine-subset-v", false]], "--version": [[1, "cmdoption-copernicusmarine-V", false]], "--vertical-dimension-as-originally-produced": [[1, "cmdoption-copernicusmarine-subset-vertical-dimension-as-originally-produced", false]], "-a": [[1, "cmdoption-copernicusmarine-describe-a", false]], "-c": [[1, "cmdoption-copernicusmarine-describe-c", false]], "-f": [[1, "cmdoption-copernicusmarine-subset-f", false]], "-i": [[1, "cmdoption-copernicusmarine-get-i", false], [1, "cmdoption-copernicusmarine-subset-i", false]], "-nd": [[1, "cmdoption-copernicusmarine-get-nd", false]], "-o": [[1, "cmdoption-copernicusmarine-get-o", false], [1, "cmdoption-copernicusmarine-subset-o", false]], "-overwrite": [[1, "cmdoption-copernicusmarine-login-overwrite", false]], "-s": [[1, "cmdoption-copernicusmarine-get-s", false], [1, "cmdoption-copernicusmarine-subset-s", false]], "-t": [[1, "cmdoption-copernicusmarine-subset-T", false], [1, "cmdoption-copernicusmarine-subset-t", false]], "-v": [[1, "cmdoption-copernicusmarine-V", false], [1, "cmdoption-copernicusmarine-subset-v", false]], "-x": [[1, "cmdoption-copernicusmarine-subset-X", false], [1, "cmdoption-copernicusmarine-subset-x", false]], "-y": [[1, "cmdoption-copernicusmarine-subset-Y", false], [1, "cmdoption-copernicusmarine-subset-y", false]], "-z": [[1, "cmdoption-copernicusmarine-subset-Z", false], [1, "cmdoption-copernicusmarine-subset-z", false]], "coodinates_extent (copernicusmarine.responsesubset attribute)": [[5, "copernicusmarine.ResponseSubset.coodinates_extent", false]], "copernicusmarine": [[3, "module-copernicusmarine", false]], "copernicusmarine command line option": [[1, "cmdoption-copernicusmarine-V", false]], "copernicusmarine-describe command line option": [[1, "cmdoption-copernicusmarine-describe-a", false], [1, "cmdoption-copernicusmarine-describe-c", false], [1, "cmdoption-copernicusmarine-describe-disable-progress-bar", false], [1, "cmdoption-copernicusmarine-describe-include-datasets", false], [1, "cmdoption-copernicusmarine-describe-include-description", false], [1, "cmdoption-copernicusmarine-describe-include-keywords", false], [1, "cmdoption-copernicusmarine-describe-include-versions", false], [1, "cmdoption-copernicusmarine-describe-log-level", false]], "copernicusmarine-get command line option": [[1, "cmdoption-copernicusmarine-get-create-file-list", false], [1, "cmdoption-copernicusmarine-get-create-template", false], [1, "cmdoption-copernicusmarine-get-credentials-file", false], [1, "cmdoption-copernicusmarine-get-dataset-part", false], [1, "cmdoption-copernicusmarine-get-dataset-version", false], [1, "cmdoption-copernicusmarine-get-disable-progress-bar", false], [1, "cmdoption-copernicusmarine-get-dry-run", false], [1, "cmdoption-copernicusmarine-get-file-list", false], [1, "cmdoption-copernicusmarine-get-filter", false], [1, "cmdoption-copernicusmarine-get-force-download", false], [1, "cmdoption-copernicusmarine-get-i", false], [1, "cmdoption-copernicusmarine-get-index-parts", false], [1, "cmdoption-copernicusmarine-get-log-level", false], [1, "cmdoption-copernicusmarine-get-nd", false], [1, "cmdoption-copernicusmarine-get-o", false], [1, "cmdoption-copernicusmarine-get-overwrite-output-data", false], [1, "cmdoption-copernicusmarine-get-password", false], [1, "cmdoption-copernicusmarine-get-regex", false], [1, "cmdoption-copernicusmarine-get-request-file", false], [1, "cmdoption-copernicusmarine-get-s", false], [1, "cmdoption-copernicusmarine-get-show-outputnames", false], [1, "cmdoption-copernicusmarine-get-sync", false], [1, "cmdoption-copernicusmarine-get-sync-delete", false], [1, "cmdoption-copernicusmarine-get-username", false]], "copernicusmarine-login command line option": [[1, "cmdoption-copernicusmarine-login-configuration-file-directory", false], [1, "cmdoption-copernicusmarine-login-log-level", false], [1, "cmdoption-copernicusmarine-login-overwrite", false], [1, "cmdoption-copernicusmarine-login-password", false], [1, "cmdoption-copernicusmarine-login-skip-if-user-logged-in", false], [1, "cmdoption-copernicusmarine-login-username", false]], "copernicusmarine-subset command line option": [[1, "cmdoption-copernicusmarine-subset-T", false], [1, "cmdoption-copernicusmarine-subset-X", false], [1, "cmdoption-copernicusmarine-subset-Y", false], [1, "cmdoption-copernicusmarine-subset-Z", false], [1, "cmdoption-copernicusmarine-subset-bounding-box-method", false], [1, "cmdoption-copernicusmarine-subset-create-template", false], [1, "cmdoption-copernicusmarine-subset-credentials-file", false], [1, "cmdoption-copernicusmarine-subset-dataset-part", false], [1, "cmdoption-copernicusmarine-subset-dataset-version", false], [1, "cmdoption-copernicusmarine-subset-disable-progress-bar", false], [1, "cmdoption-copernicusmarine-subset-dry-run", false], [1, "cmdoption-copernicusmarine-subset-f", false], [1, "cmdoption-copernicusmarine-subset-file-format", false], [1, "cmdoption-copernicusmarine-subset-force-download", false], [1, "cmdoption-copernicusmarine-subset-i", false], [1, "cmdoption-copernicusmarine-subset-log-level", false], [1, "cmdoption-copernicusmarine-subset-motu-api-request", false], [1, "cmdoption-copernicusmarine-subset-netcdf-compression-enabled", false], [1, "cmdoption-copernicusmarine-subset-netcdf-compression-level", false], [1, "cmdoption-copernicusmarine-subset-netcdf3-compatible", false], [1, "cmdoption-copernicusmarine-subset-o", false], [1, "cmdoption-copernicusmarine-subset-overwrite-output-data", false], [1, "cmdoption-copernicusmarine-subset-password", false], [1, "cmdoption-copernicusmarine-subset-request-file", false], [1, "cmdoption-copernicusmarine-subset-s", false], [1, "cmdoption-copernicusmarine-subset-subset-method", false], [1, "cmdoption-copernicusmarine-subset-t", false], [1, "cmdoption-copernicusmarine-subset-username", false], [1, "cmdoption-copernicusmarine-subset-v", false], [1, "cmdoption-copernicusmarine-subset-vertical-dimension-as-originally-produced", false], [1, "cmdoption-copernicusmarine-subset-x", false], [1, "cmdoption-copernicusmarine-subset-y", false], [1, "cmdoption-copernicusmarine-subset-z", false]], "data_needed (copernicusmarine.responsesubset attribute)": [[5, "copernicusmarine.ResponseSubset.data_needed", false]], "datasetcoordinatesextent (class in copernicusmarine)": [[5, "copernicusmarine.DatasetCoordinatesExtent", false]], "depth (copernicusmarine.datasetcoordinatesextent attribute)": [[5, "copernicusmarine.DatasetCoordinatesExtent.depth", false]], "describe() (in module copernicusmarine)": [[3, "copernicusmarine.describe", false]], "elevation (copernicusmarine.datasetcoordinatesextent attribute)": [[5, "copernicusmarine.DatasetCoordinatesExtent.elevation", false]], "fileget (class in copernicusmarine)": [[5, "copernicusmarine.FileGet", false]], "files (copernicusmarine.responseget attribute)": [[5, "copernicusmarine.ResponseGet.files", false]], "geographicalextent (class in copernicusmarine)": [[5, "copernicusmarine.GeographicalExtent", false]], "get() (in module copernicusmarine)": [[3, "copernicusmarine.get", false]], "last_modified (copernicusmarine.fileget attribute)": [[5, "copernicusmarine.FileGet.last_modified", false]], "latitude (copernicusmarine.datasetcoordinatesextent attribute)": [[5, "copernicusmarine.DatasetCoordinatesExtent.latitude", false]], "login() (in module copernicusmarine)": [[3, "copernicusmarine.login", false]], "longitude (copernicusmarine.datasetcoordinatesextent attribute)": [[5, "copernicusmarine.DatasetCoordinatesExtent.longitude", false]], "maximum (copernicusmarine.geographicalextent attribute)": [[5, "copernicusmarine.GeographicalExtent.maximum", false]], "maximum (copernicusmarine.timeextent attribute)": [[5, "copernicusmarine.TimeExtent.maximum", false]], "minimum (copernicusmarine.geographicalextent attribute)": [[5, "copernicusmarine.GeographicalExtent.minimum", false]], "minimum (copernicusmarine.timeextent attribute)": [[5, "copernicusmarine.TimeExtent.minimum", false]], "module": [[3, "module-copernicusmarine", false]], "open_dataset() (in module copernicusmarine)": [[3, "copernicusmarine.open_dataset", false]], "output (copernicusmarine.fileget attribute)": [[5, "copernicusmarine.FileGet.output", false]], "output (copernicusmarine.responsesubset attribute)": [[5, "copernicusmarine.ResponseSubset.output", false]], "read_dataframe() (in module copernicusmarine)": [[3, "copernicusmarine.read_dataframe", false]], "responseget (class in copernicusmarine)": [[5, "copernicusmarine.ResponseGet", false]], "responsesubset (class in copernicusmarine)": [[5, "copernicusmarine.ResponseSubset", false]], "size (copernicusmarine.fileget attribute)": [[5, "copernicusmarine.FileGet.size", false]], "size (copernicusmarine.responsesubset attribute)": [[5, "copernicusmarine.ResponseSubset.size", false]], "subset() (in module copernicusmarine)": [[3, "copernicusmarine.subset", false]], "time (copernicusmarine.datasetcoordinatesextent attribute)": [[5, "copernicusmarine.DatasetCoordinatesExtent.time", false]], "timeextent (class in copernicusmarine)": [[5, "copernicusmarine.TimeExtent", false]], "url (copernicusmarine.fileget attribute)": [[5, "copernicusmarine.FileGet.url", false]]}, "objects": {"": [[3, 0, 0, "-", "copernicusmarine"]], "copernicusmarine": [[5, 1, 1, "", "DatasetCoordinatesExtent"], [5, 1, 1, "", "FileGet"], [5, 1, 1, "", "GeographicalExtent"], [5, 1, 1, "", "ResponseGet"], [5, 1, 1, "", "ResponseSubset"], [5, 1, 1, "", "TimeExtent"], [3, 3, 1, "", "describe"], [3, 3, 1, "", "get"], [3, 3, 1, "", "login"], [3, 3, 1, "", "open_dataset"], [3, 3, 1, "", "read_dataframe"], [3, 3, 1, "", "subset"], [1, 4, 1, "cmdoption-copernicusmarine-V", "--version"], [1, 4, 1, "cmdoption-copernicusmarine-V", "-V"]], "copernicusmarine-describe": [[1, 4, 1, "cmdoption-copernicusmarine-describe-c", "--contains"], [1, 4, 1, "cmdoption-copernicusmarine-describe-disable-progress-bar", "--disable-progress-bar"], [1, 4, 1, "cmdoption-copernicusmarine-describe-a", "--include-all"], [1, 4, 1, "cmdoption-copernicusmarine-describe-include-versions", "--include-all-versions"], [1, 4, 1, "cmdoption-copernicusmarine-describe-include-datasets", "--include-datasets"], [1, 4, 1, "cmdoption-copernicusmarine-describe-include-description", "--include-description"], [1, 4, 1, "cmdoption-copernicusmarine-describe-include-keywords", "--include-keywords"], [1, 4, 1, "cmdoption-copernicusmarine-describe-include-versions", "--include-versions"], [1, 4, 1, "cmdoption-copernicusmarine-describe-log-level", "--log-level"], [1, 4, 1, "cmdoption-copernicusmarine-describe-a", "-a"], [1, 4, 1, "cmdoption-copernicusmarine-describe-c", "-c"]], "copernicusmarine-get": [[1, 4, 1, "cmdoption-copernicusmarine-get-create-file-list", "--create-file-list"], [1, 4, 1, "cmdoption-copernicusmarine-get-create-template", "--create-template"], [1, 4, 1, "cmdoption-copernicusmarine-get-credentials-file", "--credentials-file"], [1, 4, 1, "cmdoption-copernicusmarine-get-i", "--dataset-id"], [1, 4, 1, "cmdoption-copernicusmarine-get-dataset-part", "--dataset-part"], [1, 4, 1, "cmdoption-copernicusmarine-get-dataset-version", "--dataset-version"], [1, 4, 1, "cmdoption-copernicusmarine-get-disable-progress-bar", "--disable-progress-bar"], [1, 4, 1, "cmdoption-copernicusmarine-get-dry-run", "--dry-run"], [1, 4, 1, "cmdoption-copernicusmarine-get-file-list", "--file-list"], [1, 4, 1, "cmdoption-copernicusmarine-get-filter", "--filter"], [1, 4, 1, "cmdoption-copernicusmarine-get-filter", "--filter-with-globbing-pattern"], [1, 4, 1, "cmdoption-copernicusmarine-get-regex", "--filter-with-regular-expression"], [1, 4, 1, "cmdoption-copernicusmarine-get-dataset-part", "--force-dataset-part"], [1, 4, 1, "cmdoption-copernicusmarine-get-dataset-version", "--force-dataset-version"], [1, 4, 1, "cmdoption-copernicusmarine-get-force-download", "--force-download"], [1, 4, 1, "cmdoption-copernicusmarine-get-s", "--force-service"], [1, 4, 1, "cmdoption-copernicusmarine-get-index-parts", "--index-parts"], [1, 4, 1, "cmdoption-copernicusmarine-get-log-level", "--log-level"], [1, 4, 1, "cmdoption-copernicusmarine-get-nd", "--no-directories"], [1, 4, 1, "cmdoption-copernicusmarine-get-o", "--output-directory"], [1, 4, 1, "cmdoption-copernicusmarine-get-overwrite-output-data", "--overwrite"], [1, 4, 1, "cmdoption-copernicusmarine-get-overwrite-output-data", "--overwrite-output-data"], [1, 4, 1, "cmdoption-copernicusmarine-get-password", "--password"], [1, 4, 1, "cmdoption-copernicusmarine-get-regex", "--regex"], [1, 4, 1, "cmdoption-copernicusmarine-get-request-file", "--request-file"], [1, 4, 1, "cmdoption-copernicusmarine-get-s", "--service"], [1, 4, 1, "cmdoption-copernicusmarine-get-show-outputnames", "--show-outputnames"], [1, 4, 1, "cmdoption-copernicusmarine-get-sync", "--sync"], [1, 4, 1, "cmdoption-copernicusmarine-get-sync-delete", "--sync-delete"], [1, 4, 1, "cmdoption-copernicusmarine-get-username", "--username"], [1, 4, 1, "cmdoption-copernicusmarine-get-i", "-i"], [1, 4, 1, "cmdoption-copernicusmarine-get-nd", "-nd"], [1, 4, 1, "cmdoption-copernicusmarine-get-o", "-o"], [1, 4, 1, "cmdoption-copernicusmarine-get-s", "-s"]], "copernicusmarine-login": [[1, 4, 1, "cmdoption-copernicusmarine-login-configuration-file-directory", "--configuration-file-directory"], [1, 4, 1, "cmdoption-copernicusmarine-login-log-level", "--log-level"], [1, 4, 1, "cmdoption-copernicusmarine-login-overwrite", "--overwrite-configuration-file"], [1, 4, 1, "cmdoption-copernicusmarine-login-password", "--password"], [1, 4, 1, "cmdoption-copernicusmarine-login-skip-if-user-logged-in", "--skip-if-user-logged-in"], [1, 4, 1, "cmdoption-copernicusmarine-login-username", "--username"], [1, 4, 1, "cmdoption-copernicusmarine-login-overwrite", "-overwrite"]], "copernicusmarine-subset": [[1, 4, 1, "cmdoption-copernicusmarine-subset-bounding-box-method", "--bounding-box-method"], [1, 4, 1, "cmdoption-copernicusmarine-subset-create-template", "--create-template"], [1, 4, 1, "cmdoption-copernicusmarine-subset-credentials-file", "--credentials-file"], [1, 4, 1, "cmdoption-copernicusmarine-subset-i", "--dataset-id"], [1, 4, 1, "cmdoption-copernicusmarine-subset-dataset-part", "--dataset-part"], [1, 4, 1, "cmdoption-copernicusmarine-subset-dataset-version", "--dataset-version"], [1, 4, 1, "cmdoption-copernicusmarine-subset-disable-progress-bar", "--disable-progress-bar"], [1, 4, 1, "cmdoption-copernicusmarine-subset-dry-run", "--dry-run"], [1, 4, 1, "cmdoption-copernicusmarine-subset-T", "--end-datetime"], [1, 4, 1, "cmdoption-copernicusmarine-subset-file-format", "--file-format"], [1, 4, 1, "cmdoption-copernicusmarine-subset-dataset-part", "--force-dataset-part"], [1, 4, 1, "cmdoption-copernicusmarine-subset-dataset-version", "--force-dataset-version"], [1, 4, 1, "cmdoption-copernicusmarine-subset-force-download", "--force-download"], [1, 4, 1, "cmdoption-copernicusmarine-subset-s", "--force-service"], [1, 4, 1, "cmdoption-copernicusmarine-subset-log-level", "--log-level"], [1, 4, 1, "cmdoption-copernicusmarine-subset-Z", "--maximal-depth"], [1, 4, 1, "cmdoption-copernicusmarine-subset-Y", "--maximal-latitude"], [1, 4, 1, "cmdoption-copernicusmarine-subset-X", "--maximal-longitude"], [1, 4, 1, "cmdoption-copernicusmarine-subset-Z", "--maximum-depth"], [1, 4, 1, "cmdoption-copernicusmarine-subset-Y", "--maximum-latitude"], [1, 4, 1, "cmdoption-copernicusmarine-subset-X", "--maximum-longitude"], [1, 4, 1, "cmdoption-copernicusmarine-subset-z", "--minimal-depth"], [1, 4, 1, "cmdoption-copernicusmarine-subset-y", "--minimal-latitude"], [1, 4, 1, "cmdoption-copernicusmarine-subset-x", "--minimal-longitude"], [1, 4, 1, "cmdoption-copernicusmarine-subset-z", "--minimum-depth"], [1, 4, 1, "cmdoption-copernicusmarine-subset-y", "--minimum-latitude"], [1, 4, 1, "cmdoption-copernicusmarine-subset-x", "--minimum-longitude"], [1, 4, 1, "cmdoption-copernicusmarine-subset-motu-api-request", "--motu-api-request"], [1, 4, 1, "cmdoption-copernicusmarine-subset-netcdf-compression-enabled", "--netcdf-compression-enabled"], [1, 4, 1, "cmdoption-copernicusmarine-subset-netcdf-compression-level", "--netcdf-compression-level"], [1, 4, 1, "cmdoption-copernicusmarine-subset-netcdf3-compatible", "--netcdf3-compatible"], [1, 4, 1, "cmdoption-copernicusmarine-subset-o", "--output-directory"], [1, 4, 1, "cmdoption-copernicusmarine-subset-f", "--output-filename"], [1, 4, 1, "cmdoption-copernicusmarine-subset-overwrite-output-data", "--overwrite"], [1, 4, 1, "cmdoption-copernicusmarine-subset-overwrite-output-data", "--overwrite-output-data"], [1, 4, 1, "cmdoption-copernicusmarine-subset-password", "--password"], [1, 4, 1, "cmdoption-copernicusmarine-subset-request-file", "--request-file"], [1, 4, 1, "cmdoption-copernicusmarine-subset-s", "--service"], [1, 4, 1, "cmdoption-copernicusmarine-subset-t", "--start-datetime"], [1, 4, 1, "cmdoption-copernicusmarine-subset-subset-method", "--subset-method"], [1, 4, 1, "cmdoption-copernicusmarine-subset-username", "--username"], [1, 4, 1, "cmdoption-copernicusmarine-subset-v", "--variable"], [1, 4, 1, "cmdoption-copernicusmarine-subset-vertical-dimension-as-originally-produced", "--vertical-dimension-as-originally-produced"], [1, 4, 1, "cmdoption-copernicusmarine-subset-T", "-T"], [1, 4, 1, "cmdoption-copernicusmarine-subset-X", "-X"], [1, 4, 1, "cmdoption-copernicusmarine-subset-Y", "-Y"], [1, 4, 1, "cmdoption-copernicusmarine-subset-Z", "-Z"], [1, 4, 1, "cmdoption-copernicusmarine-subset-f", "-f"], [1, 4, 1, "cmdoption-copernicusmarine-subset-i", "-i"], [1, 4, 1, "cmdoption-copernicusmarine-subset-o", "-o"], [1, 4, 1, "cmdoption-copernicusmarine-subset-s", "-s"], [1, 4, 1, "cmdoption-copernicusmarine-subset-t", "-t"], [1, 4, 1, "cmdoption-copernicusmarine-subset-v", "-v"], [1, 4, 1, "cmdoption-copernicusmarine-subset-x", "-x"], [1, 4, 1, "cmdoption-copernicusmarine-subset-y", "-y"], [1, 4, 1, "cmdoption-copernicusmarine-subset-z", "-z"]], "copernicusmarine.DatasetCoordinatesExtent": [[5, 2, 1, "", "depth"], [5, 2, 1, "", "elevation"], [5, 2, 1, "", "latitude"], [5, 2, 1, "", "longitude"], [5, 2, 1, "", "time"]], "copernicusmarine.FileGet": [[5, 2, 1, "", "last_modified"], [5, 2, 1, "", "output"], [5, 2, 1, "", "size"], [5, 2, 1, "", "url"]], "copernicusmarine.GeographicalExtent": [[5, 2, 1, "", "maximum"], [5, 2, 1, "", "minimum"]], "copernicusmarine.ResponseGet": [[5, 2, 1, "", "files"]], "copernicusmarine.ResponseSubset": [[5, 2, 1, "", "coodinates_extent"], [5, 2, 1, "", "data_needed"], [5, 2, 1, "", "output"], [5, 2, 1, "", "size"]], "copernicusmarine.TimeExtent": [[5, 2, 1, "", "maximum"], [5, 2, 1, "", "minimum"]]}, "objnames": {"0": ["py", "module", "Python module"], "1": ["py", "class", "Python class"], "2": ["py", "attribute", "Python attribute"], "3": ["py", "function", "Python function"], "4": ["std", "cmdoption", "program option"]}, "objtypes": {"0": "py:module", "1": "py:class", "2": "py:attribute", "3": "py:function", "4": "std:cmdoption"}, "terms": {"": 1, "0": [1, 3], "00": 1, "01": 1, "01t00": 1, "08": 1, "083deg_p1m": 5, "083deg_pt6h": 1, "1": [1, 3], "12": 1, "17": 1, "180": 1, "2022": 1, "3": [1, 2, 3], "30": 1, "31t23": 1, "35": 1, "36": 1, "360": 1, "3d": 1, "5": 1, "59": 1, "6": 1, "75": 1, "9": [1, 2, 3], "A": [1, 3], "By": 1, "For": [1, 3, 5], "If": [1, 3], "It": [1, 3, 5], "The": [1, 3, 5], "There": 2, "These": [1, 3], "To": 2, "_netrc": 1, "abl": 2, "about": 5, "absolut": 1, "accept": 1, "access": 3, "account": 0, "action": [1, 3], "add": 0, "all": [1, 3, 5], "allow": 1, "alreadi": [1, 3], "also": 3, "among": 1, "amount": 5, "an": [0, 1, 3], "ani": 3, "anyth": 5, "api": [1, 3], "appli": [1, 3], "ar": [1, 2, 3, 5], "arco": [1, 3], "arg": 1, "argument": 1, "ask": [1, 3], "attempt": [1, 3], "attribut": 1, "authent": 3, "avail": [1, 3], "avoid": 3, "axi": 1, "bar": [1, 3], "base": [1, 3], "befor": [1, 3], "bool": 3, "bound": [1, 3, 5], "bounding_box_method": [1, 3], "box": [1, 3], "c": [1, 2], "call": 3, "can": [1, 2, 3, 5], "care": 3, "catalog": 1, "catalogu": [1, 3], "caution": 1, "channel": 0, "check": [1, 3], "class": 5, "cli": [0, 5], "cmems_mod_glo_phi": [1, 5], "cmems_mod_nws_bgc": 1, "command": [0, 1], "common": 1, "compat": [1, 3], "complet": 1, "compress": [1, 3], "comput": 3, "concaten": 1, "concern": 5, "conda": 0, "configur": [1, 3], "configuration_file_directori": [1, 3], "confirm": [1, 3], "consol": 1, "consolid": 1, "construct": 4, "contain": [1, 3, 5], "coodinates_ext": 5, "coordin": 5, "copernicu": [1, 3, 5], "copernicusmarin": [0, 2, 3, 5], "copernicusmarine_service_password": [1, 3], "copernicusmarine_service_usernam": [1, 3], "correspond": 1, "creat": [0, 1, 3], "create_file_list": [1, 3], "credenti": [1, 3], "credentials_fil": [1, 3], "critic": 1, "csv": 1, "current": [1, 3], "custom": [1, 3], "d": 1, "data": [1, 3, 5], "data_need": 5, "dataclass": 1, "datafram": 3, "dataset": [1, 3, 5], "dataset_id": [1, 3], "dataset_part": [1, 3], "dataset_vers": [1, 3], "datasetcoordinatesext": 5, "datasetid": 1, "date": [1, 5], "datetim": [1, 3], "debug": 1, "default": [1, 3], "delet": [1, 3], "depth": [1, 3, 5], "descend": 1, "describ": [0, 3], "descript": [1, 3, 5], "destin": [1, 3], "detail": [0, 1, 3], "diato_p1m": 1, "dict": 3, "dictionari": 3, "dimens": [1, 3], "directli": [1, 3], "directori": [1, 3], "disabl": 1, "disable_progress_bar": 3, "displai": [1, 3], "do": 5, "doc": 1, "docker": 0, "dockerhub": 2, "document": [1, 3], "doubl": 1, "download": [1, 3, 5], "download_file_list": 3, "dry": [1, 5], "dry_run": [3, 5], "e": 1, "each": 3, "easili": 5, "either": 3, "elev": 5, "els": [1, 3], "enabl": [1, 3], "encapsul": 1, "end": [1, 3], "end_datetim": [1, 3], "ensur": 1, "entir": 3, "environ": [1, 3], "equival": 1, "error": 1, "estim": 5, "eustac": 1, "exact": 1, "exampl": [1, 5], "exclus": 1, "execut": 3, "exist": [1, 3], "exit": 1, "express": [1, 3], "extens": 3, "extract": 3, "f": 1, "fals": 3, "fetch": [1, 3], "file": [1, 3, 5], "file_format": [1, 3], "file_list": [1, 3], "fileget": 5, "filenam": [1, 3], "filter": [1, 3], "final": 5, "find": [1, 3], "flag": [1, 3, 5], "float": [1, 3, 5], "folder": 1, "follow": 1, "forc": [1, 3], "force_download": 3, "force_servic": 3, "forg": 0, "form": 5, "format": [1, 3], "found": [1, 3], "from": [1, 3], "full": 5, "fulli": [1, 3], "function": [1, 3], "geo": [1, 3], "geograph": [3, 5], "geographicalext": 5, "geoseri": 1, "get": [0, 3, 5], "get_templ": 1, "getrequest": 1, "given": [1, 3], "glo": 1, "glob": 1, "h": 1, "ha": 1, "have": 2, "here": 2, "hide": [1, 3], "hierarchi": 1, "higher": 2, "highest": [1, 3], "home": 1, "http": 1, "i": [1, 3, 5], "id": [1, 3], "identifi": 3, "immedi": 3, "includ": [1, 3], "include_al": 3, "include_dataset": 3, "include_descript": 3, "include_keyword": 3, "include_vers": 3, "index": [1, 3], "index_part": 3, "individu": 1, "info": 1, "inform": [1, 3, 5], "ini": 1, "input": [1, 3], "insid": [1, 3], "insitu": [1, 3], "instal": 0, "instead": [1, 3, 5], "int": 3, "interfac": 0, "interv": [1, 3, 5], "io": 1, "iso8601": 5, "item": 3, "its": [1, 3], "json": [1, 5], "keyword": [1, 3], "l4": 1, "last": 5, "last_modifi": 5, "latitud": [1, 3, 5], "lazi": 3, "level": [1, 3], "librari": 1, "limit": [1, 3], "line": [1, 3], "list": [1, 3, 5], "liter": 3, "load": 3, "local": [1, 3, 5], "locat": 5, "log": [1, 3], "log_level": 1, "login": [0, 3], "longitud": [1, 3, 5], "look": 1, "m": [1, 5], "mai": 3, "manag": 3, "mandatori": 3, "marin": [1, 3, 5], "match": [1, 3], "maxim": 1, "maximum": [1, 3, 5], "maximum_depth": [1, 3], "maximum_latitud": [1, 3], "maximum_longitud": [1, 3], "mb": 5, "mean": [1, 3], "memori": 3, "metadata": [3, 5], "method": [1, 3], "metoffic": 1, "minim": 1, "minimum": [1, 3, 5], "minimum_depth": [1, 3], "minimum_latitud": [1, 3], "minimum_longitud": [1, 3], "mode": 3, "modifi": 5, "more": [1, 3], "motu": [1, 3], "motu_api_request": [1, 3], "motucli": 1, "multipl": 1, "must": [1, 3], "mutual": 1, "my_json": 5, "name": [1, 3], "nc": 1, "nd": 1, "nearest": [1, 3], "need": [1, 2, 5], "netcdf": [1, 3], "netcdf3": 1, "netcdf3_compat": 3, "netcdf_compression_en": 3, "netcdf_compression_level": [1, 3], "netrc": 1, "new": 1, "no_directori": 3, "none": [1, 3, 5], "note": 1, "nrt": 1, "o": 1, "ob": 1, "ofth": 1, "omi": 1, "one": 1, "ones": 1, "onli": [1, 3], "open_dataset": [0, 3], "optim": 3, "option": [1, 3, 5], "organ": 3, "origin": [1, 3], "other": [1, 3], "ouput": 1, "output": [1, 3, 5], "output_directori": [1, 3], "output_filenam": [1, 3], "outputnam": 1, "outsid": [1, 3], "over": 1, "overwrit": [1, 3], "overwrite_configuration_fil": 3, "overwrite_output_data": 3, "overwritten": 1, "panda": 3, "paramet": 3, "pars": 1, "part": [1, 3], "pass": 1, "password": [1, 3], "path": [1, 3, 5], "pathlib": 3, "pattern": 1, "pendulum": 1, "perform": [1, 3], "pft_myint_7km": 1, "pip": 0, "pleas": [1, 3], "point": [1, 3], "posit": 1, "posixpath": 3, "possibl": 1, "preced": 1, "prefer": 3, "present": [1, 3], "print": 1, "process": [1, 3], "produc": [1, 3], "product": [1, 3], "progress": [1, 3], "protocol": 3, "provid": [1, 3], "pypi": 2, "python": [0, 1, 2], "queri": [1, 3, 5], "quick": 0, "quiet": 1, "quot": 1, "ram": 3, "rang": [1, 3], "rapid": 3, "read_datafram": [0, 3], "readm": [1, 3], "recreat": 1, "recurs": 1, "reduc": 1, "refer": [1, 3], "regex": [1, 3], "regist": 2, "regular": [1, 3], "relev": 5, "remot": [1, 3], "replac": 1, "request": [1, 3, 5], "request_fil": [1, 3], "requir": [1, 2, 3], "respons": 0, "responseget": [3, 5], "responsesubset": [3, 5], "restructuredtext": 0, "result": 5, "retriev": 3, "return": [1, 3, 5], "rjester": 3, "run": [1, 2, 3, 5], "save": [3, 5], "search": [1, 3], "see": [0, 1, 3], "select": 1, "sent": 5, "seri": [1, 3], "server": [1, 3, 5], "servic": [1, 3], "set": [1, 3], "sever": [1, 2], "short": 1, "should": 1, "show": 1, "show_outputnam": 3, "side": 5, "singl": 1, "size": 5, "skip": [1, 3], "skip_if_user_logged_in": 3, "some": 5, "soon": 3, "sourc": 3, "spatial": 3, "specif": [1, 3], "specifi": [1, 3], "sst": 1, "stage": 3, "standard": 1, "start": [0, 1, 3], "start_datetim": [1, 3], "static": 1, "stdout": 5, "store": [1, 3], "str": [3, 5], "strict": [1, 3], "strictli": [1, 3], "string": [1, 3, 5], "structur": 1, "subset": [0, 3, 5], "subset_method": [1, 3], "subset_templ": 1, "subsetrequest": 1, "subtyp": 0, "support": [1, 3], "sync": [1, 3], "sync_delet": 3, "synchron": [1, 3], "syntax": 0, "t": 1, "take": 1, "target": [1, 3], "templat": 1, "tempor": [1, 3], "temporari": [1, 3], "them": [1, 3], "thetao": 1, "thetao_anfc_0": [1, 5], "thi": [1, 3], "those": 5, "through": 1, "time": [1, 3, 5], "timeext": 5, "timeseri": 1, "token": 1, "toolbox": [1, 3, 5], "true": [1, 3], "txt": [1, 3], "type": [0, 3], "under": [1, 4], "union": 3, "uniqu": [1, 3], "unlik": 3, "url": [1, 5], "us": [0, 1, 2, 3, 5], "usag": 3, "user": [1, 3, 5], "usernam": [1, 3], "v": 1, "v2": 1, "valid": 1, "valu": [1, 3], "variabl": [1, 3], "variou": 3, "version": [1, 3], "vertic": [1, 3], "vertical_dimension_as_originally_produc": [1, 3], "via": [0, 1], "wai": 2, "warn": 1, "websit": 0, "when": [1, 3, 5], "where": [1, 3], "whether": 3, "which": [1, 3], "while": [1, 3], "within": 1, "without": [1, 3, 5], "write": [1, 3], "x": 1, "xarrai": 3, "y": 1, "you": [1, 2, 3, 5], "your": [0, 1, 3], "z": 1, "zarr": [1, 3]}, "titles": ["Copernicus Marine Toolbox documentation", "CLI", "Installing Copernicus Marine Toolbox", "Python Interface", "Quick Start", "Response Types"], "titleterms": {"account": 2, "an": 2, "channel": 2, "cli": 1, "command": 5, "conda": 2, "content": 0, "copernicu": [0, 2], "copernicusmarin": 1, "creat": 2, "describ": 1, "docker": 2, "document": 0, "forg": 2, "get": 1, "instal": 2, "interfac": 3, "login": 1, "marin": [0, 2], "pip": 2, "python": 3, "quick": 4, "respons": 5, "start": 4, "subset": 1, "subtyp": 5, "toolbox": [0, 2], "type": 5, "via": 2, "websit": 2}})
diff --git a/doc/_build/html/usage/command-line-interface.html b/doc/_build/html/usage/command-line-interface.html
index b5413400..6ea1a85c 100644
--- a/doc/_build/html/usage/command-line-interface.html
+++ b/doc/_build/html/usage/command-line-interface.html
@@ -204,6 +204,7 @@
 <li class="toctree-l1"><a class="reference internal" href="quickstart.html">Quick Start</a></li>
 <li class="toctree-l1 current current-page"><a class="current reference internal" href="#">CLI</a></li>
 <li class="toctree-l1"><a class="reference internal" href="python-interface.html">Python Interface</a></li>
+<li class="toctree-l1"><a class="reference internal" href="response_types.html">Response Types</a></li>
 </ul>
 
 </div>
@@ -490,13 +491,24 @@ <h4>subset<a class="headerlink" href="#copernicusmarine-subset" title="Link to t
 <dl class="std option">
 <dt class="sig sig-object std" id="cmdoption-copernicusmarine-subset-t">
 <span id="cmdoption-copernicusmarine-subset-start-datetime"></span><span class="sig-name descname"><span class="pre">-t</span></span><span class="sig-prename descclassname"></span><span class="sig-prename descclassname"><span class="pre">,</span> </span><span class="sig-name descname"><span class="pre">--start-datetime</span></span><span class="sig-prename descclassname"> <span class="pre">&lt;start_datetime&gt;</span></span><a class="headerlink" href="#cmdoption-copernicusmarine-subset-t" title="Link to this definition">¶</a></dt>
-<dd><p>The start datetime of the temporal subset. Caution: encapsulate date with “ “ to ensure valid expression for format “%Y-%m-%d %H:%M:%S”.</p>
+<dd><p>The start datetime of the temporal subset. Caution: encapsulate date with “ “ to ensure valid expression for format “%Y-%m-%d %H:%M:%S”. Supports common format parsed by pendulum. See <a class="reference external" href="https://pendulum.eustace.io/docs/#parsing">https://pendulum.eustace.io/docs/#parsing</a></p>
 </dd></dl>
 
 <dl class="std option">
 <dt class="sig sig-object std" id="cmdoption-copernicusmarine-subset-T">
 <span id="cmdoption-copernicusmarine-subset-end-datetime"></span><span class="sig-name descname"><span class="pre">-T</span></span><span class="sig-prename descclassname"></span><span class="sig-prename descclassname"><span class="pre">,</span> </span><span class="sig-name descname"><span class="pre">--end-datetime</span></span><span class="sig-prename descclassname"> <span class="pre">&lt;end_datetime&gt;</span></span><a class="headerlink" href="#cmdoption-copernicusmarine-subset-T" title="Link to this definition">¶</a></dt>
-<dd><p>The end datetime of the temporal subset. Caution: encapsulate date with “ “ to ensure valid expression for format “%Y-%m-%d %H:%M:%S”.</p>
+<dd><p>The end datetime of the temporal subset. Caution: encapsulate date with “ “ to ensure valid expression for format “%Y-%m-%d %H:%M:%S”. Supports common format parsed by pendulum. See <a class="reference external" href="https://pendulum.eustace.io/docs/#parsing">https://pendulum.eustace.io/docs/#parsing</a></p>
+</dd></dl>
+
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-copernicusmarine-subset-bounding-box-method">
+<span class="sig-name descname"><span class="pre">--bounding-box-method</span></span><span class="sig-prename descclassname"> <span class="pre">&lt;bounding_box_method&gt;</span></span><a class="headerlink" href="#cmdoption-copernicusmarine-subset-bounding-box-method" title="Link to this definition">¶</a></dt>
+<dd><p>The bounding box method when requesting the dataset.If ‘inside’ (by default), it will returned the inside interval. If ‘nearest’, the limits ofthe requested interval will be the nearest points of the dataset. If ‘outside’, it will return all the data such that the requested interval is fully included. Check the documentation for more details.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Options<span class="colon">:</span></dt>
+<dd class="field-odd"><p>inside | nearest | outside</p>
+</dd>
+</dl>
 </dd></dl>
 
 <dl class="std option">
@@ -575,6 +587,12 @@ <h4>subset<a class="headerlink" href="#copernicusmarine-subset" title="Link to t
 <dd><p>Option to pass a complete MOTU API request as a string. Caution, user has to replace double quotes “ with single quotes ‘ in the request.</p>
 </dd></dl>
 
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-copernicusmarine-subset-dry-run">
+<span class="sig-name descname"><span class="pre">--dry-run</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-copernicusmarine-subset-dry-run" title="Link to this definition">¶</a></dt>
+<dd><p>Runs query without downloading data.</p>
+</dd></dl>
+
 <dl class="std option">
 <dt class="sig sig-object std" id="cmdoption-copernicusmarine-subset-disable-progress-bar">
 <span class="sig-name descname"><span class="pre">--disable-progress-bar</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-copernicusmarine-subset-disable-progress-bar" title="Link to this definition">¶</a></dt>
@@ -777,6 +795,12 @@ <h4>get<a class="headerlink" href="#copernicusmarine-get" title="Link to this he
 <dd><p>Option to get the index files of an INSITU dataset. Temporary option.</p>
 </dd></dl>
 
+<dl class="std option">
+<dt class="sig sig-object std" id="cmdoption-copernicusmarine-get-dry-run">
+<span class="sig-name descname"><span class="pre">--dry-run</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-copernicusmarine-get-dry-run" title="Link to this definition">¶</a></dt>
+<dd><p>Runs query without downloading data.</p>
+</dd></dl>
+
 <dl class="std option">
 <dt class="sig sig-object std" id="cmdoption-copernicusmarine-get-disable-progress-bar">
 <span class="sig-name descname"><span class="pre">--disable-progress-bar</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-copernicusmarine-get-disable-progress-bar" title="Link to this definition">¶</a></dt>
diff --git a/doc/_build/html/usage/installation.html b/doc/_build/html/usage/installation.html
index f3cdb83b..ef419688 100644
--- a/doc/_build/html/usage/installation.html
+++ b/doc/_build/html/usage/installation.html
@@ -204,6 +204,7 @@
 <li class="toctree-l1"><a class="reference internal" href="quickstart.html">Quick Start</a></li>
 <li class="toctree-l1"><a class="reference internal" href="command-line-interface.html">CLI</a></li>
 <li class="toctree-l1"><a class="reference internal" href="python-interface.html">Python Interface</a></li>
+<li class="toctree-l1"><a class="reference internal" href="response_types.html">Response Types</a></li>
 </ul>
 
 </div>
diff --git a/doc/_build/html/usage/python-interface.html b/doc/_build/html/usage/python-interface.html
index de336386..13f62517 100644
--- a/doc/_build/html/usage/python-interface.html
+++ b/doc/_build/html/usage/python-interface.html
@@ -3,7 +3,7 @@
   <head><meta charset="utf-8"/>
     <meta name="viewport" content="width=device-width,initial-scale=1"/>
     <meta name="color-scheme" content="light dark"><meta name="viewport" content="width=device-width, initial-scale=1" />
-<link rel="index" title="Index" href="../genindex.html" /><link rel="search" title="Search" href="../search.html" /><link rel="prev" title="CLI" href="command-line-interface.html" />
+<link rel="index" title="Index" href="../genindex.html" /><link rel="search" title="Search" href="../search.html" /><link rel="next" title="Response Types" href="response_types.html" /><link rel="prev" title="CLI" href="command-line-interface.html" />
 
     <!-- Generated with Sphinx 7.4.7 and Furo 2024.08.06 -->
         <title>Python Interface - Copernicus Marine Toolbox documentation</title>
@@ -204,6 +204,7 @@
 <li class="toctree-l1"><a class="reference internal" href="quickstart.html">Quick Start</a></li>
 <li class="toctree-l1"><a class="reference internal" href="command-line-interface.html">CLI</a></li>
 <li class="toctree-l1 current current-page"><a class="current reference internal" href="#">Python Interface</a></li>
+<li class="toctree-l1"><a class="reference internal" href="response_types.html">Response Types</a></li>
 </ul>
 
 </div>
@@ -274,7 +275,7 @@
 
 <dl class="py function">
 <dt class="sig sig-object py" id="copernicusmarine.get">
-<span class="sig-prename descclassname"><span class="pre">copernicusmarine.</span></span><span class="sig-name descname"><span class="pre">get</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">dataset_id</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">dataset_version</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">dataset_part</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">username</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">password</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">no_directories</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">bool</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">False</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">show_outputnames</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">bool</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">False</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">output_directory</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">Path</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">credentials_file</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">Path</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">force_download</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">bool</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">False</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">overwrite_output_data</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">bool</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">False</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">request_file</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">Path</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">service</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">filter</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">regex</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">file_list</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">Path</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">create_file_list</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">download_file_list</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">bool</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">False</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">index_parts</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">bool</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">False</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">sync</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">bool</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">False</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">sync_delete</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">bool</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">False</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">disable_progress_bar</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">bool</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">False</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">staging</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">bool</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">False</span></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><span class="pre">List</span><span class="p"><span class="pre">[</span></span><span class="pre">Path</span><span class="p"><span class="pre">]</span></span></span></span><a class="headerlink" href="#copernicusmarine.get" title="Link to this definition">¶</a></dt>
+<span class="sig-prename descclassname"><span class="pre">copernicusmarine.</span></span><span class="sig-name descname"><span class="pre">get</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">dataset_id</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">dataset_version</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">dataset_part</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">username</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">password</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">no_directories</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">bool</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">False</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">show_outputnames</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">bool</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">False</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">output_directory</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">Path</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">credentials_file</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">Path</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">force_download</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">bool</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">False</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">overwrite_output_data</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">bool</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">False</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">request_file</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">Path</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">service</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">filter</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">regex</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">file_list</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">Path</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">create_file_list</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">download_file_list</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">bool</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">False</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">index_parts</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">bool</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">False</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">sync</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">bool</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">False</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">sync_delete</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">bool</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">False</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">dry_run</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">bool</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">False</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">disable_progress_bar</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">bool</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">False</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">staging</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">bool</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">False</span></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><a class="reference internal" href="response_types.html#copernicusmarine.ResponseGet" title="copernicusmarine.core_functions.models.ResponseGet"><span class="pre">ResponseGet</span></a></span></span><a class="headerlink" href="#copernicusmarine.get" title="Link to this definition">¶</a></dt>
 <dd><p>Fetches data from the Copernicus Marine server based on the provided parameters.</p>
 <dl class="field-list simple">
 <dt class="field-odd">Parameters<span class="colon">:</span></dt>
@@ -299,6 +300,8 @@
 <li><p><strong>index_parts</strong> (<em>bool</em><em>, </em><em>optional</em>) – If True, download index files. Only for INSITU datasets. Temporary option.</p></li>
 <li><p><strong>sync</strong> (<em>bool</em><em>, </em><em>optional</em>) – If True, synchronize the local directory with the remote directory.</p></li>
 <li><p><strong>sync_delete</strong> (<em>bool</em><em>, </em><em>optional</em>) – If True, delete local files that are not present on the remote server while applying sync.</p></li>
+<li><p><strong>dry_run</strong> (<em>bool</em><em>, </em><em>optional</em>) – If True, runs query without downloading data..</p></li>
+<li><p><strong>disable_progress_bar</strong> (<em>bool</em><em>, </em><em>optional</em>) – Flag to hide progress bar.</p></li>
 </ul>
 </dd>
 <dt class="field-even">Returns<span class="colon">:</span></dt>
@@ -329,7 +332,7 @@
 
 <dl class="py function">
 <dt class="sig sig-object py" id="copernicusmarine.open_dataset">
-<span class="sig-prename descclassname"><span class="pre">copernicusmarine.</span></span><span class="sig-name descname"><span class="pre">open_dataset</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">dataset_id</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">dataset_version</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">dataset_part</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">username</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">password</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">variables</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">List</span><span class="p"><span class="pre">[</span></span><span class="pre">str</span><span class="p"><span class="pre">]</span></span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">minimum_longitude</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">float</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">maximum_longitude</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">float</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">minimum_latitude</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">float</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">maximum_latitude</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">float</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">minimum_depth</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">float</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">maximum_depth</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">float</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">vertical_dimension_as_originally_produced</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">bool</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">True</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">start_datetime</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">datetime</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">end_datetime</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">datetime</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">subset_method</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">Literal</span><span class="p"><span class="pre">[</span></span><span class="s"><span class="pre">'nearest'</span></span><span class="p"><span class="pre">,</span></span><span class="w"> </span><span class="s"><span class="pre">'strict'</span></span><span class="p"><span class="pre">]</span></span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">'nearest'</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">service</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">credentials_file</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">Path</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><span class="pre">Dataset</span></span></span><a class="headerlink" href="#copernicusmarine.open_dataset" title="Link to this definition">¶</a></dt>
+<span class="sig-prename descclassname"><span class="pre">copernicusmarine.</span></span><span class="sig-name descname"><span class="pre">open_dataset</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">dataset_id</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">dataset_version</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">dataset_part</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">username</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">password</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">variables</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">List</span><span class="p"><span class="pre">[</span></span><span class="pre">str</span><span class="p"><span class="pre">]</span></span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">minimum_longitude</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">float</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">maximum_longitude</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">float</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">minimum_latitude</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">float</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">maximum_latitude</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">float</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">minimum_depth</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">float</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">maximum_depth</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">float</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">vertical_dimension_as_originally_produced</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">bool</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">True</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">start_datetime</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">datetime</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">end_datetime</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">datetime</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">bounding_box_method</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">Literal</span><span class="p"><span class="pre">[</span></span><span class="s"><span class="pre">'inside'</span></span><span class="p"><span class="pre">,</span></span><span class="w"> </span><span class="s"><span class="pre">'nearest'</span></span><span class="p"><span class="pre">,</span></span><span class="w"> </span><span class="s"><span class="pre">'outside'</span></span><span class="p"><span class="pre">]</span></span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">'inside'</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">subset_method</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">Literal</span><span class="p"><span class="pre">[</span></span><span class="s"><span class="pre">'nearest'</span></span><span class="p"><span class="pre">,</span></span><span class="w"> </span><span class="s"><span class="pre">'strict'</span></span><span class="p"><span class="pre">]</span></span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">'nearest'</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">service</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">credentials_file</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">Path</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><span class="pre">Dataset</span></span></span><a class="headerlink" href="#copernicusmarine.open_dataset" title="Link to this definition">¶</a></dt>
 <dd><p>Load an xarray dataset using “lazy-loading” mode from a Copernicus Marine data source using either the ARCO series protocol.</p>
 <p>This means that data is only loaded into memory when a computation is called, optimizing RAM usage by avoiding immediate loading. It supports various parameters for customization, such as specifying geographical bounds, temporal range, depth range, and more.</p>
 <dl class="field-list simple">
@@ -347,6 +350,7 @@
 <li><p><strong>maximum_latitude</strong> (<em>float</em><em>, </em><em>optional</em>) – The maximum latitude for subsetting the data.</p></li>
 <li><p><strong>minimum_depth</strong> (<em>float</em><em>, </em><em>optional</em>) – The minimum depth for subsetting the data.</p></li>
 <li><p><strong>maximum_depth</strong> (<em>float</em><em>, </em><em>optional</em>) – The maximum depth for subsetting the data.</p></li>
+<li><p><strong>bounding_box_method</strong> (<em>str</em><em>, </em><em>optional</em>) – The bounding box method when requesting the dataset. If ‘inside’ (by default), it will returned the inside interval. If ‘nearest’, the limits of the requested interval will be the nearest points of the dataset. If ‘outside’, it will return all the data such that the requested interval is fully included. Check the documentation for more details.</p></li>
 <li><p><strong>subset_method</strong> (<em>str</em><em>, </em><em>optional</em>) – The subset method (‘nearest’ or ‘strict’) when requesting the dataset. If strict, you can only request dimension strictly inside the dataset.</p></li>
 <li><p><strong>vertical_dimension_as_originally_produced</strong> (<em>bool</em><em>, </em><em>optional</em>) – If True, use the vertical dimension as originally produced.</p></li>
 <li><p><strong>start_datetime</strong> (<em>datetime</em><em>, </em><em>optional</em>) – The start datetime for temporal subsetting.</p></li>
@@ -366,7 +370,7 @@
 
 <dl class="py function">
 <dt class="sig sig-object py" id="copernicusmarine.read_dataframe">
-<span class="sig-prename descclassname"><span class="pre">copernicusmarine.</span></span><span class="sig-name descname"><span class="pre">read_dataframe</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">dataset_id</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">dataset_version</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">dataset_part</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">username</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">password</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">variables</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">List</span><span class="p"><span class="pre">[</span></span><span class="pre">str</span><span class="p"><span class="pre">]</span></span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">minimum_longitude</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">float</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">maximum_longitude</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">float</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">minimum_latitude</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">float</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">maximum_latitude</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">float</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">minimum_depth</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">float</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">maximum_depth</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">float</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">vertical_dimension_as_originally_produced</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">bool</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">True</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">start_datetime</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">datetime</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">end_datetime</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">datetime</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">subset_method</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">Literal</span><span class="p"><span class="pre">[</span></span><span class="s"><span class="pre">'nearest'</span></span><span class="p"><span class="pre">,</span></span><span class="w"> </span><span class="s"><span class="pre">'strict'</span></span><span class="p"><span class="pre">]</span></span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">'nearest'</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">force_service</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">credentials_file</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">Path</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><span class="pre">DataFrame</span></span></span><a class="headerlink" href="#copernicusmarine.read_dataframe" title="Link to this definition">¶</a></dt>
+<span class="sig-prename descclassname"><span class="pre">copernicusmarine.</span></span><span class="sig-name descname"><span class="pre">read_dataframe</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">dataset_id</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">dataset_version</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">dataset_part</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">username</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">password</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">variables</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">List</span><span class="p"><span class="pre">[</span></span><span class="pre">str</span><span class="p"><span class="pre">]</span></span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">minimum_longitude</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">float</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">maximum_longitude</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">float</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">minimum_latitude</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">float</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">maximum_latitude</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">float</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">minimum_depth</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">float</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">maximum_depth</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">float</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">vertical_dimension_as_originally_produced</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">bool</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">True</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">start_datetime</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">datetime</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">end_datetime</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">datetime</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">bounding_box_method</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">Literal</span><span class="p"><span class="pre">[</span></span><span class="s"><span class="pre">'inside'</span></span><span class="p"><span class="pre">,</span></span><span class="w"> </span><span class="s"><span class="pre">'nearest'</span></span><span class="p"><span class="pre">,</span></span><span class="w"> </span><span class="s"><span class="pre">'outside'</span></span><span class="p"><span class="pre">]</span></span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">'inside'</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">subset_method</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">Literal</span><span class="p"><span class="pre">[</span></span><span class="s"><span class="pre">'nearest'</span></span><span class="p"><span class="pre">,</span></span><span class="w"> </span><span class="s"><span class="pre">'strict'</span></span><span class="p"><span class="pre">]</span></span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">'nearest'</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">force_service</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">credentials_file</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">Path</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><span class="pre">DataFrame</span></span></span><a class="headerlink" href="#copernicusmarine.read_dataframe" title="Link to this definition">¶</a></dt>
 <dd><p>Immediately loads a Pandas DataFrame into memory from a specified dataset.</p>
 <p>Unlike “lazy-loading”, the data is loaded as soon as this function is executed, which may be preferable when rapid access to the entire dataset is required, but may require careful memory management.</p>
 <dl class="field-list simple">
@@ -387,6 +391,7 @@
 <li><p><strong>vertical_dimension_as_originally_produced</strong> (<em>bool</em><em>, </em><em>optional</em>) – If True, use the vertical dimension as originally produced.</p></li>
 <li><p><strong>start_datetime</strong> (<em>datetime</em><em>, </em><em>optional</em>) – Start datetime for temporal subset.</p></li>
 <li><p><strong>end_datetime</strong> (<em>datetime</em><em>, </em><em>optional</em>) – End datetime for temporal subset.</p></li>
+<li><p><strong>bounding_box_method</strong> (<em>str</em><em>, </em><em>optional</em>) – The bounding box method when requesting the dataset. If ‘inside’ (by default), it will returned the inside interval. If ‘nearest’, the limits of the requested interval will be the nearest points of the dataset. If ‘outside’, it will return all the data such that the requested interval is fully included. Check the documentation for more details.</p></li>
 <li><p><strong>subset_method</strong> (<em>str</em><em>, </em><em>optional</em>) – The subset method (‘nearest’ or ‘strict’) when requesting the dataset. If strict, you can only request dimension strictly inside the dataset.</p></li>
 <li><p><strong>force_service</strong> (<em>str</em><em>, </em><em>optional</em>) – Force a specific service for data download.</p></li>
 <li><p><strong>credentials_file</strong> (<em>Union</em><em>[</em><em>pathlib.Path</em><em>, </em><em>str</em><em>]</em><em>, </em><em>optional</em>) – Path to a credentials file for authentication.</p></li>
@@ -403,7 +408,7 @@
 
 <dl class="py function">
 <dt class="sig sig-object py" id="copernicusmarine.subset">
-<span class="sig-prename descclassname"><span class="pre">copernicusmarine.</span></span><span class="sig-name descname"><span class="pre">subset</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">dataset_id</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">dataset_version</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">dataset_part</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">username</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">password</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">variables</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">List</span><span class="p"><span class="pre">[</span></span><span class="pre">str</span><span class="p"><span class="pre">]</span></span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">minimum_longitude</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">float</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">maximum_longitude</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">float</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">minimum_latitude</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">float</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">maximum_latitude</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">float</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">minimum_depth</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">float</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">maximum_depth</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">float</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">vertical_dimension_as_originally_produced</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">bool</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">True</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">start_datetime</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">datetime</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">end_datetime</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">datetime</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">subset_method</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">Literal</span><span class="p"><span class="pre">[</span></span><span class="s"><span class="pre">'nearest'</span></span><span class="p"><span class="pre">,</span></span><span class="w"> </span><span class="s"><span class="pre">'strict'</span></span><span class="p"><span class="pre">]</span></span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">'nearest'</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">output_filename</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">file_format</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">Literal</span><span class="p"><span class="pre">[</span></span><span class="s"><span class="pre">'netcdf'</span></span><span class="p"><span class="pre">,</span></span><span class="w"> </span><span class="s"><span class="pre">'zarr'</span></span><span class="p"><span class="pre">]</span></span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">'netcdf'</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">service</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">request_file</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">Path</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">output_directory</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">Path</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">credentials_file</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">Path</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">motu_api_request</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">force_download</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">bool</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">False</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">overwrite_output_data</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">bool</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">False</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">disable_progress_bar</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">bool</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">False</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">staging</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">bool</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">False</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">netcdf_compression_enabled</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">bool</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">False</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">netcdf_compression_level</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">int</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">netcdf3_compatible</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">bool</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">False</span></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><span class="pre">Path</span></span></span><a class="headerlink" href="#copernicusmarine.subset" title="Link to this definition">¶</a></dt>
+<span class="sig-prename descclassname"><span class="pre">copernicusmarine.</span></span><span class="sig-name descname"><span class="pre">subset</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">dataset_id</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">dataset_version</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">dataset_part</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">username</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">password</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">variables</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">List</span><span class="p"><span class="pre">[</span></span><span class="pre">str</span><span class="p"><span class="pre">]</span></span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">minimum_longitude</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">float</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">maximum_longitude</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">float</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">minimum_latitude</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">float</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">maximum_latitude</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">float</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">minimum_depth</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">float</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">maximum_depth</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">float</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">vertical_dimension_as_originally_produced</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">bool</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">True</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">start_datetime</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">datetime</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">end_datetime</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">datetime</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">bounding_box_method</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">Literal</span><span class="p"><span class="pre">[</span></span><span class="s"><span class="pre">'inside'</span></span><span class="p"><span class="pre">,</span></span><span class="w"> </span><span class="s"><span class="pre">'nearest'</span></span><span class="p"><span class="pre">,</span></span><span class="w"> </span><span class="s"><span class="pre">'outside'</span></span><span class="p"><span class="pre">]</span></span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">'inside'</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">subset_method</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">Literal</span><span class="p"><span class="pre">[</span></span><span class="s"><span class="pre">'nearest'</span></span><span class="p"><span class="pre">,</span></span><span class="w"> </span><span class="s"><span class="pre">'strict'</span></span><span class="p"><span class="pre">]</span></span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">'nearest'</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">output_filename</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">file_format</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">Literal</span><span class="p"><span class="pre">[</span></span><span class="s"><span class="pre">'netcdf'</span></span><span class="p"><span class="pre">,</span></span><span class="w"> </span><span class="s"><span class="pre">'zarr'</span></span><span class="p"><span class="pre">]</span></span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">'netcdf'</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">service</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">request_file</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">Path</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">output_directory</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">Path</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">credentials_file</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">Path</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">motu_api_request</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">force_download</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">bool</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">False</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">overwrite_output_data</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">bool</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">False</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">dry_run</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">bool</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">False</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">disable_progress_bar</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">bool</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">False</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">staging</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">bool</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">False</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">netcdf_compression_enabled</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">bool</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">False</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">netcdf_compression_level</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">int</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">netcdf3_compatible</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><span class="pre">bool</span></span><span class="w"> </span><span class="o"><span class="pre">=</span></span><span class="w"> </span><span class="default_value"><span class="pre">False</span></span></em><span class="sig-paren">)</span> <span class="sig-return"><span class="sig-return-icon">&#x2192;</span> <span class="sig-return-typehint"><a class="reference internal" href="response_types.html#copernicusmarine.ResponseSubset" title="copernicusmarine.core_functions.models.ResponseSubset"><span class="pre">ResponseSubset</span></a></span></span><a class="headerlink" href="#copernicusmarine.subset" title="Link to this definition">¶</a></dt>
 <dd><p>Extracts a subset of data from a specified dataset using given parameters.</p>
 <dl class="field-list simple">
 <dt class="field-odd">Parameters<span class="colon">:</span></dt>
@@ -429,20 +434,22 @@
 <li><p><strong>vertical_dimension_as_originally_produced</strong> (<em>bool</em><em>, </em><em>optional</em>) – Use original vertical dimension.</p></li>
 <li><p><strong>start_datetime</strong> (<em>datetime</em><em>, </em><em>optional</em>) – Start datetime for temporal subset.</p></li>
 <li><p><strong>end_datetime</strong> (<em>datetime</em><em>, </em><em>optional</em>) – End datetime for temporal subset.</p></li>
+<li><p><strong>bounding_box_method</strong> (<em>str</em><em>, </em><em>optional</em>) – The bounding box method when requesting the dataset. If ‘inside’ (by default), it will returned the inside interval. If ‘nearest’, the limits of the requested interval will be the nearest points of the dataset. If ‘outside’, it will return all the data such that the requested interval is fully included. Check the documentation for more details.</p></li>
 <li><p><strong>subset_method</strong> (<em>str</em><em>, </em><em>optional</em>) – The subset method (‘nearest’ or ‘strict’) when requesting the dataset. If strict, you can only request dimension strictly inside the dataset.</p></li>
 <li><p><strong>output_filename</strong> (<em>str</em><em>, </em><em>optional</em>) – Output filename for the subsetted data.</p></li>
 <li><p><strong>file_format</strong> (<em>str</em><em>, </em><em>optional</em>) – Extension format for the filename.</p></li>
 <li><p><strong>motu_api_request</strong> (<em>str</em><em>, </em><em>optional</em>) – MOTU API request string.</p></li>
+<li><p><strong>dry_run</strong> (<em>bool</em><em>, </em><em>optional</em>) – If True, runs query without downloading data.</p></li>
 <li><p><strong>netcdf_compression_enabled</strong> (<em>bool</em><em>, </em><em>optional</em>) – Enable compression level 1 to the NetCDF output file. Use ‘netcdf_compression_level’ option to customize the compression level.</p></li>
 <li><p><strong>netcdf_compression_level</strong> (<em>int</em><em>, </em><em>optional</em>) – Specify a compression level to apply on the NetCDF output file. A value of 0 means no compression, and 9 is the highest level of compression available.</p></li>
 <li><p><strong>netcdf3_compatible</strong> (<em>bool</em><em>, </em><em>optional</em>) – Enable downloading the dataset in a netCDF 3 compatible format.</p></li>
 </ul>
 </dd>
 <dt class="field-even">Returns<span class="colon">:</span></dt>
-<dd class="field-even"><p>Path to the generated subsetted data file.</p>
+<dd class="field-even"><p>A description of the downloaded data and its destination</p>
 </dd>
 <dt class="field-odd">Return type<span class="colon">:</span></dt>
-<dd class="field-odd"><p>pathlib.Path</p>
+<dd class="field-odd"><p><a class="reference internal" href="response_types.html#copernicusmarine.ResponseSubset" title="copernicusmarine.ResponseSubset">ResponseSubset</a></p>
 </dd>
 </dl>
 </dd></dl>
@@ -454,7 +461,15 @@
       <footer>
 
         <div class="related-pages">
-
+          <a class="next-page" href="response_types.html">
+              <div class="page-info">
+                <div class="context">
+                  <span>Next</span>
+                </div>
+                <div class="title">Response Types</div>
+              </div>
+              <svg class="furo-related-icon"><use href="#svg-arrow-right"></use></svg>
+            </a>
           <a class="prev-page" href="command-line-interface.html">
               <svg class="furo-related-icon"><use href="#svg-arrow-right"></use></svg>
               <div class="page-info">
diff --git a/doc/_build/html/usage/quickstart.html b/doc/_build/html/usage/quickstart.html
index 601d83cd..5c7e3e09 100644
--- a/doc/_build/html/usage/quickstart.html
+++ b/doc/_build/html/usage/quickstart.html
@@ -204,6 +204,7 @@
 <li class="toctree-l1 current current-page"><a class="current reference internal" href="#">Quick Start</a></li>
 <li class="toctree-l1"><a class="reference internal" href="command-line-interface.html">CLI</a></li>
 <li class="toctree-l1"><a class="reference internal" href="python-interface.html">Python Interface</a></li>
+<li class="toctree-l1"><a class="reference internal" href="response_types.html">Response Types</a></li>
 </ul>
 
 </div>
diff --git a/doc/_build/html/usage/response_types.html b/doc/_build/html/usage/response_types.html
new file mode 100644
index 00000000..9fc0b3f6
--- /dev/null
+++ b/doc/_build/html/usage/response_types.html
@@ -0,0 +1,517 @@
+<!doctype html>
+<html class="no-js" lang="en" data-content_root="../">
+  <head><meta charset="utf-8"/>
+    <meta name="viewport" content="width=device-width,initial-scale=1"/>
+    <meta name="color-scheme" content="light dark"><meta name="viewport" content="width=device-width, initial-scale=1" />
+<link rel="index" title="Index" href="../genindex.html" /><link rel="search" title="Search" href="../search.html" /><link rel="prev" title="Python Interface" href="python-interface.html" />
+
+    <!-- Generated with Sphinx 7.4.7 and Furo 2024.08.06 -->
+        <title>Response Types - Copernicus Marine Toolbox documentation</title>
+      <link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=fa44fd50" />
+    <link rel="stylesheet" type="text/css" href="../_static/styles/furo.css?v=354aac6f" />
+    <link rel="stylesheet" type="text/css" href="../_static/styles/furo-extensions.css?v=302659d7" />
+
+
+
+
+<style>
+  body {
+    --color-code-background: #eeffcc;
+  --color-code-foreground: black;
+
+  }
+  @media not print {
+    body[data-theme="dark"] {
+      --color-code-background: #272822;
+  --color-code-foreground: #f8f8f2;
+
+    }
+    @media (prefers-color-scheme: dark) {
+      body:not([data-theme="light"]) {
+        --color-code-background: #272822;
+  --color-code-foreground: #f8f8f2;
+
+      }
+    }
+  }
+</style></head>
+  <body>
+
+    <script>
+      document.body.dataset.theme = localStorage.getItem("theme") || "auto";
+    </script>
+
+
+<svg xmlns="http://www.w3.org/2000/svg" style="display: none;">
+  <symbol id="svg-toc" viewBox="0 0 24 24">
+    <title>Contents</title>
+    <svg stroke="currentColor" fill="currentColor" stroke-width="0" viewBox="0 0 1024 1024">
+      <path d="M408 442h480c4.4 0 8-3.6 8-8v-56c0-4.4-3.6-8-8-8H408c-4.4 0-8 3.6-8 8v56c0 4.4 3.6 8 8 8zm-8 204c0 4.4 3.6 8 8 8h480c4.4 0 8-3.6 8-8v-56c0-4.4-3.6-8-8-8H408c-4.4 0-8 3.6-8 8v56zm504-486H120c-4.4 0-8 3.6-8 8v56c0 4.4 3.6 8 8 8h784c4.4 0 8-3.6 8-8v-56c0-4.4-3.6-8-8-8zm0 632H120c-4.4 0-8 3.6-8 8v56c0 4.4 3.6 8 8 8h784c4.4 0 8-3.6 8-8v-56c0-4.4-3.6-8-8-8zM115.4 518.9L271.7 642c5.8 4.6 14.4.5 14.4-6.9V388.9c0-7.4-8.5-11.5-14.4-6.9L115.4 505.1a8.74 8.74 0 0 0 0 13.8z"/>
+    </svg>
+  </symbol>
+  <symbol id="svg-menu" viewBox="0 0 24 24">
+    <title>Menu</title>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor"
+      stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather-menu">
+      <line x1="3" y1="12" x2="21" y2="12"></line>
+      <line x1="3" y1="6" x2="21" y2="6"></line>
+      <line x1="3" y1="18" x2="21" y2="18"></line>
+    </svg>
+  </symbol>
+  <symbol id="svg-arrow-right" viewBox="0 0 24 24">
+    <title>Expand</title>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor"
+      stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather-chevron-right">
+      <polyline points="9 18 15 12 9 6"></polyline>
+    </svg>
+  </symbol>
+  <symbol id="svg-sun" viewBox="0 0 24 24">
+    <title>Light mode</title>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor"
+      stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="feather-sun">
+      <circle cx="12" cy="12" r="5"></circle>
+      <line x1="12" y1="1" x2="12" y2="3"></line>
+      <line x1="12" y1="21" x2="12" y2="23"></line>
+      <line x1="4.22" y1="4.22" x2="5.64" y2="5.64"></line>
+      <line x1="18.36" y1="18.36" x2="19.78" y2="19.78"></line>
+      <line x1="1" y1="12" x2="3" y2="12"></line>
+      <line x1="21" y1="12" x2="23" y2="12"></line>
+      <line x1="4.22" y1="19.78" x2="5.64" y2="18.36"></line>
+      <line x1="18.36" y1="5.64" x2="19.78" y2="4.22"></line>
+    </svg>
+  </symbol>
+  <symbol id="svg-moon" viewBox="0 0 24 24">
+    <title>Dark mode</title>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor"
+      stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="icon-tabler-moon">
+      <path stroke="none" d="M0 0h24v24H0z" fill="none" />
+      <path d="M12 3c.132 0 .263 0 .393 0a7.5 7.5 0 0 0 7.92 12.446a9 9 0 1 1 -8.313 -12.454z" />
+    </svg>
+  </symbol>
+  <symbol id="svg-sun-with-moon" viewBox="0 0 24 24">
+    <title>Auto light/dark, in light mode</title>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor"
+      stroke-width="1" stroke-linecap="round" stroke-linejoin="round"
+      class="icon-custom-derived-from-feather-sun-and-tabler-moon">
+      <path style="opacity: 50%" d="M 5.411 14.504 C 5.471 14.504 5.532 14.504 5.591 14.504 C 3.639 16.319 4.383 19.569 6.931 20.352 C 7.693 20.586 8.512 20.551 9.25 20.252 C 8.023 23.207 4.056 23.725 2.11 21.184 C 0.166 18.642 1.702 14.949 4.874 14.536 C 5.051 14.512 5.231 14.5 5.411 14.5 L 5.411 14.504 Z"/>
+      <line x1="14.5" y1="3.25" x2="14.5" y2="1.25"/>
+      <line x1="14.5" y1="15.85" x2="14.5" y2="17.85"/>
+      <line x1="10.044" y1="5.094" x2="8.63" y2="3.68"/>
+      <line x1="19" y1="14.05" x2="20.414" y2="15.464"/>
+      <line x1="8.2" y1="9.55" x2="6.2" y2="9.55"/>
+      <line x1="20.8" y1="9.55" x2="22.8" y2="9.55"/>
+      <line x1="10.044" y1="14.006" x2="8.63" y2="15.42"/>
+      <line x1="19" y1="5.05" x2="20.414" y2="3.636"/>
+      <circle cx="14.5" cy="9.55" r="3.6"/>
+    </svg>
+  </symbol>
+  <symbol id="svg-moon-with-sun" viewBox="0 0 24 24">
+    <title>Auto light/dark, in dark mode</title>
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor"
+      stroke-width="1" stroke-linecap="round" stroke-linejoin="round"
+      class="icon-custom-derived-from-feather-sun-and-tabler-moon">
+      <path d="M 8.282 7.007 C 8.385 7.007 8.494 7.007 8.595 7.007 C 5.18 10.184 6.481 15.869 10.942 17.24 C 12.275 17.648 13.706 17.589 15 17.066 C 12.851 22.236 5.91 23.143 2.505 18.696 C -0.897 14.249 1.791 7.786 7.342 7.063 C 7.652 7.021 7.965 7 8.282 7 L 8.282 7.007 Z"/>
+      <line style="opacity: 50%" x1="18" y1="3.705" x2="18" y2="2.5"/>
+      <line style="opacity: 50%" x1="18" y1="11.295" x2="18" y2="12.5"/>
+      <line style="opacity: 50%" x1="15.316" y1="4.816" x2="14.464" y2="3.964"/>
+      <line style="opacity: 50%" x1="20.711" y1="10.212" x2="21.563" y2="11.063"/>
+      <line style="opacity: 50%" x1="14.205" y1="7.5" x2="13.001" y2="7.5"/>
+      <line style="opacity: 50%" x1="21.795" y1="7.5" x2="23" y2="7.5"/>
+      <line style="opacity: 50%" x1="15.316" y1="10.184" x2="14.464" y2="11.036"/>
+      <line style="opacity: 50%" x1="20.711" y1="4.789" x2="21.563" y2="3.937"/>
+      <circle style="opacity: 50%" cx="18" cy="7.5" r="2.169"/>
+    </svg>
+  </symbol>
+  <symbol id="svg-pencil" viewBox="0 0 24 24">
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor"
+      stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="icon-tabler-pencil-code">
+      <path d="M4 20h4l10.5 -10.5a2.828 2.828 0 1 0 -4 -4l-10.5 10.5v4" />
+      <path d="M13.5 6.5l4 4" />
+      <path d="M20 21l2 -2l-2 -2" />
+      <path d="M17 17l-2 2l2 2" />
+    </svg>
+  </symbol>
+  <symbol id="svg-eye" viewBox="0 0 24 24">
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor"
+      stroke-width="1" stroke-linecap="round" stroke-linejoin="round" class="icon-tabler-eye-code">
+      <path stroke="none" d="M0 0h24v24H0z" fill="none" />
+      <path d="M10 12a2 2 0 1 0 4 0a2 2 0 0 0 -4 0" />
+      <path
+        d="M11.11 17.958c-3.209 -.307 -5.91 -2.293 -8.11 -5.958c2.4 -4 5.4 -6 9 -6c3.6 0 6.6 2 9 6c-.21 .352 -.427 .688 -.647 1.008" />
+      <path d="M20 21l2 -2l-2 -2" />
+      <path d="M17 17l-2 2l2 2" />
+    </svg>
+  </symbol>
+</svg>
+
+<input type="checkbox" class="sidebar-toggle" name="__navigation" id="__navigation">
+<input type="checkbox" class="sidebar-toggle" name="__toc" id="__toc">
+<label class="overlay sidebar-overlay" for="__navigation">
+  <div class="visually-hidden">Hide navigation sidebar</div>
+</label>
+<label class="overlay toc-overlay" for="__toc">
+  <div class="visually-hidden">Hide table of contents sidebar</div>
+</label>
+
+<a class="skip-to-content muted-link" href="#furo-main-content">Skip to content</a>
+
+
+
+<div class="page">
+  <header class="mobile-header">
+    <div class="header-left">
+      <label class="nav-overlay-icon" for="__navigation">
+        <div class="visually-hidden">Toggle site navigation sidebar</div>
+        <i class="icon"><svg><use href="#svg-menu"></use></svg></i>
+      </label>
+    </div>
+    <div class="header-center">
+      <a href="../index.html"><div class="brand">Copernicus Marine Toolbox  documentation</div></a>
+    </div>
+    <div class="header-right">
+      <div class="theme-toggle-container theme-toggle-header">
+        <button class="theme-toggle">
+          <div class="visually-hidden">Toggle Light / Dark / Auto color theme</div>
+          <svg class="theme-icon-when-auto-light"><use href="#svg-sun-with-moon"></use></svg>
+          <svg class="theme-icon-when-auto-dark"><use href="#svg-moon-with-sun"></use></svg>
+          <svg class="theme-icon-when-dark"><use href="#svg-moon"></use></svg>
+          <svg class="theme-icon-when-light"><use href="#svg-sun"></use></svg>
+        </button>
+      </div>
+      <label class="toc-overlay-icon toc-header-icon" for="__toc">
+        <div class="visually-hidden">Toggle table of contents sidebar</div>
+        <i class="icon"><svg><use href="#svg-toc"></use></svg></i>
+      </label>
+    </div>
+  </header>
+  <aside class="sidebar-drawer">
+    <div class="sidebar-container">
+
+      <div class="sidebar-sticky"><a class="sidebar-brand" href="../index.html">
+
+
+  <span class="sidebar-brand-text">Copernicus Marine Toolbox  documentation</span>
+
+</a><form class="sidebar-search-container" method="get" action="../search.html" role="search">
+  <input class="sidebar-search" placeholder="Search" name="q" aria-label="Search">
+  <input type="hidden" name="check_keywords" value="yes">
+  <input type="hidden" name="area" value="default">
+</form>
+<div id="searchbox"></div><div class="sidebar-scroll"><div class="sidebar-tree">
+  <p class="caption" role="heading"><span class="caption-text">Contents:</span></p>
+<ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="installation.html">Installing Copernicus Marine Toolbox</a></li>
+<li class="toctree-l1"><a class="reference internal" href="quickstart.html">Quick Start</a></li>
+<li class="toctree-l1"><a class="reference internal" href="command-line-interface.html">CLI</a></li>
+<li class="toctree-l1"><a class="reference internal" href="python-interface.html">Python Interface</a></li>
+<li class="toctree-l1 current current-page"><a class="current reference internal" href="#">Response Types</a></li>
+</ul>
+
+</div>
+</div>
+
+      </div>
+
+    </div>
+  </aside>
+  <div class="main">
+    <div class="content">
+      <div class="article-container">
+        <a href="#" class="back-to-top muted-link">
+          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
+            <path d="M13 20h-2V8l-5.5 5.5-1.42-1.42L12 4.16l7.92 7.92-1.42 1.42L13 8v12z"></path>
+          </svg>
+          <span>Back to top</span>
+        </a>
+        <div class="content-icon-container">
+          <div class="view-this-page">
+  <a class="muted-link" href="../_sources/usage/response_types.rst.txt" title="View this page">
+    <svg><use href="#svg-eye"></use></svg>
+    <span class="visually-hidden">View this page</span>
+  </a>
+</div>
+<div class="theme-toggle-container theme-toggle-content">
+            <button class="theme-toggle">
+              <div class="visually-hidden">Toggle Light / Dark / Auto color theme</div>
+              <svg class="theme-icon-when-auto-light"><use href="#svg-sun-with-moon"></use></svg>
+              <svg class="theme-icon-when-auto-dark"><use href="#svg-moon-with-sun"></use></svg>
+              <svg class="theme-icon-when-dark"><use href="#svg-moon"></use></svg>
+              <svg class="theme-icon-when-light"><use href="#svg-sun"></use></svg>
+            </button>
+          </div>
+          <label class="toc-overlay-icon toc-content-icon" for="__toc">
+            <div class="visually-hidden">Toggle table of contents sidebar</div>
+            <i class="icon"><svg><use href="#svg-toc"></use></svg></i>
+          </label>
+        </div>
+        <article role="main" id="furo-main-content">
+          <section id="response-types">
+<h1>Response Types<a class="headerlink" href="#response-types" title="Link to this heading">¶</a></h1>
+<p>The Copernicus Marine Toolbox commands return some information about the download.
+It can contain useful metadata for the user.</p>
+<p>For the CLI, all the returned data will be in a form of a json sent to stdout.
+You can easily save it locally by doing, for example:</p>
+<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>copernicusmarine<span class="w"> </span>get<span class="w"> </span>-i<span class="w"> </span>cmems_mod_glo_phy-thetao_anfc_0.083deg_P1M-m<span class="w"> </span>&gt;<span class="w"> </span>my_json.json
+</pre></div>
+</div>
+<div class="admonition note">
+<p class="admonition-title">Note</p>
+<p>For the “get” and “subset” commands you can get those metadata without
+downloading anything by using the <code class="docutils literal notranslate"><span class="pre">dry_run</span></code> option (or <code class="docutils literal notranslate"><span class="pre">--dry-run</span></code> flag for the CLI).</p>
+</div>
+<section id="commands-response">
+<h2>Commands Response<a class="headerlink" href="#commands-response" title="Link to this heading">¶</a></h2>
+<dl class="py class">
+<dt class="sig sig-object py" id="copernicusmarine.ResponseGet">
+<em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">copernicusmarine.</span></span><span class="sig-name descname"><span class="pre">ResponseGet</span></span><a class="headerlink" href="#copernicusmarine.ResponseGet" title="Link to this definition">¶</a></dt>
+<dd><p>Metadata returned when using <a class="reference internal" href="python-interface.html#copernicusmarine.get" title="copernicusmarine.get"><code class="xref py py-func docutils literal notranslate"><span class="pre">get()</span></code></a></p>
+<dl class="py attribute">
+<dt class="sig sig-object py" id="copernicusmarine.ResponseGet.files">
+<span class="sig-name descname"><span class="pre">files</span></span><em class="property"><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="pre">list</span><span class="p"><span class="pre">[</span></span><a class="reference internal" href="#copernicusmarine.FileGet" title="copernicusmarine.core_functions.models.FileGet"><span class="pre">FileGet</span></a><span class="p"><span class="pre">]</span></span></em><a class="headerlink" href="#copernicusmarine.ResponseGet.files" title="Link to this definition">¶</a></dt>
+<dd><p>Description of the files concerned by the query</p>
+</dd></dl>
+
+</dd></dl>
+
+<dl class="py class">
+<dt class="sig sig-object py" id="copernicusmarine.ResponseSubset">
+<em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">copernicusmarine.</span></span><span class="sig-name descname"><span class="pre">ResponseSubset</span></span><a class="headerlink" href="#copernicusmarine.ResponseSubset" title="Link to this definition">¶</a></dt>
+<dd><p>Metadata returned when using <a class="reference internal" href="python-interface.html#copernicusmarine.subset" title="copernicusmarine.subset"><code class="xref py py-func docutils literal notranslate"><span class="pre">subset()</span></code></a></p>
+<dl class="py attribute">
+<dt class="sig sig-object py" id="copernicusmarine.ResponseSubset.output">
+<span class="sig-name descname"><span class="pre">output</span></span><em class="property"><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="pre">str</span></em><a class="headerlink" href="#copernicusmarine.ResponseSubset.output" title="Link to this definition">¶</a></dt>
+<dd><p>Path to the result file.</p>
+</dd></dl>
+
+<dl class="py attribute">
+<dt class="sig sig-object py" id="copernicusmarine.ResponseSubset.size">
+<span class="sig-name descname"><span class="pre">size</span></span><em class="property"><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="pre">float</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></em><a class="headerlink" href="#copernicusmarine.ResponseSubset.size" title="Link to this definition">¶</a></dt>
+<dd><p>Estimation of the size of the final result file.</p>
+</dd></dl>
+
+<dl class="py attribute">
+<dt class="sig sig-object py" id="copernicusmarine.ResponseSubset.data_needed">
+<span class="sig-name descname"><span class="pre">data_needed</span></span><em class="property"><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="pre">float</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></em><a class="headerlink" href="#copernicusmarine.ResponseSubset.data_needed" title="Link to this definition">¶</a></dt>
+<dd><p>Estimation of the maximum amount of data needed to
+get the final result.</p>
+</dd></dl>
+
+<dl class="py attribute">
+<dt class="sig sig-object py" id="copernicusmarine.ResponseSubset.coodinates_extent">
+<span class="sig-name descname"><span class="pre">coodinates_extent</span></span><em class="property"><span class="p"><span class="pre">:</span></span><span class="w"> </span><a class="reference internal" href="#copernicusmarine.DatasetCoordinatesExtent" title="copernicusmarine.core_functions.models.DatasetCoordinatesExtent"><span class="pre">DatasetCoordinatesExtent</span></a></em><a class="headerlink" href="#copernicusmarine.ResponseSubset.coodinates_extent" title="Link to this definition">¶</a></dt>
+<dd><p>The bounds of the subsetted dataset.</p>
+</dd></dl>
+
+</dd></dl>
+
+</section>
+<section id="subtypes">
+<h2>Subtypes<a class="headerlink" href="#subtypes" title="Link to this heading">¶</a></h2>
+<dl class="py class">
+<dt class="sig sig-object py" id="copernicusmarine.FileGet">
+<em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">copernicusmarine.</span></span><span class="sig-name descname"><span class="pre">FileGet</span></span><a class="headerlink" href="#copernicusmarine.FileGet" title="Link to this definition">¶</a></dt>
+<dd><dl class="py attribute">
+<dt class="sig sig-object py" id="copernicusmarine.FileGet.url">
+<span class="sig-name descname"><span class="pre">url</span></span><em class="property"><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="pre">str</span></em><a class="headerlink" href="#copernicusmarine.FileGet.url" title="Link to this definition">¶</a></dt>
+<dd><p>Full url of the location of the file server side.</p>
+</dd></dl>
+
+<dl class="py attribute">
+<dt class="sig sig-object py" id="copernicusmarine.FileGet.size">
+<span class="sig-name descname"><span class="pre">size</span></span><em class="property"><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="pre">float</span></em><a class="headerlink" href="#copernicusmarine.FileGet.size" title="Link to this definition">¶</a></dt>
+<dd><p>Size of the file in MB.</p>
+</dd></dl>
+
+<dl class="py attribute">
+<dt class="sig sig-object py" id="copernicusmarine.FileGet.last_modified">
+<span class="sig-name descname"><span class="pre">last_modified</span></span><em class="property"><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="pre">str</span></em><a class="headerlink" href="#copernicusmarine.FileGet.last_modified" title="Link to this definition">¶</a></dt>
+<dd><p>Last modified date.</p>
+</dd></dl>
+
+<dl class="py attribute">
+<dt class="sig sig-object py" id="copernicusmarine.FileGet.output">
+<span class="sig-name descname"><span class="pre">output</span></span><em class="property"><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="pre">str</span></em><a class="headerlink" href="#copernicusmarine.FileGet.output" title="Link to this definition">¶</a></dt>
+<dd><p>Path to the local downloaded file</p>
+</dd></dl>
+
+</dd></dl>
+
+<dl class="py class">
+<dt class="sig sig-object py" id="copernicusmarine.DatasetCoordinatesExtent">
+<em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">copernicusmarine.</span></span><span class="sig-name descname"><span class="pre">DatasetCoordinatesExtent</span></span><a class="headerlink" href="#copernicusmarine.DatasetCoordinatesExtent" title="Link to this definition">¶</a></dt>
+<dd><dl class="py attribute">
+<dt class="sig sig-object py" id="copernicusmarine.DatasetCoordinatesExtent.longitude">
+<span class="sig-name descname"><span class="pre">longitude</span></span><em class="property"><span class="p"><span class="pre">:</span></span><span class="w"> </span><a class="reference internal" href="#copernicusmarine.GeographicalExtent" title="copernicusmarine.core_functions.models.GeographicalExtent"><span class="pre">GeographicalExtent</span></a></em><a class="headerlink" href="#copernicusmarine.DatasetCoordinatesExtent.longitude" title="Link to this definition">¶</a></dt>
+<dd><p>Longitude Interval of the subsetted data.</p>
+</dd></dl>
+
+<dl class="py attribute">
+<dt class="sig sig-object py" id="copernicusmarine.DatasetCoordinatesExtent.latitude">
+<span class="sig-name descname"><span class="pre">latitude</span></span><em class="property"><span class="p"><span class="pre">:</span></span><span class="w"> </span><a class="reference internal" href="#copernicusmarine.GeographicalExtent" title="copernicusmarine.core_functions.models.GeographicalExtent"><span class="pre">GeographicalExtent</span></a></em><a class="headerlink" href="#copernicusmarine.DatasetCoordinatesExtent.latitude" title="Link to this definition">¶</a></dt>
+<dd><p>Latitude Interval of the subsetted data.</p>
+</dd></dl>
+
+<dl class="py attribute">
+<dt class="sig sig-object py" id="copernicusmarine.DatasetCoordinatesExtent.time">
+<span class="sig-name descname"><span class="pre">time</span></span><em class="property"><span class="p"><span class="pre">:</span></span><span class="w"> </span><a class="reference internal" href="#copernicusmarine.TimeExtent" title="copernicusmarine.core_functions.models.TimeExtent"><span class="pre">TimeExtent</span></a></em><a class="headerlink" href="#copernicusmarine.DatasetCoordinatesExtent.time" title="Link to this definition">¶</a></dt>
+<dd><p>Time Interval of the subsetted data in iso8601 string</p>
+</dd></dl>
+
+<dl class="py attribute">
+<dt class="sig sig-object py" id="copernicusmarine.DatasetCoordinatesExtent.depth">
+<span class="sig-name descname"><span class="pre">depth</span></span><em class="property"><span class="p"><span class="pre">:</span></span><span class="w"> </span><a class="reference internal" href="#copernicusmarine.GeographicalExtent" title="copernicusmarine.core_functions.models.GeographicalExtent"><span class="pre">GeographicalExtent</span></a><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></em><a class="headerlink" href="#copernicusmarine.DatasetCoordinatesExtent.depth" title="Link to this definition">¶</a></dt>
+<dd><p>Depth Interval of the subsetted data.</p>
+</dd></dl>
+
+<dl class="py attribute">
+<dt class="sig sig-object py" id="copernicusmarine.DatasetCoordinatesExtent.elevation">
+<span class="sig-name descname"><span class="pre">elevation</span></span><em class="property"><span class="p"><span class="pre">:</span></span><span class="w"> </span><a class="reference internal" href="#copernicusmarine.GeographicalExtent" title="copernicusmarine.core_functions.models.GeographicalExtent"><span class="pre">GeographicalExtent</span></a><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></em><a class="headerlink" href="#copernicusmarine.DatasetCoordinatesExtent.elevation" title="Link to this definition">¶</a></dt>
+<dd><p>Elevation Interval of the subsetted data.
+Is relevant if data are requested for elevation
+instead of depth</p>
+</dd></dl>
+
+</dd></dl>
+
+<dl class="py class">
+<dt class="sig sig-object py" id="copernicusmarine.GeographicalExtent">
+<em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">copernicusmarine.</span></span><span class="sig-name descname"><span class="pre">GeographicalExtent</span></span><a class="headerlink" href="#copernicusmarine.GeographicalExtent" title="Link to this definition">¶</a></dt>
+<dd><p>Interval for geographical coordinates.</p>
+<dl class="py attribute">
+<dt class="sig sig-object py" id="copernicusmarine.GeographicalExtent.minimum">
+<span class="sig-name descname"><span class="pre">minimum</span></span><em class="property"><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="pre">float</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></em><a class="headerlink" href="#copernicusmarine.GeographicalExtent.minimum" title="Link to this definition">¶</a></dt>
+<dd></dd></dl>
+
+<dl class="py attribute">
+<dt class="sig sig-object py" id="copernicusmarine.GeographicalExtent.maximum">
+<span class="sig-name descname"><span class="pre">maximum</span></span><em class="property"><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="pre">float</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></em><a class="headerlink" href="#copernicusmarine.GeographicalExtent.maximum" title="Link to this definition">¶</a></dt>
+<dd></dd></dl>
+
+</dd></dl>
+
+<dl class="py class">
+<dt class="sig sig-object py" id="copernicusmarine.TimeExtent">
+<em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">copernicusmarine.</span></span><span class="sig-name descname"><span class="pre">TimeExtent</span></span><a class="headerlink" href="#copernicusmarine.TimeExtent" title="Link to this definition">¶</a></dt>
+<dd><p>Interval for time coordinate.</p>
+<dl class="py attribute">
+<dt class="sig sig-object py" id="copernicusmarine.TimeExtent.minimum">
+<span class="sig-name descname"><span class="pre">minimum</span></span><em class="property"><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></em><a class="headerlink" href="#copernicusmarine.TimeExtent.minimum" title="Link to this definition">¶</a></dt>
+<dd></dd></dl>
+
+<dl class="py attribute">
+<dt class="sig sig-object py" id="copernicusmarine.TimeExtent.maximum">
+<span class="sig-name descname"><span class="pre">maximum</span></span><em class="property"><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="pre">str</span><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><span class="pre">None</span></em><a class="headerlink" href="#copernicusmarine.TimeExtent.maximum" title="Link to this definition">¶</a></dt>
+<dd></dd></dl>
+
+</dd></dl>
+
+</section>
+</section>
+
+        </article>
+      </div>
+      <footer>
+
+        <div class="related-pages">
+
+          <a class="prev-page" href="python-interface.html">
+              <svg class="furo-related-icon"><use href="#svg-arrow-right"></use></svg>
+              <div class="page-info">
+                <div class="context">
+                  <span>Previous</span>
+                </div>
+
+                <div class="title">Python Interface</div>
+
+              </div>
+            </a>
+        </div>
+        <div class="bottom-of-page">
+          <div class="left-details">
+            <div class="copyright">
+                Copyright &#169; 2024, Mercator Ocean International
+            </div>
+            Made with <a href="https://www.sphinx-doc.org/">Sphinx</a> and <a class="muted-link" href="https://pradyunsg.me">@pradyunsg</a>'s
+
+            <a href="https://github.com/pradyunsg/furo">Furo</a>
+
+          </div>
+          <div class="right-details">
+
+          </div>
+        </div>
+
+      </footer>
+    </div>
+    <aside class="toc-drawer">
+
+
+      <div class="toc-sticky toc-scroll">
+        <div class="toc-title-container">
+          <span class="toc-title">
+            On this page
+          </span>
+        </div>
+        <div class="toc-tree-container">
+          <div class="toc-tree">
+            <ul>
+<li><a class="reference internal" href="#">Response Types</a><ul>
+<li><a class="reference internal" href="#commands-response">Commands Response</a><ul>
+<li><a class="reference internal" href="#copernicusmarine.ResponseGet"><code class="docutils literal notranslate"><span class="pre">ResponseGet</span></code></a><ul>
+<li><a class="reference internal" href="#copernicusmarine.ResponseGet.files"><code class="docutils literal notranslate"><span class="pre">ResponseGet.files</span></code></a></li>
+</ul>
+</li>
+<li><a class="reference internal" href="#copernicusmarine.ResponseSubset"><code class="docutils literal notranslate"><span class="pre">ResponseSubset</span></code></a><ul>
+<li><a class="reference internal" href="#copernicusmarine.ResponseSubset.output"><code class="docutils literal notranslate"><span class="pre">ResponseSubset.output</span></code></a></li>
+<li><a class="reference internal" href="#copernicusmarine.ResponseSubset.size"><code class="docutils literal notranslate"><span class="pre">ResponseSubset.size</span></code></a></li>
+<li><a class="reference internal" href="#copernicusmarine.ResponseSubset.data_needed"><code class="docutils literal notranslate"><span class="pre">ResponseSubset.data_needed</span></code></a></li>
+<li><a class="reference internal" href="#copernicusmarine.ResponseSubset.coodinates_extent"><code class="docutils literal notranslate"><span class="pre">ResponseSubset.coodinates_extent</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+<li><a class="reference internal" href="#subtypes">Subtypes</a><ul>
+<li><a class="reference internal" href="#copernicusmarine.FileGet"><code class="docutils literal notranslate"><span class="pre">FileGet</span></code></a><ul>
+<li><a class="reference internal" href="#copernicusmarine.FileGet.url"><code class="docutils literal notranslate"><span class="pre">FileGet.url</span></code></a></li>
+<li><a class="reference internal" href="#copernicusmarine.FileGet.size"><code class="docutils literal notranslate"><span class="pre">FileGet.size</span></code></a></li>
+<li><a class="reference internal" href="#copernicusmarine.FileGet.last_modified"><code class="docutils literal notranslate"><span class="pre">FileGet.last_modified</span></code></a></li>
+<li><a class="reference internal" href="#copernicusmarine.FileGet.output"><code class="docutils literal notranslate"><span class="pre">FileGet.output</span></code></a></li>
+</ul>
+</li>
+<li><a class="reference internal" href="#copernicusmarine.DatasetCoordinatesExtent"><code class="docutils literal notranslate"><span class="pre">DatasetCoordinatesExtent</span></code></a><ul>
+<li><a class="reference internal" href="#copernicusmarine.DatasetCoordinatesExtent.longitude"><code class="docutils literal notranslate"><span class="pre">DatasetCoordinatesExtent.longitude</span></code></a></li>
+<li><a class="reference internal" href="#copernicusmarine.DatasetCoordinatesExtent.latitude"><code class="docutils literal notranslate"><span class="pre">DatasetCoordinatesExtent.latitude</span></code></a></li>
+<li><a class="reference internal" href="#copernicusmarine.DatasetCoordinatesExtent.time"><code class="docutils literal notranslate"><span class="pre">DatasetCoordinatesExtent.time</span></code></a></li>
+<li><a class="reference internal" href="#copernicusmarine.DatasetCoordinatesExtent.depth"><code class="docutils literal notranslate"><span class="pre">DatasetCoordinatesExtent.depth</span></code></a></li>
+<li><a class="reference internal" href="#copernicusmarine.DatasetCoordinatesExtent.elevation"><code class="docutils literal notranslate"><span class="pre">DatasetCoordinatesExtent.elevation</span></code></a></li>
+</ul>
+</li>
+<li><a class="reference internal" href="#copernicusmarine.GeographicalExtent"><code class="docutils literal notranslate"><span class="pre">GeographicalExtent</span></code></a><ul>
+<li><a class="reference internal" href="#copernicusmarine.GeographicalExtent.minimum"><code class="docutils literal notranslate"><span class="pre">GeographicalExtent.minimum</span></code></a></li>
+<li><a class="reference internal" href="#copernicusmarine.GeographicalExtent.maximum"><code class="docutils literal notranslate"><span class="pre">GeographicalExtent.maximum</span></code></a></li>
+</ul>
+</li>
+<li><a class="reference internal" href="#copernicusmarine.TimeExtent"><code class="docutils literal notranslate"><span class="pre">TimeExtent</span></code></a><ul>
+<li><a class="reference internal" href="#copernicusmarine.TimeExtent.minimum"><code class="docutils literal notranslate"><span class="pre">TimeExtent.minimum</span></code></a></li>
+<li><a class="reference internal" href="#copernicusmarine.TimeExtent.maximum"><code class="docutils literal notranslate"><span class="pre">TimeExtent.maximum</span></code></a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+
+          </div>
+        </div>
+      </div>
+
+
+    </aside>
+  </div>
+</div><script src="../_static/documentation_options.js?v=5929fcd5"></script>
+    <script src="../_static/doctools.js?v=9a2dae69"></script>
+    <script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
+    <script src="../_static/scripts/furo.js?v=5fa4622c"></script>
+    </body>
+</html>
diff --git a/doc/index.rst b/doc/index.rst
index 85c4f95a..22c8531e 100644
--- a/doc/index.rst
+++ b/doc/index.rst
@@ -19,3 +19,4 @@ documentation for details.
    usage/quickstart
    usage/command-line-interface
    usage/python-interface
+   usage/response_types
diff --git a/doc/usage/response_types.rst b/doc/usage/response_types.rst
new file mode 100644
index 00000000..9a6793fe
--- /dev/null
+++ b/doc/usage/response_types.rst
@@ -0,0 +1,63 @@
+=================
+Response Types
+=================
+
+The Copernicus Marine Toolbox commands return some information about the download.
+It can contain useful metadata for the user.
+
+For the CLI, all the returned data will be in a form of a json sent to stdout.
+You can easily save it locally by doing, for example:
+
+.. code-block:: bash
+
+    copernicusmarine get -i cmems_mod_glo_phy-thetao_anfc_0.083deg_P1M-m > my_json.json
+
+
+.. note::
+   For the "get" and "subset" commands you can get those metadata without
+   downloading anything by using the ``dry_run`` option (or ``--dry-run`` flag for the CLI).
+
+-------------------
+Commands Response
+-------------------
+
+.. autoclass:: copernicusmarine.ResponseGet()
+    :members:
+    :undoc-members:
+    :exclude-members: model_computed_fields, model_config, model_fields
+    :member-order: bysource
+
+.. autoclass:: copernicusmarine.ResponseSubset()
+    :members:
+    :undoc-members:
+    :exclude-members: model_computed_fields, model_config, model_fields
+    :member-order: bysource
+
+--------------
+Subtypes
+--------------
+
+.. autoclass:: copernicusmarine.FileGet()
+    :members:
+    :undoc-members:
+    :exclude-members: model_computed_fields, model_config, model_fields
+    :member-order: bysource
+
+.. autoclass:: copernicusmarine.DatasetCoordinatesExtent()
+    :members:
+    :undoc-members:
+    :exclude-members: model_computed_fields, model_config, model_fields
+    :member-order: bysource
+
+
+.. autoclass:: copernicusmarine.GeographicalExtent()
+    :members:
+    :undoc-members:
+    :exclude-members: model_computed_fields, model_config, model_fields
+    :member-order: bysource
+
+.. autoclass:: copernicusmarine.TimeExtent()
+    :members:
+    :undoc-members:
+    :exclude-members: model_computed_fields, model_config, model_fields
+    :member-order: bysource
diff --git a/poetry.lock b/poetry.lock
index b9068941..4558d2c3 100644
--- a/poetry.lock
+++ b/poetry.lock
@@ -1,4 +1,4 @@
-# This file is automatically @generated by Poetry 1.8.2 and should not be changed by hand.
+# This file is automatically @generated by Poetry 1.6.1 and should not be changed by hand.
 
 [[package]]
 name = "aiohttp"
@@ -110,6 +110,17 @@ files = [
 [package.dependencies]
 frozenlist = ">=1.1.0"
 
+[[package]]
+name = "annotated-types"
+version = "0.7.0"
+description = "Reusable constraint types to use with typing.Annotated"
+optional = false
+python-versions = ">=3.8"
+files = [
+    {file = "annotated_types-0.7.0-py3-none-any.whl", hash = "sha256:1f02e8b43a8fbbc3f3e0d4f0f4bfc8131bcb4eebe8849b8e5c773f3a1c582a53"},
+    {file = "annotated_types-0.7.0.tar.gz", hash = "sha256:aff07c09a53a08bc8cfccb9c85b05f1aa9a2a6f23728d790723543408344ce89"},
+]
+
 [[package]]
 name = "asciitree"
 version = "0.3.3"
@@ -1484,6 +1495,127 @@ files = [
 [package.extras]
 tests = ["pytest"]
 
+[[package]]
+name = "pydantic"
+version = "2.9.1"
+description = "Data validation using Python type hints"
+optional = false
+python-versions = ">=3.8"
+files = [
+    {file = "pydantic-2.9.1-py3-none-any.whl", hash = "sha256:7aff4db5fdf3cf573d4b3c30926a510a10e19a0774d38fc4967f78beb6deb612"},
+    {file = "pydantic-2.9.1.tar.gz", hash = "sha256:1363c7d975c7036df0db2b4a61f2e062fbc0aa5ab5f2772e0ffc7191a4f4bce2"},
+]
+
+[package.dependencies]
+annotated-types = ">=0.6.0"
+pydantic-core = "2.23.3"
+typing-extensions = {version = ">=4.6.1", markers = "python_version < \"3.13\""}
+
+[package.extras]
+email = ["email-validator (>=2.0.0)"]
+timezone = ["tzdata"]
+
+[[package]]
+name = "pydantic-core"
+version = "2.23.3"
+description = "Core functionality for Pydantic validation and serialization"
+optional = false
+python-versions = ">=3.8"
+files = [
+    {file = "pydantic_core-2.23.3-cp310-cp310-macosx_10_12_x86_64.whl", hash = "sha256:7f10a5d1b9281392f1bf507d16ac720e78285dfd635b05737c3911637601bae6"},
+    {file = "pydantic_core-2.23.3-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:3c09a7885dd33ee8c65266e5aa7fb7e2f23d49d8043f089989726391dd7350c5"},
+    {file = "pydantic_core-2.23.3-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:6470b5a1ec4d1c2e9afe928c6cb37eb33381cab99292a708b8cb9aa89e62429b"},
+    {file = "pydantic_core-2.23.3-cp310-cp310-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:9172d2088e27d9a185ea0a6c8cebe227a9139fd90295221d7d495944d2367700"},
+    {file = "pydantic_core-2.23.3-cp310-cp310-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:86fc6c762ca7ac8fbbdff80d61b2c59fb6b7d144aa46e2d54d9e1b7b0e780e01"},
+    {file = "pydantic_core-2.23.3-cp310-cp310-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:f0cb80fd5c2df4898693aa841425ea1727b1b6d2167448253077d2a49003e0ed"},
+    {file = "pydantic_core-2.23.3-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:03667cec5daf43ac4995cefa8aaf58f99de036204a37b889c24a80927b629cec"},
+    {file = "pydantic_core-2.23.3-cp310-cp310-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:047531242f8e9c2db733599f1c612925de095e93c9cc0e599e96cf536aaf56ba"},
+    {file = "pydantic_core-2.23.3-cp310-cp310-musllinux_1_1_aarch64.whl", hash = "sha256:5499798317fff7f25dbef9347f4451b91ac2a4330c6669821c8202fd354c7bee"},
+    {file = "pydantic_core-2.23.3-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:bbb5e45eab7624440516ee3722a3044b83fff4c0372efe183fd6ba678ff681fe"},
+    {file = "pydantic_core-2.23.3-cp310-none-win32.whl", hash = "sha256:8b5b3ed73abb147704a6e9f556d8c5cb078f8c095be4588e669d315e0d11893b"},
+    {file = "pydantic_core-2.23.3-cp310-none-win_amd64.whl", hash = "sha256:2b603cde285322758a0279995b5796d64b63060bfbe214b50a3ca23b5cee3e83"},
+    {file = "pydantic_core-2.23.3-cp311-cp311-macosx_10_12_x86_64.whl", hash = "sha256:c889fd87e1f1bbeb877c2ee56b63bb297de4636661cc9bbfcf4b34e5e925bc27"},
+    {file = "pydantic_core-2.23.3-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:ea85bda3189fb27503af4c45273735bcde3dd31c1ab17d11f37b04877859ef45"},
+    {file = "pydantic_core-2.23.3-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:a7f7f72f721223f33d3dc98a791666ebc6a91fa023ce63733709f4894a7dc611"},
+    {file = "pydantic_core-2.23.3-cp311-cp311-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:2b2b55b0448e9da68f56b696f313949cda1039e8ec7b5d294285335b53104b61"},
+    {file = "pydantic_core-2.23.3-cp311-cp311-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:c24574c7e92e2c56379706b9a3f07c1e0c7f2f87a41b6ee86653100c4ce343e5"},
+    {file = "pydantic_core-2.23.3-cp311-cp311-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:f2b05e6ccbee333a8f4b8f4d7c244fdb7a979e90977ad9c51ea31261e2085ce0"},
+    {file = "pydantic_core-2.23.3-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:e2c409ce1c219c091e47cb03feb3c4ed8c2b8e004efc940da0166aaee8f9d6c8"},
+    {file = "pydantic_core-2.23.3-cp311-cp311-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:d965e8b325f443ed3196db890d85dfebbb09f7384486a77461347f4adb1fa7f8"},
+    {file = "pydantic_core-2.23.3-cp311-cp311-musllinux_1_1_aarch64.whl", hash = "sha256:f56af3a420fb1ffaf43ece3ea09c2d27c444e7c40dcb7c6e7cf57aae764f2b48"},
+    {file = "pydantic_core-2.23.3-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:5b01a078dd4f9a52494370af21aa52964e0a96d4862ac64ff7cea06e0f12d2c5"},
+    {file = "pydantic_core-2.23.3-cp311-none-win32.whl", hash = "sha256:560e32f0df04ac69b3dd818f71339983f6d1f70eb99d4d1f8e9705fb6c34a5c1"},
+    {file = "pydantic_core-2.23.3-cp311-none-win_amd64.whl", hash = "sha256:c744fa100fdea0d000d8bcddee95213d2de2e95b9c12be083370b2072333a0fa"},
+    {file = "pydantic_core-2.23.3-cp312-cp312-macosx_10_12_x86_64.whl", hash = "sha256:e0ec50663feedf64d21bad0809f5857bac1ce91deded203efc4a84b31b2e4305"},
+    {file = "pydantic_core-2.23.3-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:db6e6afcb95edbe6b357786684b71008499836e91f2a4a1e55b840955b341dbb"},
+    {file = "pydantic_core-2.23.3-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:98ccd69edcf49f0875d86942f4418a4e83eb3047f20eb897bffa62a5d419c8fa"},
+    {file = "pydantic_core-2.23.3-cp312-cp312-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:a678c1ac5c5ec5685af0133262103defb427114e62eafeda12f1357a12140162"},
+    {file = "pydantic_core-2.23.3-cp312-cp312-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:01491d8b4d8db9f3391d93b0df60701e644ff0894352947f31fff3e52bd5c801"},
+    {file = "pydantic_core-2.23.3-cp312-cp312-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:fcf31facf2796a2d3b7fe338fe8640aa0166e4e55b4cb108dbfd1058049bf4cb"},
+    {file = "pydantic_core-2.23.3-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:7200fd561fb3be06827340da066df4311d0b6b8eb0c2116a110be5245dceb326"},
+    {file = "pydantic_core-2.23.3-cp312-cp312-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:dc1636770a809dee2bd44dd74b89cc80eb41172bcad8af75dd0bc182c2666d4c"},
+    {file = "pydantic_core-2.23.3-cp312-cp312-musllinux_1_1_aarch64.whl", hash = "sha256:67a5def279309f2e23014b608c4150b0c2d323bd7bccd27ff07b001c12c2415c"},
+    {file = "pydantic_core-2.23.3-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:748bdf985014c6dd3e1e4cc3db90f1c3ecc7246ff5a3cd4ddab20c768b2f1dab"},
+    {file = "pydantic_core-2.23.3-cp312-none-win32.whl", hash = "sha256:255ec6dcb899c115f1e2a64bc9ebc24cc0e3ab097775755244f77360d1f3c06c"},
+    {file = "pydantic_core-2.23.3-cp312-none-win_amd64.whl", hash = "sha256:40b8441be16c1e940abebed83cd006ddb9e3737a279e339dbd6d31578b802f7b"},
+    {file = "pydantic_core-2.23.3-cp313-cp313-macosx_10_12_x86_64.whl", hash = "sha256:6daaf5b1ba1369a22c8b050b643250e3e5efc6a78366d323294aee54953a4d5f"},
+    {file = "pydantic_core-2.23.3-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:d015e63b985a78a3d4ccffd3bdf22b7c20b3bbd4b8227809b3e8e75bc37f9cb2"},
+    {file = "pydantic_core-2.23.3-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:a3fc572d9b5b5cfe13f8e8a6e26271d5d13f80173724b738557a8c7f3a8a3791"},
+    {file = "pydantic_core-2.23.3-cp313-cp313-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:f6bd91345b5163ee7448bee201ed7dd601ca24f43f439109b0212e296eb5b423"},
+    {file = "pydantic_core-2.23.3-cp313-cp313-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:fc379c73fd66606628b866f661e8785088afe2adaba78e6bbe80796baf708a63"},
+    {file = "pydantic_core-2.23.3-cp313-cp313-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:fbdce4b47592f9e296e19ac31667daed8753c8367ebb34b9a9bd89dacaa299c9"},
+    {file = "pydantic_core-2.23.3-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:fc3cf31edf405a161a0adad83246568647c54404739b614b1ff43dad2b02e6d5"},
+    {file = "pydantic_core-2.23.3-cp313-cp313-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:8e22b477bf90db71c156f89a55bfe4d25177b81fce4aa09294d9e805eec13855"},
+    {file = "pydantic_core-2.23.3-cp313-cp313-musllinux_1_1_aarch64.whl", hash = "sha256:0a0137ddf462575d9bce863c4c95bac3493ba8e22f8c28ca94634b4a1d3e2bb4"},
+    {file = "pydantic_core-2.23.3-cp313-cp313-musllinux_1_1_x86_64.whl", hash = "sha256:203171e48946c3164fe7691fc349c79241ff8f28306abd4cad5f4f75ed80bc8d"},
+    {file = "pydantic_core-2.23.3-cp313-none-win32.whl", hash = "sha256:76bdab0de4acb3f119c2a4bff740e0c7dc2e6de7692774620f7452ce11ca76c8"},
+    {file = "pydantic_core-2.23.3-cp313-none-win_amd64.whl", hash = "sha256:37ba321ac2a46100c578a92e9a6aa33afe9ec99ffa084424291d84e456f490c1"},
+    {file = "pydantic_core-2.23.3-cp38-cp38-macosx_10_12_x86_64.whl", hash = "sha256:d063c6b9fed7d992bcbebfc9133f4c24b7a7f215d6b102f3e082b1117cddb72c"},
+    {file = "pydantic_core-2.23.3-cp38-cp38-macosx_11_0_arm64.whl", hash = "sha256:6cb968da9a0746a0cf521b2b5ef25fc5a0bee9b9a1a8214e0a1cfaea5be7e8a4"},
+    {file = "pydantic_core-2.23.3-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:edbefe079a520c5984e30e1f1f29325054b59534729c25b874a16a5048028d16"},
+    {file = "pydantic_core-2.23.3-cp38-cp38-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:cbaaf2ef20d282659093913da9d402108203f7cb5955020bd8d1ae5a2325d1c4"},
+    {file = "pydantic_core-2.23.3-cp38-cp38-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:fb539d7e5dc4aac345846f290cf504d2fd3c1be26ac4e8b5e4c2b688069ff4cf"},
+    {file = "pydantic_core-2.23.3-cp38-cp38-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:7e6f33503c5495059148cc486867e1d24ca35df5fc064686e631e314d959ad5b"},
+    {file = "pydantic_core-2.23.3-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:04b07490bc2f6f2717b10c3969e1b830f5720b632f8ae2f3b8b1542394c47a8e"},
+    {file = "pydantic_core-2.23.3-cp38-cp38-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:03795b9e8a5d7fda05f3873efc3f59105e2dcff14231680296b87b80bb327295"},
+    {file = "pydantic_core-2.23.3-cp38-cp38-musllinux_1_1_aarch64.whl", hash = "sha256:c483dab0f14b8d3f0df0c6c18d70b21b086f74c87ab03c59250dbf6d3c89baba"},
+    {file = "pydantic_core-2.23.3-cp38-cp38-musllinux_1_1_x86_64.whl", hash = "sha256:8b2682038e255e94baf2c473dca914a7460069171ff5cdd4080be18ab8a7fd6e"},
+    {file = "pydantic_core-2.23.3-cp38-none-win32.whl", hash = "sha256:f4a57db8966b3a1d1a350012839c6a0099f0898c56512dfade8a1fe5fb278710"},
+    {file = "pydantic_core-2.23.3-cp38-none-win_amd64.whl", hash = "sha256:13dd45ba2561603681a2676ca56006d6dee94493f03d5cadc055d2055615c3ea"},
+    {file = "pydantic_core-2.23.3-cp39-cp39-macosx_10_12_x86_64.whl", hash = "sha256:82da2f4703894134a9f000e24965df73cc103e31e8c31906cc1ee89fde72cbd8"},
+    {file = "pydantic_core-2.23.3-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:dd9be0a42de08f4b58a3cc73a123f124f65c24698b95a54c1543065baca8cf0e"},
+    {file = "pydantic_core-2.23.3-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:89b731f25c80830c76fdb13705c68fef6a2b6dc494402987c7ea9584fe189f5d"},
+    {file = "pydantic_core-2.23.3-cp39-cp39-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:c6de1ec30c4bb94f3a69c9f5f2182baeda5b809f806676675e9ef6b8dc936f28"},
+    {file = "pydantic_core-2.23.3-cp39-cp39-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:bb68b41c3fa64587412b104294b9cbb027509dc2f6958446c502638d481525ef"},
+    {file = "pydantic_core-2.23.3-cp39-cp39-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:1c3980f2843de5184656aab58698011b42763ccba11c4a8c35936c8dd6c7068c"},
+    {file = "pydantic_core-2.23.3-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:94f85614f2cba13f62c3c6481716e4adeae48e1eaa7e8bac379b9d177d93947a"},
+    {file = "pydantic_core-2.23.3-cp39-cp39-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:510b7fb0a86dc8f10a8bb43bd2f97beb63cffad1203071dc434dac26453955cd"},
+    {file = "pydantic_core-2.23.3-cp39-cp39-musllinux_1_1_aarch64.whl", hash = "sha256:1eba2f7ce3e30ee2170410e2171867ea73dbd692433b81a93758ab2de6c64835"},
+    {file = "pydantic_core-2.23.3-cp39-cp39-musllinux_1_1_x86_64.whl", hash = "sha256:4b259fd8409ab84b4041b7b3f24dcc41e4696f180b775961ca8142b5b21d0e70"},
+    {file = "pydantic_core-2.23.3-cp39-none-win32.whl", hash = "sha256:40d9bd259538dba2f40963286009bf7caf18b5112b19d2b55b09c14dde6db6a7"},
+    {file = "pydantic_core-2.23.3-cp39-none-win_amd64.whl", hash = "sha256:5a8cd3074a98ee70173a8633ad3c10e00dcb991ecec57263aacb4095c5efb958"},
+    {file = "pydantic_core-2.23.3-pp310-pypy310_pp73-macosx_10_12_x86_64.whl", hash = "sha256:f399e8657c67313476a121a6944311fab377085ca7f490648c9af97fc732732d"},
+    {file = "pydantic_core-2.23.3-pp310-pypy310_pp73-macosx_11_0_arm64.whl", hash = "sha256:6b5547d098c76e1694ba85f05b595720d7c60d342f24d5aad32c3049131fa5c4"},
+    {file = "pydantic_core-2.23.3-pp310-pypy310_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:0dda0290a6f608504882d9f7650975b4651ff91c85673341789a476b1159f211"},
+    {file = "pydantic_core-2.23.3-pp310-pypy310_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:65b6e5da855e9c55a0c67f4db8a492bf13d8d3316a59999cfbaf98cc6e401961"},
+    {file = "pydantic_core-2.23.3-pp310-pypy310_pp73-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:09e926397f392059ce0afdcac920df29d9c833256354d0c55f1584b0b70cf07e"},
+    {file = "pydantic_core-2.23.3-pp310-pypy310_pp73-musllinux_1_1_aarch64.whl", hash = "sha256:87cfa0ed6b8c5bd6ae8b66de941cece179281239d482f363814d2b986b79cedc"},
+    {file = "pydantic_core-2.23.3-pp310-pypy310_pp73-musllinux_1_1_x86_64.whl", hash = "sha256:e61328920154b6a44d98cabcb709f10e8b74276bc709c9a513a8c37a18786cc4"},
+    {file = "pydantic_core-2.23.3-pp310-pypy310_pp73-win_amd64.whl", hash = "sha256:ce3317d155628301d649fe5e16a99528d5680af4ec7aa70b90b8dacd2d725c9b"},
+    {file = "pydantic_core-2.23.3-pp39-pypy39_pp73-macosx_10_12_x86_64.whl", hash = "sha256:e89513f014c6be0d17b00a9a7c81b1c426f4eb9224b15433f3d98c1a071f8433"},
+    {file = "pydantic_core-2.23.3-pp39-pypy39_pp73-macosx_11_0_arm64.whl", hash = "sha256:4f62c1c953d7ee375df5eb2e44ad50ce2f5aff931723b398b8bc6f0ac159791a"},
+    {file = "pydantic_core-2.23.3-pp39-pypy39_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:2718443bc671c7ac331de4eef9b673063b10af32a0bb385019ad61dcf2cc8f6c"},
+    {file = "pydantic_core-2.23.3-pp39-pypy39_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:a0d90e08b2727c5d01af1b5ef4121d2f0c99fbee692c762f4d9d0409c9da6541"},
+    {file = "pydantic_core-2.23.3-pp39-pypy39_pp73-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:2b676583fc459c64146debea14ba3af54e540b61762dfc0613dc4e98c3f66eeb"},
+    {file = "pydantic_core-2.23.3-pp39-pypy39_pp73-musllinux_1_1_aarch64.whl", hash = "sha256:50e4661f3337977740fdbfbae084ae5693e505ca2b3130a6d4eb0f2281dc43b8"},
+    {file = "pydantic_core-2.23.3-pp39-pypy39_pp73-musllinux_1_1_x86_64.whl", hash = "sha256:68f4cf373f0de6abfe599a38307f4417c1c867ca381c03df27c873a9069cda25"},
+    {file = "pydantic_core-2.23.3-pp39-pypy39_pp73-win_amd64.whl", hash = "sha256:59d52cf01854cb26c46958552a21acb10dd78a52aa34c86f284e66b209db8cab"},
+    {file = "pydantic_core-2.23.3.tar.gz", hash = "sha256:3cb0f65d8b4121c1b015c60104a685feb929a29d7cf204387c7f2688c7974690"},
+]
+
+[package.dependencies]
+typing-extensions = ">=4.6.0,<4.7.0 || >4.7.0"
+
 [[package]]
 name = "pygments"
 version = "2.18.0"
@@ -2006,4 +2138,4 @@ test = ["big-O", "importlib-resources", "jaraco.functools", "jaraco.itertools",
 [metadata]
 lock-version = "2.0"
 python-versions = ">=3.9,<3.13"
-content-hash = "2248793fb390933099ce694951481e01fc3bacfb49ec217e037ae5f43b29d715"
+content-hash = "26395cd003002a8f61264c79d406941c7a963c42bb9c1002586ac6ca9f390728"
diff --git a/pyproject.toml b/pyproject.toml
index 2375b661..e26b8f51 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -25,6 +25,7 @@ pystac = ">=1.8.3"
 lxml = ">=4.9.0"
 numpy = ">=1.23.0,<2.0.0"
 pendulum = "^3.0.0"
+pydantic = "^2.9.1"
 
 [tool.poetry.dev-dependencies]
 pre-commit = "^2.20.0"
diff --git a/tests/__snapshots__/test_help_command_interface.ambr b/tests/__snapshots__/test_help_command_interface.ambr
index 2a15a5b9..a468b425 100644
--- a/tests/__snapshots__/test_help_command_interface.ambr
+++ b/tests/__snapshots__/test_help_command_interface.ambr
@@ -152,6 +152,7 @@
     '                                  directories].',
     '  --index-parts                   Option to get the index files of an INSITU',
     '                                  dataset. Temporary option.',
+    '  --dry-run                       Runs query without downloading data.',
     '  --disable-progress-bar          Flag to hide progress bar.',
     '  --log-level [DEBUG|INFO|WARN|ERROR|CRITICAL|QUIET]',
     '                                  Set the details printed to console by the',
@@ -323,6 +324,7 @@
     '                                  as a string. Caution, user has to replace',
     '                                  double quotes " with single quotes \\\' in the',
     '                                  request.',
+    '  --dry-run                       Runs query without downloading data.',
     '  --disable-progress-bar          Flag to hide progress bar.',
     '  --log-level [DEBUG|INFO|WARN|ERROR|CRITICAL|QUIET]',
     '                                  Set the details printed to console by the',
diff --git a/tests/test_command_line_interface.py b/tests/test_command_line_interface.py
index c4a47b11..b2f0247d 100644
--- a/tests/test_command_line_interface.py
+++ b/tests/test_command_line_interface.py
@@ -653,6 +653,55 @@ def test_downloaded_files_are_not_displayed_with_force_download_option(
             not in self.output.stderr
         )
 
+    def test_get_download_with_dry_run_option(self, tmp_path):
+        dataset_id = "cmems_mod_ibi_phy_my_0.083deg-3D_P1Y-m"
+        command = [
+            "copernicusmarine",
+            "get",
+            "-i",
+            f"{dataset_id}",
+            "--output-directory",
+            f"{tmp_path}",
+            "--dry-run",
+            "--force-download",
+        ]
+
+        self.output = execute_in_terminal(command)
+        # weirdly add \n at the end of the output
+        returned_value = loads(self.output.stdout[:-1])
+        assert self.output.returncode == 0
+        assert len(returned_value["files"]) != 0
+        for get_file in returned_value["files"]:
+            assert get_file["output"] is not None
+            assert get_file["size"] is not None
+            assert get_file["url"] is not None
+            assert get_file["last_modified"] is not None
+            assert str(tmp_path) in get_file["output"]
+            assert not os.path.exists(get_file["output"])
+
+    def test_subset_with_dry_run_option(self, tmp_path):
+        command = [
+            "copernicusmarine",
+            "subset",
+            "--dataset-id",
+            "cmems_mod_ibi_phy_my_0.083deg-3D_P1Y-m",
+            "--variable",
+            "thetao",
+            "--minimum-longitude",
+            "-9.9",
+            "--maximum-longitude",
+            "-9.6",
+            "--force-download",
+            "--dry-run",
+            "-o",
+            f"{tmp_path}",
+        ]
+        self.output = execute_in_terminal(command)
+        assert self.output.returncode == 0
+        returned_value = loads(self.output.stdout[:-1])
+        assert str(tmp_path) in returned_value["output"]
+        assert not os.path.exists(returned_value["output"])
+
     def test_subset_output_file_as_netcdf(self, tmp_path):
         dataset_id = "cmems_mod_ibi_phy_my_0.083deg-3D_P1Y-m"
         output_filename = "test_subset_output_file_as_netcdf.nc"
diff --git a/tests/test_get_direct_download.py b/tests/test_get_direct_download.py
index be1d6cb3..1fa7e45f 100644
--- a/tests/test_get_direct_download.py
+++ b/tests/test_get_direct_download.py
@@ -142,7 +142,8 @@ def test_get_direct_download_file_list_python(self, tmp_path):
             overwrite_output_data=True,
             output_directory=tmp_path,
         )
-        assert set(get_result) == {
+        result_paths = [result.output for result in get_result.files]
+        assert set(result_paths) == {
             pathlib.Path(
                 f"{tmp_path}/"
                 f"INSITU_GLO_PHYBGCWAV_DISCRETE_MYNRT_013_030/"
@@ -156,7 +157,7 @@ def test_get_direct_download_file_list_python(self, tmp_path):
                 f"history/BO/AR_PR_BO_58US.nc"
             ),
         }
-        for file_path in get_result:
+        for file_path in result_paths:
             assert os.path.exists(file_path)
 
     def _assert_insitu_file_exists_locally(
diff --git a/tests/test_get_index_files_insitu.py b/tests/test_get_index_files_insitu.py
index 25770d8a..12c5df4d 100644
--- a/tests/test_get_index_files_insitu.py
+++ b/tests/test_get_index_files_insitu.py
@@ -53,4 +53,9 @@ def test_get_index_insitu_files_python(self):
             force_download=True,
         )
         assert get_result is not None
-        assert all(map(lambda x: x.exists(), get_result))
+        assert all(
+            map(
+                lambda x: x.exists(),
+                [result.output for result in get_result.files],
+            )
+        )
diff --git a/tests/test_python_interface.py b/tests/test_python_interface.py
index 08c68c65..8b3b2c8e 100644
--- a/tests/test_python_interface.py
+++ b/tests/test_python_interface.py
@@ -37,7 +37,12 @@ def test_get_function(self, tmp_path):
             force_download=True,
         )
         assert get_result is not None
-        assert all(map(lambda x: x.exists(), get_result))
+        assert all(
+            map(
+                lambda x: x.exists(),
+                [result.output for result in get_result.files],
+            )
+        )
 
     @mock.patch("os.utime", side_effect=PermissionError)
     def test_permission_denied_for_modification_date(
@@ -78,7 +83,7 @@ def test_subset_function(self, tmp_path):
         )
 
         assert subset_result is not None
-        assert subset_result.exists()
+        assert subset_result.output.exists()
 
     def test_open_dataset(self):
         dataset = open_dataset(