How to Run S2DR

How to Run S2DR

Run S2DR with your Gamma Earth API key in Google Colab, from the Python SDK, with the Python package, over the REST API or from the QGIS plugin, and how to choose between them.

There are five ways to run S2DR. They differ in where the processing happens and in what you work with. All of them use your Gamma Earth API key and the same credits (see API Access & Keys and How Credits Work).

Choose a Way

If you want to...UseWhere it runs
Try S2DR with nothing to installGoogle Colab Public DemoA Google Colab GPU, in your browser
Run it from your own code or scripts, or process a large area from a vector filePython SDKYour GPU, or a Colab GPU
Search, run and download products from Python without a GPUPython PackageGamma Earth servers
Connect another system or build your own integrationREST APIGamma Earth servers
Work in a GIS and load the results into your projectQGIS PluginGamma Earth servers

Where to Start

  • New to S2DR: start with the Colab demo. It needs only your account and API key.
  • Python user: the Python Package is the lightest option, with no GPU and nothing but pip install. Use the Python SDK when you want the processing on your own machine.
  • Programmer or integrator: the REST API is the direct way to submit jobs and read their results from your own systems.