=============
Why Use JAWS
=============

JAWS (JGI Analysis Workflow Service) simplifies and scales scientific workflows across multiple HPC facilities, all through a single command-line interface.

.. role:: bash(code)
   :language: bash

🚀 Simplified Workflow Submission
---------------------------------

With a single command, :bash:`jaws submit <workflow.wdl> <inputs.json> <site>`, you can launch your pipeline, no matter where it will run. JAWS takes care of moving your files, configuring the environment, and submitting your job securely and efficiently.

🔍 Real-Time Monitoring
-----------------------

Monitor the status of your workflows using intuitive commands like :bash:`jaws log`. Check the status, view outputs, and debug failed tasks from a centralized interface.

🌎 Access to Multiple Compute Sites
-----------------------------------

JAWS connects you to compute resources across DOE facilities. Examples include:

.. figure:: /Figures/JAWS-deployment-structure.png
   :class: with-shadow
   :scale: 70%
   :align: center

   *JAWS is deployed across multiple DOE HPC systems, with multiple sites per system. Green indicates JGI-accessible sites, purple marks NMDC project sites, and orange shows KBase project sites.*  
   * *Deployment to the IRI Testbed is in progress.*

All compute sites are managed centrally by JAWS, allowing users to focus on science—not infrastructure.

📦 Portable and Reproducible Workflows
--------------------------------------

JAWS runs containerized tasks using Shifter or Apptainer-compatible runtimes. This ensures portability and consistency across systems. All workflows are written in WDL (Workflow Description Language) and executed via Cromwell.


📊 Performance and Provenance
-----------------------------

JAWS captures and visualizes detailed performance metrics through the `JAWS Dashboard <https://jaws-docs.readthedocs.io>`_. This includes:

- CPU and memory usage
- Task-level runtime tracking
- Debug return codes


🤝 Hands-On Support and Community
----------------------------------

The JAWS Team actively supports users through:

- Weekly office hours and pair programming sessions
- Comprehensive documentation and training materials
- Monthly JAWS User Meetings for updates, demos, and feedback

Whether you're porting a legacy pipeline or designing a new one, help is always available.

.. figure:: /Figures/why_jaws.svg
   :class: with-shadow
   :scale: 50%
   :align: center

   **JAWS helps you run reproducible, scalable, and secure workflows across DOE facilities.**