OverviewWeb Quickstart

Web Quickstart

This guide walks through the typical user flow for the Biosimulant web app: signing in, browsing models, running a simulation, and viewing results. No local install needed.

Before you start

  • Time: about 5 minutes.
  • Requirements: a modern browser. Public labs can be browsed without installing anything; an account may be required to start and save runs.
  • Outcome: one completed public simulation with plots, downloadable results, and provenance.

Prefer to run simulations locally? See the Library Quickstart (Python), the Desktop App, or the CLI.

Step 1: Open the Hub

Open the Biosimulant Hub and choose a published lab. For a known starting point, use the Lotka–Volterra System Lab.

Step 2: Sign in when needed

If sign-in is required for the Biosimulant Web workspace you are using:

  1. Open the platform in your browser
  2. Click Sign In
  3. Authenticate with your account

Public browsing may be available without sign-in, but saving labs and starting runs typically requires authentication.

Step 3: Inspect the lab

  1. Click Models in the navigation bar
  2. Use the search bar to find models by name or keyword
  3. Filter by:
    • Standard (SBML, NeuroML, CellML, NMODL, ONNX, other)
    • Tags
    • Visibility or source, if your account can see those filters

Open the lab and inspect:

  • Description: What the model represents
  • Parameters: Configurable inputs
  • Models and wiring: The modules that participate in the lab
  • References: Associated publications

Step 4: Run the simulation

  1. From the lab page, click Run
  2. Configure the run:
    • Duration: How long to simulate (e.g., 100 seconds)
    • Communication step: The coupling boundary between module exchanges, when exposed
    • Parameters: Override default values if needed
  3. Click Start Run

The simulation runs in the background. You can navigate away and return to its run page.

Verify the result

Once the simulation completes:

  1. Confirm the run status is Completed
  2. Inspect its time-series plots, summary tables, or domain-specific visualizations
  3. Review the resolved package version and provenance
  4. Download available results or artifacts

For the Lotka–Volterra lab, expect lagged predator–prey oscillations and a closed-loop phase portrait.

Troubleshooting

  • Run is unavailable: sign in and confirm the lab is public or shared with your account.
  • Run remains queued: keep the run URL and check it again; managed runs are durable.
  • Unexpected result: reset the inputs to their defaults and compare the resolved lab version with the example page.
  • Need a reproducible script: switch to the Developer API quickstart.

Next steps

Library Quickstart (Python)Overview