Downloading Simulation Outputs

The final step in the workflow is to download the data from your completed simulation run.

Step 4: Using the Download Link

When a simulation run’s status changes to COMPLETED, the response from the status endpoint will include a downloadUrl for that specific run.

{
  // ...
  "runs": [
    {
      "uuid": "f755904f-f614-4912-97d8-cbfffc53010b",
      "status": "COMPLETED",
      "downloadUrl": "https://s3.amazonaws.com/.../run-8e0627e7.zip?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=..."
    },
    {
      "uuid": "1675ba77-0075-4e7c-a568-c530b96311fe",
      "status": "COMPLETED",
      "downloadUrl": "https://s3.amazonaws.com/.../run-1c3450c3.zip?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=..."
    },
    {
      "uuid": "a29b1b13-7b83-46ec-8051-5163f9686713",
      "status": "COMPLETED",
      "downloadUrl": "https://s3.amazonaws.com/.../run-4a3521b5.zip?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=..."
    }
  ]
}

Link Expiry

The downloadUrl is a pre-signed S3 link that provides temporary, direct access to the data. For security reasons, this link will automatically expire 48 hours after the run is completed. You should ensure you download the data within this window.

How to Download

You can download the file using a simple curl command or by pasting the URL into your web browser.

# Use the full URL provided in the API response
curl "https://s3.amazonaws.com/.../run-8e0627e7.zip?..." -o simulation_output.lz4

Understanding the Archive Format

The downloaded file is a compressed archive containing the raw output from the simulation model.

• Current Format: The data is currently provided as an lz4 compressed archive. You will need a tool capable of decompressing .lz4 files to access the contents.

• Future Formats: We are actively working to support a wider range of archival and data formats, such as tar, gzip, and the meteorological standard grib.

We value your feedback. If you have specific format requirements or preferences, please let us know by contacting our team at contact@weatherwise.fr.

What’s Next?

Congratulations! You have successfully planned, executed, and downloaded a high-resolution weather simulation. You are now ready to integrate this powerful data into your own applications and analyses.

If you have any questions or need further assistance, please visit our Support page.