# 1. Create the venv
python3 -m venv .venv

# 2. Activate (the conda/unset lines are harmless
#    w/o Conda; they stop a stale PROJ_LIB from
#    hanging `import rasterio`)
conda deactivate 2>/dev/null || true
unset PROJ_LIB PROJ_DATA
source .venv/bin/activate

# 3. Install deps
pip install --upgrade pip
pip install -r supporting_scripts/requirements.txt

# 4. Verify — call the venv's own python directly with a clean
#    environment. This is the "it just works" form: no timeout,
#    no retries, no chance of a Conda shim interfering.
env -u PROJ_LIB -u PROJ_DATA -u GDAL_DATA \
    -u CONDA_PREFIX -u CONDA_DEFAULT_ENV \
    ./.venv/bin/python -c "import rasterio, pygmsh, pyvista; print('ok')"
# → if it hangs > 10 s, see the troubleshooting note on the right

gmsh wheel fails? brew install gmsh (macOS) / apt install gmsh (Linux), then re-run pip.

Verify still hangs? Conda is polluting the child process with DYLD/LD_LIBRARY_PATH. Last resort: open a fresh terminal (no auto-Conda), source .venv/bin/activate and re-run step 4. Or permanently disable Conda auto-activation: conda config --set auto_activate_base false.

Windows PowerShell:  if ($env:CONDA_DEFAULT_ENV){conda deactivate}; Remove-Item Env:PROJ_LIB,Env:PROJ_DATA -EA SilentlyContinue; .venv\Scripts\Activate.ps1; then .venv\Scripts\python -c "import rasterio, pygmsh, pyvista; print('ok')".

# 1. Move into the 1_Model_Config folder
# If you are in FLUXOS_cpp, you can run
cd supporting_scripts/1_Model_Config/

# 2. Copy the template to a project-specific name
#    (anything like model_config_<project>.py)
cp model_config_template.py \
   model_config_myTest.py

# 3. Open the copy and edit the _config dict
#    (see next slide for the fields you need to set)
#    You can also just double-click the file and edit
#    it in any text editor — VS Code, Sublime, PyCharm,
#    TextEdit, Notepad++, etc. — no terminal needed.
nano model_config_myTest.py

# 4. Run it — from this folder OR anywhere else,
#    just point python at your edited copy
python model_config_myTest.py

# (run from repo root instead, if you prefer):
# python supporting_scripts/1_Model_Config/\
#        model_config_myTest.py

# Lives at 2_Read_Outputs/output_supporting_lib/fluxos_viewer.py
# Add --mesh-type triangular for .vtu output (regular = .txt default)

# Interactive 3D WebGL viewer (starts a local HTTP server
# on --webgl-port and opens http://localhost:8080)
python supporting_scripts/2_Read_Outputs/\
output_supporting_lib/fluxos_viewer.py \
    --results-dir Results/ \
    --dem Working_example/Rosa_2m.asc \
    --utm-zone 10 \
    --export-webgl \
    --webgl-output fluxos_web_rosa \
    --webgl-step 1 \
    --webgl-port 8080

# Animated KML/KMZ for Google Earth
# (default action if neither --export-webgl nor --export-video given)
python fluxos_viewer.py \
    --results-dir Results/ \
    --dem Working_example/Rosa_2m.asc \
    --utm-zone 10 \
    --output-dir fluxos_kml_rosa

# MP4 animation (requires ffmpeg in PATH)
python fluxos_viewer.py \
    --results-dir Results/ \
    --dem Working_example/Rosa_2m.asc \
    --utm-zone 10 \
    --export-video mp4 \
    --video-output flood.mp4 \
    --video-fps 15