Release News: Big Usability Gains with Inductiva API v0.11

The Inductiva Team

Author

December 2, 2024

Tags:

Inductiva API v0.11 releaseInductiva APISWANTask tracking improvementsHigh Performance ComputingAPI for Scientific SimulationsAPI Release
v0.11

Our latest release, v0.11, focuses on making your experience smoother, smarter, and more efficient. Building on the progress from v0.10, this update brings better task visibility, improved simulation management, flexibility in running the SWAN simulator, and a simplified onboarding process.

Read on for details of what’s new and what’s better! And as always, you can check out the full release notes in our documentation here.

The TL;DR

Here’s a quick rundown of our V0.11 release updates:

  • See More with Task Lifecycle Insights – Real-time tracking of simulator commands, phase durations, and status updates in Inductiva’s Console and CLI.
  • New Options to Run the SWAN Simulator – Choose between swan.exe and swanrun based on your workflow needs.
  • Reusable Input Files –  Upload once, use across multiple simulations to save time and costs.
  • Smart Resource Management – List and filter available computational resources to find the perfect machine for your simulation.
  • Simplified API Key Setup – Use inductiva auth login for easier authentication on Windows and Linux.

See More with Task Lifecycle Insights

Building on the improvements introduced in v0.10, we’ve added more details to the Task’s timeline, making it easier to track progress in real time. 

You can now:

  • Understand Task Phases Better: Self-explanatory phase titles make it clear what’s happening at every stage.
  • Track Commands in Real-Time: See exactly what commands the simulator is running during the computation process.
  • Monitor Progress by Phase: View the duration and timestamps for each phase, helping you plan better for future runs.

These updates are available in the Console or via the tasks info method in CLI. Whether you’re troubleshooting or optimizing workflows, the improved visibility keeps you in control. For a detailed breakdown of a Task’s lifecycle, check out our community documentation.

New Options to Run the SWAN Simulator 

The SWAN simulator, integrated directly into Inductiva’s API, allows you to easily run simulations on the cloud alongside a growing library of other powerful simulators. With this release, you can now choose between two executable commands for running SWAN:

  • swanrun (Default Command): Best for single-machine simulations, swanrun generates helpful debug files (.rpt and .erf) when issues arise. However, it does not support MPI clusters, making it ideal for smaller, localized tasks.
  • swan.exe: Designed for larger-scale tasks, swan.exe supports MPI clusters, allowing simulations to run across multiple machines. While powerful, it may occasionally fail to generate debug files.

For a step-by-step guide on setting up and running your simulations, check out the updated SWAN tutorial.

The complete list of integrated simulators is available on our website or by using the Python method:

inductiva simulators list

Have another simulator in mind? Get in touch and let us know how we can support your research.

Reusable Input Files

Running multiple simulations often means reusing large input files, like the bathymetry of a coastal area or object geometries for computational fluid dynamics (CFD). Instead of repeatedly uploading these files for every simulation, Inductiva now lets you upload them once and reuse them across multiple tasks. This new feature saves both time and costs, making your workflow more efficient. 

Here’s how it works:

  1. Upload Files: Upload your local files, or those stored remotely on a URL, to a remote directory using Python commands.
  2. Run Tasks: Use the remote_assets parameter to point to the uploaded files for your simulation.
  3. Manage Files: Easily list or delete stored files with CLI commands or Python methods for streamlined maintenance.

This feature reduces upload times and storage costs while simplifying workflows. Learn more about how to reuse input files in our release notes.

Smarter Resource Management

Make smarter decisions for your workflow with Inductiva’s latest updates, featuring enhanced filtering tools and RAM visibility to streamline your simulations.

Find the Perfect Machine for Your Task

Selecting the right computational resources is easier than ever with our new filtering tools. Whether you need specific vCPU counts, memory, or price points, use the Console’s filtering options or Python commands to narrow down hundreds of machine types.

Here’s how it looks:


```
machines = inductiva.resources.machine_types.get_available_machine_types(
    provider="GCP",
    machine_families=["c2", "c2d"],
    machine_configs=["standard", "highcpu"],
    vcpus_range=(16, 32),
    memory_range=(50, 100),
    price_range=(0, 0.8),
    spot=False)

for m in machines:
    print(m.machine_type)
    print(m.price)
```

Filter by cloud provider, machine family, cost, and more for optimized simulations.

Know Your RAM

When registering machine groups, you’ll now see the allocated RAM alongside other attributes. This provides a clearer picture of the resources you’re working with, helping you make informed decisions about your simulations.

Here’s how it looks:


Registering MachineGroup configurations:
        · Name:                      api-a702c5ecsreb8o02yamasy6s2
        · Machine Type:               c2-standard-4
        · Data disk size:             10 GB
        · Total memory (RAM):         16 GB
        · Maximum idle time:          30 minutes
        · Auto terminate timestamp:   2024/12/03 20:56:52
        · Number of machines:         1
        · Spot:                       True
        · Estimated cloud cost of machine group: 0.074 $/h
        · You are spending 3.3x less by using spot machines.

Curious about available resources for your simulations? Run the below command to explore the full range of machines that can support your work:

inductiva resources available

Smoother Onboarding: Simplified API Key Setup

Onboarding just got easier! Instead of manually setting environment variables for your API key, you can now authenticate using:

inductiva auth login

This command stores your API key in a secure local file within the Inductiva folder, making setup on Windows and Linux smoother. To remove your stored key, use:

inductiva auth logout
 

For advanced users, the API still prioritizes the INDUCTIVA_API_KEY environment variable if set. For testing this new feature, make sure the variable isn’t set.

Wrapping It Up

And that’s a wrap for v0.11! These incremental updates go a long way in improving usability and control for our users, giving you more tools to power your work.

Try Inductiva Out with Free Credits

Ready to experience the full potential of Inductiva? Register today and enjoy $5 USD in free credits to explore our API’s full features, run your favorite simulators on the cloud, and access compute resources.

Don’t Forget to Upgrade

To make the most of the new features and improvements in our v0.11 release, make sure you upgrade the Inductiva client package. Simply run the following command:

pip install –upgrade inductiva

As always, your feedback shapes Inductiva’s future, let us know what features or simulators you’d like to see next!

A big thank you to our team and collaborators for making this release possible. 

Happy simulating!

 

Check out our blog

Inductiva API v0.14 release

GPU-Accelerated Simulations on Inductiva.AI – Faster, More Efficient HPC with Inductiva API v0.14

Inductiva API v0.14 introduces GPU-powered numerical simulations, real-time output monitoring, seamless AWS exports, and an expanded set of built-in simulators, enhancing high-performance computing (HPC) for scientific research. With GPU acceleration now available, users can leverage parallel computing for faster, large-scale simulations, significantly reducing runtime and boosting performance in molecular dynamics, CFD, fusion energy, and AI-driven physics modeling.

Banner image for blog post on Inductiva V0.13 release update

Unveiling v0.13: Local Meets Cloud and More

Run simulations your way with Bring Your Own Hardware (BYOH), leverage upgraded OpenFOAM and DualSPHysics support, and take full control with enhanced cost transparency. Transform your scientific computing workflow today!

Banner image for blog post on V0.12 release

Inductiva API v0.12: Benchmarking and Beyond

Discover the latest features in Inductiva API v0.12, including powerful benchmarking tools to optimize performance and costs, enhanced usability, and more!