Examples

Insula Code provides a set of ready-to-use examples to help you in the learning process. These examples are automatically downloaded upon your first login and can be found in your user workspace under the folder named “getting-started”.

Accessing the Examples

  • Locate the folder: Navigate to your user workspace and open the “getting-started” folder.

  • Choose an Example: Within the folder, you’ll find several notebook files with “.ipynb” extensions. These notebooks contain code examples and explanations.

Running the Examples

Since the examples are primarily in Python, they leverage Jupyter Notebook format. To run an example:

  • Double-Click the Notebook: Open the desired “.ipynb” file by double-clicking on it.

  • Execute Cells: Jupyter Notebooks allow you to execute code snippets one by one or in sequence. Look for buttons or keyboard shortcuts within the interface to execute individual cells or the entire notebook.

Understanding the Examples

The examples are designed to be self-explanatory. Each notebook includes comments and explanations directly within the code cells, guiding you through the steps.

Governance Rules

At startup, each Insula Code notebook automatically clones the examples from relevant GitHub repositories (e.g. from the dedicated ECMWF or EUMETSAT branches) to ensure users work with the latest approved version of the codebase and directory structure. Users are free to modify the local copy within their environment; however, it is important to note that local changes may prevent automatic synchronization when updates are later pulled from the master or upstream repositories. To maintain compatibility and ensure smooth updates, users are encouraged to keep personal modifications isolated (e.g. on feature branches or forks) and avoid altering core directory structures or configuration files managed by the providers of the examples. Future pulls or merges from these repositories will overwrite or conflict with local edits in the Insula Code directory tree if governance rules are not observed.

Additional Resources