antonioscalaunina/pyANTI-FASc: v1.4.0

🐳 Unified Docker Workflow

The Docker support has been extended (see previous enhancement description in versions v1.3.x) to provide a single unified environment for both command-line and interactive usage.

✨ Highlights

• A single Docker image now supports both:
  • CLI execution
  • JupyterLab interactive sessions
• Two usage modes are available through the same launcher:

🔹 CLI mode (default)

    ./antifasc

Runs the full pipeline as in previous versions.

🔹 Notebook mode (interactive)

     ./antifasc notebook

Launches JupyterLab inside the container for interactive exploration and visualization.

• No need to manage separate environments or images
• Same dependencies and runtime for both workflows
• Improved cross-platform consistency (Linux, macOS, Windows)

💡 This simplifies the user experience and ensures full reproducibility across all execution modes.

🗂️ Interactive Map Exploration

A new interactive notebook (interactive_slip_maps.ipynb) enables dynamic exploration of generated outputs.

✨ Features

• Hierarchical folder navigation via dropdown menus:
  • event → rigidity → magnitude → scaling law
• Dynamic selection of:
  • GeoJSON files
  • slip / rake visualization
  • Interactive plotting using Folium maps
  • Integrated preview of generated HTML maps
• Automatic update of available files after new runs

💡 This significantly simplifies post-processing and inspection of large ensembles of slip distributions.

🗺️ Enhanced Mapping Capabilities

The plotting system has been upgraded to support multiple basemaps and improved rendering.

✨ Highlights

• Support for multiple basemaps for GeoJSON outputs:
  • CartoDB:
    • Positron (default)
    • Positron (no labels)
    • Dark Matter
    • Voyager
  • OpenTopoMap
  • ESRI Satellite (with labels)
• Automatic handling of tile attribution when required
• Improved color mapping using branca.colormap
• Better visual contrast for scientific visualization (e.g., dark mode compatibility)

⚙️ Workflow Improvements

This release improves consistency and usability across the entire pipeline.

✨ Highlights

• Unified CLI and Notebook workflows under the same Docker environment
• Improved file handling:
• Safe overwrite of output directories
• Better error handling for repeated runs
• Refactoring of plotting utilities for modular use in both scripts and notebooks
• Clear separation between core logic (Python modules) and UI (notebooks)

🧪 HTML Map Integration

Users can now generate and preview HTML maps directly from the interactive interface.

✨ Features

• One-click HTML generation from selected folders
• Automatic detection of available HTML outputs
• Dropdown-based selection and inline preview within Jupyter
• No need to open files manually in external browsers

🧠 Notes

• The interactive workflow is fully compatible with existing CLI-based pipelines
• Docker remains the recommended execution environment
• Manual (Conda-based) installation is still supported (see MANUAL_INSTALL.md)
• All outputs remain fully synchronized with the host filesystem

✅ Benefits

• Much easier exploration of simulation outputs
• Reduced need for manual scripting during post-processing
• Improved reproducibility and usability across platforms
• More intuitive workflow for both new and advanced users

💡 In short: This release transforms PyANTI-FASc from a pure command-line tool into an interactive analysis environment, making slip distribution exploration faster, clearer, and more user-friendly.