From 839d314ea4413cf8983a9306b1467249d1d642e9 Mon Sep 17 00:00:00 2001 From: Boris Rojo Tanzi <71112604+borisrojotanzi@users.noreply.github.com> Date: Thu, 5 Nov 2026 14:40:56 -0300 Subject: [PATCH 01/13] refactor: freeze legacy code and add golden-master regression tests --- .gitignore | 253 +++--------------- CHANGELOG.md | 22 ++ CONTRIBUTING.md | 17 +- README.md | 12 +- docs/source/api/index.rst | 24 +- docs/source/conf.py | 2 +- examples/README.md | 22 +- {src/ldem => examples/beam_102}/DATA0.DAT | 0 {src/ldem => examples/beam_102}/LET.AN1 | 0 .../beam_102}/arquivo_3lc_rnao_cv05 | 0 {src/ldem => legacy}/ANSYS.m | 0 {src/ldem => legacy}/BOUND.m | 6 + {src/ldem => legacy}/CABAR.m | 0 {src/ldem => legacy}/CACOEV.m | 0 {src/ldem => legacy}/CALAUX.m | 0 {src/ldem => legacy}/CALCOEV.m | 0 {src/ldem => legacy}/CALOAD.m | 0 {src/ldem => legacy}/CALRES.m | 0 {src/ldem => legacy}/CONECTI.m | 0 {src/ldem => legacy}/CONSTIT.m | 0 {src/ldem => legacy}/COORD.m | 0 {src/ldem => legacy}/COORDSUB.m | 0 {src/ldem => legacy}/DEFEP.m | 0 {src/ldem => legacy}/DIACO1.m | 0 {src/ldem => legacy}/ENERG2.m | 0 {src/ldem => legacy}/EXTCO1.m | 0 {src/ldem => legacy}/IGN012.m | 0 {src/ldem => legacy}/IMPERF.m | 0 {src/ldem => legacy}/INTCO1.m | 0 legacy/KNOWN_ISSUES.md | 42 +++ {src/ldem => legacy}/NAYFES0.m | 0 {src/ldem => legacy}/NODMASS.m | 0 {src/ldem => legacy}/RMEC.m | 0 {src/ldem => legacy}/RMEC2.m | 0 {src/ldem => legacy}/RMECDI.m | 0 {src/ldem => legacy}/RMECEX.m | 0 {src/ldem => legacy}/RMECIN.m | 0 {src/ldem => legacy}/WRICON.m | 0 {src/ldem => legacy}/WRIDIPO.m | 0 {src/ldem => legacy}/WRIENE.m | 0 {src/ldem => legacy}/ini_DEM3.m | 0 {src/ldem => legacy}/main1.m | 37 ++- {src/ldem => legacy}/prepvar.m | 0 {src/ldem => legacy}/read_dat0.m | 0 {src/ldem => sandbox}/Energy_balance.m | 0 {src/ldem => sandbox}/Teste_combinado.m | 0 {src/ldem => sandbox}/Teste_pot.m | 0 .../ldem => sandbox}/gerar_transicao_dupla2.m | 0 {src/ldem => sandbox}/main.m | 0 {src/ldem => sandbox}/mainDEM.m | 0 setup_path.m | 15 +- src/ldem/BARR_ROMP.dat | 1 - src/ldem/Copy_of_COORDSUB.m | 50 ---- src/ldem/Copy_of_main - Copia.m | 16 -- src/ldem/Copy_of_main.m | 16 -- src/ldem/Energia_Barra.TXT | 0 src/ldem/LET.CON | 65 ----- src/ldem/LET.DIS | 0 src/ldem/LET.ENE | 1 - src/ldem/LET.POS | 1 - src/ldem/Lei_Barra.TXT | 2 - src/ldem/SIM01.DAT | 1 - src/ldem/Teste_combinado - Copia.m | 239 ----------------- src/ldem/Teste_pot - Copia.m | 239 ----------------- src/ldem/gerar_transicao_dupla2 - Copia.m | 74 ----- src/ldem/ini_DEM3 - Copia.m | 218 --------------- src/ldem/initialization_DEM - Copia.m | 15 -- src/ldem/initialization_DEM.m | 15 -- src/ldem/main - Copia.m | 15 -- tests/TestLdemPath.m | 4 +- tests/fixtures/bending102.mat | Bin 0 -> 558497 bytes tests/fixtures/tension101_damage.mat | Bin 0 -> 167063 bytes tests/fixtures/tension101_elastic.mat | Bin 0 -> 160198 bytes tests/regression/TestFixtures.m | 62 +++++ tests/regression/TestLegacyReproducibility.m | 63 +++++ tests/run_tests.m | 37 ++- tests/tools/generateReference.m | 48 ++++ tests/tools/referenceCases.m | 55 ++++ tests/tools/runLegacyCase.m | 97 +++++++ tests/tools/writeDataFile.m | 52 ++++ 80 files changed, 590 insertions(+), 1248 deletions(-) rename {src/ldem => examples/beam_102}/DATA0.DAT (100%) rename {src/ldem => examples/beam_102}/LET.AN1 (100%) rename {src/ldem => examples/beam_102}/arquivo_3lc_rnao_cv05 (100%) rename {src/ldem => legacy}/ANSYS.m (100%) rename {src/ldem => legacy}/BOUND.m (93%) rename {src/ldem => legacy}/CABAR.m (100%) rename {src/ldem => legacy}/CACOEV.m (100%) rename {src/ldem => legacy}/CALAUX.m (100%) rename {src/ldem => legacy}/CALCOEV.m (100%) rename {src/ldem => legacy}/CALOAD.m (100%) rename {src/ldem => legacy}/CALRES.m (100%) rename {src/ldem => legacy}/CONECTI.m (100%) rename {src/ldem => legacy}/CONSTIT.m (100%) rename {src/ldem => legacy}/COORD.m (100%) rename {src/ldem => legacy}/COORDSUB.m (100%) rename {src/ldem => legacy}/DEFEP.m (100%) rename {src/ldem => legacy}/DIACO1.m (100%) rename {src/ldem => legacy}/ENERG2.m (100%) rename {src/ldem => legacy}/EXTCO1.m (100%) rename {src/ldem => legacy}/IGN012.m (100%) rename {src/ldem => legacy}/IMPERF.m (100%) rename {src/ldem => legacy}/INTCO1.m (100%) create mode 100644 legacy/KNOWN_ISSUES.md rename {src/ldem => legacy}/NAYFES0.m (100%) rename {src/ldem => legacy}/NODMASS.m (100%) rename {src/ldem => legacy}/RMEC.m (100%) rename {src/ldem => legacy}/RMEC2.m (100%) rename {src/ldem => legacy}/RMECDI.m (100%) rename {src/ldem => legacy}/RMECEX.m (100%) rename {src/ldem => legacy}/RMECIN.m (100%) rename {src/ldem => legacy}/WRICON.m (100%) rename {src/ldem => legacy}/WRIDIPO.m (100%) rename {src/ldem => legacy}/WRIENE.m (100%) rename {src/ldem => legacy}/ini_DEM3.m (100%) rename {src/ldem => legacy}/main1.m (95%) rename {src/ldem => legacy}/prepvar.m (100%) rename {src/ldem => legacy}/read_dat0.m (100%) rename {src/ldem => sandbox}/Energy_balance.m (100%) rename {src/ldem => sandbox}/Teste_combinado.m (100%) rename {src/ldem => sandbox}/Teste_pot.m (100%) rename {src/ldem => sandbox}/gerar_transicao_dupla2.m (100%) rename {src/ldem => sandbox}/main.m (100%) rename {src/ldem => sandbox}/mainDEM.m (100%) delete mode 100644 src/ldem/BARR_ROMP.dat delete mode 100644 src/ldem/Copy_of_COORDSUB.m delete mode 100644 src/ldem/Copy_of_main - Copia.m delete mode 100644 src/ldem/Copy_of_main.m delete mode 100644 src/ldem/Energia_Barra.TXT delete mode 100644 src/ldem/LET.CON delete mode 100644 src/ldem/LET.DIS delete mode 100644 src/ldem/LET.ENE delete mode 100644 src/ldem/LET.POS delete mode 100644 src/ldem/Lei_Barra.TXT delete mode 100644 src/ldem/SIM01.DAT delete mode 100644 src/ldem/Teste_combinado - Copia.m delete mode 100644 src/ldem/Teste_pot - Copia.m delete mode 100644 src/ldem/gerar_transicao_dupla2 - Copia.m delete mode 100644 src/ldem/ini_DEM3 - Copia.m delete mode 100644 src/ldem/initialization_DEM - Copia.m delete mode 100644 src/ldem/initialization_DEM.m delete mode 100644 src/ldem/main - Copia.m create mode 100644 tests/fixtures/bending102.mat create mode 100644 tests/fixtures/tension101_damage.mat create mode 100644 tests/fixtures/tension101_elastic.mat create mode 100644 tests/regression/TestFixtures.m create mode 100644 tests/regression/TestLegacyReproducibility.m create mode 100644 tests/tools/generateReference.m create mode 100644 tests/tools/referenceCases.m create mode 100644 tests/tools/runLegacyCase.m create mode 100644 tests/tools/writeDataFile.m diff --git a/.gitignore b/.gitignore index 8892ef0..82aea6c 100644 --- a/.gitignore +++ b/.gitignore @@ -1,225 +1,34 @@ -# Byte-compiled / optimized / DLL files -__pycache__/ -*.py[codz] -*$py.class - -# C extensions -*.so - -# Distribution / packaging -.Python -build/ -develop-eggs/ -dist/ -downloads/ -eggs/ -.eggs/ -lib/ -lib64/ -parts/ -sdist/ -var/ -wheels/ -share/python-wheels/ -*.egg-info/ -.installed.cfg -*.egg -MANIFEST - -# PyInstaller -# Usually these files are written by a python script from a template -# before PyInstaller builds the exe, so as to inject date/other infos into it. -*.manifest -*.spec - -# Installer logs -pip-log.txt -pip-delete-this-directory.txt - -# Unit test / coverage reports -htmlcov/ -.tox/ -.nox/ -.coverage -.coverage.* -.cache -nosetests.xml -coverage.xml -*.cover -*.py.cover -*.lcov -.hypothesis/ -.pytest_cache/ -cover/ - -# Translations -*.mo -*.pot - -# Django stuff: -*.log -local_settings.py -db.sqlite3 -db.sqlite3-journal - -# Flask stuff: -instance/ -.webassets-cache - -# Scrapy stuff: -.scrapy - -# Sphinx documentation -docs/_build/ - -# PyBuilder -.pybuilder/ -target/ - -# Jupyter Notebook -.ipynb_checkpoints - -# IPython -profile_default/ -ipython_config.py - -# pyenv -# For a library or package, you might want to ignore these files since the code is -# intended to run in multiple environments; otherwise, check them in: -# .python-version - -# pipenv -# According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control. -# However, in case of collaboration, if having platform-specific dependencies or dependencies -# having no cross-platform support, pipenv may install dependencies that don't work, or not -# install all needed dependencies. -# Pipfile.lock - -# uv -# Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control. -# This is especially recommended for binary packages to ensure reproducibility, and is more -# commonly ignored for libraries. -# uv.lock - -# poetry -# Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control. -# This is especially recommended for binary packages to ensure reproducibility, and is more -# commonly ignored for libraries. -# https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control -# poetry.lock -# poetry.toml - -# pdm -# Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control. -# pdm recommends including project-wide configuration in pdm.toml, but excluding .pdm-python. -# https://pdm-project.org/en/latest/usage/project/#working-with-version-control -# pdm.lock -# pdm.toml -.pdm-python -.pdm-build/ - -# pixi -# Similar to Pipfile.lock, it is generally recommended to include pixi.lock in version control. -# pixi.lock -# Pixi creates a virtual environment in the .pixi directory, just like venv module creates one -# in the .venv directory. It is recommended not to include this directory in version control. -.pixi/* -!.pixi/config.toml - -# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm -__pypackages__/ - -# Celery stuff -celerybeat-schedule* -celerybeat.pid - -# Redis -*.rdb -*.aof -*.pid - -# RabbitMQ -mnesia/ -rabbitmq/ -rabbitmq-data/ - -# ActiveMQ -activemq-data/ - -# SageMath parsed files -*.sage.py - -# Environments -.env -.envrc -.venv -env/ -venv/ -ENV/ -env.bak/ -venv.bak/ - -# Spyder project settings -.spyderproject -.spyproject - -# Rope project settings -.ropeproject - -# mkdocs/Zensical documentation -/site - -# mypy -.mypy_cache/ -.dmypy.json -dmypy.json - -# Pyre type checker -.pyre/ - -# pytype static type analyzer -.pytype/ - -# Cython debug symbols -cython_debug/ - -# PyCharm -# JetBrains specific template is maintained in a separate JetBrains.gitignore that can -# be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore -# and can be added to the global gitignore or merged into this file. For a more nuclear -# option (not recommended) you can uncomment the following to ignore the entire idea folder. -# .idea/ - -# Abstra -# Abstra is an AI-powered process automation framework. -# Ignore directories containing user credentials, local state, and settings. -# Learn more at https://abstra.io/docs -.abstra/ - -# Visual Studio Code -# Visual Studio Code specific template is maintained in a separate VisualStudioCode.gitignore that -# can be found at https://github.com/github/gitignore/blob/main/Global/VisualStudioCode.gitignore -# and can be added to the global gitignore or merged into this file. However, if you prefer, you -# could uncomment the following to ignore the entire vscode folder -# .vscode/ -# Temporary file for partial code execution -tempCodeRunnerFile.py - -# Ruff stuff: -.ruff_cache/ - -# PyPI configuration file -.pypirc - -# Marimo -marimo/_static/ -marimo/_lsp/ -__marimo__/ - -# Streamlit -.streamlit/secrets.toml - -# MATLAB / LDEM +# MATLAB *.asv *.m~ +*.mex* +slprj/ +codegen/ +*.autosave +resources/project/ + +# LDEM simulation outputs (written to the working directory / output folder) +output/ +LET.CON +LET.DIS +LET.POS +LET.ENE +LET.RES +Lei_Barra.TXT +Energia_Barra.TXT +BARI.txt +ANSYS*.MAC +*.vtu +*.pvd + +# Test artifacts +test-results/ +code-coverage/ + +# Python / Sphinx (docs) +__pycache__/ +.venv/ docs/build/ +docs/_build/ +BARR_ROMP.dat +SIM01.DAT diff --git a/CHANGELOG.md b/CHANGELOG.md index 77d6d26..159822b 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -5,3 +5,25 @@ - Repository structure: README, LICENSE, CITATION, CONTRIBUTING. - Sphinx documentation (English/Spanish) with API generated from `.m` files. - `matlab.unittest` test suite and GitHub Actions workflows. +- Golden-master regression infrastructure (`tests/tools`, `tests/fixtures`, + `tests/regression`): three small reference simulations generated from the + legacy code, plus a slow test that checks the legacy code still reproduces + them (`run_tests(IncludeSlow=true)`). +- `legacy/KNOWN_ISSUES.md`: bugs found in the original code and how the + refactored code will resolve each one. + +### Changed +- Original routines moved from `src/ldem` to `legacy/` (frozen reference). +- Experimental scripts moved to `sandbox/`; example inputs to `examples/beam_102/`. +- `.gitignore` now targets MATLAB and LDEM output files. +- `run_tests` searches subfolders and skips tests tagged `Slow` by default. + +### Fixed +- `legacy/main1.m`: removed scratch lines; fixed the end-of-run file closing + (undefined `fid12/fid15/fid19/fid20`) and the ANSYS output call. +- `legacy/BOUND.m`: `TEST 101` failed because `ini` was not assigned. + +### Removed +- Duplicate files (`* - Copia.m`, `Copy_of_*`), empty `initialization_DEM`, and + generated output files that were tracked by mistake (`LET.*`, `*.TXT`, + `SIM01.DAT`, `BARR_ROMP.dat`). diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 4578723..fa5bb5f 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -7,12 +7,12 @@ placed **immediately after the `function` line** (before `global` blocks): ```matlab function ini = CALOAD() -% CALOAD One-line summary (Portuguese). +% CALOAD One-line summary (English). % Longer description of what the routine does. global ... ``` -Comments in the source code are written in Portuguese. +Comments in new code are written in English (the legacy code keeps its original Portuguese comments). ## Workflow 1. Branch from `dev`. @@ -20,5 +20,14 @@ Comments in the source code are written in Portuguese. 3. Run `run_tests` in MATLAB and build the docs (`docs/`) locally. 4. Open a pull request. -Files excluded from docs/tests: backups (`*.asv`), copies (`*Copia*`, -`Copy_of_*`) and scratch scripts (`Teste_*`, `main1`, ...). +Files excluded from docs/tests: backups (`*.asv`) and the scratch scripts in `sandbox/`. + +## Repository layout during the refactoring +- `legacy/` is the **frozen** original code. Do not change its numerics: the + regression tests compare the refactored code against it. Known problems are + listed in `legacy/KNOWN_ISSUES.md`. +- `tests/fixtures/*.mat` are golden-master results produced by the legacy code. + Regenerate them only if the legacy code is changed on purpose: + `addpath('tests/tools'); generateReference`. +- `run_tests` skips slow tests by default; use `run_tests(IncludeSlow=true)` + before opening a pull request. diff --git a/README.md b/README.md index 922f4a3..2021956 100644 --- a/README.md +++ b/README.md @@ -16,7 +16,7 @@ quasi-brittle materials (concrete, rocks). | Path | Content | |------|---------| -| `src/ldem/` | LDEM source code (`.m`) | +| `legacy/` | Original LDEM routines (frozen reference, being refactored into `src/+ldem`) | | `tests/` | `matlab.unittest` test suite | | `docs/` | Sphinx documentation (English and Spanish), API generated from the `.m` files | | `examples/` | How to run the example simulations | @@ -24,7 +24,7 @@ quasi-brittle materials (concrete, rocks). ### Quick start ```matlab ->> setup_path % adds src/ldem to the MATLAB path +>> setup_path % adds legacy/ to the MATLAB path >> main % runs the default simulation ``` @@ -68,7 +68,7 @@ quase-frágeis (concreto, rochas). | Caminho | Conteúdo | |---------|----------| -| `src/ldem/` | Código-fonte LDEM (`.m`) | +| `legacy/` | Rotinas LDEM originais (referência congelada, em refatoração para `src/+ldem`) | | `tests/` | Suíte de testes com `matlab.unittest` | | `docs/` | Documentação Sphinx (espanhol e inglês), API gerada a partir dos `.m` | | `examples/` | Como executar as simulações de exemplo | @@ -76,7 +76,7 @@ quase-frágeis (concreto, rochas). ### Início rápido ```matlab ->> setup_path % adiciona src/ldem ao path do MATLAB +>> setup_path % adiciona legacy/ ao path do MATLAB >> main % executa a simulação padrão ``` @@ -118,7 +118,7 @@ cuasi-frágiles (hormigón, rocas). | Ruta | Contenido | |------|-----------| -| `src/ldem/` | Código fuente LDEM (`.m`) | +| `legacy/` | Rutinas LDEM originales (referencia congelada, en refactorización hacia `src/+ldem`) | | `tests/` | Suite de tests con `matlab.unittest` | | `docs/` | Documentación Sphinx (español e inglés), API generada desde los `.m` | | `examples/` | Cómo ejecutar las simulaciones de ejemplo | @@ -126,7 +126,7 @@ cuasi-frágiles (hormigón, rocas). ### Inicio rápido ```matlab ->> setup_path % agrega src/ldem al path de MATLAB +>> setup_path % agrega legacy/ al path de MATLAB >> main % ejecuta la simulación por defecto ``` diff --git a/docs/source/api/index.rst b/docs/source/api/index.rst index 41235be..ca38a37 100644 --- a/docs/source/api/index.rst +++ b/docs/source/api/index.rst @@ -2,7 +2,7 @@ API reference / Referencia de la API ==================================== Generated automatically from the comments of the ``.m`` files in -``src/ldem`` (comments are written in Portuguese) / +``legacy/`` (comments are written in Portuguese) / Generada automáticamente desde los comentarios de los ``.m``. .. note:: @@ -12,30 +12,30 @@ Generada automáticamente desde los comentarios de los ``.m``. and append it to this list / Para añadir otra rutina, documentarla y agregarla a esta lista. -.. mat:module:: ldem +.. mat:module:: legacy Initialisation / Inicialización ------------------------------- -.. mat:autofunction:: ldem.ini_DEM3 -.. mat:autofunction:: ldem.read_dat0 -.. mat:autofunction:: ldem.prepvar +.. mat:autofunction:: legacy.ini_DEM3 +.. mat:autofunction:: legacy.read_dat0 +.. mat:autofunction:: legacy.prepvar Geometry and connectivity / Geometría y conectividad ---------------------------------------------------- -.. mat:autofunction:: ldem.CONECTI -.. mat:autofunction:: ldem.INTCO1 +.. mat:autofunction:: legacy.CONECTI +.. mat:autofunction:: legacy.INTCO1 Mechanics, loads and boundary conditions / Mecánica, cargas y contorno ---------------------------------------------------------------------- -.. mat:autofunction:: ldem.RMEC -.. mat:autofunction:: ldem.BOUND -.. mat:autofunction:: ldem.CALOAD +.. mat:autofunction:: legacy.RMEC +.. mat:autofunction:: legacy.BOUND +.. mat:autofunction:: legacy.CALOAD Results and energy / Resultados y energía ----------------------------------------- -.. mat:autofunction:: ldem.CALRES -.. mat:autofunction:: ldem.ENERG2 +.. mat:autofunction:: legacy.CALRES +.. mat:autofunction:: legacy.ENERG2 diff --git a/docs/source/conf.py b/docs/source/conf.py index 87be76f..eb4209c 100644 --- a/docs/source/conf.py +++ b/docs/source/conf.py @@ -13,7 +13,7 @@ ] # --- MATLAB API (generated from the .m comments) --------------------------- -matlab_src_dir = os.path.abspath(os.path.join(os.path.dirname(__file__), "..", "..", "src")) +matlab_src_dir = os.path.abspath(os.path.join(os.path.dirname(__file__), "..", "..")) matlab_short_links = True matlab_auto_link = "basic" primary_domain = "mat" diff --git a/examples/README.md b/examples/README.md index fff4150..6a561ef 100644 --- a/examples/README.md +++ b/examples/README.md @@ -1,7 +1,21 @@ # Examples -1. From the repository root: `setup_path` -2. Input data: `src/ldem/DATA0.DAT`, `src/ldem/SIM01.DAT` -3. Run `main` (or `mainDEM`) from `src/ldem`. +## beam_102 -Outputs (`LET.*`, `*.TXT`) are written to the working directory. +Input files of the beam (TEST 102) example: + +| File | Purpose | +|------|---------| +| `DATA0.DAT` | Simulation parameters (read by `read_dat0`) | +| `LET.AN1` | Names of the ANSYS files to write | +| `arquivo_3lc_rnao_cv05` | Random field applied to the critical strain of each bar (11 MB) | + +The legacy driver reads these files from the **current folder** and writes its +outputs (`LET.*`, `*.TXT`, `ANSYS*.MAC`, ...) there too, so run it from a +scratch copy: + +```matlab +>> setup_path % from the repository root +>> mkdir('run'); copyfile('examples/beam_102/*', 'run'); cd run +>> main1 +``` diff --git a/src/ldem/DATA0.DAT b/examples/beam_102/DATA0.DAT similarity index 100% rename from src/ldem/DATA0.DAT rename to examples/beam_102/DATA0.DAT diff --git a/src/ldem/LET.AN1 b/examples/beam_102/LET.AN1 similarity index 100% rename from src/ldem/LET.AN1 rename to examples/beam_102/LET.AN1 diff --git a/src/ldem/arquivo_3lc_rnao_cv05 b/examples/beam_102/arquivo_3lc_rnao_cv05 similarity index 100% rename from src/ldem/arquivo_3lc_rnao_cv05 rename to examples/beam_102/arquivo_3lc_rnao_cv05 diff --git a/src/ldem/ANSYS.m b/legacy/ANSYS.m similarity index 100% rename from src/ldem/ANSYS.m rename to legacy/ANSYS.m diff --git a/src/ldem/BOUND.m b/legacy/BOUND.m similarity index 93% rename from src/ldem/BOUND.m rename to legacy/BOUND.m index 6b9fdee..b9f8f50 100644 --- a/src/ldem/BOUND.m +++ b/legacy/BOUND.m @@ -90,6 +90,12 @@ % RETURN % END % +% FIX: ini was only assigned inside "if TEST == 102", so TEST 101 failed with +% "output argument ini not assigned". Assign it unconditionally. +% NOTE (not changed, physics frozen): in TEST 101 mask2 uses (M1 - 0.51*LCO) +% instead of (M1 - 0.51)*LCO, so it selects no nodes. +ini = 1; + if TEST == 101 % Masks for the two conditions (operate on all elements at once) diff --git a/src/ldem/CABAR.m b/legacy/CABAR.m similarity index 100% rename from src/ldem/CABAR.m rename to legacy/CABAR.m diff --git a/src/ldem/CACOEV.m b/legacy/CACOEV.m similarity index 100% rename from src/ldem/CACOEV.m rename to legacy/CACOEV.m diff --git a/src/ldem/CALAUX.m b/legacy/CALAUX.m similarity index 100% rename from src/ldem/CALAUX.m rename to legacy/CALAUX.m diff --git a/src/ldem/CALCOEV.m b/legacy/CALCOEV.m similarity index 100% rename from src/ldem/CALCOEV.m rename to legacy/CALCOEV.m diff --git a/src/ldem/CALOAD.m b/legacy/CALOAD.m similarity index 100% rename from src/ldem/CALOAD.m rename to legacy/CALOAD.m diff --git a/src/ldem/CALRES.m b/legacy/CALRES.m similarity index 100% rename from src/ldem/CALRES.m rename to legacy/CALRES.m diff --git a/src/ldem/CONECTI.m b/legacy/CONECTI.m similarity index 100% rename from src/ldem/CONECTI.m rename to legacy/CONECTI.m diff --git a/src/ldem/CONSTIT.m b/legacy/CONSTIT.m similarity index 100% rename from src/ldem/CONSTIT.m rename to legacy/CONSTIT.m diff --git a/src/ldem/COORD.m b/legacy/COORD.m similarity index 100% rename from src/ldem/COORD.m rename to legacy/COORD.m diff --git a/src/ldem/COORDSUB.m b/legacy/COORDSUB.m similarity index 100% rename from src/ldem/COORDSUB.m rename to legacy/COORDSUB.m diff --git a/src/ldem/DEFEP.m b/legacy/DEFEP.m similarity index 100% rename from src/ldem/DEFEP.m rename to legacy/DEFEP.m diff --git a/src/ldem/DIACO1.m b/legacy/DIACO1.m similarity index 100% rename from src/ldem/DIACO1.m rename to legacy/DIACO1.m diff --git a/src/ldem/ENERG2.m b/legacy/ENERG2.m similarity index 100% rename from src/ldem/ENERG2.m rename to legacy/ENERG2.m diff --git a/src/ldem/EXTCO1.m b/legacy/EXTCO1.m similarity index 100% rename from src/ldem/EXTCO1.m rename to legacy/EXTCO1.m diff --git a/src/ldem/IGN012.m b/legacy/IGN012.m similarity index 100% rename from src/ldem/IGN012.m rename to legacy/IGN012.m diff --git a/src/ldem/IMPERF.m b/legacy/IMPERF.m similarity index 100% rename from src/ldem/IMPERF.m rename to legacy/IMPERF.m diff --git a/src/ldem/INTCO1.m b/legacy/INTCO1.m similarity index 100% rename from src/ldem/INTCO1.m rename to legacy/INTCO1.m diff --git a/legacy/KNOWN_ISSUES.md b/legacy/KNOWN_ISSUES.md new file mode 100644 index 0000000..896ae11 --- /dev/null +++ b/legacy/KNOWN_ISSUES.md @@ -0,0 +1,42 @@ +# Known issues of the legacy code + +`legacy/` is the frozen reference implementation. The regression tests compare +the refactored code against it, so its numerics must not change. Issues found +while freezing it are listed here and are **resolved explicitly in the new +code** (each one has a test that documents the decision). + +## Fixed in legacy (no effect on the physics) + +| File | Problem | Fix | +|------|---------|-----| +| `main1.m` | Scratch lines `a=1, b=2, c=3` at the top | Removed | +| `main1.m` | Closing section used undefined `fid12/fid15/fid19/fid20` and crashed at the end of every run | Closes the file ids that were really opened | +| `main1.m` | `ARMANS(I3)` (parentheses) and `[...] = ini==ANSYS(...)` crashed when ANSYS output was enabled | `ARMANS{I3}`, plain call | +| `BOUND.m` | `ini` only assigned when `TEST == 102`, so `TEST 101` failed | Assigned unconditionally | + +## Not fixed (would change results or output) - decide in the new code + +1. **`ENERG2.m` lines 172-174: kinetic energy is not summed.** + `ENCN = ENCN + (MAS.*VLX.^2)/2` is element-wise, so `ENCN` is a + 1-by-`INT` vector (kinetic energy per node) instead of a scalar. `ENIN`, + `DEN` and the energy balance inherit this shape. + *New code:* `energy.kinetic = sum(...)` (scalar). The regression test + compares `sum(ENCN)` with the new scalar. +2. **`WRIENE.m` line 35: invalid format `%25.12` (missing `e`).** + `fprintf` stops at the invalid conversion, so `LET.ENE` is truncated and + garbled. Correcting only the format would write one row per element of the + `ENCN` vector (90 MB for 200 steps), so it depends on issue 1. + *New code:* one well-formed row per saved step. +3. **`BOUND.m`, `TEST == 101`: operator precedence.** + `mask2` uses `U0 > (M1 - 0.51*LCO)` instead of `(M1 - 0.51)*LCO`; it + selects no node, so the right end is never fixed in x. + *New code:* decide with the author whether this support was intended. +4. **`CABAR.m` / `ENERG2.m`: tracked bar hardcoded to 7014.** + *New code:* `params.trackedBar`. +5. **`CALOAD.m` / `BOUND.m` / `CALRES.m` / `ANSYS.m` (`TEST == 102`):** + geometry hardcoded in module units (`33.49`, `4.51`, `50.5`...), so the + scenario only works for meshes with `M >= ~70`. + *New code:* scenario parameters. +6. **`IMPERF.m`: `LABELN` is set to 1 and then immediately to 0,** so the mesh + perturbation is never applied (the random generator seed has no effect). +7. **Preallocation `INT = 168000`, `INB = 2300000`** limits the mesh size. diff --git a/src/ldem/NAYFES0.m b/legacy/NAYFES0.m similarity index 100% rename from src/ldem/NAYFES0.m rename to legacy/NAYFES0.m diff --git a/src/ldem/NODMASS.m b/legacy/NODMASS.m similarity index 100% rename from src/ldem/NODMASS.m rename to legacy/NODMASS.m diff --git a/src/ldem/RMEC.m b/legacy/RMEC.m similarity index 100% rename from src/ldem/RMEC.m rename to legacy/RMEC.m diff --git a/src/ldem/RMEC2.m b/legacy/RMEC2.m similarity index 100% rename from src/ldem/RMEC2.m rename to legacy/RMEC2.m diff --git a/src/ldem/RMECDI.m b/legacy/RMECDI.m similarity index 100% rename from src/ldem/RMECDI.m rename to legacy/RMECDI.m diff --git a/src/ldem/RMECEX.m b/legacy/RMECEX.m similarity index 100% rename from src/ldem/RMECEX.m rename to legacy/RMECEX.m diff --git a/src/ldem/RMECIN.m b/legacy/RMECIN.m similarity index 100% rename from src/ldem/RMECIN.m rename to legacy/RMECIN.m diff --git a/src/ldem/WRICON.m b/legacy/WRICON.m similarity index 100% rename from src/ldem/WRICON.m rename to legacy/WRICON.m diff --git a/src/ldem/WRIDIPO.m b/legacy/WRIDIPO.m similarity index 100% rename from src/ldem/WRIDIPO.m rename to legacy/WRIDIPO.m diff --git a/src/ldem/WRIENE.m b/legacy/WRIENE.m similarity index 100% rename from src/ldem/WRIENE.m rename to legacy/WRIENE.m diff --git a/src/ldem/ini_DEM3.m b/legacy/ini_DEM3.m similarity index 100% rename from src/ldem/ini_DEM3.m rename to legacy/ini_DEM3.m diff --git a/src/ldem/main1.m b/legacy/main1.m similarity index 95% rename from src/ldem/main1.m rename to legacy/main1.m index 9c40583..baf28b1 100644 --- a/src/ldem/main1.m +++ b/legacy/main1.m @@ -1,9 +1,7 @@ -% boris -a= 1 -b = 2 -c= 3 - - +% MAIN1 Legacy LDEM driver (frozen reference implementation). +% Run from the folder that contains DATA0.DAT, LET.AN1 and the random +% field file, with legacy/ on the MATLAB path. Do not modify the numerics: +% the regression tests in tests/regression compare against this code. clear all clc global INT INB U V W U0 V0 W0 BDX BDY BDZ VLX VLY VLZ @@ -465,10 +463,11 @@ if PR3 == OU3 I3 = I3 + 1; PR3 = 1; - fid11 = fopen(ARMANS(I3), 'w'); + % FIX: ARMANS is a cell array (braces) and ANSYS returns only a + % status flag; the bar counters are reset inside ANSYS. + fid11 = fopen(ARMANS{I3}, 'w'); fprintf(fid11, '!ARQUIVO NO TEMPO = %g\n', TIME); - [CONT1, CONT2, CONT3, CONT4, CONT5, CONT6] = ... - ini==ANSYS(fid11, CONT1, CONT2, CONT3, CONT4, CONT5, CONT6); + ini = ANSYS(fid11, cont1, cont2, cont3, cont4, cont5, cont6); 'ini=ANSYS()' fclose(fid11); else @@ -510,25 +509,19 @@ end % ------------------------------------------------------------------------- -if RUN == NRUN - % GO TO 70 -else - if OU5 > 0 && fid15 >= 0, fclose(fid15); end - if OU6 > 0 && fid_DIS>= 0, fclose(fid_DIS); end - if OU7 > 0 && fid_POS >= 0, fclose(fid_POS); end - if OU8 > 0 && fid_ENE >= 0, fclose(fid_ENE); end -end - % 70 CONTINUE fprintf('\n'); fprintf(' ****************** THE END ******************* \n'); fprintf('\n'); -% Close remaining open files -if fid19 >= 0, fclose(fid19); end -if fid20 >= 0, fclose(fid20); end -if fid12 >= 0, fclose(fid12); end +% FIX: close every output file that was opened (the original code +% referenced undefined identifiers fid12/fid15/fid19/fid20). +for fidToClose = [fid_CON, fid_RES, fid_DIS, fid_POS, fid_ENE, fid_Lei, fid_EnB] + if fidToClose >= 3 && ~isempty(fopen(fidToClose)) + fclose(fidToClose); + end +end % End of program Console1 diff --git a/src/ldem/prepvar.m b/legacy/prepvar.m similarity index 100% rename from src/ldem/prepvar.m rename to legacy/prepvar.m diff --git a/src/ldem/read_dat0.m b/legacy/read_dat0.m similarity index 100% rename from src/ldem/read_dat0.m rename to legacy/read_dat0.m diff --git a/src/ldem/Energy_balance.m b/sandbox/Energy_balance.m similarity index 100% rename from src/ldem/Energy_balance.m rename to sandbox/Energy_balance.m diff --git a/src/ldem/Teste_combinado.m b/sandbox/Teste_combinado.m similarity index 100% rename from src/ldem/Teste_combinado.m rename to sandbox/Teste_combinado.m diff --git a/src/ldem/Teste_pot.m b/sandbox/Teste_pot.m similarity index 100% rename from src/ldem/Teste_pot.m rename to sandbox/Teste_pot.m diff --git a/src/ldem/gerar_transicao_dupla2.m b/sandbox/gerar_transicao_dupla2.m similarity index 100% rename from src/ldem/gerar_transicao_dupla2.m rename to sandbox/gerar_transicao_dupla2.m diff --git a/src/ldem/main.m b/sandbox/main.m similarity index 100% rename from src/ldem/main.m rename to sandbox/main.m diff --git a/src/ldem/mainDEM.m b/sandbox/mainDEM.m similarity index 100% rename from src/ldem/mainDEM.m rename to sandbox/mainDEM.m diff --git a/setup_path.m b/setup_path.m index 2faa86d..156b84c 100644 --- a/setup_path.m +++ b/setup_path.m @@ -1,5 +1,16 @@ function setup_path() -%SETUP_PATH Adiciona src/ldem ao path do MATLAB. +%SETUP_PATH Add the LDEM code to the MATLAB path. +% +% setup_path() adds the folder that contains the LDEM routines to the +% MATLAB path for the current session. At the moment this is the +% frozen reference implementation in legacy/; the refactored package +% (src/+ldem) will be added here as it replaces it. +% +% Example: +% >> setup_path +% +% See also addpath. + root = fileparts(mfilename('fullpath')); -addpath(fullfile(root, 'src', 'ldem')); +addpath(fullfile(root, 'legacy')); end diff --git a/src/ldem/BARR_ROMP.dat b/src/ldem/BARR_ROMP.dat deleted file mode 100644 index 927363e..0000000 --- a/src/ldem/BARR_ROMP.dat +++ /dev/null @@ -1 +0,0 @@ -0.000000E+00 1.000000E+00 1126960 0 0 diff --git a/src/ldem/Copy_of_COORDSUB.m b/src/ldem/Copy_of_COORDSUB.m deleted file mode 100644 index dd78d7a..0000000 --- a/src/ldem/Copy_of_COORDSUB.m +++ /dev/null @@ -1,50 +0,0 @@ - -function ini=COORDSUB (MI,MF,NI,NF,LLI,LF,ST,MX,NX,X1,Y1,X2,Y2,X3,Y3,C1,C2,C3) -global INT INB U V W U0 V0 W0 BDX BDY BDZ VLX VLY VLZ -global ACX ACY ACZ FRX FRY FRZ FX FY FZ MAS MSS CN ENR -global EDG E1 E2 LI DEQB F YNGB GFRB LCRB EPRB EP SS EM -global EN KR KR1 DSS DM FS CAF DT GFR DEQ LCR TEST EST -global DF DF1 DF2 DMP1 DMP2 TDAF CON M N L M1 N1 L1 MNL -global NNO NNS NNT NBA NBS NBT INCO NCON STEP NSTEP NDAMF -global RUN NRUN LCO TIME TTOT PSN ROH YNG EPR EPMAX EPMIN -global MEAN COEV ENEX ENCN ENEL ENGD ENDP ENIN DEN DERIV -global XB YB ZB UBAR VBAR WBAR REACAOX REACAOY REACAOZ -global STRAIN STRESS SEED -%--------------------------------------------------- -% -% ! -% ! Esta subrotina é chamada pela subrotina coord para fazer a geração -% ! automática de coordenadas nodais. -% ! -% !-------------------------------------------------------------------------- - - - %INTEGER I,J,K,LLI,LF,NI,NF,MI,MF,MX,NX - %INTEGER X1,Y1,X2,Y2,X3,Y3,C1,C2,C3,NO,ST -%!-------------------------------------------------------------------------- - for K=LLI:LF - for J=NI:NF - for I=MI:MF -% - NO=ST+(K-1)*MX*NX+(J-1)*MX+I; -%! - U(1,NO)=(X1*I-Y1/2.0D00)*LCO; - U(2,NO)=U(1,NO); - U(3,NO)=U(2,NO); - V(1,NO)=(X2*J-Y2/2.0D00)*LCO; - V(2,NO)=V(1,NO); - V(3,NO)=V(2,NO); - W(1,NO)=(X3*K-Y3/2.0D00)*LCO; - W(2,NO)=W(1,NO); - W(3,NO)=W(2,NO); -%! - BDX(NO)=C1; - BDY(NO)=C2; - BDZ(NO)=C3; -%! - end - end - end -%! - ini=1; - end diff --git a/src/ldem/Copy_of_main - Copia.m b/src/ldem/Copy_of_main - Copia.m deleted file mode 100644 index d809786..0000000 --- a/src/ldem/Copy_of_main - Copia.m +++ /dev/null @@ -1,16 +0,0 @@ -clear all -clc -global INT INB U V W U0 V0 W0 BDX BDY BDZ VLX VLY VLZ -global ACX ACY ACZ - -% FRX FRY FRZ FX FY FZ MAS MSS CN ENR -% global EDG E1 E2 LI DEQB F YNGB GFRB LCRB EPRB EP SS EM -% global EN KR KR1 DSS DM FS CAF DT GFR DEQ LCR TEST EST -% global DF DF1 DF2 DMP1 DMP2 TDAF CON M N L M1 N1 L1 MNL -% global NNO NNS NNT NBA NBS NBT INCO NCON STEP NSTEP NDAMF -% global RUN NRUN LCO TIME TTOT PSN ROH YNG EPR EPMAX EPMIN -% global MEAN COEV ENEX ENCN ENEL ENGD ENDP ENIN DEN DERIV -% global XB YB ZB UBAR VBAR WBAR REACAOX REACAOY REACAOZ -% global STRAIN STRESS -ini=ini_DEM2() -ACX \ No newline at end of file diff --git a/src/ldem/Copy_of_main.m b/src/ldem/Copy_of_main.m deleted file mode 100644 index d809786..0000000 --- a/src/ldem/Copy_of_main.m +++ /dev/null @@ -1,16 +0,0 @@ -clear all -clc -global INT INB U V W U0 V0 W0 BDX BDY BDZ VLX VLY VLZ -global ACX ACY ACZ - -% FRX FRY FRZ FX FY FZ MAS MSS CN ENR -% global EDG E1 E2 LI DEQB F YNGB GFRB LCRB EPRB EP SS EM -% global EN KR KR1 DSS DM FS CAF DT GFR DEQ LCR TEST EST -% global DF DF1 DF2 DMP1 DMP2 TDAF CON M N L M1 N1 L1 MNL -% global NNO NNS NNT NBA NBS NBT INCO NCON STEP NSTEP NDAMF -% global RUN NRUN LCO TIME TTOT PSN ROH YNG EPR EPMAX EPMIN -% global MEAN COEV ENEX ENCN ENEL ENGD ENDP ENIN DEN DERIV -% global XB YB ZB UBAR VBAR WBAR REACAOX REACAOY REACAOZ -% global STRAIN STRESS -ini=ini_DEM2() -ACX \ No newline at end of file diff --git a/src/ldem/Energia_Barra.TXT b/src/ldem/Energia_Barra.TXT deleted file mode 100644 index e69de29..0000000 diff --git a/src/ldem/LET.CON b/src/ldem/LET.CON deleted file mode 100644 index de3dba8..0000000 --- a/src/ldem/LET.CON +++ /dev/null @@ -1,65 +0,0 @@ - - ********************* DEM ********************* - - Discrete Element Method - - All Rights Reserved - PPGEC / UFRGS - - DATA CONTROL OUTPUT - ******************* - - Simulation =======================> 0 - - Test simulated...................... 102 - Truss modules in X-direction........ 100 - Truss modules in Y-direction........ 40 - Truss modules in Z-direction........ 20 - - Principal nodes number.............. 166961 - Symmetry nodes number............... 166961 - Total nodes number.................. 166961 - Principal bars number............... 1126960 - Symmetry bars number................ 1126960 - Total bars number................... 1126960 - - Control node number................. 1 - Control node number................. 2 - Control node number................. 3 - Control node number................. 4 - Control node number................. 5 - - - Initial damping factor.............. 2.500000E+04 - Final damping factor................ 2.500000E+04 - Time of damping change.............. 1.500000E-02 - Stiffness proportional damping...... 0.000000E+00 - - Truss module length................. 3.000000E-03 - Time increment...................... 2.000000E-07 - Total time of integration........... 3.000000E-02 - - Poissons ratio...................... 2.500000E-01 - Mass density........................ 2.000000E+03 - Total mass.......................... 4.320000E+00 - Youngs modulus...................... 3.200000E+10 - Element normal stiffness............ 1.152000E+05 - Element diagonal stiffness.......... 1.995323E+05 - Specific fracture energy............ 5.000000E+01 - equivalent d ........ 2.800000E-02 - Proportionality mean strain......... 2.312311E-04 - Critical value for Lc............... 1.939000E-02 - Kr value for normal bars............ 6.463333E+00 - Delta coefficient................... 1.125000E+00 - Alfa coefficient.................... 4.000000E-01 - - Maximum value for ep................ 0.000000E+00 - Minimum value for ep................ 9.900000E+99 - - - GENERAL REMARKS - *************** - - Mean ep............................. 2.263162E-04 - Coefficient of variation for ep..... 0.000000E+00 - - diff --git a/src/ldem/LET.DIS b/src/ldem/LET.DIS deleted file mode 100644 index e69de29..0000000 diff --git a/src/ldem/LET.ENE b/src/ldem/LET.ENE deleted file mode 100644 index 37cd833..0000000 --- a/src/ldem/LET.ENE +++ /dev/null @@ -1 +0,0 @@ - 2.000000000000e-07 0.000000000000e+00 0.000000000000e+00 0.000000000000e+00 \ No newline at end of file diff --git a/src/ldem/LET.POS b/src/ldem/LET.POS deleted file mode 100644 index 7507abe..0000000 --- a/src/ldem/LET.POS +++ /dev/null @@ -1 +0,0 @@ - 2.000000000000e-07 0.000000000000e+00 0.000000000000e+00 diff --git a/src/ldem/Lei_Barra.TXT b/src/ldem/Lei_Barra.TXT deleted file mode 100644 index c78a85d..0000000 --- a/src/ldem/Lei_Barra.TXT +++ /dev/null @@ -1,2 +0,0 @@ - 2.000000000000E-07 0.000000000000E+00 0.000000000000E+00 1.438338298716E-03 0.000000000000E+00 2.225381586462E-04 - 4.000000000000E-07 0.000000000000E+00 0.000000000000E+00 1.438338298716E-03 0.000000000000E+00 2.225381586462E-04 diff --git a/src/ldem/SIM01.DAT b/src/ldem/SIM01.DAT deleted file mode 100644 index 9dcf4ae..0000000 --- a/src/ldem/SIM01.DAT +++ /dev/null @@ -1 +0,0 @@ - 2.000000000000e-07 -3.999995648852e+01 0.000000000000e+00 0.000000000000e+00 diff --git a/src/ldem/Teste_combinado - Copia.m b/src/ldem/Teste_combinado - Copia.m deleted file mode 100644 index c32b46f..0000000 --- a/src/ldem/Teste_combinado - Copia.m +++ /dev/null @@ -1,239 +0,0 @@ -clear all -clc - -% Configurações - n_total = 5000; % Número total de elementos - velocidade1 = 5; % Velocidade de transição entrada potencial(1-10) - velocidade2 = 5; % Velocidade de transição saida potencial (1-10) - expoente = 1; % Expoente da lei de potência - - dados =gerar_transicao_dupla2(n_total, velocidade1, velocidade2, expoente); - %dados = gerar_transicao_uniforme_potencial(n_total, velocidade, expoente); - %unif = rand(n_total /2,1); - %dados=[dados';unif]'; n_total=size(dados,2); - % Criar janela com subplots para visualização - figure('Position', [100, 100, 1200, 800]); - - % Subplot 1: Histograma completo - %subplot(2, 3, [1, 4]); - subplot(2,1,1); - histogram(dados, 100, 'Normalization', 'pdf', 'FaceColor', [0.3, 0.6, 0.9]); - xlabel('Value'); - ylabel('Density'); - title(sprintf('Uniform + Power law distribution + Uniform (N =%d)', n_total)); - grid on; - - % Subplot 4: Evolução temporal dos valores - %subplot(2, 3, [5, 6]); - subplot(2,1,2); - plot(1:n_total, dados', '.', 'MarkerSize', 2); - xlabel('N'); - ylabel('Value'); - title('Evolução Temporal dos Valores'); - grid on; - - % Adicionar linha de tendência móvel - window_size = 500; - media_movel = movmean(dados', window_size); - hold on; - plot(1:n_total, media_movel, 'r-', 'LineWidth', 2); - legend('Data', sprintf('Moving average (W=%d)', window_size), 'Location', 'best'); - hold off; - - % Estatísticas descritivas - fprintf('\n--- Estatísticas ---\n'); - fprintf('Média: %.4f\n', mean(dados)); - fprintf('Mediana: %.4f\n', median(dados)); - fprintf('Desvio padrão: %.4f\n', std(dados)); - fprintf('Mínimo: %.4f\n', min(dados)); - fprintf('Máximo: %.4f\n', max(dados)); - - % Análise da transição - % fprintf('\n--- Análise da Transição ---\n'); - - % % Dividir em 5 segmentos - % segmentos = 5; - % for k = 1:segmentos - % idx_inicio = round((k-1)*n_total/segmentos) + 1; - % idx_fim = round(k*n_total/segmentos); - % segmento = dados(idx_inicio:idx_fim); - % - % % Calcular média e mediana - % fprintf('Segmento %d (%.0f%%-%.0f%%): Média=%.4f, Mediana=%.4f, Coef.Variação=%.4f\n', ... - % k, (k-1)*100/segmentos, k*100/segmentos, ... - % mean(segmento), median(segmento), std(segmento)/mean(segmento)); - % end -%end -%%%%%%%%%%%%%%%% NATURAL TIME -Q=dados'; -% 1. Configuração Inicial e Medida de Energia -% O artigo sugere que a medida adequada é Qk = A^1.5, onde A é a amplitude [4, 5]. -%Q = Amp.^1.5; -Lin = length(Q); - -% Definição de PI_c (ruído uniforme) - calculada uma única vez -fi = 0:0.025:0.5; -ww = 2 * pi * fi; -pi_c = 18./(5*ww.^2) - 6*cos(ww)./(5*ww.^2) - 12*sin(ww)./(5*ww.^3); -pi_c(1) = 1; % Limite quando w -> 0 - -% Pré-alocação de variáveis para velocidade -kapa1 = zeros(Lin, 1); -Snt = zeros(Lin, 1); -Srev = zeros(Lin, 1); -D = zeros(Lin, 1); - -% Loop principal (Evolução dos eventos) -% Nota: Calculamos os parâmetros para cada janela de tamanho k -for k = 1:Lin - % 1. Recorte e Normalização da janela atual - Q_k = Q(1:k); - An = sum(Q_k); - pk = Q_k / An; % Energias normalizadas P_k [4] - - % 2. Vetor de Tempo Natural chi_k [4] - xk = (1:k)' / k; - - % 3. Cálculo Vetorizado de Kappa1 (Variância) - k1 = sum(pk .* (xk.^2)); - k2 = sum(pk .* xk); - kapa1(k) = k1 - k2^2; - - % 4. Cálculo Vetorizado das Entropias (S e S_inv) [1, 3] - % Usando logaritmo natural 'log' conforme recomendado [2] - Snt(k) = sum(pk .* xk .* log(xk)) - k2 * log(k2); - - % Para S_inv, invertemos a ordem das energias P_k -> P_{N-k+1} - pk_rev = flipud(pk); - k2_rev = sum(pk_rev .* xk); - Srev(k) = sum(pk_rev .* xk .* log(xk)) - k2_rev * log(k2_rev); - - % 5. Cálculo Vetorizado de PI(phi) e Distância D - % Criamos uma matriz para evitar o loop 'b' - % xk: (k x 1), ww: (1 x n_fi) -> exp_arg: (k x n_fi) - exp_arg = complex(0, 1) * (xk * ww); - Pi_phi = abs(pk' * exp(exp_arg)).^2; % Produto matricial calcula todos os fi de uma vez - - D(k) = mean(abs(Pi_phi - pi_c)); - - % Convertional time - %ct(k)=tpico(k); - % Natural time - nt(k)=k; - - % Feedback de progresso (opcional) - % if mod(k, 1000) == 0, disp(['Progresso: ', num26(k/Lin*100), '%']); end -end -% -figure() -% nt=ct; -plot(nt,kapa1,'r') -hold on -plot(nt,Snt,'b') -plot(nt,Srev,'m') -plot(nt,D,'g') -grid on - -plot([0 k],[0.07 0.07],'r--') -plot([0 k],[0.096 0.096],'b--') -plot([0 k],[0.02 0.02],'g--') -% ylim([0 0.3]) -legend('\kappa_1','S','S_r_e_v','D','0.07','0.096','0.02') -xlabel('N','FontName','Times New Roman','FontSize',18,'Rotation',0) -ylabel('\kappa_1, S, S_r_e_v, D','FontName','Times New Roman','FontSize',18,'Rotation',90) - -%% ENTROPIAS SHENNON AND HKL - -%Q=dados'; -Lin = length(Q); - -% 2. Pré-alocação de variáveis para desempenho -Hs = zeros(Lin, 1); -Hkl = zeros(Lin, 1); - -% 3. Cálculo Evolutivo (Abordagem de Janela Crescente) -% Conforme o artigo, a janela de detecção inicia no primeiro evento e -% cresce a cada novo hit para capturar o comportamento histórico [3, 6]. -for K = 2:Lin - % Energias da janela atual (do evento 1 até K) - current_Q = Q(1:K); - An = sum(current_Q); % Soma total da área/energia da janela [6, 7] - - % Vetor de probabilidade pK (distribuição de massa de ocorrência) [2] - % pK(k) é o k-ésimo elemento do vetor de probabilidade [2] - pk = current_Q / An; - - % --- Entropia de Shannon (Hs) --- - % Calculada para o hit K usando o logaritmo natural (ln) conforme orientação [2, 5] - % Hs(K) = -sum( pK * ln(pK) ) [2, 6] - Hs(K) = -sum(pk .* log(pk + eps)); - - % --- Entropia de Kullback-Leibler (Hkl) --- - % Expressa a probabilidade do evento atual condicionada pelo anterior [8] - % HKL(K) = -sum_{k=2}^{K} pK(k) * ln( pK(k) / pK(k-1) ) [6] - pk_atual = pk(2:end); - pk_anterior = pk(1:end-1); - Hkl(K) = -sum(pk_atual .* log((pk_atual + eps) ./ (pk_anterior + eps))); -end - -% 4. Valores Cumulativos (Sigma Hs e Sigma Hkl) -% O artigo também avalia a sensibilidade dos valores acumulados ao dano [1, 8]. -sum_Hs = cumsum(Hs); -sum_Hkl = cumsum(Hkl); - -% 5. Visualização dos Resultados -figure; -%subplot(2,1,1); -plot(Hs); -ylabel('\itH_s','FontName','Times New Roman','FontSize',18,'Rotation',90) -%set(gca, 'XTickLabel', []); % Remove os rótulos do eixo x grid on; -grid on -yyaxis right -ax = gca; -ax.YColor = 'k'; % define a cor do eixo Y direito como preto -hold on -%subplot(2,1,2); -plot(Hkl); grid on; -ylabel('\itH_{KL}','FontName','Times New Roman','FontSize',18,'Rotation',90) -legend('\itH_s','itH_{KL}') - -%% TSALLIS ENTROPY -win=50; %initial data size -k=1; -Amp=dados'; -tpico=1:1:size(dados,2) ; tpico=tpico'; -for jj=win+1:1:size(dados,2) -%Interval=[tpico(jj-win) tpico(jj)]; % SLIDING WINDOWN -Interval=[1 jj]; % -Mi=0.05; % division on the Amplitude distribution -[Datavalue, A_fit, lmbda_fit, q_fit, resultados_fit,p2]=EA_Calc_q(Amp,tpico,Interval,Mi,'NHist'); -A(k)=A_fit; -lmbda(k)=lmbda_fit; -q(k)=q_fit; -R(k)=resultados_fit.R_squared; -TPico(k)=jj; -p22(k)=p2; -k=k+1; -end -%% -figure; -plot(TPico,q,'r') -ylabel('q','FontName','Times New Roman','FontSize',20,'Rotation',90) -yyaxis right -hold on -plot(TPico,1./lmbda,'b') -legend('q','lambda') -xlabel('N','FontName','Times New Roman','FontSize',20,'Rotation',0) -ylabel('lambda','FontName','Times New Roman','FontSize',20,'Rotation',90) - -% -figure; -scatter(1./lmbda, q, 8, TPico, 'o'); % 50 = tamanho dos marcadores -colorbar; -xlabel('1/\it\lambda', 'FontSize', 12); -ylabel('\itq', 'FontSize', 12); -grid on -box on -ylabel(colorbar, 'Time [s]'); - - diff --git a/src/ldem/Teste_pot - Copia.m b/src/ldem/Teste_pot - Copia.m deleted file mode 100644 index 9344930..0000000 --- a/src/ldem/Teste_pot - Copia.m +++ /dev/null @@ -1,239 +0,0 @@ -clear all -clc - -% Configurações - n_total = 5000; % Número total de elementos - velocidade1 = 10; % Velocidade de transição entrada potencial(1-10) - velocidade2 = 10; % Velocidade de transição saida potencial (1-10) - expoente = 1; % Expoente da lei de potência - - dados =gerar_transicao_dupla2(n_total, velocidade1, velocidade2, expoente); - %dados = gerar_transicao_uniforme_potencial(n_total, velocidade, expoente); - %unif = rand(n_total /2,1); - %dados=[dados';unif]'; n_total=size(dados,2); - % Criar janela com subplots para visualização - figure('Position', [100, 100, 1200, 800]); - - % Subplot 1: Histograma completo - %subplot(2, 3, [1, 4]); - subplot(2,1,1); - histogram(dados, 100, 'Normalization', 'pdf', 'FaceColor', [0.3, 0.6, 0.9]); - xlabel('Value'); - ylabel('Density'); - title(sprintf('Uniform + Power law distribution + Uniform (N =%d)', n_total)); - grid on; - - % Subplot 4: Evolução temporal dos valores - %subplot(2, 3, [5, 6]); - subplot(2,1,2); - plot(1:n_total, dados', '.', 'MarkerSize', 2); - xlabel('N'); - ylabel('Value'); - title('Evolução Temporal dos Valores'); - grid on; - - % Adicionar linha de tendência móvel - window_size = 500; - media_movel = movmean(dados', window_size); - hold on; - plot(1:n_total, media_movel, 'r-', 'LineWidth', 2); - legend('Data', sprintf('Moving average (W=%d)', window_size), 'Location', 'best'); - hold off; - - % Estatísticas descritivas - fprintf('\n--- Estatísticas ---\n'); - fprintf('Média: %.4f\n', mean(dados)); - fprintf('Mediana: %.4f\n', median(dados)); - fprintf('Desvio padrão: %.4f\n', std(dados)); - fprintf('Mínimo: %.4f\n', min(dados)); - fprintf('Máximo: %.4f\n', max(dados)); - - % Análise da transição - % fprintf('\n--- Análise da Transição ---\n'); - - % % Dividir em 5 segmentos - % segmentos = 5; - % for k = 1:segmentos - % idx_inicio = round((k-1)*n_total/segmentos) + 1; - % idx_fim = round(k*n_total/segmentos); - % segmento = dados(idx_inicio:idx_fim); - % - % % Calcular média e mediana - % fprintf('Segmento %d (%.0f%%-%.0f%%): Média=%.4f, Mediana=%.4f, Coef.Variação=%.4f\n', ... - % k, (k-1)*100/segmentos, k*100/segmentos, ... - % mean(segmento), median(segmento), std(segmento)/mean(segmento)); - % end -%end -%%%%%%%%%%%%%%%% NATURAL TIME -Q=dados'; -% 1. Configuração Inicial e Medida de Energia -% O artigo sugere que a medida adequada é Qk = A^1.5, onde A é a amplitude [4, 5]. -%Q = Amp.^1.5; -Lin = length(Q); - -% Definição de PI_c (ruído uniforme) - calculada uma única vez -fi = 0:0.025:0.5; -ww = 2 * pi * fi; -pi_c = 18./(5*ww.^2) - 6*cos(ww)./(5*ww.^2) - 12*sin(ww)./(5*ww.^3); -pi_c(1) = 1; % Limite quando w -> 0 - -% Pré-alocação de variáveis para velocidade -kapa1 = zeros(Lin, 1); -Snt = zeros(Lin, 1); -Srev = zeros(Lin, 1); -D = zeros(Lin, 1); - -% Loop principal (Evolução dos eventos) -% Nota: Calculamos os parâmetros para cada janela de tamanho k -for k = 1:Lin - % 1. Recorte e Normalização da janela atual - Q_k = Q(1:k); - An = sum(Q_k); - pk = Q_k / An; % Energias normalizadas P_k [4] - - % 2. Vetor de Tempo Natural chi_k [4] - xk = (1:k)' / k; - - % 3. Cálculo Vetorizado de Kappa1 (Variância) - k1 = sum(pk .* (xk.^2)); - k2 = sum(pk .* xk); - kapa1(k) = k1 - k2^2; - - % 4. Cálculo Vetorizado das Entropias (S e S_inv) [1, 3] - % Usando logaritmo natural 'log' conforme recomendado [2] - Snt(k) = sum(pk .* xk .* log(xk)) - k2 * log(k2); - - % Para S_inv, invertemos a ordem das energias P_k -> P_{N-k+1} - pk_rev = flipud(pk); - k2_rev = sum(pk_rev .* xk); - Srev(k) = sum(pk_rev .* xk .* log(xk)) - k2_rev * log(k2_rev); - - % 5. Cálculo Vetorizado de PI(phi) e Distância D - % Criamos uma matriz para evitar o loop 'b' - % xk: (k x 1), ww: (1 x n_fi) -> exp_arg: (k x n_fi) - exp_arg = complex(0, 1) * (xk * ww); - Pi_phi = abs(pk' * exp(exp_arg)).^2; % Produto matricial calcula todos os fi de uma vez - - D(k) = mean(abs(Pi_phi - pi_c)); - - % Convertional time - %ct(k)=tpico(k); - % Natural time - nt(k)=k; - - % Feedback de progresso (opcional) - % if mod(k, 1000) == 0, disp(['Progresso: ', num26(k/Lin*100), '%']); end -end -% -figure() -% nt=ct; -plot(nt,kapa1,'r') -hold on -plot(nt,Snt,'b') -plot(nt,Srev,'m') -plot(nt,D,'g') -grid on - -plot([0 k],[0.07 0.07],'r--') -plot([0 k],[0.096 0.096],'b--') -plot([0 k],[0.02 0.02],'g--') -% ylim([0 0.3]) -legend('\kappa_1','S','S_r_e_v','D','0.07','0.096','0.02') -xlabel('N','FontName','Times New Roman','FontSize',18,'Rotation',0) -ylabel('\kappa_1, S, S_r_e_v, D','FontName','Times New Roman','FontSize',18,'Rotation',90) - -%% ENTROPIAS SHENNON AND HKL - -%Q=dados'; -Lin = length(Q); - -% 2. Pré-alocação de variáveis para desempenho -Hs = zeros(Lin, 1); -Hkl = zeros(Lin, 1); - -% 3. Cálculo Evolutivo (Abordagem de Janela Crescente) -% Conforme o artigo, a janela de detecção inicia no primeiro evento e -% cresce a cada novo hit para capturar o comportamento histórico [3, 6]. -for K = 2:Lin - % Energias da janela atual (do evento 1 até K) - current_Q = Q(1:K); - An = sum(current_Q); % Soma total da área/energia da janela [6, 7] - - % Vetor de probabilidade pK (distribuição de massa de ocorrência) [2] - % pK(k) é o k-ésimo elemento do vetor de probabilidade [2] - pk = current_Q / An; - - % --- Entropia de Shannon (Hs) --- - % Calculada para o hit K usando o logaritmo natural (ln) conforme orientação [2, 5] - % Hs(K) = -sum( pK * ln(pK) ) [2, 6] - Hs(K) = -sum(pk .* log(pk + eps)); - - % --- Entropia de Kullback-Leibler (Hkl) --- - % Expressa a probabilidade do evento atual condicionada pelo anterior [8] - % HKL(K) = -sum_{k=2}^{K} pK(k) * ln( pK(k) / pK(k-1) ) [6] - pk_atual = pk(2:end); - pk_anterior = pk(1:end-1); - Hkl(K) = -sum(pk_atual .* log((pk_atual + eps) ./ (pk_anterior + eps))); -end - -% 4. Valores Cumulativos (Sigma Hs e Sigma Hkl) -% O artigo também avalia a sensibilidade dos valores acumulados ao dano [1, 8]. -sum_Hs = cumsum(Hs); -sum_Hkl = cumsum(Hkl); - -% 5. Visualização dos Resultados -figure; -%subplot(2,1,1); -plot(Hs); -ylabel('\itH_s','FontName','Times New Roman','FontSize',18,'Rotation',90) -%set(gca, 'XTickLabel', []); % Remove os rótulos do eixo x grid on; -grid on -yyaxis right -ax = gca; -ax.YColor = 'k'; % define a cor do eixo Y direito como preto -hold on -%subplot(2,1,2); -plot(Hkl); grid on; -ylabel('\itH_{KL}','FontName','Times New Roman','FontSize',18,'Rotation',90) -legend('\itH_s','itH_{KL}') - -%% TSALLIS ENTROPY -win=50; %initial data size -k=1; -Amp=dados'; -tpico=1:1:size(dados,2) ; tpico=tpico'; -for jj=win+1:1:size(dados,2) -%Interval=[tpico(jj-win) tpico(jj)]; % SLIDING WINDOWN -Interval=[1 jj]; % -Mi=0.05; % division on the Amplitude distribution -[Datavalue, A_fit, lmbda_fit, q_fit, resultados_fit,p2]=EA_Calc_q(Amp,tpico,Interval,Mi,'NHist'); -A(k)=A_fit; -lmbda(k)=lmbda_fit; -q(k)=q_fit; -R(k)=resultados_fit.R_squared; -TPico(k)=jj; -p22(k)=p2; -k=k+1; -end -%% -figure; -plot(TPico,q,'r') -ylabel('q','FontName','Times New Roman','FontSize',20,'Rotation',90) -yyaxis right -hold on -plot(TPico,1./lmbda,'b') -legend('q','lambda') -xlabel('N','FontName','Times New Roman','FontSize',20,'Rotation',0) -ylabel('lambda','FontName','Times New Roman','FontSize',20,'Rotation',90) - -% -figure; -scatter(1./lmbda, q, 8, TPico, 'o'); % 50 = tamanho dos marcadores -colorbar; -xlabel('1/\it\lambda', 'FontSize', 12); -ylabel('\itq', 'FontSize', 12); -grid on -box on -ylabel(colorbar, 'Time [s]'); - - diff --git a/src/ldem/gerar_transicao_dupla2 - Copia.m b/src/ldem/gerar_transicao_dupla2 - Copia.m deleted file mode 100644 index a794295..0000000 --- a/src/ldem/gerar_transicao_dupla2 - Copia.m +++ /dev/null @@ -1,74 +0,0 @@ -function dados = gerar_transicao_dupla(n_total, velocidade1, velocidade2, expoente) - % GERAR_TRANSICAO_DUPLA - Gera números com transição uniforme → potencial → uniforme - % - % Entradas: - % n_total - número total de elementos - % velocidade1 - velocidade da primeira transição (uniforme → potencial) - % valores típicos: 1 a 10 (maior = mais abrupta) - % velocidade2 - velocidade da segunda transição (potencial → uniforme) - % expoente - expoente da distribuição potencial (alfa > 0) - % - % Saída: - % dados - vetor (1 x n_total) com os números gerados - - % Validações - if nargin < 4 - error('São necessários 4 argumentos: n_total, velocidade1, velocidade2, expoente'); - end - if velocidade1 <= 0 || velocidade2 <= 0 - error('As velocidades devem ser positivas'); - end - if expoente <= 0 - error('Expoente deve ser positivo'); - end - - % Pontos de transição fixos (frações normalizadas de 0 a 1) - p1 = 0.01; % fim da primeira zona uniforme - p2 = 0.01; % fim da transição uniforme → potencial - p3 = 1.0; % fim da zona potencial pura - p4 = 1.0; % fim da transição potencial → uniforme - - % Pré‑calcular a distribuição potencial (intervalo [0.01, 1]) - x_min = 0.01; - x_max = 1.0; - if abs(expoente - 1) < 1e-6 - % Expoente = 1 → distribuição logarítmica - log_ratio = log(x_max / x_min); - gerar_potencial = @() x_min * exp(rand() * log_ratio); - else - c1 = x_min^(1 - expoente); - c2 = x_max^(1 - expoente); - gerar_potencial = @() (rand() * (c2 - c1) + c1)^(1/(1 - expoente)); - end - - % Gerar cada elemento - dados = zeros(1, n_total); - for i = 1:n_total - t = (i - 1) / (n_total - 1); % posição normalizada (0 → 1) - - % Determinar o peso da componente potencial (0 = uniforme, 1 = potencial) - if t <= p1 - peso_pot = 0; - elseif t <= p2 - % Transição uniforme → potencial (sigmóide crescente) - t_norm = (t - p1) / (p2 - p1); % mapeia [p1, p2] → [0, 1] - peso_pot = 1 / (1 + exp(-velocidade1 * (t_norm - 0.5) * 8)); - elseif t <= p3 - % Zona potencial pura - peso_pot = 1; - elseif t <= p4 - % Transição potencial → uniforme (sigmóide decrescente) - t_norm = (t - p3) / (p4 - p3); % mapeia [p3, p4] → [0, 1] - peso_pot = 1 / (1 + exp(velocidade2 * (t_norm - 0.5) * 8)); - else - peso_pot = 0; - end - - % Amostrar conforme o peso - if rand() < peso_pot - dados(i) = gerar_potencial(); - else - dados(i) = rand(); % uniforme em [0,1] - end - end -end \ No newline at end of file diff --git a/src/ldem/ini_DEM3 - Copia.m b/src/ldem/ini_DEM3 - Copia.m deleted file mode 100644 index 70c1188..0000000 --- a/src/ldem/ini_DEM3 - Copia.m +++ /dev/null @@ -1,218 +0,0 @@ -function ini=ini_DEM3() -%H1 this function put initial values in the global variables -% -global INT INB U V W U0 V0 W0 BDX BDY BDZ VLX VLY VLZ -global ACX ACY ACZ FRX FRY FRZ FX FY FZ MAS MSS CN ENR -global EDG E1 E2 LI DEQB F YNGB GFRB LCRB EPRB EP SS EM -global EN KR KR1 DSS DM FS CAF DT GFR DEQ LCR TEST EST -global DF DF1 DF2 DMP1 DMP2 TDAF CON M N L M1 N1 L1 MNL -global NNO NNS NNT NBA NBS NBT INCO NCON STEP NSTEP NDAMF -global RUN NRUN LCO TIME TTOT PSN ROH YNG EPR EPMAX EPMIN -global MEAN COEV ENEX ENCN ENEL ENGD ENDP ENIN DEN DERIV -global XB YB ZB UBAR VBAR WBAR REACAOX REACAOY REACAOZ -global STRAIN STRESS - -% Variables setting -INT=10000; % total nodes -IBT=100000;% total elements -U(3,INT)=0.0; % nodal displacement, U=x,V=y,W=z, i-1,i,i+1 time_ step -V(3,INT)=0.0; -W(3,INT)=0.0; -U0(INT)=0.0;% nodal displacements in the initial configuration -V0(INT)=0.0;% -W0(INT)=0.0;% -BDX(INT)=0;% boundary conditions 1=fix, 0=fix -BDY(INT)=0; -BDZ(INT)=0; -VLX(INT)=0.0;% nodal velocities -VLY(INT)=0.0; -VLZ(INT)=0.0; -ACX(INT)=0.0;%nodal acelerations -ACY(INT)=0.0; -ACZ(INT)=0.0; -FRX(INT)=0.0; %Nodal forces in each step -FRY(INT)=0.0; -FRZ(INT)=0.0; -FX(INT)=0.0; %acumulated nodal forces -FY(INT)=0.0; -FZ(INT)=0.0; -MAS(INT)=0.0; % nodal masses with corrections taken into account -MSS(INT)=0.0; -%,ROMP,ROMP_OLD -%! - -CN(2,INB)=0; %conectivity i, and j of each element -ENR(INB)=0.0;% normal specific stifness ENR(i)=YNGB(i)*ALPHA*(LI(i))^2 -EDG(INB)=0.0;% diagonal stifness bar EDG(B)=2.0D00*DELTA*(4.0D00/3.0D00)*ENR(B)/DSQRT(3.0D00) -E1(INB)=0.0;% Normal stifness in compression taking into account if the bar is in the border or is a internal bar -E2(INB)=0.0;% Normal stifness in tension -LI(INB)=0.0; % cubic module length -% -DEQB(INB)=0.0;%equivalent distance for each element -F(INB)=0.0;%element force -YNGB(INB)=0.0; %Young modules in each bar -GFRB(INB)=0.0; %toughness in each bar -LCRB(INB)=0.0; %LCR=DEQ*2.0D00*CAF/ALFA -EPRB(INB)=0.0;% EPRB(i)=DSQRT(GFRB(i)/(YNGB(i)*DEQB(i))) -EP(INB)=0.0;%the same of EPRB ??? %%%%%%%% -SS(INB)=0.0; %the strain in the bar the last step -EM(INB)=0.0;% te same that SS ?????? %%%%%%%% -EN(2,INB)=0.0; %elastic energy in each bar computed in each step, 1 undamage, 2 damage. this information it isnt used -KR(INB)=0.0; %er(i)= kr(i)* ep(i) -KR1(INB)=0.0;%%%% it is not used -DSS(INB)=0.0; %the derivative of the strain STRRT in each step -DM(INB)=true; % damage index if DM=true bar is undamage -FS(INB)=true; %failure index if DM= true bar is unfail, with partial damage or not. -%DM1(INB)=true; -%FS1(INB)=true; -%TR(INB)=0.0; -%ansysColor=0 -% -CAF=0.1385; %failure area of each normal bars An(i)=CAF*LI(i) -%CUT=0.0; -DT=0.0; % time increment -GFR=0.0; %tougnhess , mean value -DEQ=0.0;% critical distance mean value -LCR=0.0; % critical length -%SEED=0.0; -TEST=0; %number of test to stablish characteristic of each specific problem -EST=0; % establish differetn type of damping |EstEST=0 ==> Amortecimento padrão (C=DF*M) -%! EST=1 ==> EST=0 + um amortecimento introduzido -%! na equação constitutiva com CON -%! EST=2 ==> EST=0, mas o coefic. de amortecimento -%! DF é multiplicado pelo índice de dano -DF1=0.0; %input damping value -DF2=0.0; -DMP1=0.0; %%% % DMP1=(1.0D00-DF11*DT/2.0D00)%%%%must be global??? -DMP2=0.0; %%%%must be global??? -TDAF=0.0; %time in which the damping 1 change to damping 2 -CON=0.0; % values that introduce damping proportional to the stifness -%Label=0; -M=0; %number of modules Mx, N(y), L(z) , -N=0; -L=0; -M1=0; -N1=0; -L1=0; -%MNL=0;% M*N*L -NNO=0;% NNO=MNL+M1*N1*L1 %%%%%%%%%% -NNS=0;% %%%%%%%%% -NNT=0;% total number of nodes -NBA=0;%partial values %%%%%%% -NBS=0;%partial values %%%%%%%% -NBT=0; % total number of elements -INCO(10)=0;%the specific number of node indicated as input %%%%%%% -NCON(10)=0;%Number of nodes that could be identified -% OU2=0; % the number of output for print the results %%%%%% -% OU3=0; -% OU4=0; -% OU5=0; -% OU6=0; -% OU7=0; -% OU8=0; -% OU9=0; -% PR3=0; % numer os step to skip when th result are save -% PR4=0; -% PR5=0; -% PR67=0; -% PR8=0; -% PR9=0; -STEP=0;% current number of step -NSTEP=0;% tital number of steps -NDAMF=0;% step number correlated with TDAF -RUN=0; %current number of simulation -NRUN=0; % total number of simulations -LCO=0.0; %lenth of the cubic module -TIME=0.0; % current time -TTOT=0.0; % total time of the simulation -PSN=0.0;% poisson coeficient -ROH=0.0; % density -YNG=0.0; %mean young modulus -EPR=0.0; % -EPMAX=0.0; % maximum value of the critical strain -EPMIN=0.0; %minimum value of the critical strain -MEAN=0.0 ; %mean value of critical strain -COEV=0.0 ; % variation coeficient of critical strain -ENEX=0.0 ;% External energy -ENCN=0.0;% kinetic energy -ENEL=0.0;% Elastic energy -ENGD=0.0;% damage energy -ENDP=0.0;% damping energy -ENIN=0.0;% internal energy -DEN=0.0;% ENEX-ENIN -DERIV=0.0;% derivative of the ENGD -XB(INB)=0.0; %baricentric coordinates fo the elements -YB(INB)=0.0; -ZB(INB)=0.0; -UBAR(INB)=0.0;%displacement in the baricentric of each bar -VBAR(INB)=0.0; -WBAR(INB)=0.0; - -REACAOX=0.0;% summation of the reaction in x diretion -REACAOY=0.0; -REACAOZ=0.0; -STRAIN=0.0; -STRESS=0.0; -%X -%Y -%Z -% ,aaa -% ,ReaV -% ,vmax -% ,tt1 -% ,vmax2 -% ,tt2 -% VF1 -% ,VF2 -% ,VF3 -% ,vmax3 -% ,tt3 -% ,VF4 -% ,vmax4 -% ,vmax5 -% ,tt5 -% ,VF6 -% ,vmax6 -% ,tt6 -% ,dmax -% ,dmax2 - - % NK1 - % ,NK2 - % ,NK3 -% D2,PI,K1,K2,K3,DK1,DK2,DK3 -% PHI1,PHI2,PHI3,PHI4,AN - % CVROH,CVYNG,CVGFR,CORRCAF - %TENNORMZ,TENTANGX - % RKX,RKZ,VF -%FOR1 -%STR1 -%FOR2 -%STR2 -%FOR3 -%STR3 -%FOR4 -%STR4 -%ROHN - % BTA,GMA,IBT - % LCORX,LCORY,LCORZ,NPTX,NPTY,NPTZ,NPTOTAL - - % ,IPT - % MPJ,NPJ,LPJ,MPI,NPI,LPI - % IPT1,IPT2,IPT3,IPT4,IPT5,IPT6,IPT7,IPT8,IPT9 - % MP2,NP2,LP2,PHI - % PMI,PNI,PLI,PHIV - %xc,yc,vfarea,vfareal,time1 - %neib,iicont - % krs,epp,constB - % krsc,E2C,EMC - %g51589,gg51589,g89116,gg89116,ggg89116,giv89116 - % DESELX,DESELXMEDIO,SOMADESX,DESELY,DESELYMEDIO, & - %SOMADESY - -ini=1 -return - - - - diff --git a/src/ldem/initialization_DEM - Copia.m b/src/ldem/initialization_DEM - Copia.m deleted file mode 100644 index 372d17f..0000000 --- a/src/ldem/initialization_DEM - Copia.m +++ /dev/null @@ -1,15 +0,0 @@ - -function ini= ini_DEM - -global INT U V W - - - - % Variables setting - INT=10000; % total nodes - - U(3,INT)=0.0; % nodal displacement, U=x,V=y,W=z, i-1,i,i+1 time_ step - V(3,INT)=0.0; - W(3,INT)=0.0; - ini=1; - end diff --git a/src/ldem/initialization_DEM.m b/src/ldem/initialization_DEM.m deleted file mode 100644 index 372d17f..0000000 --- a/src/ldem/initialization_DEM.m +++ /dev/null @@ -1,15 +0,0 @@ - -function ini= ini_DEM - -global INT U V W - - - - % Variables setting - INT=10000; % total nodes - - U(3,INT)=0.0; % nodal displacement, U=x,V=y,W=z, i-1,i,i+1 time_ step - V(3,INT)=0.0; - W(3,INT)=0.0; - ini=1; - end diff --git a/src/ldem/main - Copia.m b/src/ldem/main - Copia.m deleted file mode 100644 index dc5f223..0000000 --- a/src/ldem/main - Copia.m +++ /dev/null @@ -1,15 +0,0 @@ -clear all -clc -global INT INB U V W U0 V0 W0 BDX BDY BDZ VLX VLY VLZ -global ACX ACY ACZ FRX FRY FRZ FX FY FZ MAS MSS CN ENR -global EDG E1 E2 LI DEQB F YNGB GFRB LCRB EPRB EP SS EM -global EN KR KR1 DSS DM FS CAF DT GFR DEQ LCR TEST EST -global DF DF1 DF2 DMP1 DMP2 TDAF CON M N L M1 N1 L1 MNL -global NNO NNS NNT NBA NBS NBT INCO NCON STEP NSTEP NDAMF -global RUN NRUN LCO TIME TTOT PSN ROH YNG EPR EPMAX EPMIN -global MEAN COEV ENEX ENCN ENEL ENGD ENDP ENIN DEN DERIV -global XB YB ZB UBAR VBAR WBAR REACAOX REACAOY REACAOZ -global STRAIN STRESS - -ini=ini_DEM3() -CAF \ No newline at end of file diff --git a/tests/TestLdemPath.m b/tests/TestLdemPath.m index fd7abf4..8f18b7e 100644 --- a/tests/TestLdemPath.m +++ b/tests/TestLdemPath.m @@ -1,5 +1,5 @@ classdef TestLdemPath < matlab.unittest.TestCase - %TESTLDEMPATH Verifica que as rotinas principais estão no path e documentadas. + %TESTLDEMPATH Check that the main routines are on the path and documented. properties (TestParameter) routine = {'ini_DEM3','CALOAD','CALRES','BOUND','CONECTI', ... 'INTCO1','RMEC','ENERG2','read_dat0','prepvar'} @@ -8,7 +8,7 @@ function addSource(testCase) root = fileparts(fileparts(mfilename('fullpath'))); testCase.applyFixture(matlab.unittest.fixtures.PathFixture( ... - fullfile(root, 'src', 'ldem'))); + fullfile(root, 'legacy'))); end end methods (Test) diff --git a/tests/fixtures/bending102.mat b/tests/fixtures/bending102.mat new file mode 100644 index 0000000000000000000000000000000000000000..5ac2fc056f8bea13fd8be738672ff5f3071bf741 GIT binary patch literal 558497 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≪0foT4y_rm&8Tru!chQc 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

st(e6 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[l{Vp%` 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

3O_^8P9%~A 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

l4^ry42jSf|fU)>n9IaE3IV{>Opy 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 addpath tests +% >> run_tests +% >> run_tests(IncludeSlow=true) +% +% See also matlab.unittest.TestSuite, generateReference. + +arguments + options.IncludeSlow (1,1) logical = false +end + +testsFolder = fileparts(mfilename('fullpath')); +addpath(fullfile(fileparts(testsFolder), 'legacy')); + +suite = matlab.unittest.TestSuite.fromFolder(testsFolder, ... + 'IncludingSubfolders', true); +if ~options.IncludeSlow + suite = suite.selectIf(~matlab.unittest.selectors.HasTag('Slow')); +end + results = run(suite); disp(table(results)); assertSuccess(results); diff --git a/tests/tools/generateReference.m b/tests/tools/generateReference.m new file mode 100644 index 0000000..2a32d2b --- /dev/null +++ b/tests/tools/generateReference.m @@ -0,0 +1,48 @@ +function generateReference(caseNames) +%GENERATEREFERENCE Create the golden-master fixtures from the legacy code. +% +% generateReference() runs every case of referenceCases with the frozen +% legacy driver and stores the result in tests/fixtures/.mat. +% generateReference("bending102") regenerates only the named case(s). +% +% Each fixture contains the variables: +% caseDef The case definition (see referenceCases). +% state Final legacy state, trimmed to the real mesh size. +% files Text of every output file written by the legacy code. +% +% Run this ONLY when the legacy code is intentionally changed; the +% fixtures are the reference that all refactored code is compared with. +% +% See also referenceCases, runLegacyCase, TestGoldenMaster. + +arguments + caseNames (1,:) string = string.empty +end + +cases = referenceCases(); +if ~isempty(caseNames) + cases = cases(ismember({cases.name}, caseNames)); + if isempty(cases) + error('ldem:tools:unknownCase', 'No reference case matches the given names.'); + end +end + +fixtureDir = fullfile(fileparts(fileparts(mfilename('fullpath'))), 'fixtures'); +if ~isfolder(fixtureDir) + mkdir(fixtureDir); +end + +for k = 1:numel(cases) + caseDef = cases(k); + fprintf('Running legacy case "%s" ... ', caseDef.name); + workDir = tempname; + mkdir(workDir); + cleaner = onCleanup(@() rmdir(workDir, 's')); + timer = tic; + [state, files] = runLegacyCase(caseDef, workDir); %#ok + save(fullfile(fixtureDir, caseDef.name + ".mat"), 'caseDef', 'state', 'files'); + fprintf('done in %.1f s (%d nodes, %d bars, %d damaged bars).\n', ... + toc(timer), state.NNT, state.NBT, nnz(~state.DM)); + clear cleaner +end +end diff --git a/tests/tools/referenceCases.m b/tests/tools/referenceCases.m new file mode 100644 index 0000000..aa46ccd --- /dev/null +++ b/tests/tools/referenceCases.m @@ -0,0 +1,55 @@ +function cases = referenceCases() +%REFERENCECASES Definitions of the small simulations used as golden masters. +% +% cases = referenceCases() returns a struct array. Each element describes +% one LDEM run that is small enough to execute in seconds but exercises a +% different part of the code: +% +% tension101_elastic TEST 101, elastic response only (no damage) +% tension101_damage TEST 101, low fracture energy -> softening + rupture +% bending102 TEST 102, beam with supports and reaction output +% +% Fields of every case: +% name Unique identifier (also the fixture file name). +% test Test number written to DATA0.DAT (101 or 102). +% modules [M N L] number of nodes along x, y, z. +% nSteps Number of time steps to integrate. +% fractureEnergy GFR, specific fracture energy [N/m]. +% ansysEvery OU3: write an ANSYS file every n steps. +% everyN OU6..OU9: write the other outputs every n steps. +% +% The remaining material and numerical parameters are shared (see below). +% +% See also generateReference, runLegacyCase, writeDataFile. + +shared = struct( ... + 'seed', 123, ... + 'moduleLength', 0.003, ... % [m] + 'damping1', 25000, ... % DF1 [1/s] + 'damping2', 25000, ... % DF2 [1/s] + 'dampingSwitchTime', 0.015, ... % TDAF [s] + 'con', 0, ... + 'dt', 2e-7, ... % [s] + 'controlNodes', [1 2], ... + 'poisson', 0.25, ... + 'density', 2000, ... % [kg/m^3] + 'youngModulus', 32e9, ... % [Pa] + 'criticalDistance', 0.028); % DEQ [m] + +specs = { ... + % name test modules nSteps GFR OU3 everyN + 'tension101_elastic', 101, [6 3 3], 200, 50.0, 100, 10; ... + 'tension101_damage', 101, [6 3 3], 800, 0.5, 400, 20; ... + 'bending102', 102, [70 4 3], 300, 0.5, 150, 10}; + +cases = repmat(shared, size(specs, 1), 1); +for k = 1:size(specs, 1) + cases(k).name = specs{k, 1}; + cases(k).test = specs{k, 2}; + cases(k).modules = specs{k, 3}; + cases(k).nSteps = specs{k, 4}; + cases(k).fractureEnergy = specs{k, 5}; + cases(k).ansysEvery = specs{k, 6}; + cases(k).everyN = specs{k, 7}; +end +end diff --git a/tests/tools/runLegacyCase.m b/tests/tools/runLegacyCase.m new file mode 100644 index 0000000..ac744d8 --- /dev/null +++ b/tests/tools/runLegacyCase.m @@ -0,0 +1,97 @@ +function [state, files] = runLegacyCase(c, workDir) +%RUNLEGACYCASE Run the frozen legacy driver for one case in a child MATLAB. +% +% [state, files] = runLegacyCase(c, workDir) executes legacy/main1.m with +% the input described by case c, inside the (empty) folder workDir. +% +% The legacy driver starts with "clear all" and keeps everything in global +% variables, so it cannot be called from inside a running test. It is +% therefore executed in a separate "matlab -batch" process whose final +% workspace is saved and read back. +% +% Inputs: +% c Case struct, see referenceCases. +% workDir Existing folder where the simulation runs and writes output. +% +% Outputs: +% state Struct with the final legacy state, trimmed to the real mesh +% size (the legacy code preallocates INT=168000 nodes and +% INB=2300000 bars). Node arrays are 1-by-NNT, bar arrays +% 1-by-NBT, CN is 1-by-2*NBT. Scalars are kept unchanged. +% files Struct with the text of every output file, keyed by a valid +% field name (dots replaced by underscores). +% +% See also referenceCases, generateReference. + +root = fileparts(fileparts(fileparts(mfilename('fullpath')))); +legacyDir = fullfile(root, 'legacy'); +exampleDir = fullfile(root, 'examples', 'beam_102'); + +writeDataFile(fullfile(workDir, 'DATA0.DAT'), c); +copyfile(fullfile(exampleDir, 'LET.AN1'), workDir); +copyfile(fullfile(exampleDir, 'arquivo_3lc_rnao_cv05'), workDir); + +batchCmd = sprintf('addpath(''%s''); main1; save(''final_state.mat'');', legacyDir); +matlabExe = fullfile(matlabroot, 'bin', 'matlab'); +logFile = fullfile(workDir, 'legacy_run.log'); +cmd = sprintf('"%s" -batch "%s" > "%s" 2>&1', matlabExe, batchCmd, logFile); + +oldFolder = cd(workDir); +folderRestore = onCleanup(@() cd(oldFolder)); +status = system(cmd); +if status ~= 0 || ~isfile(fullfile(workDir, 'final_state.mat')) + error('ldem:tools:legacyRunFailed', ... + 'Legacy run of case "%s" failed (exit %d). See %s.', c.name, status, logFile); +end + +raw = load(fullfile(workDir, 'final_state.mat')); +state = trimLegacyState(raw); +files = collectTextFiles(workDir); +end + +function state = trimLegacyState(raw) +%TRIMLEGACYSTATE Cut the preallocated legacy arrays down to the real mesh. +nNodes = raw.NNT; +nBars = raw.NBT; +keep = {'U','V','W','U0','V0','W0','BDX','BDY','BDZ','VLX','VLY','VLZ', ... + 'ACX','ACY','ACZ','FRX','FRY','FRZ','FX','FY','FZ','MAS','MSS', ... + 'CN','XB','YB','ZB','UBAR','VBAR','WBAR', ... + 'LI','E1','E2','EP','EM','KR','SS','DSS','F','DM','FS','DEQB', ... + 'EDG','ENR','YNGB','GFRB','LCRB','EPRB','EN', ... + 'TIME','STEP','NSTEP','NNT','NBT','M','N','L','LCO','DT', ... + 'ENEX','ENCN','ENEL','ENGD','ENDP','ENIN','DEN','DERIV', ... + 'REACAOX','REACAOY','REACAOZ','EPMAX','EPMIN','MEAN','COEV'}; +state = struct(); +for k = 1:numel(keep) + name = keep{k}; + if ~isfield(raw, name) + continue + end + value = raw.(name); + if isnumeric(value) || islogical(value) + nCols = size(value, 2); + if nCols == raw.INT + value = value(:, 1:nNodes); + elseif nCols == raw.INB + value = value(:, 1:nBars); + elseif nCols == 2 * raw.INB + value = value(:, 1:2*nBars); + end + end + state.(name) = value; +end +end + +function files = collectTextFiles(workDir) +%COLLECTTEXTFILES Read every generated output file into a struct of strings. +files = struct(); +listing = dir(workDir); +skip = {'DATA0.DAT','LET.AN1','arquivo_3lc_rnao_cv05','final_state.mat','legacy_run.log'}; +for k = 1:numel(listing) + if listing(k).isdir || any(strcmp(listing(k).name, skip)) + continue + end + field = matlab.lang.makeValidName(listing(k).name); + files.(field) = fileread(fullfile(workDir, listing(k).name)); +end +end diff --git a/tests/tools/writeDataFile.m b/tests/tools/writeDataFile.m new file mode 100644 index 0000000..d31a4ee --- /dev/null +++ b/tests/tools/writeDataFile.m @@ -0,0 +1,52 @@ +function writeDataFile(path, c) +%WRITEDATAFILE Write a legacy DATA0.DAT input file from a case definition. +% +% writeDataFile(path, c) creates the input file read by the legacy routine +% READ_DAT0. Only the first token of each line is read by the legacy code; +% the quoted label after it is a comment for humans. +% +% Inputs: +% path Full path of the file to create. +% c Case struct, see referenceCases. +% +% See also referenceCases, runLegacyCase. + +fid = fopen(path, 'w'); +if fid == -1 + error('ldem:tools:cannotOpenFile', 'Cannot create "%s".', path); +end +closer = onCleanup(@() fclose(fid)); + +nControl = numel(c.controlNodes); +totalTime = c.nSteps * c.dt; + +fprintf(fid, '%d '' TEST ''\n', c.test); +fprintf(fid, '%d '' SEED ''\n', c.seed); +fprintf(fid, '%.6g '' LCO ''\n', c.moduleLength); +fprintf(fid, '%d '' M ''\n', c.modules(1)); +fprintf(fid, '%d '' N ''\n', c.modules(2)); +fprintf(fid, '%d '' L ''\n', c.modules(3)); +fprintf(fid, '%.6g '' DF1 ''\n', c.damping1); +fprintf(fid, '%.6g '' DF2 ''\n', c.damping2); +fprintf(fid, '%.6g '' TDAF ''\n', c.dampingSwitchTime); +fprintf(fid, '%.6g '' CON ''\n', c.con); +fprintf(fid, '%.6g '' DT ''\n', c.dt); +fprintf(fid, '%.15g '' TTOT ''\n', totalTime); +fprintf(fid, '%d '' INCO ''\n', nControl); +for i = 1:nControl + fprintf(fid, '%d '' Ncon%d ''\n', c.controlNodes(i), i); +end +fprintf(fid, '9999999 '' OU2 ''\n'); +fprintf(fid, '%d '' OU3 ''\n', c.ansysEvery); +fprintf(fid, '0 '' OU4 ''\n'); +fprintf(fid, '0 '' OU5 ''\n'); +fprintf(fid, '%d '' OU6 ''\n', c.everyN); +fprintf(fid, '%d '' OU7 ''\n', c.everyN); +fprintf(fid, '%d '' OU8 ''\n', c.everyN); +fprintf(fid, '%d '' OU9 ''\n', c.everyN); +fprintf(fid, '%.6g '' PSN ''\n', c.poisson); +fprintf(fid, '%.6g '' ROH ''\n', c.density); +fprintf(fid, '%.6g '' YNG ''\n', c.youngModulus); +fprintf(fid, '%.6g '' GFR ''\n', c.fractureEnergy); +fprintf(fid, '%.6g '' DEQ ''\n', c.criticalDistance); +end From 0c86b9c0389a4bfdef1e2ec07fac47e4cdb9d53e Mon Sep 17 00:00:00 2001 From: Boris Rojo Tanzi <71112604+borisrojotanzi@users.noreply.github.com> Date: Thu, 5 Nov 2026 14:59:09 -0300 Subject: [PATCH 02/13] refactor: add ldem package with validated parameters, input and mesh --- CHANGELOG.md | 9 + docs/source/api/index.rst | 71 +++--- docs/source/conf.py | 2 +- setup_path.m | 9 +- src/+ldem/+io/readInputFile.m | 123 +++++++++++ src/+ldem/+mesh/buildBars.m | 67 ++++++ src/+ldem/+mesh/buildMesh.m | 53 +++++ src/+ldem/+mesh/buildNodes.m | 45 ++++ src/+ldem/+mesh/computeBarGeometry.m | 51 +++++ src/+ldem/+mesh/computeNodalMasses.m | 49 +++++ src/+ldem/+mesh/perturbNodes.m | 59 +++++ src/+ldem/+scenarios/FourPointBending.m | 54 +++++ src/+ldem/+scenarios/Scenario.m | 34 +++ src/+ldem/+scenarios/UniaxialTension.m | 41 ++++ src/+ldem/+scenarios/fromTestId.m | 40 ++++ src/+ldem/+solver/checkStability.m | 41 ++++ src/+ldem/Parameters.m | 264 +++++++++++++++++++++++ tests/LdemTestCase.m | 25 +++ tests/regression/TestMeshAgainstLegacy.m | 86 ++++++++ tests/run_tests.m | 1 + tests/tools/generateReference.m | 2 +- tests/unit/TestMesh.m | 131 +++++++++++ tests/unit/TestParameters.m | 108 ++++++++++ tests/unit/TestPerturbNodes.m | 65 ++++++ tests/unit/TestReadInputFile.m | 115 ++++++++++ tests/unit/TestScenarios.m | 69 ++++++ 26 files changed, 1582 insertions(+), 32 deletions(-) create mode 100644 src/+ldem/+io/readInputFile.m create mode 100644 src/+ldem/+mesh/buildBars.m create mode 100644 src/+ldem/+mesh/buildMesh.m create mode 100644 src/+ldem/+mesh/buildNodes.m create mode 100644 src/+ldem/+mesh/computeBarGeometry.m create mode 100644 src/+ldem/+mesh/computeNodalMasses.m create mode 100644 src/+ldem/+mesh/perturbNodes.m create mode 100644 src/+ldem/+scenarios/FourPointBending.m create mode 100644 src/+ldem/+scenarios/Scenario.m create mode 100644 src/+ldem/+scenarios/UniaxialTension.m create mode 100644 src/+ldem/+scenarios/fromTestId.m create mode 100644 src/+ldem/+solver/checkStability.m create mode 100644 src/+ldem/Parameters.m create mode 100644 tests/LdemTestCase.m create mode 100644 tests/regression/TestMeshAgainstLegacy.m create mode 100644 tests/unit/TestMesh.m create mode 100644 tests/unit/TestParameters.m create mode 100644 tests/unit/TestPerturbNodes.m create mode 100644 tests/unit/TestReadInputFile.m create mode 100644 tests/unit/TestScenarios.m diff --git a/CHANGELOG.md b/CHANGELOG.md index 159822b..00245ad 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -12,11 +12,20 @@ - `legacy/KNOWN_ISSUES.md`: bugs found in the original code and how the refactored code will resolve each one. +- New package `src/+ldem` (refactoring in progress), validated against the + legacy fixtures: `ldem.Parameters` (validated input), `ldem.io.readInputFile`, + `ldem.mesh.*` (nodes, bars, masses, geometry, optional perturbation), + `ldem.scenarios.*` (test cases 101 and 102) and `ldem.solver.checkStability`. +- Unit tests (`tests/unit`) and a regression test that compares the new mesh + with the legacy one (`tests/regression/TestMeshAgainstLegacy`). + ### Changed - Original routines moved from `src/ldem` to `legacy/` (frozen reference). - Experimental scripts moved to `sandbox/`; example inputs to `examples/beam_102/`. - `.gitignore` now targets MATLAB and LDEM output files. - `run_tests` searches subfolders and skips tests tagged `Slow` by default. +- `setup_path` adds both `src/` and `legacy/`; the generated API documentation + now covers the `ldem` package only. ### Fixed - `legacy/main1.m`: removed scratch lines; fixed the end-of-run file closing diff --git a/docs/source/api/index.rst b/docs/source/api/index.rst index ca38a37..56c4d6c 100644 --- a/docs/source/api/index.rst +++ b/docs/source/api/index.rst @@ -1,41 +1,60 @@ API reference / Referencia de la API ==================================== -Generated automatically from the comments of the ``.m`` files in -``legacy/`` (comments are written in Portuguese) / +Generated automatically from the comments of the ``.m`` files / Generada automáticamente desde los comentarios de los ``.m``. -.. note:: +Refactored package ``ldem`` / Paquete refactorizado ``ldem`` +------------------------------------------------------------ - Only routines that already have a docstring (comment block right below - the ``function`` line) are listed. To add another routine, document it - and append it to this list / Para añadir otra rutina, documentarla y - agregarla a esta lista. +New code in ``src/+ldem`` (English comments). It replaces the routines of +``legacy/`` step by step; see ``legacy/KNOWN_ISSUES.md``. -.. mat:module:: legacy +.. mat:module:: ldem -Initialisation / Inicialización -------------------------------- +Parameters / Parámetros +~~~~~~~~~~~~~~~~~~~~~~~ -.. mat:autofunction:: legacy.ini_DEM3 -.. mat:autofunction:: legacy.read_dat0 -.. mat:autofunction:: legacy.prepvar +.. mat:autoclass:: ldem.Parameters + :members: -Geometry and connectivity / Geometría y conectividad ----------------------------------------------------- +.. mat:module:: ldem.io -.. mat:autofunction:: legacy.CONECTI -.. mat:autofunction:: legacy.INTCO1 +.. mat:autofunction:: ldem.io.readInputFile -Mechanics, loads and boundary conditions / Mecánica, cargas y contorno ----------------------------------------------------------------------- +Mesh / Malla +~~~~~~~~~~~~ -.. mat:autofunction:: legacy.RMEC -.. mat:autofunction:: legacy.BOUND -.. mat:autofunction:: legacy.CALOAD +.. mat:module:: ldem.mesh -Results and energy / Resultados y energía ------------------------------------------ +.. mat:autofunction:: ldem.mesh.buildMesh +.. mat:autofunction:: ldem.mesh.buildNodes +.. mat:autofunction:: ldem.mesh.perturbNodes +.. mat:autofunction:: ldem.mesh.buildBars +.. mat:autofunction:: ldem.mesh.computeNodalMasses +.. mat:autofunction:: ldem.mesh.computeBarGeometry -.. mat:autofunction:: legacy.CALRES -.. mat:autofunction:: legacy.ENERG2 +Scenarios / Escenarios de ensayo +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +.. mat:module:: ldem.scenarios + +.. mat:autoclass:: ldem.scenarios.Scenario +.. mat:autoclass:: ldem.scenarios.UniaxialTension +.. mat:autoclass:: ldem.scenarios.FourPointBending +.. mat:autofunction:: ldem.scenarios.fromTestId + +Solver +~~~~~~ + +.. mat:module:: ldem.solver + +.. mat:autofunction:: ldem.solver.checkStability + +Legacy routines / Rutinas originales +------------------------------------ + +The original routines live in ``legacy/`` as a frozen reference and are not +part of the generated API. Their known problems are listed in +``legacy/KNOWN_ISSUES.md`` / Las rutinas originales están en ``legacy/`` como +referencia congelada y no forman parte de la API generada. diff --git a/docs/source/conf.py b/docs/source/conf.py index eb4209c..87be76f 100644 --- a/docs/source/conf.py +++ b/docs/source/conf.py @@ -13,7 +13,7 @@ ] # --- MATLAB API (generated from the .m comments) --------------------------- -matlab_src_dir = os.path.abspath(os.path.join(os.path.dirname(__file__), "..", "..")) +matlab_src_dir = os.path.abspath(os.path.join(os.path.dirname(__file__), "..", "..", "src")) matlab_short_links = True matlab_auto_link = "basic" primary_domain = "mat" diff --git a/setup_path.m b/setup_path.m index 156b84c..9bc04b5 100644 --- a/setup_path.m +++ b/setup_path.m @@ -1,16 +1,17 @@ function setup_path() %SETUP_PATH Add the LDEM code to the MATLAB path. % -% setup_path() adds the folder that contains the LDEM routines to the -% MATLAB path for the current session. At the moment this is the -% frozen reference implementation in legacy/; the refactored package -% (src/+ldem) will be added here as it replaces it. +% setup_path() adds to the MATLAB path, for the current session: +% src/ the refactored package, used as ldem. +% legacy/ the frozen original routines (reference implementation) % % Example: % >> setup_path +% >> params = ldem.Parameters(); % % See also addpath. root = fileparts(mfilename('fullpath')); +addpath(fullfile(root, 'src')); addpath(fullfile(root, 'legacy')); end diff --git a/src/+ldem/+io/readInputFile.m b/src/+ldem/+io/readInputFile.m new file mode 100644 index 0000000..d2cc436 --- /dev/null +++ b/src/+ldem/+io/readInputFile.m @@ -0,0 +1,123 @@ +function values = readInputFile(path) +%READINPUTFILE Read a legacy input file (DATA0.DAT format). +% +% values = ldem.io.readInputFile(path) parses the file and returns a +% struct whose field names are properties of ldem.Parameters. The struct +% can be passed to the constructor with namedargs2cell. +% +% File format. Only the FIRST WORD of each line is read; whatever follows +% (usually a quoted label) is a comment. The values appear in this order: +% +% TEST, SEED, LCO, M, N, L, +% DF1, DF2, TDAF, CON, DT, TTOT, +% INCO, NCON(1) ... NCON(INCO), +% OU2, OU3, OU4, OU5, OU6, OU7, OU8, OU9, +% PSN, ROH, YNG, GFR, DEQ +% +% Output codes OU2..OU9 of the legacy code are mapped to +% Parameters.output as follows: +% +% OU3 -> snapshotEvery OU6 -> controlNodesEvery +% OU8 -> energyEvery OU9 -> trackedBarEvery (0 or 1) +% +% OU2 (echo of the input), OU4, OU5 and OU7 only opened files in the +% legacy driver and have no meaning in the new code; they are ignored. +% +% Input: +% path Path of the input file. +% +% Output: +% values Struct with the fields testId, seed, moduleLength, nModules, +% dampingInitial, dampingFinal, dampingSwitchTime, +% constitutiveDamping, dt, totalTime, controlNodes, output, +% poissonRatio, density, youngModulus, fractureEnergy and +% criticalDistance. +% +% Errors: +% ldem:io:fileNotFound The file does not exist. +% ldem:io:malformedInput The file has missing or non-numeric values. +% +% Example: +% values = ldem.io.readInputFile("examples/beam_102/DATA0.DAT"); +% +% Legacy: READ_DAT0. +% +% See also ldem.Parameters.fromFile. + +arguments + path (1,1) string +end + +if ~isfile(path) + error('ldem:io:fileNotFound', 'Input file "%s" does not exist.', path); +end + +tokens = firstWordOfEachLine(path); +nFixedBefore = 13; % TEST .. INCO +if numel(tokens) < nFixedBefore + error('ldem:io:malformedInput', ... + '"%s" has %d values but at least %d are required.', ... + path, numel(tokens), nFixedBefore); +end + +nControl = str2double(tokens(13)); +if ~isfinite(nControl) || nControl < 1 || nControl ~= fix(nControl) + error('ldem:io:malformedInput', ... + 'Value 13 (INCO, number of control nodes) of "%s" must be a positive integer.', path); +end + +expected = 26 + nControl; +if numel(tokens) < expected + error('ldem:io:malformedInput', ... + ['"%s" has %d values but %d are required for INCO = %d ' ... + '(13 + INCO + 13).'], path, numel(tokens), expected, nControl); +end + +numbers = str2double(tokens(1:expected)); +bad = find(isnan(numbers), 1); +if ~isempty(bad) + error('ldem:io:malformedInput', ... + 'Value %d of "%s" ("%s") is not a number.', bad, path, tokens(bad)); +end + +at = @(k) numbers(k); +afterControl = 13 + nControl; % index of the last control node + +values = struct(); +values.testId = at(1); +values.seed = at(2); +values.moduleLength = at(3); +values.nModules = [at(4) at(5) at(6)]; +values.dampingInitial = at(7); +values.dampingFinal = at(8); +values.dampingSwitchTime = at(9); +values.constitutiveDamping = at(10); +values.dt = at(11); +values.totalTime = at(12); +values.controlNodes = reshape(numbers(14:afterControl), 1, []); + +ou = numbers(afterControl + (1:8)); % OU2 ... OU9 +values.output = struct( ... + 'snapshotEvery', ou(2), ... % OU3 + 'controlNodesEvery', ou(5), ... % OU6 + 'energyEvery', ou(7), ... % OU8 + 'trackedBarEvery', double(ou(8) > 0)); % OU9 + +values.poissonRatio = at(afterControl + 9); +values.density = at(afterControl + 10); +values.youngModulus = at(afterControl + 11); +values.fractureEnergy = at(afterControl + 12); +values.criticalDistance = at(afterControl + 13); +end + +function tokens = firstWordOfEachLine(path) +%FIRSTWORDOFEACHLINE First whitespace-delimited word of every non-empty line. +lines = splitlines(string(fileread(path))); +tokens = strings(0, 1); +for k = 1:numel(lines) + word = strtok(strtrim(lines(k))); + if strlength(word) > 0 + tokens(end+1, 1) = word; %#ok + end +end +end diff --git a/src/+ldem/+mesh/buildBars.m b/src/+ldem/+mesh/buildBars.m new file mode 100644 index 0000000..c9c2e75 --- /dev/null +++ b/src/+ldem/+mesh/buildBars.m @@ -0,0 +1,67 @@ +function bars = buildBars(nModules) +%BUILDBARS Connectivity of the bars of the lattice. +% +% bars = ldem.mesh.buildBars(nModules) returns, for every bar, the numbers +% of its two end nodes. Node numbering is the one of ldem.mesh.buildNodes. +% +% Each cubic module has 12 edges, shared with its neighbours, plus 8 +% diagonals that join the centre node to the 8 corners. The bars are +% listed in this order: +% +% 1. Grid edges parallel to x, then to y, then to z. +% 2. Centre-to-centre bars parallel to x, then to y, then to z. +% 3. Diagonals: 8 consecutive bars per module (centre -> each corner), +% modules in node order. +% +% Input: +% nModules [M N L], integers >= 2. +% +% Output: +% bars nBars-by-2 matrix of node numbers [startNode endNode]. +% +% Example: +% bars = ldem.mesh.buildBars([2 2 2]); +% size(bars, 1) % 12 edges + 8 diagonals = 20 bars +% +% Legacy: CONECTI, EXTCO1, INTCO1, DIACO1. +% +% See also ldem.mesh.buildNodes, ldem.mesh.computeBarGeometry. + +arguments + nModules (1,3) double {mustBeInteger, mustBeGreaterThanOrEqual(nModules, 2)} +end + +M = nModules(1); N = nModules(2); L = nModules(3); +M1 = M - 1; N1 = N - 1; L1 = L - 1; +nGrid = M * N * L; + +% Grid-edge bars: node (i,j,k) joined to its neighbour along one axis. +gridNode = @(i, j, k) (k - 1) * M * N + (j - 1) * M + i; +edgesX = edgeBars(gridNode, M1, N, L, 1); +edgesY = edgeBars(gridNode, M, N1, L, M); +edgesZ = edgeBars(gridNode, M, N, L1, M * N); + +% Centre-to-centre bars: centre (i,j,k) joined to its neighbour. +centreNode = @(i, j, k) nGrid + (k - 1) * M1 * N1 + (j - 1) * M1 + i; +centresX = edgeBars(centreNode, M - 2, N1, L1, 1); +centresY = edgeBars(centreNode, M1, N - 2, L1, M1); +centresZ = edgeBars(centreNode, M1, N1, L - 2, M1 * N1); + +% Diagonals: centre of every module to its 8 corners. +[i, j, k] = ndgrid(1:M1, 1:N1, 1:L1); +corner0 = gridNode(i(:), j(:), k(:)); % lowest corner of each module +centre = centreNode(i(:), j(:), k(:)); +offsets = [0, 1, M, M + 1, M * N, M * N + 1, M * N + M, M * N + M + 1]; +corners = (corner0 + offsets).'; % 8-by-nModulesTotal +starts = repmat(centre.', 8, 1); +diagonals = [starts(:), corners(:)]; + +bars = [edgesX; edgesY; edgesZ; centresX; centresY; centresZ; diagonals]; +end + +function bars = edgeBars(nodeNumber, nx, ny, nz, stride) +%EDGEBARS Bars [n, n+stride] for every node n of an nx-by-ny-by-nz block. +[i, j, k] = ndgrid(1:nx, 1:ny, 1:nz); +first = nodeNumber(i(:), j(:), k(:)); +bars = [first, first + stride]; +end diff --git a/src/+ldem/+mesh/buildMesh.m b/src/+ldem/+mesh/buildMesh.m new file mode 100644 index 0000000..87ed000 --- /dev/null +++ b/src/+ldem/+mesh/buildMesh.m @@ -0,0 +1,53 @@ +function mesh = buildMesh(params, scenario) +%BUILDMESH Assemble the complete lattice model from the parameters. +% +% mesh = ldem.mesh.buildMesh(params) builds nodes, supports, masses, bars +% and bar geometry, using the scenario that matches params.testId. +% +% mesh = ldem.mesh.buildMesh(params, scenario) uses the given scenario +% object (a subclass of ldem.scenarios.Scenario). +% +% Inputs: +% params ldem.Parameters. +% scenario (optional) ldem.scenarios.Scenario. +% +% Output: +% mesh Struct with the fields +% nodes0 nNodes-by-3 initial coordinates [m] +% nGridNodes number of grid nodes (they come first, then the centres) +% fixed nNodes-by-3 logical, true where the motion is fixed +% mass nNodes-by-1 lumped masses [kg] +% bars nBars-by-2 end-node numbers +% barLength nBars-by-1 initial lengths [m] +% barCentres nBars-by-3 midpoints [m] +% +% Example: +% params = ldem.Parameters(testId=101, nModules=[6 3 3]); +% mesh = ldem.mesh.buildMesh(params); +% fprintf("%d nodes, %d bars\n", size(mesh.nodes0, 1), size(mesh.bars, 1)); +% +% Legacy: the assembly stage of the main program (COORD, IMPERF, BOUND, +% NODMASS, CONECTI, CALAUX). +% +% See also ldem.mesh.buildNodes, ldem.mesh.buildBars, ldem.Parameters. + +arguments + params (1,1) ldem.Parameters + scenario (1,1) ldem.scenarios.Scenario = ldem.scenarios.fromTestId(params.testId) +end + +nodes = ldem.mesh.buildNodes(params.nModules, params.moduleLength); +if params.meshPerturbation.enabled + nodes = ldem.mesh.perturbNodes(nodes, params.nModules, params.moduleLength, ... + params.seed, params.meshPerturbation.cv); +end + +mesh = struct(); +mesh.nodes0 = nodes; +mesh.nGridNodes = prod(params.nModules); +mesh.fixed = scenario.fixedDofs(nodes, params); +mesh.mass = ldem.mesh.computeNodalMasses(params.nModules, ... + params.moduleLength, params.density); +mesh.bars = ldem.mesh.buildBars(params.nModules); +[mesh.barLength, mesh.barCentres] = ldem.mesh.computeBarGeometry(nodes, mesh.bars); +end diff --git a/src/+ldem/+mesh/buildNodes.m b/src/+ldem/+mesh/buildNodes.m new file mode 100644 index 0000000..6cb0545 --- /dev/null +++ b/src/+ldem/+mesh/buildNodes.m @@ -0,0 +1,45 @@ +function nodes = buildNodes(nModules, moduleLength) +%BUILDNODES Coordinates of the nodes of the regular lattice. +% +% nodes = ldem.mesh.buildNodes(nModules, moduleLength) returns the +% initial coordinates of all nodes of a prism of (M-1)*(N-1)*(L-1) cubic +% modules, where nModules = [M N L] is the number of nodes along x, y, z. +% +% The lattice has two kinds of nodes, numbered in this order: +% 1. Grid nodes, M*N*L of them, at the corners of the modules. Node +% number = (k-1)*M*N + (j-1)*M + i, so x varies fastest. +% 2. Centre nodes, (M-1)*(N-1)*(L-1) of them, one in the middle of each +% module. Numbered after the grid nodes, also with x fastest. +% +% Inputs: +% nModules [M N L], integers >= 2. +% moduleLength Edge length of a module [m]. +% +% Output: +% nodes nNodes-by-3 matrix [x y z] in metres. +% +% Example: +% nodes = ldem.mesh.buildNodes([3 3 3], 0.01); +% size(nodes) % 27 + 8 = 35 nodes +% +% Legacy: COORD, COORDSUB. +% +% See also ldem.mesh.buildBars, ldem.mesh.buildMesh. + +arguments + nModules (1,3) double {mustBeInteger, mustBeGreaterThanOrEqual(nModules, 2)} + moduleLength (1,1) double {mustBePositive, mustBeFinite} +end + +M = nModules(1); N = nModules(2); L = nModules(3); + +% Grid nodes: coordinates are (index - 1) * moduleLength. +[i, j, k] = ndgrid(1:M, 1:N, 1:L); +gridNodes = [i(:) - 1, j(:) - 1, k(:) - 1] * moduleLength; + +% Centre nodes: halfway between grid nodes, (index - 0.5) * moduleLength. +[i, j, k] = ndgrid(1:M-1, 1:N-1, 1:L-1); +centreNodes = [i(:) - 0.5, j(:) - 0.5, k(:) - 0.5] * moduleLength; + +nodes = [gridNodes; centreNodes]; +end diff --git a/src/+ldem/+mesh/computeBarGeometry.m b/src/+ldem/+mesh/computeBarGeometry.m new file mode 100644 index 0000000..013875d --- /dev/null +++ b/src/+ldem/+mesh/computeBarGeometry.m @@ -0,0 +1,51 @@ +function [barLength, barCentres] = computeBarGeometry(nodes, bars) +%COMPUTEBARGEOMETRY Length and midpoint of every bar. +% +% [barLength, barCentres] = ldem.mesh.computeBarGeometry(nodes, bars) +% returns the initial length [m] and the coordinates of the midpoint of +% each bar. +% +% Inputs: +% nodes nNodes-by-3 coordinates. +% bars nBars-by-2 node numbers, from ldem.mesh.buildBars. +% +% Outputs: +% barLength nBars-by-1 vector of lengths [m]. +% barCentres nBars-by-3 matrix of midpoints [x y z]. +% +% Errors: +% ldem:mesh:zeroLengthBar A bar has zero length (coincident nodes). +% +% Example: +% nodes = ldem.mesh.buildNodes([2 2 2], 1); +% bars = ldem.mesh.buildBars([2 2 2]); +% [len, mid] = ldem.mesh.computeBarGeometry(nodes, bars); +% +% Legacy: CALAUX. +% +% See also ldem.mesh.buildBars. + +arguments + nodes (:,3) double + bars (:,2) double {mustBeInteger, mustBePositive} +end + +if max(bars, [], 'all') > size(nodes, 1) + error('ldem:mesh:badConnectivity', ... + 'bars refers to node %d but there are only %d nodes.', ... + max(bars, [], 'all'), size(nodes, 1)); +end + +first = nodes(bars(:, 1), :); +second = nodes(bars(:, 2), :); +delta = second - first; + +barLength = sqrt(delta(:, 1).^2 + delta(:, 2).^2 + delta(:, 3).^2); +barCentres = (second + first) / 2.0; + +if any(barLength == 0) + error('ldem:mesh:zeroLengthBar', ... + '%d bar(s) have zero length (first one: bar %d).', ... + nnz(barLength == 0), find(barLength == 0, 1)); +end +end diff --git a/src/+ldem/+mesh/computeNodalMasses.m b/src/+ldem/+mesh/computeNodalMasses.m new file mode 100644 index 0000000..d31831c --- /dev/null +++ b/src/+ldem/+mesh/computeNodalMasses.m @@ -0,0 +1,49 @@ +function mass = computeNodalMasses(nModules, moduleLength, density) +%COMPUTENODALMASSES Lumped mass of every node. +% +% mass = ldem.mesh.computeNodalMasses(nModules, moduleLength, density) +% returns the mass [kg] associated with each node. +% +% Every module has a volume moduleLength^3 and contains one centre node +% and shares its 8 corners. A full-size mass is density*moduleLength^3/2 +% (half of the module volume per node type). Grid nodes on the surface of +% the prism have less material around them, so their mass is divided by 2 +% for each face they lie on: 1/2 on a face, 1/4 on an edge, 1/8 at a +% corner of the prism. Centre nodes always have the full mass. +% +% Inputs: +% nModules [M N L], integers >= 2. +% moduleLength Module edge length [m]. +% density Mass density [kg/m^3]. +% +% Output: +% mass nNodes-by-1 vector, in the node order of ldem.mesh.buildNodes. +% +% Example: +% m = ldem.mesh.computeNodalMasses([3 3 3], 0.01, 2000); +% sum(m) % total mass, close to density * volume +% +% Legacy: NODMASS. +% +% See also ldem.mesh.buildNodes. + +arguments + nModules (1,3) double {mustBeInteger, mustBeGreaterThanOrEqual(nModules, 2)} + moduleLength (1,1) double {mustBePositive, mustBeFinite} + density (1,1) double {mustBePositive, mustBeFinite} +end + +M = nModules(1); N = nModules(2); L = nModules(3); +fullMass = moduleLength * moduleLength * moduleLength * density / 2.0; + +% Grid nodes: halve the mass once for each face of the prism they touch. +[i, j, k] = ndgrid(1:M, 1:N, 1:L); +facesTouched = (k == 1 | k == L) + (j == 1 | j == N) + (i == 1 | i == M); +gridMass = fullMass * 2 .^ (-facesTouched(:)); + +% Centre nodes: full mass. +nCentres = prod(nModules - 1); +centreMass = fullMass * ones(nCentres, 1); + +mass = [gridMass; centreMass]; +end diff --git a/src/+ldem/+mesh/perturbNodes.m b/src/+ldem/+mesh/perturbNodes.m new file mode 100644 index 0000000..d11804b --- /dev/null +++ b/src/+ldem/+mesh/perturbNodes.m @@ -0,0 +1,59 @@ +function nodes = perturbNodes(nodes, nModules, moduleLength, seed, cv) +%PERTURBNODES Add a random perturbation to the node coordinates. +% +% nodes = ldem.mesh.perturbNodes(nodes, nModules, moduleLength, seed, cv) +% displaces every node by a normally distributed random vector with +% standard deviation cv*moduleLength in each direction. Nodes close to the +% faces of the prism keep their original position, so the outer shape is +% preserved. +% +% The random numbers are generated with rng(seed) and drawn in the order +% x, y, z, so the result is reproducible. The global random stream is +% changed by this call. +% +% Inputs: +% nodes nNodes-by-3 coordinates, from ldem.mesh.buildNodes. +% nModules [M N L]. +% moduleLength Module edge length [m]. +% seed Seed of the random number generator. +% cv Standard deviation as a fraction of moduleLength. +% +% Output: +% nodes Perturbed coordinates (same size as the input). +% +% Note: the legacy code contains this feature but disables it (it sets +% LABELN=1 and immediately LABELN=0), so the legacy results correspond to +% no perturbation. ldem.Parameters.meshPerturbation.enabled is false by +% default for the same reason. +% +% Legacy: IMPERF. +% +% See also ldem.mesh.buildNodes. + +arguments + nodes (:,3) double + nModules (1,3) double + moduleLength (1,1) double + seed (1,1) double + cv (1,1) double {mustBeNonnegative} +end + +M1 = nModules(1) - 1; N1 = nModules(2) - 1; L1 = nModules(3) - 1; +nNodes = size(nodes, 1); + +original = nodes; +rng(seed); +perturbed = nodes; +for axis = 1:3 + perturbed(:, axis) = nodes(:, axis) + randn(nNodes, 1) * cv * moduleLength; +end + +% Keep the nodes near the faces of the prism where they were. +x = original(:, 1); y = original(:, 2); z = original(:, 3); +nearFace = (z >= (L1 - 1.01) * moduleLength) | (z <= 1.01 * moduleLength) | ... + (x >= (M1 - 1.01) * moduleLength) | (x <= 1.01 * moduleLength) | ... + (y >= (N1 - 1.01) * moduleLength) | (y <= 1.01 * moduleLength); +perturbed(nearFace, :) = original(nearFace, :); + +nodes = perturbed; +end diff --git a/src/+ldem/+scenarios/FourPointBending.m b/src/+ldem/+scenarios/FourPointBending.m new file mode 100644 index 0000000..1dcdc25 --- /dev/null +++ b/src/+ldem/+scenarios/FourPointBending.m @@ -0,0 +1,54 @@ +classdef FourPointBending < ldem.scenarios.Scenario + %FOURPOINTBENDING Beam loaded at two points and supported at two points (TEST 102). + % + % The beam is supported near both ends and loaded by prescribed + % vertical displacements at the quarter points. This class defines the + % supports; the loading is added with the solver. + % + % The positions are expressed in module units, as in the legacy code + % (supports at 4 modules from each end, loads at 33.5 modules from + % each end), so the scenario only makes sense for beams longer than + % about 70 modules. See legacy/KNOWN_ISSUES.md, item 5. + % + % Legacy: the "TEST == 102" branch of BOUND. + % + % See also ldem.scenarios.Scenario. + + properties (Constant) + testId = 102 + end + + methods + function fixed = fixedDofs(obj, nodes0, params) + %FIXEDDOFS Supports and load points of the beam. + % + % Fixes x and y at the left support, y at the right support, + % and y at the two load points on the top face (their + % y-motion is then imposed by the loading routine). + arguments + obj (1,1) ldem.scenarios.FourPointBending %#ok + nodes0 (:,3) double + params (1,1) ldem.Parameters + end + LCO = params.moduleLength; + M1 = params.nModules(1) - 1; + N1 = params.nModules(2) - 1; + x = nodes0(:, 1); + y = nodes0(:, 2); + + leftSupport = (y > (0.49 * LCO)) & (y < (0.51 * LCO)) & ... + (x < (4.51 * LCO)) & (x > (4.49 * LCO)); + rightSupport = (x > ((M1 - 4.51) * LCO)) & (x < ((M1 - 4.49) * LCO)) & ... + (y < (0.51 * LCO)) & (y > (0.49 * LCO)); + + loadRight = (x < ((M1 - 33.49) * LCO)) & (x > ((M1 - 33.51) * LCO)) & ... + (y < ((N1 - 0.49) * LCO)) & (y > ((N1 - 0.51) * LCO)); + loadLeft = (x < (33.51 * LCO)) & (x > (33.49 * LCO)) & ... + (y < ((N1 - 0.49) * LCO)) & (y > ((N1 - 0.51) * LCO)); + + fixed = false(size(nodes0)); + fixed(leftSupport, 1) = true; + fixed(leftSupport | rightSupport | loadRight | loadLeft, 2) = true; + end + end +end diff --git a/src/+ldem/+scenarios/Scenario.m b/src/+ldem/+scenarios/Scenario.m new file mode 100644 index 0000000..8b04aaf --- /dev/null +++ b/src/+ldem/+scenarios/Scenario.m @@ -0,0 +1,34 @@ +classdef (Abstract) Scenario + %SCENARIO Base class of the test cases (boundary conditions and loads). + % + % A scenario defines everything that is specific to one kind of test: + % which degrees of freedom are fixed, and (in later versions of the + % package) how the load is applied and which results are extracted. + % The solver never checks the test number; it asks the scenario. + % + % To add a new test, create a subclass in this folder: + % 1. Set the constant property testId to a new number. + % 2. Implement fixedDofs. + % 3. Register the class in ldem.scenarios.fromTestId. + % + % See also ldem.scenarios.UniaxialTension, + % ldem.scenarios.FourPointBending, ldem.scenarios.fromTestId. + + properties (Abstract, Constant) + % Number that identifies the scenario in the input file (TEST). + testId + end + + methods (Abstract) + % FIXEDDOFS Degrees of freedom held at their initial position. + % + % fixed = scenario.fixedDofs(nodes0, params) returns an + % nNodes-by-3 logical matrix; fixed(n, d) is true when node n is + % not allowed to move in direction d (1 = x, 2 = y, 3 = z). + % + % Inputs: + % nodes0 nNodes-by-3 initial coordinates [m]. + % params ldem.Parameters. + fixed = fixedDofs(obj, nodes0, params) + end +end diff --git a/src/+ldem/+scenarios/UniaxialTension.m b/src/+ldem/+scenarios/UniaxialTension.m new file mode 100644 index 0000000..5895865 --- /dev/null +++ b/src/+ldem/+scenarios/UniaxialTension.m @@ -0,0 +1,41 @@ +classdef UniaxialTension < ldem.scenarios.Scenario + %UNIAXIALTENSION Prism loaded by a prescribed axial displacement (TEST 101). + % + % The prism is pulled (or compressed) along x by imposing a + % displacement velocity on the last column of centre nodes. This class + % defines the supports; the loading is added with the solver. + % + % Legacy: the "TEST == 101" branches of BOUND and CALOAD. + % + % See also ldem.scenarios.Scenario. + + properties (Constant) + testId = 101 + end + + methods + function fixed = fixedDofs(obj, nodes0, params) + %FIXEDDOFS Fix the x-motion of the centre nodes of both end faces. + % + % NOTE (reproduces the legacy code): the right-end condition + % is written with the legacy operator precedence, + % (M1 - 0.51*LCO) instead of (M1 - 0.51)*LCO, so it selects no + % node and only the left end is fixed. See + % legacy/KNOWN_ISSUES.md, item 3. + arguments + obj (1,1) ldem.scenarios.UniaxialTension %#ok + nodes0 (:,3) double + params (1,1) ldem.Parameters + end + LCO = params.moduleLength; + M1 = params.nModules(1) - 1; + x = nodes0(:, 1); + + leftEnd = (x < (0.51 * LCO)) & (x > (0.49 * LCO)); + rightEnd = (x > (M1 - 0.51 * LCO)) & (x < (M1 - 0.49 * LCO)); + + fixed = false(size(nodes0)); + fixed(leftEnd | rightEnd, 1) = true; + end + end +end diff --git a/src/+ldem/+scenarios/fromTestId.m b/src/+ldem/+scenarios/fromTestId.m new file mode 100644 index 0000000..f7c9d2c --- /dev/null +++ b/src/+ldem/+scenarios/fromTestId.m @@ -0,0 +1,40 @@ +function scenario = fromTestId(testId) +%FROMTESTID Create the scenario object for a test number. +% +% scenario = ldem.scenarios.fromTestId(testId) returns an instance of the +% scenario class registered for testId: +% +% 101 ldem.scenarios.UniaxialTension +% 102 ldem.scenarios.FourPointBending +% +% To register a new scenario, add a line to the list inside this file. +% +% Input: +% testId Test number (Parameters.testId). +% +% Output: +% scenario Object of a subclass of ldem.scenarios.Scenario. +% +% Errors: +% ldem:scenarios:unknownTest No scenario has that number. +% +% See also ldem.scenarios.Scenario. + +arguments + testId (1,1) double +end + +registered = {ldem.scenarios.UniaxialTension(), ldem.scenarios.FourPointBending()}; + +for k = 1:numel(registered) + if registered{k}.testId == testId + scenario = registered{k}; + return + end +end + +known = cellfun(@(s) s.testId, registered); +error('ldem:scenarios:unknownTest', ... + 'There is no scenario for testId = %g. Available: %s.', ... + testId, strjoin(string(known), ', ')); +end diff --git a/src/+ldem/+solver/checkStability.m b/src/+ldem/+solver/checkStability.m new file mode 100644 index 0000000..e9f6c09 --- /dev/null +++ b/src/+ldem/+solver/checkStability.m @@ -0,0 +1,41 @@ +function criticalDt = checkStability(barLength, params) +%CHECKSTABILITY Verify that the time step is stable for the actual mesh. +% +% criticalDt = ldem.solver.checkStability(barLength, params) computes the +% largest stable time step of the explicit scheme, minimum bar length +% divided by the elastic wave speed, and throws an error if params.dt is +% larger. +% +% This uses the real bar lengths, so it also covers perturbed meshes. For +% a regular lattice the value equals params.criticalTimeStep. +% +% Inputs: +% barLength Vector of initial bar lengths [m]. +% params ldem.Parameters. +% +% Output: +% criticalDt Largest stable time step [s]. +% +% Errors: +% ldem:params:unstableTimeStep params.dt exceeds the critical value. +% +% Example: +% criticalDt = ldem.solver.checkStability(mesh.barLength, params); +% +% Legacy: stability check at the end of NAYFES0. +% +% See also ldem.Parameters, ldem.mesh.computeBarGeometry. + +arguments + barLength (:,1) double {mustBePositive} + params (1,1) ldem.Parameters +end + +criticalDt = min(barLength) / params.waveSpeed; +if criticalDt < params.dt + error('ldem:params:unstableTimeStep', ... + ['The time step dt = %g s is unstable for this mesh: the shortest ' ... + 'bar (%g m) requires dt <= %g s. Reduce dt.'], ... + params.dt, min(barLength), criticalDt); +end +end diff --git a/src/+ldem/Parameters.m b/src/+ldem/Parameters.m new file mode 100644 index 0000000..3a5f77e --- /dev/null +++ b/src/+ldem/Parameters.m @@ -0,0 +1,264 @@ +classdef Parameters + %PARAMETERS Validated input parameters of an LDEM simulation. + % + % p = ldem.Parameters() creates a parameter set with default values + % (a small tension test that runs in seconds). + % + % p = ldem.Parameters(Name=Value, ...) overrides any property, for + % example: + % + % p = ldem.Parameters(testId=102, nModules=[70 4 3], dt=2e-7); + % + % p = ldem.Parameters.fromFile("DATA0.DAT") reads the legacy input + % file format, see ldem.io.readInputFile. + % + % Every property is validated when it is assigned (type, size and + % range). Rules that involve several properties, such as the + % stability of the time step, are checked by validate(), which the + % constructor and ldem.runSimulation call for you. + % + % Units are SI (m, s, kg, Pa, N) unless stated otherwise. + % + % Legacy names: the comment on each property gives the variable of the + % original code (DATA0.DAT / global variables) it replaces. + % + % See also ldem.io.readInputFile, ldem.runSimulation. + + properties + % Test identifier selecting the boundary conditions and loads + % (101 = uniaxial tension, 102 = four-point bending). Legacy: TEST. + testId (1,1) double {mustBeInteger, mustBePositive} = 101 + + % Seed of the random number generator used for the optional mesh + % perturbation. Legacy: SEED. + seed (1,1) double {mustBeInteger, mustBeNonnegative} = 123 + + % Edge length of the cubic module [m]. Legacy: LCO. + moduleLength (1,1) double {mustBePositive, mustBeFinite} = 0.003 + + % Number of nodes along x, y and z of the prism, [M N L]; the prism + % has (M-1)*(N-1)*(L-1) cubic modules. Legacy: M, N, L. + nModules (1,3) double {mustBeInteger, mustBeGreaterThanOrEqual(nModules, 2)} = [6 3 3] + + % Mass-proportional damping coefficient before the switch time + % [1/s]. Legacy: DF1. + dampingInitial (1,1) double {mustBeNonnegative, mustBeFinite} = 25000 + + % Mass-proportional damping coefficient after the switch time + % [1/s]. Legacy: DF2. + dampingFinal (1,1) double {mustBeNonnegative, mustBeFinite} = 25000 + + % Time at which the damping changes from dampingInitial to + % dampingFinal [s]. Legacy: TDAF. + dampingSwitchTime (1,1) double {mustBeNonnegative, mustBeFinite} = 0.015 + + % Damping coefficient inside the constitutive law, proportional to + % the stiffness [s]. Legacy: CON. + constitutiveDamping (1,1) double {mustBeNonnegative, mustBeFinite} = 0 + + % Integration time step [s]. Legacy: DT. + dt (1,1) double {mustBePositive, mustBeFinite} = 2e-7 + + % Total simulated time [s]. Legacy: TTOT. + totalTime (1,1) double {mustBePositive, mustBeFinite} = 4e-5 + + % Node numbers of the control points whose motion is recorded, as a + % row vector (at most 10). Legacy: INCO, NCON. + controlNodes (1,:) double {mustBeInteger, mustBePositive} = [1 2] + + % Young's modulus [Pa]. Legacy: YNG. + youngModulus (1,1) double {mustBePositive, mustBeFinite} = 32e9 + + % Mass density [kg/m^3]. Legacy: ROH. + density (1,1) double {mustBePositive, mustBeFinite} = 2000 + + % Poisson's ratio, from 0 up to (not including) 0.5. The upper + % limit is checked by validate(). Legacy: PSN. + poissonRatio (1,1) double {mustBeNonnegative, mustBeFinite} = 0.25 + + % Specific fracture energy [N/m]. Legacy: GFR. + fractureEnergy (1,1) double {mustBePositive, mustBeFinite} = 50 + + % Equivalent (critical) distance [m]. Legacy: DEQ. + criticalDistance (1,1) double {mustBePositive, mustBeFinite} = 0.028 + + % Fraction of the module face that fails per bar (area of failure is + % failureAreaFactor*length). Legacy: CAF, hardcoded to 0.1385. + failureAreaFactor (1,1) double {mustBePositive, mustBeFinite} = 0.1385 + + % Number of the bar whose strain history is recorded. + % Legacy: hardcoded 7014 in CABAR and ENERG2. + trackedBar (1,1) double {mustBeInteger, mustBePositive} = 7014 + + % Text file with one multiplier of the critical strain per bar + % (random field). Empty means "no random field" (all multipliers 1). + % Legacy: file "arquivo_3lc_rnao_cv05". + randomFieldFile (1,1) string = "" + + % Optional random perturbation of the node coordinates. + % enabled: apply it; cv: standard deviation as a fraction of the + % module length. Legacy: LABELN (always 0) and CVUVW = 0.02. + meshPerturbation (1,1) struct = struct('enabled', false, 'cv', 0.02) + + % How often each result is stored, in time steps (0 = never): + % + % * snapshotEvery: ANSYS/VTK files and full-field snapshots (OU3). + % * controlNodesEvery: control nodes and reactions (OU6). + % * energyEvery: global energies (OU8). + % * trackedBarEvery: tracked bar, 0 or 1; the legacy code stores it + % at every step when OU9 > 0 (OU9). + output (1,1) struct = struct('snapshotEvery', 0, ... + 'controlNodesEvery', 10, 'energyEvery', 10, 'trackedBarEvery', 0) + end + + properties (Dependent, SetAccess = private) + % Number of time steps, round(totalTime/dt). Legacy: NSTEP. + nSteps + + % Step at which the damping changes, round(dampingSwitchTime/dt). + % Legacy: NDAMF. + dampingSwitchStep + + % Total number of nodes: grid nodes plus module-centre nodes. + % Legacy: NNT. + nNodes + + % Elastic wave speed sqrt(E/rho) [m/s]. + waveSpeed + + % Largest stable time step for a regular (unperturbed) lattice [s]. + % The shortest bar joins a module centre to a corner and measures + % sqrt(3)/2 times the module length. + criticalTimeStep + end + + methods + function obj = Parameters(props) + %PARAMETERS Create and validate a parameter set. + arguments + props.?ldem.Parameters + end + names = fieldnames(props); + for k = 1:numel(names) + obj.(names{k}) = props.(names{k}); + end + obj.validate(); + end + + function validate(obj) + %VALIDATE Check the rules that involve several properties. + % + % p.validate() throws an error with an identifier of the form + % "ldem:params:" and a message that says how to fix + % it. It returns silently when the parameters are consistent. + + % The lattice stiffness formulas diverge as the ratio approaches 1/2. + if obj.poissonRatio >= 0.5 + error('ldem:params:badPoissonRatio', ... + 'poissonRatio must be smaller than 0.5, got %g.', obj.poissonRatio); + end + + % Control nodes must exist and be few. + if numel(obj.controlNodes) > 10 + error('ldem:params:tooManyControlNodes', ... + 'At most 10 control nodes are supported, got %d.', ... + numel(obj.controlNodes)); + end + if any(obj.controlNodes > obj.nNodes) + error('ldem:params:controlNodeOutOfRange', ... + ['Control node %d does not exist: the mesh has only ' ... + '%d nodes.'], max(obj.controlNodes), obj.nNodes); + end + + % Output settings. + required = {'snapshotEvery','controlNodesEvery','energyEvery','trackedBarEvery'}; + if ~all(isfield(obj.output, required)) || numel(fieldnames(obj.output)) ~= numel(required) + error('ldem:params:badOutput', ... + 'output must have exactly the fields: %s.', strjoin(required, ', ')); + end + for k = 1:numel(required) + v = obj.output.(required{k}); + if ~(isnumeric(v) && isscalar(v) && isfinite(v) && v >= 0 && v == fix(v)) + error('ldem:params:badOutput', ... + 'output.%s must be a non-negative integer.', required{k}); + end + end + if obj.output.trackedBarEvery > 1 + error('ldem:params:badOutput', ... + 'output.trackedBarEvery must be 0 or 1 (the tracked bar is stored at every step).'); + end + + % Mesh perturbation settings. + mp = obj.meshPerturbation; + if ~isequal(sort(fieldnames(mp)), sort({'enabled'; 'cv'})) || ... + ~(isscalar(mp.enabled) && (islogical(mp.enabled) || isnumeric(mp.enabled))) || ... + ~(isnumeric(mp.cv) && isscalar(mp.cv) && mp.cv >= 0 && isfinite(mp.cv)) + error('ldem:params:badMeshPerturbation', ... + 'meshPerturbation must be a struct with a logical "enabled" and a non-negative "cv".'); + end + + % Time integration. + if obj.totalTime < obj.dt + error('ldem:params:totalTimeTooShort', ... + 'totalTime (%g s) must be at least one time step (dt = %g s).', ... + obj.totalTime, obj.dt); + end + if ~obj.meshPerturbation.enabled && obj.dt > obj.criticalTimeStep + error('ldem:params:unstableTimeStep', ... + ['The time step dt = %g s is unstable. For moduleLength = %g m, ' ... + 'youngModulus = %g Pa and density = %g kg/m^3 it must not exceed ' ... + '%g s. Reduce dt or increase moduleLength.'], ... + obj.dt, obj.moduleLength, obj.youngModulus, obj.density, obj.criticalTimeStep); + end + end + + function value = get.nSteps(obj) + value = round(obj.totalTime / obj.dt); + end + + function value = get.dampingSwitchStep(obj) + value = round(obj.dampingSwitchTime / obj.dt); + end + + function value = get.nNodes(obj) + gridNodes = prod(obj.nModules); + centreNodes = prod(obj.nModules - 1); + value = gridNodes + centreNodes; + end + + function value = get.waveSpeed(obj) + value = sqrt(obj.youngModulus / obj.density); + end + + function value = get.criticalTimeStep(obj) + shortestBar = obj.moduleLength * sqrt(3) / 2; + value = shortestBar / obj.waveSpeed; + end + end + + methods (Static) + function obj = fromFile(path, overrides) + %FROMFILE Read the legacy input file (DATA0.DAT format). + % + % p = ldem.Parameters.fromFile(path) reads the file and + % returns a validated parameter set. + % + % p = ldem.Parameters.fromFile(path, Name=Value) additionally + % overrides properties that are not stored in the file, for + % example randomFieldFile or trackedBar. + % + % See also ldem.io.readInputFile. + arguments + path (1,1) string + overrides.?ldem.Parameters + end + fromFile = ldem.io.readInputFile(path); + names = fieldnames(overrides); + for k = 1:numel(names) + fromFile.(names{k}) = overrides.(names{k}); + end + args = namedargs2cell(fromFile); + obj = ldem.Parameters(args{:}); + end + end +end diff --git a/tests/LdemTestCase.m b/tests/LdemTestCase.m new file mode 100644 index 0000000..42d7209 --- /dev/null +++ b/tests/LdemTestCase.m @@ -0,0 +1,25 @@ +classdef (Abstract) LdemTestCase < matlab.unittest.TestCase + %LDEMTESTCASE Base class of the tests of the refactored ldem package. + % + % Adds src/ (the ldem package) to the MATLAB path for the duration of + % the test class and exposes the repository folders. Derive a test + % from it with: + % + % classdef TestSomething < LdemTestCase + % + % The tests/ folder must be on the path (run_tests does it). + + properties (Access = protected) + % Absolute path of the repository root. + RepoRoot (1,1) string + end + + methods (TestClassSetup) + function addSourceToPath(testCase) + here = fileparts(mfilename('fullpath')); + testCase.RepoRoot = string(fileparts(here)); + testCase.applyFixture(matlab.unittest.fixtures.PathFixture( ... + fullfile(testCase.RepoRoot, 'src'))); + end + end +end diff --git a/tests/regression/TestMeshAgainstLegacy.m b/tests/regression/TestMeshAgainstLegacy.m new file mode 100644 index 0000000..0c9153e --- /dev/null +++ b/tests/regression/TestMeshAgainstLegacy.m @@ -0,0 +1,86 @@ +classdef TestMeshAgainstLegacy < LdemTestCase + %TESTMESHAGAINSTLEGACY The new mesh equals the one built by the legacy code. + % + % Compares ldem.mesh.buildMesh with the node coordinates, supports, + % masses, connectivity and bar geometry stored in the golden-master + % fixtures (generated by legacy/main1.m). No simulation is run, so the + % test is fast. + % + % See also TestFixtures, generateReference. + + properties (TestParameter) + caseName = {'tension101_elastic', 'tension101_damage', 'bending102'} + end + + methods (Test, TestTags = {'Regression'}) + function meshMatchesLegacy(testCase, caseName) + fixture = load(fullfile(testCase.RepoRoot, 'tests', 'fixtures', caseName + ".mat")); + s = fixture.state; + params = TestMeshAgainstLegacy.parametersOf(fixture.caseDef); + + mesh = ldem.mesh.buildMesh(params); + + tight = {'RelTol', 1e-14, 'AbsTol', 1e-18}; + + testCase.verifyEqual(params.nNodes, s.NNT, 'Node count differs.'); + testCase.verifyEqual(size(mesh.bars, 1), s.NBT, 'Bar count differs.'); + + % Initial coordinates (legacy U0, V0, W0). + testCase.verifyEqual(mesh.nodes0, [s.U0(:), s.V0(:), s.W0(:)], tight{:}); + + % Supports (legacy BDX, BDY, BDZ). + legacyFixed = [s.BDX(:), s.BDY(:), s.BDZ(:)] ~= 0; + testCase.verifyEqual(mesh.fixed, legacyFixed, 'Supports differ.'); + + % Lumped masses (legacy MAS). + testCase.verifyEqual(mesh.mass, s.MAS(:), tight{:}); + + % Connectivity (legacy CN is [start1 end1 start2 end2 ...]). + testCase.verifyEqual(mesh.bars, reshape(s.CN, 2, []).', 'Connectivity differs.'); + + % Bar geometry (legacy LI, XB, YB, ZB). + testCase.verifyEqual(mesh.barLength, s.LI(:), tight{:}); + testCase.verifyEqual(mesh.barCentres, [s.XB(:), s.YB(:), s.ZB(:)], tight{:}); + end + + function timeIntegrationSettingsMatchLegacy(testCase, caseName) + fixture = load(fullfile(testCase.RepoRoot, 'tests', 'fixtures', caseName + ".mat")); + params = TestMeshAgainstLegacy.parametersOf(fixture.caseDef); + testCase.verifyEqual(params.nSteps, double(fixture.state.NSTEP)); + testCase.verifyEqual(params.dt, fixture.state.DT); + end + + function stabilityCheckAgreesWithLegacyCriterion(testCase, caseName) + % Legacy NAYFES0 stops when min(LI)/sqrt(E/rho) < DT. + fixture = load(fullfile(testCase.RepoRoot, 'tests', 'fixtures', caseName + ".mat")); + params = TestMeshAgainstLegacy.parametersOf(fixture.caseDef); + mesh = ldem.mesh.buildMesh(params); + legacyCritical = min(fixture.state.LI) / sqrt(params.youngModulus / params.density); + testCase.verifyEqual(ldem.solver.checkStability(mesh.barLength, params), ... + legacyCritical, 'RelTol', 1e-12); + end + end + + methods (Static, Access = private) + function params = parametersOf(c) + %PARAMETERSOF Build ldem.Parameters from a reference-case definition. + params = ldem.Parameters( ... + testId = c.test, ... + seed = c.seed, ... + moduleLength = c.moduleLength, ... + nModules = c.modules, ... + dampingInitial = c.damping1, ... + dampingFinal = c.damping2, ... + dampingSwitchTime = c.dampingSwitchTime, ... + constitutiveDamping = c.con, ... + dt = c.dt, ... + totalTime = c.nSteps * c.dt, ... + controlNodes = c.controlNodes, ... + youngModulus = c.youngModulus, ... + density = c.density, ... + poissonRatio = c.poisson, ... + fractureEnergy = c.fractureEnergy, ... + criticalDistance = c.criticalDistance); + end + end +end diff --git a/tests/run_tests.m b/tests/run_tests.m index 87e7363..92fc700 100644 --- a/tests/run_tests.m +++ b/tests/run_tests.m @@ -22,6 +22,7 @@ end testsFolder = fileparts(mfilename('fullpath')); +addpath(testsFolder); addpath(fullfile(fileparts(testsFolder), 'legacy')); suite = matlab.unittest.TestSuite.fromFolder(testsFolder, ... diff --git a/tests/tools/generateReference.m b/tests/tools/generateReference.m index 2a32d2b..24af3b7 100644 --- a/tests/tools/generateReference.m +++ b/tests/tools/generateReference.m @@ -39,7 +39,7 @@ function generateReference(caseNames) mkdir(workDir); cleaner = onCleanup(@() rmdir(workDir, 's')); timer = tic; - [state, files] = runLegacyCase(caseDef, workDir); %#ok + [state, files] = runLegacyCase(caseDef, workDir); save(fullfile(fixtureDir, caseDef.name + ".mat"), 'caseDef', 'state', 'files'); fprintf('done in %.1f s (%d nodes, %d bars, %d damaged bars).\n', ... toc(timer), state.NNT, state.NBT, nnz(~state.DM)); diff --git a/tests/unit/TestMesh.m b/tests/unit/TestMesh.m new file mode 100644 index 0000000..0a9f5a1 --- /dev/null +++ b/tests/unit/TestMesh.m @@ -0,0 +1,131 @@ +classdef TestMesh < LdemTestCase + %TESTMESH Unit tests of the ldem.mesh package using analytical results. + + properties (TestParameter) + % Sizes [M N L] covering cubes, prisms and the 2-node minimum. + sizes = {[2 2 2], [3 3 3], [4 3 2], [5 2 3], [6 4 5]} + end + + methods (Test, TestTags = {'Unit'}) + function nodeCount(testCase, sizes) + nodes = ldem.mesh.buildNodes(sizes, 0.01); + expected = prod(sizes) + prod(sizes - 1); + testCase.verifySize(nodes, [expected 3]); + end + + function nodeCoordinates(testCase) + lco = 0.5; + nodes = ldem.mesh.buildNodes([3 2 2], lco); + % Grid nodes: x runs fastest. + testCase.verifyEqual(nodes(1, :), [0 0 0]); + testCase.verifyEqual(nodes(2, :), [1 0 0] * lco); + testCase.verifyEqual(nodes(3, :), [2 0 0] * lco); + testCase.verifyEqual(nodes(4, :), [0 1 0] * lco); + testCase.verifyEqual(nodes(7, :), [0 0 1] * lco); + % Centre nodes come after the 12 grid nodes, at half-integer positions. + testCase.verifyEqual(nodes(13, :), [0.5 0.5 0.5] * lco); + testCase.verifyEqual(nodes(14, :), [1.5 0.5 0.5] * lco); + end + + function barCount(testCase, sizes) + M = sizes(1); N = sizes(2); L = sizes(3); + gridEdges = (M-1)*N*L + M*(N-1)*L + M*N*(L-1); + centreBars = (M-2)*(N-1)*(L-1) + (M-1)*(N-2)*(L-1) + (M-1)*(N-1)*(L-2); + diagonals = 8 * (M-1)*(N-1)*(L-1); + bars = ldem.mesh.buildBars(sizes); + testCase.verifySize(bars, [gridEdges + centreBars + diagonals, 2]); + end + + function singleModuleHasTwentyBars(testCase) + bars = ldem.mesh.buildBars([2 2 2]); + testCase.verifySize(bars, [20 2]); + end + + function barsAreValidAndUnique(testCase, sizes) + bars = ldem.mesh.buildBars(sizes); + nNodes = prod(sizes) + prod(sizes - 1); + testCase.verifyGreaterThanOrEqual(min(bars, [], 'all'), 1); + testCase.verifyLessThanOrEqual(max(bars, [], 'all'), nNodes); + testCase.verifyTrue(all(bars(:, 1) ~= bars(:, 2)), 'A bar joins a node to itself.'); + unordered = sort(bars, 2); + testCase.verifySize(unique(unordered, 'rows'), size(bars), ... + 'The same pair of nodes is joined by more than one bar.'); + end + + function everyNodeIsConnected(testCase, sizes) + bars = ldem.mesh.buildBars(sizes); + nNodes = prod(sizes) + prod(sizes - 1); + testCase.verifyEqual(numel(unique(bars)), nNodes); + end + + function barLengthsAreEdgesAndDiagonals(testCase) + lco = 0.02; + nodes = ldem.mesh.buildNodes([4 3 3], lco); + bars = ldem.mesh.buildBars([4 3 3]); + len = ldem.mesh.computeBarGeometry(nodes, bars); + allowed = [lco, lco * sqrt(3) / 2]; + distance = min(abs(len - allowed), [], 2); + testCase.verifyLessThan(max(distance), 1e-14); + testCase.verifyEqual(min(len), lco * sqrt(3) / 2, 'RelTol', 1e-12); + end + + function barMidpointsLieBetweenEndNodes(testCase) + nodes = ldem.mesh.buildNodes([3 3 3], 1); + bars = ldem.mesh.buildBars([3 3 3]); + [~, mid] = ldem.mesh.computeBarGeometry(nodes, bars); + testCase.verifyEqual(mid, (nodes(bars(:, 1), :) + nodes(bars(:, 2), :)) / 2); + end + + function totalMassEqualsDensityTimesVolume(testCase, sizes) + lco = 0.01; rho = 2500; + mass = ldem.mesh.computeNodalMasses(sizes, lco, rho); + volume = prod(sizes - 1) * lco^3; + testCase.verifyEqual(sum(mass), rho * volume, 'RelTol', 1e-12); + end + + function massReductionAtFacesEdgesAndCorners(testCase) + lco = 1; rho = 2; + full = lco^3 * rho / 2; + mass = ldem.mesh.computeNodalMasses([4 4 4], lco, rho); + nodeAt = @(i, j, k) (k-1)*16 + (j-1)*4 + i; + testCase.verifyEqual(mass(nodeAt(2, 2, 2)), full); % interior + testCase.verifyEqual(mass(nodeAt(1, 2, 2)), full / 2); % face + testCase.verifyEqual(mass(nodeAt(1, 1, 2)), full / 4); % edge + testCase.verifyEqual(mass(nodeAt(1, 1, 1)), full / 8); % corner + testCase.verifyEqual(mass(65), full); % centre node + end + + function zeroLengthBarIsDetected(testCase) + nodes = [0 0 0; 0 0 0; 1 0 0]; + testCase.verifyError(@() ldem.mesh.computeBarGeometry(nodes, [1 2; 2 3]), ... + 'ldem:mesh:zeroLengthBar'); + end + + function barReferringToMissingNodeIsDetected(testCase) + nodes = [0 0 0; 1 0 0]; + testCase.verifyError(@() ldem.mesh.computeBarGeometry(nodes, [1 3]), ... + 'ldem:mesh:badConnectivity'); + end + + function buildMeshAssemblesEverything(testCase) + params = ldem.Parameters(testId=101, nModules=[6 3 3]); + mesh = ldem.mesh.buildMesh(params); + + nNodes = params.nNodes; + testCase.verifySize(mesh.nodes0, [nNodes 3]); + testCase.verifySize(mesh.fixed, [nNodes 3]); + testCase.verifyClass(mesh.fixed, 'logical'); + testCase.verifySize(mesh.mass, [nNodes 1]); + testCase.verifyEqual(mesh.nGridNodes, 54); + nBars = size(mesh.bars, 1); + testCase.verifySize(mesh.barLength, [nBars 1]); + testCase.verifySize(mesh.barCentres, [nBars 3]); + end + + function buildMeshRejectsUnknownTest(testCase) + params = ldem.Parameters(testId=999); + testCase.verifyError(@() ldem.mesh.buildMesh(params), ... + 'ldem:scenarios:unknownTest'); + end + end +end diff --git a/tests/unit/TestParameters.m b/tests/unit/TestParameters.m new file mode 100644 index 0000000..61b1f2a --- /dev/null +++ b/tests/unit/TestParameters.m @@ -0,0 +1,108 @@ +classdef TestParameters < LdemTestCase + %TESTPARAMETERS Unit tests of ldem.Parameters. + + methods (Test, TestTags = {'Unit'}) + function defaultsAreValid(testCase) + p = ldem.Parameters(); + testCase.verifyEqual(p.testId, 101); + testCase.verifyEqual(p.nModules, [6 3 3]); + end + + function nameValueOverridesProperties(testCase) + p = ldem.Parameters(testId=102, nModules=[70 4 3], dt=1e-7); + testCase.verifyEqual(p.testId, 102); + testCase.verifyEqual(p.nModules, [70 4 3]); + testCase.verifyEqual(p.dt, 1e-7); + end + + function dependentValues(testCase) + p = ldem.Parameters(nModules=[3 3 3], dt=2e-7, totalTime=4e-5, ... + dampingSwitchTime=1e-5, youngModulus=32e9, density=2000); + testCase.verifyEqual(p.nSteps, 200); + testCase.verifyEqual(p.dampingSwitchStep, 50); + testCase.verifyEqual(p.nNodes, 27 + 8); + testCase.verifyEqual(p.waveSpeed, 4000, 'RelTol', 1e-12); + testCase.verifyEqual(p.criticalTimeStep, ... + p.moduleLength * sqrt(3) / 2 / 4000, 'RelTol', 1e-12); + end + + function dependentPropertiesCannotBeSet(testCase) + testCase.verifyError(@() ldem.Parameters(nSteps=10), ?MException); + end + + function rejectsInvalidValues(testCase) + testCase.verifyError(@() ldem.Parameters(moduleLength=-1), ?MException); + testCase.verifyError(@() ldem.Parameters(nModules=[1 3 3]), ?MException); + testCase.verifyError(@() ldem.Parameters(nModules=[2.5 3 3]), ?MException); + testCase.verifyError(@() ldem.Parameters(poissonRatio=-0.1), ?MException); + testCase.verifyError(@() ldem.Parameters(youngModulus=0), ?MException); + testCase.verifyError(@() ldem.Parameters(dt=NaN), ?MException); + end + + function poissonRatioMustBeBelowOneHalf(testCase) + testCase.verifyError(@() ldem.Parameters(poissonRatio=0.5), ... + 'ldem:params:badPoissonRatio'); + p = ldem.Parameters(poissonRatio=0.499); + testCase.verifyEqual(p.poissonRatio, 0.499); + end + + function unstableTimeStepIsRejected(testCase) + testCase.verifyError(@() ldem.Parameters(dt=1e-5), ... + 'ldem:params:unstableTimeStep'); + end + + function timeStepJustBelowLimitIsAccepted(testCase) + probe = ldem.Parameters(); + p = ldem.Parameters(dt=0.999 * probe.criticalTimeStep, ... + totalTime=probe.criticalTimeStep); + testCase.verifyLessThan(p.dt, p.criticalTimeStep); + end + + function totalTimeShorterThanStepIsRejected(testCase) + testCase.verifyError(@() ldem.Parameters(dt=2e-7, totalTime=1e-7), ... + 'ldem:params:totalTimeTooShort'); + end + + function controlNodeMustExist(testCase) + testCase.verifyError(@() ldem.Parameters(nModules=[2 2 2], controlNodes=[1 99]), ... + 'ldem:params:controlNodeOutOfRange'); + end + + function atMostTenControlNodes(testCase) + testCase.verifyError(@() ldem.Parameters(controlNodes=1:11), ... + 'ldem:params:tooManyControlNodes'); + end + + function outputSettingsAreChecked(testCase) + bad = struct('snapshotEvery', -1, 'controlNodesEvery', 1, ... + 'energyEvery', 1, 'trackedBarEvery', 0); + testCase.verifyError(@() ldem.Parameters(output=bad), 'ldem:params:badOutput'); + + missing = struct('snapshotEvery', 1); + testCase.verifyError(@() ldem.Parameters(output=missing), 'ldem:params:badOutput'); + + tooOften = struct('snapshotEvery', 1, 'controlNodesEvery', 1, ... + 'energyEvery', 1, 'trackedBarEvery', 5); + testCase.verifyError(@() ldem.Parameters(output=tooOften), 'ldem:params:badOutput'); + end + + function meshPerturbationIsChecked(testCase) + testCase.verifyError( ... + @() ldem.Parameters(meshPerturbation=struct('enabled', true)), ... + 'ldem:params:badMeshPerturbation'); + end + + function valueSemantics(testCase) + a = ldem.Parameters(); + b = a; + b.seed = 999; + testCase.verifyEqual(a.seed, 123, 'Parameters must be a value class.'); + end + + function validateCatchesChangesAfterConstruction(testCase) + p = ldem.Parameters(); + p.dt = 1e-5; + testCase.verifyError(@() p.validate(), 'ldem:params:unstableTimeStep'); + end + end +end diff --git a/tests/unit/TestPerturbNodes.m b/tests/unit/TestPerturbNodes.m new file mode 100644 index 0000000..5e743de --- /dev/null +++ b/tests/unit/TestPerturbNodes.m @@ -0,0 +1,65 @@ +classdef TestPerturbNodes < LdemTestCase + %TESTPERTURBNODES Unit tests of ldem.mesh.perturbNodes. + + properties + Nodes + Sizes = [8 6 6] + Lco = 0.01 + end + + methods (TestMethodSetup) + function createNodes(testCase) + testCase.Nodes = ldem.mesh.buildNodes(testCase.Sizes, testCase.Lco); + end + end + + methods (Test, TestTags = {'Unit'}) + function sameSeedGivesSameResult(testCase) + a = ldem.mesh.perturbNodes(testCase.Nodes, testCase.Sizes, testCase.Lco, 7, 0.02); + b = ldem.mesh.perturbNodes(testCase.Nodes, testCase.Sizes, testCase.Lco, 7, 0.02); + testCase.verifyEqual(a, b); + end + + function differentSeedGivesDifferentResult(testCase) + a = ldem.mesh.perturbNodes(testCase.Nodes, testCase.Sizes, testCase.Lco, 1, 0.02); + b = ldem.mesh.perturbNodes(testCase.Nodes, testCase.Sizes, testCase.Lco, 2, 0.02); + testCase.verifyNotEqual(a, b); + end + + function zeroVariationLeavesNodesUnchanged(testCase) + out = ldem.mesh.perturbNodes(testCase.Nodes, testCase.Sizes, testCase.Lco, 1, 0); + testCase.verifyEqual(out, testCase.Nodes); + end + + function nodesNearTheFacesDoNotMove(testCase) + out = ldem.mesh.perturbNodes(testCase.Nodes, testCase.Sizes, testCase.Lco, 1, 0.05); + moved = any(out ~= testCase.Nodes, 2); + lco = testCase.Lco; + M1 = testCase.Sizes(1) - 1; N1 = testCase.Sizes(2) - 1; L1 = testCase.Sizes(3) - 1; + x = testCase.Nodes(:, 1); y = testCase.Nodes(:, 2); z = testCase.Nodes(:, 3); + nearFace = z >= (L1 - 1.01)*lco | z <= 1.01*lco | ... + x >= (M1 - 1.01)*lco | x <= 1.01*lco | ... + y >= (N1 - 1.01)*lco | y <= 1.01*lco; + testCase.verifyFalse(any(moved & nearFace)); + testCase.verifyTrue(any(moved), 'Some interior node should have moved.'); + end + + function displacementsHaveTheRequestedScale(testCase) + cv = 0.02; + out = ldem.mesh.perturbNodes(testCase.Nodes, testCase.Sizes, testCase.Lco, 3, cv); + d = out - testCase.Nodes; + d = d(any(d ~= 0, 2), :); + testCase.verifyEqual(std(d(:)), cv * testCase.Lco, 'RelTol', 0.3); + end + + function enabledThroughParametersChangesTheMesh(testCase) + base = ldem.Parameters(nModules=testCase.Sizes); + perturbed = ldem.Parameters(nModules=testCase.Sizes, ... + meshPerturbation=struct('enabled', true, 'cv', 0.02)); + a = ldem.mesh.buildMesh(base); + b = ldem.mesh.buildMesh(perturbed); + testCase.verifyNotEqual(a.nodes0, b.nodes0); + testCase.verifyEqual(a.bars, b.bars, 'Connectivity must not change.'); + end + end +end diff --git a/tests/unit/TestReadInputFile.m b/tests/unit/TestReadInputFile.m new file mode 100644 index 0000000..f675010 --- /dev/null +++ b/tests/unit/TestReadInputFile.m @@ -0,0 +1,115 @@ +classdef TestReadInputFile < LdemTestCase + %TESTREADINPUTFILE Unit tests of ldem.io.readInputFile and Parameters.fromFile. + + methods (Access = private) + function path = writeFile(testCase, lines) + folder = testCase.applyFixture( ... + matlab.unittest.fixtures.TemporaryFolderFixture).Folder; + path = fullfile(folder, 'DATA.DAT'); + fid = fopen(path, 'w'); + fprintf(fid, '%s\n', lines{:}); + fclose(fid); + end + + function lines = validLines(~) + % Same layout as DATA0.DAT, with two control nodes. + lines = {"101 ' TEST '", "123 ' SEED '", "0.003 ' LCO '", ... + "6 ' M '", "3 ' N '", "3 ' L '", ... + "25000.00E+0 ' DF1 '", "30000 ' DF2 '", "0.015 ' TDAF '", ... + "0.00E-00 ' CON '", "2.00E-7 ' DT '", "4.0E-5 ' TTOT '", ... + "2 ' INCO '", "1 ' N1 '", "2 ' N2 '", ... + "9999999 ' OU2 '", "100 ' OU3 '", "0 ' OU4 '", "0 ' OU5 '", ... + "10 ' OU6 '", "10 ' OU7 '", "20 ' OU8 '", "5 ' OU9 '", ... + "2.50E-01 ' PSN '", "2000.0E+0 ' ROH '", "32.00E+9 ' YNG '", ... + "50.0E+00 ' GFR '", "0.028 ' DEQ '"}; + end + end + + methods (Test, TestTags = {'Unit'}) + function readsEveryValue(testCase) + v = ldem.io.readInputFile(testCase.writeFile(testCase.validLines())); + + testCase.verifyEqual(v.testId, 101); + testCase.verifyEqual(v.seed, 123); + testCase.verifyEqual(v.moduleLength, 0.003); + testCase.verifyEqual(v.nModules, [6 3 3]); + testCase.verifyEqual(v.dampingInitial, 25000); + testCase.verifyEqual(v.dampingFinal, 30000); + testCase.verifyEqual(v.dampingSwitchTime, 0.015); + testCase.verifyEqual(v.constitutiveDamping, 0); + testCase.verifyEqual(v.dt, 2e-7); + testCase.verifyEqual(v.totalTime, 4e-5); + testCase.verifyEqual(v.controlNodes, [1 2]); + testCase.verifyEqual(v.poissonRatio, 0.25); + testCase.verifyEqual(v.density, 2000); + testCase.verifyEqual(v.youngModulus, 32e9); + testCase.verifyEqual(v.fractureEnergy, 50); + testCase.verifyEqual(v.criticalDistance, 0.028); + end + + function mapsOutputCodes(testCase) + v = ldem.io.readInputFile(testCase.writeFile(testCase.validLines())); + testCase.verifyEqual(v.output.snapshotEvery, 100); % OU3 + testCase.verifyEqual(v.output.controlNodesEvery, 10); % OU6 + testCase.verifyEqual(v.output.energyEvery, 20); % OU8 + testCase.verifyEqual(v.output.trackedBarEvery, 1); % OU9 > 0 + end + + function ignoresBlankLinesAndTrailingText(testCase) + lines = testCase.validLines(); + lines = [lines(1:5), {""}, lines(6:end), {"", " "}]; + v = ldem.io.readInputFile(testCase.writeFile(lines)); + testCase.verifyEqual(v.nModules, [6 3 3]); + end + + function readsTheBundledBeamExample(testCase) + path = fullfile(testCase.RepoRoot, 'examples', 'beam_102', 'DATA0.DAT'); + v = ldem.io.readInputFile(path); + testCase.verifyEqual(v.testId, 102); + testCase.verifyEqual(v.nModules, [101 41 21]); + testCase.verifyEqual(v.controlNodes, 1:5); + testCase.verifyEqual(v.output.snapshotEvery, 10000); + end + + function fromFileReturnsValidatedParameters(testCase) + path = fullfile(testCase.RepoRoot, 'examples', 'beam_102', 'DATA0.DAT'); + p = ldem.Parameters.fromFile(path, trackedBar=42); + testCase.verifyClass(p, 'ldem.Parameters'); + testCase.verifyEqual(p.trackedBar, 42); + testCase.verifyEqual(p.nNodes, 101*41*21 + 100*40*20); + end + + function missingFile(testCase) + testCase.verifyError(@() ldem.io.readInputFile("does_not_exist.dat"), ... + 'ldem:io:fileNotFound'); + end + + function tooFewValues(testCase) + lines = testCase.validLines(); + path = testCase.writeFile(lines(1:8)); + testCase.verifyError(@() ldem.io.readInputFile(path), 'ldem:io:malformedInput'); + end + + function controlNodeCountDoesNotMatch(testCase) + % INCO says 3 but only 2 control nodes are listed. + lines = testCase.validLines(); + lines{13} = "3 ' INCO '"; + path = testCase.writeFile(lines); + testCase.verifyError(@() ldem.io.readInputFile(path), 'ldem:io:malformedInput'); + end + + function nonNumericValue(testCase) + lines = testCase.validLines(); + lines{3} = "abc ' LCO '"; + path = testCase.writeFile(lines); + testCase.verifyError(@() ldem.io.readInputFile(path), 'ldem:io:malformedInput'); + end + + function invalidControlNodeCount(testCase) + lines = testCase.validLines(); + lines{13} = "0 ' INCO '"; + path = testCase.writeFile(lines); + testCase.verifyError(@() ldem.io.readInputFile(path), 'ldem:io:malformedInput'); + end + end +end diff --git a/tests/unit/TestScenarios.m b/tests/unit/TestScenarios.m new file mode 100644 index 0000000..f5428c9 --- /dev/null +++ b/tests/unit/TestScenarios.m @@ -0,0 +1,69 @@ +classdef TestScenarios < LdemTestCase + %TESTSCENARIOS Unit tests of ldem.scenarios and ldem.solver.checkStability. + + methods (Test, TestTags = {'Unit'}) + function factoryReturnsTheRightClass(testCase) + testCase.verifyClass(ldem.scenarios.fromTestId(101), ... + 'ldem.scenarios.UniaxialTension'); + testCase.verifyClass(ldem.scenarios.fromTestId(102), ... + 'ldem.scenarios.FourPointBending'); + end + + function factoryRejectsUnknownTest(testCase) + testCase.verifyError(@() ldem.scenarios.fromTestId(7), ... + 'ldem:scenarios:unknownTest'); + end + + function everyScenarioIsRegisteredUnderItsOwnId(testCase) + for id = [101 102] + testCase.verifyEqual(ldem.scenarios.fromTestId(id).testId, id); + end + end + + function tensionFixesOnlyXOfTheLeftEndCentres(testCase) + params = ldem.Parameters(testId=101, nModules=[6 3 3]); + nodes = ldem.mesh.buildNodes(params.nModules, params.moduleLength); + fixed = ldem.scenarios.UniaxialTension().fixedDofs(nodes, params); + + testCase.verifySize(fixed, [params.nNodes 3]); + testCase.verifyFalse(any(fixed(:, 2:3), 'all'), 'Only x may be fixed.'); + % Centre nodes of the first module column: (N-1)*(L-1) = 4 nodes. + testCase.verifyEqual(nnz(fixed(:, 1)), 4); + testCase.verifyEqual(max(nodes(fixed(:, 1), 1)), 0.5 * params.moduleLength, ... + 'RelTol', 1e-12); + end + + function bendingFixesYAtEverySupportAndLoadPoint(testCase) + params = ldem.Parameters(testId=102, nModules=[70 4 3]); + nodes = ldem.mesh.buildNodes(params.nModules, params.moduleLength); + fixed = ldem.scenarios.FourPointBending().fixedDofs(nodes, params); + + testCase.verifySize(fixed, [params.nNodes 3]); + testCase.verifyFalse(any(fixed(:, 3)), 'z must stay free.'); + testCase.verifyTrue(all(fixed(fixed(:, 1), 2)), ... + 'A node fixed in x must also be fixed in y (left support).'); + testCase.verifyGreaterThan(nnz(fixed(:, 2)), nnz(fixed(:, 1))); + end + + function stabilityCheckReturnsCriticalStep(testCase) + params = ldem.Parameters(); + lengths = [0.003; 0.0026; 0.003]; + critical = ldem.solver.checkStability(lengths, params); + testCase.verifyEqual(critical, 0.0026 / params.waveSpeed, 'RelTol', 1e-12); + end + + function stabilityCheckRejectsShortBars(testCase) + params = ldem.Parameters(); + testCase.verifyError( ... + @() ldem.solver.checkStability([1e-5; 0.003], params), ... + 'ldem:params:unstableTimeStep'); + end + + function regularLatticeMatchesParametersEstimate(testCase) + params = ldem.Parameters(nModules=[4 3 3]); + mesh = ldem.mesh.buildMesh(params); + critical = ldem.solver.checkStability(mesh.barLength, params); + testCase.verifyEqual(critical, params.criticalTimeStep, 'RelTol', 1e-12); + end + end +end From 08d87f7a8c2957029a1be15c701f019ccdb84fe6 Mon Sep 17 00:00:00 2001 From: Boris Rojo Tanzi <71112604+borisrojotanzi@users.noreply.github.com> Date: Thu, 5 Nov 2026 15:33:37 -0300 Subject: [PATCH 03/13] feat(material): add bar stiffness, critical strain and bilinear law --- CHANGELOG.md | 4 + docs/source/api/index.rst | 11 ++ legacy/KNOWN_ISSUES.md | 14 +- src/+ldem/+io/readRandomField.m | 55 +++++++ src/+ldem/+material/bilinearLaw.m | 107 +++++++++++++ src/+ldem/+material/buildBarProperties.m | 113 ++++++++++++++ src/+ldem/+material/computeBarStiffness.m | 56 +++++++ src/+ldem/+material/latticeCoefficients.m | 40 +++++ src/+ldem/+mesh/buildBars.m | 53 +++++-- src/+ldem/+mesh/buildMesh.m | 4 +- tests/regression/TestMaterialAgainstLegacy.m | 73 +++++++++ tests/unit/TestBilinearLaw.m | 155 +++++++++++++++++++ tests/unit/TestMaterial.m | 137 ++++++++++++++++ tests/unit/TestMesh.m | 15 ++ tests/unit/TestReadRandomField.m | 51 ++++++ 15 files changed, 872 insertions(+), 16 deletions(-) create mode 100644 src/+ldem/+io/readRandomField.m create mode 100644 src/+ldem/+material/bilinearLaw.m create mode 100644 src/+ldem/+material/buildBarProperties.m create mode 100644 src/+ldem/+material/computeBarStiffness.m create mode 100644 src/+ldem/+material/latticeCoefficients.m create mode 100644 tests/regression/TestMaterialAgainstLegacy.m create mode 100644 tests/unit/TestBilinearLaw.m create mode 100644 tests/unit/TestMaterial.m create mode 100644 tests/unit/TestReadRandomField.m diff --git a/CHANGELOG.md b/CHANGELOG.md index 00245ad..c417f21 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -16,6 +16,10 @@ legacy fixtures: `ldem.Parameters` (validated input), `ldem.io.readInputFile`, `ldem.mesh.*` (nodes, bars, masses, geometry, optional perturbation), `ldem.scenarios.*` (test cases 101 and 102) and `ldem.solver.checkStability`. +- Material model in `ldem.material`: lattice coefficients, bar stiffness by bar + type, critical strain with optional random field (`ldem.io.readRandomField`), + and the bilinear constitutive law as a pure function (`bilinearLaw`). + `ldem.mesh.buildBars` now also returns the bar type and boundary faces. - Unit tests (`tests/unit`) and a regression test that compares the new mesh with the legacy one (`tests/regression/TestMeshAgainstLegacy`). diff --git a/docs/source/api/index.rst b/docs/source/api/index.rst index 56c4d6c..3a33486 100644 --- a/docs/source/api/index.rst +++ b/docs/source/api/index.rst @@ -21,6 +21,7 @@ Parameters / Parámetros .. mat:module:: ldem.io .. mat:autofunction:: ldem.io.readInputFile +.. mat:autofunction:: ldem.io.readRandomField Mesh / Malla ~~~~~~~~~~~~ @@ -34,6 +35,16 @@ Mesh / Malla .. mat:autofunction:: ldem.mesh.computeNodalMasses .. mat:autofunction:: ldem.mesh.computeBarGeometry +Material / Material +~~~~~~~~~~~~~~~~~~~ + +.. mat:module:: ldem.material + +.. mat:autofunction:: ldem.material.latticeCoefficients +.. mat:autofunction:: ldem.material.computeBarStiffness +.. mat:autofunction:: ldem.material.buildBarProperties +.. mat:autofunction:: ldem.material.bilinearLaw + Scenarios / Escenarios de ensayo ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ diff --git a/legacy/KNOWN_ISSUES.md b/legacy/KNOWN_ISSUES.md index 896ae11..4c47612 100644 --- a/legacy/KNOWN_ISSUES.md +++ b/legacy/KNOWN_ISSUES.md @@ -39,4 +39,16 @@ code** (each one has a test that documents the decision). *New code:* scenario parameters. 6. **`IMPERF.m`: `LABELN` is set to 1 and then immediately to 0,** so the mesh perturbation is never applied (the random generator seed has no effect). -7. **Preallocation `INT = 168000`, `INB = 2300000`** limits the mesh size. +7. **`CALCOEV.m`: the coefficient of variation is never stored.** + It computes `COEF = std(EP)/MEAN` but the global variable is `COEV`, which + therefore stays 0 (and is printed as 0 in the input echo). + *New code:* `barProps.criticalStrainCv` holds the real value. +8. **`DEFEP.m`: unused safety check.** `DEFEP` stops when `KR < 1.01`, but + `RMEC` no longer calls it (the formulas are inlined), so the check never + runs and the softening branch could divide by `KR - 1 ~ 0`. + *New code:* `buildBarProperties` raises `ldem:material:criticalLengthTooShort`. +9. **Random field is mandatory.** The main program fails if the file + `arquivo_3lc_rnao_cv05` is missing, with no way to run a homogeneous + material. *New code:* `params.randomFieldFile` is optional (empty = all + multipliers equal to 1). +10. **Preallocation `INT = 168000`, `INB = 2300000`** limits the mesh size. diff --git a/src/+ldem/+io/readRandomField.m b/src/+ldem/+io/readRandomField.m new file mode 100644 index 0000000..4b80bf9 --- /dev/null +++ b/src/+ldem/+io/readRandomField.m @@ -0,0 +1,55 @@ +function field = readRandomField(path, nBars) +%READRANDOMFIELD Read the random field that scatters the critical strain. +% +% field = ldem.io.readRandomField(path, nBars) reads the first nBars +% numbers of a text file with one value per line (or separated by +% blanks). Each value multiplies the critical strain of the bar with the +% same number, so the material is not perfectly homogeneous. +% +% The file may be longer than nBars; the extra values are ignored. +% +% Inputs: +% path Path of the text file. +% nBars Number of bars of the mesh. +% +% Output: +% field nBars-by-1 vector of positive multipliers. +% +% Errors: +% ldem:io:fileNotFound The file does not exist. +% ldem:io:randomFieldTooShort The file has fewer than nBars values. +% ldem:io:randomFieldInvalid A value is not finite and positive. +% +% Example: +% field = ldem.io.readRandomField("examples/beam_102/arquivo_3lc_rnao_cv05", 6221); +% +% Legacy: the loop that reads "arquivo_3lc_rnao_cv05" in the main program. +% +% See also ldem.material.buildBarProperties. + +arguments + path (1,1) string + nBars (1,1) double {mustBeInteger, mustBePositive} +end + +if ~isfile(path) + error('ldem:io:fileNotFound', 'Random field file "%s" does not exist.', path); +end + +fid = fopen(path, 'r'); +if fid == -1 + error('ldem:io:cannotOpenFile', 'Cannot open random field file "%s".', path); +end +closer = onCleanup(@() fclose(fid)); +field = fscanf(fid, '%f', nBars); + +if numel(field) < nBars + error('ldem:io:randomFieldTooShort', ... + '"%s" has %d values but the mesh has %d bars.', path, numel(field), nBars); +end +if any(~isfinite(field) | field <= 0) + error('ldem:io:randomFieldInvalid', ... + '"%s" contains values that are not finite and positive (first one: value %d).', ... + path, find(~isfinite(field) | field <= 0, 1)); +end +end diff --git a/src/+ldem/+material/bilinearLaw.m b/src/+ldem/+material/bilinearLaw.m new file mode 100644 index 0000000..35fed6f --- /dev/null +++ b/src/+ldem/+material/bilinearLaw.m @@ -0,0 +1,107 @@ +function [force, history] = bilinearLaw(strain, strainRate, barProps, history, constitutiveDamping) +%BILINEARLAW Axial force of the bars: elastic, softening and rupture. +% +% [force, history] = ldem.material.bilinearLaw(strain, strainRate, ... +% barProps, history, constitutiveDamping) evaluates the constitutive law +% of all bars at once and updates their damage state. +% +% The force follows one of four branches, chosen per bar: +% +% 1. Rupture strain >= ER: force is zero, the bar is broken for +% good (tension stiffness becomes zero). +% 2. Softening strain >= EM (a new largest strain, above EP): the +% force decreases linearly with strain, reaching zero +% at ER. The tension stiffness becomes the secant +% stiffness F/strain and EM is updated. +% 3. Tension 0 <= strain < EM: linear with the current tension +% stiffness E2. This is the elastic response of an +% undamaged bar and the unloading/reloading of a damaged +% one (damage is irreversible). +% 4. Compression strain < 0: linear with stiffness E1, damage has no +% effect (contact). +% +% A viscous term stiffness*constitutiveDamping*strainRate is added in +% branches 2, 3 and 4. +% +% Inputs: +% strain nBars-by-1 axial strains (tension positive). +% strainRate nBars-by-1 strain rates [1/s]. +% barProps Struct from ldem.material.buildBarProperties. +% history Damage state of the previous call or the initial one. +% constitutiveDamping Damping coefficient [s] (params.constitutiveDamping). +% +% Outputs: +% force nBars-by-1 axial forces [N], tension positive. +% history Updated damage state. +% +% Example: +% [barProps, history] = ldem.material.buildBarProperties(mesh, params); +% damping = params.constitutiveDamping; +% [force, history] = ldem.material.bilinearLaw(strain, rate, barProps, history, damping); +% +% Legacy: the constitutive branches inside CABAR (and CONSTIT). +% +% See also ldem.material.buildBarProperties. + +arguments + strain (:,1) double + strainRate (:,1) double + barProps (1,1) struct + history (1,1) struct + constitutiveDamping (1,1) double {mustBeNonnegative} +end + +nBars = numel(strain); +if numel(strainRate) ~= nBars || numel(barProps.stiffness) ~= nBars + error('ldem:material:sizeMismatch', ... + 'strain (%d), strainRate (%d) and the bar properties (%d) must have one entry per bar.', ... + nBars, numel(strainRate), numel(barProps.stiffness)); +end + +E1 = barProps.stiffness; +EP = barProps.criticalStrain; +KR = barProps.ruptureRatio; +ER = KR .* EP; + +E2 = history.tensionStiffness; +EM = history.maxStrain; +isUndamaged = history.isUndamaged; +isUnbroken = history.isUnbroken; + +% Select the branch of every bar. The branches are mutually exclusive. +broken = strain >= ER; +softening = ~broken & (strain >= EM); +tension = ~broken & ~softening & (strain >= 0.0); +compression = ~broken & ~softening & ~tension; + +force = zeros(nBars, 1); + +% 1. Rupture. +E2(broken) = 0.0; +EM(broken) = ER(broken); +isUndamaged(broken & isUnbroken) = false; +isUnbroken(broken) = false; +% force stays 0. + +% 2. Softening. +s = softening; +aux = (strain(s) - EP(s)) ./ (KR(s) - 1.0); +aux = E1(s) .* (EP(s) - aux); +E2(s) = aux ./ strain(s); +EM(s) = strain(s); +force(s) = aux + E2(s) .* constitutiveDamping .* strainRate(s); +isUndamaged(s) = false; + +% 3. Tension (elastic or unloading). +t = tension; +force(t) = E2(t) .* strain(t) + E2(t) .* constitutiveDamping .* strainRate(t); + +% 4. Compression. +c = compression; +force(c) = E1(c) .* strain(c) + E1(c) .* constitutiveDamping .* strainRate(c); + +history.tensionStiffness = E2; +history.maxStrain = EM; +history.isUndamaged = isUndamaged; +history.isUnbroken = isUnbroken; +end diff --git a/src/+ldem/+material/buildBarProperties.m b/src/+ldem/+material/buildBarProperties.m new file mode 100644 index 0000000..5c41d98 --- /dev/null +++ b/src/+ldem/+material/buildBarProperties.m @@ -0,0 +1,113 @@ +function [barProps, history] = buildBarProperties(mesh, params, options) +%BUILDBARPROPERTIES Material properties and initial damage state of every bar. +% +% [barProps, history] = ldem.material.buildBarProperties(mesh, params) +% computes everything the constitutive law of the bars needs. +% +% Every bar behaves as follows (see ldem.material.bilinearLaw): linear +% elastic with stiffness E1 up to the critical strain EP, then linear +% softening down to zero force at the rupture strain ER = KR*EP. The +% fracture energy is what fixes EP and KR: +% +% EP0 = sqrt(Gf / (E * deq)) critical strain +% Lcr = 2 * deq * CAF / alpha critical length +% KR = Lcr / L rupture strain / critical strain +% +% with the material data of ldem.Parameters, the failure-area factor CAF +% and the lattice coefficient alpha. EP is EP0 times a random field when +% params.randomFieldFile is set. +% +% Inputs: +% mesh Struct from ldem.mesh.buildMesh. +% params ldem.Parameters. +% +% Name-value options: +% RandomField nBars-by-1 vector of multipliers of the critical strain. +% Overrides params.randomFieldFile. Default: use the file +% if there is one, otherwise all ones. +% +% Outputs: +% barProps Struct of properties that stay constant during the simulation. +% history Struct with the initial damage state of every bar. +% +% Fields of barProps (nBars-by-1 unless stated otherwise): +% +% stiffness E1, axial stiffness [N] +% criticalStrain EP, strain at which damage starts +% ruptureRatio KR, ratio between rupture and critical strain +% ruptureStrain ER = KR*EP, strain at which the bar breaks +% criticalStrainMean scalar, mean of EP +% criticalStrainCv scalar, coefficient of variation of EP +% +% Fields of history (nBars-by-1), updated by ldem.material.bilinearLaw: +% +% tensionStiffness E2, secant stiffness in tension (starts at E1) +% maxStrain EM, largest strain reached (starts at EP) +% isUndamaged DM, false once the bar has started to soften +% isUnbroken FS, false once the bar has broken +% +% Errors: +% ldem:material:criticalLengthTooShort KR is below 1.01 for some bar; +% the softening branch needs KR > 1. Increase params.criticalDistance +% or reduce params.moduleLength. +% +% Example: +% params = ldem.Parameters(); +% mesh = ldem.mesh.buildMesh(params); +% [barProps, history] = ldem.material.buildBarProperties(mesh, params); +% +% Legacy: NAYFES0, RMEC, the random-field loop of the main program, CALCOEV. +% +% See also ldem.material.bilinearLaw, ldem.material.computeBarStiffness, +% ldem.io.readRandomField. + +arguments + mesh (1,1) struct + params (1,1) ldem.Parameters + options.RandomField (:,1) double = [] +end + +nBars = numel(mesh.barLength); +[~, alpha] = ldem.material.latticeCoefficients(params.poissonRatio); + +stiffness = ldem.material.computeBarStiffness(mesh, params); + +baseCriticalStrain = sqrt(params.fractureEnergy ./ (params.youngModulus .* params.criticalDistance)); +criticalLength = params.criticalDistance * 2.0 * params.failureAreaFactor / alpha; +ruptureRatio = criticalLength ./ mesh.barLength; + +if any(ruptureRatio < 1.01) + error('ldem:material:criticalLengthTooShort', ... + ['The critical length (%g m) is too short compared with the bar length ' ... + '(%g m): rupture ratio KR = %g < 1.01. Increase criticalDistance or ' ... + 'reduce moduleLength.'], criticalLength, max(mesh.barLength), min(ruptureRatio)); +end + +% Random scatter of the critical strain. +if ~isempty(options.RandomField) + field = options.RandomField; +elseif strlength(params.randomFieldFile) > 0 + field = ldem.io.readRandomField(params.randomFieldFile, nBars); +else + field = ones(nBars, 1); +end +if numel(field) ~= nBars + error('ldem:material:randomFieldSize', ... + 'The random field has %d values but the mesh has %d bars.', numel(field), nBars); +end +criticalStrain = field .* baseCriticalStrain; + +barProps = struct(); +barProps.stiffness = stiffness; +barProps.criticalStrain = criticalStrain; +barProps.ruptureRatio = ruptureRatio; +barProps.ruptureStrain = ruptureRatio .* criticalStrain; +barProps.criticalStrainMean = mean(criticalStrain); +barProps.criticalStrainCv = std(criticalStrain) / mean(criticalStrain); + +history = struct(); +history.tensionStiffness = stiffness; +history.maxStrain = criticalStrain; +history.isUndamaged = true(nBars, 1); +history.isUnbroken = true(nBars, 1); +end diff --git a/src/+ldem/+material/computeBarStiffness.m b/src/+ldem/+material/computeBarStiffness.m new file mode 100644 index 0000000..70f8bf2 --- /dev/null +++ b/src/+ldem/+material/computeBarStiffness.m @@ -0,0 +1,56 @@ +function stiffness = computeBarStiffness(mesh, params) +%COMPUTEBARSTIFFNESS Axial stiffness of every bar of the lattice. +% +% stiffness = ldem.material.computeBarStiffness(mesh, params) returns the +% stiffness E1 [N] of each bar, defined so that the axial force is +% force = stiffness * strain. +% +% The reference value of an edge bar is EA = alpha*E*L^2 (L = bar +% length, see ldem.material.latticeCoefficients). It is modified by the +% type of bar (ldem.mesh.buildBars): +% +% * Grid edges inside the prism: EA. +% * Grid edges on a face of the prism: EA/2 (they are shared by fewer +% modules); on an edge of the prism: EA/4. +% * Centre-to-centre bars: EA. +% * Diagonals: EA * 2*delta*(4/3)/sqrt(3). +% +% Inputs: +% mesh Struct from ldem.mesh.buildMesh. +% params ldem.Parameters (uses youngModulus and poissonRatio). +% +% mesh must contain barLength, barType and barBoundaryFaces. +% +% Output: +% stiffness nBars-by-1 vector [N]. +% +% Example: +% params = ldem.Parameters(); +% mesh = ldem.mesh.buildMesh(params); +% E1 = ldem.material.computeBarStiffness(mesh, params); +% +% Legacy: NAYFES0 (ENR, EDG) and RMEC, RMECEX, RMECIN, RMECDI, DEFEP (E1). +% +% See also ldem.material.latticeCoefficients, ldem.material.buildBarProperties. + +arguments + mesh (1,1) struct + params (1,1) ldem.Parameters +end + +[delta, alpha] = ldem.material.latticeCoefficients(params.poissonRatio); + +edgeStiffness = (params.youngModulus .* (mesh.barLength .^ 2)) .* alpha; +diagonalFactor = (2.0 * delta * (4.0 / 3.0)) / sqrt(3.0); +diagonalStiffness = edgeStiffness * diagonalFactor; + +% Reduction of the grid edges that lie on the surface of the prism: +% 0 faces -> 1, 1 face -> 1/2, 2 faces (an edge of the prism) -> 1/4. +reduction = ones(size(edgeStiffness)); +reduction(mesh.barBoundaryFaces == 1) = 0.50; +reduction(mesh.barBoundaryFaces >= 2) = 0.25; + +stiffness = edgeStiffness .* reduction; % grid edges +stiffness(mesh.barType == 2) = edgeStiffness(mesh.barType == 2); % centre-to-centre +stiffness(mesh.barType == 3) = diagonalStiffness(mesh.barType == 3); % diagonals +end diff --git a/src/+ldem/+material/latticeCoefficients.m b/src/+ldem/+material/latticeCoefficients.m new file mode 100644 index 0000000..27a8730 --- /dev/null +++ b/src/+ldem/+material/latticeCoefficients.m @@ -0,0 +1,40 @@ +function [delta, alpha] = latticeCoefficients(poissonRatio) +%LATTICECOEFFICIENTS Coefficients that make the lattice equivalent to a continuum. +% +% [delta, alpha] = ldem.material.latticeCoefficients(poissonRatio) +% returns the two coefficients of the Nayfeh-Hefzy equivalence between the +% cubic lattice (edges plus diagonals) and an isotropic elastic continuum +% with the given Poisson's ratio: +% +% delta = 9*nu / (4 - 8*nu) +% alpha = (9 + 8*delta) / (18 + 24*delta) +% +% alpha scales the stiffness of the edge bars, EA = alpha*E*L^2, and delta +% scales the diagonals relative to the edges. +% +% Input: +% poissonRatio Poisson's ratio, 0 <= nu < 0.5. +% +% Outputs: +% delta, alpha Dimensionless coefficients. +% +% Example: +% [delta, alpha] = ldem.material.latticeCoefficients(0.25); +% % delta = 1.125, alpha = 0.4 +% +% Legacy: first lines of NAYFES0. +% +% See also ldem.material.computeBarStiffness. + +arguments + poissonRatio (1,1) double {mustBeNonnegative, mustBeFinite} +end + +if poissonRatio >= 0.5 + error('ldem:params:badPoissonRatio', ... + 'poissonRatio must be smaller than 0.5, got %g.', poissonRatio); +end + +delta = 9.0 * poissonRatio / (4.0 - 8.0 * poissonRatio); +alpha = (9.0 + 8.0 * delta) / (18.0 + 24.0 * delta); +end diff --git a/src/+ldem/+mesh/buildBars.m b/src/+ldem/+mesh/buildBars.m index c9c2e75..61cd7c2 100644 --- a/src/+ldem/+mesh/buildBars.m +++ b/src/+ldem/+mesh/buildBars.m @@ -1,9 +1,13 @@ -function bars = buildBars(nModules) -%BUILDBARS Connectivity of the bars of the lattice. +function [bars, barType, boundaryFaces] = buildBars(nModules) +%BUILDBARS Connectivity and classification of the bars of the lattice. % % bars = ldem.mesh.buildBars(nModules) returns, for every bar, the numbers % of its two end nodes. Node numbering is the one of ldem.mesh.buildNodes. % +% [bars, barType, boundaryFaces] = ldem.mesh.buildBars(nModules) also +% classifies each bar, which the material model needs to assign +% stiffness. +% % Each cubic module has 12 edges, shared with its neighbours, plus 8 % diagonals that join the centre node to the 8 corners. The bars are % listed in this order: @@ -16,16 +20,23 @@ % Input: % nModules [M N L], integers >= 2. % -% Output: -% bars nBars-by-2 matrix of node numbers [startNode endNode]. +% Outputs: +% bars nBars-by-2 matrix of node numbers [startNode endNode]. +% barType nBars-by-1 codes: 1 grid edge, 2 centre bar, 3 diagonal. +% boundaryFaces nBars-by-1 faces of the prism a grid edge lies on (0, 1, 2). +% +% boundaryFaces is 0 for a grid edge inside the prism, 1 for one on a face +% and 2 for one on an edge of the prism. It is 0 for the other bar types. % % Example: % bars = ldem.mesh.buildBars([2 2 2]); % size(bars, 1) % 12 edges + 8 diagonals = 20 bars % -% Legacy: CONECTI, EXTCO1, INTCO1, DIACO1. +% Legacy: CONECTI, EXTCO1, INTCO1, DIACO1 (connectivity) and the +% TYPES counter of RMECEX (classification). % -% See also ldem.mesh.buildNodes, ldem.mesh.computeBarGeometry. +% See also ldem.mesh.buildNodes, ldem.mesh.computeBarGeometry, +% ldem.material.buildBarProperties. arguments nModules (1,3) double {mustBeInteger, mustBeGreaterThanOrEqual(nModules, 2)} @@ -35,17 +46,19 @@ M1 = M - 1; N1 = N - 1; L1 = L - 1; nGrid = M * N * L; -% Grid-edge bars: node (i,j,k) joined to its neighbour along one axis. +% Grid-edge bars: node (i,j,k) joined to its neighbour along one axis. A bar +% along x lies on the surface of the prism when its j or k index is on a +% boundary, and so on for the other axes. gridNode = @(i, j, k) (k - 1) * M * N + (j - 1) * M + i; -edgesX = edgeBars(gridNode, M1, N, L, 1); -edgesY = edgeBars(gridNode, M, N1, L, M); -edgesZ = edgeBars(gridNode, M, N, L1, M * N); +[edgesX, facesX] = edgeBars(gridNode, M1, N, L, 1, [M N L], [false true true]); +[edgesY, facesY] = edgeBars(gridNode, M, N1, L, M, [M N L], [true false true]); +[edgesZ, facesZ] = edgeBars(gridNode, M, N, L1, M * N, [M N L], [true true false]); % Centre-to-centre bars: centre (i,j,k) joined to its neighbour. centreNode = @(i, j, k) nGrid + (k - 1) * M1 * N1 + (j - 1) * M1 + i; -centresX = edgeBars(centreNode, M - 2, N1, L1, 1); -centresY = edgeBars(centreNode, M1, N - 2, L1, M1); -centresZ = edgeBars(centreNode, M1, N1, L - 2, M1 * N1); +[centresX, ~] = edgeBars(centreNode, M - 2, N1, L1, 1, [M N L], [false false false]); +[centresY, ~] = edgeBars(centreNode, M1, N - 2, L1, M1, [M N L], [false false false]); +[centresZ, ~] = edgeBars(centreNode, M1, N1, L - 2, M1 * N1, [M N L], [false false false]); % Diagonals: centre of every module to its 8 corners. [i, j, k] = ndgrid(1:M1, 1:N1, 1:L1); @@ -57,11 +70,23 @@ diagonals = [starts(:), corners(:)]; bars = [edgesX; edgesY; edgesZ; centresX; centresY; centresZ; diagonals]; + +nGridEdges = size(edgesX, 1) + size(edgesY, 1) + size(edgesZ, 1); +nCentreBars = size(centresX, 1) + size(centresY, 1) + size(centresZ, 1); +barType = [ones(nGridEdges, 1); 2 * ones(nCentreBars, 1); 3 * ones(size(diagonals, 1), 1)]; +boundaryFaces = [facesX; facesY; facesZ; zeros(nCentreBars + size(diagonals, 1), 1)]; end -function bars = edgeBars(nodeNumber, nx, ny, nz, stride) +function [bars, boundaryFaces] = edgeBars(nodeNumber, nx, ny, nz, stride, nModules, countAxes) %EDGEBARS Bars [n, n+stride] for every node n of an nx-by-ny-by-nz block. +% +% boundaryFaces counts, over the axes flagged in countAxes, how many of the +% indices i, j, k lie on the first or last node of the prism. [i, j, k] = ndgrid(1:nx, 1:ny, 1:nz); first = nodeNumber(i(:), j(:), k(:)); bars = [first, first + stride]; + +index = [i(:), j(:), k(:)]; +onBoundary = index == 1 | index == nModules; % implicit expansion over columns +boundaryFaces = sum(onBoundary(:, countAxes), 2); end diff --git a/src/+ldem/+mesh/buildMesh.m b/src/+ldem/+mesh/buildMesh.m index 87ed000..4b27e72 100644 --- a/src/+ldem/+mesh/buildMesh.m +++ b/src/+ldem/+mesh/buildMesh.m @@ -18,6 +18,8 @@ % fixed nNodes-by-3 logical, true where the motion is fixed % mass nNodes-by-1 lumped masses [kg] % bars nBars-by-2 end-node numbers +% barType nBars-by-1 codes: 1 grid edge, 2 centre-to-centre, 3 diagonal +% barBoundaryFaces nBars-by-1 prism faces a grid edge lies on (0, 1 or 2) % barLength nBars-by-1 initial lengths [m] % barCentres nBars-by-3 midpoints [m] % @@ -48,6 +50,6 @@ mesh.fixed = scenario.fixedDofs(nodes, params); mesh.mass = ldem.mesh.computeNodalMasses(params.nModules, ... params.moduleLength, params.density); -mesh.bars = ldem.mesh.buildBars(params.nModules); +[mesh.bars, mesh.barType, mesh.barBoundaryFaces] = ldem.mesh.buildBars(params.nModules); [mesh.barLength, mesh.barCentres] = ldem.mesh.computeBarGeometry(nodes, mesh.bars); end diff --git a/tests/regression/TestMaterialAgainstLegacy.m b/tests/regression/TestMaterialAgainstLegacy.m new file mode 100644 index 0000000..ea6075e --- /dev/null +++ b/tests/regression/TestMaterialAgainstLegacy.m @@ -0,0 +1,73 @@ +classdef TestMaterialAgainstLegacy < LdemTestCase + %TESTMATERIALAGAINSTLEGACY The new bar properties equal the legacy ones. + % + % Compares ldem.material.buildBarProperties with the stiffness, + % critical strain, rupture ratio and statistics stored in the + % golden-master fixtures. The legacy random field file is used, so + % the comparison also covers the scatter of the critical strain. + % + % For the elastic case no bar ever softens, so the damage state at the + % end of the legacy run is still the initial one and it is compared + % too. + % + % See also TestMeshAgainstLegacy, generateReference. + + properties (TestParameter) + caseName = {'tension101_elastic', 'tension101_damage', 'bending102'} + end + + methods (Test, TestTags = {'Regression'}) + function barPropertiesMatchLegacy(testCase, caseName) + [fixture, params] = testCase.loadCase(caseName); + s = fixture.state; + mesh = ldem.mesh.buildMesh(params); + + [props, ~] = ldem.material.buildBarProperties(mesh, params); + + tight = {'RelTol', 1e-14, 'AbsTol', 1e-30}; + testCase.verifyEqual(props.stiffness, s.E1(:), tight{:}); + testCase.verifyEqual(props.criticalStrain, s.EP(:), tight{:}); + testCase.verifyEqual(props.ruptureRatio, s.KR(:), tight{:}); + testCase.verifyEqual(props.criticalStrainMean, s.MEAN, tight{:}); + end + + function initialStateMatchesLegacyWhenNothingDamaged(testCase) + [fixture, params] = testCase.loadCase('tension101_elastic'); + s = fixture.state; + mesh = ldem.mesh.buildMesh(params); + [~, history] = ldem.material.buildBarProperties(mesh, params); + + tight = {'RelTol', 1e-14, 'AbsTol', 1e-30}; + testCase.verifyEqual(history.tensionStiffness, s.E2(:), tight{:}); + testCase.verifyEqual(history.maxStrain, s.EM(:), tight{:}); + testCase.verifyEqual(history.isUndamaged, logical(s.DM(:))); + testCase.verifyEqual(history.isUnbroken, logical(s.FS(:))); + end + end + + methods (Access = private) + function [fixture, params] = loadCase(testCase, caseName) + fixture = load(fullfile(testCase.RepoRoot, 'tests', 'fixtures', caseName + ".mat")); + c = fixture.caseDef; + fieldFile = fullfile(testCase.RepoRoot, 'examples', 'beam_102', 'arquivo_3lc_rnao_cv05'); + params = ldem.Parameters( ... + testId = c.test, ... + seed = c.seed, ... + moduleLength = c.moduleLength, ... + nModules = c.modules, ... + dampingInitial = c.damping1, ... + dampingFinal = c.damping2, ... + dampingSwitchTime = c.dampingSwitchTime, ... + constitutiveDamping = c.con, ... + dt = c.dt, ... + totalTime = c.nSteps * c.dt, ... + controlNodes = c.controlNodes, ... + youngModulus = c.youngModulus, ... + density = c.density, ... + poissonRatio = c.poisson, ... + fractureEnergy = c.fractureEnergy, ... + criticalDistance = c.criticalDistance, ... + randomFieldFile = fieldFile); + end + end +end diff --git a/tests/unit/TestBilinearLaw.m b/tests/unit/TestBilinearLaw.m new file mode 100644 index 0000000..fe45eaf --- /dev/null +++ b/tests/unit/TestBilinearLaw.m @@ -0,0 +1,155 @@ +classdef TestBilinearLaw < LdemTestCase + %TESTBILINEARLAW Unit tests of ldem.material.bilinearLaw with hand-made bars. + % + % One bar with stiffness E1 = 100 N, critical strain EP = 1e-3 and + % rupture ratio KR = 5, so the rupture strain is ER = 5e-3. The + % expected forces are computed by hand from the law: + % softening force = E1 * (EP - (strain - EP)/(KR - 1)) + + properties (Constant) + E1 = 100 + EP = 1e-3 + KR = 5 + end + + methods (Access = private) + function [props, history] = makeBars(testCase, n) + props = struct( ... + 'stiffness', repmat(testCase.E1, n, 1), ... + 'criticalStrain', repmat(testCase.EP, n, 1), ... + 'ruptureRatio', repmat(testCase.KR, n, 1), ... + 'ruptureStrain', repmat(testCase.KR * testCase.EP, n, 1)); + history = struct( ... + 'tensionStiffness', repmat(testCase.E1, n, 1), ... + 'maxStrain', repmat(testCase.EP, n, 1), ... + 'isUndamaged', true(n, 1), ... + 'isUnbroken', true(n, 1)); + end + end + + methods (Test, TestTags = {'Unit'}) + function elasticTensionBelowCriticalStrain(testCase) + [props, history] = testCase.makeBars(1); + [force, after] = ldem.material.bilinearLaw(5e-4, 0, props, history, 0); + testCase.verifyEqual(force, 100 * 5e-4, 'RelTol', 1e-14); + testCase.verifyEqual(after, history, 'An elastic bar must not change state.'); + end + + function compressionIsAlwaysElastic(testCase) + [props, history] = testCase.makeBars(1); + [force, after] = ldem.material.bilinearLaw(-0.02, 0, props, history, 0); + testCase.verifyEqual(force, 100 * -0.02, 'RelTol', 1e-14); + testCase.verifyEqual(after, history); + end + + function softeningFollowsTheDescendingLine(testCase) + [props, history] = testCase.makeBars(1); + strain = 2e-3; + expected = 100 * (1e-3 - (strain - 1e-3) / 4); % 0.075 + [force, after] = ldem.material.bilinearLaw(strain, 0, props, history, 0); + + testCase.verifyEqual(force, expected, 'RelTol', 1e-12); + testCase.verifyEqual(after.tensionStiffness, expected / strain, 'RelTol', 1e-12); + testCase.verifyEqual(after.maxStrain, strain); + testCase.verifyFalse(after.isUndamaged); + testCase.verifyTrue(after.isUnbroken); + end + + function forceIsContinuousAtTheCriticalStrain(testCase) + [props, history] = testCase.makeBars(1); + elastic = ldem.material.bilinearLaw(1e-3 * (1 - 1e-9), 0, props, history, 0); + softening = ldem.material.bilinearLaw(1e-3 * (1 + 1e-9), 0, props, history, 0); + testCase.verifyEqual(softening, elastic, 'RelTol', 1e-6); + testCase.verifyEqual(elastic, 100 * 1e-3, 'RelTol', 1e-6); % peak force + end + + function forceVanishesAtTheRuptureStrain(testCase) + [props, history] = testCase.makeBars(1); + force = ldem.material.bilinearLaw(5e-3 * (1 - 1e-9), 0, props, history, 0); + testCase.verifyEqual(force, 0, 'AbsTol', 1e-9); + end + + function unloadingIsLinearTowardTheOrigin(testCase) + [props, history] = testCase.makeBars(1); + [~, history] = ldem.material.bilinearLaw(2e-3, 0, props, history, 0); + peakForce = 0.075; + + [force, after] = ldem.material.bilinearLaw(1e-3, 0, props, history, 0); + testCase.verifyEqual(force, peakForce * (1e-3 / 2e-3), 'RelTol', 1e-12); + testCase.verifyEqual(after.maxStrain, 2e-3, 'Unloading must not reduce maxStrain.'); + testCase.verifyEqual(after.tensionStiffness, history.tensionStiffness); + end + + function reloadingReturnsToTheSofteningLine(testCase) + [props, history] = testCase.makeBars(1); + [f1, history] = ldem.material.bilinearLaw(2e-3, 0, props, history, 0); + [~, history] = ldem.material.bilinearLaw(1e-3, 0, props, history, 0); + f2 = ldem.material.bilinearLaw(2e-3, 0, props, history, 0); + testCase.verifyEqual(f2, f1, 'RelTol', 1e-12); + end + + function ruptureIsPermanent(testCase) + [props, history] = testCase.makeBars(1); + [force, history] = ldem.material.bilinearLaw(6e-3, 0, props, history, 0); + testCase.verifyEqual(force, 0); + testCase.verifyFalse(history.isUnbroken); + testCase.verifyFalse(history.isUndamaged); + testCase.verifyEqual(history.tensionStiffness, 0); + + % A broken bar carries no tension even when the strain goes back down... + force = ldem.material.bilinearLaw(1e-3, 0, props, history, 0); + testCase.verifyEqual(force, 0); + % ...but still resists compression (contact). + force = ldem.material.bilinearLaw(-1e-3, 0, props, history, 0); + testCase.verifyEqual(force, -0.1, 'RelTol', 1e-14); + end + + function viscousTermIsAddedExceptWhenBroken(testCase) + [props, history] = testCase.makeBars(1); + damping = 0.1; rate = 10; + force = ldem.material.bilinearLaw(5e-4, rate, props, history, damping); + testCase.verifyEqual(force, 100 * 5e-4 + 100 * damping * rate, 'RelTol', 1e-14); + + force = ldem.material.bilinearLaw(-5e-4, rate, props, history, damping); + testCase.verifyEqual(force, -100 * 5e-4 + 100 * damping * rate, 'RelTol', 1e-14); + + force = ldem.material.bilinearLaw(6e-3, rate, props, history, damping); + testCase.verifyEqual(force, 0, 'A broken bar has no viscous force either.'); + end + + function vectorizedResultEqualsBarByBar(testCase) + strains = [5e-4; 2e-3; 6e-3; -1e-3; 3e-3]; + rates = [1; -2; 3; 0.5; -1]; + [props, history] = testCase.makeBars(numel(strains)); + + [forceAll, historyAll] = ldem.material.bilinearLaw(strains, rates, props, history, 0.05); + + for k = 1:numel(strains) + [p, h] = testCase.makeBars(1); + [f, hk] = ldem.material.bilinearLaw(strains(k), rates(k), p, h, 0.05); + testCase.verifyEqual(forceAll(k), f); + testCase.verifyEqual(historyAll.tensionStiffness(k), hk.tensionStiffness); + testCase.verifyEqual(historyAll.maxStrain(k), hk.maxStrain); + testCase.verifyEqual(historyAll.isUndamaged(k), hk.isUndamaged); + testCase.verifyEqual(historyAll.isUnbroken(k), hk.isUnbroken); + end + end + + function tensionForceNeverExceedsThePeak(testCase) + [props, history] = testCase.makeBars(1); + strains = linspace(0, 0.01, 200).'; + peak = 100 * 1e-3; + for k = 1:numel(strains) + [f, history] = ldem.material.bilinearLaw(strains(k), 0, props, history, 0); + testCase.verifyLessThanOrEqual(f, peak * (1 + 1e-12)); + end + end + + function sizeMismatchIsReported(testCase) + [props, history] = testCase.makeBars(3); + testCase.verifyError( ... + @() ldem.material.bilinearLaw([1e-3; 2e-3], [0; 0], props, history, 0), ... + 'ldem:material:sizeMismatch'); + end + end +end diff --git a/tests/unit/TestMaterial.m b/tests/unit/TestMaterial.m new file mode 100644 index 0000000..b930008 --- /dev/null +++ b/tests/unit/TestMaterial.m @@ -0,0 +1,137 @@ +classdef TestMaterial < LdemTestCase + %TESTMATERIAL Unit tests of the stiffness and bar-property computation. + + methods (Access = private) + function path = writeNumbers(testCase, values) + folder = testCase.applyFixture( ... + matlab.unittest.fixtures.TemporaryFolderFixture).Folder; + path = fullfile(folder, 'field.txt'); + fid = fopen(path, 'w'); + fprintf(fid, '%.10g\n', values); + fclose(fid); + end + end + + methods (Test, TestTags = {'Unit'}) + function latticeCoefficientsForKnownPoissonRatios(testCase) + [delta, alpha] = ldem.material.latticeCoefficients(0.25); + testCase.verifyEqual(delta, 1.125, 'RelTol', 1e-14); + testCase.verifyEqual(alpha, 0.4, 'RelTol', 1e-14); + + [delta, alpha] = ldem.material.latticeCoefficients(0); + testCase.verifyEqual(delta, 0); + testCase.verifyEqual(alpha, 0.5, 'RelTol', 1e-14); + end + + function latticeCoefficientsRejectIncompressibleLimit(testCase) + testCase.verifyError(@() ldem.material.latticeCoefficients(0.5), ... + 'ldem:params:badPoissonRatio'); + end + + function stiffnessDependsOnTheTypeOfBar(testCase) + params = ldem.Parameters(nModules=[4 4 4]); + mesh = ldem.mesh.buildMesh(params); + E1 = ldem.material.computeBarStiffness(mesh, params); + + [delta, alpha] = ldem.material.latticeCoefficients(params.poissonRatio); + reference = alpha * params.youngModulus * mesh.barLength.^2; + diagonalFactor = 2 * delta * (4/3) / sqrt(3); + + isGrid = mesh.barType == 1; + testCase.verifyEqual(E1(isGrid & mesh.barBoundaryFaces == 0), ... + reference(isGrid & mesh.barBoundaryFaces == 0), 'RelTol', 1e-14); + testCase.verifyEqual(E1(isGrid & mesh.barBoundaryFaces == 1), ... + reference(isGrid & mesh.barBoundaryFaces == 1) / 2, 'RelTol', 1e-14); + testCase.verifyEqual(E1(isGrid & mesh.barBoundaryFaces == 2), ... + reference(isGrid & mesh.barBoundaryFaces == 2) / 4, 'RelTol', 1e-14); + testCase.verifyEqual(E1(mesh.barType == 2), reference(mesh.barType == 2), 'RelTol', 1e-14); + testCase.verifyEqual(E1(mesh.barType == 3), ... + reference(mesh.barType == 3) * diagonalFactor, 'RelTol', 1e-14); + end + + function stiffnessIsPositiveAndScalesWithYoungModulus(testCase) + p1 = ldem.Parameters(nModules=[3 3 3], youngModulus=30e9); + p2 = ldem.Parameters(nModules=[3 3 3], youngModulus=60e9); + mesh = ldem.mesh.buildMesh(p1); + e1 = ldem.material.computeBarStiffness(mesh, p1); + e2 = ldem.material.computeBarStiffness(mesh, p2); + testCase.verifyGreaterThan(min(e1), 0); + testCase.verifyEqual(e2, 2 * e1, 'RelTol', 1e-14); + end + + function barPropertiesWithoutRandomField(testCase) + params = ldem.Parameters(nModules=[3 3 3]); + mesh = ldem.mesh.buildMesh(params); + [props, history] = ldem.material.buildBarProperties(mesh, params); + + nBars = size(mesh.bars, 1); + expectedEP = sqrt(params.fractureEnergy / (params.youngModulus * params.criticalDistance)); + testCase.verifyEqual(props.criticalStrain, repmat(expectedEP, nBars, 1), 'RelTol', 1e-14); + + [~, alpha] = ldem.material.latticeCoefficients(params.poissonRatio); + criticalLength = params.criticalDistance * 2 * params.failureAreaFactor / alpha; + testCase.verifyEqual(props.ruptureRatio, criticalLength ./ mesh.barLength, 'RelTol', 1e-14); + testCase.verifyEqual(props.ruptureStrain, props.ruptureRatio .* props.criticalStrain); + testCase.verifyEqual(props.criticalStrainCv, 0, 'AbsTol', 1e-12); + + testCase.verifyEqual(history.tensionStiffness, props.stiffness); + testCase.verifyEqual(history.maxStrain, props.criticalStrain); + testCase.verifyTrue(all(history.isUndamaged)); + testCase.verifyTrue(all(history.isUnbroken)); + end + + function randomFieldScalesTheCriticalStrain(testCase) + params = ldem.Parameters(nModules=[3 3 3]); + mesh = ldem.mesh.buildMesh(params); + nBars = size(mesh.bars, 1); + field = linspace(0.8, 1.2, nBars).'; + + [base, ~] = ldem.material.buildBarProperties(mesh, params); + [props, history] = ldem.material.buildBarProperties(mesh, params, RandomField=field); + + testCase.verifyEqual(props.criticalStrain, field .* base.criticalStrain, 'RelTol', 1e-14); + testCase.verifyEqual(history.maxStrain, props.criticalStrain); + testCase.verifyEqual(props.criticalStrainMean, mean(props.criticalStrain)); + testCase.verifyEqual(props.criticalStrainCv, ... + std(props.criticalStrain) / mean(props.criticalStrain), 'RelTol', 1e-14); + testCase.verifyGreaterThan(props.criticalStrainCv, 0); + end + + function randomFieldIsReadFromTheParametersFile(testCase) + probe = ldem.Parameters(nModules=[3 3 3]); + nBars = size(ldem.mesh.buildBars(probe.nModules), 1); + field = 1 + 0.1 * sin((1:nBars).'); + path = testCase.writeNumbers(field); + + params = ldem.Parameters(nModules=[3 3 3], randomFieldFile=path); + mesh = ldem.mesh.buildMesh(params); + [props, ~] = ldem.material.buildBarProperties(mesh, params); + [base, ~] = ldem.material.buildBarProperties(mesh, probe); + testCase.verifyEqual(props.criticalStrain, field .* base.criticalStrain, 'RelTol', 1e-9); + end + + function randomFieldOfWrongSizeIsRejected(testCase) + params = ldem.Parameters(nModules=[3 3 3]); + mesh = ldem.mesh.buildMesh(params); + testCase.verifyError( ... + @() ldem.material.buildBarProperties(mesh, params, RandomField=ones(5, 1)), ... + 'ldem:material:randomFieldSize'); + end + + function tooShortCriticalLengthIsRejected(testCase) + params = ldem.Parameters(nModules=[3 3 3], criticalDistance=0.001); + mesh = ldem.mesh.buildMesh(params); + testCase.verifyError(@() ldem.material.buildBarProperties(mesh, params), ... + 'ldem:material:criticalLengthTooShort'); + end + + function longerFractureEnergyDelaysDamage(testCase) + lowG = ldem.Parameters(nModules=[3 3 3], fractureEnergy=10); + highG = ldem.Parameters(nModules=[3 3 3], fractureEnergy=40); + mesh = ldem.mesh.buildMesh(lowG); + a = ldem.material.buildBarProperties(mesh, lowG); + b = ldem.material.buildBarProperties(mesh, highG); + testCase.verifyEqual(b.criticalStrain, 2 * a.criticalStrain, 'RelTol', 1e-12); + end + end +end diff --git a/tests/unit/TestMesh.m b/tests/unit/TestMesh.m index 0a9f5a1..853efde 100644 --- a/tests/unit/TestMesh.m +++ b/tests/unit/TestMesh.m @@ -36,6 +36,21 @@ function barCount(testCase, sizes) testCase.verifySize(bars, [gridEdges + centreBars + diagonals, 2]); end + function barClassification(testCase) + % In a 4x4x4 prism: 144 grid edges (36 inside, 72 on faces, 36 on + % prism edges), 3*2*3*3 = 54 centre bars and 8*27 = 216 diagonals. + [bars, type, faces] = ldem.mesh.buildBars([4 4 4]); + testCase.verifySize(type, [size(bars, 1) 1]); + testCase.verifySize(faces, [size(bars, 1) 1]); + testCase.verifyEqual(nnz(type == 1), 144); + testCase.verifyEqual(nnz(type == 2), 54); + testCase.verifyEqual(nnz(type == 3), 216); + testCase.verifyEqual(nnz(type == 1 & faces == 0), 36); + testCase.verifyEqual(nnz(type == 1 & faces == 1), 72); + testCase.verifyEqual(nnz(type == 1 & faces == 2), 36); + testCase.verifyTrue(all(faces(type ~= 1) == 0)); + end + function singleModuleHasTwentyBars(testCase) bars = ldem.mesh.buildBars([2 2 2]); testCase.verifySize(bars, [20 2]); diff --git a/tests/unit/TestReadRandomField.m b/tests/unit/TestReadRandomField.m new file mode 100644 index 0000000..2c48b6d --- /dev/null +++ b/tests/unit/TestReadRandomField.m @@ -0,0 +1,51 @@ +classdef TestReadRandomField < LdemTestCase + %TESTREADRANDOMFIELD Unit tests of ldem.io.readRandomField. + + methods (Access = private) + function path = writeText(testCase, text) + folder = testCase.applyFixture( ... + matlab.unittest.fixtures.TemporaryFolderFixture).Folder; + path = fullfile(folder, 'field.txt'); + fid = fopen(path, 'w'); + fprintf(fid, '%s', text); + fclose(fid); + end + end + + methods (Test, TestTags = {'Unit'}) + function readsTheRequestedNumberOfValues(testCase) + path = testCase.writeText(sprintf('0.5\n1.0\n1.5\n2.0\n')); + field = ldem.io.readRandomField(path, 3); + testCase.verifyEqual(field, [0.5; 1.0; 1.5]); + end + + function acceptsValuesSeparatedByBlanks(testCase) + path = testCase.writeText('0.9 1.1 1.0'); + testCase.verifyEqual(ldem.io.readRandomField(path, 3), [0.9; 1.1; 1.0]); + end + + function missingFile(testCase) + testCase.verifyError(@() ldem.io.readRandomField("nope.txt", 3), ... + 'ldem:io:fileNotFound'); + end + + function fileWithTooFewValues(testCase) + path = testCase.writeText(sprintf('1\n1\n')); + testCase.verifyError(@() ldem.io.readRandomField(path, 5), ... + 'ldem:io:randomFieldTooShort'); + end + + function nonPositiveValue(testCase) + path = testCase.writeText(sprintf('1\n0\n1\n')); + testCase.verifyError(@() ldem.io.readRandomField(path, 3), ... + 'ldem:io:randomFieldInvalid'); + end + + function readsTheBundledExample(testCase) + path = fullfile(testCase.RepoRoot, 'examples', 'beam_102', 'arquivo_3lc_rnao_cv05'); + field = ldem.io.readRandomField(path, 1000); + testCase.verifySize(field, [1000 1]); + testCase.verifyGreaterThan(min(field), 0); + end + end +end From 5b9ae42c7656251373b945669bc15f241d0aeede Mon Sep 17 00:00:00 2001 From: Boris Rojo Tanzi <71112604+borisrojotanzi@users.noreply.github.com> Date: Thu, 5 Nov 2026 19:26:25 -0300 Subject: [PATCH 04/13] feat: fix legacy time integration, add ldem.solver, runSimulation and outputs --- CHANGELOG.md | 19 ++ CONTRIBUTING.md | 38 +++- README.md | 21 +- docs/source/api/index.rst | 54 +++-- docs/source/en/usage.rst | 98 ++++++++- docs/source/es/uso.rst | 101 ++++++++- examples/README.md | 36 ++-- examples/beam_102/runBeam.m | 41 ++++ examples/tension_101/runTension.m | 51 +++++ legacy/IGN012.m | 3 + legacy/KNOWN_ISSUES.md | 46 +++- src/+ldem/+io/SnapshotWriter.m | 132 ++++++++++++ src/+ldem/+io/exportAnsys.m | 124 +++++++++++ src/+ldem/+io/exportVtk.m | 92 ++++++++ src/+ldem/+io/saveResults.m | 34 +++ src/+ldem/+io/writePvd.m | 49 +++++ src/+ldem/+post/plotEnergy.m | 48 +++++ src/+ldem/+post/plotReaction.m | 50 +++++ src/+ldem/+scenarios/FourPointBending.m | 92 +++++++- src/+ldem/+scenarios/Scenario.m | 38 +++- src/+ldem/+scenarios/UniaxialTension.m | 57 ++++- src/+ldem/+solver/computeBarForces.m | 85 ++++++++ src/+ldem/+solver/computeEnergies.m | 81 +++++++ src/+ldem/+solver/dampingCoefficient.m | 39 ++++ src/+ldem/+solver/initialState.m | 63 ++++++ src/+ldem/+solver/integrateStep.m | 91 ++++++++ src/+ldem/+solver/simulate.m | 177 ++++++++++++++++ src/+ldem/Parameters.m | 14 ++ src/+ldem/runSimulation.m | 136 ++++++++++++ src/+ldem/version.m | 14 ++ tests/fixtures/bending102.mat | Bin 558497 -> 899199 bytes tests/fixtures/tension101_damage.mat | Bin 167063 -> 165037 bytes tests/fixtures/tension101_elastic.mat | Bin 160198 -> 161402 bytes tests/regression/TestAnsysAgainstLegacy.m | 73 +++++++ tests/regression/TestFixtures.m | 13 +- tests/regression/TestSolverAgainstLegacy.m | 137 ++++++++++++ tests/tools/referenceCases.m | 8 +- tests/unit/TestEnergies.m | 98 +++++++++ tests/unit/TestExamples.m | 57 +++++ tests/unit/TestExporters.m | 218 +++++++++++++++++++ tests/unit/TestRunSimulation.m | 196 +++++++++++++++++ tests/unit/TestSimulate.m | 177 ++++++++++++++++ tests/unit/TestSolver.m | 236 +++++++++++++++++++++ 43 files changed, 3050 insertions(+), 87 deletions(-) create mode 100644 examples/beam_102/runBeam.m create mode 100644 examples/tension_101/runTension.m create mode 100644 src/+ldem/+io/SnapshotWriter.m create mode 100644 src/+ldem/+io/exportAnsys.m create mode 100644 src/+ldem/+io/exportVtk.m create mode 100644 src/+ldem/+io/saveResults.m create mode 100644 src/+ldem/+io/writePvd.m create mode 100644 src/+ldem/+post/plotEnergy.m create mode 100644 src/+ldem/+post/plotReaction.m create mode 100644 src/+ldem/+solver/computeBarForces.m create mode 100644 src/+ldem/+solver/computeEnergies.m create mode 100644 src/+ldem/+solver/dampingCoefficient.m create mode 100644 src/+ldem/+solver/initialState.m create mode 100644 src/+ldem/+solver/integrateStep.m create mode 100644 src/+ldem/+solver/simulate.m create mode 100644 src/+ldem/runSimulation.m create mode 100644 src/+ldem/version.m create mode 100644 tests/regression/TestAnsysAgainstLegacy.m create mode 100644 tests/regression/TestSolverAgainstLegacy.m create mode 100644 tests/unit/TestEnergies.m create mode 100644 tests/unit/TestExamples.m create mode 100644 tests/unit/TestExporters.m create mode 100644 tests/unit/TestRunSimulation.m create mode 100644 tests/unit/TestSimulate.m create mode 100644 tests/unit/TestSolver.m diff --git a/CHANGELOG.md b/CHANGELOG.md index c417f21..c1723e4 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -20,6 +20,22 @@ type, critical strain with optional random field (`ldem.io.readRandomField`), and the bilinear constitutive law as a pure function (`bilinearLaw`). `ldem.mesh.buildBars` now also returns the bar type and boundary faces. +- Solver in `ldem.solver`: `simulate` (time loop), `computeBarForces`, + `integrateStep` (central differences with damping), `computeEnergies`, + `dampingCoefficient` and `initialState`. `Scenario` now also defines the + loading (`applyLoads`, with a configurable `loadingVelocity`) and the + reaction force (`reactions`). +- `TestSolverAgainstLegacy`: the new solver reproduces the corrected legacy + simulation (displacements, velocities, damage, energies, reactions) in the + three reference cases; unit tests with analytical solutions (damped + oscillator, energy balance, Newton's third law). +- `ldem.runSimulation`: complete simulation returning one `results` struct and + writing `results.mat`, ANSYS macro files (`ldem.io.exportAnsys`, equal to the + legacy files except for two intended fixes) and a VTK series for ParaView + (`ldem.io.exportVtk`, `ldem.io.writePvd`), driven by `ldem.io.SnapshotWriter`. +- `ldem.post.plotEnergy` and `ldem.post.plotReaction`; `ldem.Parameters.toStruct`. +- Runnable examples: `examples/tension_101/runTension.m` and + `examples/beam_102/runBeam.m`; user guides rewritten (EN/ES). - Unit tests (`tests/unit`) and a regression test that compares the new mesh with the legacy one (`tests/regression/TestMeshAgainstLegacy`). @@ -35,6 +51,9 @@ - `legacy/main1.m`: removed scratch lines; fixed the end-of-run file closing (undefined `fid12/fid15/fid19/fid20`) and the ANSYS output call. - `legacy/BOUND.m`: `TEST 101` failed because `ini` was not assigned. +- `legacy/IGN012.m`: the time integration was never executed (the nested function + `ign012` was not called), so free nodes never moved. Fixed; the golden-master + fixtures were regenerated and the damage case re-tuned (1000 steps, Gf = 0.1). ### Removed - Duplicate files (`* - Copia.m`, `Copy_of_*`), empty `initialization_DEM`, and diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index fa5bb5f..4633eea 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -2,17 +2,41 @@ ## Docstring convention The API docs are generated from the comments of the `.m` files -(`sphinxcontrib-matlabdomain`). The docstring must be the comment block -placed **immediately after the `function` line** (before `global` blocks): +(`sphinxcontrib-matlabdomain`). The docstring is the comment block placed +**immediately after the `function` line** (no blank line in between): ```matlab -function ini = CALOAD() -% CALOAD One-line summary (English). -% Longer description of what the routine does. -global ... +function [barLength, barCentres] = computeBarGeometry(nodes, bars) +%COMPUTEBARGEOMETRY One-line summary. +% +% [barLength, barCentres] = ldem.mesh.computeBarGeometry(nodes, bars) +% explains in a few lines what the function does. +% +% Inputs: +% nodes nNodes-by-3 coordinates [m]. +% bars nBars-by-2 node numbers. +% +% Outputs: +% barLength nBars-by-1 vector of lengths [m]. +% barCentres nBars-by-3 matrix of midpoints [m]. +% +% Example: +% [len, mid] = ldem.mesh.computeBarGeometry(nodes, bars); +% +% Legacy: CALAUX. +% +% See also ldem.mesh.buildBars. ``` -Comments in new code are written in English (the legacy code keeps its original Portuguese comments). +Rules that keep the Sphinx build free of warnings: +- Write each entry of *Inputs/Outputs* on **one line**; put longer + explanations in a paragraph after the list. +- Leave a blank comment line before an indented block (list, example, table). + +Comments in new code are written in English (the legacy code keeps its original +Portuguese comments). Names: `lowerCamelCase` for functions and variables, +`UpperCamelCase` for classes. Validate inputs with an `arguments` block and throw +errors with an identifier of the form `ldem::`. ## Workflow 1. Branch from `dev`. diff --git a/README.md b/README.md index 2021956..01b4711 100644 --- a/README.md +++ b/README.md @@ -16,7 +16,8 @@ quasi-brittle materials (concrete, rocks). | Path | Content | |------|---------| -| `legacy/` | Original LDEM routines (frozen reference, being refactored into `src/+ldem`) | +| `src/+ldem/` | The `ldem` package (refactored code) | +| `legacy/` | Original LDEM routines (frozen reference used by the regression tests) | | `tests/` | `matlab.unittest` test suite | | `docs/` | Sphinx documentation (English and Spanish), API generated from the `.m` files | | `examples/` | How to run the example simulations | @@ -24,8 +25,8 @@ quasi-brittle materials (concrete, rocks). ### Quick start ```matlab ->> setup_path % adds legacy/ to the MATLAB path ->> main % runs the default simulation +>> setup_path % adds src/ and legacy/ to the MATLAB path +>> run('examples/tension_101/runTension.m') % small example, output in examples/tension_101/output ``` Run the tests: @@ -68,7 +69,8 @@ quase-frágeis (concreto, rochas). | Caminho | Conteúdo | |---------|----------| -| `legacy/` | Rotinas LDEM originais (referência congelada, em refatoração para `src/+ldem`) | +| `src/+ldem/` | O pacote `ldem` (código refatorado) | +| `legacy/` | Rotinas LDEM originais (referência congelada usada nos testes de regressão) | | `tests/` | Suíte de testes com `matlab.unittest` | | `docs/` | Documentação Sphinx (espanhol e inglês), API gerada a partir dos `.m` | | `examples/` | Como executar as simulações de exemplo | @@ -76,8 +78,8 @@ quase-frágeis (concreto, rochas). ### Início rápido ```matlab ->> setup_path % adiciona legacy/ ao path do MATLAB ->> main % executa a simulação padrão +>> setup_path % adiciona src/ e legacy/ ao path do MATLAB +>> run('examples/tension_101/runTension.m') % exemplo pequeno, saída em examples/tension_101/output ``` Executar os testes: @@ -118,7 +120,8 @@ cuasi-frágiles (hormigón, rocas). | Ruta | Contenido | |------|-----------| -| `legacy/` | Rutinas LDEM originales (referencia congelada, en refactorización hacia `src/+ldem`) | +| `src/+ldem/` | El paquete `ldem` (código refactorizado) | +| `legacy/` | Rutinas LDEM originales (referencia congelada usada en los tests de regresión) | | `tests/` | Suite de tests con `matlab.unittest` | | `docs/` | Documentación Sphinx (español e inglés), API generada desde los `.m` | | `examples/` | Cómo ejecutar las simulaciones de ejemplo | @@ -126,8 +129,8 @@ cuasi-frágiles (hormigón, rocas). ### Inicio rápido ```matlab ->> setup_path % agrega legacy/ al path de MATLAB ->> main % ejecuta la simulación por defecto +>> setup_path % agrega src/ y legacy/ al path de MATLAB +>> run('examples/tension_101/runTension.m') % ejemplo pequeño, salida en examples/tension_101/output ``` Ejecutar los tests: diff --git a/docs/source/api/index.rst b/docs/source/api/index.rst index 3a33486..a2ee2ad 100644 --- a/docs/source/api/index.rst +++ b/docs/source/api/index.rst @@ -4,27 +4,39 @@ API reference / Referencia de la API Generated automatically from the comments of the ``.m`` files / Generada automáticamente desde los comentarios de los ``.m``. -Refactored package ``ldem`` / Paquete refactorizado ``ldem`` ------------------------------------------------------------- +The ``ldem`` package (``src/+ldem``) is the refactored code. It replaces the +routines of ``legacy/`` step by step; the original routines are kept as a +frozen reference and are not part of this API (their known problems are in +``legacy/KNOWN_ISSUES.md``) / El paquete ``ldem`` (``src/+ldem``) es el código +refactorizado. Las rutinas originales de ``legacy/`` se conservan como +referencia congelada y no forman parte de esta API. -New code in ``src/+ldem`` (English comments). It replaces the routines of -``legacy/`` step by step; see ``legacy/KNOWN_ISSUES.md``. +Running a simulation / Ejecutar una simulación +---------------------------------------------- .. mat:module:: ldem -Parameters / Parámetros -~~~~~~~~~~~~~~~~~~~~~~~ - +.. mat:autofunction:: ldem.runSimulation .. mat:autoclass:: ldem.Parameters :members: +.. mat:autofunction:: ldem.version + +Input and output / Entrada y salida +----------------------------------- .. mat:module:: ldem.io .. mat:autofunction:: ldem.io.readInputFile .. mat:autofunction:: ldem.io.readRandomField +.. mat:autofunction:: ldem.io.saveResults +.. mat:autofunction:: ldem.io.exportAnsys +.. mat:autofunction:: ldem.io.exportVtk +.. mat:autofunction:: ldem.io.writePvd +.. mat:autoclass:: ldem.io.SnapshotWriter + :members: Mesh / Malla -~~~~~~~~~~~~ +------------ .. mat:module:: ldem.mesh @@ -35,8 +47,8 @@ Mesh / Malla .. mat:autofunction:: ldem.mesh.computeNodalMasses .. mat:autofunction:: ldem.mesh.computeBarGeometry -Material / Material -~~~~~~~~~~~~~~~~~~~ +Material +-------- .. mat:module:: ldem.material @@ -46,7 +58,7 @@ Material / Material .. mat:autofunction:: ldem.material.bilinearLaw Scenarios / Escenarios de ensayo -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +-------------------------------- .. mat:module:: ldem.scenarios @@ -56,16 +68,22 @@ Scenarios / Escenarios de ensayo .. mat:autofunction:: ldem.scenarios.fromTestId Solver -~~~~~~ +------ .. mat:module:: ldem.solver +.. mat:autofunction:: ldem.solver.simulate +.. mat:autofunction:: ldem.solver.initialState +.. mat:autofunction:: ldem.solver.computeBarForces +.. mat:autofunction:: ldem.solver.integrateStep +.. mat:autofunction:: ldem.solver.dampingCoefficient +.. mat:autofunction:: ldem.solver.computeEnergies .. mat:autofunction:: ldem.solver.checkStability -Legacy routines / Rutinas originales ------------------------------------- +Post-processing / Postproceso +----------------------------- + +.. mat:module:: ldem.post -The original routines live in ``legacy/`` as a frozen reference and are not -part of the generated API. Their known problems are listed in -``legacy/KNOWN_ISSUES.md`` / Las rutinas originales están en ``legacy/`` como -referencia congelada y no forman parte de la API generada. +.. mat:autofunction:: ldem.post.plotEnergy +.. mat:autofunction:: ldem.post.plotReaction diff --git a/docs/source/en/usage.rst b/docs/source/en/usage.rst index ccff90b..30d2e7d 100644 --- a/docs/source/en/usage.rst +++ b/docs/source/en/usage.rst @@ -1,18 +1,102 @@ Usage ===== +Run a simulation +---------------- + +.. code-block:: matlab + + >> setup_path % adds src/ to the MATLAB path + >> params = ldem.Parameters(testId=101, nModules=[6 3 3], totalTime=2e-4, ... + fractureEnergy=0.1, ... + output=struct('snapshotEvery', 250, 'controlNodesEvery', 10, ... + 'energyEvery', 10, 'trackedBarEvery', 0)); + >> results = ldem.runSimulation(params, OutputFolder="output", ... + Formats=["mat" "ansys" "vtk"]); + >> ldem.post.plotEnergy(results); + +``ldem.Parameters`` checks every value when it is set and explains what is +wrong (for example an unstable time step). The complete, ready-to-run version +of this script is ``examples/tension_101/runTension.m``. + +To use an input file in the format of the original program: + +.. code-block:: matlab + + >> params = ldem.Parameters.fromFile("DATA0.DAT"); + +Tests available +--------------- + +``testId = 101`` + Uniaxial load: the centre nodes of the last column of modules move along + :math:`x` with a prescribed velocity. +``testId = 102`` + Beam with two supports and a load point (needs a beam longer than about 70 + modules). See ``examples/beam_102``. + +To add a new test, create a subclass of ``ldem.scenarios.Scenario``. + +What you get: the ``results`` struct +------------------------------------ + +.. list-table:: + :header-rows: 1 + :widths: 22 78 + + * - Field + - Content + * - ``info`` + - ldem version, date, MATLAB release, run time [s]. + * - ``params`` + - The parameters used, as a plain struct (derived values included). + * - ``mesh`` + - Initial node positions, supports (``fixed``), masses, bars, bar lengths. + * - ``barProps`` + - Stiffness, critical strain and rupture strain of every bar. + * - ``controlNodes`` + - Time and displacement, velocity and acceleration of the control nodes. + * - ``reactions`` + - Time and reaction force of the test (beam test: vertical force). + * - ``energy`` + - Time, kinetic, elastic, damage and damping energies [J], their sum + (``internal``) and the damage rate. + * - ``trackedBar`` + - Strain, force and damage energy of one bar at every step (optional). + * - ``snapshots`` + - Step, time, number of intact/damaged/broken bars, and compact copies of + the displacements and of the damage state at the snapshot steps. + * - ``final`` + - Final displacement, velocity, force and damage state. + +``results.mat`` contains this struct and loads without the package: + .. code-block:: matlab - >> setup_path - >> main % default simulation + >> data = load("output/results.mat"); + >> results = data.results; + +Output files +------------ + +``results.mat`` + The ``results`` struct (format v7.3, readable from Python with ``h5py``). +``snapshot_0000.mac``, ``snapshot_0001.mac``, ... + ANSYS macro files with the deformed lattice. Bars are element types 1 + (intact), 2 (damaged) and 5 (broken). +``snapshot_0000.vtu``, ... and ``snapshots.pvd`` + VTK files. Open ``snapshots.pvd`` in `ParaView `_; + colour by ``damageState`` (cell data) to see the cracks and use the time + slider to follow them. Displacement and velocity are point data. -Input data files (``DATA0.DAT``, ``SIM01.DAT``) are read by ``read_dat0``. -Results are written to ``LET.*`` and ``*.TXT`` files in the working -directory. +ANSYS and VTK files are written at time zero and every +``params.output.snapshotEvery`` steps. -Run the tests: +Run the tests +------------- .. code-block:: matlab >> addpath tests - >> run_tests + >> run_tests % fast tests + >> run_tests(IncludeSlow=true) % also re-runs the legacy simulations diff --git a/docs/source/es/uso.rst b/docs/source/es/uso.rst index 5007398..170a239 100644 --- a/docs/source/es/uso.rst +++ b/docs/source/es/uso.rst @@ -1,18 +1,105 @@ Uso === +Ejecutar una simulación +----------------------- + +.. code-block:: matlab + + >> setup_path % agrega src/ al path de MATLAB + >> params = ldem.Parameters(testId=101, nModules=[6 3 3], totalTime=2e-4, ... + fractureEnergy=0.1, ... + output=struct('snapshotEvery', 250, 'controlNodesEvery', 10, ... + 'energyEvery', 10, 'trackedBarEvery', 0)); + >> results = ldem.runSimulation(params, OutputFolder="output", ... + Formats=["mat" "ansys" "vtk"]); + >> ldem.post.plotEnergy(results); + +``ldem.Parameters`` valida cada valor al asignarlo y explica qué está mal +(por ejemplo, un paso de tiempo inestable). La versión completa y lista para +ejecutar está en ``examples/tension_101/runTension.m``. + +Para usar un archivo de entrada con el formato del programa original: + +.. code-block:: matlab + + >> params = ldem.Parameters.fromFile("DATA0.DAT"); + +Ensayos disponibles +------------------- + +``testId = 101`` + Carga uniaxial: los nodos centrales de la última columna de módulos se + mueven en :math:`x` con velocidad impuesta. +``testId = 102`` + Viga con dos apoyos y un punto de carga (requiere una viga de más de unos + 70 módulos). Ver ``examples/beam_102``. + +Para agregar un ensayo nuevo se crea una subclase de +``ldem.scenarios.Scenario``. + +Qué se obtiene: la estructura ``results`` +----------------------------------------- + +.. list-table:: + :header-rows: 1 + :widths: 22 78 + + * - Campo + - Contenido + * - ``info`` + - Versión de ldem, fecha, versión de MATLAB, tiempo de cálculo [s]. + * - ``params`` + - Los parámetros usados, como estructura simple (con valores derivados). + * - ``mesh`` + - Posiciones iniciales, apoyos (``fixed``), masas, barras y longitudes. + * - ``barProps`` + - Rigidez, deformación crítica y deformación de rotura de cada barra. + * - ``controlNodes`` + - Tiempo y desplazamiento, velocidad y aceleración de los nodos de control. + * - ``reactions`` + - Tiempo y fuerza de reacción del ensayo (viga: fuerza vertical). + * - ``energy`` + - Tiempo, energías cinética, elástica, de daño y de amortiguamiento [J], + su suma (``internal``) y la tasa de daño. + * - ``trackedBar`` + - Deformación, fuerza y energía de daño de una barra en cada paso + (opcional). + * - ``snapshots`` + - Paso, tiempo, número de barras intactas/dañadas/rotas y copias + compactas de los desplazamientos y del estado de daño. + * - ``final`` + - Desplazamiento, velocidad, fuerza y estado de daño finales. + +``results.mat`` contiene esta estructura y se carga sin el paquete: + .. code-block:: matlab - >> setup_path - >> main % simulación por defecto + >> data = load("output/results.mat"); + >> results = data.results; + +Archivos de salida +------------------ + +``results.mat`` + La estructura ``results`` (formato v7.3, legible desde Python con ``h5py``). +``snapshot_0000.mac``, ``snapshot_0001.mac``, ... + Macros de ANSYS con el reticulado deformado. Las barras son elementos de + tipo 1 (intactas), 2 (dañadas) y 5 (rotas). +``snapshot_0000.vtu``, ... y ``snapshots.pvd`` + Archivos VTK. Abrir ``snapshots.pvd`` en `ParaView `_; + colorear por ``damageState`` (datos de celda) para ver las fisuras y usar + el control de tiempo para seguirlas. Desplazamiento y velocidad son datos + de nodo. -Los archivos de entrada (``DATA0.DAT``, ``SIM01.DAT``) son leídos por -``read_dat0``. Los resultados se escriben en archivos ``LET.*`` y ``*.TXT`` -en el directorio de trabajo. +Los archivos ANSYS y VTK se escriben en el tiempo cero y cada +``params.output.snapshotEvery`` pasos. -Ejecutar los tests: +Ejecutar los tests +------------------ .. code-block:: matlab >> addpath tests - >> run_tests + >> run_tests % tests rápidos + >> run_tests(IncludeSlow=true) % también repite las simulaciones originales diff --git a/examples/README.md b/examples/README.md index 6a561ef..ebccccd 100644 --- a/examples/README.md +++ b/examples/README.md @@ -1,21 +1,31 @@ # Examples -## beam_102 +| Folder | What it shows | Time | +|--------|---------------|------| +| `tension_101/` | Small prism under uniaxial load, all output formats, energy plot | seconds | +| `beam_102/` | The 101x41x21-module beam read from `DATA0.DAT` | ~20 s for 50 steps; ~20 h for the full run | -Input files of the beam (TEST 102) example: +Run an example from MATLAB, from any folder: + +```matlab +>> run('examples/tension_101/runTension.m') +``` + +Outputs are written to an `output/` folder next to the script (ignored by git): + +- `results.mat` - one struct, `results`, with everything that was recorded. + Load it with `data = load('results.mat'); results = data.results;`. +- `snapshot_0000.mac`, ... - ANSYS macro files of the deformed lattice. +- `snapshot_0000.vtu`, ... and `snapshots.pvd` - open `snapshots.pvd` in + [ParaView](https://www.paraview.org/) to see the damage evolve in time. + +## beam_102 input files | File | Purpose | |------|---------| -| `DATA0.DAT` | Simulation parameters (read by `read_dat0`) | -| `LET.AN1` | Names of the ANSYS files to write | +| `DATA0.DAT` | Simulation parameters (legacy format, read by `ldem.Parameters.fromFile`) | +| `LET.AN1` | Names of the ANSYS files of the legacy driver (not needed by the new code) | | `arquivo_3lc_rnao_cv05` | Random field applied to the critical strain of each bar (11 MB) | -The legacy driver reads these files from the **current folder** and writes its -outputs (`LET.*`, `*.TXT`, `ANSYS*.MAC`, ...) there too, so run it from a -scratch copy: - -```matlab ->> setup_path % from the repository root ->> mkdir('run'); copyfile('examples/beam_102/*', 'run'); cd run ->> main1 -``` +The legacy driver (`legacy/main1.m`) reads its files from the current folder +and writes its outputs there too, so run it from a scratch copy. diff --git a/examples/beam_102/runBeam.m b/examples/beam_102/runBeam.m new file mode 100644 index 0000000..b2c9978 --- /dev/null +++ b/examples/beam_102/runBeam.m @@ -0,0 +1,41 @@ +%% Bending test (TEST 102) on the 101x41x21-module beam of the paper +% Reads the input file DATA0.DAT of this folder and runs the beam. +% +% The full beam has about 167,000 nodes and 1.1 million bars. A full run is +% 150,000 steps (see the time estimate below), so this script runs only the first +% "nStepsDemo" steps. Increase it (or remove the totalTime override) for the +% real simulation. Measured on a laptop: about 20 s to build the model and 0.5 s +% per step, so the 150,000 steps of the real run need roughly 20 hours. +% +% Output goes to the folder "output" next to this script, or to +% "outputFolder" if that variable already exists in the workspace. + +here = fileparts(mfilename('fullpath')); +addpath(fullfile(fileparts(fileparts(here)), 'src')); +if ~exist('outputFolder', 'var') + outputFolder = fullfile(here, 'output'); +end +nStepsDemo = 50; + +%% 1. Read the input file +% fromFile reads DATA0.DAT; the name-value pairs add what the file does not +% contain (the random field) or replace a value (the simulated time). +params = ldem.Parameters.fromFile(fullfile(here, 'DATA0.DAT'), ... + randomFieldFile = fullfile(here, 'arquivo_3lc_rnao_cv05'), ... + totalTime = nStepsDemo * 2e-7); +% Store the snapshots at the end only (demo). +params.output.snapshotEvery = nStepsDemo; +params.output.controlNodesEvery = 5; +params.output.energyEvery = 5; + +fprintf('Beam with %d nodes, %d steps.\n', params.nNodes, params.nSteps); + +%% 2. Run +results = ldem.runSimulation(params, ... + OutputFolder = outputFolder, ... + Formats = ["mat" "vtk"], ... + Verbose = true); + +%% 3. Plot +fig = figure('Name', 'Reaction force'); +ldem.post.plotReaction(results, axes(fig)); diff --git a/examples/tension_101/runTension.m b/examples/tension_101/runTension.m new file mode 100644 index 0000000..3d623e8 --- /dev/null +++ b/examples/tension_101/runTension.m @@ -0,0 +1,51 @@ +%% Uniaxial test (TEST 101) on a small prism +% This script runs a complete simulation in a few seconds and writes every +% kind of output file. It is the best place to start: copy it and change the +% parameters. +% +% What it does +% 1. Describes the model with ldem.Parameters (a 5x2x2-module prism). +% 2. Runs it with ldem.runSimulation, writing results.mat, ANSYS macro files +% and a VTK series (open snapshots.pvd in ParaView). +% 3. Plots the energies. +% +% Output goes to the folder "output" next to this script, or to +% "outputFolder" if that variable already exists in the workspace. + +here = fileparts(mfilename('fullpath')); +addpath(fullfile(fileparts(fileparts(here)), 'src')); +if ~exist('outputFolder', 'var') + outputFolder = fullfile(here, 'output'); +end + +%% 1. Parameters +% The fracture energy is low on purpose so that bars soften and break within +% the 1000 steps (0.2 ms) of the run. +params = ldem.Parameters( ... + testId = 101, ... % prism loaded along x + nModules = [6 3 3], ... % nodes along x, y, z + moduleLength = 0.003, ... % [m] + dt = 2e-7, ... % [s] + totalTime = 2e-4, ... % [s] -> 1000 steps + fractureEnergy = 0.1, ... % [N/m] + controlNodes = [1 2], ... + output = struct( ... + 'snapshotEvery', 250, ... % ANSYS/VTK file every 250 steps + 'controlNodesEvery', 10, ... % control nodes and reactions + 'energyEvery', 10, ... % energies + 'trackedBarEvery', 0)); % tracked bar off + +%% 2. Run +results = ldem.runSimulation(params, ... + OutputFolder = outputFolder, ... + Formats = ["mat" "ansys" "vtk"], ... + Verbose = true); + +%% 3. Look at the results +counts = results.snapshots.barCounts(end, :); +fprintf('\nAfter %.2g s: %d intact, %d damaged and %d broken bars.\n', ... + results.final.time, counts(1), counts(2), counts(3)); +fprintf('Files written to %s\n', outputFolder); + +fig = figure('Name', 'Energies'); +ldem.post.plotEnergy(results, axes(fig)); diff --git a/legacy/IGN012.m b/legacy/IGN012.m index 3eedcf2..05b0f91 100644 --- a/legacy/IGN012.m +++ b/legacy/IGN012.m @@ -280,6 +280,9 @@ W(2,:) = W(3,:); end +% FIX: ign012 is a nested function and was never called, so the equations of +% motion were not integrated (see legacy/KNOWN_ISSUES.md, item 0). +ign012; ini=1; end diff --git a/legacy/KNOWN_ISSUES.md b/legacy/KNOWN_ISSUES.md index 4c47612..8bb371d 100644 --- a/legacy/KNOWN_ISSUES.md +++ b/legacy/KNOWN_ISSUES.md @@ -13,16 +13,17 @@ code** (each one has a test that documents the decision). | `main1.m` | Closing section used undefined `fid12/fid15/fid19/fid20` and crashed at the end of every run | Closes the file ids that were really opened | | `main1.m` | `ARMANS(I3)` (parentheses) and `[...] = ini==ANSYS(...)` crashed when ANSYS output was enabled | `ARMANS{I3}`, plain call | | `BOUND.m` | `ini` only assigned when `TEST == 102`, so `TEST 101` failed | Assigned unconditionally | +| `IGN012.m` | **Critical.** The central-difference integration was in a nested function `ign012` that was never called, so no node moved except those with a prescribed displacement (velocities and accelerations were exactly 0) | Added the call `ign012;`. Results change: the fixtures were regenerated and cases that damaged because of the frozen neighbours no longer do | ## Not fixed (would change results or output) - decide in the new code -1. **`ENERG2.m` lines 172-174: kinetic energy is not summed.** +1. **`ENERG2.m` lines 172-174: kinetic energy is not summed.** *(Resolved in the new code.)* `ENCN = ENCN + (MAS.*VLX.^2)/2` is element-wise, so `ENCN` is a 1-by-`INT` vector (kinetic energy per node) instead of a scalar. `ENIN`, `DEN` and the energy balance inherit this shape. *New code:* `energy.kinetic = sum(...)` (scalar). The regression test compares `sum(ENCN)` with the new scalar. -2. **`WRIENE.m` line 35: invalid format `%25.12` (missing `e`).** +2. **`WRIENE.m` line 35: invalid format `%25.12` (missing `e`).** *(Output to be written by the new exporters.)* `fprintf` stops at the invalid conversion, so `LET.ENE` is truncated and garbled. Correcting only the format would write one row per element of the `ENCN` vector (90 MB for 200 steps), so it depends on issue 1. @@ -52,3 +53,44 @@ code** (each one has a test that documents the decision). material. *New code:* `params.randomFieldFile` is optional (empty = all multipliers equal to 1). 10. **Preallocation `INT = 168000`, `INB = 2300000`** limits the mesh size. +11. **`ign012` (IGN012.m): acceleration in y uses a wrong index.** + `ACY = (V(3,:) - V(2,I).*2.0 + V(1,:))./SDT` uses `V(2,I)` (a scalar, with + `I` left over from the node loop) instead of `V(2,:)`. Only the reported + acceleration is affected, not the motion. + *New code:* the three components use the same formula + (`ldem.solver.integrateStep`); the regression test skips `ACY`. +12. **`ign012`: damping energy mixes vectors and scalars.** + `ENDP` becomes a per-node vector, and the viscous dissipation of every bar + (a scalar) is added to every node entry, so `sum(ENDP)` counts the bar + terms `NNT` times. The reference cases have `CON = 0`, where the two + definitions coincide. + *New code:* `state.dampingEnergy` is a scalar. +13. **`ENERG2.m` / `IGN012.m`: `KL` is always 2.** The test `B > NBA` (or + `B <= NBS`) selecting `KL = 4` for the diagonals never holds because + `NBA = NBS = NBT`. `KL = 2` gives the exact bar energy + (`E*strain^2*L/2`), so the results are right; the dead branch was removed. +14. **`ENEX` (external work) is never computed.** It stays 0 and the energy + balance `ENEX - ENIN` is not available. + *New code:* not provided yet; `energy.internal` is. +15. **`CALOAD.m`, `TEST == 102`: the second load point is never loaded.** + The condition is `LOGIC1 && LOGIC2`, two conditions on the x coordinate + that can only both hold for `M1 = 67`; `BOUND` holds both load points in y, + so the left one acts as a support. + *New code:* reproduced (`FourPointBending.loadedNodes`); decide with the + author whether both points should be loaded. +16. **`TDAF` shorter than half a time step never switches the damping.** + The switch is done when `STEP == NDAMF` and `NDAMF` would be 0. + *New code:* reproduced (`ldem.solver.dampingCoefficient`). +17. **`TEST == 101` sign convention.** The loaded nodes move to + `x0 - VF2*TIME`, which compresses the prism for `VF2 > 0` although the + comment says "tension". *New code:* same convention, documented in + `UniaxialTension`. +18. **`ANSYS.m`: three problems in the macro files.** + (a) The line `ET,IFILE,4` is an invalid ANSYS command (a translation slip + for `ET,3,4`); (b) constraints (`D,node,UX`...) are only written for + `TEST == 102`; (c) the "applied loads" section writes `F,node,Fx,-10` for + nodes selected with hardcoded coordinates (`50.5*LCO`...) that match no + node of the beam. + *New code (`ldem.io.exportAnsys`):* writes `ET,3,4`, writes the constraints + of every scenario and leaves the loads section empty. The regression test + normalizes (a) and (b) before comparing with the legacy files. diff --git a/src/+ldem/+io/SnapshotWriter.m b/src/+ldem/+io/SnapshotWriter.m new file mode 100644 index 0000000..57efa91 --- /dev/null +++ b/src/+ldem/+io/SnapshotWriter.m @@ -0,0 +1,132 @@ +classdef SnapshotWriter < handle + %SNAPSHOTWRITER Collect snapshots of the state and export them to files. + % + % A snapshot is the full state of the lattice at one instant. The solver + % calls the writer at the steps chosen by params.output.snapshotEvery. + % For every snapshot the writer does the following: + % + % * keeps a compact copy (displacement and damage state), stored in the results; + % * writes an ANSYS macro file if "ansys" is among the formats; + % * writes a VTK file if "vtk" is among the formats. + % + % When the simulation ends, finish() writes the ParaView collection that + % groups the VTK files in time. + % + % Typical use (done by ldem.runSimulation): + % writer = ldem.io.SnapshotWriter(mesh, "output", ["ansys" "vtk"]); + % ldem.solver.simulate(..., SnapshotFcn=@writer.write); + % snapshots = writer.finish(); + % + % Files are written inside the given folder, named snapshot_0000.vtu, + % snapshot_0001.vtu, ... and snapshot_0000.mac, ... (zero is the state + % at time zero); the collection is called snapshots.pvd. + % + % See also ldem.io.exportAnsys, ldem.io.exportVtk, ldem.io.writePvd, + % ldem.solver.simulate. + + properties (SetAccess = private) + % Folder where the files are written ("" if no files are written). + Folder (1,1) string = "" + % Export formats: any of "ansys" and "vtk". + Formats (1,:) string = string.empty + % Number of snapshots taken so far. + Count (1,1) double = 0 + end + + properties (Access = private) + Mesh (1,1) struct + Steps = zeros(0, 1) + Times = zeros(0, 1) + BarCounts = zeros(0, 3) + Displacements = {} + DamageStates = {} + VtkFiles = strings(0, 1) + end + + methods + function obj = SnapshotWriter(mesh, folder, formats) + %SNAPSHOTWRITER Create a writer for a mesh. + % + % writer = ldem.io.SnapshotWriter(mesh, folder, formats) prepares + % the writer. folder may be "" when formats is empty, to only keep + % the in-memory snapshots. + arguments + mesh (1,1) struct + folder (1,1) string = "" + formats (1,:) string {mustBeMember(formats, ["ansys", "vtk"])} = string.empty + end + if ~isempty(formats) && strlength(folder) == 0 + error('ldem:io:noFolder', 'A folder is needed to export %s files.', strjoin(formats, ' and ')); + end + if strlength(folder) > 0 && ~isfolder(folder) + mkdir(folder); + end + obj.Mesh = mesh; + obj.Folder = folder; + obj.Formats = formats; + end + + function write(obj, state) + %WRITE Take one snapshot (callback for ldem.solver.simulate). + arguments + obj (1,1) ldem.io.SnapshotWriter + state (1,1) struct + end + index = obj.Count; + baseName = sprintf('snapshot_%04d', index); + + if any(obj.Formats == "ansys") + counts = ldem.io.exportAnsys(fullfile(obj.Folder, baseName + ".mac"), obj.Mesh, state); + else + counts = ldem.io.SnapshotWriter.countBars(state); + end + if any(obj.Formats == "vtk") + ldem.io.exportVtk(fullfile(obj.Folder, baseName + ".vtu"), obj.Mesh, state); + obj.VtkFiles(end + 1, 1) = baseName + ".vtu"; + end + + damageState = uint8(2 * ones(size(state.history.isUndamaged))); + damageState(state.history.isUnbroken) = 1; + damageState(state.history.isUndamaged) = 0; + + obj.Count = obj.Count + 1; + obj.Steps(end + 1, 1) = state.step; + obj.Times(end + 1, 1) = state.time; + obj.BarCounts(end + 1, :) = [counts.intact, counts.damaged, counts.broken]; + obj.Displacements{end + 1} = single(state.displacement); + obj.DamageStates{end + 1} = damageState; + end + + function snapshots = finish(obj) + %FINISH Write the ParaView collection and return the snapshots. + % + % snapshots = writer.finish() returns a struct with the fields + % step, time (n-by-1), barCounts (n-by-3: intact, damaged, + % broken), and displacement (n-by-1 cell of nNodes-by-3 single) + % and damageState (n-by-1 cell of nBars-by-1 uint8: 0 intact, + % 1 damaged, 2 broken). + arguments + obj (1,1) ldem.io.SnapshotWriter + end + if ~isempty(obj.VtkFiles) + ldem.io.writePvd(fullfile(obj.Folder, "snapshots.pvd"), ... + obj.Times(1:numel(obj.VtkFiles)), obj.VtkFiles); + end + snapshots = struct( ... + 'step', obj.Steps, ... + 'time', obj.Times, ... + 'barCounts', obj.BarCounts, ... + 'displacement', {obj.Displacements(:)}, ... + 'damageState', {obj.DamageStates(:)}); + end + end + + methods (Static, Access = private) + function counts = countBars(state) + intact = nnz(state.history.isUndamaged); + broken = nnz(~state.history.isUnbroken); + counts = struct('intact', intact, 'damaged', numel(state.history.isUndamaged) - intact - broken, ... + 'broken', broken); + end + end +end diff --git a/src/+ldem/+io/exportAnsys.m b/src/+ldem/+io/exportAnsys.m new file mode 100644 index 0000000..6002b06 --- /dev/null +++ b/src/+ldem/+io/exportAnsys.m @@ -0,0 +1,124 @@ +function counts = exportAnsys(path, mesh, state) +%EXPORTANSYS Write an ANSYS macro file (.mac) with the current state. +% +% counts = ldem.io.exportAnsys(path, mesh, state) writes a text file that +% ANSYS can read to draw the deformed lattice. It contains the node +% positions, the bars coloured by damage state, and the constraints. +% +% The bars are written as elements of three types: +% +% TYPE 1 intact bars (never softened) +% TYPE 2 damaged bars (softening but not broken) +% TYPE 5 broken bars +% +% The element type numbers are the ones used by the colour commands of the +% file, so the damaged zone is easy to see. +% +% The constraint section lists the degrees of freedom held by the scenario +% (mesh.fixed). Node positions are written in single precision, like the +% legacy code. +% +% Inputs: +% path Path of the file to create. +% mesh Struct from ldem.mesh.buildMesh. +% state Solver state (current displacement and damage state). +% +% Output: +% counts Struct with the number of bars in each state: intact, damaged +% and broken. +% +% Errors: +% ldem:io:cannotOpenFile The file cannot be created. +% +% Differences from the legacy file: the line "ET,IFILE,4" (an invalid +% command caused by a translation slip) is written as "ET,3,4"; the +% constraints are written for every scenario, not only for TEST 102; and +% the hardcoded "applied loads" of TEST 102 are not written (they did not +% match any node of the beam). +% +% Example: +% counts = ldem.io.exportAnsys("step100.mac", mesh, state); +% +% Legacy: ANSYS. +% +% See also ldem.io.exportVtk, ldem.io.SnapshotWriter. + +arguments + path (1,1) string + mesh (1,1) struct + state (1,1) struct +end + +fid = fopen(path, 'w'); +if fid == -1 + error('ldem:io:cannotOpenFile', 'Cannot create the ANSYS file "%s".', path); +end +closer = onCleanup(@() fclose(fid)); + +nNodes = size(state.displacement, 1); +nBars = size(mesh.bars, 1); + +fprintf(fid, '!ARQUIVO NO TEMPO = %g\n', state.time); +fprintf(fid, '/PREP7\n'); +fprintf(fid, '/TITLE, TEMPO =%g\n', state.time); +for typeNumber = [1 2 3 4 5 6 8 9 10 11 12] + fprintf(fid, 'ET,%d,4\n', typeNumber); +end +fprintf(fid, 'MP,EX,1,2E10\n'); +fprintf(fid, 'MP,PRXY,1,0.25\n'); +fprintf(fid, 'MP,DENS,1,2500\n'); +fprintf(fid, 'R,1,0.13,0.0014,0.36\n'); +fprintf(fid, '\n'); + +% Node coordinates, in single precision. +fprintf(fid, '!COORDENADAS NODAIS\n'); +coordinates = double(single(state.displacement)); +fprintf(fid, 'N,%d,%g,%g,%g\n', [(1:nNodes); coordinates.']); +fprintf(fid, '\n'); + +% Bars as elements, typed by damage state. +fprintf(fid, '!CONECTIVIDADES DOS ELEMENTOS\n'); +elementType = 5 * ones(nBars, 1); % broken +elementType(state.history.isUnbroken) = 2; % damaged +elementType(state.history.isUndamaged) = 1; % intact +fprintf(fid, 'TYPE,%d\nE,%d,%d,!EL%d\n', [elementType.'; mesh.bars.'; (1:nBars)]); +fprintf(fid, '\n'); + +counts = struct('intact', nnz(elementType == 1), ... + 'damaged', nnz(elementType == 2), ... + 'broken', nnz(elementType == 5)); + +% Colours. +fprintf(fid, '!CORES DOS ELEMENTOS\n'); +colours = {1, 'GCYA'; 2, 'ORAN'; 5, 'RED'; 6, 'GREE'}; +for k = 1:size(colours, 1) + fprintf(fid, 'ESEL,S,TYPE,,%d\n', colours{k, 1}); + fprintf(fid, '/COLOR,ELEM,%s\n', colours{k, 2}); + fprintf(fid, '/PNUM,TYPE,0\n'); + fprintf(fid, '/NUMBER,1\n'); + fprintf(fid, 'ESEL,ALL\n'); +end + +% Constraints. +fprintf(fid, '!CONDIÇÕES DE CONTORNO\n'); +directions = ["UX", "UY", "UZ"]; +for node = find(any(mesh.fixed, 2)).' + for direction = find(mesh.fixed(node, :)) + fprintf(fid, 'D,%d,%s\n', node, directions(direction)); + end +end +fprintf(fid, '\n'); + +fprintf(fid, '!CARGAS APLICADAS\n'); +fprintf(fid, '\n'); + +fprintf(fid, '/VIEW,1,0,-1,0\n'); +fprintf(fid, 'EPLOT\n'); +fprintf(fid, '\n'); + +fprintf(fid, '!ESTADO DAS BARRAS\n'); +fprintf(fid, '!BARRAS INTACTAS = %d\n', counts.intact); +fprintf(fid, '!BARRAS DANIFICADAS = %d\n', counts.damaged); +fprintf(fid, '!BARRAS ROMPIDAS = %d\n', counts.broken); +fprintf(fid, '\n'); +end diff --git a/src/+ldem/+io/exportVtk.m b/src/+ldem/+io/exportVtk.m new file mode 100644 index 0000000..5fdaa03 --- /dev/null +++ b/src/+ldem/+io/exportVtk.m @@ -0,0 +1,92 @@ +function exportVtk(path, mesh, state) +%EXPORTVTK Write the current state as a VTK unstructured grid (.vtu). +% +% ldem.io.exportVtk(path, mesh, state) writes an XML VTK file that opens in +% ParaView (or any VTK reader). The lattice is drawn as line cells. +% +% Points are the current node positions. Data stored: +% +% Point data displacement (current minus initial position [m]) and +% velocity [m/s], both 3-component vectors. +% Cell data damageState (0 intact, 1 damaged, 2 broken), strain, +% axialForce [N] (tension positive) and barType (1 grid +% edge, 2 centre bar, 3 diagonal). +% +% The file is ASCII so that it can be inspected and diffed. To follow a +% whole simulation, ldem.io.SnapshotWriter writes one file per snapshot +% and a .pvd collection that ParaView opens as a time series. +% +% Inputs: +% path Path of the .vtu file to create. +% mesh Struct from ldem.mesh.buildMesh. +% state Solver state. +% +% Errors: +% ldem:io:cannotOpenFile The file cannot be created. +% +% Example: +% ldem.io.exportVtk("step100.vtu", mesh, state); +% +% See also ldem.io.exportAnsys, ldem.io.SnapshotWriter, ldem.io.writePvd. + +arguments + path (1,1) string + mesh (1,1) struct + state (1,1) struct +end + +fid = fopen(path, 'w'); +if fid == -1 + error('ldem:io:cannotOpenFile', 'Cannot create the VTK file "%s".', path); +end +closer = onCleanup(@() fclose(fid)); + +nNodes = size(state.displacement, 1); +nBars = size(mesh.bars, 1); + +damageState = 2 * ones(nBars, 1); % broken +damageState(state.history.isUnbroken) = 1; % damaged +damageState(state.history.isUndamaged) = 0; % intact + +fprintf(fid, '\n'); +fprintf(fid, '\n'); +fprintf(fid, '\n'); +fprintf(fid, '\n', nNodes, nBars); + +fprintf(fid, '\n'); +writeArray(fid, 'Float64', 'displacement', 3, '%.9g', state.displacement - mesh.nodes0); +writeArray(fid, 'Float64', 'velocity', 3, '%.9g', state.velocity); +fprintf(fid, '\n'); + +fprintf(fid, '\n'); +writeArray(fid, 'Int32', 'damageState', 1, '%d', damageState); +writeArray(fid, 'Float64', 'strain', 1, '%.9g', state.strain); +writeArray(fid, 'Float64', 'axialForce', 1, '%.9g', state.axialForce); +if isfield(mesh, 'barType') + writeArray(fid, 'Int32', 'barType', 1, '%d', mesh.barType); +end +fprintf(fid, '\n'); + +fprintf(fid, '\n'); +writeArray(fid, 'Float64', 'position', 3, '%.9g', state.displacement); +fprintf(fid, '\n'); + +fprintf(fid, '\n'); +writeArray(fid, 'Int32', 'connectivity', 1, '%d', mesh.bars - 1); % VTK counts from 0 +writeArray(fid, 'Int32', 'offsets', 1, '%d', 2 * (1:nBars).'); +writeArray(fid, 'UInt8', 'types', 1, '%d', 3 * ones(nBars, 1)); % 3 = VTK_LINE +fprintf(fid, '\n'); + +fprintf(fid, '\n'); +fprintf(fid, '\n'); +fprintf(fid, '\n'); +end + +function writeArray(fid, type, name, nComponents, format, data) +%WRITEARRAY Write one ASCII ; rows of data are the tuples. +fprintf(fid, '\n', ... + type, name, nComponents); +rowFormat = [strjoin(repmat({format}, 1, nComponents), ' ') '\n']; +fprintf(fid, rowFormat, data.'); +fprintf(fid, '\n'); +end diff --git a/src/+ldem/+io/saveResults.m b/src/+ldem/+io/saveResults.m new file mode 100644 index 0000000..80950dc --- /dev/null +++ b/src/+ldem/+io/saveResults.m @@ -0,0 +1,34 @@ +function saveResults(path, results) +%SAVERESULTS Save the results struct of a simulation to a MAT-file. +% +% ldem.io.saveResults(path, results) stores the struct in a MAT-file that +% is loaded with +% +% data = load(path); +% results = data.results; +% +% The file uses the v7.3 format, which supports variables larger than 2 GB +% and is readable from Python (h5py) and other languages. The results +% contain only plain structs and arrays, so no ldem class is needed to load +% them. +% +% Inputs: +% path Path of the .mat file; its folder is created if needed. +% results Struct returned by ldem.runSimulation. +% +% Example: +% ldem.io.saveResults("output/results.mat", results); +% +% See also ldem.runSimulation. + +arguments + path (1,1) string + results (1,1) struct +end + +folder = fileparts(path); +if strlength(folder) > 0 && ~isfolder(folder) + mkdir(folder); +end +save(path, 'results', '-v7.3'); +end diff --git a/src/+ldem/+io/writePvd.m b/src/+ldem/+io/writePvd.m new file mode 100644 index 0000000..fb68299 --- /dev/null +++ b/src/+ldem/+io/writePvd.m @@ -0,0 +1,49 @@ +function writePvd(path, times, files) +%WRITEPVD Write a ParaView collection (.pvd) that groups VTK files in time. +% +% ldem.io.writePvd(path, times, files) creates a small XML file that lists +% the given .vtu files with their simulation times. Opening it in ParaView +% loads the whole series and enables the time slider. +% +% File names are stored relative to the .pvd file, so the folder can be +% moved or zipped. +% +% Inputs: +% path Path of the .pvd file to create. +% times Simulation times [s], one per file. +% files File names of the .vtu files (same folder as the .pvd). +% +% Errors: +% ldem:io:cannotOpenFile The file cannot be created. +% +% Example: +% ldem.io.writePvd("series.pvd", [0 1e-4], ["a.vtu" "b.vtu"]); +% +% See also ldem.io.exportVtk, ldem.io.SnapshotWriter. + +arguments + path (1,1) string + times (:,1) double + files (:,1) string +end + +if numel(times) ~= numel(files) + error('ldem:io:sizeMismatch', ... + 'times (%d) and files (%d) must have the same length.', numel(times), numel(files)); +end + +fid = fopen(path, 'w'); +if fid == -1 + error('ldem:io:cannotOpenFile', 'Cannot create the PVD file "%s".', path); +end +closer = onCleanup(@() fclose(fid)); + +fprintf(fid, '\n'); +fprintf(fid, '\n'); +fprintf(fid, '\n'); +for k = 1:numel(files) + fprintf(fid, '\n', times(k), files(k)); +end +fprintf(fid, '\n'); +fprintf(fid, '\n'); +end diff --git a/src/+ldem/+post/plotEnergy.m b/src/+ldem/+post/plotEnergy.m new file mode 100644 index 0000000..942394d --- /dev/null +++ b/src/+ldem/+post/plotEnergy.m @@ -0,0 +1,48 @@ +function ax = plotEnergy(results, ax) +%PLOTENERGY Plot the energies of a simulation versus time. +% +% ax = ldem.post.plotEnergy(results) draws the kinetic, elastic, damage and +% damping energies, and their sum, in the current axes (a new figure if +% there are none). +% +% ax = ldem.post.plotEnergy(results, ax) draws in the given axes. +% +% Inputs: +% results Struct returned by ldem.runSimulation. +% ax (optional) Axes object. +% +% Output: +% ax The axes used. +% +% Errors: +% ldem:post:noData The results contain no energy history (set +% params.output.energyEvery > 0). +% +% Example: +% results = ldem.runSimulation(ldem.Parameters()); +% ldem.post.plotEnergy(results); +% +% See also ldem.post.plotReaction, ldem.runSimulation. + +arguments + results (1,1) struct + ax = [] +end + +e = results.energy; +if isempty(e.time) + error('ldem:post:noData', ... + 'The results contain no energy history. Set params.output.energyEvery to a positive number.'); +end +if isempty(ax) + ax = gca; +end + +plot(ax, e.time, e.kinetic, e.time, e.elastic, e.time, e.damage, e.time, e.damping, ... + e.time, e.internal, 'k--', 'LineWidth', 1.2); +legend(ax, 'Kinetic', 'Elastic', 'Damage', 'Damping', 'Total', 'Location', 'best'); +xlabel(ax, 'Time [s]'); +ylabel(ax, 'Energy [J]'); +title(ax, 'Energies'); +grid(ax, 'on'); +end diff --git a/src/+ldem/+post/plotReaction.m b/src/+ldem/+post/plotReaction.m new file mode 100644 index 0000000..6ebce5b --- /dev/null +++ b/src/+ldem/+post/plotReaction.m @@ -0,0 +1,50 @@ +function ax = plotReaction(results, ax) +%PLOTREACTION Plot the reaction force of the test versus time. +% +% ax = ldem.post.plotReaction(results) draws the components of the +% reaction force that are defined for the test of the simulation (for the +% beam test only the vertical one) in the current axes. +% +% ax = ldem.post.plotReaction(results, ax) draws in the given axes. +% +% Inputs: +% results Struct returned by ldem.runSimulation. +% ax (optional) Axes object. +% +% Output: +% ax The axes used. +% +% Errors: +% ldem:post:noData The test defines no reaction, or none was stored +% (set params.output.controlNodesEvery > 0). +% +% Example: +% results = ldem.runSimulation(ldem.Parameters(testId=102, nModules=[70 4 3])); +% ldem.post.plotReaction(results); +% +% See also ldem.post.plotEnergy, ldem.runSimulation. + +arguments + results (1,1) struct + ax = [] +end + +r = results.reactions; +defined = ~all(isnan(r.force), 1) & any(r.force ~= 0, 1); +if isempty(r.time) || ~any(defined) + error('ldem:post:noData', ... + ['The simulation has no reaction force: the test does not define one or ' ... + 'params.output.controlNodesEvery is 0.']); +end +if isempty(ax) + ax = gca; +end + +names = ["Rx", "Ry", "Rz"]; +plot(ax, r.time, r.force(:, defined), 'LineWidth', 1.2); +legend(ax, names(defined), 'Location', 'best'); +xlabel(ax, 'Time [s]'); +ylabel(ax, 'Reaction force [N]'); +title(ax, 'Reaction force'); +grid(ax, 'on'); +end diff --git a/src/+ldem/+scenarios/FourPointBending.m b/src/+ldem/+scenarios/FourPointBending.m index 1dcdc25..9d86cc3 100644 --- a/src/+ldem/+scenarios/FourPointBending.m +++ b/src/+ldem/+scenarios/FourPointBending.m @@ -1,16 +1,24 @@ classdef FourPointBending < ldem.scenarios.Scenario - %FOURPOINTBENDING Beam loaded at two points and supported at two points (TEST 102). + %FOURPOINTBENDING Beam with two supports and a load point (TEST 102). % - % The beam is supported near both ends and loaded by prescribed - % vertical displacements at the quarter points. This class defines the - % supports; the loading is added with the solver. + % The beam is supported near both ends. A load point on the top face, + % 33.5 modules from the right end, is moved down with a constant + % velocity. % % The positions are expressed in module units, as in the legacy code - % (supports at 4 modules from each end, loads at 33.5 modules from - % each end), so the scenario only makes sense for beams longer than - % about 70 modules. See legacy/KNOWN_ISSUES.md, item 5. + % (supports at 4 modules from each end, load points at 33.5 modules + % from each end), so the scenario only makes sense for beams longer + % than about 70 modules. % - % Legacy: the "TEST == 102" branch of BOUND. + % Behaviour reproduced from the legacy code (see + % legacy/KNOWN_ISSUES.md, items 5 and 11): there are two load points + % and both are held in y, but only the right one is actually moved; + % the left one stays at its initial height and acts as a support. + % + % Create it with a different velocity using + % scenario = ldem.scenarios.FourPointBending(loadingVelocity=1e-3); + % + % Legacy: the "TEST == 102" branches of BOUND, CALOAD and CALRES. % % See also ldem.scenarios.Scenario. @@ -18,13 +26,29 @@ testId = 102 end + properties + % Downward velocity of the loaded nodes [m/s]. Legacy: VF2 = 400e-5. + loadingVelocity (1,1) double {mustBeFinite} = 400e-5 + end + methods + function obj = FourPointBending(props) + %FOURPOINTBENDING Create the scenario, optionally with a new velocity. + arguments + props.?ldem.scenarios.FourPointBending + end + names = fieldnames(props); + for k = 1:numel(names) + obj.(names{k}) = props.(names{k}); + end + end + function fixed = fixedDofs(obj, nodes0, params) %FIXEDDOFS Supports and load points of the beam. % % Fixes x and y at the left support, y at the right support, - % and y at the two load points on the top face (their - % y-motion is then imposed by the loading routine). + % and y at the two load points on the top face (the y-motion + % of the right one is then imposed by applyLoads). arguments obj (1,1) ldem.scenarios.FourPointBending %#ok nodes0 (:,3) double @@ -50,5 +74,53 @@ fixed(leftSupport, 1) = true; fixed(leftSupport | rightSupport | loadRight | loadLeft, 2) = true; end + + function loaded = loadedNodes(obj, nodes0, params) + %LOADEDNODES Logical vector of the nodes that are moved down. + % + % Only the load point at 33.5 modules from the right end (see the + % class description). + arguments + obj (1,1) ldem.scenarios.FourPointBending %#ok + nodes0 (:,3) double + params (1,1) ldem.Parameters + end + LCO = params.moduleLength; + M1 = params.nModules(1) - 1; + N1 = params.nModules(2) - 1; + x = nodes0(:, 1); + y = nodes0(:, 2); + loaded = (x < (M1 - 33.49) * LCO) & (x > (M1 - 33.51) * LCO) & ... + (y < (N1 - 0.49) * LCO) & (y > (N1 - 0.51) * LCO); + end + + function state = applyLoads(obj, state, mesh, params) + %APPLYLOADS Move the loaded nodes to y0 - loadingVelocity*time. + arguments + obj (1,1) ldem.scenarios.FourPointBending + state (1,1) struct + mesh (1,1) struct + params (1,1) ldem.Parameters + end + loaded = obj.loadedNodes(mesh.nodes0, params); + state.displacement(loaded, 2) = mesh.nodes0(loaded, 2) - obj.loadingVelocity * state.time; + end + + function reaction = reactions(obj, state, mesh, params) + %REACTIONS Vertical force carried by the nodes held in y at the top. + % + % Returns [0 Ry 0] where Ry is the sum of the y-component of the + % bar forces on the nodes held in y whose initial height is + % (N-1.51) modules or more, that is, the load points. + arguments + obj (1,1) ldem.scenarios.FourPointBending %#ok + state (1,1) struct + mesh (1,1) struct + params (1,1) ldem.Parameters + end + N1 = params.nModules(2) - 1; + atTop = mesh.fixed(:, 2) & (mesh.nodes0(:, 2) >= params.moduleLength * (N1 - 0.51)); + reaction = [0, sum(state.force(atTop, 2)), 0]; + end end end diff --git a/src/+ldem/+scenarios/Scenario.m b/src/+ldem/+scenarios/Scenario.m index 8b04aaf..96094b7 100644 --- a/src/+ldem/+scenarios/Scenario.m +++ b/src/+ldem/+scenarios/Scenario.m @@ -1,15 +1,16 @@ classdef (Abstract) Scenario - %SCENARIO Base class of the test cases (boundary conditions and loads). + %SCENARIO Base class of the test cases (supports, loads and reactions). % % A scenario defines everything that is specific to one kind of test: - % which degrees of freedom are fixed, and (in later versions of the - % package) how the load is applied and which results are extracted. - % The solver never checks the test number; it asks the scenario. + % which degrees of freedom are fixed, how the load is applied at every + % time step and which reaction force is reported. The solver never + % checks the test number; it asks the scenario. % % To add a new test, create a subclass in this folder: % 1. Set the constant property testId to a new number. - % 2. Implement fixedDofs. - % 3. Register the class in ldem.scenarios.fromTestId. + % 2. Implement fixedDofs and applyLoads. + % 3. Optionally override reactions. + % 4. Register the class in ldem.scenarios.fromTestId. % % See also ldem.scenarios.UniaxialTension, % ldem.scenarios.FourPointBending, ldem.scenarios.fromTestId. @@ -30,5 +31,30 @@ % nodes0 nNodes-by-3 initial coordinates [m]. % params ldem.Parameters. fixed = fixedDofs(obj, nodes0, params) + + % APPLYLOADS Impose the loading of the current time step. + % + % state = scenario.applyLoads(state, mesh, params) modifies the + % current displacements (state.displacement) of the loaded nodes + % for the time state.time. It is called once per step, before the + % bar forces are computed. + % + % Inputs: + % state Solver state, see ldem.solver.initialState. + % mesh Struct from ldem.mesh.buildMesh. + % params ldem.Parameters. + state = applyLoads(obj, state, mesh, params) + end + + methods + function reaction = reactions(obj, state, mesh, params) %#ok + %REACTIONS Reaction force of the test as [Rx Ry Rz] [N]. + % + % reaction = scenario.reactions(state, mesh, params) returns the + % force that the test reports for the current step. The + % default is NaN(1,3), meaning "not defined for this test"; + % subclasses override it. + reaction = NaN(1, 3); + end end end diff --git a/src/+ldem/+scenarios/UniaxialTension.m b/src/+ldem/+scenarios/UniaxialTension.m index 5895865..0ef607b 100644 --- a/src/+ldem/+scenarios/UniaxialTension.m +++ b/src/+ldem/+scenarios/UniaxialTension.m @@ -1,9 +1,17 @@ classdef UniaxialTension < ldem.scenarios.Scenario %UNIAXIALTENSION Prism loaded by a prescribed axial displacement (TEST 101). % - % The prism is pulled (or compressed) along x by imposing a - % displacement velocity on the last column of centre nodes. This class - % defines the supports; the loading is added with the solver. + % The centre nodes of the last column of the prism are moved along x + % with a constant velocity, while the centre nodes of the first column + % are held in x. + % + % Sign convention (as in the legacy code): the loaded nodes move to + % x0 - loadingVelocity*time, so a positive loadingVelocity pushes them + % toward the fixed end and COMPRESSES the prism. Use a negative value + % to pull it. The comment of the legacy code says "tension". + % + % Create it with a different velocity using + % scenario = ldem.scenarios.UniaxialTension(loadingVelocity=1e-3); % % Legacy: the "TEST == 101" branches of BOUND and CALOAD. % @@ -13,7 +21,23 @@ testId = 101 end + properties + % Velocity of the loaded nodes along -x [m/s]. Legacy: VF2 = 400e-5. + loadingVelocity (1,1) double {mustBeFinite} = 400e-5 + end + methods + function obj = UniaxialTension(props) + %UNIAXIALTENSION Create the scenario, optionally with a new velocity. + arguments + props.?ldem.scenarios.UniaxialTension + end + names = fieldnames(props); + for k = 1:numel(names) + obj.(names{k}) = props.(names{k}); + end + end + function fixed = fixedDofs(obj, nodes0, params) %FIXEDDOFS Fix the x-motion of the centre nodes of both end faces. % @@ -37,5 +61,32 @@ fixed = false(size(nodes0)); fixed(leftEnd | rightEnd, 1) = true; end + + function loaded = loadedNodes(obj, nodes0, params) + %LOADEDNODES Logical vector of the nodes with prescribed motion. + % + % They are the centre nodes of the last column of modules. + arguments + obj (1,1) ldem.scenarios.UniaxialTension %#ok + nodes0 (:,3) double + params (1,1) ldem.Parameters + end + LCO = params.moduleLength; + M1 = params.nModules(1) - 1; + x = nodes0(:, 1); + loaded = (x < (M1 - 0.49) * LCO) & (x > (M1 - 0.51) * LCO); + end + + function state = applyLoads(obj, state, mesh, params) + %APPLYLOADS Move the loaded nodes to x0 - loadingVelocity*time. + arguments + obj (1,1) ldem.scenarios.UniaxialTension + state (1,1) struct + mesh (1,1) struct + params (1,1) ldem.Parameters + end + loaded = obj.loadedNodes(mesh.nodes0, params); + state.displacement(loaded, 1) = mesh.nodes0(loaded, 1) - obj.loadingVelocity * state.time; + end end end diff --git a/src/+ldem/+solver/computeBarForces.m b/src/+ldem/+solver/computeBarForces.m new file mode 100644 index 0000000..b4eb311 --- /dev/null +++ b/src/+ldem/+solver/computeBarForces.m @@ -0,0 +1,85 @@ +function state = computeBarForces(state, mesh, barProps, params) +%COMPUTEBARFORCES Axial force of every bar and resulting nodal forces. +% +% state = ldem.solver.computeBarForces(state, mesh, barProps, params) +% measures the strain and strain rate of every bar in the current +% configuration, evaluates the constitutive law (damage included) and +% adds each bar force to its two end nodes. +% +% For a bar from node i to node j with current length L, direction +% cosines c = (xj - xi)/L and axial force F (tension positive), the bar +% pulls node i toward j with +F*c and node j toward i with -F*c. +% The strain is (L - L0)/L0 and the rate is the strain change since the +% previous step divided by dt. +% +% Inputs: +% state Solver state, see ldem.solver.initialState. +% mesh Struct from ldem.mesh.buildMesh. +% barProps Struct from ldem.material.buildBarProperties. +% params ldem.Parameters. +% +% Output: +% state The input state with force, strain, strainRate, axialForce and +% history updated. +% +% Errors: +% ldem:solver:zeroLengthBar Two end nodes coincide in the current +% configuration. +% +% Legacy: CABAR. +% +% See also ldem.material.bilinearLaw, ldem.solver.integrateStep. + +arguments + state (1,1) struct + mesh (1,1) struct + barProps (1,1) struct + params (1,1) ldem.Parameters +end + +first = mesh.bars(:, 1); +second = mesh.bars(:, 2); +initialLength = mesh.barLength; + +% Current configuration and the one of the previous step. +delta = state.displacement(second, :) - state.displacement(first, :); +currentLength = sqrt(delta(:, 1) .* delta(:, 1) + delta(:, 2) .* delta(:, 2) + delta(:, 3) .* delta(:, 3)); + +deltaPrevious = state.previousDisplacement(second, :) - state.previousDisplacement(first, :); +previousLength = sqrt(deltaPrevious(:, 1) .* deltaPrevious(:, 1) + ... + deltaPrevious(:, 2) .* deltaPrevious(:, 2) + deltaPrevious(:, 3) .* deltaPrevious(:, 3)); + +if any(currentLength == 0) + error('ldem:solver:zeroLengthBar', ... + 'Bar %d has zero length at step %d: its two nodes coincide.', ... + find(currentLength == 0, 1), state.step); +end + +directionCosines = delta ./ currentLength; + +strain = (currentLength - initialLength) ./ initialLength; +oldStrain = (previousLength - initialLength) ./ initialLength; +strainRate = (strain - oldStrain) / params.dt; + +[axialForce, history] = ldem.material.bilinearLaw( ... + strain, strainRate, barProps, state.history, params.constitutiveDamping); + +% Add the bar forces to the nodes. The contributions are listed bar by bar +% (start node +, end node -) so that, for every node, they are summed in the +% same order as a loop over the bars; this keeps the rounding identical to +% the legacy code. +nNodes = size(state.displacement, 1); +nodeIndex = reshape([first, second].', [], 1); +nodalForce = zeros(nNodes, 3); +for direction = 1:3 + component = axialForce .* directionCosines(:, direction); + contributions = reshape([component, -component].', [], 1); + nodalForce(:, direction) = accumarray(nodeIndex, contributions, [nNodes, 1]); +end + +state.force = nodalForce; +state.strain = strain; +state.strainRate = strainRate; +state.axialForce = axialForce; +state.history = history; +end diff --git a/src/+ldem/+solver/computeEnergies.m b/src/+ldem/+solver/computeEnergies.m new file mode 100644 index 0000000..7d9453d --- /dev/null +++ b/src/+ldem/+solver/computeEnergies.m @@ -0,0 +1,81 @@ +function energy = computeEnergies(state, mesh, barProps, params) +%COMPUTEENERGIES Energies of the system at the current state. +% +% energy = ldem.solver.computeEnergies(state, mesh, barProps, params) +% returns the energies [J], all of them scalars. +% +% Fields of energy: +% +% time Simulated time [s]. +% kinetic Sum of m*|v|^2/2 over all nodes. +% elastic Sum of E*strain^2*L/2 over the bars (tension or compression stiffness). +% damage Energy dissipated by softening in the damaged bars. +% damping Energy dissipated by damping so far (state.dampingEnergy). +% internal kinetic + elastic + damage + damping. +% brokenBars Total fracture energy of the bars that have broken. +% damageRate Change of the damage energy per unit time since the previous step [W]. +% +% For a damaged bar with critical strain EP, largest strain EM and +% stiffnesses E1 (compression) and E2 (tension), the energy dissipated is +% L/2 times E1*EP^2 - E2*EM^2 + (E1*EP + E2*EM)*(EM - EP). +% For a broken bar the total fracture energy is L/2 * E1*EP^2*KR. +% +% Inputs: +% state Solver state after ldem.solver.integrateStep. +% mesh Struct from ldem.mesh.buildMesh. +% barProps Struct from ldem.material.buildBarProperties. +% params ldem.Parameters. +% +% Output: +% energy Struct with the fields above plus time. +% +% Example: +% energy = ldem.solver.computeEnergies(state, mesh, barProps, params); +% +% Legacy: ENERG2. There the kinetic and damping energies were vectors (one +% entry per node) that were never summed; here they are scalars. The +% external work (ENEX) was never computed and is not provided. +% +% See also ldem.solver.simulate. + +arguments + state (1,1) struct + mesh (1,1) struct + barProps (1,1) struct + params (1,1) ldem.Parameters +end + +% Kinetic energy. +speedSquared = state.velocity(:, 1).^2 + state.velocity(:, 2).^2 + state.velocity(:, 3).^2; +kinetic = sum(mesh.mass .* speedSquared ./ 2.0); + +% Elastic energy of the bars. +E1 = barProps.stiffness; +E2 = state.history.tensionStiffness; +strain = state.strain; +stiffness = E1; +stiffness(strain >= 0.0) = E2(strain >= 0.0); +elastic = sum(stiffness .* (strain .* strain .* mesh.barLength ./ 2)); + +% Energy dissipated by damage. +EP = barProps.criticalStrain; +EM = state.history.maxStrain; +damaged = ~state.history.isUndamaged; +area = E1 .* EP .* EP - E2 .* EM .* EM + (E1 .* EP + E2 .* EM) .* (EM - EP); +damage = sum(mesh.barLength(damaged) .* area(damaged) ./ 2); + +% Fracture energy of the bars that are completely broken. +broken = damaged & ~state.history.isUnbroken; +brokenBars = sum(E1(broken) .* EP(broken) .* EP(broken) .* barProps.ruptureRatio(broken) ... + .* mesh.barLength(broken) ./ 2); + +energy = struct(); +energy.time = state.time; +energy.kinetic = kinetic; +energy.elastic = elastic; +energy.damage = damage; +energy.damping = state.dampingEnergy; +energy.internal = kinetic + elastic + damage + state.dampingEnergy; +energy.brokenBars = brokenBars; +energy.damageRate = (damage - state.previousDamageEnergy) / params.dt; +end diff --git a/src/+ldem/+solver/dampingCoefficient.m b/src/+ldem/+solver/dampingCoefficient.m new file mode 100644 index 0000000..1ed902c --- /dev/null +++ b/src/+ldem/+solver/dampingCoefficient.m @@ -0,0 +1,39 @@ +function coefficient = dampingCoefficient(step, params) +%DAMPINGCOEFFICIENT Mass-proportional damping coefficient of a time step. +% +% coefficient = ldem.solver.dampingCoefficient(step, params) returns +% params.dampingInitial before the switch step and params.dampingFinal +% from the switch step on (params.dampingSwitchStep = round(TDAF/dt)). +% +% If the switch step is zero (dampingSwitchTime shorter than half a time +% step) the coefficient never changes and dampingInitial is used. This +% reproduces the legacy code, which only switched when STEP == NDAMF and +% steps start at 1. +% +% Inputs: +% step Time step number (1, 2, ...). +% params ldem.Parameters. +% +% Output: +% coefficient Damping coefficient [1/s]. +% +% Example: +% c = ldem.solver.dampingCoefficient(100, params); +% +% Legacy: the damping change at the top of the time loop of the main +% program (DF1 = DF2 when STEP == NDAMF). +% +% See also ldem.solver.integrateStep. + +arguments + step (1,1) double {mustBeInteger, mustBePositive} + params (1,1) ldem.Parameters +end + +switchStep = params.dampingSwitchStep; +if switchStep >= 1 && step >= switchStep + coefficient = params.dampingFinal; +else + coefficient = params.dampingInitial; +end +end diff --git a/src/+ldem/+solver/initialState.m b/src/+ldem/+solver/initialState.m new file mode 100644 index 0000000..381fdb0 --- /dev/null +++ b/src/+ldem/+solver/initialState.m @@ -0,0 +1,63 @@ +function state = initialState(mesh, history) +%INITIALSTATE State of the simulation at time zero. +% +% state = ldem.solver.initialState(mesh, history) creates the struct that +% the time-stepping routines update. All nodes start at their initial +% position, at rest and without forces; the bars start undamaged. +% +% The explicit central-difference scheme needs the displacement of two +% consecutive times, so the state holds both (at time zero they are equal). +% +% Inputs: +% mesh Struct from ldem.mesh.buildMesh. +% history Initial damage state from ldem.material.buildBarProperties. +% +% Output: +% state Struct with the fields listed below. +% +% Fields of state: +% +% step Number of the last completed step (0). +% time Simulated time [s]. +% displacement nNodes-by-3 current positions [m] (legacy U(2,:), V(2,:), W(2,:)). +% previousDisplacement nNodes-by-3 positions one step before (legacy U(1,:), V(1,:), W(1,:)). +% velocity nNodes-by-3 velocities [m/s]. +% acceleration nNodes-by-3 accelerations [m/s^2]. +% force nNodes-by-3 force of the bars on the nodes [N] (legacy FRX, FRY, FRZ). +% strain nBars-by-1 axial strain (legacy SS). +% strainRate nBars-by-1 strain rate [1/s] (legacy DSS). +% axialForce nBars-by-1 axial force [N], tension positive (legacy F). +% history Damage state of the bars. +% dampingEnergy Energy dissipated by damping so far [J]. +% previousDamageEnergy Energy dissipated by damage at the previous step [J]. +% +% Example: +% state = ldem.solver.initialState(mesh, history); +% +% Legacy: INI_DEM3 (allocation) and the initial values set by COORDSUB. +% +% See also ldem.solver.simulate. + +arguments + mesh (1,1) struct + history (1,1) struct +end + +nNodes = size(mesh.nodes0, 1); +nBars = size(mesh.bars, 1); + +state = struct(); +state.step = 0; +state.time = 0.0; +state.displacement = mesh.nodes0; +state.previousDisplacement = mesh.nodes0; +state.velocity = zeros(nNodes, 3); +state.acceleration = zeros(nNodes, 3); +state.force = zeros(nNodes, 3); +state.strain = zeros(nBars, 1); +state.strainRate = zeros(nBars, 1); +state.axialForce = zeros(nBars, 1); +state.history = history; +state.dampingEnergy = 0.0; +state.previousDamageEnergy = 0.0; +end diff --git a/src/+ldem/+solver/integrateStep.m b/src/+ldem/+solver/integrateStep.m new file mode 100644 index 0000000..ad410c2 --- /dev/null +++ b/src/+ldem/+solver/integrateStep.m @@ -0,0 +1,91 @@ +function state = integrateStep(state, mesh, barProps, params) +%INTEGRATESTEP Advance the node positions one time step. +% +% state = ldem.solver.integrateStep(state, mesh, barProps, params) solves +% the equation of motion of every free degree of freedom with the explicit +% central-difference scheme +% +% m * (u_next - 2*u + u_prev)/dt^2 + c*m * (u_next - u_prev)/(2*dt) = F +% +% where F is the bar force on the node, m its lumped mass and c the +% mass-proportional damping coefficient of the step, which gives +% +% u_next = (dt^2/m * F + 2*u - (1 - c*dt/2)*u_prev) / (1 + c*dt/2) +% +% Degrees of freedom fixed by the scenario keep their current value. After +% the update the velocity and acceleration are obtained with central +% differences, the energy dissipated by damping is accumulated and the two +% stored positions are shifted (current -> previous, next -> current). +% +% The energy dissipated in the step has two parts: the mass-proportional +% damping of the nodes, c*(m/2)*v*(u_next - u_prev), and the viscous term +% of the constitutive law, E*CON*rate^2*dt*L for every bar (E is the +% compression stiffness for compressed bars and the tension stiffness +% otherwise). +% +% Inputs: +% state Solver state after ldem.solver.computeBarForces. +% mesh Struct from ldem.mesh.buildMesh (mass, fixed, barLength). +% barProps Struct from ldem.material.buildBarProperties. +% params ldem.Parameters. +% +% Output: +% state Updated: displacement, previousDisplacement, velocity, +% acceleration and dampingEnergy. +% +% Errors: +% ldem:solver:zeroMass A node has zero mass. +% +% Legacy: IGN012 (nested function ign012). The legacy acceleration in y +% used a wrong index (V(2,I) instead of V(2,:)); here it is computed like +% the other two components. +% +% See also ldem.solver.computeBarForces, ldem.solver.dampingCoefficient. + +arguments + state (1,1) struct + mesh (1,1) struct + barProps (1,1) struct + params (1,1) ldem.Parameters +end + +if any(mesh.mass == 0) + error('ldem:solver:zeroMass', 'Node %d has zero mass.', find(mesh.mass == 0, 1)); +end + +dt = params.dt; +ddt = 2.0 * dt; +sdt = dt * dt; + +c = ldem.solver.dampingCoefficient(state.step, params); +dampingPrevious = 1.0 - c * dt / 2.0; +dampingNext = 1.0 + c * dt / 2.0; + +u = state.displacement; +uPrev = state.previousDisplacement; +timeFactor = sdt ./ mesh.mass; % nNodes-by-1, applies to x, y and z + +uNext = (timeFactor .* state.force + 2.0 .* u - dampingPrevious .* uPrev) ./ dampingNext; +uNext(mesh.fixed) = u(mesh.fixed); + +velocity = (uNext - uPrev) ./ ddt; +acceleration = (uNext - u .* 2.0 + uPrev) ./ sdt; + +% Energy dissipated by mass-proportional damping (all nodes and directions). +nodeDamping = (c .* (mesh.mass ./ 2.0)) .* velocity .* (uNext - uPrev); +dissipated = sum(nodeDamping, 'all'); + +% Energy dissipated by the viscous term of the constitutive law. +isCompressed = state.strain < 0.0; +stiffness = state.history.tensionStiffness; +stiffness(isCompressed) = barProps.stiffness(isCompressed); +barViscous = 2.0 * (stiffness .* params.constitutiveDamping .* state.strainRate .* ... + state.strainRate .* dt .* mesh.barLength ./ 2.0); +dissipated = dissipated + sum(barViscous); + +state.dampingEnergy = state.dampingEnergy + dissipated; +state.previousDisplacement = u; +state.displacement = uNext; +state.velocity = velocity; +state.acceleration = acceleration; +end diff --git a/src/+ldem/+solver/simulate.m b/src/+ldem/+solver/simulate.m new file mode 100644 index 0000000..9cdcce7 --- /dev/null +++ b/src/+ldem/+solver/simulate.m @@ -0,0 +1,177 @@ +function [state, record] = simulate(params, mesh, barProps, history, scenario, options) +%SIMULATE Run the explicit time integration of an LDEM model. +% +% [state, record] = ldem.solver.simulate(params, mesh, barProps, history, scenario) +% advances the model from time zero to params.totalTime and returns the +% final state and the results recorded along the way. +% +% Every step does, in this order: +% 1. advance the time, +% 2. impose the loading of the scenario, +% 3. compute the bar forces (damage included), +% 4. integrate the equations of motion, +% 5. compute the energies and store the requested results. +% +% Inputs: +% params ldem.Parameters. +% mesh Struct from ldem.mesh.buildMesh. +% barProps Struct from ldem.material.buildBarProperties. +% history Initial damage state, second output of buildBarProperties. +% scenario Object of a subclass of ldem.scenarios.Scenario. +% +% Name-value options: +% +% SnapshotFcn Function handle f(state) for the snapshots (see below). +% Verbose Print the progress every 10 % (default false). +% +% SnapshotFcn is called at time zero and every params.output.snapshotEvery +% steps, and never if that value is 0. +% +% Outputs: +% state Final solver state, see ldem.solver.initialState. +% record Struct with the results stored along the run, see below. +% +% Fields of record: +% +% controlNodes time (n-by-1) and displacement, velocity, acceleration (n-by-k-by-3 for k nodes). +% reactions time (n-by-1) and force (n-by-3), the scenario reaction. +% energy time and the energies of ldem.solver.computeEnergies as column vectors. +% trackedBar bar number, time, strain, criticalStrain, ruptureStrain, force, damageEnergy. +% +% controlNodes and reactions are stored every params.output.controlNodesEvery +% steps and energy every energyEvery steps. trackedBar is stored at every +% step, only when trackedBarEvery is 1 and the bar exists in the mesh. +% +% Errors: +% ldem:solver:nonFinite A displacement became NaN or Inf (unstable +% time step or coincident nodes). +% +% Example: +% params = ldem.Parameters(); +% mesh = ldem.mesh.buildMesh(params); +% [barProps, history] = ldem.material.buildBarProperties(mesh, params); +% scenario = ldem.scenarios.fromTestId(params.testId); +% [state, record] = ldem.solver.simulate(params, mesh, barProps, history, scenario); +% +% Legacy: the time loop of the main program (main1) with CALOAD, CABAR, +% IGN012, CALRES, WRIDIPO, ENERG2 and WRIENE. +% +% See also ldem.solver.computeBarForces, ldem.solver.integrateStep, +% ldem.solver.computeEnergies. + +arguments + params (1,1) ldem.Parameters + mesh (1,1) struct + barProps (1,1) struct + history (1,1) struct + scenario (1,1) ldem.scenarios.Scenario + options.SnapshotFcn = [] + options.Verbose (1,1) logical = false +end + +ldem.solver.checkStability(mesh.barLength, params); + +nSteps = params.nSteps; +controlEvery = params.output.controlNodesEvery; +energyEvery = params.output.energyEvery; +snapshotEvery = params.output.snapshotEvery; +trackBar = params.output.trackedBarEvery > 0 && params.trackedBar <= size(mesh.bars, 1); + +nControl = numel(params.controlNodes); +nControlRows = floor(nSteps / max(controlEvery, 1)) * (controlEvery > 0); +nEnergyRows = floor(nSteps / max(energyEvery, 1)) * (energyEvery > 0); + +record = struct(); +record.controlNodes = struct( ... + 'time', zeros(nControlRows, 1), ... + 'displacement', zeros(nControlRows, nControl, 3), ... + 'velocity', zeros(nControlRows, nControl, 3), ... + 'acceleration', zeros(nControlRows, nControl, 3)); +record.reactions = struct('time', zeros(nControlRows, 1), 'force', zeros(nControlRows, 3)); +record.energy = struct('time', zeros(nEnergyRows, 1), 'kinetic', zeros(nEnergyRows, 1), ... + 'elastic', zeros(nEnergyRows, 1), 'damage', zeros(nEnergyRows, 1), ... + 'damping', zeros(nEnergyRows, 1), 'internal', zeros(nEnergyRows, 1), ... + 'brokenBars', zeros(nEnergyRows, 1), 'damageRate', zeros(nEnergyRows, 1)); +nTracked = nSteps * trackBar; +record.trackedBar = struct('bar', params.trackedBar, 'time', zeros(nTracked, 1), ... + 'strain', zeros(nTracked, 1), 'criticalStrain', zeros(nTracked, 1), ... + 'ruptureStrain', zeros(nTracked, 1), 'force', zeros(nTracked, 1), ... + 'damageEnergy', zeros(nTracked, 1)); + +state = ldem.solver.initialState(mesh, history); +if snapshotEvery > 0 && ~isempty(options.SnapshotFcn) + options.SnapshotFcn(state); +end + +controlRow = 0; +energyRow = 0; +progressStep = max(1, floor(nSteps / 10)); + +for step = 1:nSteps + state.step = step; + state.time = state.time + params.dt; + + state = scenario.applyLoads(state, mesh, params); + state = ldem.solver.computeBarForces(state, mesh, barProps, params); + state = ldem.solver.integrateStep(state, mesh, barProps, params); + + if ~all(isfinite(state.displacement), 'all') + error('ldem:solver:nonFinite', ... + ['Displacements are not finite at step %d (time %g s). The time ' ... + 'step may be unstable or two nodes coincide.'], step, state.time); + end + + energy = ldem.solver.computeEnergies(state, mesh, barProps, params); + state.previousDamageEnergy = energy.damage; + + if controlEvery > 0 && mod(step, controlEvery) == 0 + controlRow = controlRow + 1; + record.controlNodes.time(controlRow) = state.time; + record.controlNodes.displacement(controlRow, :, :) = reshape(state.displacement(params.controlNodes, :), 1, nControl, 3); + record.controlNodes.velocity(controlRow, :, :) = reshape(state.velocity(params.controlNodes, :), 1, nControl, 3); + record.controlNodes.acceleration(controlRow, :, :) = reshape(state.acceleration(params.controlNodes, :), 1, nControl, 3); + record.reactions.time(controlRow) = state.time; + record.reactions.force(controlRow, :) = scenario.reactions(state, mesh, params); + end + + if energyEvery > 0 && mod(step, energyEvery) == 0 + energyRow = energyRow + 1; + names = fieldnames(record.energy); + for k = 1:numel(names) + record.energy.(names{k})(energyRow) = energy.(names{k}); + end + end + + if trackBar + b = params.trackedBar; + record.trackedBar.time(step) = state.time; + record.trackedBar.strain(step) = state.strain(b); + record.trackedBar.criticalStrain(step) = barProps.criticalStrain(b); + record.trackedBar.ruptureStrain(step) = barProps.ruptureStrain(b); + record.trackedBar.force(step) = state.axialForce(b); + record.trackedBar.damageEnergy(step) = trackedDamageEnergy(state, mesh, barProps, b); + end + + if snapshotEvery > 0 && mod(step, snapshotEvery) == 0 && ~isempty(options.SnapshotFcn) + options.SnapshotFcn(state); + end + + if options.Verbose && mod(step, progressStep) == 0 + fprintf(' step %d / %d (t = %.4g s)\n', step, nSteps, state.time); + end +end +end + +function value = trackedDamageEnergy(state, mesh, barProps, b) +%TRACKEDDAMAGEENERGY Energy dissipated by damage in one bar (zero if undamaged). +if state.history.isUndamaged(b) + value = 0.0; + return +end +E1 = barProps.stiffness(b); +E2 = state.history.tensionStiffness(b); +EP = barProps.criticalStrain(b); +EM = state.history.maxStrain(b); +area = E1 * EP * EP - E2 * EM * EM + (E1 * EP + E2 * EM) * (EM - EP); +value = mesh.barLength(b) * area / 2; +end diff --git a/src/+ldem/Parameters.m b/src/+ldem/Parameters.m index 3a5f77e..2f8745f 100644 --- a/src/+ldem/Parameters.m +++ b/src/+ldem/Parameters.m @@ -212,6 +212,20 @@ function validate(obj) end end + function s = toStruct(obj) + %TOSTRUCT Convert the parameters (and derived values) to a plain struct. + % + % s = p.toStruct() returns a struct with one field per property, + % derived values included. Unlike the object it can be loaded + % from a MAT-file without the ldem package on the path, so it + % is what ldem.runSimulation stores in the results. + names = properties(obj); + s = struct(); + for k = 1:numel(names) + s.(names{k}) = obj.(names{k}); + end + end + function value = get.nSteps(obj) value = round(obj.totalTime / obj.dt); end diff --git a/src/+ldem/runSimulation.m b/src/+ldem/runSimulation.m new file mode 100644 index 0000000..40a745a --- /dev/null +++ b/src/+ldem/runSimulation.m @@ -0,0 +1,136 @@ +function results = runSimulation(params, options) +%RUNSIMULATION Run a complete LDEM simulation. +% +% results = ldem.runSimulation(params) builds the lattice model described +% by params, integrates it in time and returns all the useful information +% in one struct. +% +% results = ldem.runSimulation(params, Name=Value) accepts options, for +% example +% +% results = ldem.runSimulation(params, OutputFolder="output", ... +% Formats=["mat" "ansys" "vtk"]); +% +% writes results.mat, ANSYS macro files and a VTK series (to open in +% ParaView) to the folder "output". +% +% Name-value options: +% +% OutputFolder Folder for the output files (empty: nothing is written). +% Formats Files to write: "mat", "ansys" and/or "vtk" (default "mat"). +% Scenario Scenario object (default: the one registered for params.testId). +% Verbose Print the progress (default false). +% +% With an empty OutputFolder the results are only returned. The ANSYS and +% VTK files are written at time zero and every params.output.snapshotEvery +% steps, so that value must be positive to obtain them. +% +% Output: +% results Struct with the parts listed below. +% +% Fields of results: +% +% info Version of ldem, date, MATLAB release, run time. +% params Input parameters (plain struct, derived values included). +% mesh Nodes, supports, masses, bars and bar geometry. +% barProps Constant properties of the bars. +% controlNodes Motion of the control nodes versus time. +% reactions Reaction force of the test versus time. +% energy Energies versus time. +% trackedBar History of the bar params.trackedBar (may be empty). +% snapshots Compact copies of the state at the snapshot steps. +% final Final state of nodes and bars. +% +% The fields of each part are described in ldem.solver.simulate, +% ldem.mesh.buildMesh, ldem.material.buildBarProperties and +% ldem.io.SnapshotWriter. +% +% Example: +% params = ldem.Parameters(testId=101, nModules=[6 3 3], totalTime=2e-4); +% results = ldem.runSimulation(params); +% ldem.post.plotEnergy(results); +% +% Legacy: the main program (main1) and its input/output routines. +% +% See also ldem.Parameters, ldem.solver.simulate, ldem.io.saveResults. + +arguments + params (1,1) ldem.Parameters + options.OutputFolder (1,1) string = "" + options.Formats (1,:) string {mustBeMember(options.Formats, ["mat", "ansys", "vtk"])} = "mat" + options.Scenario = [] + options.Verbose (1,1) logical = false +end + +params.validate(); +if isempty(options.Scenario) + scenario = ldem.scenarios.fromTestId(params.testId); +else + scenario = options.Scenario; +end + +writeFiles = strlength(options.OutputFolder) > 0; +snapshotFormats = intersect(options.Formats, ["ansys", "vtk"], 'stable'); +if ~writeFiles + snapshotFormats = string.empty; +elseif ~isempty(snapshotFormats) && params.output.snapshotEvery == 0 + warning('ldem:output:noSnapshots', ... + ['%s files were requested but params.output.snapshotEvery is 0, so ' ... + 'none will be written. Set snapshotEvery to the number of steps ' ... + 'between files.'], strjoin(upper(snapshotFormats), ' and ')); +end +if writeFiles && ~isfolder(options.OutputFolder) + mkdir(options.OutputFolder); +end + +timer = tic; +if options.Verbose + fprintf('Building the model (%d nodes) ...\n', params.nNodes); +end +mesh = ldem.mesh.buildMesh(params, scenario); +[barProps, history] = ldem.material.buildBarProperties(mesh, params); + +writer = ldem.io.SnapshotWriter(mesh, options.OutputFolder, snapshotFormats); +if options.Verbose + fprintf('Integrating %d steps ...\n', params.nSteps); +end +[state, record] = ldem.solver.simulate(params, mesh, barProps, history, scenario, ... + SnapshotFcn=@writer.write, Verbose=options.Verbose); + +results = struct(); +results.info = struct( ... + 'version', ldem.version(), ... + 'date', string(datetime('now', 'Format', 'yyyy-MM-dd HH:mm:ss')), ... + 'matlabRelease', string(version('-release')), ... + 'elapsedSeconds', toc(timer)); +results.params = params.toStruct(); +results.mesh = mesh; +results.barProps = barProps; +results.controlNodes = record.controlNodes; +results.reactions = record.reactions; +results.energy = record.energy; +results.trackedBar = record.trackedBar; +results.snapshots = writer.finish(); +results.final = finalState(state); + +if writeFiles && any(options.Formats == "mat") + ldem.io.saveResults(fullfile(options.OutputFolder, "results.mat"), results); +end +if options.Verbose + fprintf('Done in %.1f s.\n', results.info.elapsedSeconds); +end +end + +function final = finalState(state) +%FINALSTATE Fields of the solver state worth keeping after the run. +final = struct( ... + 'step', state.step, ... + 'time', state.time, ... + 'displacement', state.displacement, ... + 'velocity', state.velocity, ... + 'acceleration', state.acceleration, ... + 'force', state.force, ... + 'strain', state.strain, ... + 'axialForce', state.axialForce, ... + 'damage', state.history); +end diff --git a/src/+ldem/version.m b/src/+ldem/version.m new file mode 100644 index 0000000..25b422b --- /dev/null +++ b/src/+ldem/version.m @@ -0,0 +1,14 @@ +function v = version() +%VERSION Version of the ldem package. +% +% v = ldem.version() returns the version string that is stored in the +% results of every simulation, so that a result file can be traced back to +% the code that produced it. +% +% Example: +% disp(ldem.version()) +% +% See also ldem.runSimulation. + +v = "0.2.0-dev"; +end diff --git a/tests/fixtures/bending102.mat b/tests/fixtures/bending102.mat index 5ac2fc056f8bea13fd8be738672ff5f3071bf741..bc752228e9c5401396d3e8c2a2cba3de7a7e5690 100644 GIT binary patch delta 464380 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

jjQ=6w(V$kH3#G0ZGoN=sO~RP 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

GrZBm_LA!>rT1t_OlxVS3VY7e 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�Tx>BvBY2{=Osu%R4 z`B#IGZp38*9dKHRfEz+CQ??!PmYfvD%cnrc>M@`sVnY(FaLui?!8{ry|< z`Ka#G$LY!y;%#mxeQWFEBq#@Z`s6a`4^FThp(?*#0`*(tq#!p}juinyb;fBErW;_P ztn(-7k9_X)l@!<~y(Iqh($<|j2&pu$n;lMshM|kyXM^>2*snJoWB@k}=7feIwjsp$ zwMo!O)3wxT#aG@h2M*LH5bb+w{wQJUhmoUbu?NO&ZjWF!F9eXdBpivW1?|DC#)Ex1 z;MMJ1V3UXnL>S}!cEL5(79%V`ewm&{oP;%(2>muyDC`5S!n#8ZQ>oVw+$%OB(DQ7* z`P+*AfR2B)sm%fUgmdkaehh&5K5qqxjuM~LZh_Wd=6}qb;OLs~Bc8x2)Ha_vPml;z zLeN-SRCrCk;Qw%{g^kRLHRlAhfv2q?GN*eOS?)G%WxXU0Z$z~Qxkj9?>mBXn_??DS zGsWN~_l`elfwxF1Gq&2WXX`h+@H4+{?p(ei=O)l6MTI8o$2~KSHLts2UZ$5|GwL~k zfi!kMo=SwqMi4`wLC@AUCtqLSF4ObK)8$Z^z6AxPkUE29ffLwtuE4rXU%gE_gx}^S zRxOlxRe0s45S;fQdx*K8IAbpWb;)lsaIX!HrQn0#$J>6eCD_JmVe=y@9G1Z77Mmb0 z4=cUUguVi*C@B_3(-()%)paI*{)v#Yg#n+yw#2W3)FGl8Yd6x4SytKNV@TDl+T|#Y z2cbUJMK7P;>jNZ>QR-LM7!m4LK36?ETs#g37mvVZl9}1Uu~W_=;d+OdiTOo8X^xIg zr|T|bcX!H$VHPxGz5e>=QjcUur-QoJY03ei+49}Qp*1J$v`41z=Xb3^%4tnoOu<+# zy&ErI3bVzZZGV#GdG){-Chomi3@RZ9pkvWZ%`5SsngVIw|DnN@lED-G7eY<*IwU0D zvjOXpouHn3+zjuw+*(L$Nnw?|^N>~*Yi#(&l^IV6Yq2Y`%KE8ay5G>UUoma)bJefx z`4mBT*>^c)U-eVgmuqkuvOBd(B+C2NJeV+c+fsNADxyP4*F`Awd0M)&dEG{967|Cc;pl#bb+(KfY|l|n-p_;qJkfxvh=PISub z1QC_}@$S1EgE`Dn>jUkufdQ}ncjFl%w0HUv>PD(O@K7EK=cNnwpj)|@#_>Agb@3O* z^t_1Xp#HOve~eFBX48j-LP|;tLZ2GkB) zgYSJny?+>dQD%c;WkYKaeH;{uHJcMbJiuCF+G;1$mop?;>Kd)(xDNaAh1)4I_n|`6 zEdv%$q{{ae$1pf?;JmbR$|5MbdYQgv6wB@FQ{b6yGW;*)p~*w?pIU|*)<(aK(K<5Y zPCjD-ILP^>4n+f`TtP41gsAdNgi=)|5~h!TQE$08?Xxq{zj|D-IYQ90*ZJHM7&jX8 z^GbuA&OcpP`A7kyFuvw&;F-&^GgQIC6F#;8_U1~9qwo*1o>fHpnnsgX%JA(I5mD4> z`+Nz$NPB(@;Sz9Bwj8TRzA#K1|PRbI!%siHiD zqIchy=XY+GY{%E`qxmIT9DMecY17~EmUHNrOl2YY-Sh9dd!}6`OxDY-u8rZpv|^s& z0S}cu^B-$@`C@RCNb*P>J~m@C>SrZ;<}!CtWD3p5w#${s-D$Iak%Yw(ZX3qIQ4by; zz)p5<_$r;$#Q8I?TJZO9gfZ8ExY;oCDC0=us*AO*%g-)GSfn8r=efvU>6`0Y(HqR@ z^VhL#OWbS(oQktR6}H<;LI~uIpd_WeLLcOE!p8A#R0@vBudHy431a~>xjRRBnjG-(nv*jzCDtBSuyj^ z8>YWwmX?yb2`HeKK#ScGlH8ldMh12d4o(|OD7s8_UoZdtAFkdqERL;d7Y^?m=Z2qp*$fyOh4>Rgrur3Oq$sq4#RsBZnkCRE4Dg4 zTG`u67%q$9bESF-i&4U8y{jSmMlB2_{G|}fRUt=#*khns+9MEjP)YY@45V{1OCmEf zi%*B@V3coIWpD;?VW9`iubX`Xky3S@>{mR>YwBgielFZOisoO!YTFPJm;bR|Z-)?) z8S&%EfVaw`%-b*5;A_m~FnkhqM{yl7F|00PGUNIuy#Qg~5*s>Vc!uNJ_c%Rfi0{!8 z*03!kHVU=s)XU=OPe!IEK@(vC#Qve`N1I0HI?gEt&aLz%>-BSk?P?k9^Ga&WMiD8)=Vu~`!%#!Pw~lRf6Vid(J#qRxqm z+sgxx?Iy7*$mr#zLf~R?c??|Sf(wZ#+HXIu7NLTyFDP8-o2`msXUIJ~_OEimrgQG9 zI$2;ciWD7ZC>LEF;=;urFg)W8akGh zJ5La)rm|bLzAGY+iW}+};~h7Y`0QA5_C;#7Ys9ASLk{?Jd$VsOic5i2v`o@WdM~z9 zR)3+;?kaD|x{BMi1zS{M>yzQ&>>NhX*OtbK2 zwOZh%KXrzD(k`e8$xm~s(^VUVC;C{Ubb0!@t>fj7p*{vKQ&bBri{QWf*|DKu!C7_9ej1o%Am%*H? zo&$a>g&uTVH6nIv_@@ZlC8)*oX@zhmof>$~VN!M5N@E%Rv`VZR5=!ktAF)#RdnP?Z zsn2L#+3j9cdaWPoUaivuF&q4u<7{j>8@z$rvumQ_*8Ig@sWcl*rcnxb|7=$K33>WC zlYaG{hcUZQsHWTO51|YF(0$#M?o4`rV=*<vki!v#Z3{J?FcCc z98P|rGDzjJzax-Z@GKhhe)1X(039h#3r11l&X6nk6uDg&3b6(m-$U5|sq3~^84HDo z+G47^XTzeEb9g@=VXFJ7;}r=VIa0Lef(=oIK1%0;b4j0>>0SEoUOH@{On{u+1jIAx zcKKmC7llI7)L#%y3WaRssl@m8^nN@AzvoLB%q0r(3nFmocktcxr#TvXeiDLL zn@KMUN{fvs6xzdkg2Gx0{Xzr(q{#(EnU3Zc_K zevNKcTP?VJz&jeF1Q7xsmKQl!vc9kzj9H^B8)9F)W`WDnA}Tqxwo zlTiH)S~aq>YiO3;fm+b_xPD~ikp`a+(Mxxu8-;z zg+l7Gs57^PLW!Iwwky!|S*#z&=YUyMeSNPnT>8ryxW`Fd`Xl;GvM^leb5RN)2rfbO z1+39f8cadpg*Ldk26>bXISc%j#FqYpvfDLpojRO~8;535K#8&&vdiqrL!l6OH^n>` zTw8{yVGSjRyvQ)3aS0l9Ra(JxDR6C13czyd7oi5F&5+Y8E)VHKxgEjD^LHw4)f&w* zM9OYjANhN7mEA6%6cNJyfCpIE@d|Um(e~#f6*&M{Z&rPbNNN?OD-cYa1)ljGt4{hT0137>mm#^Iq2QO`S@3> z1k0+2c$ZThmJ1RH?#6Y{K}%I{c@fYEAb4>ZgLT_(iPZ0<|TziMMtox6&m;>C45dwv%iPxe}I=*yU?q zn2I!!<8y;q;*}>w8W76Xs=pv>21Lt+N!+LJ-_74~bMGe$I*$oMhpU;=@?FXfho~X< zsqUGahU&mo_ZDx}2W6|fRNHJC|KKFo&&0zIijZloIVRmdzkpwwdMnFE<8V*q$%1S; zL;mmDBF{82`AfYj9yjW0SW>1IoBx2aBL!YviCR?>VT|Ic(q%~JC1w*M>-95h#nz=k99l->1c5qqjw=vJ6g1{Vicco?lOv2@7BL5Q!>nHtzP`~3Sqf6h z(-RYFE-`2iM=PXrVINBHekW*B&SExz0UJVv>q<+W^fVUI`27>LtErbedOzvH7ScKx zBo*{*(?Q2)ATZ&&cG^DJ|0W;7%p@T3JvG-F7(d++Ne8Gf?HNq}8XP@=^=+I3zOQ?X zz^^$%Ecvd6kK!v*EnL0`B44bSp73TvwRyfU$ZivffMi|c3SVqWY3$IGt{tuR{? zgf;Tt%%j=~WbrbmA08c!a`Zcx^+l8G3&Y#>30CJ@E~2 zeS{^Doy|M@5+jzOCw|$(6aV)~Ic`!|N#VtL>BW?RaEqAj@rZ^gfT3xTG_r`1x=Bf# zUdl691!C4;mPxo?={;G+?Hx&3&R7q@@;r284GkZMy?l!Cba zsIb4##aW{qWh<9aB^&Gck8i7!z!!fR(#JKAMaxGf2^qSxC+6i`>}83bWD|y{%csOc z4}{~t*ZvzZZ!_w|g3}9?$_Wv}+ReYZ;mgcSvXkdl!Vi=_e_WRPi(_d$0@(pA!F3fd za635xfjZuIvo%W1t^-zi*M2jiA4py*__&LQ;5fh9sz0q5V%(VTz9K$jAi6p$8hov! z*ij-{KxcBN))|aBLC@zbUJ`6p+mq*c>#4~mrxzzBA_s${)JRXYlu*MQ8t4Cmb#KVP zYZi_3XqAFsoc2!&1g3RyF;!*pGRpjV)AU_6V69Ja799A%T@+M0Me}3wQQcG|2Kjg9 z9P8BccT@Fv?3NrF%t=?gd&;%_@W8MoOogveL4rcbRq2_x?{3`y*?%x3Iy}Cw?(gdU z5V4)v(%6p*mFq#9+i9ULsysB7Bqh{h`D)l+j_yw~WHaCBhdV)Ar@>3_Ni!7PzE+nA ztOeiGZ-nUAp;F`heoqSCy!SHYH?NY%NJ^xR+q2f7(Ybk+ty?V**7_Oggs($`T1VGl z8i?w{&5YX6riH}i>w|??i%tcO?5@MlSo+i=^i7=|q5qg@>O?a$YwB89r8t?E2r0pW z0v}((D*^w_#mF1{-|dU;dR=&f>**Xzz>_ADAZ0swJ{#}2oXBQNRp3Q{x($BO;o?)G zy3M(^M*8~zx?rVMoadAQvj)ehzcg@PcF)J>?z)zsRPfH}_3LCMOn0KkbD|gn%NdKw zZE8q;)_qRq8pV=&H6atKab%V2T4a$eH}ONr!orrv?<0_1jena>DkX425+Lq)03pYV zAS5Z-I#`0V-}m;Tz&rB@Z;NRwQmIV+2JnKBb>YLELgR@Nz`@+0TYf@{7>KX$rFJJI zrniWTvHsRRS4+LUnQ4j`8!!Iv?j!k^{QPT{hE$;~8}d)+D4a6CR$tg}tNMa()sNQB zV3>$xyvrNrui-v61nq~GxCU#T0iM2Wi-_!K@ z`2;Igj?jCG$TJAVi3Ku0WLD%fzf0-46qrxV=eSl>4%ytn;0UhE*%x9GlV4OL zYm!4Stw4Tlr(njC9X9Lk0me|@erBQS!TM~@bifKM@3afnI~nDU`bFlixaX& zswvPbHHI0xjG#g&fH!w9YgmX+0T#7Wi_z&^s?I!T96*VX~( zIW+`A^6GUVbt0&M$NSB~P_31K8l(lbp5*uYH5Ybgg?BPpxdllhj4D;O3&`lN!?rc7 zFbZYjcPu<_(wZNS7QW$RLF28#S9sSD=UIDbV-6`_WqsQ-BunAcSsM0&6iVp2j4S9KPW_~?U*Fj2e8 zZ=_bwMbcm}I2EfQEhKD}81`O1r!t}JY>M}zHavGm^WHKSllZUZ;sX{FY$+?~n|g}y z7+mtY6lzcNvinqMI2mSpw0fGHhW~pht92%_T5e5-4UxnW_kqk2z z*PrAV2?Kp(LQRNQg1F_R3`t`RKy$=QcLIp*^P@QF2iw|E@A8)?ZdJtR2)(3EFA}Tf+GxM|NnfL}i-M&Flctm4~9`_>=Kt`;d_} zQ(sCKqd3jTIDUb8+%3*pqh7umN{ZoK{c9nM|81Y$Z81vGc<;>H;bfC#NvmfEJ>+Fd zZ9uUc6&XU|n;!Vudm+quz$Dq1*hnX@xBq&qs?-Rc|W%iDh zitTuUy`rnSV6PAkqPatIzE=Dcsaq*mNrF;Qlhamv?2_CzAW98JWiFqZ3Zmla7eTnDK|wM{zLoE>JFp z(6laf6UGb96;aF$NBg++7_J~r`>LZ!{*dt&3)l51#?zE{>ea9#czf^t&IgX89R+<3 zgGMh5tZ(dK=>7$Tq>T0_Ycr0AmE?(n*d(?vHkAISj}wSZ3WEZ26z%T8;$u(ss?@}U zgZgFMqC`>BtCJCQr}nCCJF;U}^1vdOlc?FgG;ey-#f+&w)wTtv*w7?SzZzkO5%ah8W!e|grq|_ZceYU@ z0KFn@C;CjOI`2WLptD6=xmFOAZSkKyI@;m4(UYuCzNmaa`?`0Q%Qz0b&J0m~Zqkcp|Hz=I>V}TmAU}W1(D1iTsej@mF;PvX` zMFoF8QH6a&8(wG(CyQ5tUgq=bT3zgI?@=+_pnze!iZ4sVg_Y|~vcpJ}ntsfd_}E#R zv?0;QvG0iom@H?@=PM{rP?(+3e#t(OC-DJFu8!0XtuW7DInIjj+ZuYWl~u<4v-r=Z%4mxHQa}FQR=HfZi@HS6d0*je6lfD z_c9{MBcP+#DgsAx>PQz|dsSLUm@grV>`;(WV~isqbpP^b*n_STaQ|^H6?GTU+6hEh zCz@hyn1ZZ~^YZhCy`0Vc`t{lEOn>mM4&KMf=#*BQ{vc?49*FUXv*mY6`z^2j{p|VG zbE&a7<|@CUwc5YbLRO|CG4@9C6`Ivc$X(+x==jG&*w|&kCn2)}-`}w>32iRdbjL91 zeRs(tGPT`B3PVZe;v_fW4;S52mdg7Jv=acBmxd<;A=H_@(u?y#oh~-U@vPibVAGCV*L(JxPq? zHa}S4D0tF+<{3qBy*+VveBho%$WdfEHq8Pe{%&8*gf~%Ph_UpiL^I{mFJgw_(^`=ER z@u@1KB725Bs{hLL2#&ne)V!^~2*^pwc`B;&MwjYI)iJoJhR=UlVjLuPlk%G0*RGug z(2`0BNvychRbmVi;v7~#_AoZvXK}V-a=K7ZteY{1BqfHdD!RyjVQW%A+NEfEXFgWE zTt1tk{Lv*XESUdI==4ISRtoXuHrAOlpWz#yzTGCP6f6z`hLwa_(NC#ti`21aK|OZ7 z)x9{D!32yLDOJXm+iEdR5s895W!SZU0SIB?CGp9 zAm?o@TeJA$b~TB6I@=cK1&i4Vnvt+B6O%pSr$jb?6-Uycp&Wr*103fx^??Q^fq)goDqumF4a|2{zovO!;zI36WC;vvx0>%6N7e zbvgtpIs2W2FwHi@m;sCUaau9ob4zWFTXTkzlCg6l#g8Y&2?z8-*(&Qn0RHR56wO;T zw}3xLF~Lb)>8xAN--Eq=FX60XBaN*8QkfF9_|&{t!Qm!C!J49IAb($rbQy3|=J1LT zIu>QR`GPit${);Ccoh_wf94ePP=0=0)n!jZO8DJ2Dslg6=-uxV;v*WXgI~4XE~iU4 z7k9VSzt+vz+x!Om*_=x?U;uxE+s-~ZSt*;2W?}n8661~}k!aNxlJMD8E=u|)*j@SG z*%Dd2%8HC7Go#8eT17R38HC5tz@`Pg8>=MG*J^#SB{kA~H)6zjH6FjBvMTG;XY^qk z^`7v`JX)(iC8{g$f4zeookvEDqrani$L&(%&p0xQKRN@M^{b)(I}4D!-!Jl)vpdY+ zG$_1#%BYUIe#t`xknOn5WyQ6ZbBobC=tgXv!yax2-dx6t8&VT3w*WTYYi^OAL)yFQ ztD+b@4c=IJjs=+2>Q|G5(dshfQ3O%Qt8tPeiV9wJDHSXq_tL1q9dEMCeIM4F4qO8Yfbt-O? z+65!ad_F!S{yp}E$FxOu&~x)mHiwAl;o(ttwXaK1$cPltehT?=QzdCgQ6^r}A-Ys; z!cql4n>O6OSZJ;*GZ<~P?0YNHP;gA5<&lyL%wBnaF&n?aWNrB7CM~`Fm#fhciJl3> zL(jK2$q--VMgd@eZzAGHu`AVNVzCZK)2bJ(A_#p@F5RPY-;lxhd{$N6+>z2k&CfES z0a3a9hN%fZ3C>Y^r+j{0>C4`61?wj*Y|b2J{`%n}*qq_S*Bfj&L*GV2R&8M=UX9al zQB5WO`AGX7N>)Yhw9(`X4o)wFeUDo^TteQ&u8Jq`8V>^Ew^w0a?Zhdau19_V7x##m zRuH$w(jT<>@+F@()w}c~v;GJ6l`}zgmU>l27z$=n=v}&DAF-r`7jgc@3Uy0Nj z!)SVHV-N63oHkaE)o4-NoOov`UTH?~ZO}#AR7=A^f%qkhX6p3=&mR|}YR6ZE`9y1! z##evj#Dr1{^Y4b%MTDp?e0>n{ar>6Y;p}!oQJBjP;jH`)O6YAPU#OZXVqW{t7lGd` z>k|Ns{^1a}M>Hqy$4d zu#Q{+bV8gkq8KkUc}oL#Lbuo4&{b$nc7fF^+~Pv}1*aDA_mntcBch!+!~K0_o$~ALze-EV`x=^ zADfWU^EON9jG%-iK!E>O)RNogvs*!;g>wSW z^z_t%;#4o_sRIgx;f1*2JN@Et>&E6h@PV+HjL{gaBmKV)bEUL2oEZ-r0ohp7rt#ba^j?631 zK|?uqEokVwJ8WDC&r}=`54R%|gLj2_d+B%QBFfL&%i~mboq`08mM>p$&S}x@yoxI+ z8Gv!Nz{4KcC&z_BA2y?VJ!k69Dj^(4iJdj9Z%;H^f_GaU{3ZiF*x=_j5P(f|nhz?w z3xwf5^SAC|)Ft{PVyycP7mFgx5y9&L;`d-V-oU`@^LyQkzOmC4E~QWuB4kfX!Yl9* zYwrbJd}My}WZ9?@QzhZnS^eYBTh*oe26A*mqErul=_Lt+^ZF!pb_al4U*Xs`kzX`( zSMlM@MP>x1Khqpr?rnpNI`Cm&2tjUEKJRta80{pticU6xE1O8~!1jtyq9^`clgADI zf%HDcUI$^`5ACvpw?{*0#*RVpXnLj-M2Wv&mnd}@yr6sygr_N%)cHsuJloD%g@5j% ze)AFZXGtB%53_4T7${1?%aE8!?*!ammt+kTdNDgWqz^Xm$Bw7`mIOiz++EPLP?cY~ zmVO46qf86dw_OPT$ z{2h$7ciH_>eINqh@@-rdZe#-He2i~WhwVjfib#7tiE>{x7$7-ims`3gqj>?cu5w>5mD zYxqDZPOtXGRpz}BA>o{4A^X#1Wzp2&l_2BYhyI~)LlyRjbTsZ z?MgOF`93_WIFoitNe3lb;s%7N%M2-z0(|SbWo9s(<)419vO2-}w|~1$Ar{qK&sU@v ziVZ>x&8;g4Am17Q(jVws`Vp};ycYSvqB%G*iPi}kM3U{>8yHXeI${j#wyjksB4H*X z4!3_0z#NJh&BeMG8A}fLZFOS#JQFTw#UMrPY{aik-aSU|5hfM+xen|CgSi`?j8uM6 zq$II52t%X@)T^k0k--kL_<#uEMrxs6RMN#B!N075DLN8Bu{PQ8BHfz=6UME9!&LdR?5B3VR&jwFBp@|y)*7RtPbdcC)Pt)#WK6e`xbj}IvdehU+ULObI+!2dj(%DKUg zHse3%{w9z20iSH0j2$mBc0TdS+dJ|MZf|38_h)1<1GCaa=!V4fa>yFoN_+4_xV)zk ztLQv~G6%QFsJH0jk4`1_$pVRtf!k%ZD$Y`w*M?1mbq*O?*Lkga zwZS)>K#8LD%4#RVuc+?&btMaJ9`YNISNHC_8GTk=7jItC%(i9PLLP-#zCqRmXC6rm z%GFo|b6yo*ZaEu|ARauQwi&DUrLYgfcKm8&d7JhsY%D3EaMRZ6PWGnE>KppTni-j> z#wCg?rXI)Hk$WZ6%H;tBqz}};C1_)`a*lOpfg3oMA)_4dO=7#+emx?Bw=E8w+*kuW z=aA|K4)~qjR34%kX<+|Wb*^~BpL&DU7=N4md|h{pS(RkzIXa#uvDqYIyK(ITjDXK= zVH7Z1V$NRtW8=1wdO9b1Zov!L(hz_w74?gsmJVa+G3F=UhgU7}1~}>kZ=mUnp1?vJ zfHVLd#O-c`y6n$gxcHTBXmt=&>H2(RmAVT^gpcWT8y~KrP-%$PFd?dOKBz&)afNEi zZ857y=;dB$Yg&J6C?u1z_^kW5QDwoxmR?&;Oy%NcJRcCpQ?YT`#6FY427<1&8UrP9> zTp`UQ>-_2v!fu%(Z_1K!*idf<))!GD!@tnFc!dizyG0(7wkv(N1oDR;qHA_y?NmW>b!`f*prk_s|RTe z@9Qb{KpG6-wsarkR1UNI_jDQ~D`@zf<(XTBH<230l_!79i|yzsx{cew zfrDG@)%Mp#uu{e{^E6Ybdg%7)7s-w_70K|3UO+@l%hu|Ykr|N=LkHm8K=$rjy}udY ze^cp0YHUV~8oXE&HoR3tTCJ0|LSo*5*%ZutC)}V7cj{y;(VF^AObu_h-vtQ)Ou=jy zSBX^Qla--P?kDEKUZ8sCM1#Y&7|4bB@m=7kVh z*fGP5%;hCGun~5{0|FTNaJdZ3f>e zY;=ZSd;VEX5NdNQ5#ji#!E}OsC(iS99e}ahc;=`R{__~qn29gcN-!Dr)Y(=C5Bl5T zaq#XgH;R|s%f{m88J*z{(3pMEi6u?3PUwEFN9*)6HAdph0n!XaGlv~xPL$L=7k?>L zZXdt$AGw|bW4#t@_2}Szz zD)H37(2mT*TH||Q?z7xT6&x2H1I4N5pab_WpD3(zFT1&)#21HPu&*Bd?c=FF-CcqX zew{9tylZGP!_zQLlrH+rj9S3lLWu;pgo51{z&KAcw;Cdr^H&Y>uZs#6u=0hx_#LXK z(^Agxd>JYEWh|i@C66~mZ5*f498&~u^)_~aF_RHd{Tn9Wch8Pm$T&&bIQ%{meyuH+ zAD@}3zsscR=r7_QFCa>aZW=FmGj!FH6vc3j`0DVf40+oE40g`sM!>>;CRJGsub;qQeDRBsJ6~03pDlN2-~C-Y=~6FK zUP)9w?Q=oO$6pmdXChCIOCRCy zdzFJ_tk}LsjD7hlaDIE2vNGdMU6h*FUoxY|;qy6y_i*n_U+ZaYHvaBU?8VHpn-}r$ z%ZH$0J6UG#4#>V-%myz|d9bKCrt~@#t#NM~B7S}ZZ?4v)oI8mI+0HXY5Lg3gnRtEc z{UW4-f6>YFus=1Dp77zzj4b^9y<1#Xdb{0WbK|YPVOkg5r){tAe(yZLm$|F+R@tlc z@=G-BGge6^eEvVpO}_U3)!dZmpaAm@4igRLAFL<@)Ht!YRJc7)xVW{r|3Fp!)BlvX zpat^|wjQnFQ41yu6;3e_?th@Fph#9wu|p!8DGV1}U^HB!i7Cu`*p#M*&JMUalmSCHfcd z%D)*3Y=y@0?+lapA0f*5zfhaF$sAD-yeh$%ey5hxu1DLGu5IEMEVQ zl>ps;i(ob0G)!2)e?)~F;DY}jxG*B_|5bU51*-$+?uqhG6qVG-aEf;S3HKB1{{+Yb z{zrn=_;0xN9{-Vc{+o6Gfg%;&>;Fk6_04~qz|h9QKq%pKUjOw5*tEI{ zYrK+ze5cu1^U{C+1`}|RkkLpFxxQukWolX>_eFJ4;v3D?CrO?GS)nD#mfZB)u~uOG zc;#$;`|iP)vZJHC|2S>lWAs>WeE+7^VBcJuZ|0Li5O#=OlPu!i=K?9BfACN~5*(pcnL>-M(GD zTF|msfi`nIKGB>dY-?3(4%D*|_La&4v_HRh^I2&U(wX>^kBc?7PdoWIo!FW0^RUM_ zS9{{Ycm3CVj=mHKDM<%agmzzGaXROK`K91)?Y&G35wq*gWsPKgP8#_xVEemAtCFei zL#$ex86;%!$qXx?JnK5@FI>=YKHQ zzb)h8e0$e8tr+y+eNltf?=ANrQ8kCO9H{q_Y1(_b;&Ob?H#ih#4$#z07$`tD$HA7$ ztG`SgNt6yNK562*a&w-n1rrLbH~{lLgZ1ufp%5Xv^f5YN{=!8Q7v!OiyRmiQDE1xK z8?Qs-pc`{d*BZSsJSRPef>$RdH}8erNJz}cMT3jD5Q@3;d=gh)+ITH~!qR!%0tJ8S zpwevv#H;hKk}-ZJASJ|sBzRFWbB0MY-YVT(%|b(ibMu_`f#5Dafj+!pV_1M*aCo_J|G<@p#X z?BX zN{jDMwTj(2@HoBrn-v-q(w#E974hYgN!78}{2H_|c(Q@M=6{NR!Rw4Q?ks4}jydpi zJ*_p(M*oLrB&F(i`AUO|_ER#AF~WP{lq>aPfwN)0@84WUOqWa)zvnZ~b0wUFHxOJD z5FH0jWLKTa0GpY6`DzpioclfPVOUY@Qf*_#O3P%WXQTK0*|vopzd~GY`vjr{$A&Q^ zUe(quE<(-;yW8h=8oEE`HCR||i#$H?4x7-wMm|9fjd~RI);TOf9Qke?XEuDsw6*$! zxC1L>dxcMiS~YBTmfvIciURs7XV#aEx|>>2B>QN$K&qjemvv!}iJs^CR!<)1pg4$j z{6XkV)%P{4Q~1|~){?bR++$n^rQIQ%+J5qFUi2zVbFio+uPBct2yll!}h38 zH#=K5&}}V8iw)Mj#;aq=tydv^&Ym=Q6GH!pS%8#>bY3q=bSMzbyy&vP9 zu>8{`_k$m~ZCgHJEkZu? z0Cp;`)t@*N=Nr0@ra64MW8^+D?3pnL)pMdgInd-EAHttVx(3-w)3vd;I}N)Tr_H}I z39k&=m{@<=8g|?AO)TThY%p0FUWqg2=4=ni`qnV@HZg-|nQYv8?Pza!28rQvDck+G(~ssFVI6=(66v)f$dCU5=;iN~G)D~*dd+6E>J4czK6?WP?(exj)O$k4eprPo z`4)ZFVRbN@T(;%iPm-v~8)D|mu+YJ*C<>YK?t`yM{F;}Ta5m||=Fix7} z@w4Gs#Nj(-OUXjw(%)i*ME3_B<|kYHItEhm&!S#rzIl{5u0_Z%o3}Q$&}WVC>5X%; z?eF(z(;yny(6?@V70J<_cmjJ4%D0vX(*$wsAuF0)!q>zUkfK-4(s|ie_zI`|0s5}n zoKx(R%qgpFKFs+j{N4S1YS9Qxaz0Lir}HIuTast35lqXM_;Fp{>l(10L2#o>zih1? zzx_K^a^k}yG|&;%Wz>2w@EAt;_1pTJC-vRiTEm4IH+@Q+HJ*VsMQ*W{h!A@M?QXep z9i$dj;SeF^eQ{rEFT7(^5GV6ECw*%bn4kg!q*D2HRjQGjj%PCt<3Vz6AY|`6kwzwG z2)Q7o0;K<0peJ1|N|O#GC;PyS);R6mrdx;boF{hX@QiwLjI~G#%=Rc1qgw&xdr{6S zt5=frCabQXy;Z&+nY4?hV^Q5tF&|zw1Y~N3bX(nDQGHRCtDo-k--g@Y)CI^-C9h?l zeTa*9+w@@oY1J9>KMOxXLf}0qk6W;q<$i(SY(C$Nk`~0E)b^PapC8K^5x}TX27Pa>`Jxa8Ex@uiYDJ2W`8}taHEvi_p zZ9P%g0jOK0FDF-E zZd%2A>vfOKS{X!Uo!IevDhl=n6ckhSC}lqRR2IIKMJ}Z6egFBNcN-qsY{u18H)Hc_Vm@?K0xO4 z_(hT@vuhI)g2oQmyScy6;T&(B)Orq>m-eT&$9~zOXY*;eXz}>UQn16rg>{$yy#^QU zVhzCRaCN}yZ#c$c13ld{-0ueICt@)F5DIk_wct*M+d3@fRk9))E=^Qpw-ZDFsW=L8 zZV_Fvo9kTWwFM;^Rm~anSFray?QObQ5BY|d++~!%9A3W!$d*5utlnTLG+_C4fLRZ> ze+Ro?eKT!6alOC#N&2wty4CDGTeREaE&@z;e@H$`Zv?i!n_BXn#Q2QQ)^OMzH)X_y zWVRZtF|GyQmFAZfH<0#$R)(KoF5*UIn@BFsgTCgxHrjpcki0FKljf#uWYTP5q0bNI z9%2i2mWGUz+Qzp{WbS6rS`hv{7TIq(!p)o|!xhSW-Yob_MSmIhBMlSlq-N)~!X04W zs3}TT}od9cdy@Nv{)YqRAFpdt^z6UCOzqEYn*WU4yyw!&L(e#Y*Q-01DpSbvXFdA-oddiYDh zxE?1*!up7>XenqI*YVqk?LIu($a=UB<$*u+QEWNMUf~JY{1QO5v<%QK0Wc4PAuda> zAWkw;*7G$iWvyZQTazy4|4 zD~#gMLpZ;6W3nQ0LLWHqD6C=^wV<*WCattFV0tciba3wS6b&|m0=lFawPQPaz0z%q z$f;st4u}g<^M|fcyZp#-u#8}lS!7S60T^- z@~^T|PQGgOdVi(tElY3z!Wk~vzM@iPs)`FRgw_K9(A9`cw`Qd$IugZJkhR_shS2;0VE5eHrE*7K_ zCzLk$?mmGSH%B6)ePMl#>1LJE9^-ud1(^61i!&J*!~qbDQp~Ww?^fqaMh*fbH~biq za*Zpmp=3e=9bB(VUo}A&{Lin~aqmw|epG+3BvhiqN)t*ygmRThx z7Fkf0sSpA5i%yJ2+F2!vNLom)w9^&bA$_-0_HwlseP?Ep#WXy`w2v0rJlZtzl$-hE z6`-Jo&`MF6^B&UM4!3`P2kB8YDoOd1dC#IpbwICkrWxalGw0xgc1RyE>iL@Ji<8AR zt3;<2>sy_zT10wCkD%v8aY$blTVC-A>R$6#oUiJD$oEVXNKf_Vjd+o7>~ER_`dH3m zXbvoWxx%jFWJImEKY_j_((2JdcHZm*Y6cjP-1p|X)Q9w^v7R162lPk+4;4u8kX%!Q zL;CX)a#e_FJ>eleYb^Ww+|187$;Bds*Kyd3uZQ%-lM_m%S^#KDDH_X-Gtk$+)pXJ9 zfPRCfzeN%R15U#!!?}*@7=_k=GO#2ovsR9zUqAvRo-uud0D!?@Jx2N)O3Rkmq;+-Naq-=RV3#!AwC{#&!boBT9qvD{zC` z6GM{=joR}$0-77)FTQNoao&ozPnZYv8YdHuxtUtkjO@VDALuwhJn%S(J*Bin8&?BeSLVZ>rN58pbAIPO4yK1qD4{lrVIR^XHR5g8OeoQXlEE?m z$=q=+J0gXihGIH25h5s$D3>HEtk<{)ID-@uN}ZsoOv(R`qU(-l>;1wlRV_tPP3@wU zY7uJBR7+K@qNQf4wkoxE?w3+~uc{GSjiUBUsJ-{zvG*oO;&*@l6(N`oC^7<2{`Z_so6Ceu&Hzs!;^)2h;lciCfvaLaS(2ZFN)o{ zxc$wd_3b)zAJVRSm5CBBiTkBC02(FO{y7cw>{wqW4Rw4kh}au|{M_n+b|)d+IFAql zr5r6(!vU_E)EAtNs{X4t&-Mx~XEf_YebH&Z8&3XzsrBZ8*t~H8sxb`5^sn0F@=+{Z zKaiTuvxB;i*P-{}Am#VIy~>F~4smbjyaK_`&H2c=4#m_(B8TX>FhR#LqMh^UAP<7x zuP=i9Uz+o5Kr0Ngm^Pr=x&$z4hUkRk4f9dko}8oVMt6ux7eP;uj38#>W?Vz+6g7x> zFbHB;ZULxkgh!}p;=9`yL64c8)0qE1uLL3wIaC`7CVl{FI^t-lh00jBNG|Cr{CjvFHVySK)kY2U zkS^OhW)n&gl6?^*2N_cTl&J)7^7K;4M}4EoCnG%C@q-@I@5h?yf`O(^11h9`lo2G0 z*O&o$59B<&s{r(X<1-^lwLm90UFFN6!;ZOb_84(fxPjiW~oP_0IochfT=t7b& zawrENhP;Pw{876IQm8^f-@qC9G_PJ>DCu8)lY{@g6(R(Bq4x?*s1iGl6Dh|rzUKZr z0O+4Ay(-ABtAT4+8Y*xIC zIfPsd3xf?<-5*o=QQlqYV_L6gfYlsrvr+g{Qej6y5#Gv$N=4)AlfZ<72pZ}_%ry9kh9Wt#u? zVHfN)EczhFew&|FfO`CEIE$Tu4^gcjUFJ%)eOmpY(tg1Z_3!d#?x*BDK|{bMV8^w_ z(3z%LbbBK02#_Qf&CC6l%{ju3<2-KU2)*jL=DH*k`sCDbkZMrQ=smObq*Hw~>}zGx zuyYsfaRJ+kQ~nJCaoXyb6GD)UzRaqp97mNIw&i5j7ayH;KGe%)eq{!h`i-Qzl)kgG zCf@H}%dkSOf4^SMUq;{i1j*E<teI>{+E9t zNAzct!$<|zH_tPr$FbcSABGfc$IbH>&&`VtxOPIK9p*~>%hk`frc~U+>BW-!hci#( zBUm$D050a^M-7%p0xcWB`f`4yWPu&cR<_vlDYp152Hb33_{h&#^5}#!2cM-8x z2$+69H9?%GqFx?}p{1K6+YSVseHePLX7fCk6R>NpIem(CB8NdM#FDbU@vOpT@7^zk zN&;N@y$SMgDJpoP&PfLDUbDG3`^bqg73_J*gh$8Goy{b5g9!_fP4!8@WsE7*!WU3p zx-$iLQO`?wUNo=3F3n4OT}>aZk=ov59Xa3SG2&acl+%vqQTdPGVT1E8E*-w1e(E&Qv&$U<44an z%Dknglp>40<%o0z8LKb0M(ZlEqc0~e(iFz;l+YMVXF-C!a^;^loHdUz>BoPqTY9=0 zBC)Gy5y)?-)Aa{MS%9!7t{R~ImWoitshycd0oyUDB^0!|))jAZDL=(f8MgwE*)_|d zz5dHw+jna_`*kJNc;ASu8a{nIu{r}!m-!;wYrGR;*j}8>U<88GF0U zq|Zs?v_;%o)?=Pp5ny+si(b+I`qmxr_Do%KNzCJB#z-r`yJ~My%EY!Ct9+)stFDpfon|s{A9;?5GjzkR5e+zi0sm_ zVws0Ahf01ztV+$I0qI`r-wh1zb!`a^UHCQkJxjr=x!rT$>XEZ!YCmX4K{IDZQ8uDQ zFX2ki=q^rU)hb(_EH|Td*LoM`IWhDj4^L67;+)2nej~@}ysR_EYsS^%XQq23&xx*{ zlS-y94+F3*TLuWx9GGq0=pI*e*EUWdr1On7W(HkU@-wWT5s4p1pQGQi)Yj~3U2hZm z8DTpUVBceuea=U9#@;Pc&7!D;2WhK4BC3c3>GFSYBGPVq5Lvvho3=*8O9Xi_C?_usdzqnzo zVL&)p;06xD^v*^cIMn>9y^DWrQ9+t9cTst)6H^KS_^g1eUcdcCxsOj*I4nFHXNR;^VGs44duEQ3?vMOCZ~uw?0&w#b2jp;;DO&^G;z;G5nEH=Gn*tTR2U!KJ>RCcpZH7?vUe>(zDZpt zrC5QGMEjJu_Gyn#W-BUqEu86V*sUhQ*@l(_!IEeYOc-XW*Z!VBbsG2wX@GacR22*#6y z2ZBxiwTV4(TohN|Y& zdeMWoX9Z;qPU~l_5jx|2q{uhYrKjs0;br4$tD0Uy(`(*6!Px1YJUXp^g5B&wd2@?E zn1@&bR-&6Ffgyy4=5qXsz9RFg+38Sag1)U!d3I3EZ1BXD;|WS#ld1lu=%aA8^zfb7lzRvXI<`MaThl@$1n#ao>!=%-_Nxn>iGBexcvsV- z$5_Q9?bH5O4a#s;#2RUYwIPGk(Kk4dX<>HER-Q0%^3mw_xBlwC?v1jA$|ioz=|LtbjqiDTqON;>dvPE8UeMz2M>OwkV9P~j zrNmXbEmv!;R-9zKRrY+)Pe_q9Ton<5Bw?drWeh-CcqRZLtrxaNziV6>7R!e`FBu!7 zij}3+tJ6}%EVh4?mfOXsem}OF7qfMPvk}DhcFi&saKg^Me{L^EI~eCP*x0oyWp)PJ zC8Ig^gGD@k#p-;6SVyuqVU~x1taFWur-xkiRi59Y*qi$Gv(BS5T_MYg`~5%ShVZ}l z6qgkPzelKZ!2dZ~D@U?(AiW>>;cx8}CHvxUogReeRh`@g_%)F?rU}qPu91jI{$)k% z;+IJF#TvHOj)?uKHmLG|on~CMkT;T_XXD>I+8nMTJ*WNm_2!CV#)JqfXzE`o_m{|) zQl0H5@TUypKa`KSbX_^%*tx`8=NdK%@*HsMpLJ1(Tv3(?pey2S4eOm1#SZoOdIhB4 z86pUxfm|-Ofh{XSfL+iurA)A<23^o$yaqU9h?oZQ5uN{L59E+**esSk&Vk=}2*2Ly z-4!995wm!`Bcf!^f-Z`kHX<8;>v=utisBnFsSAqpL5zSEGIr_r!(~N9Zkf1MMfF$^ zP?zP0@PEV=CmtwqYsrQAoE96n;=Qam5s+!t5%G@52-fbtb@>Ou*BgQK1`%=Ji3BZN z!{EX9gp~-2^Qe~sD~bR8Dk_GKh)+o%&c-Z9P)_*EI=e%V zP#1Ur{?^&m7zfxeeC&tsSj&wUhC8@%_eRL;f^cm}ygA~s2jM=}5&&(Psu2fX|6(^R zx_g-UV^S=NJ)M|&A6%#tw4ResiUY1``I{a*6=Ky9v5>GR0?sgMposMQwxe<$^(JdN z281Yq<}{X_@yV%f0RHy~^cm`qYyI8RSay4?J24g%0SBcY-tuR*Fq|UX9h3%D!%-AF z#~$H;>YR4pKTHt`_#G5ny+*$8vI=Dk!rxjtj9yio(FZ+jOgW&_?TYXk+kS<-!7K*$ zKQ&ndrSVfe3U5X{pBD^oQE9U_z+Tx93XK?Igjb%?~y|e&L@;W8ufIq!88;t+`Q;3-z0E6jF3Jf|^ z{uRZPXpzy=m&o!3$rZ)wBAI*V8n<=k{13VGMS0D@=vro`H;ZDw&fd)fFEtZWO~>Cl zAb36oPrJ;(tdPe$tSgF-v90z)_$PANh8+>XESmm!%W|-_!|@(NBzxSqOI|4gAliPqdz%sb5`*ilX1~Ok5u6JQ0c*s>4&`r9mh$A42>m%8%=B0u_W9#Tt zKzr6!-<(IW*0pH=VkguV2ID*8Pj+6ONAXE{;e?hI9~-!dJ>!7a>du2o-NFo$fGa)v z0Q?upo)_`$HFAWf=F%!Tl08NDAy;q2t}ewnEpX|T5XtV(>J1KXD|3j8WVbI`1FcNX z4*>(iWwkbvePe$61@gv>a_8McF8_uf9TAaYU%v3^Ji;imtv?}!(*e5Pb|kH+_~cL6 zTv>!6KZWEQL_;>ldSBLbbw?<@v{yvtaelFgo;_~^OsbXc@u3!9ikS5PYO}phxCCf9 zNl1+O=cx)ACoN>w8k7>rrRHa6^{v(ticJs5?i_r7K9rQb% z64W1P3;@g*Ms)E@c`+d2o$J{2KNq~d^$-xR&TCa2T?EFP`9I&5Q zF3x~xk#7=zrj3e)WPkSm&{BUJm>_n=So%ed+;Kx_l+794jM~pK+n&sssaPajK!?bK1HYGazd;9F|2gn)1=DnV( z*Y^hT<2jpPEwQl{+SH&Qt>1=eXC`S{ORR{3}WROCBt|op>6(z zIeGvcd=lh)=U9JLPy{d~FDk~=KDK49g zpysXtOv|+}-Q9jPs9kk{SUqh=elzWg{kbS@mQd&pgMh$;l{sK`h&@tm&Op{9ly6fi zu^zAJUjDmw^Jzl_7F#KBJ-}hjQPs z_KYjjP_9!2Jv_j>c~!GC&Nx9+WIgIn-NJS7D6TP4c-IEbE;1t4v0;!NaB02^!3^zv zprBug*D|trH}Fb3(Bv7PY*^b#;p0~^EZ=0>FU@q+t>^J(Sz@b`m)0iHBfHM>3ioFZ$Z z;NE;zA()l$q%z)pS5acKiLEN;3C)g?{7W2@GUgDHS;J z4WZz*9*1$Dxs9fy96FtfSb05WZ5Yfwi-{@AxMZ5p_MZI1QH~n-)iY2+Fm6XGuBlkR z;+MG0gfm_iQ>U-@n-6j+JuD*U_rUmJ3!8FsBdjnZH$RdO);{Uc|0Q=Jda3(YplE2r5ai8U3(!3#1h>nE+4R9@HRXqw)VVQ`r>A+qK zhEZI+;_iQRRk}wu^Uu@k->yV!V&NAh2d4LSpO+4eO%+-6c-EaSbt1Coc}x;!SkqK5 zMNd#z8)=I+zh1`{$D^5+DsbPS~B9U#12FM%(RG7%SPN z$`cyk=%1v#C!tgW}V#he-G-K<+)%VX%a zBA}93spX}l(l&bVgP zpxE8lIT>_XNnEtGX*%hir-~=osb}l$l^6Op9H40a3uv2PIddXwElK4v#@5zjDwB@}>%&z4P$C>~p z7R5>!lzEInP5T*py;LcBXbT;+_>GrmvmMU_$o$sa?eCfm;3ej9Hn|zrF7| z^Rv(^QMcOKa5u$?QzHk;4tAHBvVq*owL&qvtNZT9Hvyk30YMTVueX~VXmZ}W!gXI* z`d~(i`^bPM^d>Ff!zxaJ_jh8a0`?&|r4<_=%umAs;0J5CK z*n$v1Nn>HvMeb?~Fx~!mUreBUzD^)!!F!i$1(p-B=8Jh@F&uZ8V1ZEo5AzUd_lW2# zF1${Sqr7ncrn3OcA!AyA@m?MY9VBS(mR<*6`E8gFAW+%!U0w6A*A6h`#z+l z!kM`du~0m>Ljt(#pQ$du?gzIZ-qzGSZf-(+tZdL?#*<;-T>;-Q|GCbn(BeWux4=>B zH*Jjtz zvg7_WA54iwzYpdUtEQ|ECT%wM)dFmvh84aKnK>&V1vv1!)I<`geM%hVW*zbx;KP18 zavhL!mpXtHUOmUcoE!2dN=PYo-!Ui-~X(Ny8UBx4y==3$O~=#06MO zKynk}Q&>YI;$5*RFOG8T*^4fOwHSdEkekH%HX=$>PeD(Sc6*fIo+|GlzL*7qx5y1V znfU!95aEMm@&iacyEzOTz9&LX^gZw80~O_2t^oqElzOSO09&=FCnF9yUO#|r168eG zeK692P~yMR>s3LRScjs7K+HFT3o{#ZwH+Zs((3n_E{WF4JGCe4)aWS38GgNY+tqMZs)hB}ePfcPsF10cq;PVByz zPxDVPV3?NwKBNDUs$K;G?ddhdh9|R6>vr3RY|jsI`e1NRctIsNM%@RoPf*tbUom`- zK`p|*@Zcy<=XJ^OWaEkuO8jH(QQZX?)pP&_xOb58E1G>sY=Q1Rr2JCi|8!J)LvYGA zqHW^qcJck;QL;8A)Z$%pLb90v@O5_ z6_X--FfaO_^j`zyQg!z@_aV7Y4M7sl{6F&m8ovw%m8u<7DDhq~B!~tOeUoR6FT~H-OV0}VQrbTRdF7JMb~fN#YIDD_9ZlK_ zm2PccSuQ0TT-7nstV_9lC-0}OU68K&;iDfb*2gtA-h*KKZ;z(p-z87=qSttEkhl3z z4SFSBua;H?5j8rrO?v&9pr>?&6gn_Wlyjf>K%RWG)l;a*w-XL46OU!XC z87Z^&joR*a{!qkcv`Eeeg|_s&^C$yB1pMGypA?EFOty;rj0Wg(=~il~4Nr2zDqOqB zlie^x$<3P`7-C&b42!#XizdU7aP?}YIv@9com)mdCykQt$E~~mw7JU{d9*Hliq$H1 zX0P$?|YDr?UmHS?|<-XGA}7*cPstkvfew~$)%2NJ4F6No4;Ai=6iC@D=RW( zkAF0uGw+{ix8s8$%byvVQHkU5WIuy%xhidetzCd_o zrfMLi_}&yCg2cf44jd!{&O+NS`i;Ep8(6(9gfiVOS$<*0I=Qq2!i63aXGlVe&xu@$ z%(dt|s|6>Vef->t>V=AA_wHP>0Lz;E3=SNX$)UTXbCT@6wN=B)!Axnj@GtJ%AgOgoY0vg<`}QT5FS!O@E`tmo|^> zQ9CaCx%_|H3%*MXuNxfaH>sNsxSyxT5GM!Di78W7w&n2W_Gb+p>TLpr&|c_AsJS4a zZ)@pv`rakNUCAVx6yMw~=t}2(W-H*K+e~-it+ixT#+S0BW`_|Z7411*l+ZeiXg$-W z0OlLi>t*aXyv0UN-_4RN&6)PEd42*Ex5a+Go;SQw(?iJ5_p3(JTlpOpZATvzeDFS~ zpBVk^$ccYq>}UOpYRpi=Xc>KT>$ucK_bmxlecGrZU$}6~pS=R5DR8ydPa(A~l`r>t z>%To`gFTK_JA-`#NOM!w_@@;56e7!8IiOzY!rozDHb-RDaiq4q%*|&?`}qZx&_70lEUch;`xyU&nQJHa}4HR zmFQgR$3>4IyLrrN?Dn5BFXU0>yOq>Y{HMW0jTl?(<+Y*~Q?wo}UVg6I*^#@g47hq_ zB6dM7cs4MdqKg9y$5w^Sxv#rkm5n9@+q2ad3hxNFn+mUg}FJGUqr;dDS4RnHz%!qC$6A_d<@)%^2I#^gT#DjX2L zI9?+=6uOifGBmSHJ~8M@OEcsN{1`mn%0=beXvFZ(T_$bG+h2MPkDpIK{yeF;`|M)Z z#O-|D>=?}r?nkVITw5qt*^iKNxKLYWZ{R0EP&>#<-9~&XdV$&}JHRq6hVUgxFT=gu zCvJIN-~Ii!5mH|zn%D>-7cEc;hOKN7AqbB^qfjodrdqyO`u&wgSJed|L`whLXYzfr zwJTXkxkENH+S-6aMYT&V+k=iwM`CD7+y;C@j6UG#Oc^mh+_5OA= zw);_l!$Jtz<;n1s4-9LxbQ`gND#*govAn^3W;L(Y2!^>(X5)r-#21y_#suNl5p;dT z09fy)AM7g~X4jeo4G4R4crh9<8^IQon`1k#AZVMO8|aUJe;I!8fsIj(3*Ydv!VU1Z zCg>*JLL4j5Xx&2a>P{j|ZXq6hD9grWblpXlzsYI4i~e-AeH+m;xfRAhf-amq$AAXb z`oBGBz4DgXS1?>|IHB8bjb;`11(9k>+9#_ngi?C>upa{|H_;28(L_!jv{M2px)D}M zhi;V3kH;$i)4Gm`=L;c6f101CLr;{()%d}}ZN8@_{Ri8o`j_zC;NS7%Mo3G9?J5cS z{U|*+%bCK}qH@jieX^s;iJM;6!{s9+2j0i@2aTg*u*#P@Jm`+cB#3?QU`Oix>|}bt zkre$f98g1$dNo}^ALLv^7;xZzUqb{}Pg1ltLcG|$doF1^4z~Wk0m0F~RE~ zMbHoSCtB4ZgIs@M&0qO8Vjs?_E~<2}VwVrxLsX`ap%)0J{Fm%re@!b$>dCyU3<(c# zBrGLe*U& zTt_hJ1cC>BCT+Y6lz*mwTs1+;5m_KVN%A$Mps_r;poXNA_sQIv_{h+)-?-Rl(GSt} z++IztJBJbfpXS9OJDR2DHrNmt1NQyu8ulLytM}?U;va7o?r;)D=dh~E zzdqw*vDYhkEOnBep~UKeV{KF$p1($1IXZ3;rC#`_T+1G_5E87CTipn@`^buUGx}`(?uUtE;o@uAS6pVdA5rGsCTVKq@{V zInk*quiGlrj<*@j_ZnVDWnnl$QD-#D>B?GkCDWVrr`4??STl}GW2~n2_)gZr-nu2N z6Z^PDF%|gZ^YY$o$N)0LepYJ}v+h6Z2n$uVY0wy@s;u{%mVhx`{b^1?mOw^xLk-E8 z$4(IcQEuBo`V&@5Yznh?o%HMgR3^7xIX}je=#C&Qc*LKiwk3%_R;D_J4!U!xuTivw zos;rzoTZVKvOX0KFB4q-=Z-s`_Ng7YiaN1~v&8h-xVf=o$j?%vF5TEtlp_gR=xZm; zedUi+hx%o4qJqVU*puW9a_U890L(Iw)sR!Xu^6~9Mph>-FbbS_4CPr z)YV`=WhwIxcI*9hMEL|+VW1_JQ|-K4v2$yL9=d0vk#Plhd_)OEOvUjEmnt@xuLLaZ+`4){ zD(Sr8Ik~8_X`V4>T>~VAwq%Zge8kx+FTM$s z{-W=i)cXWAr|*WJ9o;k8x7Yt$x%9GZP@lR<-h@8Kn`S}116=FW$wsw48cY6*bMj-& zt!{m=w!PMre+*a5a5*{3FR1|Lw@0&_tG~EJj&bpBM)yk>X7+y+9Zq)hnN1=)vSJVA zV;!|*wP@D~O(OuhD<$5)OMs({9|Oc5OAiT3g2+7?K7n*11ze2xg^~5ZneUDP6T&7b zT5`iOfSlq${&N-cfjsA6gaKzu%<6xsfzWEekq&!%rY}2JIQ7l}1RFGoVhn`-SC?~z zRa#PRp`WRucq#3}exWJtgIRlj>p;H1{3-VK6d+7-;0J^kzmt|Ta6e}`xPfH3`>ZAA z;&e9 zs~l$^EUT3Yr+VGWaPxH}gb%qzS0`d`x3|t@y8W}CyK0S5Wly=QzC9uHQu?pSUT<7m zj1V;Yz!WgM-5Nu;+oobA?LHIB-4b(jcu!pb9&^8iz8d4=QcqIB?<1jMP>QkyuGELrJrluhzNfk00-+O- zFpD8K2lUCq)|elM4jic}uuM1KE!>urvL2?5BM^XE=1P(s+*p!0esFL@ax(O;mGq$4 zeelmd)?!$t+X-p^pXq{-?B_N#@c9%Dg0w14ad6`bC<(;gb_$QVr`{-*^G>>nKv)fg zmQ3H|Ol`a(DlG-QeB4TpTX_m=p~uZ*C0po6^cTb3eAk3{Qq$%teE!cFw+@qfZ4vNV zy2*K-dC0BwJW4p#)D*Oy2JrY02*nJ8UEzs0Tj+YlnEm2gS z@u6;<&nTp${oSyQwiF=f;yFBFP#2S|gGV~`>VeQ&dPT0(j=-^YO=+Hj+HxOkQ0SA5 z7cf_p=e9`&4A@RN+wpwnKqw9_%^nQO z03rsS!PAV&w$L+bWNp!Lq{_3`KM8|Alew#Ix=#q9!rlhA_!Lg9H(t4`K46s2h*e^= z&~_v_xUm(*>gVR`Tx$n%CXU|a$KLMBam+esIR_O;v`BLVK(DunzHYv_`xg9RP%*KG zsSm>q^g*ngr6+xlEnQdG4z2$r|dxvB?`?GWvE@-aC1*g(9iR%yud#hEu4=A{nxW(MaC ze9)u|2Jk$V`8g&B#j`)aPdSer1XW*+O4JN6?etW3RsGF94KUEnzlr(7lF4c(f5OJ} zfhzYb-Mas}r@lL1HL zDo&RDxv$E{aYqV3-&@B$|D}eFnB5Z(nW??!qClOpbkVr`%oFuCal6ywp9$fmYYjqm zL!SaJLsdc)8w%OT+VKN+Gyd<`B^BX+N=UBs|LfP@of6+o6F+*|#7Ro<{)FULc~PU1 z*%*oIT4ZQ&xfrfzL44&-t=h7}KBg)6Omo-ZKcLgU0%phm_2E81UtzXXXN5kS@wQ1B z*8?XvYUgqR5$@0ESu#{@Hz4oJJ^$c(4 z^38NragC!5MuKdv$e@A0TXuEC23F!d>^%T==G?iok)fJG3DMV`YG!W9h;{b0;F;Bm zQEK++CPVL^Y=(&ai{b?+6-TjIr@HTPY>p&ucyiUW4xT)P&ysYHi_gG_-5#T7VhI0xmt( z!nmbF&&4O-C4T!V-@du#u^*E$ZYV5pb@4Z>TQ!gHOLgw;auvd%yKP9iAT>GpHEu=3 z%8&bE*gAT_i*(cdkF`*MVY(Z7lze>aOzllJp?`FJH$f4ZI1KbS{GfkEb5#XpKVchP zmz@hjejR$6O3!aY>%Pi-(U5J)~f*eS!!|J2FU@l5|#BvM`CbpOwA zQ92Wsz{C=7z zyniUZ3GE(Vkyz|rD|mZMQ2YL2ME?WRIGdT{FZBtwR>jxC#oj5it0oO+QaAQnn3<3s z1uD6xArL5aIswk=X`n*HN?3%u&%-sV6$U(oyJ*GR4who@k7Xk=G9}km};}z z$=a&Qef;8S@m|9>!}Nq{6=3lk1)n5PF7dA8-LSc{}^)r#1VM1?!zN;b=Dp>O{wlxA~pEAq^CBEoQtTae$4Skkq#J2uj{ z#EX15c5<-u%Pm+aNo&dOauDC&Q+w~nVbB*@Ho+(QH631ouXGFaIRJIc+0~$$U9O|D z%NZabA?^x%tE~grb}bA5fv+NmY3x@yx(vmHUcdu>?n#vy53lZssJB-i5>v`% zeeFBfgT9QV^M8c2vrDh)9}rGQ`3?r5M8B zu{fMo?bO^q-Mk3h2Sk3hqew}oG6d$vwxhcL*%OMVyGD^ECPul1=||>V%W=Gc<1-bg zbK$!LU;^1A`hbAmhM)UF&xf<*t~w%e*w>o<>({>7u{ut*uNAxYXL;M^$1}=p8U6-5 z?#@=RAAF`bZ$7A{Gn^7jboP0@Os+xt>VXIRC^w|V>s#+Q;CeG`@0eoeN5ij$$(#gB z%V~Y&wp4=zl;C-@Y({SLioOI@8qkWhl2k708t~eex5_yrBxH)j5EN;0Gh!iK%s+?CdH)R zujXVEzmfZIVhT=U{rpQlqrjC~=g8MuulGK~BVPlkex4XzdZ*T@8_&q7ZQHM36|DX{ z4(y&*SOU&7+4&z6y=*#IB71ABs?~!SMNRvUrX4+w9L}0OOm);&UJ*N_|FVlDN}Lj- zbTWOOm$`=b2!?IT);lkivCo>TEv!tPsvjSJFbl7yD*NC*lzt{#g_}@eRglfKBP7qt zwBWasU!3tZw+TA9pAxPf5C*50lc!xx12}Mb319;D>J-~+VDYV z3XfvXeanOX!ZV$X_@2eD%--BNm=V*LBj&w8%5;$hOWD=NT~gM$<8k_3FELW0i&d2; zT8#Vo%H;I~gUy=)GKFRNM$Ek{qozzK;c8y2R3(JFx_;1n7aCHv?y}Lx^87*G=+2-Q z5txg=42CE1xmDdG6$vBX@pu)JGkF%Ou{!^wco+R4X;GaO5V7S49;gQfS;nnWeQG9xaRy{aer@DjRYqgnfwxkTn+zS zk@`jcMBd9J(cf_;R;SzTc~8}P(siwR+*~Jpdri@&bB&<;G`pv|JtKy|A-8u9GuQl# z@VD0cuEesQ=OUBSH|zCW%CcYiF$fWjx{3#4j8tY4g+ge;QkrRq4h{MHer$X9i-F?| zt0c{-9Z!v;;|%lBtlM2+v$rxR!Th5C{i-=}ZY&%cX-%QVhEEGo-f{SOO%#xTVT z$@Fi^QXgC^MK|0yem1edM!< z6bF-=(@gHkhFksOaW%HOBJJPdYui;jJ8|b;;MM8J*{AB<8i-cHYi|J|q0PAmoy<_A z*Eh`s)O3@hX#JR`>(S>_n!mDGX^!Mc?a#U5Nz9$_5hp`HY~t63P(i`$bWwQEnhE13 z;`Bn$?)XZ2eZ{hU+s#o5F#8@)b@WDe!+R~3LFJ|AiyR|&0WFuNXBTDBVkU#cZ5*ap z-1WJ*+boxv88<(1Xm7sxYa&j)V7pDS__Oxq)X0vyt4SO8R~%uaF|JeNmkDNkIxKPV zz_vYgIz3dQ>u87Xnf7z$XVkcR{RxW}vb1N`wYI$>XAj~KoAfO|fhQXtMNKvFRF(5< z1XinmPRFA|EWAUjXW@B7z_OMGD4ajDTR622DvjpTcX>_i`TBG&db{Cl&NCrVUN$fC zkwbiB&YS2c!=Zbc8s{l{drRmm-y-F4$^NAiX(Mwk^QMxc--}ZXr2J`{rU!!+-^p7` zH2c4$mb{k8xH8)^2hOiA&Fb)RfH(YnJidY)tW5?AX=X}mLi=@FJ!nMpJ`XGmHfL$X3=ZT^a*OpX zk)YhW&+t&@;7z+_yWTp53{AoQ_7$ha7Z(FU?NUQjwR1h12#TOr0S0;8rhB`I_~rMu z?YU$9*)m7#)1V-@kl=n4aVB%*9+|*%ynjoW7HvxHe^Xz}NZwD%xpZ#CKrK5)Wevi` z6q`L18SyGZk?*r0m++03S$qr4MOJrjoLcdfDev)WJOs|;4{-*f6w$YF%X=R}JCyK! z7MDpr7ZBO1AWQo9nhRY@*$DwRo_}=Q%zirv-8u+N|6%#@=Q}ri+z7qW<$j8DO0S}r zE=(rMruc=cMF>~?uI0R7GQ}abJT`6JtX0WK_Is zy5-~VT~&a}Eei<`7huR~JdH)Y=mk^(dhbl(k-#oDvF^3FkUj ze|{sQ8`;+Hf8yoVoQ-MoeXBp#5H?NywP>e+lHyIP3;h7%oPfuDDUF~z&t1T$ z5%XSVE3^mO-57mgU7M`0eski#uK z+R`4)^_Mc-qB{O}iqcqO+EuG$s~TGuX~%bpJQv3P{9?4pu!rK63#3a$ed{SwJJbtmX{RPJ(!5bE1wm`Nd|yq{H#OutfAeB( z7XQ+OddPG1zKc*gEw4IoAHFwAh3L_GW|}w~skyZt_{UO0ny$OxtGzP0y;bn1ow}O+ z!>|6t<1_BaGyOb6{e1tSXN$IFu7^H3Gk(^Z4ZzKphY``e=7#>&fBF>?U?XzR33Z&a z&x}i2&hunF1?Zc!Z;a2>JbP$$@v(J$n{KA;$W!H2(zP1;nle+t)qTXR>4@(;d`-vyX8{3-5@;=cr(|Kl>4j0xNF%UWOLg8nx+J(!t@{jG^dol~* z$h<3HvsZfR24$v?XS3Jara63_zNEtol~?+DFFlWwhhlMM(@rP!ZUa6Prw5up6DJy_U(x z11QB)a_IgToqak-){EL2i&lN}BGF>*=0K4)xTP2G#_0g+{R30St`QM<2=*S&po8lD zO%J2tq~oGneg06dMCoWU(V+ZCLI+e>)zelU8#sLf6A(>s8J;d?;#(~ zuL8d2p8Ilq3@OOfm!xC;loy$1->G;^X24H#%(t4Da`n&h_q;9ut-HR2)yeE*`J>rZdM zOqMN=CMdCY8rbjGn|L#vMX_4{nrq@f-eCK^eRlG7{~0yAR*m?JUjpyDrhs-WQ}vJ= z)lstN(;shQYF+932{Gbs_+L6KiE0P7B6c3lP+IR<`*ZTTw#Xx|l&#FaL%L4;xcK0n z`G`=@{K9a|N8=nco{@^cP`^!-CiOTAe+IW}=Uf$AfNz zn#}XTctLOP6^goxEMi*RmA7kozq_czPCw+TIEmKkTK3YqT3~9K%ai1=e+&gPYVp=k1%b@f2-ihMyz!+nJ4j zkSvW&Z9at2?K5X&82yV{b0_$x);6 z$ey?w`LW}m1eA4lRpX9Zr^fIx<@)jbr1)LS_L*BmD5JZq+0uA2Z$8fRD=XRF z>!d?fhjuF?x;V@oU~JRBs<|olCa&U*3d4 z(1+6}a_jVYY}e3@4jL9S#D;t&w--@Ix({U){XZ43Sh3!ol!$1L@0+11^BT!$t7DR% zH8(VMdS-PTO*aY^upB6+#Wvelf9Q3dzCp<>!D3(V-(?a1b{CmbpnBrz3zt;S&5TfGI z7r&j)9!U}1fImg;ti>CeM9JTJLi|cc0~$`gA9#&$MUo@WjoL7yy)uvWW$r8AX@7wc zPxvv)E4QuaYyj94&9$=h_PrLSjACl4Wd0A9w4MIov;KQAb3x173zp0n<8!Hr4mxy* z3*jqE+2we{GHa#&*JF2hJCYxhg{qF(w;bIyd-|9(F|4tqW9%1}hEqE1zjZ8gNUwT5u zh2`IRT3?tqF4(AkishtT2nXoPKuW{Ae8S{q<`#~ZDyRw{dMZg8MTm!noQ7rcP}Pq zqg8oLj&$Dhq4~+B!(K1qr{*Hx_@C+}TW{3v51JCI#~xf_k?ZzFj?g?s=VK)Hb;gIS z;jT$r*hYoA^Ea(P#JRYf{Z*AagJ=3P;Ww9uZJs{-$PPIBxyPTCdHo}zHdmQMgE1i` zQj@t?HMK(em2L#FA|x)PzTDTM;2ElJdV#IiUOe~2R_h9=)dhPC&V+^SkkKj0FFF|r z*ICwlCZjtB?QeZoJzq|$`z5XWw{Bh?{j6gD@yR6(ocC$kRcR`vxCM4~eub(V2^Yr= z9g7-6Trj}?t)S-SGvjzOaqTA5N`E_M&l!@^Yb7iD+OSc8XHCvZsOhRowMEgMv!u@- z`P=yv8>xQ=K2>D*`2J8JSg3InjrC;@rrSo`o>}jW^ivjp|BB;4^5NYtG8XMC>)ay` zs^5J_pcJxSeLDa2xA3z0>K~-$pJ1mPT+q)FNo<-Rkeg(Wv9*p$0%yfxu~|1(*lyJI zAt-uLo|+>b(h+FGwGD)?RRrOi@V?v@1XtZ&$3r46Ky|? zTBGjXEBbOC;;}khV%24U`o7!2GzEpBkWcgP9St3Q<_y!K-$k6|S4Mut*wpwde|bwB zx2fyAWb}H5CS8~Nq{pYFML6Gy@@gwYAW-KaH}D;sR(|mdbFuMi;!wEG7d?@Bu5TT8 zIaKrs((J`uj?#PEd-#SD3eGSU@;e`HVUC3;+XXz&jhA)=4uynANmH}1hi8QpoYKuE z8Gf!bgCjC$sRX5A{GDqaLysl=JuyBh`=>{TbI6<*#o#Hfu)oi*Z&~SR2|571>Eh9+ z7C^lS6`-UyB3SpSAJf>L|9xYoFG|#R(Xj{O^GC7A;E5E~@N49B)$6-+(AFmms*Eb%$n&G`t8YLyp-?C^n4u!qsBEB%`6S1(DgjLRAzq_d8hg0I>IO z2AtBE`UGb+<`EN2+yiNm0gH~5NQcxc_PI~hC>nuP*vySu<^Y|@j+g7FY*|oazscKm zV_$7f9`oE?qc6vN%ZTbfJ3)ZUd3{@ZKj&>OtBA;`tuhmS z#3pw&Mn%D6_>3^-Rw7f8>XlOgTy-(KQ2d0CL))Zzi zFyGf*j$*cloF`XPN(+Cwyz4YSs=;yxT`mLc-*^;w{i;ut7drbP9Ez78vh(>&(R{&p zHBMwGuTFsdpXu>;!`ryW4?n+C{P@A1voN}fVwTFHyCYPsa@W0_w4?Q+2y-Tmk4=-8 zR><0A&OQv6!{|AE`g0tsyQD3j2r>J`48qKZW12ku12p#1e| zz;eAW9a$ap*)4yfNea;-!S4C3lhTp!UQa4JN;pja-p$~P$#jp~T<0&zomXRcN{*NIu#q~ai@rp6A|zAdf$FADKWLm zi_bV|oP1+ig?6q=%#vjIo$95I^y<;hso#%$roiB+BK?*7u;j9sfY`LkYW^K7+uZ@_YZrL*A{B|&i2AAH0{;I)x60vEN4f4Vh%%Uf`=Yz5INH|KnFMedJJIC+&O6c zbHM#a_rSC&!7)sQ0UFAFTkf_UEj1Np)$!}vuLsITSs}cE%8|_1($@BeC!QtGLQRgV zeosxm{FZvz9NWM^z8-5yOkS27l(sW8?%`otT|#TYUYH*nQ0;7bwgej63!RvzeE)J# zd5QlMBE9Oc<`VURFd+3VN-_Umoure=f834k=;S~^l!G5G;IBaTqg#K)HTxYcM;#*> z;n+Cudf=&Jn|SyiTUK+%j8q)v+r`d$SC$BG(r8J7^BR5Hkc*x8y_`1+8@bkJ-f~pA zDE?y87q=E&4`*|Zoh2GM+7D1U|7nI^pQ_3F;YdM*)xHpwJqCWAl+5oH*it=6{HL~C zb&Dx;H+lWo;p^p>?2oBGrP}z`9JsP&SW$>PkNvPKAffHT_vZAu&C^BLdY6{usfOlf z%gNTU2SinaC9j8ybPf*(Y8?4{1{8m(g%j1S>qsi-^ zQTuBPv+Qaix}RR@wFnl?I+$*!iRd&cMJ?>e6(3SHce@rW>DC? zDko&uQRmry&ZxoFj4h1ix&N@!U;h(#d zQ(?91mSz*(1Or&O|I|qJkRQ#m$p7=JuZAyNc>3_$6JvFa+G@qk^-1s)eSQUV7oWww zvPk1+?kS1|Oxm-6RHE{+MriN_a|0*#))Ufxw6B>DWKLodGTlV7+4cFFB zmdt~(H`qT}UtWoS>wdv$lC0-P-H8@A7!eKX^K&;@+*pXdTs}zeS$y=3WAM>i-7;GX z(WQmR%uhhqR2-AZuP;kGQ%TG0w-tdj?#GsIHK~6HveHTD^cBDD7Ilkzm1y>O4Nx_{ zXXO&gvE zse_q!Pa(RyQ-k}PZH%lZ&-~(;;iu^^7JcTHo_pw5@Q`PL--jQ()z*aDGouBwQWC69 zB3|mr7|&0O$p5O-tMvDZb!J*E zK%rJEWig$;Ww|-h7~2?dZSi<#lPFg=cEdoiZ3|#sjQncBgqF77rLeX?H zEegu}sTWo{*Zu`}URaY@70jq@`XVgO-oJ9r5FuNKNV07?wC0ytp`sBf>fm6G-yLz& zG+uYAjjHO+kyVK*0uH|3%&|SJ7;E2 zX#1j_+A?yHu`JIm4jH$c!OMfgMUvP)d*`jwlZY;1np>}&cvo-!KGUd~FR@}S(#r-) zm!|CZy@HP{Cs&lVT{2JZo&}u+iT0U?br08Mzrl4oMR=(wEV-Yf>qLKZdm=enf}R@R zRjv0ik#-H*GW)hC`kx|O!36nM>KcWm-CVj&IZ3{>5Mt1@=W^Y2ayU-XzgzoF-I7Zf z=Jxn;lWK9NEmbH>jZ^VICLNuuv?dDRabGmy=#X?6teN)nv9`sF^(*gvOx=RJ5hKdv zlj1Ypgmn)-^BboJRC@yXscV`sif#%BfKLvC zazwhF<2zIrxUZZa*I%wV2bgQ`o0a#Q>`QoV8#x^2R0sF04V?DA6rfkNdKCDsWj?7i zIBRAYcmF_R98cfU#;qo3)A68>o5GQ+Xq#jQO*-E)?q%P-Z>_}ppP(L&xw7CV#HTfx z8bb8Ah3xIR(Rlhf*UOU4A#3aF77!$_|9m?>vjb~)-~FO3^;4Zvo{UV9wtp7G)kK@9 z+pji+21~z<{(Ye$Zaait7fzL7q@q_XlA69Gb^Pd|XR-`W2$$fB2mbv!A{&3ECB5|GZO7`RLiszuy3uTk zja$q|>8_(-JJY4-kDuqzZrkBAf*j_@o<`eu6*(Lq{YWwswX-L|n4+C&|I)8(QHkOI z%R0GYo+lCm$BDgFVkP-}mp=(}s6X~=Rktg@oYeAgFFq&fZl9&-`1q)X;VIL)zr^a4KHB6zj9u4!B(1YLNv9(xP9o!&##~?QEkZPt7J7{>%$s?qCo& zO?3f(LmHlmtTNj##<%T-_uTG${lJF&j%b$>%Fu$HauI%gZAX;jX z&~f4;q>YOFVye;TS`<)$0`yr`ua;(~#>|WfU6JDOS(cjknMPIPt@Jw{EwzupXnuG1 zWBqRq62_!~tel&CXmRs(Prl7|P=`!MYu|w0mKk|1c+oxn*-7Mp*qTJb#JFNL+*$Xd zs<=?vRdHLRE=H+_#aBH>+naE3cC_6uK@9>QkJaqV^ z#=M4G0UsD-1y*JrBmcV+>SeJro#P(SIMI)+tl*EZjsJ=Ysod>QPcSg9Gw;{&wC*T; zs$*0-#d6bj5qJ5oY0dPCM?{{%;>hR57NyhO-0RLwA(sl6BD~M}wCFoXBHRuO0+jBp z*WS-$Uy9HTZFB1Sz1RT+UNZ5PX7PVnZa-hj5os4_J4BI0QG12*r@GJifu!XQ?bf63 zuj{IGcA{AXs}BF3X_kg3%D1)24=qIPLWs@#iPIYp{w9?HTy<%v3S91SByJvV zGAQ$-`S+WCb9`PV%9&n2VOnA zJ`#~ARN-c$l|HkOzEe2f;oFAmMSgn9E#e^ls1=^c08|LP`i|n?Y~fG+Fgk2Z&1n#L zx+I*vVU&d+!sQ?Vm2V9YasWb^BkkvU(c^Pl#77pJa4(%ufHJ zDM}ZbG`{!M_v4;J#)O{C!M!AKxD=^-qz1z`xA(RAwl2E$Ag`7yx}~i3$x2a-tRde; z=y{{aN%Fy#d2K9v51+@X#O}k0tF0HGy@$#R?1s+z^bw<;0N@ErzaAs$RoVY(@6P6H zo%w1?T)&8p?bHuxnM;I4f=IubbL4(&n(BuKklHrD0e=XSXPO2oZvOK%(XS-Gd%a|2 zbt&;O-A^f_&GqRPuZml~(4Cg(+XrSZ(c!Km_Z!!pFddX zu>LITwNu5<2L~$SWnav-0FE&$qdd$tuRYbLY=Qxv5~NLhy^2>FUq zECefmerY@CJsV}8&)=l_xxylp&%5n}kM{aK{5E|y$v%)TI;V+={dE#bzY2GIQrK(d zjpeyE4W9=Y$Wad2S-sj9R?NiC3x?Y0z_i{uOO-&fU;ulxG!%B#llw{5> z0_ziSkgx3LQ&%fB;}h9KGvFL($S)xJC$~Q5CDZcC)#cTnpG$QIXLr|S7*@As%ljfp zSVe{Pu)fA_FA7I7Ca4r6ppd_`sdr9z za2g36yj0tK3~=PZkL9^|u5-tyNw*jN!dIE#g&qGruguae2nccuYi0Nj4v?M?Z0Cj6 zWsw~@@zkST7iYRsT#G#O6Sc$zrkJrivjX+};lMO!$6!G2Ok3K=p)u8)&wago8}pB* z?b1wJlnAeQ2`ppI+l#+Q0hRu2?-xGv3@3-cTdI6d=+H>ogS()1IPkQulxEM zISnvAW;rV8S$HkME-Ut=PxV2ge=jT3Qxnu7ln`k?XcE&JNPDl`oS`y+h|*hFa4j3r(!0a^!$fWI<%XP~ zJ47uX&foCm%(~pmu5|H+lOZmYTcK2A%vj*<@bnjt;<<5%e4}E;$qc>bt zaNW&k+i#qowAQkhtK$%Rp zQ;Fuwm0czUUg~YXMli3Y$^X#aANRbtqJB&)Hb)M_8edUF1mx-7=&DXF--z(_hj;*m zfj~NxC%5>sf3!M7&Zs7D`*i+k)03AY^6&R2-p`Ult?Vr;k`jmLThxm}&k%J3tTYdU znubO%Vzhbx${L)y+TTycPZ_bDs(+lXQnpxsMxn8R@Y9T!<)i!P{p`oEUBS7eJpa|~ zO4HJdSY=BdzY!JOApRo|9ZFxaQojG>C_l;*UH1hCMy<#7;y6ecbENYE{K|7?he$wau)R&>^eBO^dY04}==^@_g11C3( z?hM*m)LgB$pX;AUG>Wq{$jYTCFXx8v)l3otI5O5r7ouyazSbnBsT8V`zkKO7f+zU+uw(LtH_Yswu~ORZAg#y5+CU~ zx((gj;v%<fB^(*gsFU1AQ^FIUYAI!l zOaJHBNXPH>%Jv6bJ((&bA#)PAtqXhd&tO2-{~aU0iLp}v*5}$KMy~ zFOzHAJ3JZc_S=<@;HGlZGL77p<*L}3o#*;-sGm>2ro)C??3yZJPm9I1foCxyPXVdM z^^&`vFAgR5=re_dX9o00{aUpb&<&QdJsM;EC$jnD4W)hNV-LnpjBl)___B|xOOSSS zeCU^N(FO-hxBpESEKE!`rl3pv&8J4HEN!#@a27x+*x~f$C}&v@mXLAEu9qI zE_8+?mTTg=fl(GF&#omm1xWnNRQjK@lY*cJRpU>Iv-=4mJjVy%ag}JyYoCPo{2p;H zk}KeLHa50wkCg7LL;UG64(Ah9))~Q+K~c-ioum3iT@yXrw;soaE4JeA??1|GH_qfg z!AsMok7pQ5H@@b&P(tILNNC>^7JNYvZ=mR&N6(p6{SvMRdFT=6AF-kY&E397ueZ1jpw zvO)1*Umogx-k(5Bv)*kbxfq@cwR8q`e4LP+ir?_BZ(?k_^3|RzhWhO?<-XVL#rhe|fZ-oNwqU zjd=sP&4Z&;BZ{bbbbOsbxMJPuA3bYWMZ0Z8%?cVeD^4>Vc#FIYJS;od!+y!Oq+>kX5a823&5Kf1rXdCG|S}f-0W=%|8F5 z&-1ip4x9gIlq|%9rPgivpA{C_};+!~Kvs^)~GE3uJp)pt++}c`|j}Djg&GhRN!~ z@pTKn>m-K0Geju!&v#KO&j&h|T3Y9VcmJ3g7RFd0jo2tXoL-FB8B*((1;#H;eRoTe zx3O{(M=?I#lX#3XDcn8oFE7cTW%5^#)r)l`x6jk%Kl>iR$jTaW-juH@a8JVg-onwp z%Rl^9m++Rvb>Nsos&Jr4Y1n?Qh?Xn<3O47TqlNkUuT;_POP?XI#pC(IeYPQ;XIi{P zE(;ti?Std;CBDqk@A}mK!F)w@6PmgdS{0WpDy`Q~+r(+Vl>J!@g6a45?xsC>gzib% zFPxtt+4+Y2+mzoM`R}NZY<;?(L@D|2&iI3Ue!@O<&EKVn?H@%pnn$8y{5Asqryn!e=mpzfc02GA-yUMjPOiotk$2?8kY`aM zBClFkwJoaw`t<`iB4J+aikqCRl1&^18`N#gZ8O38M1a(71fA&L%^f z%k8bf7yU(U0Yd!P#+>g_K@#5A%ljc^+DkU4mm~s}aW?9VsL+&;++?TFV%RH=+G zWlJM-dNLl|4{ltzflKH|%=uK#&4zEixwNo_1*xpuZW!vcGK;e~$GCFp=S$z0lW1#y_LQk{mnHUF zfU--rS^qdUsgiIE@%Ik5rV$;eobnpxqb`dq|G<92wQ~ol5U0pJdYxH2yvKFvMpZvOx2V@6|?w%*#YdkR9;K}9jTv=+=STT4! ze6?|{L3M`Fk#}W}Qs9~ODzWr#>yA<*`w-xB?_7!V{!p_zZz5f3U^9Um5*uB1h^ED|Hn{cRs9~ zJOw_aQyLofpOnkg-JFGr~``2g>tl$31$rUU80{?`|gBxcPsqWoNQmx-%R!!6gr)75W)t90V zb6D;}Md%?qE%8EY4;Di!i`9Pcs&kzzwL*Th=Q$6n9ZJ3x%wmbCFT29`4#wCKWHt?q zzy7_V?qQR~H+~UX+-fdE?+|~Of6yB4eC9iBvdi)Hm&->rrA}k2WyqnW)Y~ZSw*hAa z>(0jS4ioW)&@ethrd@TV*8)X`^x%)>U89am<=>AqIQ3;>kV9(DsG3){ldI}P$Vebp z;PYvm{n^PqApvss1pyvr|I+zs7di?k-+4N~JQcgAw=c@lPLhto+w!$(cBjb3;rNLV zA)@R+{4}mv_GH-XDEs&!)1D>%Zf@3H`;Bfi&T;cRerlTZQDqOtf%d35^@|oDLcSlX zNalkpO%Y$*M3^hcuG~N*^s$UJwoa3-Gl;5gIAg62&x>aGh|tR~Ous8n1EeZ$n=h=I z-C6L`pzGx98Z*=fg(^(L*H`5+I}opH^hB~7R?+)~P>mp2;AdWX3G+0mR6keXzb>?x zcBTu0lAJxZ%ug*jjjQMCyh`JS(gV`X-|s+{iUwYV6OPqFt<4z8xliSCEg#|GU;bN= zWJS}^$(W#jYescVrY@@iM2NmoT;a7U%*d;&ndCRfgw6@N8f83OI;F1bPc`Ay?Jt@# z(MT5l6?&LF5z2naU=oo%EQ_@#-vVRQElXyrPRc*(j8mO~C|rJ8`m z;FQLO+41m6*YD85YC`YOWYBa;b#e2V%`vku5n?;}?x?p40}dtI4?enc-t;MWhISpa z&dk}8rCfy9*CR~YS`X!T{Ldf$tx#u&8>UOl)(&Q1eoAibH! zU7z633rR#`-mMAv_9EbODtMzSkbSOV2Ah1r7t>UTlye~p_B-+?gE++|@!dwkK~y(dnDGVo4fgsTZ7%l%}-BZ2%J z)V*{t@X##|21nU-IX2@p(>SGugR~LwU6;D1&0~=)hq!uW7#_ZWw=-h-jm8Zh9M}WA zpi>jdy8l#RAc|ue_3w}g?o&69De*8#xsjkxt|*wJdSpK(S%7^L?o(bxXj6Z37+Xz% z5a8#-YDB1_-i5iS3kvq@8-C9X5BqQ6o|JMGMxyu!{s|Zt4N-2>>_jLp?qiq(=#M#{ z!6OPHG(I~&zh;_LWOzuMgawxMZ@!F(%$~;0A#cJrMTiiYr5T=Z%!ov9Q%ejI^BZR) zur*BzKK~NN8jiF$I^9qVCvb;a|2v{5XD3bn>I=lf9yNM@r$ZHb-PG7fL?*PKzcA6N zBDgHgdP{?g28MY6;2vx*9_7Zip$)P#77K&!eN$V4o8K$J3nQ3uCq^F}@UYqb{YY9A%z~^fxCDD3 zg>h#?i#<805nqBY*EdYJx?pSEM2^E)h|ocr!y(5`O);EnIm;3ZLF8SZbVe24*u$VU}N zoMb*4vieZKG!F5Pwx8IoSt3HRNxDIVzHEA%nKey{FU}Rb)q##eo|=d)!Jni>Qn7%+ zGOH&|U?f6NA~FE0W>n~YujCS}(T^`8r;4zl+6+(Ffd(cvd_+_eVDQKj?nK4uoY})tp1qz$U|7i-pX`p{mc^PSRi<-xfw#xG!h%FTvf}2{|GN z4560SAso|SvZ7{q#22);iwnoFWd^?g*rr)BI2sbY11!wI|og@EBvZcYvZ z_$-bKy>E7uD|nbDM~hYTJBWfV z!P5fRjZCUBubw40nI2^e+7UEpQNrRb&LB>DGsWI*Cy6JeIf)?>b+bKLm*Ar;zvVd4 z2FNpC(9J5_*8)K|e}s60UK_nEG6mWnws7r)7Ap*w6G!bp)wSSWbl83Pd4=*4{86pP zJrHhh2cH9)B@5pkg9wPY=&d(#Ln+R!@fjTnG#dZrYbWusuYuEd5|QbPTYsiWoq}8{ zVhHobB{sWu+<@m5OVCw83riqi3p8AN$4`WYB#x?9g1FtoHJ%@V1QO+PzKSlvtDG($Jb)Q-!B5qWMQENrwpAW%GNiC*X`qHAP1DagnoW9;$*cHWr{^n!N)Z-0G8pOp^wzBk!@J#dHtm9NS60 z3Ad9|ma{pcW|+Sz6CtY`nYv(v{1ciIMKEuT&zPCu;eqCiKG=42$>WUPxE-jOE+uE} zG|AriIKY!0WpY6+Kke&^S}E0P45lDwv!5(v8Uc9NWWlkKpbK^dGIF!{4U$FmUk2O+ z%!8WRSD;lx(_5Pvh!84OyJvJLw;VW;0$jQ5iPL}JPLFKPW_<8)>fe~HmMA1zNkE!EUROu9$m zP=yGUtySg^Csa%PHyGcI_R#)`NCyFPt-lz|93viSSCD~?70e_%<6+j_$GB}*Y$_(? z&YK-*8C_-;Sn`{>81n)4PIMG!rWW^aP2AYXL$P+;4_c(OFk&b*wXGd7jbjuP83Fw~ zUwBO#EPD;Q7$1wHT-WnioKqEHhDTNo%oL-9zuxUQQ{(trc1;5hcb5@Xa<;IS6^5&d zAQ8Nlb;3aw5Iry+rYGkTYB_}8Op|`dWoq3(3`KSJLui0%%r0NUEZaNekmIx73^0}; z#Y8ZlH$GD;&4T_Pc0{p&Wos*%Zq)_5->_^BX3vgO<$q9&iU6Aa%_t zu2P~1%!&Fai@C6D9%Tk^Xy6TGWa}#ZdtlnU5}Z;iWPjCQx1-$*PG1 zeq)sM&GGOj=Q43xVBoyWRe`XObI(X++h9$@Stq;{B|@lsNg;Ho6>XshIZ?=jnfmn$ z1oMX8%;`%!oY?&@bD~IdYYls0*TYTD9WrRZbygE35OpahOk}?8+XNnv#^~0MF4#Jw z6s`0#>SF}8N?X$M!6LMjD$5UmrS$<}EI1O$LJD4EUV4iUcK+OBkia~`i=Q}SS9rnc5+Ln+9{KnU$VJ|>>1>2!l9%aUL86ff z0sFf2VC`WV0&XG_Xp1ujyz%gMF8{k=l_UsD>KzFr$5B1Y0r~g3wbfq_H`Kf9%UAz` zsJ5YSuJ;z1kj%;(afJwZ3Q%0|8$L0(wV}@xPKYW0(b^q}#5lQ#c1KN<#4pV3eY-Tf zEppT^#EFmv2Em$J)tCmD(c`oo$mS0rI9Pamj`{0mQrWjr#GsxC}p z2{tEf+8Ph$e+P%R@@zcPyr`BTfQ1ObF)e3-U$lk_KZ`)N2qgNI2u;uSpfX*LaTKVZn zoMYdLi2USjyyA=($0?D|dIseg^MSlAel1F8rR3!YAYdNSX`5id8>jyBSL?aj-07~h+|cn~1k zewNE}PLnivpBLEyqiJtz-zW*TljdSoHS)rd7=S6PMunf8-%zv^eVYiW=F&ZfS7B!A zTKt$n~z(gd-D#d!?|K@o-MPms)|Ke(Vou`{V)c_1VbNzSR!22cCl_f{O@Y$c3P9 zP2*0_JOaByvH7)^9TjiFi**~2C9wP8HX&%h_`+jM-C0^^_W zJ|TL$T~q9Hj($K)6z8;hLu_L;CKGA@qJ@Q=-LYYw6*%z2H_9?&;>}uypGkSn?iG+u zmpldRwkjmzLLvg}xINUo1*F;=wk~W- z@c6ai%?d(b<(XDTCTW^E>e9Il=3K~8> z3ld#ugKycrwV-6~ryFuFo+cSqyanm)N9q=35J83Q`izgVOPJo&%2i{IX9xJ~qmkwY zg(JQ9@NiFyO~Q!_7G~|`ufRsmMc?_PPlbmgDjQ?iH9Zms>cNE1qUul-0O^0K9};8> z%MU38Ppbf*GLOU;NAXC^A;UQbshW`AdVlTiQEoR)M-pfh{R<4PRKc%y)df|fT8MBK zAoE3}o9lqU`<=!H0Sb-%wmR>>qD1JQ0z1>Ip!7{JIs;3~Sy7?1^)zl+Ip(alThqht zw(TkSFs$w@vzQCk?f#K&9thQiTi5t$0j%PdPx&;c@DFd1kFVfiDXZNi23M5ZZE?;V z5Jvm76AYMgNs9Y1p-7Ofv)X+a=ORKMOU&+m0`cs*+$I?O=?`7OUIkqmd*VAV2IU&6 zJiyFrEBM4YI*s$pp!&~i5qI&`;Nb@*axTN;0rq5&T$sdMHp9aUzOew!;$Y?d$Ow#p zoL8Cm+bz(tBM5Hpuq)*3PPZbCzG;%LlRZM_4bp;?o-g_o50@M)`Ds-};12r}|}fb4!RHY=TjoPAc2Hg%4J{}6w0QcZBl3kWei5L( zkOl8A3Wc=eK32?BaA@Mb;R~QkuzTzh;&iC}v#*2pY((g?fgBSaWC!a<3%A=z^>1f4 zL8H#q-3kh?#>|{H+O$R^hia(amGa|Z4|%)3(V?vD12LdL#Hfg_&|>uh(<*)g++=}} zh1C3Tf~D-bw-_QpiJVB7s=^$z_5B26y<#()ryW<+&3}v{NN7Cg`~phOUka}0Z;=+` z)e;izqRmcO>IXb~aLBIYQ<2{Y-?pP;(YsBPXFIXZuW zbQcFdrTNHpfoT!bY6$$`C1;m}Tt2Co#;t#wzetWm4snwP@{nLh#?OB+tP_pH3-8;s zlT4qNDLi$??pyUVNAQueo1|IL9GX!bm1mqwu=-%FI?zOC10O<^iO>yq7x&*_yKQ7B zXbemc3K;`duvr%x9w9%t?#oIDC)J z-GPqF$~^%;9ET~UP?H5D%kv%y;$hnXP>dJY{V~JK~H8KLoEVy0rxR+vvmywxZTgaG)}q zOLm2V{8i3724pkxk_G45z)|k0af>VXrE%YV(4bpwUZ6C#t{A=tlG&2{C!lJkb86Ts zts=xoMF-zK5?InKBZm{-;Is~DQC3q~ZTLuJf~*;Cn+^}-nmUJ@9q|nfQ?*^i!~F&% znrX2$S)mKzJ5b6|;wczn%y~v&eC*7=ac;*wN!rd7LjdN^t$(gB!74VVI+@(CD{7u2 zU>oi0I}`F{a;`j?hBBP+tf~KsYW5JffeENoC zI6-KpUPb#zfVe``2`4lh{`>-B5+B1U0JhvnVlg0XUR{ZOe2#-HNCmT_aX(H?L3#Ue z5CCFX(IvjF5YT_|)E8)0O^@}mmdi^p(N3dlG}V}VqzX5vav{4%n(d^IJ6T|SWAwjl zf@1FLt9gN&2$rX94Rr0e=@yy{C$RhGR^<(fj;nHR*Op+@PR1YE&>kYC$tk>K0h`P} z4WP}N#yt#m=te%ei=eEmrkXPm=BuVjkYfRo zg(Pwn&ZVFRX<35H?xu$)5n`$}ri?TJF$+{i41&3T^&{tT_SL#S=R+MhCFv&YCl;(* zz^%U5h{T(Ecds1h4z!m{tirtp7#5N-4PCB2dYU+$wx7pZI}q6OZyi)SklIg`T0&Sw zhXC(z1ctP45tKpzhhc2p!tU?(lV0sX9;5j_h@!@L_WM&1=2_vdM2@os%DaKtRe0bD zdg&$>HgyNido19+HA%e(m0@-aScRQjSFyi^g84svNpqa-cJ|Gw7yL2r*G(bpN^r$4 z-*N5+allgkDEDQxPh!>*T;Kxg8;dZvFw9^(&hGPrfopPo*Z0Z??LlyJg9E*|ujMN%;7$vs{zXe65{Kp-I>3GT zO&G~jALS;#pOWk$UCAmTmv`V8sRc>TqcGq#7LQ%8plSjD6VE&$M1qyUnr&>D3D&WM0@Fe+$BVUd+CHTm|`&7gS%RYp@Y}I_P|CE zG|@87Z3kLl_kq!U2b$P0u=-*V?kc zM*lfBZ2lsB6!{Gaiz3iDGc@U<#j#(JCI6m8%^*iCgYWw zEiJHzbsVC@be!vhk~#zXIODYMxsnNVgrquQEKqo#eB%RRhSM(@5o9n999>j5( z_;eMPX7?w9yA8Y?+2(sHAtZ10kj#XzSnO$$TZKO;{2xVE9TwHog>3``L>x+T&=cK`u7B`F`_l3b0F=k-F&Hzljfy1EUiYv9GE`{u`N|D zNurBy!8PRcrtTg{z)x#J`Y`ta{ZfJoB=@_CufSfzdn=u0PPCrg(XIVX7aLnk8Me(eCx0CfwbQnMah1A(;&P$86Hh| zU&?Y1CsD!UknfC>NPu;hU;|NMMyOQQ8^}r@Wr=7wD#~w{bZHp|q$o^(dAek&^WsJsn{ySzQx*4?4z!vw=2YLJHyRYT5xO&B^DZS`vtjA^9>f`(SB& z9Kbw2O=B80S^{OAx61b)a@Dfyrv^kxekaU<5gygQZixLzNK2tu+1|oQkMgG2tigI( z!)!L%@Qf1Ooqz%)M6OmDlz{t-f3FWDP-Le2OY#^3(Y5dar!j2steZX2>rGS&} z_vJ`igYDjp`@xEKeaAS%d`b^d;uycO5Qb|Q{5DKufNS)sVnOSAlJ!B7kfv9xf9C}n zHX)9;acaZQL@2$~Z^tC6D3>6EzymdBJ#@(+xn;njHRmZ~0;E?46q<}a=>RA#u@JX| zPW;STZ4FH)J_UNHjhBKC2YPhqYZFoec4%CSzoNEUwBaFekUIU-97n^LPb3YG+VS`2 zC+SFnvF0ZC_rToWCw`+A?i&zHgNDOA4IxDn3e#gpyZ*35oC|eg?5p4(EN?GSF#?Ec z-TN&{&3aDhH(GM{74d~6gtTQ_oyt@&&>jEfRsBs!uGaI}kFRu0_G5nMhLXXfRN+e_ zyp#+DPAnfVRW8sgtmUO%%VAEd+X-6t#Jts3Mtk}MD)p@ilIRSo_OATU?^HLK4 z?Mg2wKk>PS_;GH@0*^Cki;_?$Am7T|(yM>GNem@0%WQP3-^NK4S4ZCiv3ZnKr0{4E zs{GH1R~HG=b>z=HA5BZI!CF(UBwSNNr`^@1 zmee1*hwS9qe>Fx9!Nl?Fk?OdBt_AOY7O3mQ5wyK{vf zo`MX|Q~gi%LkK6=4!X^iz}VgExQ7QV@UAZ+nP@5Vcyzt`4jiS8(YPs1NYiFIw2nr* z%D$N=Wp2ZW$6s(85g`v1o?Ct;gM?@b%KfBmu~o3}-ZCSkwVkq-=;Nd_Sq_8dj)SQq zVMYA!+AzvI;8g*uCQv<`Areo|)%UvKFOA zM-NUhI4YBjOLWckK}xn^d^?6Qrq8>I1%ffjDKF!JYn&R`)DXcbYQI_rf>CBI_h|wv zAx+f>Q*G9XH-=p8n;l4m^WMr_T6UGP75TRYW~*9lLWG{L>-vAZ-@apa8>Vp1WCPtbgeqZMpF_}8f3Ph17J2G{w0HJ z8$QcZq$M>7OIhqQWOZw)b2|MvfC++ONyuM|#YqtT?6EZMz!<+3x-20_uI>%*GTmER zbpn2Ka5J>n4i-hPIue*S-koMCf_=_@7N80;dPFgqT>#1)wOp7o3Ii`GE=_5BxHlwtXAFy=na#tYaS(E(ju;g~H8??S(`EH{ zK@ZZ55xpc`qH1UBcX`+nlKb-OECA*vT;tQ1h*~%;2hgrB;TpPwSXK!FV+)7r92my` z0!`VlM7#d-p#oa`uv>W-np2>i2raxcCkH*hLakqJbAj?E4xva#NV(ksdDj3E;hNE) zPMicyEywy#w5w?GSYF~+tV%=5ODEcv-kbvGYY;yfBo%VTF2n3{fb$l`HcVfIvl0>n zw?@el)L@u>!g8{n8p0`I9B4@mk4`Q*v;g%@w@0`J%=6Nc7w^Jw(&J-{sSpt0ev=4x z$4T_gX%0<^!#mvR;aEfr^NnOZOjC>v)MFj$_f zE#OE9ns1>(I5Es$(ey zHEG|Emt-xuFG7x&%?T-A^z^v31J-aQ~F?=@Na?BLZV}nnbw(Atgjn)gu-wq3`Pz2}hmo zs2V&%!`$9mo-74oRrWm%Er6Ryo${%#(X{6cqsIVKKW5iczhV3)vJ#CeLc&q~Oanr8 zIO(&_2Fcbod|YYDull=7mEvVqT&Ij??dAx|wd&J?XmxEc-&Ate!ijb*(9sBq!H&+; z+rOn)a<%gz0&c)jvEMVcO$lip>+LQF5}fY!MSYl1+twy0Fck-^uPO%JAuvLojmPm2 zn2$G3$q%H9=Jp(Zt%~q0&MsRn5HDFayo10&y8i8|^WU1Qs88eI50n7Z=zNME!s!+= z^qK-5ZRpe1Bn8*>iUMd()0RKQ|1!c!d%jaYW(q_JsN|EeArFy~Mr%(ADL|*j{r^+c zCRYc@jip0-fc5DXj178R3B0a1qJ%3%H^$r4gl?JSbk zTwkR^xyd{6e;`xatV@-Butqu%qVB3~Lk^^AasevIKFs{f?-u_dUDXQBxlU8EZ7=Qn zF+7@=%k!j5IxqM4?@Pi_8w~V9q9C4XjE|3aN>o}}n#hTyYQlfNcbam)^xZ#3LJHY~ z!iIj#JWpXY`_j0sV^b3yuNJyA8{@+7*RPL7~ z0L1FY1(llpcpT8SqCZ~8D@oXQE*otRxnRk}1aBo{su z?sOm_xb4@z2CF&D3H^?h5YMoZX~Cqaei>sRr1_H3H>|mu&Q12KRu@dGvb}@qsikmZ7>I4;L}%-~p`|A)pB&s4l{4k`35GF?qsc zLduWH62uzpQB{!yLuKm20j(Pb{+g z@XA0%%+n=6sGxN!79KrQ(`vW|dmNIv_Z>xy{dUoc+UI`4&5B%gBMb-}NchW`?ZseY zB$6fHwAea+`7V8$CJ+K{qs0qXGZ%pUN=vH(`?c%eRw{>+5UXn7k42S7^2}+rC~auM zc}|&ok9~;OU~YA!JpK5O@AfKLkwW$EX0J{ef!wboss|FZsik_L_7X2k2oNn%8JBT_ z-r^FP=?8LFS&4u?eBRGj^WbM1+NHk3hv~0`DGnrfUsyWCq9l&EJ^4?W11eCMetehV z&u_8V`uN%nC2F|lWXZsWBu)Y~_9CJm(?uwfdJVyBZ#VvoSazM#4|j^i_Ak301J9PI z_A{D)z%^afGx})>%wbpK(o{H!j$dbbY&Z$%$&N0Ft4ZBQ2b zOVZwxT83?C8bLt=;Y;lwy$!)QtA)HeO*ubFcidQZeQdZ(0=_k%Sh)(c;pHbGlCmwf zSP=0!5z;oyd^5G5X>0q4&8x7`iTtZHW*^wmFDTkh?`v? ztZ%enNU^|BAY+6Bt7-HLfBpGB6 zjxv+sNiG^zvQO}c!PeJG_n`UU(T-oeOjzO33*vHkdIIAT#b;rVd(JjqngT>fOXIn8 zrw0&D`DQI7Z42gt?A-o9+Lq5`*aKvF+OQ&hlBLR+UI*oS5Y8Xwut%qi)umFu{@^4! zneqWIaMX#Y7i8cXUN$f>(1E`*-}LY=xn>7^b)5euA;6Z#IS5a3U?^ z+YZ;b0r>DB{t+|C(j#lGb)^DP#KQ=bLQC)1py~k)97QTE-3S(veA3T)G`I|V7i>E9 zfD@UyhI#{0lF^S;qJ`wztIce1!8Ho6YFjzcu&PI5X8*oox9AMS zwl*M+6UhH5u}*|!tN7RiZk@Mz=fIXDJ@2H|>l)-nYrLG3b{T7;8OwM(M@3D!Z>Bk6u%&6^gjF<>A7NX5Rp1&`KK zXi1@gQ|!Eg+uC`Ky(z1yF+Uj~qRM zN2AkUW`p={qiVe)VHv#jvgp$RSWFP31x!6a>SQ<%h%!TZ-;C%>F*W-dL4vnm64IW| zzV3g9lUCIE5uxWZ8^Kb`%k*)ny%l}va{rLgdFlX$QIT#r!u+C2egJBv!V*i4X<`in4I`lRMYfH(S}Bjs7S6D2!FR|Dkhw;Ju1(<#IW)8{Ugnd_qqT%Z3iW&t}Kv zzYUXr^iz;pJNP;NGk{ovE!Zvqsnx@u+y@rVFX2+m)72s^OoFGZ<`Hj}7`2Y&_nu`PNubEJfs1;}(8qE&~UuhFo6_8m%Xu#D=9zKr`v zKffQ1+FMvk(!s%T?&__>YQ|z!pEM_TZe%_35?`C#;btGrgdj|tACT4ViYrj|_nHY6 z(QiSfEU0?}MEs5HUs4=@2Uc*HKtGx&;PzE&XTJe7 zWxmOBosxCtHY20j`|oA_@h;@CN*`Ta@PNxIN>q0YnI$Zq5_<9O&@oFG#Se!c;r9&1ybJ$1w{O`=??Y`0ar-6F z*#``T`%El!<<%MXMN@)RHIsD@v-Pfz$id@q&AvH$FO}jRQ?xiNeno!2FHa=M`|rt zP$q@RFl|ZY|M;+4BlqgGQYpSG| zWh3)=raY9jZuyKN4CZxJXP39X^+x`|!>wA) zy48`;?dQ`?#`DU+s~m-3|L1?`A~J&8pBE(_OiXp$QMchq`U9XkR(GLGz;h03i(rWy zahoBvKlm9#OoYkP92dn0S*lw5MO4TUXI_A@q0naNrSx3^!s8}GvjMqda@xeGt3R^x zM+e*Y_3zW4WZ&_9nDHTFvaY|E;{jf+va(Q_$il9pMDnfNBCa8ZcOG8k6ohDsryRFY z>vN8)$GX4f-ml$-_3tSw0EH*4mW_AE^2?{Z=hi|4v2O|%nMh?-)1w|aJinujXp{Bw9>v7lUZ z`Y%E@iy)-G$lJgg`$(JYjHzYms^8)XPgrwDcSKT&jm4O=>^ad>A2Fw05 z6>nDuH#5s-6LbRJ$$gsnQ)nUe{y)kccVABleyYIP`Ol2qzp`JZyYo3wII=$yM?{#Y z^Dz%?xGucVB7WWUB`(#4*7v3PsH@d(k~Ax^5wN=PMiE)cLHr?~nq^X3Mw<)hct3aLR#HkIH=F#ez5+htIJS9c!`cQM{*N4W{t?CLacWTu{UIQ=j)9B@1FtyMZ#A z$wRsO6t(eTt}v%X7uG`pz-yDqzO;!KK#G8DRzrHR8PN(oY9r1 zHuG~lKR?A9r#G9$0oL^AeRU;T2Y4G(BKa!FNHtlZ*z=j*YW$p*-RP69XXF6fagH`Kw9;>d{e1$CN6cZ!VnJnGHX1t2&?i zV0`&(_rv!^79VjIO}mn2=lNv6xOZ>q2a=gH*msbWCQG|GOoC2r${!2o>g8>{=0tKg zz3r{79lhc{CE%+@8O-u&{EnfXjs}mMD{Mw159=FP*PG@XEL9|LBn_?COR<;xM>6)$ zztv9bZ280fc3OhC(a1se;RZdtTJL?EawZ9Bi?48BW%F&$>3db;(2|Z>{R^aScl`22 zUgtc`qIBX2JZJD)l?a6pj=RWv5@DdrUm5tTb~W;}8JJ!}+E~P7t2LHttcR|#Y}*um z8|_XX8!z`!G0<>K_nqQk9;|?Xk&r=!OsEdR#M{h2g^nqYd^>u?a0q(yLWgOyp&t4E zwE@xJSh#L<%;i(=(u#T$pq3`0>@y79`PPGM`QgETTD3fT+MA3TzO#aDhA*emSwCNu z8T;`akb!KA7*I&QVF}NB#q#aTWK-F|(?V|q0sio@`X>Q>TE?7ug$si;?%k-%Rpl>A zN50a-d-A1p+*(v7Waia!fk>^xltf9^6J_m$0y4^eUs?g^&He*iv_}-z1*wYULMBc=+-X*>{Ge0xl^!IIFX!uE`U7wI)K-X@@yW)mzi9 z%PmilUuHPhLFdBPj(?fG*T2!Ao9z$zbEOyrM5c@^M#XQ`ievJKRKLos0 zMx4l3Fgli}SPCcFcZVMysE{eKYBx^i`Ko%|4G(Yis+l|#_+bK`qqp#}+Ozb4~CsGnMRbi^d|jNUx4p) zUuVKAz!ft~s`0!~VRMJZhycs68K73DUClcftxGb|o_V*^TueIqWRYUK1!-G)D?zxL z!AvXwqx5^LaPD26#)zp_-t=PyTKaM*dQ4t-d1OMu(MbLPlI#pGg|gDu{ONAg9#LLi z?>Fb7sPL0ZOOB#L0QcR`Ld*pO^MiKq{BLr@mCgJG^Uzc7w~TK*_URt? z)>JlaHIs4FIYfQxR$CWscp=)nYwAL)O~`6xxgUtp3q|&n-q9>7I9in8dE&+0W#_m2 zA2D+11)%~daND`G=|!rH#7B9*TvN|>8p_MuTg`(y=;@>s3#yRRh0D!oZNT&K3RR-% z2=VU^{GDH1`GqZTgcvgF$`t%)(a?>{M;cwTKjuZlRrd*-tJ-v~9!&6gG&Ss}*Hh+i zkrERx(}HS+cpKoyLmhFhvAMf$Z*k*?{YbLCEVN>pQOhDl%7|LSYTqss(Y()r8b*55 zrE6qQ@yFg9SvtIYHED}p1|TS~^g_sgc5`>9%i)>CJ1Z*;!xWzX_N32!QL!aug~0Iu z$>d+f&LoZCDNlByBqp!44^C{sTRDG*e=~9Fl`nh0Sgpm64wm+@F}9LoRsS1P{3w#a z|5wdf6Hl8W_pP}29Q!7CKAUR6%1wve$gQDQX#sNjtkR!_TwfNtlA(Z`K~D2KTwL3+ z3E?C;C?3;6D ze`6k^e+0b1s+9z%zX||$^!sS%DU%eMyo9?cZ5gTA`;ipAjYb_*SuU9`!_56tZ8@b% z?+@y5Xa_4R1%2w&z`u;^)ISZm{KC$f`iA<_^Do(#p2nbg7+2l&MCz9?=pCwtk{7Nw zXt~rP_6Ld85=H7ezPGbIK797% z<9W)rV2rX?$rs?^#Tk`UOh{@uuxwN4S+J)pXfeP3^9%dm1Fm5$w9CDLjf%94kHM_& zoM*pjX+{YlBksLQdh5zgyRZ3KMaI*UG|m6wXEE5WY>Rk)Yvl`R=<>f zd={TP%UEKd6|&bv2TWgey^Ger9&Mg2xZje+D}EWsMiGH4Po>c>=+d-oy<$6_mx*iP ze+xf!&f}aYZ+6Qk5o)3~ELaQ1FZ&!}7<)cs%}fi7#Oy?wHO6={(niP%NDs8KZM`jP zACvo+QSgwxw^m(Y}_t8*08f%U#VDP+0rPs{$TNjFXsc2h(j+rzD1K%@o|)n z10_*_mgUgy#z<|4a<`d5K01}3W)JrA@du6eQSg+2$#^xi@1w>7tJTo$92f6zm2gTG z)q2TfvJ*x20pQ;-vy!eIv^ihv<>Q|Sqcisw0Y(T#GEr9&`tq@AbB$kuzdrK6In{ar zahY+e5@Qj1D%;$G`l{!Nf7;3y_t4)&(y9Hme_`c$ID%hTA00Td)=E-_^PebWmP~VAeG!h7W6%pw?SoQ{<{gAJAA~*o zcy28V;eSr+jD*b4Ri)qP4i|EY`y(x1RIR@1PbQ-5U{sc}^%3&7TwqPN8Y`#!LO(V| zR!YWyy&kw1TmG$2=xj()R+7Y|Jbue=VLEu-CnPO8t+@AuDU9j!vgXT6%K*7|PkFtr zgX3T!gq@dvOMQ1ujoH$~|2p^_I^CASLnH=Z3mtnj=hmkp$@^iUij`{f{?bXY6E)8` zS#Pa>f5dQ!%RgBNc9h$RLA~j!Eju$7u1i3g3bg}IfCS6{Q@Cf3q!Ia)8lq43m-h0j zW9u)<8mhSm-`~;xaDFGcQ?vEDl+})Z%>W|5vn<_Ugt6P-lf1_mK#juPi+{2BD&kAx z=I;b916+HiH<9D~5U&z6vex~x7^ZWlq~+Yr>i&Q-?(Lx%zP*Gmvo^!%R(o=U2V<&d zXLt}W-Arf{_OndhKPRS@-*Y_U+#k60$!Z`>T?YEp`OXQw95n3HLu#YxaalFf(^eGt z)IZ`4xeT=28d>jk`;0hX6mrvWlT%IctkZQwa~n<}_IKp0U$ZxoZj&?Iepk-(H!?30 zW}2USOx3vhrg=p3Ue6Ir-{@KYic22n5f#v>mrZ@^jQHt!h4}5W{`!D-E7;%2KYCZ^ zhilNwuICkFX;Yd86tu~@a?tYUJ63;5E(1eh)!r0GvB`6@jDqRNvZ<-ZvDf384`?a! zt7V}3jv8Vv0f>r^j4YVDms#J*Qjq}&Sq!fJH^rGsaOs@in@!HM7pCV!=}4`kUuppL zZ)DZNIdHk=V0Zp&6*yDzVUBsd!&%Iz>MK`;I4C)>>jut<*ZbDOgf}_!S@a#b zo18^1njtSfU0N+?kBV$^#{S&>jQ@?4@3+=7&N_}A?9Xu&SM=duaKf}N-m8yj+I#LLubWP`yF9Q7cydN;jSIq>ZgT#>ESW)wFWD6Vxl7GW z&ZcD~b8{f#5h43)7I5P-kn!wy4Je!p8BtJ$pgKP5ax@DnH zBe#xh(~%D|dtiZ%%I4LV_TSFaktr)PYGAuo<*iQ%kYeOS6HiI@F;(TN+4QGNcK2u| zh9fGUSWg$F-$*I4H}4nkT&@L&y*gKa58Y3weto^gseix$cwE;a^W1`rTC$F*g!apK zz{k1FdwZ2Zh>p39qO?1g>_!NefO|(&viJp4P|@j-A^_iODDix2`WwF~%_u%K$6&;Y zsVXCV`f==!4Ys=@njWUQ(>9sMv93(-IMb06F7JN+GaQziTeQBn>xYmXxU_e|`R2~J zd&=_)8%xRUaDEX3ub79Le-!w0AJlKAoe#f{sWMU;?H-&FOU&!g$w1SGjT5l}2tgeN zEc&VrL%eENq!ARP%bz4Jae zdU6!IoB8eO(<+3E8%6}w7$Kqq)Drm7`pJ`#n-|~Ts+{fLJqwc|XkD`&#UlNaQ>D|9 zRd-A8c*sEeqhm&BPu^Of02z5&5ZmI9Su3?Q)JaDe*oew9;09-coe%i z53eq*LX4d%)$Ktqtwwg+fffEu&YE1Rck1cL=Ph%wgP>^CIgc~)j>)!sMrGy@>$^d{Ew5Y&75*Bw2D zrX#bu{7s-hA5BfQkY5JAl^i9sBHm6iJ)*b_{ICWM1zSy*cAz=ypNz050)3CG4X({& zlQU~W=e7iBG>s8Z`rpVnM$;c;ImcA^ngb#5A*`UCA|3g_mXF63bl-FjHiKlK-n|~2 z)AVOyKw41$HwVybTr;YijcDGwE=A%*YO6s%@69QbJ96i;3&CzCdE-o_JNbHA^N!$j zBvuyMuUzNRnKY$&#I$;ljuf6EAR>biKR7&=E4hwh>!bH*UV&c?CMAmejqGc-^PRnU z$zIm~8OL3WOtE2nmwg;7R{B#m9Vve1djS}eU&@OeE;igaibW`<_KJ*XJ_t5&96#%y z8nv_i@*cXi`x_I45IkFkHAo&&1r$(Jfa82iUQY2|2C99*sr9k$cfjD;_g-E*dd(PN$<8tlKmv|lEH}YXF zQ3<#Zq`!T^yYw1rI4<$o8#FwmP2yDgHE2Nl$Epd-hv^v#0+Kf_v$S_WKfKwYL4JFa za|FL&3%+rBm=WTlee>r#V3E1$cX2dnhFZ#aNz#Xd;8q*mv(I<aG%7@vm5S`IJep zS_%`TlJ9D{68~d;eUOwxhKrh?^XhzklaVI3Rp^R~wxZdi!)n)G)b6oR{LUQb*J>g4 zZI)8{0NP@=UCF!B)vn6b%k_L5j76f}R<nfYvvV`Cn|Z~QxuE`JhXNEbya9TnAG zOp5qX@k-kuJ9tYLQAo{Eu+ilqC}+lb$K5A<;h})DWn1?!%?Ws{dG->$rP%%hE@?prG z@atr0M5@TmgsXF$Y2OZcylacyYm6())p=-m?({SH$-JibG20PFl>xRUP=%-B_@||p z8KJ%Ln)T*ZiG54<6@=US?F(zKrBv0jw*`^i6UAeV%^}U- zKdWL57ptVYYHb%@HlLGEx%`fvFMCQdXl8eIdTGiCu(ss4N>NdNjaUj560za`Ga3R#KzX3`$5bbf-CmwlD+8Xm|MKnmS5PM z?Luip`%X@RVKJGz$y}fJO`>bH`6wH03QG@Mtr^m8| zcY3-j(8hE(%()^rdHGn}Bu95qL)Kk1!N+t-pxf$mCB=BnaGjgKTSHv$O`VXLSpe3* z>aY30grTOxwflO;&xzr)aoK*|aTJU%@oZZw3;vZYs{YBx5i4Sh5L?YH%a~fNMQ%&k z9eu~Fd?+9Dr~8;tf$IklXoWu}PAy~8hzLFbsAC8Gti-XFmQ=zL|NN(ot0gY8|14jo z9NSvAQgKu7RzRh;14HRHVlJ|b^7OxoY}q+HJlTGL`{i>3zBN;QSf#|yeSay(&M3}r z`=wb=4D+U+Vs!6g>9}S1a?{1K8qjsVAcXg;c(p}(34<%EBw@=Ts8O( zV0`wWE6tkkCg3rpY2JbiHoBIQ#0#Z_V_eL9?AG)xgwEEwlS5dRBNLbe$MF?7OlP2z zg$i3kf;_*AxzJI3u+H^ch~jb&S0y^2JH1Y%*v<#z!^%AuuiWd~e6yPQ`$Ed)Q>sa% z`1P4Cf|r@jSX8a$Uv!Hj@rE!ev^yR6#Zzvt~4Q0X{(c{4RdaCS~lR_|_?JPco+^h+WN?SJ|fe8n7A8ihaPx z7iyyVS5GN1T+yojuNX^ZHxWXz)IRmA2{A*OugSZwQQV=3^>LjpPDI+Ad8bL#_TSqp zUQyGT@A%&NHOkN_2fpPtcw!KagV{2t=mb3{)!zxQSH(#t|q*Vl;0KYrHkC14^u zyXdeq#m|)H$9Asi^SVY=J*YEw{Z}DWPPfMJ{`b)vEzHb$mQ_TB}1`xX8X`h}b8! z2j3Vgs+)pHY2@Oz5WuSy|E&!j6%LKWUxmE`gh_g;AQC8fB0XDi6^1-Xu}tYC*v$jW z6)NT3m0NHi+Qbh*lo{7_-X4OeX9|@mA$#@|3p?v$w2C)sOBnJtcRUmTa}w^&N@ZW| zy~z9NneA_ISCeP%E*16zEV1!DcSR@~Ed@nB9L(*^DbLNW04mQui$B^kbh;9x@>gz! zUO#!{63m=A`$?TPl5}cw#A8xft;IL*&@+%NXWqdg?L$NKV*CNrK0fg9B4~w{yY_a> zRJPQHoY_Lm*RGZPH(xfrfmat#MBBY@ex4H;B*SaVxYlluaw>Qo@$Wp7J7c}Lj8L)$ z%7r$3kEOPZ)B!RFDXad}!tdWy24kh0$HMyf^5K~_iV`_?3_d|trZM-cL>>;yAI*FjZ+e+y3*~ zc$+YzB~Lc&KBy2CL(5i9lKHlHf|pP);$`i4M&kz;z6Qb}zwiB5F%Y|8=GpFg;h#2I z=r~;WoM(Hsy4ABR*z+=_@dqyl4SVa%UZtGEw1N;7R1PX6c@a_xRqWPH zx~u)l<~;oTmu;x;E2C%y3pas~+ABRvq21Z_=akf5TjmNacIu+U^C81UOrHHQ?Vr>A z&7ZQ@j?dgZQ8O8t)D#=?*653zp{XDPoLttd)lEP@=08ST=N$tyHIDZS>af3nl-HK& z_Q|7o;=H5I-!)@3YV7#4*E0J2Zo5AQZC?DNOng(e#*tPRZMjEb*YnmfquPc0uL{Ob z_g?bsI7<+li-nRNGw$W+uWQkg>U*kxyJFlME45d?t31J8O8rs!MV40bv9lyCXHY%5 ztyV!0P@uk(Pf$}UNe|J#?O@0xA#-uNRF(74qv=G!Huq@BWRt6h+|fH*+?6y&(`N7+ zP5oOnLleLjQFm)c@a26ip*-dEmX&$q*Svc^tMk>G|Iv^xT`hA%^n#{5Xfzv%+w0Xm zf92}SO6Bx5)fIX_@=%_h8+a)~BeF-H`^xH71`rvh$!q5*=$ypEhz#s-)gy#|NP%r8pL{XjE5aP4Y*DB zGRj{(-N+ov7c*yzei-<6wZI2<}1smU3>HFQ_6iMw5ljU zd%-e?)*Y=RFA*~Lawu9+f`dGOh4M4-=VbgM?|9Ea2*;+-uD{~lek<|IkNjnJLd<~a z3yAx(FSycf*H0<8$~Z6F>V=`N%C!e5E&%2AH%$scL(yJd^Tln^p>o4YhwahZ1+{TA z{w&(paq4_uSyX(il4=52_B|d<`Vv7iQc4;QA6z`QjC}TwdMLVwbp2I(^qFe*O6(_u zyfXXzZD=^xJQH}^Z=@VkPid|n%QFrok~;w`&Z;S?H8-Gkki+i$q@CGh1z&;_23?KMg6^7BKWDY-DbxJh$EW;rKk-hV=<&My&sD;A%DpJ z4wN)+CFk8^){uO+qWt&8miFfIoAt zk~{6ud9F zi%|Q&EqiYc*>a_ASN<(aNIL&?yK|8jb0+h~TIG=f#v!KZ@q>$uIoJMbV2g&Y7y@6W zAy5hw%z3{hx%imj1b=v;yfeI98h}>Ho-6#4^$DR{YwUW^ri$mRM4-mR3tI!6@i_p6H+AD^OJY|hS z1DcCaM8toH2MGD_7VlYR;3CvXbiR}fAzx#PIRCn#6i}&YaA+T+@h>Oe+E6E}a?ZDx z6UUZ1^=jh{j?Kc2TgpxGmNR4P_YZFlGmqG7!7k$0TQDWC0G7MVhxWIiV`atLLpPue zhe|euq=cB)pJk_~mY(L-o@K>R60{S>e)a~VmB=M8N-t5-B+OSp!3`*@JU%?-9`x6^ zgVpA3XvPvkNAK~)=4+?XAN&N$r*$!^V4q#=527dtqs?6Uqc4P^cHUbux1g+EgbTU$ z=;t}4tVHe6eX%5NB50-B5O(kQ(C0-%+*e=7FO&^hbk6Aslp$9Hc|HPI(6O`@j--s2 z>=_*(M(FMixdL2d7oi4=X-O0ac?jRiXScr(CnX-&d-=0a_mcTU1hB*u(RuF$uxKx2 zIfjp3d_02(@DD``4yUc%f^u(PyJMdbD4SPvet$+QwWY(hWZR=l9A2H2P@d%VD8Bo- zq2vnLHIf9cNV7DVyNQrDh)Od7$4kVJaN^Grb4yzN2OzcXjHsO+ZbmE7pL9=nfpeU5 z+Vc*_HpVyL=ZaQxzs4wKi*D`dpp~wl?Ac8Ev3&ZZA$5*q2{ZHfco)j5UV}@y3*Al~ z-kt$f`%-fC8>p^2ns_@umY59PpsTMeyb71quhB}}FfMs|Ld@q-l~Qm%q$aYVV;7;k zWk4Luh4Kf@#BXE-?W0G72Ty;oG&ioBlOrbF`(ELNLBqOT7$JvNs##p+4{47!pw2n_ zh>(wrwdV6<>1UEKsiV43?wUfglM+S)x|V2Opp}kWbLUI_S*$m$)sh2PQU@(DNkq_r z7DD93jf=ibyFGRJ!%SE}yJvf}*L1@qpwJ%uz(Qyf9YQl8%oIXiO;`Sd>H~F$UXAZQtOLvT;#b&7kKdzw5z_z z4$0uyR_sS(>~WctgQ25tzgSG@LZiWkg|nlMK@s{tJ(MQI6me^ADD8DH}?1 zf~dl_=(mB<5)va9ef-MGH!t$8FN=BPez8dJE#%PTgu4CWLPWPkE587y05^Y@?tA!c zP)Ro9d=YmL^6(gGzGS;Qj8r{C6(q1DLJ#v@^x&ABONDN#krRr3$WFwh>)N5jO-ko& z&ntb#_p(?1EOaT~C7OYS`${maXBt@Pu<&3qI=K+EX=MKE5Uv9;$HBJMi-gh&{+-2}XoqjW(xv7>xW*l%x zE9B@gY1{2&Z-3+LiWmjQ<2feo{yZ~Q6{{sD9!Qy@X#FURMF$v@gnao(*6q@rA6vnq z<6PymHNH1>gK>N`BmvQz{)EDM*s7?84?Hd`)Opa~H|_VFgy3@EbW01%+^5md z-e|>wABI8?t$VjL#@nsbO!9GzTEx9gwa@*e3ZI59NO)uu z^G2rFo;-T;6W()bqH+9DMa(~QqR~~pd@s={wCg_~ZjLoz&eQgJyLA7~foss<=|`7* zRsH{p@9&2RQcpRrXHp)xB_u`iXKW^~JG7bve-ZgEM{v8F(*XB%{r6scg9@8u!>#$6 zSV3v9Zg5pgKtUuDFFgNw{BpGScgfupEsRr`8R-i_UvT$i*eYc{cDBQjPgcMCK!*P( z+Eh2@ASwa_v`0vFLsnuFmBS|U=<35&Nar@~75=>B5*>Eio#r*pJ*(fH_baT^6_+)c zpx@h?RxI9%O8n1G^0JC`9?2FOmQl4nN@F*L?^j}^Pvqe!jZ3*X@2(|ea#%0))>~2i zea+3%jRo=3(Ip}si@)T56%{`Gl(K7;o>%?PwRd`E1#rrGwi@$PCXn?^`Y>Z=kaRA~ zwgHhF0DDNw$DVgT7~L~bKA;<`npf?~Z>jd-@t8p2{Ng?v{VRt$&A>vwoV=jivSj&= zrP6|e&;9iM()#OCi^S6QdMT}4ooUfs9qxuODHCsCn=f)HhI&4JQ0`Z6J@lt8?kxIR_h zmB8vU337G0X-p?3@n>iKu`yi0w*i_~Rtz8R3bU(t`?#IEXW*BG3 z)W1;hJ1YoSD{^M_W{gC3Z7t+Z9T6}T5{)LXFCgC8BUYD??;eHY11KX_TT5{2q2rh~Zayb{fx9oT5S|N<$|@|9v2HhiAX8%zCU%(UaZ(i#rJwcMP+t&I zxgGK3!!a+U^Wd2Bi3T4;7^I#b@ApPwPf%5V_4adU+#gK+P5hqut*R2xiWOt@}+$c;DlC`!|)eSnCs zf|vKcfqQ$tB!OY(5VUhE<6hYj3Z@8uKh~YuXkBEwYiQM1^ z9_1bwQZ$P|p%J_uWvO{Mqi``viZ>6BjBR2UXbM2H^O6r2Lz6M(@%gP%SMH$iBbpV$ zKHm8IqF(9ht7giPGsKu?x^?uh=^RfK9(k8L*mDt^mb?4uq3KXN- z#HOJ{MY<0MiuGm6knI`zzCD|NqVTrM6;-cKq`Qx{F(tOp0R_ z+~a07-o;x2_cO{2eyo>L@i?dB6W3qa*!C?K6OW2Nwz#26CG9Ul18Tm1U-MtUJ))2O z@6uVqP|Wl1_NS%d@a|d(hE8~Hms&oSVukyU#Mvj*=R3)$;MQyA{fw4~+T9v_e8d#R z_#X)2VpK*d--&8#EAZotb1ik>$Z&sKC7TD0$`TXKDjdpi|MKE@&L|qcjGEQT0>9Yu z{k=;^L41wMQVUwC~q@yB!FKij#8gK0KYJmc5L_w{6gqnl;3dydUY;;!MOdIF%q8K9k2!X zWu#^F(47WDWVWyJh#&Ba(YldxH1G>ir`|{ge#wwBheK*F=Qm zo+!KpeqsG#xL+UmMe%u;pAhg%+>Rnom`3?7!z_+?Fe zgtrp-MRBNU#4dz%f_b8{W!`W8UvFy)v&ZV&3?ZuCvdTunNO&W%et;FH!fl zyl4Y{nb~NP1pHDkl)h*I{6cgt?f*jK7migOW#AXmY>lZPjbBdAg`WX_(TL~kll~vS zJXi?s1Ab|LaLFvB@k@9JDgb^d)q9kn4E$ny<^3*tTi}-muj$_czZCp^y5I`@Lc}y$ zngPEMSpy8WfnVP0@a>cXekopMGN=N6iSe^HpMlQ-m1!_di^eZ3mBw+vFJw9T?r7i_ z;@R#|k)U{34rwH6HlIhQ-8x_6+b#T^@_KGw@57He>l?;1>bD z@HhkD7vnc)xQl^bT=s8!;RXEiTAS%5^Y&;o?k2-<4)}%Wt8~hz@rw&{6*usUTle|& zK;RbxG`nk##xEKX(OWJ3vEmD9t@pq$#IDbL`oJ$XfA7AWpz+J{F2iWxm+7&X@^l)% zR9wD)8bsrlQFM{f(-rYnZoPRQ_$4OklTkVFOSHr{TT9><+iLNfUBEAtQ!!L&;1^!8 zhmy~MUq;fd-24puA{XnfCqm z0e&I1rD{n4zfc19iPZzY2>c#aZUKHFo{tKD>(ltfdW`?ZUpZu362ck5qKaa|rf-h| zzwq|6-}mG_fmEy~4!n$3$I+kaNN2T4@Z2tHzh?{Q0U4*KO@Utuf`m;PX#CRl>ZTL$ z3*j`8Ge_eWLaluY_@(rync-{T7lPIN^%U?6L6JWA3HU{Y-BldL%j42ha>qW=_=Pur z&OQqGg*w0IR}kzfHm+7?<)r43-HSp!~WI`;Fs@da_#KEFWiM^ zQUWZzbuw*-D!l{4Kd5Bwrasu6ky{F1G?(_jSnB_^*&{T1*_>(wct65toLJZ+$X z#xIN(E{;(us8MM56$9Xx#=oX4_d3n-^0x2|`+;AGSL%#zG=51@O8W);Qrh(H6$kJO zaW*1P7x;y8kHgiU#xKg8nm;^%UmVBt;(%WU{#@RKX#B!hE|LrUQg_(@q%rUd5%eKS z5BPBpDX zz%Sai>uNN9DL4^TkU`^@5Bp3TfM2L#Z=KVDUj!=pjFNy~O5Z$MiwAyxfom__t-vq; zq^bOQz%O;%7PJR|U*b6hj~W2KP)=vc&jY^@M#BUHb24iEbYemm_=RC({u}t^>0?1dZQvJTbm1=(jbDD`J)BUvfcumGP15*f zo2JeyLEslfx#%;dz%L=69iE*9e(74=Bfbj!GTTwtq6hqvao3a^s?R?M{K9MD_TeJ%%V?n5u_fStm)5B4jN`yBjsG_7 z+5-IY#KuESz>OX8&KIzntx7Gvfk&Nx1v+@P;xfUURAD@&JCBUC{rz z3-~4QT2-(*@Jqsm?e^)wFMLv63!cC)DOWDqumQgeO!o&bz;nA`EK-XR_@&tRVE7+a zGAeEOwOft9Ohov0;1{-nPtR4dM`TMcPv81J z41KtDrvBS=;Pg6;#jq4I+@m@9A!d&+R zMiQc?Us2{b=8A1zj~m3pInc0F$N{&BKs>B&@T_a)J}Uoz7;$kpJQq>awg_2sfzMgK zZeF+p_vLH~wkZd}_vVWmO(NZrki-X>f>fzeWag03aiTgO8CV)i>}roev&zd~cU8l4 z;>KmQir7$0nBVvyO@A9To>^Gbf2x60CL~>oYlE=L`%T@B{4sdX8Ik*o{#5M1ML8#= z0nZD0U;Ti8J9(I!vcfc{Q-alXLzVQo%kkB&Ji$%$HCThaG*J5RLu|mE^d$O40=~mh zV9do`h~7wY-h1Rxfkb&%28$Ic(ZhAuQ*mlVNPacTp!jwb@=>|&Ih}>t?@3r6?v4mTF~Q!gVNdhHj~Ku1?I}WkBLWHGneGpe;@6iP_SZr&m%c~~ z-M?%s_pY`=&^H}_o@tt9_!^C~*Zi00*JJQ0RnDU4FG?}P(~L6TpAC5Wygyg3L<@ep zUs+=N-5Q+z{l-djxgYv{ndJ@jZX@b=p#DD403%rztq0A!3(4zrn zYss-Vw&nz^B@?u@8HTK&IjUGS-xzl{53 zWANH6w*I0Kf(LYtaIrt}LwvCnIadS{Q0$iO?1g3u`ZjR%MJ8Jmc9l1t*WYk zcKZElb$u=#G2X7bIGBk>wg}8!?ny-gBT2-kjvTD=;>ROKw^TG#c`R;P5zaHeY}R?< zp9S~lJeYouTcS-tGiQ`Lve22v`Ro^eZ`8GgTwK1Ptdj$8G zmhUf~V{<~Q|EwJb80^uC&PbomiWSl*koudRVU3o)9s9lb;ugB{Zd%%x!w^w_bCvdG z_3NOz!UGF8)Xt%`^_Z5^-e!1hhP=Mc0^e_wqnbwP`@;7GFLEE7w}X4Rf8tg|p@$GQ z^_SGWfd{od{5bA`3bLi|Y^|g9^sz^A*6@9ye-EBD$iw|yIla6#^9!hyY~NCD6oN}8 zHVMa)V(`E@1Mdwy(A8K@az!l0+;t; zSZSom?EGRT-r1VeFvA>x7d)bOd9Q;f@HDszR;D5@U8lZIBk;M&hi=E7l;GBPDT&(_ z;h)a_+e1pAHF$2)2{gpVqXki{mL`R<5rI&|215H^`s6r z#+|w$ms5aScbwVuxwi;^52tL(^xjyD8-qJiXDZ9@;O z{jqoP9r>u~H`Tew^Pl*0uZ~I$U#$(Wg{GK+B!2}da?6~(nx&+Zl z7JiHyXh2!oH9l=|Ey&{Bbq>Xx8pO8UnOyPQ6nh&O`?5c)#qrF41<8hw8*$G_a?rn& zJWN&Gkgz>08YRo9Zn*Ry0}1@%JH*Nh_v!;&tj)ifU_L)#1Bx!3%g9}y(W~=<^Z$M$ zN+&nm&t=%daSZlEuDGeM%N0@C=y%T3_GM~F`pbXzg<-;?gDH18raM;CmC;7u~%c zdbEAn4>xjY`?8$;&G|0uOTze(jC9zSRvs18|LqG$kmx?xm+W^(BsgJTMt*vxH_-Ow z>j#4%*cal9x^nyz4P+Y_$`wZ2msK;%AlkkZtSf$peHjgZzEF7*_9f$C^$ps-{QDz2 zHv{|Pr?i>Q0QSYv?P>=D?2B{0v5O4si?qq2dMs^UMp~J8VPEJ;p`ER?ePLgxFNJ*x z6gLWsgnfAY`17Zs_Zzy7c<^TyU^ zd0}5ZGlrXgCjVz&wlAJeq(0b}mEsR|aj-9S|F^Xhd|_V% zEa}AgY5OwF`g1evOKJ3>zAdmXE=B)uUrIH}=QC*g(ye#32li#)r8kQ#>FUzp2D$n<~vQg!HQ$q~eCJW%!- z_GPJmI9po)_Jt(T&9n;p5}fVj%le;v>Frp0u@&~kWAx5VE!Y<`v0q`deUbUjDp?Bq z!q=47!wvhg_A#~l3+#*P;I*LVurG@S(FfyUUsQyn+8@KdNIuQ#SA~61^eWw~2>Y@W zK-V!0`_i%$ex)4th2XC2{ssGDqLVAF4Er*FdUpEE80?GfbuLy`*cZalTB9BIW%31Y z*mKyIx(lkKEMF~AMW;%K3hc|cm}F=->#A})W`Dl?9_GL$OeYyecOP$n@S0S{05za3gfPGPoDqygHefjHu z^K3=c2jvac1^5Q6MUkG9-zVFKaZ(o*t zx!M<|&goNQ#+N*ZXV_*Pa~ z_to$9e{etQN%g7deO%Xh9mjDp)2%oS5`CeGc*x;S^yPEihwlnRUml!#SM-&C=u7^? zFW&$3W%~d0#rVZj@h3!Id^U0wgowUuk5&--pT2B5?{xK_zWls%vV`ahMLUy1{Qsvf zwb<^%L-d8>xW`dGqAwKf@%!%*eW93hI9fpTCD@Gqofgp-3ZsO*4n$uV`R;g36Madh ze)2<;=!BBNZ9B zcQEo2efdwUGJKfm3+FwWS5ib@3VUtkCWyZ9Q9ot~Bl<#>t=ck2^yTf;PP#OrFTuhZ z`87meg4e{kr-{C3JN!QKi0F%H-|z{V|LF_dY@pBq(_-!uhlsueTl!dk2@rh|cye;* z8=^0|Ofu`qL|-bnA0NC=^o3_J_QF}BFWyd9mA^f-#yjxIii7CO^)L4X42iz@ePz70 zh1}yR#za1|6Mdm@J?N)I^yMathzk2ZecAGRwu$J=NL*Q3YkUXdZ^C;H=i^4qwe~)xnCsTpCXvJ z`#h5@=n1ZegTQkc-zf6l@!D&$JlG${s%zA8QvT)1=D+5D6q0wSe0zt!Vsiha z)M@0@-of0Pjr{ht@4jS{`N3lkk(|4M@Eh&a6oc!) z_@3MOAZpUjaQx1?vV1f?V+yU<^&t;ZX1eZ`t9#=0{Q);0)K`PcM1hsFeIUlXx?^j8 zvIr@1`Fro&Cg+rYlScPf^7DWfWJjeZXlmO?C?t4Qqb!}2D?w~K~>URV`J(7y{xtlgVOjJR7dnbLPQ$3l( z3EcTC8%N%MIaQRtHA2d(HpYB;ORNY_Ze&Xi!)Lv5{>{~Y`N%uG`=$ODa(~=IKRlvK z&cRb>1ACQ7{y`#({kdj1nOpSOn!Hm&!Ofop{?LbD=YCu)>O6<_3zN5c^uxgTe5B3M z1@iUT@Od%l?1_T$mkTIO$lPeYdL_;H5>mX?7glGrg$>EAbu%&^pwmvPPcNqrZ?&a^ z)AQuWdE2XhInIXsyri9_k;(4Z;77k0^3)PH4>e5od@{#+>FBYU_rwq3$*J^wiujnM zH(xn&&J8=iHRs%nSI2totXcXX52zQAOpQMm0u7~EZe?So%D2*#R zyyEf2%kG2$sZiYPmAwDt*GLcwv48z;H3J$NsW-o>ih~q&zp+g>G{N|=Uh*?rTWFYW z5mWtcLGmHA5C5=PL9j#6QmJ49=r_cQg%6SY#l`B@Uuk}5W9`;0b0Y(4eqOhHaiNLm zNYgBT&E^Vx8>FIVM*PVXGcimMcOyDU z--FVaV8X3^#VD=(y~W^IA#%-m-5-`DK88o0MpKnBsL8h;CA`#(K1Npg@)ybd_T_q1 zkDw_w1eXi%?ybT*alFCz`?KMrsPfg%W?49Y+vGOI+e|njXc|oAOy-tW=Y(An$$f{* z>#((DBJkOTe&4f5=DJxwKN6l$ zU5yn9fw39F6QyiM-%P@j z!XJ-wR0vNf9)4wtBs`&Lp!#s0@Z@ry*-lo%6W*;imC^}M`s-^b?-QQz%Dg*&=0|u! z;XmwWMtEZ0O=bI!CyNVfr~VS21ncql{Nstp{NOwd;faFT!uD5$CrmesV`cvFgwH-A zknqGN>Mq4@!V?O`%66}RJlQUANR03#=s`QaAUyFBJ;XIlc=9DtL%8lAPb!7Zbr7EX zK5c8QMtI_)`+Hef!4mndykpsaL3nb9GrKzTA5Zp0d>i`5lWS-9y(T>A6!jOIBs>wY zZWH+Mk0*j1^NVklaO~cdV^j=;CwJqy`EQW9-!wbz*gu|Vv7YDn#}g@&+Gpts zJfXBVvG~W6wi_q<{_#XKapODTNdt}UtD%29VPjo9MtH*CB)IUN@I-&&c@51!o-C_X zBom%c$)77p4- z+W6hr6T*}1?cmf+cycEy`ji>rNq-xq=m_Bn1rxpcC&H8Nblyf0!V^CKr_4(KcyfTM zESd1+a>^A>Zo(7ktCN>U2~VV_f3g4L$>r+9r;iezq_`fW|&vi0tNd>-M6agFn7dBT%0rfPaY!V`TBL#kthC!K8O1yzJ66g(jEsrVpy z&s~W=Awzgl*gBg=ctVk#X<`14CsgV*jD#l?2WXV5j4B=wo@noD^C|qtlc62q z4*KdyV_4H&NqA!Xo{!@nPpGo{1J zw>%FNmndlV_!@zdLW(l|h%U)h=%moT7Xym>b-cZ#zks5z(e(b_3#c8&#XZwx2Mwwl zS2|viKAqSPgX%l9K%m8AUr>1@*6^Omp4%CVO4s#%op^f*SQ+c}x2z^Zl~AEa6n7Z$ ziN8~;nQ}ybV~S^*^u|G0@xQr!B*{&PKkhF~!XxeimXmKtuAZyZ(nXTw9bWId7!aoe z>ubG}-8;!SYeMDH1Fv-8)#7WTigW?KislRdy(2yr3VN&kjoF~^^?N`2E#iN1X7b5@ z7fZNOx!HC*dB3Yx$vB;CfH!?R_b!Bye=nP@>~z+DB)50!Ov-9$Jh(X6UI~6i&VfFP zG%2=u;5~j#`N=yEkXBbM`M8*YAFn@s*tVRDT+vZn>~ZPD@7Ln<>I}JW=)CGVHxNbg z_$IIThsftp)40|~`$6#L#TqNFIM}&9p%$u{14`f8Ehxu`FZc?nyJ|^5V_WIzn7({e z5~4_d5=@OppIi@Zl?TfT$Ks*0VLbjiWg-Sw2CZMd zTSVqbM?e_v7~rOl)%)H5vkW}8l*peA%R*_QkLWjUD|5qbV*)aRzAhw78?@h z?`~eV!trZEY+{s?QVo;81O@A@KzqZaBXyTOY?!6{jinlZvDe*m8wV6f4w96Q*E z@%?SBp*RUkY1gFZwirRmUqSD8aw51<6|DB#&kc1IPQ6Z>C3CRnvO_7a$vaV4<`BGp zC;q)gsTR%FP;klc7V6EG0$m}|TlW9*EGMSkwN?`SqSth>y+(YtV|n?9nbbhnT>_U2fgIp<#_gD!j2^9 z{2Ra>Uv?f-b{8$5-b8%tokzz-dCM{OLxzXf6LDm{SGMqVfcV#5Zo2koLI#3=?Cv;U z=OUanyr-e>=MIM!EgPHyqj19`)k)|kegTQsbV=`s&)}PUge#>A(bscDDcV}7 zA4Ok1SxMf14}IJyv$n$u!=a`?UUCmgZuwABW(KQWAG&(XE`e^3x!0y6)}Z9&FjD{J zG||y>l5BHYxN&mF4i7GCT$&Jglr(XP^cS~zzhTxu-BzQMWgO(Z7)*12Vj;s7w6hrh zO78U`eg*k!f>D83VL5-Dg3TG~^*1EmTnz=|>F&4hZ(jkIPrn-Y>&boH=W6~;f-k(f z)%Wb7Y#_-kFg<&BjO5^%+9iJmUB=qUiy?D=LP-Bc%180f;plSBd6&NbC4Bohkmn)k z>B!IQiT1xj-u+}u-^QPR&BwQoZYEv`Oh9j$84K+>D@;nhBID{)OnT~C&WdI=;YY_; z@!zya&#j2Fcg|%QxXJWQAmuJO_k=%IWlBiHl$#Frp@OL}`6Vm7C!iEuYQLr_Fp&Ae zdpg$#0~-x?1bodkNm^u#{evCmdVUtNucK^{*L!deqL0rJ!`}*!8cU zNiIOS|IAfol56OPGoR<n6Yh;3u+cFQ?|+Q{^cJHeN{xBd|v z+92oNL-wtA1vOBAn?u(va_|D^YjHk)U1mXY1NnourHOyQW<@2;UmT5fl@t|+^wGGT zf9J>-6?`Kg62sue5B?v19S#c>La_svKVM!J#m`=)qRrb(fR@SPxrdMt(ByKd;L2q8 z^80Z+>slThJ(=JI)>g1BGMFeFwOWrO`>J*3tI65?V34wNUZ7zzLI!CZ>G4z#TZVQ%Vz3i1P{wWbZqNp)+^=-~Dw;@%Qzn}(*kUqQO-$u` zb4W;kJr9;9T98j`S*qZyjoG|s78%h76Zw~<=!Y#J+$yZlFG3c~duM)BJu*X2tNMrD z=~j3~%J@-bnku|(aiNr~Itd>1?kavVR>-}t`@$_W$LCX$)EY6A@b1oA^SSc#N{@69 zCT_j=ld3!zI(D-uDDLz?(T+oM;Yah)@rU+ow?QCs99YrLZZd$&HZ=X}{b9I&`1{E> zm(?Qtx%HND^Q|;|&b6n#O(z4$8=L!ZZxQVOB=uwawh|l`TRIc!oQ&1$SJoaLih{VF zioMDI6@l5-27xWZ8TkFkMgDoxOQdh6lv($H^h@jKk7+q%z`Vp{a%YVz9Oif?(fv&s za-AhlY>@lFQvSpBqT9vf*So5JMeomm#lHWN|7vA|6!SKoT#am0Di)sE@zeu1Mr695 z{m2KEfOOsoYtol}!E5r0EQ3v5x@Y?s%HX61{r3}sWtjFX zGsU1i7N4;ivjrOzLak}7a*Ff?_?pprZHCNq3w%$QQNJw4A$gHyq3(Qt*utM$B=9j4 zAa{SF-C!VU)cZY);Y+|nIdA5RM*^Vw-m|PzO|m%klWuj3s|5%acgy@KE5~hjb>k=Q z1mjKd3pAJQGjMa}iRzOh1yFk3{mkYYAz&x_;Q7biG~D`Xt4DHZD8zgjkPG9F!MNs3 zm#8N(_)UnW&UL*M56Jp|-S<_@!vV~j?l_wW!rXH|N}gnq{x_E7v*Y$?cvRq(>A4ul zNHtRra??hy$gpiaeX+2e@AZ}^kD`$4z=!tFj;6S!N}EeZ!VLyF-}j_Dv7({HvBw{; zWrDfAM0K>d2h9CpKW0SUWkcvp|L91jfM5CJ4AGzA@T>EFu`Zc^<7csmq@DPvh2yIV zUdJBnBR&*?7%I0w_)M=Jm>=Q~&EXE?LLbVpf|1i?@kQ zmu9{|OEuP}GpQUMibv^!OEUB{F?bk8rbUagAaq_q<)eEJvY%>Q4*3%d&+b1y!Bmz8 z&VOrLm_l1Xc)x&uP;zq#M*VEiF*7MZJQc*TwlftS@|spSVuC^URO2f?b5}UeqsJEh zs043u&+==XPQlatv)1fvHYgMFy+rbl7m5}Nwinx_Ku@Gk>jjE(l;-@!Ik!I&!d0Wz zMfbGh@0CjNFqS-^y?5M0*&_n?x(FuEoGb*+%eh}$c2wbiSJRzCaq_{iX|b*&iNYA{ zea~$>JDvvpelvrsf0N+(a_w|SK`O{*HwO+J&4ay?>E%vN4RG%`{vE3-M;1RWMxW$D zkUhm6R{pLDD0zNK)OSU~WBXa@*1uV>4nL~k4YuB%M+A#+6HGk0Fcw7a4qXzt0QwxzU;!o(uo0&MD z#Y(}=nvU{=Ak@BRtC{9=sh2|?a6)+a$ZZ|{*(_*7piO;Ruhr)G57b$mz8+csIWMB zcRezEGH-Fti3WQ6Z~Ja_=D{R;+~6{EEB@$S|BssF_J@k&8m>Q6w=cf z%-_*bs-FpR9SIMMq!X~4wfvPa($<@qKv~BhI$vl#a&ipcCmdDk|-1l3+ z1L|Uko=a1?La&MaJa=6VnAAbepX%R#6o?;Y2WQ&Mk0KDV%ly8LI~JJUN-7SL{#f4q zR63@?wwNHsHh)&L0YHq-C$p*;)zY+oyI358P^aZgeh2wH=CcnP3&^|jO!MOog%p3Z z|L|(>40{>W?V{AWnO6@q23PmTN0aYkaXOkUo2x*M_CG<3uppdd`(z&z>j`2nGq$xf zori1EJ2Wn~=isJ^J8)ApI*8&H>eX5aJ8b*D&?r*WX4LV<{@VRPKA>GWQeOaYs zj@-wxXGk;=9B#?&6#9__jI67F6Mwgs;ps-L10o60sP%mE)%(r$C~ot0+NGlmq?)Kc z3?0fwf%g_pQr3yEg)-6c;bCv|H@vIASu+LBEM**{uFVF?ZIW>!QY9eq^SYl5qXnpm z&HEXWJRN7rt#ORa#=~2bTRu@2fpuV6%fR3mjzA-p_$%S3E{aN9UIZ2i>& zy?WY=L)EbmAwpeDFByU?!F;2(WVKJOttZ@9(7F`dmAiWgUK%YQ3Z zG2$xwMXL{qQ2czq&53gfK+_(~C0|&Cj;z(Y3Vfqrg)^qDx5EoQw&YM|8l_-FBHLZ| zqI5W)Gx+qBv=x@zes!~dw~%m^S-W?0PbtJ+J^acszYzEAXdAl|6N_$NDvr?PyThnZ zENf(CHpoJh5Xx{2j7K4R0$+J7Eb0I6{V{U1A2_%aJ1}mN~!Euw)r%@wmSfpQ}5m=CjuTLw| zEJPPz>+7tTtS#H{yvD=y-xmt7ihU{5K39nIFBG?=kmx2^b93TI>u z_a*Q)VZ(8Yr{e3yIC^8Y;N_oepp*W_#zXQ#nQszu*l4cd`(_94p9vYLGsiDFI$8wp zerK>;*wF%&Uv^Mz$W`Na{>JnJemR(@`k|WQa2c4am&RP+Z34Q8{BN5M7Nb;g+}UzL zWf1D>xZ3c4A`$pQ#N1{3t3bk1Q##^P6i}wuJy<_cYc;khfQy#j-DX75W#0h z*23qrA;Cys?InLUj9V;dyPAdKXDdnl6q#7`pK^0IAnyzR<>m_HNESlkE#XAr_rW+> zT-~1a(+PAp8Qs&%sD-4AYW3#LSs)XpbuffF3EjAVh0lNaMSOPsCEat^N*E!9iPyrKAeBY0uNu>g}e{yhHpml98j?0r8KO>)iZ=b3*TltNR^ z{}y+DR5>E<%TZIZ2*a&m_UnS<0eHhq;;3kd2HqYI|CG2AOwKv0VX=%6xM}r>Y?>eG zZ=PbxF3{A4fC9(hac6hX7>~cbz1SanyjVY~&R)Swi^pp_jVFpVY|Fwl#Mk_cCVs&?ml694I7;DTY4;HCq} zX+e4S!)`e^Ah>1A4g)24pv$#$MN=QuZ`q`>?B&II6BfybE240P2Mfi=HDM-a`n`02 zvk3lr#zmPD&4)2#tf2W;64W@koNoQnfUab@oZY7nqwrxiiV{aL7-v~dcA?%3`q%PJ zjXn3nO-1=GeHM8Tr;FViJ9-8@wL|Q3ziov#;%@3fPfo*s^B(=&vkK7PspEfL{5S~Y zUt)VwydNZPRY-FmryxG$J;RNv$KjKIM$&1Dno|%mcTk?0TN5?o010b zK0713%Sa1f94tF}9nRy|$7B1{IBlVH|Ne5htV=+bl`*G(&KAEtcMre*#~f!q-bnk9 z=n50IA$&&{F2ifzBhg!#EO6f+W}55P2Drm?lcmx#4=}V#>?yzQ271^1Nc(~lD!(k~ zV3%`1Tg9x${Y7rjQ*C@Uw$=lG;sj&cxVRkg+rWXW;P)1ITvNqTK+pqPl!mzSt6gBM zYTNz`i>`PuOTgapqBFW55zJ;M_i)+6JG*9u-9Yue$*tzYUg+8xp0|_qf0X8jmwt(M zgqljN)8AQL;Wazw%Iae`^p*Lp{@v;_8uhu3lHeY+AJq9E_{I_3npz`&c_=-R-gHuo z&e0WnT~lMTk6MCk>#z~ISi$N&QQ^j0KDcn?Qr!G64^$EFdQSO_^di~HI=Tls!!R@3 zrif=(&{OZ;)gnh9ym0KOXls%qJQ&Cps#J7`13y{z)G>PD!;265+B&`QKYty%2_07$ zvmGr^GIxWf6$`;oS}!zzI52kSWU(LqTd<-gdI`Mg{Gb1K-U-BnbhTe+JK$;v?Tz2{ zuGn{exL+~T7OD$cPfK?>!tOT%ZgV*fC^tSVt3&5O`hTp-{xaLa*oSn@@b{KL%U6@c zt!#*+elg8Wk8RM06E_L&H->5I`TX2dJ5{r%^VO!^MWPf3v3Tkam=Xn|eeM_b2~UbRz#=v8Rsl4Uzlw z>pGoasseK|zuWype>D)9%Yw{S!xCWOz|VpEslgy0dj-!<#pBx8OLxPrP<$IPTg0_5 z0mf6$%gfvegX0~4O|=XIaTt2+msKWX8dmultVQRiLZNYhZ4BuZsmP7rG)9$*2G&#> z%Sx%}dG+%0sBAhIY+l+)Meak_>YDsL^-}T7@vX^w0>iNSR_#Iu>4Vo(l<_-xE((rp zJw|_g)F0aXM_z?=`(W(g%4pL*Hxw>udziE{1Xgd<u(}^1MF^| zU-?=F^%jf?`7Y$#l)Ep(=XNPkRQ2!A zWU$mZe6OPVO+Fw6^*O|kc0VBdzG4I)1eT{k-LceFtsOpSqrrG(QaKhFE54Yt7iM7= z?UiM`;0e_i%rmvtQb4!uzKFutFo?N2pY-RkKH7!(AEh2k#EBuR%?irIM>$Z#)UY!Z zwz(O9N9!EUL#jq8hUMW%47YyYtPqd{WkQFS1?l4;D%Ac8)l4!99=(y`rkRCp>}&Uy z|BHs`&}Shm<;h^Uu0PImBo3(pBj)ekEJoGN@SofhzOco=C6VcA41~t1_9RzkAS3z8 za0aHJi~kPokPMP@sY*^#Dv5&KE9sVWwJ8vP@G9^Xbyo^bSLwI%8~UKNFU9v8WZtR# z#{a;}vGYJ3tJk^B?h=MKb_G!PIe=T*^|NChdr(35!p`RoX>e56vgDu=d8fYBKmOu< z02ZOt>cN~ee7}&hEhxtdxZcHFp|cDJ*Gv6bPh73RqIWjT+CB+QW+(HMwngHtyu4X| zOZEWVc7t+CYx)v~I7A-^3pInHPG@WJrc~k=j+KkQ5eanjdu#OK+~8i$=Qn&b$@s1M zo$P5Xe^e~!FG9Nv{OZcNDEQqG-0M8tKp5HQ_xO3p+<5K3#RK#?4fY>qfsFKwS1-UAnj@>?-a% zV!G^$d-sN=L?#rY+gC=1Ot(_l1OBuZRxiQCi>n)F6pWB00v+GXkeu1U0KOxCeZKhT zSG<6#eJ!JLNif+d2(6q(y2rUP7M@2X-e|Vc8jJZsWHH!Il^RnEefW^ zt@PPh4PhJ>sD;={&~eLXQqY(^mc=PDAGR(79=f7O(;Va-cW2%&r8{0Y9CoNg-@gV# zR*@%LvIeYZjTLm*ns9vAjKqo8v8Xp^wc7Et47hHq%p;GY50 z0xVFDO`ug6?^Edjwp0BE>~+`i(0!Lb-oef28?>5V zA6o)UJLB`k?1SOD$5V?0N78Gmytgi?s0`_M=Z@ZBNrGn%D`^9RwQ%=QdiR-gDLC;| z{%PA%Dfa2s9$}%Y#}7S!J6?xeBzc35rrE)!V7SJoc9&N7Hj0M75#+BfLHj7SB5Cb* zIMVNPvd+E}PFe)_vryFHJ~#J_O}2GdS~t)AN23|;C)BAOm?=fe)ltFOUz@?_8PT2qZzpR~#RUluK@`i<@o#@pf6*U)sxwo-iE7>5qM6rd3 z>&>T0|KHh)6`yyc|7S=7H;0iv;8MC*`gOi=Hc`DbysZGNDE|IYOf<$D#bXIgapc|J zqQ$!XNhMZ=$I@J*ypHDOV`nWM*I->i)vur~3s|uin~^Un0%}*=BT@F3q-3f%_-D z#19-w1#hlm_7q)(LsMNFez=nW=ij;J#l!D~w4K9te2!hlmC4!V9 zjUy%?IT4VQZPe(E-01Iq|G@6`bUu^z)7Waq=qAouY*HDGgj!od1e$Ng|>fP$SwQ8Sa+YQRHduk;a1@!%gMlS1K% zR!Xdyg{zu^;Qb&t*#IpcbDn%ah5zeWBE8*H8NYcRqGhfu+e`PnjX)3-Z|3=?o9psW zsHbC{=kAusD1CU&oPI*cGg&X^OeVmTHC7$PYVh6zBfzY*^SRqZ7vvQ_|87jBA`hmo%|i?y+?%HGIe!K-aX75-422WnZ4u$rInj^HIB-{9_Io0(Z5t& z;@6Lzo(J1no|hY>YaW_qSvV{YTgS+&|Dkw0jVy}wF+G!c_WHTj;&tXCmS{XRX3lv% zf?+Z9x!1>o_OL94Af?U3r_}{-!c^)py$z7*IRI%%I?xfW= z%ZEzLZlzYG-%%5;mOR}FJ#9bx(7DjTn)`A1&w?MHtoiyj=WqroIb*Ctal5=0(2D;a zNKfdctk*n$E4^Y+V8ZTfJO1*?;`N_tzq+3-nJ~%Cvmf;i^4!yWxH2Hp$fpcUROe)A zR_h(bIh6zL?wR=z-W*tl&?kq4{y7~9k+iZ_6hVAMiNyUW^Eyp(R9Ot;tPmg33 zf3iCRCEY)S56D^;J*D|9l~TnpU)xW&CK8$ zAIE%Yd$jk^KKkmuve=hPy8A#qlj3(k>gP~;n{L9rdU783b(OBtZnRNUR&}!O*k@&LC<$u)Y z-#PfkIOAH_${C(FR(#Ey-kwJ@pVBAae|(kq=^bi-gAYdj!rzr| zrr*CU;m}u{s;Vfmwb|_FZ(e(kPVm|D=MI;QA_6u;RR^tu+Ha?ZE49`prK&8z zq4X5|O=jiqaSo+qt_S`)^n8V$lU6Ss36>cChQzVwCGMeGwFIKp+_{b8dCUo;*c(s5 zsj+9!v5CtMy}7BS8&yu10Zxq*XinLk)9ok55&m+P9&vnLKy1=<{MzM4|xo%unN&JBl>E{3h9| zjB4~h;)70_T<1JF`O!zBzI>5&GSQp_5%`z>MU?I?ke)v+F{HnkL#M3dc>A28Fm`vH zN0B#3y9qL1`MLOSSsQ&xmLHYC`*q$bF~IS+ed$E)%}5M%UO>MS^FBf1`cq8FRi^;spo-LShSIaK}r zsrHj>%{A&kE}CCWbkbM`qi1^IRf7Umq1hu6+hp)ZSWQWCpNPonaoBrH`QvrEdscq_ zSJQQ@!2#)S2CIvOZPZ+GN&0k&ZE(&-0yxX-zm){Y0A1T;AV7hCs3;LQTB~$_CL6&hY!8gAMt5 z_s$-IE>HXbxEYtZ{U=YmWTW(7<`Y@M$%NkAq1m*NM90{ic8tPecSGo+f%;iA?@ImG zbgpQYqLRD_1p8-ZF|_B~I|pe?rqA!K@!YrUrx zFLMy=5AIdjTo&H_j1E@z-d^40d@^T-*G^|A#d-7igR-|WZBd6i7aEXYL`q=q50Le_ z1NCCiE-cnR$<)79L&1x>HEvVd^A(*#e+%-XX`Hs>a}4n2OHzgQHsQVgcFAult})*V zszto$1caOP(bnGu0`Au_{yh=U^R8ApZoeQ354b+P8<3u|wqSfp$o6wzxaun4!6hgC z?x=p};D>uw5%U~{iZT(l7ThzewM9Sd+SVa?97u_$vEVY*J(rlyFrzm`vro?7RX4w{ z#m${y)8c1xSlDCNPkpgv?jL)v)XDaXh7m)kH1I3mV=ti_Zpo8;Bw00^as4Y+Vn*Uw z@T`K+`?pZ07)qP~sdKhja*}4AxAWv%YubTI701&|`foEh#B7>yaj_kV>+Lo!I|OGP zF{QlgyW)ADh`F`GgO0lXMw&EL;4K!vw#zk!zA4>Bj@DF6m7Fyie;puS>nm$`vRLs; z2#`5rX*MIX@H0gbTOndcQDAbRr6?G@{Q-bVMttRM-thN_>Gh0S*Z#yGt|8?462e!} zY&9v8^a-nsR#QO&A35StC7-S#+D^Z%HM%dJt9||@1b>KLdvuUd5L|Boz%0Xl0M6hYi1ts~ZF}pRlA-;PKB+C2LV@l4h2*%Do{7t^ zi(6j;1Gl-C;U1@Nb|lE6o|pTIceTFyHHMa#NU)_)bn1e4i|29#X6rWPd(Lyc3SCUq zW4gwO#)*BYYdcDPlu_6!e(kBPb5p-nM2&}eozO{k_N3mPJ6zI?q*vx2t)k6C#)8grMjUIRadWiXbJ9C<@F~5^hTWE7SSvEw) zE_3>W@dS~+sSLob_rb&ccwGn`+P9|F*ZcpZl2X_QT6yuhJkPqqfq1tv{3Y*-&br`< z)RsBu3#qjccpHBte=)AgjnWj+*6}lBHsS325#~KjKEUb6NzW^xC{;#*dUtg}I$fnN zs(c35wAO~YD7(dH1wFoR;Nlaaz8lk{tYn-%m;0JGd~IR-qe-{GD{nHCt+>8&6V7>F z#j1Yq#GfzpbY1O^H_$}?azTWn;%DIOFBNpuvGitbtKRsvR*=nIE!WK5 zsxxpznkZV5Cs34a+^XdKQp0U#OvTwz_$~xn+E(VqSbvq8*K6O?oh^wFr0JVKGq@+4 zCjEsyyQTHJ3BP@c{|$#`IX06Qj}EMZkHfC~dfxQcwy!9`mAihOx? zxnz3N+obj)8Rl?{->mA)+SkCE%?7qtB|0f*y&PY-+Zx`sb&>ABUh?4KiBxzwE(8cxQZdCHgp%s%oq;e$a7=c|v?Hv$b=StLUCwT*4`g6AIgd_%II#VnaTvRGms zij@QmNM_-ul9{$iWp-!6Y8n#hPq^!pgU#x1gV{{IXfTYvmP$-+IxCW`BNo# z)l;?r<_{wgpC(j4d6hj;ZXY=M@JRCFm$_oKf2j11Me=r|jQEXTbFRr*0)D@a7tY7l z`?Kd}%ysV2cmJT*T!zxzgPl2WHn>i+ z37N?)W~{vREynOuRJ#}2Rhz}0KDpAZ?of`Ytq`|AMMXA8uSO;XxwhXvFM}~RC+qUU z0-v;Z!(ps<3rp22DoO}1UcD-Q;H}~t{Xk~N;-dNw(R$!_f3mhoei71$7jY?*?d0Vh zj~ks$?!%{f;s9>+zusN`<-50Jhp|!ao%hYz-=*;vKASeWCV%A2m+|=FYv_f)QMpbv zk4dB#gg=}1=X$Aq-nQ>_4PG{$%W82DT61LI+@5NO?mBV?3SkK)3!=P%*r8RO3!{ms zE1%2lY&li{sSNTv_#A=j? zF~3sR`SG;TI8k~*y?)?PdO?j_EH$H?#YTjGL8XZ+Mo&}|jX1b^&mLA)W|V&}`zC;@ zCRTOQSjwVOD#Vp*uF1ZjzMqd$e)&LuDMM7}8{^VhU{uSrVY#uDDX5|Tb@9voPEMxG z9qRS{`xj3Qp0qV&!ls8(W{!>>CE{;0Izc}_>eez1u-k_kgcI+~^~2hw1-PD9J z4?m0PYruB%v+w7*(4*=r6R4;<^Q{@EXycAdC`bLLUv_`AV-?~997XoMgy%5r+#-U1 z0;-i!7wC;J?6IUCj9ujF#SM<9(dXywTD^>K^U9<&%W@rNbeK(6iE2(&JQqDKe4iM= zkS*hu`T13egQQvXnv7R8x^G~?$q~QLKjDw?cLRjfT$Mvq3SIriz^L1KiknpxU@^td{?Yh*VK&!62Ee( zvQ&Ia@CteA>X9gaZo}A?OQbwG>?E4EIiR_r@ZHq+tLnD=x2nkGg<|iRlJdoon$Vu> z-mQng{`ut)LwoiQyM9S$#1Jmrd`TwA4vDA!aXaVq(-pPJb-J;*UU$uAdR?z)J2g-A z!c+sZv#$HyEphl7_9)XMUEM=(;a0(67V{@Td4$|z^c>1F5_SkzDw-BhY!yn=V{8mK zknHEX zA}kX-wW!gHk!|_?=lLVAGt7ui3G#Qt^Zm!u>RfN>%2jKoGh2(>F0?al{{!yab2*%9 z0QxM4o2d4qJcvYTff}$m01wiZT0o z0?KY#ST5GaoQI0iSw4RO-G1e$@A9&%dPC7PJ5$Mx6*&u~GQukb)$Xcl-?z=DQhyV% z?16Q+><%?%7RI?7O>AL`5o_{Wif|cTM}Xtu!u{!AKgmKbbOZyqL=#GW%b=2(&JS#Q z;9=JPt!`uI7#GH5O{Ndt_Yl~M-XZZa!o_Z`Y4>TY&CHKk+@JzkqU+BNB3_e%dTBRbUag{hnS8yVO# z=_(8z;P98Y1WG&3SVlEB;Gt1%Qkn6KNW2f!CfkNviHJWzBqJCP2*$UBwOkl)*5yb&hvU)~HQMhUh4JH-@Iw3ittZ}3uSn$v|zdhVXn8d9lZMg{BRyy>UQwjNQ+`x9UeCPynV19mT@<#-$2DV1aj77oqa*j^S;Jh zbIl|qm|OY%QRfYJ&2tUo0G#a$o;C8|U$^3ERq0`J*8%6@e|A@k!pq~oIi;l@*Itz= zOuVKl*7NJ7 z_3YR%q+?1~GXD9CYbmhROXj%=M^?v?{50V@l~0QgX}N7pXUr97xwk9BRR<}MsYc=X zlR4_u`HOb~w%VzeU4il{;aKuS?eO}_8Je(eLPn_$1u9wb_}~W-j>LY+TO+`OCl!50 zu_O!5l8}$lxC=Q_?lm!FsX2(7pD@PdbO9>-o&r_0l5=n;AYNWn@2>)e#qSv8Ic!Da zUOl%W>@%RZ8&qX`QI*eOhI>-6y5 z)Ci}iK%4KxC9YDSzKXEWJql#A-mT8HgG340U9fjkdoZKk+%$LwjTIexGWH*S`1xkO zVf*hWn~(t8o#rgo{iL34Gd^U>KNNlT+5_e|zycT|%2ObPtNxYZ6v!Cjz+qvo^v%q+ zOr`;rx`Q6`!_E$BI=6uM>o9W9>i)$;I*g9@C!`j0C&_m(TOi0-2qsuG3K<^?OYj zAKFOsa_+rII!R+7|FH=trki|m*OD<%aB(oDc@RsrFdfcSJ&R8RL`yW@uAkq$gV>4t z4>=gPt(u)cfu!wSl{ck8@Tb78ThG?Rw8zU5vL?T(bS)n4hQyGU59<#f+`y1KKR9%; zAUUQoV{)ETAodj}!iW@7nQ_npOB-qJ?F|LlaPofPnzO}Oym0_Z3t+>vV8*BI zIjs(XvELmDTLb^DUCmDoTUxF&(Xms20x4nhaY|{Uz8&tJ8=*jfSo@46-wx`v`}5Ut zSZYhvCl%%Y&|>H9p%<9ZHQ(i+f6v00tMJOp?C47hn6FirF)on#;2NA9zDtD4(LxkgsBXAQx{4L5ZU`l+RDSu|d#D>>9 zUAFWuAUefFtil z7&%UP-s%|}Ud&FUdx#D%X14#gLIkF>OifZ!C&Km5O& zX}RNe>sKsks2q54_frBQdAn%hK9<_g=D+X&OZAej#y^R~Nx6PNC57RFX5{{5o<$oI z-gW_t^yqDqcXC7Q7*hF?j+-706@@bzVcmUxzbDJ?s~iPdFo-&oCBj!6-yw?#@KFC7 zFBPyPljC){)fn7R>x&iz28_$>#(LW!1-fR!9{Y`e@NW^a&->V#^dI_2Qly@NTHWJqc4B0=@pg#8sjx(AUlLueAtp zMIjzl2|BbxomZF>7fiAc8&bvtBRv`(_Ex0{i>&VrN>ZRArd#}#wcF>fDkvku@YGPC-S+r~>O46XKP|IDS)_h?@?IeqO;EJ59nnpIj|8GOraAF*u68sl0gO(k zRMDsN7#AOiM;bTMAcqFU@rLeKv%pIHC@GKSk;zL-AKUICQz~7m zp79|$SGSTT@6&``%5JCqqd>=EBTwJAk-iHlg*@1VWKLK$+7jV{yK8_MmK3<=dp017 zJOrChQ>Me$kVSq}@*)lP59tQgXeiA(7kDxS!plOxgmTa?0fL`dI9x*N>&lFYanb~D zV!5@AX~Lz50R|-`rXOi0O56wK*cf$E<3G7(?D43|Q6x>s;JJ+o*+01|xuK<#Ide z4b9?F0~R3t?#yuHYp42}(5A;P3+q%X4(x*EE4T0L+xqP~>`WW6uoNuMt(NF(9i((U z9>FhBxCx@sTGLr{TAnMxXfuKrfvYNAk0s~drqye9P@h;xO0l(5M{1%aPnpqk77bGw zvv3X$%fD)2xGdM2=1LB9&0H{>k{A-Fi-H4Gk#_3$nM^yoQ%g-jJr3icSn~2oh{4DI zV3Jtt6bU+5ti#%N2ZWZ(xffGk*G4j&VEDt(PCa@jV${rn-~I}Y-m_yQeMfWGFCcLx z3TeImwA}PBmCmdbNF8`90D=y^9opxPeND?9Y(J<6yT|vD_ob5*s0aU}EH1D-`!4ch zZ_-fMlU&tmhJc|d^YrkqNrgp-NuN6(As@r78i9})`m z__?-=;v9JFH@Hf&FwBMYbhYX_Emy?2e40vxKMl-2Y9zo9uI5@{+Nc)pJbzWr;N^qr za*m~tDdR7k*R5%&T3%+Q5Mat#Q~y`(OaVd5Fx{QspS-3=4hrOvFDg(Vj}w9Vfm{N7&s=1_KOEQC zyRo#$hA#|M^9?0DY4|QatB;ZLNJ%Idk|x0SjkGv&;=u!VBO5U ztvg5#gUP@sc_i+dgWl*R8j28oDOj2UJvYgB;gE>vy&5`Mj3pW3ijylkNM4VrEzM`q zmr9W1yW+?}06zTFflNd&xH}2UBK^f?K3IHUZKEQ`z6RKUE57~m%{~)a-k~7Xi3yGU zhjXuIL2tiO9)HIVbGhA)7!tyeTBW_UtBmyUz(!eRvMlHYmmGw!!T?Y5-k=$tVSHyeN@3VOMDIXjX*{x6Gh+#NOKmqZH5u>ABQ69~U={9LG5oN}>P^+Goy`%|0 z_bz1cpye8OcVXPaaXl|jG8`DtY4^@%dWPX9x;n>O>F}2TL(SHG0k9LzkMU^HP&&pb z-LGmBe(BBym7*w+=8pS!Cc*T?ud9i1qSJ;qwsyc|+idIp$c>R)$F6v|(1fS{D;Q_P zl>DSrVEt&QJvscrECD{>GiqT(%blLMn*id#=B|-lF7)>L5|j+~&_558F*{IcmHZP6D z0sehhEfAP|>%IuIQ-96>vFgH-KIn3&CSXZRPcZG;8LzikSVM*qq@=&iWlpXpWYWE1 zU6OoT7X=EFxN$g5gb&Uf2h86_>JL3x9#W>|GGqBR z^(c^Dhodn&EHz4-*TVj;yd>tg@XRsD)+n|oja#aj4_}yWYyOQ8>gjd_I!1L|FZwHq z&BS0yiT0L74h!EU(dkmh?sx0OR8c&**f`eT{`GUisZWG~?G!8-rpGths0JXRVi*kN8I6(0RUj6iCiOI*^Ga(Rx-&pGe5tgBO_`kli^?PZLBJyjuyOKyr`&qSOg+mHjAAQag1X?Wdx#30^%yI#y%Hr#*SU z<*2$rG#8p;-NTZ&rVcoK!1e)HmOlgY=qlgAiegI~?ZfXyDVi|TaiLtP-N9S2AVpw1 zfdVZ#!BMX}!hh|zlO8f2W4M{oaJ0(G10LkyclvEjVPx{(6Er%5h_DkEZ!$z0Y^!HA zNzqX2QkA@8hb?iJ_SY0+32=|~-WO*ham#3%9I&$W@J!usI)@fBtt-m{3E`AY@O4fM z>G#Hmfn5sJq^|ja4iSMmT>A!O#^SPGdL;;gU|phVyPgp&=~)+fn(`{|4>&w%2mkEi zhmV{f3K-c|x66wl_rOT0ZcO+~HJ^iyLDgVod`~Wk0^z>OJZg0vM*0}CB#2CwSqmaXp?6kHL16#5>S8Pr@px;a>L*AsH9uA>6cFSY&9| z4GKiUMXwTqr8X>@C|9&oKWtCDdP{*G`*^5IftWu~45WlR`lAn?A~{kTJLIjVWBoU( ze>~cR2m+Cu??JX^c2ZUavbEPAGdUkekuM0Xh}ySP`_=c;{m+5W?#)AU=;D5gP)J>I zJ4tOS^l>U5OlQ?-NneA8O62^Mw?KiiZ&lTUU1w?H4(weFIo0sTvK%wop%8uBDiRXb z-BhJ}4w>AmFs8(XF7)(vF`~nibk2M>rNaQRi^X3L)M+T=#lJVX@L~(!zTew~H0}GF zWl$hOrPk9rM0hzW#rJF*N!d;!L<-}QKlDQ762^tQHFui=T`A$a$PezMl6^7x0kqkA zdU}KbM%vUqMe9=_Te=SX7b%d82S!Sd35Yr}cOF2Guc>@J&%=nnG|*5t#;`vLBsbA_ z9~0qsg;kmjk%J`#p3z)rv7n^M;ma@`w?R)l2d8O8?QHF0o?87oTCOtSc%r`bSRW2cr0FOeu)BIwyEEe!jMWIKNy44 zgeTvi=;Udr9|@&FHWUb5J0su_^Z&V$6@R|cPAB$-d( zxt~QC*(mh3+iM1V4IF9a%848_>f+Tf2N%>>_cMe5?}$w?0PMnWuQ2LcF|&woWmpJ= zfaqeDF$1C2;%}0JH38w3$P~kW3ln@a6zcC5XEX&O+`g%qO@W+@xV6WD6wi6h=P?CR z`NuO2lp6h^E+GXhc=#c{@Yfs#iV|fhYo|aNF{&14X@WfsMPfY^$W^ocEbwQdd#v=9 zDGzt;XnNX{{zOgbd4@Q=HIE&%~-6jP|I?bM>Uv*sa@xS^*DN^Vg&Z$9NYS9)|| zm9H^H6sf`67Wq<8{5%^wzM_qhsUTmrf}U&Cprn>l)NGi}s{=>v+wIgDiK zslqD`wAOBfr=>6qDA|c{7;~rPelH9Q_ zk0u<8JEfDt#5xT*xJn{Z42-5~K?w4otQ+wgLmO@Vhaow=x`Mw+69#l-;$jsk5OA{f1e8vSKG@Zk$Kr^ussURjv{*f< zi*$=7tRY?~0BV&uClf9O0>UHZ=1d_C^-*q40EQ*m_#5o zl_(K=5*3gs%QZb*5Sp-f(kK@wtcCSyA;1K$b9CH?w2?k!wwzo9^*@J?rK#L!&~t7} z0k0Wg-TBRiabe_hbx3;=Cj4AzVDz>a(%^A-`n$789OP44jWGqH4r7{ug0kK3l#TNu zNPSocra_#5kd0sJ1Qof9cho}#{8_w%>K(4T^!Q6WO5Gvcu#!1p zH|$kpa-d{wBiOF}x19NPX}O6(`*NUZ(XD630jRW5pVV#nO}0^U|0oCW(^;bV=QZYW^_hAs-R|e<3C#Ngk3g|v%m4T&o6o+W)XHUOxZI>P?F91Fn10Q z_qkT|kr$>ztuCs$j2!&55Y}f;fJcas{$)hs8U-8bjX5wn%iT%9V+yni<+|4rLv93o zj|U@*+hxCbljZ9KL7zr-CKDt+0>(duzhX(RT?WP2h;SI!2j1y0a_ZZj%$Go5`n0T1 z%i>jJ3cSCTc9(`~tX6v7nX|z>M6XtmX8QDiYvuFf|$BM-EPN zS3qkh5Eyfz8zT|HGIFG#FYlO*~8gk z-44z8UzW7oe7!25;06JHcC)$S?rdok_bSo+2?dJ3sJ`IbPIbHpR2d_22jsbZO$tOi z7InR|gA~Yo#2ds4BUJ@gmNFxg>&ZS(&mcLcZ1Zv8n>MJ3@q$g;OebmeA`&-Mp!Z~f z0ud~k1Hi`TI3mbq3g#)v?1#dCXk%2F#Vzk!A3gwPq0c0?|J(kpmQ@B~+A1dS^IdJ! zH?LdLdce#$5*zvhLOsR#=zcAlpwSn(W>A%`+&fPm08t_KQeHd(k&%$eQ3^^ii~G0r zHlgBIf9QhpTdv%u=jT|Q6t9%K5EyzeOn@;nQolv#uv3;MTs8MJEt&$gk<&zO5dcK) zRXN@_SZejqv@cgU?$Hk|0C5&ZdNPGs29sK0QGKh70vY+~)};vQTHymiAoDy!SBsMc zH3~Iok zfk_}9N@q;)JY~mgjSc0sbl5+vZhn3c+>j%1m$Vs%<7)|4m%RidjW@O3 zyM#gy?&s*7#l&iD_f{FvP+SM|ykJyV^U_@dSKme=qe-rfmw|fRE+o}XO z%FIo=?$OGHeRMC%5=$+jpbQ8~wW7z|JHNE@lVyu`bzZv4WSo!$)< zED6cgDtx+}R59Duy5jN5IKDFc~-O4;!b5 z@ZO|;KXxK~YfofYeac|Eyj4x@Wi1?m`pP=sth&@)7*bO!9Qo!?KH0PR<6HQOFao>Ci5}<0H|n z5zffMHELGR>lr+^W!%xvQd0hb$hN(b$Ih%&qe;n=pJji~9)Sdbog_Ps49iIbFuT54 zidi{VfF36n;dIelrrel4;gM_8&75WmnH(SmF7-W__D1veE%HEpbuKm2gG z+2Z}+U7%BUcbxm34?y{^sxsE|(fTFHTV8k0*C%@fu8K-M6b!96egYadg!MO#cpi;E zlEkMh>--{+J6FMpU+ISr6N37I!4~CvXP4x!r?gYoa6Yh)jA*#-!iItZO>h+fd!-X~ z$gk8yo=b|wZSu_t^+uC})`j#uL07}{AfmWcX$btDH?4Q*$5mO7{i1noZk zE(q&3Tru+Rwp1zD)}k%y({d?O(=js?C~M^*dJ0Q@BQE7DxHx~M_FU_`%QO^G3z+>$ zgg0F-Y&8d=z?^*`i4~1CANWC$yPq=d=sl?{gef_s!Y5T|s5B;PkKT6b^yvu(B&i0a z_ZPdSC=g)Vv%G782=}oSMxKqr5kKiYg`PvhlO^y~moTw%PG15+tX$Nk8^Q#>qaNIT zmw;GOd8NWv`S4PgemyCc2=||o9E$EBspaLoHVnt*7o@c0gDA(R+x;dNMn^*l9s;7e zc<=U}vG5khM2kRm0VGFXRa(m^1;Xy`83lm0(c%(MBx{WS`OR{J9MJT>^&@d)A%=Y6 zVJ)jbH2HZ|$&~pSe2w_;Q!!TLpz6eJ4G^uy@yVt5&;(bO-8__t@E6=BYWAQ_TF03} z!cwO>eq6oCf!{XkkjGralxQmBow$!LysE9OVDf2kO#9lpWls}KVYgm?O@#9Rxe4z0 z4(bPY+^@6Q`eRv2yliE@KsF$oM|GtE4iH{ zTZ<_u2q%B_jw^i+hQ$@G{_}MB?HL+E-aHfPz0(>(1$D@}+NH7ncGBG=DSRL3`>Z0j zI@xHs4^tQUpfnVuv|$MVV~6uZY~m^fI-ILyPidp7z54dXJ|SKV`;FmpGy%SHm!r`> z1~)NDgO6~)Vjnj>^aAx(y&D>dvk0|oPmy1U2&5;c@Hn_cw0Dc?;>hH8)zM_LIg4)< zC;jM4+d6Nw#5!i}!Gh|7`+UTV7t7aHdI)xyR+EDT7Q7Z9Kz^q#zM@^GR0&xIgYfG! zYmr!7(A~KnepWPm`OEjqpj#3>0JLNi5SJItnAJgV;wh_n5FK9r&)7Pe1uy^QAEgph zC1Nsy*BFq4!&3u3S`&;(VmDYNwi_!E!I2IxrgIYiynN6h#d$LgYtQ_2-=$&{-vm+U(=sW2wpkv_1E>(3_LY zxT@nYau!ah+%^U$1*^%HKa1YBnoj_5w~&KYq~Ri0nxOR$5#Cq=;--mwd~FAHWenUOdF z-II^}G?d%yKWQ5f=>y;VwXsxRbN+tjc2c^F&H3#Z+=UvWhjQRF0ZG+Yi5{loL{61( zq6x#o51WiZA%wJM652+smMH4eZKqamo30nqa#eR*1+T-p$B!4IKoL#A#o-e#a?or~ zrvwy*?$>Y6f`U7ct;%c;(*1=)p-~V^4*Sh4{GmY38DI=d+DYSgEc~b)q?W+E-=`u6 zL8Cf8*NO=Uu6|{-F<32+4X1I;cw@Na(EvC))Yb6mrZY{jF*YVS3mmfGuq}s?_CQ2*{wwGQz0OBoVqz0JE)f%gDpfrF;_A<)F>9m zH}2H7%7)&?%w9TtL=#L(VvCJ8ae8EZBSljQ^sF+)G~W>sYpT8VzdNW)y~0u!QMgpV z%`iDB3b#3NafCt-lYC&YKdnm3)uEcI>w)q)hP!Y79Nt)_;f60r3@VmD;H3 z?v39Qqy|%LHl|lMzz7l%`|NFLmaz|11yG>7 z-BI0OOzunwsrw7VufEfaSOQhwh+3tQv+bnm23`d~5bSS0YgJ%{m$}KwEdEx&+!$f; zj1>>}ct-JJIna2ra4CojomRGmZ&E?(*FN$4eFZsKhsk&^OcS(n2k4WLG~w_BQ+W{B z^_UJ!X%P|1DpfaDZe^ztiPOLi0iO7xF2pPvXT%m)wH$%V-z?<;S#%6E@%a}D)SH1p*XktJ#~aK5%9v8zLGGGWU2lOHh{5o;Xb&Y9mD* z-A?n2#`T0|2B$G&O7@@Rv2{{gIGWrrXYnsLv#orAnxuahlYYa*+*3)(tr3%FyEQ(bFkPf7e`Rh z{ayX&T4*?K+41?lEgKrX--_VQ04Fonq903PBsK2-D*Du zSV@8S9t$^8f10s|`G5jZ3i?&8M$28Wmr;nJKl{riz!e>s$miIu-#?+N<3dHUCzwi@aylKF?fOsx^&F~M}7(ETOFu#y#M1ejS zQA$CApF#z{mE;G?Oowy<@4!)ns%6O=-9-2_Y}Y*##K+2(ck&qV4x=8~2v9v#e((Gf zoPwx2E$UQ3awO?Jc9B6Q2W81eDj^41KSlY+w9+?LR1O$)kkI(<3=&IwQc%QI{fPjF2gi_K-cZbp;ASDgb0wNO9+)9^lG)R8w z76IuvrMtU3q&eb_JC5J}{<+WH?%wXa&pb1``_8;G;CY@*(}*zu!DGnEs*ZIq=WGB- z2_ur-s}Qu=asl6=XMP#;A#xID;x_#dIjAsPPu4RT4R;wLFV9g$`|sWn6kv2a?L~tQ zsEuOoVh1n)f><^F9WqvP_wEe`INK){EoS@YW_W=#d-O~u^Ckc~3&w{6{e||y=!3@D zfz7c)pxW&`@PZEuk#*{}5e(i?m9?_yz=Qzu(W$hW$7@^U{C9WH!1q|PBm^fSCv4Yl zMeIxhPbtN@5e#>JDYnQ*WQD04XLFrN3;`+y-~-sUsn&oD_;61nvxy+;=rhBs$X@qn z5^LcIEv~F^TgG2)dz`CafQcO=mSs0P=3Qcr9s|nS*G-WdhGn?#T%e?KA_Or@b`vxk$O6faIGK^ zAYAgT@Ceno(&7Q5?R4Q-nsH|m?~h+V$2#{s)p&V&z$avPdQ3HgEPLlaUuVLAv19Ww z;L@9Dh+Mb^3jmWQ#mQfM1gDmHh3rG;y7p+LUi}`Tk&RG*4SRyroi0$|14BGYTWf@t z;JkuSfZ)5(Qvorlvi-+v%2!f8jy`q>yW<=I{+4$*qFuR0ui4gKP>F?iv`I+kQwgfm*yb&)NeszV}|L=FWT#L*QDb`uR9?SfAWg?9fqWF7LwRal8+OPG~@ z?SM004M)T%Gep+E{*_kCt{dCQ%d1w<#BrZCg72EP5}$>A!N|2eXAa;MJ~nU?U%7^r zn{@i?AavHnw6+kQ&(j0u9`60q0yFo*zk@xWPHSM@H!%@Qkw!@(DaOOvFRL-$eq;D@ zO4b^`^=`o2Dzca~rk=fF2etd3VPnlR#>)-ozGNHv=(hpX9T7fcY4;=@5h|8h>|ko4 zcNhHZ5h6?1D>ZBC|MR~g6HZ`u=YY8qjycFAIUnAD(9?|;xePF+M33C-4E7j7KdYP+ z0Zs?IYvG)OUd%rg`VYL<4tzHmEn<^PoI6@Yx*@V&wlWx~tosjs4XE2+&1Sx9W%=yX zb%Vg8piu)~$b~DT{XqRo8b9yG&m~{bGN8uFoiaBb0Zy;2Nb=6@gGEU?R3fkaxUj%r zVWq*rlQjj`ZOn+l+egi=qofc-R+1@ZYV6zChKV}BN|fudA$A(#0S2Axop`}e=rR(% z4`mA&yN+o6bg;J3K74y*AWK+t7Ytm z)4;OJBgWKFP4>0~Yc?WnTefYO(_TyCL!}?`y0$CqC~}u}T-%S=QZG_6$hQyq{`p!9 zxU)E9hqh&fvLTW1xjzEfID%iejlX~|M_WKwqUaPg1CnK;rS+9k!tX(_xn=Mg(@b^%Dd-t)#=Gh(;D5%tTSmZ?(t%L=mL`Xbzi2v6UKU(hMB;& z!47l8OZzj7MgK5(JMGH`Rxs9a64o69cDn~&<6ju|JwEU$%U4?e^d2+zq%NL`G==9? zA`2(ySM5B-yhM(L8=hyJgYoqow$3%h`L&9_2V{6=SsW*#ufqzN)PI~F%HCmo0D9<} z<(_~|)(?rBz@LY{=6kXVI{ia^#zZ<=UzehlEBnY=a;xdac!>3 z+Eeu}#we#cLQQU85a04qLOEt)>hBY0_$Pc;5mWm1Pp!QDG z(&1m`o$hR({)-cW#tFN}!g?07|LF8gXl`=u@_CZVD|+ zjSaU*%*tp2epEE&?RfNlKQus8y*a9b;l(i~k>EOA(BPCpn!5PsP;3{FRkPDpjHC$# z`&+=n{CzBeQ>h`?*8J(=Jl&E;3Oi}5EOP!}kU4Ti2a|lq^Qh)G>~h&9uJg!uO_vzu z@Zs}=pI1`pA)0UL2!$>Q-Iiku>&|h)#FtE0Ool2Ru#XO}0UwmNzv-nKkL~)1+|^tTu)=vVKp}0 z1Pz*Dd+b#aF6Ym$c-}`U%m|8h2q_)q+&PH~5R$Ss>8%Esk?5c+8C5)lx`zz`PfNg? znM}FCZab@1*(RYUFLg_larS{BLdX;QmMfW?{!mxmW^fQE8a4dum-LtO@D)*hOI-_I zR2z8{25tBcv^+<2Nn0o`?6?m+< zTz=Cvw&O-ge4ZH}dZn_Q5Yld=G0G&D&E2z;$4=^&5g?@ERi}41N1T%b_YnPrbIrXF@9%OE`wacBW#1QV{&i)Sq zUTYUyO1QcNrE_Ye$z`@YzbtH>!N4h5y5Yf8GBrVP7^kPA6VbkEL#PAoE6Hr!j%v8ZP{sy;ATEEL2KYWCk`@Q|RR>8E6EJ2!m(v zaxDCnzRiZ4yqHCtf`OH1e4S9@cFeW$(4*OgtT*GeDa z+AhoU99jhqw_cYusq+V{B|tkwOusbRJ&C*WP(0fF^PJJyi|N{T>b*b=b$9J>n{8=o zw0OyC#5|E*0p`-xZ{iNgu^Q&&R}R6gsk|OmpQw7x789~aObY|Pz2LExba$#=hupWP zDYobepkBY<#`GDK)*Q)h^N<1A~Y3p|1K%km8>;Bb{9JFyzF$=$nvR&lI ze%xLb34@>@Y3mvww$)eZ*_}%C^*M#6f?0iYphQF>>C$TB-hca$?$vrOsj*qQ8j}cD ziai{w_b8{H+wPCUi+ZdQ3c|P^{!Kl{I~xeuMKq?ml7@B;<+{5|^S6nv?sw(<_wFn+ zy z!G$a|yQOxl+YOjs%iEQm&)ibDh1}4_{ac!TJzb~4qie>&& z>ltUZv+`-xE?-BTEX|OhCdTL3x$i|*`=XHF&rKmswMNTmi{8rMF0v@^@?S%ZTpI0- zDb}+zP->;}$8{0IsR$T$yQ+Fc#S4!<>m*h=lKEqWqtmXGlDesc`J?gt;I!sa3*W|- z1m7?YQJ{T!R=@cvT|M&L^KCrTh;nI+(|M;raj2vRRiX7#)CS%*n!(+D{E_&KQsR44 zJpsVmieyYxtNm+v@R1hvX=sO{!%~AzPt;Av)i`JBB9^Si0 zFS|2Z6wNA_p1S!D#tZ|JOz+hzcVe!%tmtV^%7J$ogtyCd5`F#>(xabm&)s+?QZ#Vc zXx80&DxG5~`L!=9p7f-B%XyaN+Kk=7%pW}|D5&s+qAc1Q=RH3|F|YTqX-Mzj-jgt% zU)X`vDKBE{ab*%J?urGn&!UWH?v(hol}p40Mry`&Gk5d};Pb*7>i_&6@2a-b8Jm#e z-u?v)0z9NfQcWy|3c)ougV%W)jy)%tTM7QgWuqKUU$n>Q?l*i?F*9x;B#T-$Zd zD|~D+hmZAuAL){@(ro`5XeIAijT~HM#vqW*^3#IV3{4e&gC<`EIPT zuR`-UmB7yAjFae&W`?uz-1OjUqx8sFzL6VpSg3XJjcd8$j*#TL&Y#gZ6o0*SZ2DVP zYeKI2%Y+8uY3_7Rk5LQv8xE}21rsF01xo9B_#%#f-6GpJ&QvSyB;%axhDy0CTy9-OB1{XuDL(LEnm!jB-t{G(jM$J$f^nRbv6$%54MgDWie+5R zU+W>rTQHHI%46*_aCY=w++O6A{&+Pv+-R?oXqg?0>R6^Jp28wjoJxB0%Aj^a2F+Nj z{UYvgaF}<@xF)^GPE>o_P?&NDlH3RQ2Bi-z1@8G0b{+*SG*21Re6RrTawHOe-`}JM zCkcJxWBVTXHQ0A^&j9|Sx4rM?lT#J`a1!55B05N$ZjJw^=x3}ou-8xbPt`~#!$6sR zTzFm`YG06K9akg4yV2~8Lqo}07C#YU``jc=(Vtu2q6#fPfejsT)~mYRh;0UtCZcj) zh~R2ZdNZzLTv}9s&DToG&5K)lIhe9<4(!;i8Ljn&QD9AY6~Giq@p z-uxFr==GBz>W#vdK1`+!c-cmc1P7Uimme*fkAG*+6FDCjn8Y?>*L;gJQQ4M9c$qSYuW-Utn7TR!`X zu07`&g#fEoCFRRZcEoaM5qoXJA8Gs>Slt&!N_EjPuQrchUtOzn;7<<`;Y6@-ueb9$ zc{{c9JVQjuxlpy2&@Im}7ubc{MPkWuN_~pf5Dm|H^ED-tgz|6!rBu5{T37m4s%4Yr z?3c~BYl#QAES796L*%qe&RnR_;F{I?r+jzOhcboqB+Nd%@i6KSJ6Ddm`pnMEZt?M1z{aV0{%l$~*WwoPJAG==tDULE z=}RHL8uDH3T_#JZrEQixsyK0}`FO81+)fME?3a$|@k|R80V;=jKA{w=?c!?Er!q_n z5Hh50*DJ&}1aVBWGed6VbCgWil*U(lR9cL2SpGLH*d;ncs7296h7wYgOIvw{3aRx# z{ebEds+Tn^2a(QH?oT!TS=|4|jxWg2pHVrLk84S0om*Di~f`0vsMT{(S=D3vK4CqUPE7Dq_Q;1VvnRdcEYBY{N zeaJEM3Sd{>jao}w`~JZv>)p=h2679BO8D`HS30{^SVO*7sD?%FZ|?BpgWH{p_x#!{ zN2B`>`m8aB&Rt%ri28n?dt2vqqN*P}t6Ww&;xo-l&OjIXF=sk*gutg^(D0453?)G> z&RdLCaFgyPHp$v8^L3ZoYI|D9gzC0M44PAfJGFhVb8Fs0dfvaj%E6pv_tLD@%c=WW zofnbW0%io~&d&p)S;GG~2FW7=_`ZA&HCvUu@^`@9HTuWn^Jl2DvbqCc|0x+P5r|v8 z+eq7O4LHlOWZ5filF0iGg`HQBdZz*Jf<~}d?Asd8?lQ?Eh59ZNoQ(vc1Mfb*Z**q8 zh+ha_yyRt`%Gl{BxSg9A{vKsaK=$w%Ds4t~2T9cZs%Z)AC-mHp!RAYseA}Zv?yD3U zvE>kQdlnacSvNdDoa+^;={ITLqU%$)C4jIs9ncb5$?~MDBheOW@+u?fYmb>2$ubF5 zN=sgoa2W)roS&bPON4HQn%p`Dmc$#SUX;m|482=E^Vu>#Qhzpts1?qDw%& z4{EB(&lQ#9QNd3Q$qWn}W4=~C59)F1QT^_avmOP1nwFc<=FLxA1JSe)Aj=G2ph~N6 z2U>8Dejx*u2Q7c5xYX?k9@e?}`+iExD50?@$~i7Ke~9#zpC22lb;Vi9{jlOYp8FlYL~n3B_i+L$;jU25 z?ebprhMi#s%ENf4mh=;Kf2h5yYkjj_MsNL?u}hM_jU3P6?(alWfDjt)PKBwZaUF1MN_X*04gkgoQGN8}_vTKqWv8 zaDQn{yOJB~M-h+N9u6b>@o--|L$MKhAP-DFwLphnvd0#W7^(pmkc%7}P%hL*qqjHg z9VHHEZD3Opk$$4>u1B1NVF7ac*(Y;<75PF6<*b_f0MuNrs=?Hq+Uv1A(S7aBqa_|`aoRmaNx9vzBKwc;}P)k_Lco)?)a`AF9_X`dK%RXj%x4AWTJU3EqS2PI| zdRWBm{N|RN0mpkX7i_V>U5p}6D(Ncn1ZoW|Xl|1 zZ-CBz?NY>CZm4b6H;iJWHUW<+kPr9#_xO_CrgOCJ=<{T5(;V0M-N0Y0$=t^RLK&Cr zW+_`gS3H4yekND?%m3rr3ce zO8xlgKs!~gAKbv)NdxL#kMErIPVK1UjI~e>Ik^Hq2X2#Uxs*Ktcb`*F5K=Fhdypft z5G)kz4&Qr^=`ReUSk{|)$*xrdoOY@L)~NMAkbUj>3AuIL>P;HyB|CS+;SB+ZPnC}^ z#ck5!g^ULj#DeNR$rE5|+?QI(-A=s%O+k6(yNT*8dC+(b_;p>mbMCQpd2+~CZzYh`azD)f11)FbAVLk8tlE}K zxMT-787=^jqgtFRxvEt(EO+=~sJGoO546#|DRBj;q;#b0c&?{$`Lt33M)6opljA`9 zHs2jYDaW2?C0Cdws}MyFmf|_)u{4oxdWs% z2Pzl9Y*Tg6)x=-22j|!JjORX~I}ic|E=~FE#(JQwOf32$9@G6X{}P7TF8rszudU4c z^YY~#K0AA9@QF60ffsZI5kiLtm~P4LBTHbDLs#WCi9GO4q1=Y8cUU|ol$^c^)N_0dSK*f7Z)PN2HEEfz@i^eaLAKFA(!kj zd%u`2*{zd1^Ff`XhFLv^brzG(6|-&UpTS$oFVVoE{COt*@gJ=dGO z{(ISz)cmc^G0;|}lKcS$$x%(gU-(Bk`fU&S(@@UvH8j|Ux#Qvq>5RuT>*PH3HM@m- znJLrhh%{8ur&|#8Z*(E^mO+mU&}I zLB(DnXI<?>M>G#`Zmuc6M%5hiycdIBsndQ^{Go`9ir*}6f4znj9 zBEYu0bq-7!QTv^Xjk)S^`KD^y*J`)}8QL{USn{$avtP7zvHx;W#P9WZ9j|+H>Yntw>46( z{*$aOcJGODqD~_qJZB_NCoxTCQ{@i2i<&=C{m?o4-(tbO1D(=LtFVuD#GT<8lkU|w zy&~Xht(=)!1v4LG%{;t5M==Zy^6kE-n2OQgxR=Myrl9=ew!W5Liiux9DdqL8UYY@VJ0Fqy8R!)J=ZULNf7~(eL})|RqGyi z`%N`|q5=0c2Khs&U?C()C!Gg<26o{~zuF|wD<7xI1C`S+7VCezMw1jT3ubu9f(?XX zTH85`9wz)(kG_?N;ELq)cZ31%M4QHa4$_wH6z~`7GPJeTR!-Z05PYuk0$(xNvp^M} zRiuDmMoByO16kOfLf841<;4}YD_f(k^M8i6BGi9<+U|}lV9y9i4virrzxtl2e>FQ5 z2&LBd{V9(9*Uewj*CmSedyGRG*pJvui;O*Rc^&PZA;zv5y5Ii!vZaiC!-p0k*+&yc zSPePNIM_yC&9&A&px1M4Y>BD^S3=oYXvAfa^Z`S~Eu!$;zojE3%!Uyu3}6IRE(kAvaQ1(p2^k#XnGk=Z@QZ~f457Ewts+Ua{Vjkdmp z=nb#eWG8Q?{q-$_TX^=04;Omk`q#=%3zXep>Ft(vZOyH92vK(3*lZ6rR|DVXPy%uO z)!+792i$)0g}S(5R@u45$26#as{5&iQdQ9*K1o<#jGT^8eE62|u%9n&Sa;KvVB3ep|BkEoHEgiFVK zx^Ln9QsYfRgvq@o!(dWf|B3S7X;wrLLJN(gc?J0J8?f|a97EDGYO)`u+ z%)$Wq4;lHKQFgUToGz+RoA<&fH8fq&^r3B~!Uqdlu8jNn$3pFKe16Ts&x91PwNt}; zt&0u3RJr-E8rb-16N#-7@+T*mRY?A>v7=nmy`KsZ-9LMKq!~KqktdAcI%}@#*~cFV zOh4~Fv0jUPEuO~_% zkiU50Bkj;x9%XODaz9XCv6^ZW>adEA*X_Z}-0$qtINbH!XcnE#~x7e06AdSB^~uWOaYhZE*oGlSlBO_32u*Ztqc^ zSDHBH`O&W1)u@K7ziZw_XgtKD>QbvZ+#eB+SCu1Q%oF5_KE&-vrh}P=uD-5Bl22uv zhp7A&)g*KX=CWVkkH*4{+jGuzVDhrttUH@%>sR71gH*xvpr60wh90hY_nyi6Lp4-f z!uy;rwP?b>!2$qT-6fjXGHNO*wR>^#>KHaB$>WHxM2R(yRix>Q_2O_ViMBX7mjMI| zHg_9XN$>_kuc-EkL$fqeDcMnA=Zh$|4k=1hB5aS@DOT&(d6ZtHWSC?YaSGGm{sn$B z1JzT5ypvz~JA!22wR{1iFWBc?wyCbLcR@_KX1N`1c)h?wxgOT3s|=T!$^1W!NB6c|%~s{JTD^WRvGl^s222U{Hrhm?P39So{Lo)IzF&V9 z&xv+_q3%p-^G!g&bUlKD%cdtHLgq~bTeCy^ub}gB*rvyGPt&Jl3Unb`d`)@z9WLaE z!P1z=G`&9-{atr(q$Vp~XzM+oE8PA3*<2_Ep@{H$Stv z*s~G9P}Wo!!)tH4|Q~TE$a&H{POS=87e1 zX`58vEPi-CJQeSQ2PHZS(2eikMW(-?#n1TG&jVUxD|qf^*Q0y1K6fBgj=`%+g45n zU}B;XHTU9c|48UVX7d=5G4KzldjA<;VF)#1hbuhFoFzU?wjSi4p6I9UR@l9RY3mfC#++ z9-ankZci{230t|7d>FuO;&u7@sr6&t-E6y`-|kX(Io1ez-yRZGNT>FFAjL;T4XM`( zbU~-iHr25L==<=JJhZG54r9sOn`ni!E8lU}R(I=2TJyLZfnLz#H6u6;CBPag+KG74 zy<98&-_R*HrCK#<=o7l$x0<6JU?rgH{QU@#5^kua@^^+;Va%@#B9X7F_oCp&Ebgzv z8rO&2x>a-2P$Ggj9b>MoeDpc#uV(Hq`W~IVX-w1I2<9H%Mq5xYCqaJz4qr-c{_M33 zJeS#f_jrswr=8OHo6;?h`01OHbSISlGb-Ai@8%QEKT=fqr`CT==gm`7;{ih)_ZCv! z0gTyehPmIUg8;~?R2sq7e?Wk`ji5DK6M7omgtv}}pUnIZ zl>4DB!H5+tc6p=tL8lujVUAxQ>rtbiakzG`ZThtC@u47kJ=yKLHB4J;0$NVNPo zLe1XDIP(_3Ck6x9vY}4UTOcW*yH&4(0IA9`ZDgf=kq|w^6}`=z1N$hO4Hd4vWn>WW zN#hM*Lq-~21^s_F@jd^5ioTd3*##-~gLj&ZF3nHbmkZztQ>{k?iBO;NigXr+^ORi% z7NqLVy9Kg-mClROSRNLJvMicHc*63HG1o!Bvn7oS(xN*0g~R|rSn%?QDjQ0>=%Oau z(gyfp4X6liEbRwOTVL5RZ!@cle2pAcA#40Rf!sGMr5aF~K0P9kWT5**42o3UbVra4 zW$QtJJF^uyvY`Rf+p4nG+-^{2WTc#$RQ9M!_?#TyOJwQc;O9grb>BRdnrwby8=m4p zz_!%YlL3_rK&ZT3O;*q%M{AGSIjG;UUuF8Z45iD+pd;Y75}_*lqOwZj%|(LaN^Ten z1J2m(b;foeJK$Sk1kH?EDu|-4W>(D{8Wvz@~6QfMOAiVq(CvA5B4{D#-Hlv4a5Nws*OsD!?d& z6&&%|Ou{yEhyN){B2@p0H8|8#Y*C1(tO*4ycbgfaa;YcD5GDF-61hK9(C8`4shuUi z2NVqF`6NO)+9wqy8LDz7RW3;7w*M2{W{%ESaM0Q-C~%cml_k4P50#g-e%CCS3I6cB znnFenend+WH;?* z#S#Np=D)DTZ!>c$Z9f}ON#L=j^aNx%F}CyINdksZnJf%NU!LtI26RKSTO+p%f_kpZ zSs1Q9Y9|-Lb)ErI+sxtmdq_r*QvEM`0OZHH2_1rlU>^TiHCeJFK{&{`b+lyYHnUTL zCs{W1g~#Q7z_W92(E*iY?H+p&W-jC$$g8iG8KWwwRub?sdZ}ChsF_4ldQVwNj58Ui zlCNIM$sh$A25ndv@V`3@fJcdqU4jOanNt7~JFQCQ^@R=;9<&AixMs*!yC9wUWzU-p zEq4OS!SMk!pd#(U!84I!0wx&Zq3P1iyou2CHi`pwRZxkgJCn#rmpYmY(xk?UnIuqi z6fQ_bvc^>}NLg<`(q%*A)$y{SyW4j|Du?7MpwzeitOF|VYi@c^6l4bh zs(J9jmK`ahAY12H7z8lFyx=(c9Qv+b%UbJZ%2X@JTC1OnwJ{@A?KZRx`c;NE9b8?L z0t($#lR*?mFJC4?6>pcMRAm9{VNHL-X;GC;jKnX7Cv+X+voJ&@yHw@F6Q+Ye3yzxm`ZEFq%(`nokqOyv9_(0p}&tV+_5Au6oBr>29jGCI+4-i(-%h_fgG}VdNW?ubc z_yid_V9A~-e?fW$cY8RXf{uuxdC4GvNQKUV9!@VeS!1t&VaNX;1xYq ztDgX1mU4pRw$?4{wK~!6O!t?7tgJnVT^^Gyy(KT?3}Z^SQ;3*7Ef#3QL@U2Zd^p@1 zKVr$wMQY)fJzk*tQz-7RDvK~scc%D1evdN)WKyhKe9|Lwp+3=vB@KI2rO9M*?Kem# z+^jWy1x!LR&wp!Txp>BZCGk`Cm{AuSZB9_2h37r7nUm3Tp*pUo0m_G}Q5;!wxI%5* zMQ^-uoJa+i0tHfz&rDBWoaLt!E)lQ|7)1Ew%~{F4iul~}_B;&UE3oqFC0SFNoPR9i zJ|;Iqc@MiRaDrCYJ5Z1FQ(wlxp6zT`fW2|g*C|K=n_ z0)LZSs6mZYeXk-$NJtaCo{nD3>Lu&4~G8j74P zYg|{M?=)N%JCBdivKZIb`Zgz4?ROC<2jn}6XaNh4I(l1ad^XPQhxbukJ{vVu?pqb% zg7n)eQ*+v;d#`hn0gHAx8*SQ9vt&$xOdb_&iLK}w4MyA3;=vj&TIFuO^)=7tqoNo|WADhm}Co}Ly z1iTV(dzcQi4V$z(jcdPortK+!_-3d!CsX!Pae-u``|3+pSw$W>#W%e78Jau->I(86 z=X!mfkJDr`mhIxPeI+-%)Lw3%)aSL3{h6BnX4)VAfT92IF&5YMHKvc@yDiMc!Yo$*K5v zTByAQzjbKL`yYI|-&ESzmbEXjAh91(vNfmZ{;4Hjv2;iX*?QT zm}-(szI-_4XDI$4Vj=bDrUnQ(RSImSnsG!N^**yFf-t}A_LCmGI(|s8+RuLnV*YolARW{WkYlzkTN@Fa6mGmq2SWy!1bSPU4 z@2+vs=!)GbpVv1C7<|6PTGvc*+REeX9|=-1layt(R6z7?#tzGD8&mwhoMe_-eaiDeYVRC=Ts* z2WUx_V&_IKd1i=J#}7?+h_5gM(ge-iB6!RpO8=4|I;4Cf>esI-Tg`PWl58To5%`tbPxJt)(Z zZ%bKTCsVK7z9GLH7=L2lCg3#ncVcU%w=wM|Gx%$#6pIf&Q&cC{v zyQGbMs<^AHZV|Q`W+Kz>*2?`UH>zV*m{7LSA!JR!2+XcBT{}`fVJOoVr4C-@V}K^j zKk^g)C3e*5YIIu7EqB{WBi=6G<^73j*gN}a!DGJt8=qG8+<}@fq=;l`B~g2VmJRaI z#8A<(Ki~jZA>NzHwQRYw%8Qf)`V`9C+0pkd!g@G?5(T|$MslL*77T!%7Tdw=q#HM>3@J;hq1@+y8F- z>m`qqm=Ft{UmPrT#@VN^Tx-PE#egh*@>|ASRxm5_qWw(-WHxX&kF%q5G?w+frk*RoQXSS1nX(Qg;pou``xO0gx&3;T&SfFfc^+k6Guhu zQdKY*euQjXrQnf4Ht_!o$AL`jw=2S9hL~6s*-xS6>$92Bonz+6 znBBCu*e;!X(|ZiF3xD{~n}T+oe9|$&)SZ0#y&caoEIq?z@L}%;NuLYDN~0tu(VcX@ zQ!0p^f`biE;D>>H%Q%octpIL-h7GOTTCh&IK~=!*w6#GqL}~;SleCksb996^)Uvbzx`huro9~zjwS2S+5Ojf?d`+q!!`=<; zY8D`SzAO-DSY|z&djNZfHYL7C>n+_A4d$(9c>o5HN87c`$*_H(}I<$5`p09&AwY`fofq zBUCCHp?U}c(BXCvYU%l;&Vmf`-1m9bYeWyv!8u_kU+;#qlMQN2>oFsm zY5%cc5z=k~TVmpPiZcvGg7`lO=4!pzeU-CoSbhyDJiK8Y4QOWGm? z@m;M@dH@67adt`ZVZk1YRRn;}!8-ew1J4=Z&a~tX=SEsU<{y2~o+}ieoDml6Ej^Lx zRX2(L<5b=zE~g8gGW*PLD`N9NhvS)1BkGqB#IIaO@98-<>g?48#q zn#zjIn^wy)8p5qRuQa8IKawl{CR~DD=Py5BQ*8XXi?9guHk|Idd*e!z6L=l_Mvi9< z^4SR>RQa^JyJVV2MgPVjL{heyakPtKY>LiG#!Mq>W^~PX-=R(+qBVec6Ah{7Ik*() z{+zam79pJFDPc()KGJ+$y<0XAllP$evy%Oi`8sAKg8nB116|)Tt6$dfwS$0E)1HrU zm(o$oO`_5VcOLtd&m**@%~4xFTb5o>ifoDiJu200CSFuxfwE0T?tYj=2Fn`$Hfo7M< zt0t%sHXM6ls`t&PE!ZQ;63?14BmQE%;%SVRdtpvx`JYeD_z4SrQNbg+8n!#!R7V78CAN#kF6E5N9uUT^bDZ zvr}ed{f7tcAutj0*(=@L?|e#{Dhw@D^CTPpo&W5xz$^S)#-ZJp)4=l#FN3x!BlD*?V^15WGvw;57-Fx)y5$Qk zT956Q`O}CC$ad`8jljJCqiPtn$0NA83Gu>9ozNnacqyDrk|2ukwy}yKAMIKO)W!1ijnXss)_|*Y3 zi}NNtL8+c|Ju7qXv5D(rn1_A}N9O4T^0^T%lkkro#hLKGSj8Yl9Rapwl0N4)vhEe) z!;f6uuq_VhVWgvXA>r&6+{VRA(;^b^c2zWZuXQGccPg*X&h{bhODG# z2jX2>kN)@>*|>!ia*d9`PI1Rl65$XS%)|2;OOwBi*7wDg%)j`N%n4xa!hk1k1bb|J z1ky2^KgVQQU}Z0w6#@2#E3-^Vc-DtfqRWb4Z9uB3IMM%#i9C3{;#xy89$lTTW;rQU z4$F)|IP~*=kol$cR)79WPqrA;yy3P$3mj_I>Pn~N|GN_kj4f7jXJ)Ep!TRsoD;ZC{Q%EJOl6syC*cegX9q<0T< zuXoo%p4+@?`lvu+l`i!A{x9SxY>}n|)}aC==e}}gcj6pvxvlmCrs#U~@>fn)ds(&k zEJE+$CuESvc|t~U15VP|MC7yY9ICaJMIg`CY9HUo%m=JRv-EAxt#8sbC8c7YcXDA; zzgluo=J_b@nUdWj>|0tem+&q|X+4#NAARRzlGyZZy3lWuCXodC(3VsJy^I>rt_JjH zvRtNgNNzWjKOt#5m)|^h)Gp9lJxl8anSqZVsGv%7J>_qGG*OKiaxsik4OE|?p+y}*Y%e)14R0#2>so31=E{LgxkKrfA3O`=5VKNfvX^%PCapxw*XKK1wSXn z_C6Qi2Q`K(t%Az_>$&W<0I~kX7zY0rGIYNSq9HO~oazGX1RiG+Vkg5zL~G%elRwGb zFE;OE*=>KhrGc>Q1DLN0SoTaPo^c;k&Ypb}NSshjS3kePt4=-Nl+(>4-?!-yJxt|) zs+~SKHLE12hKZuv2Q9W;bY-JJZ9TQ{GA>hfQta=mOy?2PlMXGhr|bs(leO>%`11b% zW&<<+>g-eY;h_2py>w)p)w=*98pE}49)xesX=;j5h70hbW+s>1?V!y-pw~ifJX!}? z#-HC~eqi46YLBGt?+y5(N5SkIp9xkd;uoG0L~nhOejW z<;^zXDdv=+W3iJ<|QMSC-?o{$E6ujJLjqxt5p zQv_}gB>ZIt!YoA0qv0BDuBz&!L1&)@hyxn{ke`tTzqdVFfaoqS{YN<}ZN>#(n6-X1 zq!vCmf)}Pp2MBA#o~DYU&0T=;EM}eah|=*plb0w*D_+n!>L{dPC`PjuzVYD7O~6ZB zXZ9}TmNK;OGl5>&550fkEItt%TI-;_A9z?ayoG@Zy)Yx0VY~~n(rawN0=!TGYA9E* zsR5JuVlnXVu7zS_lu!P`6BN6%of9>{3ua6U*fz$M$qP}Ac2PzbS9@Q)3o_?FIUEB| za^14@z?0z3})}%uX#FD5H-pByal8sV+dC-r9Eo%(8;BPT5Z)B^MwwO#_n@X`;U1 zJ}CD4!i5LCSf-I=o6qNTU6*@lBJAY#r>V1Y7M)dMu^PkZS6}_# zGNLcnnp9blAMzgGh`Cmg!020f#k%oZE5K65v}*Q!x&Bc&deQ1HaC+5ewdwDAhELMN z)ssCdcj>De*eF34*EQZ{>5=e9*T!w%f`z-GEu@4zvuz## zNgRf`x1T^oCF%vVt|}0Rf3j{UJ#Q|2~eE+uy?93zok{SB5rZLeMnk`cJtI(Z_6 zHq0$@r2n3neuoP@yq0t#g57!s6K#K1 zX0rI~Ee#>a?qBz%S7V&GiC}>(@(e8XS$QV>qJp! z%Q>Z^$j?%KlL^mOMjKGs)Tab^JQn}u{T+y&QDyJHCr=go7dUtS0DngbSW5!AP~92;CSF2;lLk87E8Tzvnj7sEj1f?S5C%#u_I(`*+R`0#)i zQv|vQI54Ej{X3Z=Fyw2EK0``DFs;9ShX?FEnbsED$q#s+dEn=By)M;nd1~N+rmtnP z#Qgn(ant;c`b(Rw0gWGe1181z4^6RSr4ku9Q$i2)2VZh*&$k1Dr=ZU&^su7V-q~O* z%`wo%*y+LXZF7m#a{msLlF41`HCT@le`A6*5RUFmF-Cew{HI&P!=GQs_pw*O9jA29 zA6eC7S090~^;9wa(dnEES5ygf(~!2TkBO^ z9e?gPq^Q^btnV-_enS`PaYvt22j{bd7_nVe-TCPCkCB)0sq&+lR?H!OC|;7!NKU&F z;Ov+onDk3XOB7_4%ucOhb^hv@dWgk6+Qr{4`{Z^!8!6Pl7yrGo`XsGGc@#p&C-t28U*4R{LFmu;j@;G#27O8ps89yC4 zlXUK@NIl-D=(QhXY0$gpDz+W-0N9xW%*^$mS1L60E}QYWXy^qX>TZIWS>tNn3qd=? z+~52<*+7*tU96w}W~j~nWl=v4{ice(RxVuXm>->OSoG|(||6FhmsL#GxV61TvKud_Vqjz2dZp5816gzb@( zofo(A)!B|e?+{Tr*&CZT#-MpSAL3_{j{Qp*ehLrefi@X5^giUhH@*daLCF7;x=jbt z!w780ME`s0&N|N0HasixQ&^`wCl?u$Z5Ui!aMC3b@JV8vC9Cl6sfM2Dr#Zct?AJp? zu8Wg_Cmwp_315oQgg@3xJ5P)Qu3QM`VL&k~zr6hXkT3V-*HG4lQq@duF@wFXH-sg@SW(~c^pc`B+U^9T<8+x91 za=BD~0(z^si}(WFPq77?>#Yl1daP%Yh0e?QDeP&rbj-copXPbG2SD|k%i_1`jE`M^ zo^-t~{5F$xeOYOYB^OyV1IZH({M}Z20W)B_aSbXh^qsO#3%!JoxUv|YeeJ&R;4Lt- zD0?z3Gk9Ji>znqmgEi0@Y_50MRa2X-@?1d|-Jd0yc%q?K5rG;*oshTarxx^5D>-eGYWdSqhu6Ohw5zBjt7uQ1NC33m*7 zqSw=u!@bP{?)RBfW<1u2rWx3H3sy7KDfO@y}(HuM6=st932FH9T-uRS#?aj!@ zh16{iv@hO&CxnCP-YXB991J(>p3aGW@Y_FBbECD|?dSj-N z_Bzvx?thh&4C$JCA5Y@Q0@GZ6S~k2Pkx^$;_J2aXJW!S8jnR#MrF_~bYIGB>A#DW@ ztOApnGOQ6dpB8=9f3ANw>&@L3qnW3VeqDL-HvjF9ynBXE^E8$7H1%_3%2U4F>d&tJ zoOf@5)P^CdgkGRN;fiDi(`8UgcwY$qq($#WXUMS0%b-xUS+s1U9zA1~eo7$L*5|cW zj#`VQnq2zkikcxae_Gc|#eUeg{SInnIrJf5-1bjj?ygS_=#F*2p)9VD5vibB=2zZv zvN$s(@aReFdTqpbL5V;lRCVUr{kv&vN*Rp0q~I^PGT{T=Cq+4XVl_=({8T32fUOn( z8`$w8HIc}$8}ib3emVvHZ=usAc8`r9t*wpOh^@8p6m z04Gg0tB9Oc#kJEAz$Ygwhn%$r+P9%pg;o65mmCP!C?t1o@a7NBE!(IH6@Rn;Na<5N zK2Q1KrO-WViwSoGm#mI2t9C5V6{)AGcBjl53I05#iD{wUy{Kv<3`f%v5LyJ=lTyVZ z*llS2w%#2qT5U(*ogyDXG5uNDKP1roiz(MLGP6pLUsG(g*1PwmUzBZO*^ zBSbA8?^aVxY=+ykB7rPMW~@a!thcm;;^D&XaYcbkhw!8^eogo?_7Ug`);Z)9+^ntu z)7{Qi`FJKq(GM@JdENq44i<@bl4NxZE3#bTLj_(21<`v+b_Ufu=DC|XCTbh@T|EaA z#u!7R)`7Gdct0bF^W@-*;F;TqGUEQ--GCNhpLJUH-Zf3=n0`w(&U3R_X7Di0@_{&* zrdRpy;S@iM3e?K5Lbx~A!vn8FlgVDvt;zr5+$MiIf7$9eT|7|O%El$7AB^q^mRGHC zc1cgBC=paBI}x0Sarh(gl4*6`n%5GlWz4=~=Lb|H_jddnx(iBKrwDkxn)G5dBS|Ew zclT@PWCtOiH$kv4|LFCJp^C1)zfv6HO|Warj^`1X`6usv)ZlEM%w!*N2KsUrtFkxy zo^&86v>I^na9k?4iYCvD4tw53sekq}pEm7UZrv&zh_=^Z^fsU{jp7+qT~%K9#p^Zs zmUs&uNnIIGhpZ;Dd{_AzG0MuMEa3a^#%NGO{!b6t^;9c;TMu5zZ1~~O3ggKX*Ssx0 z;}l6m&3xePK)40UBl_>c1Z}=SE$Y`v)a6&hS)WcF04hDZSglO^u9M6Re+Rzxje`Q~ z$#h`(L5k%^^m*QIlIh2@ccXm=&g-K!kK}tc5E&dP(roZoidiFHW`fORjpUOyMV%~X z^FDEmuZZH*7u{tj0_ZfeSqKamXL0~1-ChJk{C)NcJ8H8~S61qUiI}rt>t)?U%8)ymuS?bi zTg}1(yMuWd%qjP#&y#^VbD$57Mj*$u=M4ZKX6j))#wp2bls~9F{#C%EtS6AW7s!aa zSoyc?3T^weZhZ=P%rS6jYLdRj_+e)AC9fA3ENWn}^HBY|clX6!WD=g>{;Dp}itT{4 zq4DE9~Ofi#i471xfp+;W_AA&$^CsP7Z{a8ZWWg5wu@^d_ zrF@p9|8S56+xI;RA{W{$ZR@LeEM7|4;y3UkHeB=S8B+~uOeCB~Ao(PHm=WX=j%+QS zquhw3iru?>L|>2({^lOg+tD47?!%1dwM06+T-ce-d34zPCev}r)xO8BZL`Uwp+jbQ%+O4Bvt%wy5{EjlIt>+LMr%hHF*wsdvHflVvpGUg>* zC7DNF6>M3(I%DI3Mes+p{dufh6F5T#oAMX!V>UVSSEs{Y=?_#~_iVv`b`m!Y3$1AX zE4umOuA?le2SWz3-;YLz4J7X~MsvG=`FzxzhLLe)yLSSWn%Y#0TsDrH!%V$}t%Qs` zEbt)=M?7HvZBi<&)J)1~SVqmfyWg7mwl}j$K-w&{iX{q(r)3jQ=8)EhfrD5;Z!UXrlRuN+2f8`i#t^?RJ`J z-s9u0GC0#a*M=);1Hngj&`q6DkAO%&bW!n)sp8#58HwkigU@NtvrC#GT#YiV<@FNf zK$w?<@2h<*)|vyR%E6{?3-1__&kFiXQg5Cx(*lqu@@;1`fdQKhT8Rj4M#??B7 zSk@;M#5pC%bT*kTy#)C--;2|eF_>h;JPy?k@aZ}0j~>k?I*BBxB#)qk14oXED!L&w|lr$%@M~9r)NZhG37x z@#}S*F@b0G$nJMYIq2m12;4K2?oh$bVZ$H>OjHPnEP(O_pBaP&KvD{Q?%qJal()_< z(Huw7z_c4 z1YL08a=;>z>$4&Z88NDr^O6SdB7ci)#c#ki9dmw5K5fNSW;dZvvgTiC&=%kL@y z-`-`+U9*QK%}v0G?tW;>H^vwjQ6?vvM=Kt@RD!65W$mh0zOS5iVMx4;*r8()vYmBj zzi`g(q=WJl2Ct0;(a+7{2gfj^7~Xlg3YPAy9qh7;W28b zV~3Wv>V_uY$Ch;SYb2L#ySHe4&}VebD+yR1JJgB%VodSxJ?64+`sWfQS^lZO7^;xG z1RrdoHv2dPe@x?)byks)#B$<Z+&;1NKPm@QZ(rp9h4$^7+(;NppZfOtp`8t}C zH+FcY+J>W_#?9&uJ%7wszG`4~92$3^PUU3isXk^OWyL3~I5e`s{F`3zV z7jXO&Wy8`GPp;W8O%L_*Z656tK2c7un-yO9!TopHc~bXQ#tYT%WFN#zamEsb-;5m! z(umM0SUV{T&t};c<+%P1o#z{x@S!?3f||O%G#$Az>UEzs71x2@@av#G!>0$;&4BUk zZV^~p`)p43R+j8#c;V4pUnp&Dl7U^J=w?(+-bsAoQ^P*z@HQQ5(u*zpxJnn{AEvRMo{assAm&y`E00&zq`!1TBX6*WDzq>qO1n+jx;vIX#k@aPr^r z2gobsn3mq}j#O67sH*R00%vc)qs27#=khf$#lQ-ey#up$z@`S$! zx1t@yX`Z*-nkxQQmAQLDXM8irCx71AsE6HLH_9$}!{-t4pV#T66u1|!+h?!R*IX*b z(k{pAu$1Aq7Bm>N)eC2`Q>&PMhgA+vDKPd>_&a$EA%j;rsieuSjkWFuFyR!_(!D0O z^@>Eb%7wFM)k{R!Gx+?i5y0EP$uZqSsb^w7@9ieXUet3;iVp9L+FNGBfYS9KWifQ{ zawEIf4$6!r@7Pq-*1%R@I03bwc;5F`!H5jO)lZr-Sz)KFPtx)^OopYDa${zh6rras z56-T9L;~&n*BhZO;2&Ju9=haed~|c)L=zo3v9YV!ddSqGmK#|H%t}XDo7GJHy4#6y zi_tvC$}NptJvhj|4HmgcUaFS5jx~)+9WiTjKxz7U50YJU*72jo9$LQN6+6nc3v38h?C-Ra^oP-6HsPBxEPHn z_qi!_`)1S^av{g=N3*vsWYKQCkyeT9T)W%q1*p0u<0s3a$iW_E5 zScy#m%cX~M1s2SpCh z=|2KuD1^G|;@SVoJjO4w&RVWuL=g(q8D*FCAmZkmfO|*O>27dtuRvm@z5g&r6n?W; z?z5gI=@4A(Gcj@}rRh-Q*AQKAdyRt7OGe_~LHfFrGeL<>L;&83-3tN6Can^s|TK)m2MuhjhbfIP~ZgFM+f+u5gQ%SghDk zG{&r$T^zzy1}@Xki+>XiooKL+WE=^CF%3Sm(kDaa!r;k0QUo@*Q}cdSR6xjLd96QRAE+1h z<^@Ksoz(b1q41%@TdYU3)bO)_m8F!WQiZlp%gU65F8nPW#r^&Gmf8U@P%*^SRqDei zt{kTFQ}XXSpZh(%Pp4@??#Pp;^y#J5JskYYi%aB~GK)I<@gIX}&RfAy++Tp5s4m|- z)hl=i&CPv>VR(d-@A;&Ml;fTvj+^z<#(3JY%yV0Y`#S9;SxJ%0Af#mIh= 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%0D=Imj(@?unjF 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 delta 128720 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

JMQmDhrQ}&@NbN6W}x}{706P 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

  • #?D4AHCM0 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 FJ^?J(a}fXl literal 167063 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 Y{BVh~bH6gBU)iN!*%iu?@Da=Y4`33%bN~PV diff --git a/tests/fixtures/tension101_elastic.mat b/tests/fixtures/tension101_elastic.mat index 7ee8f42d1ef25005df72fa743bc43c803afb944d..bcfb4bb0b24f64d4d148820b1ef3ac016aaa3cde 100644 GIT binary patch delta 35031 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 Y{)76*uN!_(lrQSb*Ze3?ls^0a0VSfa761SM delta 13581 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 diff --git a/tests/regression/TestAnsysAgainstLegacy.m b/tests/regression/TestAnsysAgainstLegacy.m new file mode 100644 index 0000000..d57710a --- /dev/null +++ b/tests/regression/TestAnsysAgainstLegacy.m @@ -0,0 +1,73 @@ +classdef TestAnsysAgainstLegacy < LdemTestCase + %TESTANSYSAGAINSTLEGACY The new ANSYS files equal the ones of the legacy code. + % + % Runs ldem.runSimulation on the reference cases, writing ANSYS files at + % the same steps as the legacy run, and compares them line by line with + % the files stored in the golden-master fixtures (time zero and the + % later snapshots). + % + % Intentional differences, removed before comparing (see + % ldem.io.exportAnsys): + % * the legacy line "ET,IFILE,4" is an invalid command and the new + % file writes "ET,3,4"; + % * for TEST 101 the legacy file has no constraint lines ("D,..."), + % the new one lists the fixed degrees of freedom. + % + % See also TestSolverAgainstLegacy, ldem.io.exportAnsys. + + properties (TestParameter) + caseName = {'tension101_elastic', 'tension101_damage', 'bending102'} + end + + methods (Test, TestTags = {'Regression'}) + function ansysFilesMatchLegacy(testCase, caseName) + fixture = load(fullfile(testCase.RepoRoot, 'tests', 'fixtures', caseName + ".mat")); + c = fixture.caseDef; + folder = string(testCase.applyFixture( ... + matlab.unittest.fixtures.TemporaryFolderFixture).Folder); + + params = testCase.parametersOf(c); + ldem.runSimulation(params, OutputFolder=folder, Formats="ansys"); + + nFiles = floor(c.nSteps / c.ansysEvery) + 1; + for k = 0:nFiles - 1 + legacyName = sprintf('ANSYS%02d_MAC', k); + testCase.assertTrue(isfield(fixture.files, legacyName), "Fixture lacks " + legacyName); + legacyText = testCase.normalize(fixture.files.(legacyName), c.test); + newText = testCase.normalize( ... + fileread(fullfile(folder, sprintf('snapshot_%04d.mac', k))), c.test); + testCase.verifyEqual(newText, legacyText, ... + sprintf('Snapshot %d of %s differs from the legacy ANSYS file.', k, caseName)); + end + end + end + + methods (Access = private) + function lines = normalize(~, text, testId) + lines = splitlines(string(text)); + lines = strip(lines, 'right', char(13)); + lines(lines == "ET,IFILE,4") = "ET,3,4"; + if testId == 101 + lines(startsWith(lines, "D,")) = []; + end + % Trailing empty lines are not significant. + while ~isempty(lines) && lines(end) == "" + lines(end) = []; + end + end + + function params = parametersOf(testCase, c) + fieldFile = fullfile(testCase.RepoRoot, 'examples', 'beam_102', 'arquivo_3lc_rnao_cv05'); + params = ldem.Parameters( ... + testId = c.test, seed = c.seed, moduleLength = c.moduleLength, ... + nModules = c.modules, dampingInitial = c.damping1, dampingFinal = c.damping2, ... + dampingSwitchTime = c.dampingSwitchTime, constitutiveDamping = c.con, ... + dt = c.dt, totalTime = c.nSteps * c.dt, controlNodes = c.controlNodes, ... + youngModulus = c.youngModulus, density = c.density, poissonRatio = c.poisson, ... + fractureEnergy = c.fractureEnergy, criticalDistance = c.criticalDistance, ... + randomFieldFile = fieldFile, ... + output = struct('snapshotEvery', c.ansysEvery, 'controlNodesEvery', 0, ... + 'energyEvery', 0, 'trackedBarEvery', 0)); + end + end +end diff --git a/tests/regression/TestFixtures.m b/tests/regression/TestFixtures.m index 9bffeb7..818397d 100644 --- a/tests/regression/TestFixtures.m +++ b/tests/regression/TestFixtures.m @@ -46,11 +46,22 @@ function fixtureIsConsistent(testCase, caseName) testCase.verifyTrue(all(isfinite(s.U), 'all')); end + function fixturesIncludeTheTimeIntegration(testCase, caseName) + % The legacy driver once skipped the integration (nodes stayed + % at rest). Free nodes must have moved in every reference case. + fixture = load(fullfile(testCase.FixtureDir, caseName + ".mat")); + s = fixture.state; + speed = max(abs([s.VLX(:); s.VLY(:); s.VLZ(:)])); + testCase.verifyGreaterThan(speed, 0, ... + 'Velocities are zero: the equations of motion were not integrated.'); + end + function damageCaseActuallyDamages(testCase) elastic = load(fullfile(testCase.FixtureDir, 'tension101_elastic.mat')); damaged = load(fullfile(testCase.FixtureDir, 'tension101_damage.mat')); testCase.verifyEqual(nnz(~elastic.state.DM), 0); - testCase.verifyGreaterThan(nnz(~damaged.state.DM), 0); + testCase.verifyGreaterThan(nnz(~damaged.state.DM), 0, 'No bar softened.'); + testCase.verifyGreaterThan(nnz(~damaged.state.FS), 0, 'No bar broke.'); end end diff --git a/tests/regression/TestSolverAgainstLegacy.m b/tests/regression/TestSolverAgainstLegacy.m new file mode 100644 index 0000000..9a7b969 --- /dev/null +++ b/tests/regression/TestSolverAgainstLegacy.m @@ -0,0 +1,137 @@ +classdef TestSolverAgainstLegacy < LdemTestCase + %TESTSOLVERAGAINSTLEGACY The new solver reproduces the legacy simulation. + % + % Runs ldem.solver.simulate on the three reference cases and compares + % the final state with the one stored in the golden-master fixtures, + % which were generated by the (corrected) legacy driver. Covered: + % displacements, velocities, accelerations, bar forces, strains, + % damage state, damping switch, energies and the reaction and control + % node records of the beam. + % + % Not compared, because the legacy value is wrong (see + % legacy/KNOWN_ISSUES.md): the acceleration in y (wrong index), the + % external energy (never computed) and the energy vectors, which are + % compared after summing over the nodes. + % + % See also TestMeshAgainstLegacy, TestMaterialAgainstLegacy. + + properties (TestParameter) + caseName = {'tension101_elastic', 'tension101_damage', 'bending102'} + end + + properties (Constant) + RelTol = 1e-9 + end + + methods (Test, TestTags = {'Regression'}) + function finalStateMatchesLegacy(testCase, caseName) + [fixture, state, ~] = testCase.runCase(caseName); + s = fixture.state; + nodal = @(x, y, z) [x(:), y(:), z(:)]; + + testCase.compare(state.time, s.TIME, 'time'); + testCase.compare(state.displacement, nodal(s.U(2, :), s.V(2, :), s.W(2, :)), 'displacement'); + testCase.compare(state.previousDisplacement, nodal(s.U(1, :), s.V(1, :), s.W(1, :)), 'previous displacement'); + testCase.compare(state.velocity, nodal(s.VLX, s.VLY, s.VLZ), 'velocity'); + testCase.compare(state.acceleration(:, [1 3]), [s.ACX(:), s.ACZ(:)], 'acceleration (x and z)'); + testCase.compare(state.force, nodal(s.FRX, s.FRY, s.FRZ), 'nodal force'); + end + + function barStateMatchesLegacy(testCase, caseName) + [fixture, state, ~] = testCase.runCase(caseName); + s = fixture.state; + + testCase.compare(state.strain, s.SS(:), 'strain'); + testCase.compare(state.strainRate, s.DSS(:), 'strain rate'); + testCase.compare(state.axialForce, s.F(:), 'axial force'); + testCase.compare(state.history.tensionStiffness, s.E2(:), 'tension stiffness'); + testCase.compare(state.history.maxStrain, s.EM(:), 'largest strain'); + testCase.verifyEqual(state.history.isUndamaged, logical(s.DM(:)), 'Damage flags differ.'); + testCase.verifyEqual(state.history.isUnbroken, logical(s.FS(:)), 'Rupture flags differ.'); + end + + function energiesMatchLegacy(testCase, caseName) + [fixture, ~, record] = testCase.runCase(caseName); + s = fixture.state; + last = numel(record.energy.time); + + testCase.compare(record.energy.time(last), s.TIME, 'energy time'); + testCase.compare(record.energy.kinetic(last), sum(s.ENCN), 'kinetic energy'); + testCase.compare(record.energy.elastic(last), s.ENEL, 'elastic energy'); + testCase.compare(record.energy.damage(last), s.ENGD, 'damage energy'); + testCase.compare(record.energy.brokenBars(last), s.DEN, 'energy of broken bars'); + testCase.compare(record.energy.damageRate(last), s.DERIV, 'damage rate'); + testCase.compare(record.energy.damping(last), sum(s.ENDP), 'damping energy'); + end + + function beamReactionAndControlNodesMatchLegacy(testCase) + [fixture, ~, record] = testCase.runCase('bending102'); + s = fixture.state; + + % Reaction of the last stored step (legacy SIM01.DAT keeps only that one). + testCase.compare(record.reactions.force(end, 2), s.REACAOY, 'reaction Ry'); + row = sscanf(fixture.files.SIM01_DAT, '%f'); + testCase.compare(record.reactions.time(end), row(1), 'reaction time'); + testCase.compare(record.reactions.force(end, 2), row(2), 'reaction in SIM01'); + + % Acceleration of the control nodes (legacy LET.POS: time, ax(node 1), ax(node 2)). + pos = reshape(sscanf(fixture.files.LET_POS, '%f'), 3, []).'; + testCase.verifySize(record.controlNodes.time, [size(pos, 1) 1]); + testCase.compare(record.controlNodes.time, pos(:, 1), 'control time'); + testCase.compare(record.controlNodes.acceleration(:, 1, 1), pos(:, 2), 'ax node 1'); + testCase.compare(record.controlNodes.acceleration(:, 2, 1), pos(:, 3), 'ax node 2'); + end + + function dampingSwitchIsExercised(testCase, caseName) + % The reference cases change the damping inside the simulated + % time, so the comparison above also validates the switch. + fixture = load(fullfile(testCase.RepoRoot, 'tests', 'fixtures', caseName + ".mat")); + c = fixture.caseDef; + switchStep = round(c.dampingSwitchTime / c.dt); + testCase.verifyNotEqual(c.damping1, c.damping2); + testCase.verifyGreaterThanOrEqual(switchStep, 1); + testCase.verifyLessThan(switchStep, c.nSteps); + end + end + + methods (Access = private) + function [fixture, state, record] = runCase(testCase, caseName) + fixture = load(fullfile(testCase.RepoRoot, 'tests', 'fixtures', caseName + ".mat")); + c = fixture.caseDef; + fieldFile = fullfile(testCase.RepoRoot, 'examples', 'beam_102', 'arquivo_3lc_rnao_cv05'); + params = ldem.Parameters( ... + testId = c.test, ... + seed = c.seed, ... + moduleLength = c.moduleLength, ... + nModules = c.modules, ... + dampingInitial = c.damping1, ... + dampingFinal = c.damping2, ... + dampingSwitchTime = c.dampingSwitchTime, ... + constitutiveDamping = c.con, ... + dt = c.dt, ... + totalTime = c.nSteps * c.dt, ... + controlNodes = c.controlNodes, ... + youngModulus = c.youngModulus, ... + density = c.density, ... + poissonRatio = c.poisson, ... + fractureEnergy = c.fractureEnergy, ... + criticalDistance = c.criticalDistance, ... + randomFieldFile = fieldFile, ... + output = struct('snapshotEvery', 0, 'controlNodesEvery', c.everyN, ... + 'energyEvery', c.everyN, 'trackedBarEvery', 0)); + + mesh = ldem.mesh.buildMesh(params); + [barProps, history] = ldem.material.buildBarProperties(mesh, params); + scenario = ldem.scenarios.fromTestId(params.testId); + [state, record] = ldem.solver.simulate(params, mesh, barProps, history, scenario); + end + + function compare(testCase, actual, expected, name) + % Relative comparison with an absolute floor tied to the data scale. + scale = max(abs(expected(:))); + floor = 1e-12 * scale + realmin; + testCase.verifyEqual(actual, expected, 'RelTol', testCase.RelTol, 'AbsTol', floor, ... + sprintf('%s differs from the legacy result.', name)); + end + end +end diff --git a/tests/tools/referenceCases.m b/tests/tools/referenceCases.m index aa46ccd..4fa0873 100644 --- a/tests/tools/referenceCases.m +++ b/tests/tools/referenceCases.m @@ -26,8 +26,8 @@ 'seed', 123, ... 'moduleLength', 0.003, ... % [m] 'damping1', 25000, ... % DF1 [1/s] - 'damping2', 25000, ... % DF2 [1/s] - 'dampingSwitchTime', 0.015, ... % TDAF [s] + 'damping2', 15000, ... % DF2 [1/s], differs from DF1 to test the switch + 'dampingSwitchTime', 2e-5, ... % TDAF [s] -> switch at step 100 'con', 0, ... 'dt', 2e-7, ... % [s] 'controlNodes', [1 2], ... @@ -39,8 +39,8 @@ specs = { ... % name test modules nSteps GFR OU3 everyN 'tension101_elastic', 101, [6 3 3], 200, 50.0, 100, 10; ... - 'tension101_damage', 101, [6 3 3], 800, 0.5, 400, 20; ... - 'bending102', 102, [70 4 3], 300, 0.5, 150, 10}; + 'tension101_damage', 101, [6 3 3], 1000, 0.1, 500, 20; ... + 'bending102', 102, [70 4 3], 150, 0.5, 75, 10}; cases = repmat(shared, size(specs, 1), 1); for k = 1:size(specs, 1) diff --git a/tests/unit/TestEnergies.m b/tests/unit/TestEnergies.m new file mode 100644 index 0000000..9fc139a --- /dev/null +++ b/tests/unit/TestEnergies.m @@ -0,0 +1,98 @@ +classdef TestEnergies < LdemTestCase + %TESTENERGIES Unit tests of ldem.solver.computeEnergies with hand-made states. + + methods (Access = private) + function [mesh, barProps, history, state, params] = oneBar(~) + % One bar of length 1 between two nodes of mass 2 kg and 3 kg. + params = ldem.Parameters(); + mesh = struct('nodes0', [0 0 0; 1 0 0], 'bars', [1 2], 'barLength', 1, ... + 'mass', [2; 3], 'fixed', false(2, 3)); + barProps = struct('stiffness', 100, 'criticalStrain', 1e-3, ... + 'ruptureRatio', 5, 'ruptureStrain', 5e-3); + history = struct('tensionStiffness', 100, 'maxStrain', 1e-3, ... + 'isUndamaged', true, 'isUnbroken', true); + state = ldem.solver.initialState(mesh, history); + end + end + + methods (Test, TestTags = {'Unit'}) + function everythingIsZeroAtRest(testCase) + [mesh, barProps, ~, state, params] = testCase.oneBar(); + e = ldem.solver.computeEnergies(state, mesh, barProps, params); + for name = {'kinetic', 'elastic', 'damage', 'damping', 'internal', 'brokenBars', 'damageRate'} + testCase.verifyEqual(e.(name{1}), 0, name{1}); + end + end + + function kineticEnergyIsHalfMassTimesSpeedSquared(testCase) + [mesh, barProps, ~, state, params] = testCase.oneBar(); + state.velocity = [3 4 0; 0 0 2]; % speeds 5 and 2 + e = ldem.solver.computeEnergies(state, mesh, barProps, params); + testCase.verifyEqual(e.kinetic, 0.5 * 2 * 25 + 0.5 * 3 * 4, 'RelTol', 1e-14); + end + + function elasticEnergyOfATensionedBar(testCase) + [mesh, barProps, ~, state, params] = testCase.oneBar(); + state.strain = 5e-4; + e = ldem.solver.computeEnergies(state, mesh, barProps, params); + testCase.verifyEqual(e.elastic, 0.5 * 100 * (5e-4)^2 * 1, 'RelTol', 1e-14); + end + + function elasticEnergyOfACompressedBarUsesTheCompressionStiffness(testCase) + [mesh, barProps, ~, state, params] = testCase.oneBar(); + state.history.tensionStiffness = 10; % damaged in tension + state.strain = -5e-4; + e = ldem.solver.computeEnergies(state, mesh, barProps, params); + testCase.verifyEqual(e.elastic, 0.5 * 100 * (5e-4)^2, 'RelTol', 1e-14); + end + + function damageEnergyOfASofteningBar(testCase) + % Bar loaded to strain 2e-3 on the softening branch (see TestBilinearLaw): + % work 1.375e-4 minus stored energy 7.5e-5. + [mesh, barProps, ~, state, params] = testCase.oneBar(); + state.strain = 2e-3; + state.history.tensionStiffness = 37.5; + state.history.maxStrain = 2e-3; + state.history.isUndamaged = false; + e = ldem.solver.computeEnergies(state, mesh, barProps, params); + testCase.verifyEqual(e.damage, 6.25e-5, 'RelTol', 1e-12); + testCase.verifyEqual(e.elastic, 0.5 * 37.5 * (2e-3)^2, 'RelTol', 1e-12); + testCase.verifyEqual(e.brokenBars, 0); + end + + function brokenBarDissipatesTheWholeFractureEnergy(testCase) + % Area under the whole softening curve: E1*EP*ER/2 per unit length. + [mesh, barProps, ~, state, params] = testCase.oneBar(); + state.strain = 6e-3; + state.history.tensionStiffness = 0; + state.history.maxStrain = 5e-3; % ER + state.history.isUndamaged = false; + state.history.isUnbroken = false; + e = ldem.solver.computeEnergies(state, mesh, barProps, params); + expected = 0.5 * 100 * 1e-3 * 5e-3; + testCase.verifyEqual(e.damage, expected, 'RelTol', 1e-12); + testCase.verifyEqual(e.brokenBars, expected, 'RelTol', 1e-12); + end + + function internalEnergyIsTheSumOfItsParts(testCase) + [mesh, barProps, ~, state, params] = testCase.oneBar(); + state.velocity = [1 0 0; 0 0 0]; + state.strain = 5e-4; + state.dampingEnergy = 0.25; + e = ldem.solver.computeEnergies(state, mesh, barProps, params); + testCase.verifyEqual(e.internal, e.kinetic + e.elastic + e.damage + 0.25, 'RelTol', 1e-14); + testCase.verifyEqual(e.damping, 0.25); + end + + function damageRateUsesThePreviousStep(testCase) + [mesh, barProps, ~, state, params] = testCase.oneBar(); + state.strain = 2e-3; + state.history.tensionStiffness = 37.5; + state.history.maxStrain = 2e-3; + state.history.isUndamaged = false; + state.previousDamageEnergy = 6.25e-5 - 1e-6; + e = ldem.solver.computeEnergies(state, mesh, barProps, params); + testCase.verifyEqual(e.damageRate, 1e-6 / params.dt, 'RelTol', 1e-6); + end + end +end diff --git a/tests/unit/TestExamples.m b/tests/unit/TestExamples.m new file mode 100644 index 0000000..17bbc88 --- /dev/null +++ b/tests/unit/TestExamples.m @@ -0,0 +1,57 @@ +classdef TestExamples < LdemTestCase + %TESTEXAMPLES The example scripts run and produce their files. + % + % The tension example is run completely. The beam example has about + % 167,000 nodes and 1.1 million bars, so its test only builds the model + % (reading DATA0.DAT and the random field) without integrating; it is + % tagged "Slow". + + methods (Test, TestTags = {'Unit'}) + function tensionExampleRunsAndWritesItsFiles(testCase) + folder = string(testCase.applyFixture( ... + matlab.unittest.fixtures.TemporaryFolderFixture).Folder); + script = fullfile(testCase.RepoRoot, 'examples', 'tension_101', 'runTension.m'); + testCase.assertTrue(isfile(script)); + testCase.addTeardown(@() close('all', 'hidden')); + + output = runScript(script, fullfile(folder, "output")); + + testCase.verifySubstring(output, 'bars'); + for name = ["results.mat", "snapshots.pvd", "snapshot_0000.mac", ... + "snapshot_0004.mac", "snapshot_0000.vtu", "snapshot_0004.vtu"] + testCase.verifyTrue(isfile(fullfile(folder, "output", name)), name + " is missing."); + end + + data = load(fullfile(folder, "output", "results.mat")); + counts = data.results.snapshots.barCounts(end, :); + testCase.verifyGreaterThan(counts(2) + counts(3), 0, ... + 'The example is meant to show damage, but no bar softened.'); + end + end + + methods (Test, TestTags = {'Slow'}) + function beamExampleModelIsBuiltFromItsInputFile(testCase) + here = fullfile(testCase.RepoRoot, 'examples', 'beam_102'); + params = ldem.Parameters.fromFile(fullfile(here, 'DATA0.DAT'), ... + randomFieldFile = fullfile(here, 'arquivo_3lc_rnao_cv05')); + mesh = ldem.mesh.buildMesh(params); + [barProps, history] = ldem.material.buildBarProperties(mesh, params); + + nBars = size(mesh.bars, 1); + testCase.verifyEqual(size(mesh.nodes0, 1), params.nNodes); + testCase.verifyLessThanOrEqual(nBars, 1126960, ... + 'The random field file has one value per bar.'); + testCase.verifySize(barProps.criticalStrain, [nBars 1]); + testCase.verifyGreaterThan(barProps.criticalStrainCv, 0); + testCase.verifyTrue(all(history.isUnbroken)); + testCase.verifyGreaterThan(nnz(mesh.fixed), 0); + end + end +end + +function output = runScript(script, outputFolder) %#ok +%RUNSCRIPT Run an example script with "outputFolder" defined, capturing its text. +% The examples use outputFolder when it exists in the workspace they run in, +% which here is the workspace of this function. +output = evalc('run(script)'); +end diff --git a/tests/unit/TestExporters.m b/tests/unit/TestExporters.m new file mode 100644 index 0000000..6eaebc8 --- /dev/null +++ b/tests/unit/TestExporters.m @@ -0,0 +1,218 @@ +classdef TestExporters < LdemTestCase + %TESTEXPORTERS Unit tests of the ANSYS and VTK exporters and SnapshotWriter. + + properties + Params + Mesh + State + end + + methods (TestMethodSetup) + function buildSmallState(testCase) + % A small model advanced far enough to have damaged and broken bars. + params = ldem.Parameters(nModules=[4 3 3], totalTime=2e-4, fractureEnergy=0.1); + mesh = ldem.mesh.buildMesh(params); + [barProps, history] = ldem.material.buildBarProperties(mesh, params); + scenario = ldem.scenarios.fromTestId(params.testId); + params.validate(); + state = ldem.solver.simulate(params, mesh, barProps, history, scenario); + testCase.Params = params; + testCase.Mesh = mesh; + testCase.State = state; + end + + function makeSureSomeBarsAreDamaged(testCase) + h = testCase.State.history; + testCase.assumeTrue(any(~h.isUndamaged), ... + 'The test state must contain damaged bars to be meaningful.'); + end + end + + methods (Access = private) + function folder = tempFolder(testCase) + folder = string(testCase.applyFixture( ... + matlab.unittest.fixtures.TemporaryFolderFixture).Folder); + end + end + + methods (Test, TestTags = {'Unit'}) + function ansysFileHasTheExpectedStructure(testCase) + path = fullfile(testCase.tempFolder(), "state.mac"); + counts = ldem.io.exportAnsys(path, testCase.Mesh, testCase.State); + lines = splitlines(string(fileread(path))); + nNodes = size(testCase.Mesh.nodes0, 1); + nBars = size(testCase.Mesh.bars, 1); + + testCase.verifyEqual(nnz(startsWith(lines, "N,")), nNodes); + testCase.verifyEqual(nnz(startsWith(lines, "E,")), nBars); + testCase.verifyEqual(nnz(startsWith(lines, "TYPE,")), nBars); + testCase.verifyEqual(counts.intact + counts.damaged + counts.broken, nBars); + testCase.verifyEqual(counts.intact, nnz(testCase.State.history.isUndamaged)); + testCase.verifyEqual(counts.broken, nnz(~testCase.State.history.isUnbroken)); + testCase.verifyGreaterThan(counts.damaged + counts.broken, 0); + testCase.verifyTrue(any(lines == sprintf("!BARRAS ROMPIDAS = %d", counts.broken))); + testCase.verifyTrue(startsWith(lines(1), "!ARQUIVO NO TEMPO = ")); + testCase.verifyFalse(any(contains(lines, "IFILE")), 'The invalid ET,IFILE,4 line must not appear.'); + testCase.verifyTrue(any(lines == "ET,3,4")); + end + + function ansysConstraintsListTheFixedDofs(testCase) + path = fullfile(testCase.tempFolder(), "state.mac"); + ldem.io.exportAnsys(path, testCase.Mesh, testCase.State); + lines = splitlines(string(fileread(path))); + constraints = lines(startsWith(lines, "D,")); + testCase.verifyEqual(numel(constraints), nnz(testCase.Mesh.fixed)); + testCase.verifyTrue(all(endsWith(constraints, "UX")), 'Tension fixes x only.'); + end + + function ansysCoordinatesAreTheCurrentPositions(testCase) + path = fullfile(testCase.tempFolder(), "state.mac"); + ldem.io.exportAnsys(path, testCase.Mesh, testCase.State); + lines = splitlines(string(fileread(path))); + node = split(lines(find(startsWith(lines, "N,"), 1, 'last')), ","); + last = size(testCase.State.displacement, 1); + testCase.verifyEqual(str2double(node(2)), last); + testCase.verifyEqual(str2double(node(3:5)).', ... + double(single(testCase.State.displacement(last, :))), 'RelTol', 1e-5); + end + + function ansysCannotWriteToAnInvalidPath(testCase) + testCase.verifyError( ... + @() ldem.io.exportAnsys(fullfile(testCase.tempFolder(), "missing", "x.mac"), ... + testCase.Mesh, testCase.State), 'ldem:io:cannotOpenFile'); + end + + function vtkFileIsValidXml(testCase) + path = fullfile(testCase.tempFolder(), "state.vtu"); + ldem.io.exportVtk(path, testCase.Mesh, testCase.State); + + doc = xmlread(char(path)); + nNodes = size(testCase.Mesh.nodes0, 1); + nBars = size(testCase.Mesh.bars, 1); + + piece = doc.getElementsByTagName('Piece').item(0); + testCase.verifyEqual(double(string(piece.getAttribute('NumberOfPoints'))), nNodes); + testCase.verifyEqual(double(string(piece.getAttribute('NumberOfCells'))), nBars); + + arrays = doc.getElementsByTagName('DataArray'); + names = strings(arrays.getLength(), 1); + for k = 1:numel(names) + names(k) = string(arrays.item(k - 1).getAttribute('Name')); + end + for expected = ["displacement", "velocity", "damageState", "strain", ... + "axialForce", "barType", "position", "connectivity", "offsets", "types"] + testCase.verifyTrue(any(names == expected), "Missing array " + expected); + end + end + + function vtkArraysHaveTheRightNumberOfValues(testCase) + path = fullfile(testCase.tempFolder(), "state.vtu"); + ldem.io.exportVtk(path, testCase.Mesh, testCase.State); + doc = xmlread(char(path)); + nNodes = size(testCase.Mesh.nodes0, 1); + nBars = size(testCase.Mesh.bars, 1); + + expected = dictionary("position", 3 * nNodes, "displacement", 3 * nNodes, ... + "velocity", 3 * nNodes, "connectivity", 2 * nBars, "offsets", nBars, ... + "types", nBars, "damageState", nBars, "strain", nBars, "axialForce", nBars); + arrays = doc.getElementsByTagName('DataArray'); + for k = 0:arrays.getLength() - 1 + node = arrays.item(k); + name = string(node.getAttribute('Name')); + if isKey(expected, name) + values = sscanf(char(node.getTextContent()), '%f'); + testCase.verifyEqual(numel(values), expected(name), "Wrong size of " + name); + end + end + end + + function vtkConnectivityIsZeroBasedAndOffsetsAreCumulative(testCase) + path = fullfile(testCase.tempFolder(), "state.vtu"); + ldem.io.exportVtk(path, testCase.Mesh, testCase.State); + doc = xmlread(char(path)); + arrays = doc.getElementsByTagName('DataArray'); + data = struct(); + for k = 0:arrays.getLength() - 1 + node = arrays.item(k); + data.(char(node.getAttribute('Name'))) = sscanf(char(node.getTextContent()), '%f'); + end + testCase.verifyEqual(reshape(data.connectivity, 2, []).', testCase.Mesh.bars - 1); + testCase.verifyEqual(data.offsets, 2 * (1:size(testCase.Mesh.bars, 1)).'); + testCase.verifyTrue(all(data.types == 3), 'Every cell must be a VTK_LINE (3).'); + end + + function vtkDamageStateMatchesTheBars(testCase) + path = fullfile(testCase.tempFolder(), "state.vtu"); + ldem.io.exportVtk(path, testCase.Mesh, testCase.State); + doc = xmlread(char(path)); + arrays = doc.getElementsByTagName('DataArray'); + for k = 0:arrays.getLength() - 1 + if string(arrays.item(k).getAttribute('Name')) == "damageState" + values = sscanf(char(arrays.item(k).getTextContent()), '%d'); + end + end + h = testCase.State.history; + testCase.verifyEqual(nnz(values == 0), nnz(h.isUndamaged)); + testCase.verifyEqual(nnz(values == 2), nnz(~h.isUnbroken)); + testCase.verifyEqual(nnz(values == 1), nnz(~h.isUndamaged & h.isUnbroken)); + end + + function pvdListsTheFilesWithTheirTimes(testCase) + path = fullfile(testCase.tempFolder(), "series.pvd"); + ldem.io.writePvd(path, [0; 1e-4; 2e-4], ["a.vtu"; "b.vtu"; "c.vtu"]); + doc = xmlread(char(path)); + items = doc.getElementsByTagName('DataSet'); + testCase.verifyEqual(items.getLength(), 3); + testCase.verifyEqual(string(items.item(1).getAttribute('file')), "b.vtu"); + testCase.verifyEqual(str2double(string(items.item(2).getAttribute('timestep'))), 2e-4); + end + + function pvdRejectsMismatchedInputs(testCase) + testCase.verifyError( ... + @() ldem.io.writePvd(fullfile(testCase.tempFolder(), "x.pvd"), [0; 1], "a.vtu"), ... + 'ldem:io:sizeMismatch'); + end + + function snapshotWriterWritesFilesAndACollection(testCase) + folder = fullfile(testCase.tempFolder(), "out"); + writer = ldem.io.SnapshotWriter(testCase.Mesh, folder, ["ansys" "vtk"]); + writer.write(testCase.State); + later = testCase.State; + later.step = 10; + later.time = 2e-6; + writer.write(later); + snapshots = writer.finish(); + + for name = ["snapshot_0000.mac", "snapshot_0001.mac", "snapshot_0000.vtu", ... + "snapshot_0001.vtu", "snapshots.pvd"] + testCase.verifyTrue(isfile(fullfile(folder, name)), name + " was not written."); + end + testCase.verifyEqual(snapshots.step, [testCase.State.step; 10]); + testCase.verifySize(snapshots.barCounts, [2 3]); + testCase.verifyEqual(sum(snapshots.barCounts, 2), repmat(size(testCase.Mesh.bars, 1), 2, 1)); + testCase.verifyClass(snapshots.displacement{1}, 'single'); + testCase.verifyClass(snapshots.damageState{1}, 'uint8'); + end + + function snapshotWriterKeepsSnapshotsInMemoryWithoutFiles(testCase) + writer = ldem.io.SnapshotWriter(testCase.Mesh); + writer.write(testCase.State); + snapshots = writer.finish(); + testCase.verifyEqual(numel(snapshots.time), 1); + testCase.verifyEqual(sum(snapshots.barCounts), size(testCase.Mesh.bars, 1)); + end + + function snapshotWriterNeedsAFolderToExport(testCase) + testCase.verifyError(@() ldem.io.SnapshotWriter(testCase.Mesh, "", "vtk"), ... + 'ldem:io:noFolder'); + end + + function saveResultsRoundTrip(testCase) + results = struct('a', magic(3), 'nested', struct('b', "text", 'c', {{1, 'x'}})); + path = fullfile(testCase.tempFolder(), "sub", "results.mat"); + ldem.io.saveResults(path, results); + loaded = load(path); + testCase.verifyEqual(loaded.results, results); + end + end +end diff --git a/tests/unit/TestRunSimulation.m b/tests/unit/TestRunSimulation.m new file mode 100644 index 0000000..50fecac --- /dev/null +++ b/tests/unit/TestRunSimulation.m @@ -0,0 +1,196 @@ +classdef TestRunSimulation < LdemTestCase + %TESTRUNSIMULATION End-to-end tests of ldem.runSimulation and the post-processing. + + methods (Access = private) + function params = quickParams(~, output) + % A 100-step model on a small prism; output: how often to store results. + if nargin < 2 + output = struct('snapshotEvery', 25, 'controlNodesEvery', 10, ... + 'energyEvery', 10, 'trackedBarEvery', 0); + end + params = ldem.Parameters(nModules=[4 3 3], totalTime=2e-5, output=output); + end + + function folder = tempFolder(testCase) + folder = string(testCase.applyFixture( ... + matlab.unittest.fixtures.TemporaryFolderFixture).Folder); + end + end + + methods (Test, TestTags = {'Unit'}) + function resultsHaveAllTheDocumentedParts(testCase) + results = ldem.runSimulation(testCase.quickParams()); + for name = ["info", "params", "mesh", "barProps", "controlNodes", "reactions", ... + "energy", "trackedBar", "snapshots", "final"] + testCase.verifyTrue(isfield(results, name), "Missing results." + name); + end + testCase.verifyEqual(results.info.version, ldem.version()); + testCase.verifyGreaterThan(results.info.elapsedSeconds, 0); + testCase.verifyEqual(results.params.nSteps, 100); + testCase.verifyEqual(results.final.step, 100); + testCase.verifySize(results.controlNodes.time, [10 1]); + testCase.verifySize(results.energy.time, [10 1]); + testCase.verifyEqual(numel(results.snapshots.time), 5); % 0, 25, 50, 75, 100 + testCase.verifyEqual(results.snapshots.step, (0:25:100).'); + end + + function resultsContainNoObjectsSoTheyLoadWithoutThePackage(testCase) + results = ldem.runSimulation(testCase.quickParams()); + testCase.verifyFalse(containsObject(results), ... + 'results must not hold ldem class instances.'); + end + + function energyPartsAddUp(testCase) + results = ldem.runSimulation(testCase.quickParams()); + e = results.energy; + testCase.verifyEqual(e.internal, e.kinetic + e.elastic + e.damage + e.damping, 'RelTol', 1e-12); + testCase.verifyGreaterThan(max(e.kinetic), 0); + end + + function nothingIsWrittenWithoutAnOutputFolder(testCase) + folder = testCase.tempFolder(); + oldFolder = cd(folder); + restore = onCleanup(@() cd(oldFolder)); + ldem.runSimulation(testCase.quickParams(), Formats=["mat" "ansys" "vtk"]); + listing = dir(folder); + testCase.verifyEqual(nnz(~[listing.isdir]), 0); + end + + function outputFilesAreWrittenForTheRequestedFormats(testCase) + folder = fullfile(testCase.tempFolder(), "run"); + results = ldem.runSimulation(testCase.quickParams(), OutputFolder=folder, ... + Formats=["mat" "ansys" "vtk"]); + + testCase.verifyTrue(isfile(fullfile(folder, "results.mat"))); + testCase.verifyTrue(isfile(fullfile(folder, "snapshots.pvd"))); + for k = 0:4 + testCase.verifyTrue(isfile(fullfile(folder, sprintf('snapshot_%04d.mac', k)))); + testCase.verifyTrue(isfile(fullfile(folder, sprintf('snapshot_%04d.vtu', k)))); + end + loaded = load(fullfile(folder, "results.mat")); + testCase.verifyEqual(loaded.results.final.displacement, results.final.displacement); + testCase.verifyEqual(loaded.results.energy.kinetic, results.energy.kinetic); + testCase.verifyEqual(loaded.results.params.nSteps, 100); + end + + function onlyTheRequestedFormatsAreWritten(testCase) + folder = fullfile(testCase.tempFolder(), "run"); + ldem.runSimulation(testCase.quickParams(), OutputFolder=folder, Formats="vtk"); + testCase.verifyTrue(isfile(fullfile(folder, "snapshot_0000.vtu"))); + testCase.verifyFalse(isfile(fullfile(folder, "snapshot_0000.mac"))); + testCase.verifyFalse(isfile(fullfile(folder, "results.mat"))); + end + + function snapshotFormatsWithoutSnapshotStepsWarn(testCase) + params = ldem.Parameters(nModules=[3 3 3], totalTime=2e-6); % snapshotEvery = 0 + folder = fullfile(testCase.tempFolder(), "run"); + testCase.verifyWarning( ... + @() ldem.runSimulation(params, OutputFolder=folder, Formats="vtk"), ... + 'ldem:output:noSnapshots'); + testCase.verifyFalse(isfile(fullfile(folder, "snapshot_0000.vtu"))); + end + + function unknownFormatIsRejected(testCase) + testCase.verifyError(@() ldem.runSimulation(ldem.Parameters(), Formats="docx"), ?MException); + end + + function invalidParametersAreCaughtBeforeRunning(testCase) + params = ldem.Parameters(); + params.dt = 1e-5; % unstable, set after construction + testCase.verifyError(@() ldem.runSimulation(params), 'ldem:params:unstableTimeStep'); + end + + function aCustomScenarioIsUsed(testCase) + params = testCase.quickParams(); + still = ldem.scenarios.UniaxialTension(loadingVelocity=0); + results = ldem.runSimulation(params, Scenario=still); + testCase.verifyEqual(max(abs(results.final.velocity), [], 'all'), 0); + testCase.verifyEqual(results.final.displacement, results.mesh.nodes0); + end + + function runsAreDeterministic(testCase) + a = ldem.runSimulation(testCase.quickParams()); + b = ldem.runSimulation(testCase.quickParams()); + testCase.verifyEqual(a.final, b.final); + testCase.verifyEqual(a.energy, b.energy); + end + + function aRunFromAnInputFileMatchesTheEquivalentParameters(testCase) + testsDir = fullfile(testCase.RepoRoot, 'tests', 'tools'); + testCase.applyFixture(matlab.unittest.fixtures.PathFixture(testsDir)); + cases = referenceCases(); + c = cases(strcmp({cases.name}, 'tension101_elastic')); + path = fullfile(testCase.tempFolder(), "DATA0.DAT"); + writeDataFile(path, c); + + fromFile = ldem.runSimulation(ldem.Parameters.fromFile(path)); + direct = ldem.runSimulation(ldem.Parameters( ... + testId = c.test, seed = c.seed, moduleLength = c.moduleLength, ... + nModules = c.modules, dampingInitial = c.damping1, dampingFinal = c.damping2, ... + dampingSwitchTime = c.dampingSwitchTime, constitutiveDamping = c.con, ... + dt = c.dt, totalTime = c.nSteps * c.dt, controlNodes = c.controlNodes, ... + youngModulus = c.youngModulus, density = c.density, poissonRatio = c.poisson, ... + fractureEnergy = c.fractureEnergy, criticalDistance = c.criticalDistance, ... + output = struct('snapshotEvery', c.ansysEvery, 'controlNodesEvery', c.everyN, ... + 'energyEvery', c.everyN, 'trackedBarEvery', 1))); + testCase.verifyEqual(fromFile.final.displacement, direct.final.displacement); + testCase.verifyEqual(fromFile.energy.kinetic, direct.energy.kinetic); + end + + function plotEnergyDrawsFiveCurves(testCase) + results = ldem.runSimulation(testCase.quickParams()); + fig = figure('Visible', 'off'); + testCase.addTeardown(@close, fig); + ax = ldem.post.plotEnergy(results, axes(fig)); + testCase.verifyEqual(numel(ax.Children), 5); + testCase.verifyEqual(ax.XLabel.String, 'Time [s]'); + end + + function plotEnergyNeedsAnEnergyHistory(testCase) + params = testCase.quickParams(struct('snapshotEvery', 0, ... + 'controlNodesEvery', 0, 'energyEvery', 0, 'trackedBarEvery', 0)); + results = ldem.runSimulation(params); + testCase.verifyError(@() ldem.post.plotEnergy(results), 'ldem:post:noData'); + end + + function plotReactionShowsTheBeamReaction(testCase) + params = ldem.Parameters(testId=102, nModules=[70 4 3], totalTime=2e-6, ... + output=struct('snapshotEvery', 0, 'controlNodesEvery', 2, ... + 'energyEvery', 0, 'trackedBarEvery', 0)); + results = ldem.runSimulation(params); + fig = figure('Visible', 'off'); + testCase.addTeardown(@close, fig); + ax = ldem.post.plotReaction(results, axes(fig)); + testCase.verifyEqual(numel(ax.Children), 1); % only Ry is defined + end + + function plotReactionIsNotAvailableForTension(testCase) + results = ldem.runSimulation(testCase.quickParams()); + testCase.verifyError(@() ldem.post.plotReaction(results), 'ldem:post:noData'); + end + end +end + +function tf = containsObject(value) +%CONTAINSOBJECT True if a struct tree holds an instance of a class of the ldem package. +tf = false; +if isstruct(value) + for element = value(:).' + for name = fieldnames(element).' + if containsObject(element.(name{1})) + tf = true; + return + end + end + end +elseif iscell(value) + for k = 1:numel(value) + if containsObject(value{k}) + tf = true; + return + end + end +else + tf = startsWith(string(class(value)), "ldem."); +end +end diff --git a/tests/unit/TestSimulate.m b/tests/unit/TestSimulate.m new file mode 100644 index 0000000..66d557f --- /dev/null +++ b/tests/unit/TestSimulate.m @@ -0,0 +1,177 @@ +classdef TestSimulate < LdemTestCase + %TESTSIMULATE Unit tests of the scenario loads and of ldem.solver.simulate. + + methods (Access = private) + function [params, mesh, barProps, history, scenario] = smallModel(~, varargin) + params = ldem.Parameters(varargin{:}); + mesh = ldem.mesh.buildMesh(params); + [barProps, history] = ldem.material.buildBarProperties(mesh, params); + scenario = ldem.scenarios.fromTestId(params.testId); + end + end + + methods (Test, TestTags = {'Unit'}) + function tensionLoadMovesTheLastColumnOfCentreNodes(testCase) + [params, mesh, ~, history, scenario] = testCase.smallModel(testId=101); + state = ldem.solver.initialState(mesh, history); + state.time = 1e-4; + state = scenario.applyLoads(state, mesh, params); + + loaded = scenario.loadedNodes(mesh.nodes0, params); + testCase.verifyEqual(nnz(loaded), (params.nModules(2) - 1) * (params.nModules(3) - 1)); + testCase.verifyEqual(state.displacement(loaded, 1), ... + mesh.nodes0(loaded, 1) - 400e-5 * 1e-4, 'RelTol', 1e-14); + % Everything else is untouched, and y, z of the loaded nodes too. + testCase.verifyEqual(state.displacement(~loaded, :), mesh.nodes0(~loaded, :)); + testCase.verifyEqual(state.displacement(loaded, 2:3), mesh.nodes0(loaded, 2:3)); + end + + function loadingVelocityCanBeChanged(testCase) + [params, mesh, ~, history, ~] = testCase.smallModel(testId=101); + scenario = ldem.scenarios.UniaxialTension(loadingVelocity=-1e-3); + state = ldem.solver.initialState(mesh, history); + state.time = 2e-4; + state = scenario.applyLoads(state, mesh, params); + loaded = scenario.loadedNodes(mesh.nodes0, params); + % Negative velocity pulls the loaded nodes away from the fixed end. + testCase.verifyGreaterThan(min(state.displacement(loaded, 1) - mesh.nodes0(loaded, 1)), 0); + end + + function bendingLoadMovesOnlyTheRightLoadPoint(testCase) + [params, mesh, ~, history, scenario] = testCase.smallModel(testId=102, nModules=[70 4 3]); + state = ldem.solver.initialState(mesh, history); + state.time = 1e-4; + state = scenario.applyLoads(state, mesh, params); + + loaded = scenario.loadedNodes(mesh.nodes0, params); + testCase.verifyEqual(nnz(loaded), params.nModules(3) - 1); + testCase.verifyEqual(state.displacement(loaded, 2), ... + mesh.nodes0(loaded, 2) - 400e-5 * 1e-4, 'RelTol', 1e-14); + testCase.verifyTrue(all(mesh.fixed(loaded, 2)), 'Loaded nodes must be held in y.'); + testCase.verifyEqual(state.displacement(~loaded, :), mesh.nodes0(~loaded, :)); + end + + function reactionIsUndefinedForTensionAndSummedForBending(testCase) + [params, mesh, ~, history, tension] = testCase.smallModel(testId=101); + state = ldem.solver.initialState(mesh, history); + testCase.verifyTrue(all(isnan(tension.reactions(state, mesh, params)))); + + [params, mesh, ~, history, bending] = testCase.smallModel(testId=102, nModules=[70 4 3]); + state = ldem.solver.initialState(mesh, history); + atTop = mesh.fixed(:, 2) & mesh.nodes0(:, 2) >= params.moduleLength * (params.nModules(2) - 1.51); + state.force(atTop, 2) = 1.5; + r = bending.reactions(state, mesh, params); + testCase.verifyEqual(r, [0, 1.5 * nnz(atTop), 0]); + end + + function simulateStoresTheRequestedResults(testCase) + [params, mesh, barProps, history, scenario] = testCase.smallModel( ... + nModules=[4 3 3], totalTime=4e-6, controlNodes=[1 2 3], ... + output=struct('snapshotEvery', 0, 'controlNodesEvery', 4, ... + 'energyEvery', 5, 'trackedBarEvery', 0)); + [state, record] = ldem.solver.simulate(params, mesh, barProps, history, scenario); + + testCase.verifyEqual(state.step, 20); + testCase.verifyEqual(state.time, 20 * params.dt, 'RelTol', 1e-12); + testCase.verifySize(record.controlNodes.time, [5 1]); + testCase.verifySize(record.controlNodes.displacement, [5 3 3]); + testCase.verifySize(record.controlNodes.acceleration, [5 3 3]); + testCase.verifySize(record.reactions.force, [5 3]); + testCase.verifySize(record.energy.time, [4 1]); + testCase.verifyEqual(record.controlNodes.time, (4:4:20).' * params.dt, 'RelTol', 1e-12); + testCase.verifyEqual(record.energy.time, (5:5:20).' * params.dt, 'RelTol', 1e-12); + testCase.verifyEmpty(record.trackedBar.time); + testCase.verifyEqual(record.controlNodes.displacement(end, :, :), ... + reshape(state.displacement(params.controlNodes, :), 1, 3, 3)); + end + + function simulateRecordsTheTrackedBarAtEveryStep(testCase) + [params, mesh, barProps, history, scenario] = testCase.smallModel( ... + nModules=[4 3 3], totalTime=2e-6, trackedBar=5, ... + output=struct('snapshotEvery', 0, 'controlNodesEvery', 0, ... + 'energyEvery', 0, 'trackedBarEvery', 1)); + [state, record] = ldem.solver.simulate(params, mesh, barProps, history, scenario); + + testCase.verifySize(record.trackedBar.time, [10 1]); + testCase.verifyEqual(record.trackedBar.bar, 5); + testCase.verifyEqual(record.trackedBar.strain(end), state.strain(5)); + testCase.verifyEqual(record.trackedBar.force(end), state.axialForce(5)); + testCase.verifyEqual(record.trackedBar.criticalStrain(1), barProps.criticalStrain(5)); + testCase.verifyEmpty(record.controlNodes.time); + testCase.verifyEmpty(record.energy.time); + end + + function aTrackedBarThatDoesNotExistIsIgnored(testCase) + [params, mesh, barProps, history, scenario] = testCase.smallModel( ... + nModules=[3 3 3], totalTime=1e-6, trackedBar=999999, ... + output=struct('snapshotEvery', 0, 'controlNodesEvery', 0, ... + 'energyEvery', 0, 'trackedBarEvery', 1)); + [~, record] = ldem.solver.simulate(params, mesh, barProps, history, scenario); + testCase.verifyEmpty(record.trackedBar.time); + end + + function snapshotFunctionIsCalledAtTimeZeroAndPeriodically(testCase) + [params, mesh, barProps, history, scenario] = testCase.smallModel( ... + nModules=[3 3 3], totalTime=4e-6, ... + output=struct('snapshotEvery', 5, 'controlNodesEvery', 0, ... + 'energyEvery', 0, 'trackedBarEvery', 0)); + snapshotLog("reset"); + ldem.solver.simulate(params, mesh, barProps, history, scenario, ... + SnapshotFcn=@(state) snapshotLog("add", state)); + steps = snapshotLog("read"); + testCase.verifyEqual(steps, [0 5 10 15 20]); + end + + function simulateIsDeterministic(testCase) + [params, mesh, barProps, history, scenario] = testCase.smallModel(nModules=[4 3 3], totalTime=4e-6); + a = ldem.solver.simulate(params, mesh, barProps, history, scenario); + b = ldem.solver.simulate(params, mesh, barProps, history, scenario); + testCase.verifyEqual(a.displacement, b.displacement); + testCase.verifyEqual(a.force, b.force); + end + + function loadedModelDeformsAndStaysFinite(testCase) + [params, mesh, barProps, history, scenario] = testCase.smallModel(nModules=[6 3 3], totalTime=2e-5); + state = ldem.solver.simulate(params, mesh, barProps, history, scenario); + testCase.verifyTrue(all(isfinite(state.displacement), 'all')); + testCase.verifyGreaterThan(max(abs(state.velocity), [], 'all'), 0); + % Free nodes move too, not only the loaded ones (the equation of motion is integrated). + moved = any(state.displacement ~= mesh.nodes0, 2) & ~scenario.loadedNodes(mesh.nodes0, params); + testCase.verifyTrue(any(moved)); + end + + function nonFiniteResultsAreReported(testCase) + [params, mesh, barProps, history, scenario] = testCase.smallModel(nModules=[3 3 3], totalTime=1e-6); + barProps.stiffness(:) = NaN; + history.tensionStiffness(:) = NaN; + testCase.verifyError( ... + @() ldem.solver.simulate(params, mesh, barProps, history, scenario), ... + 'ldem:solver:nonFinite'); + end + + function unstableTimeStepForTheMeshIsReported(testCase) + [params, mesh, barProps, history, scenario] = testCase.smallModel(nModules=[3 3 3], totalTime=1e-6); + mesh.barLength(1) = mesh.barLength(1) / 100; % an unusually short bar + testCase.verifyError( ... + @() ldem.solver.simulate(params, mesh, barProps, history, scenario), ... + 'ldem:params:unstableTimeStep'); + end + + function verboseModePrintsProgress(testCase) + [params, mesh, barProps, history, scenario] = testCase.smallModel(nModules=[3 3 3], totalTime=2e-6); %#ok + text = evalc('ldem.solver.simulate(params, mesh, barProps, history, scenario, Verbose=true);'); + testCase.verifySubstring(text, 'step 10 / 10'); + end + end +end + +function steps = snapshotLog(command, state) +%SNAPSHOTLOG Collect the step numbers passed to a snapshot callback. +persistent log +if command == "reset" + log = []; +elseif command == "add" + log(end + 1) = state.step; +end +steps = log; +end diff --git a/tests/unit/TestSolver.m b/tests/unit/TestSolver.m new file mode 100644 index 0000000..7770ec9 --- /dev/null +++ b/tests/unit/TestSolver.m @@ -0,0 +1,236 @@ +classdef TestSolver < LdemTestCase + %TESTSOLVER Unit tests of the solver routines with analytical solutions. + % + % The main model is a single bar: node 1 is fixed and node 2 (mass m) + % moves along x. The bar force is E1*strain, so it behaves as a spring + % of constant k = E1/L and natural frequency omega = sqrt(k/m). + + properties (Constant) + E1 = 1e6 % bar stiffness [N] + L = 0.01 % bar length [m] + Mass = 0.1 % mass of the free node [kg] + Stretch = 1e-6 % initial elongation [m] + end + + methods (Access = private) + function [mesh, barProps, history] = oscillator(testCase) + mesh = struct( ... + 'nodes0', [0 0 0; testCase.L 0 0], ... + 'bars', [1 2], ... + 'barLength', testCase.L, ... + 'mass', [testCase.Mass; testCase.Mass], ... + 'fixed', [true true true; false true true]); + barProps = struct( ... + 'stiffness', testCase.E1, ... + 'criticalStrain', 1, ... + 'ruptureRatio', 10, ... + 'ruptureStrain', 10); + history = struct('tensionStiffness', testCase.E1, 'maxStrain', 1, ... + 'isUndamaged', true, 'isUnbroken', true); + end + + function omega = naturalFrequency(testCase) + omega = sqrt(testCase.E1 / testCase.L / testCase.Mass); + end + + function [x, states, params] = runOscillator(testCase, damping, nSteps) + % Release node 2 from rest at x = L + Stretch and integrate. + params = ldem.Parameters(dt=2e-7, dampingInitial=damping, dampingFinal=damping, ... + dampingSwitchTime=1); + [mesh, barProps, history] = testCase.oscillator(); + state = ldem.solver.initialState(mesh, history); + + omega = testCase.naturalFrequency(); + c = damping; + omegaD = sqrt(omega^2 - c^2 / 4); + u0 = testCase.Stretch; + % Exact position one step before time zero, for zero initial velocity. + previous = @(t) u0 * exp(-c * t / 2) * (cos(omegaD * t) + c / (2 * omegaD) * sin(omegaD * t)); + state.displacement(2, 1) = testCase.L + u0; + state.previousDisplacement(2, 1) = testCase.L + previous(-params.dt); + + x = zeros(nSteps, 1); + states = cell(nSteps, 1); + for n = 1:nSteps + state.step = n; + state.time = state.time + params.dt; + state = ldem.solver.computeBarForces(state, mesh, barProps, params); + state = ldem.solver.integrateStep(state, mesh, barProps, params); + x(n) = state.displacement(2, 1) - testCase.L; + states{n} = state; + end + end + end + + methods (Test, TestTags = {'Unit'}) + function constantForceGivesTheDiscreteParabola(testCase) + % u_n = a*dt^2*n*(n+1)/2 for the scheme started from rest. + params = ldem.Parameters(dampingInitial=0, dampingFinal=0); + mesh = struct('nodes0', [0 0 0], 'bars', zeros(0, 2), 'barLength', zeros(0, 1), ... + 'mass', 2, 'fixed', false(1, 3)); + barProps = struct('stiffness', zeros(0, 1)); + history = struct(); + state = ldem.solver.initialState(mesh, history); + force = 6; + a = force / 2; + + for n = 1:20 + state.step = n; + state.force = [force 0 0]; + state.strain = zeros(0, 1); + state.history = struct('tensionStiffness', zeros(0, 1)); + state = ldem.solver.integrateStep(state, mesh, barProps, params); + testCase.verifyEqual(state.displacement(1), a * params.dt^2 * n * (n + 1) / 2, ... + 'RelTol', 1e-12); + end + testCase.verifyEqual(state.displacement(2:3), [0 0]); + end + + function undampedOscillatorFollowsTheCosine(testCase) + nSteps = 2000; % about two periods + [x, ~, params] = testCase.runOscillator(0, nSteps); + t = (1:nSteps).' * params.dt; + expected = testCase.Stretch * cos(testCase.naturalFrequency() * t); + testCase.verifyEqual(x, expected, 'AbsTol', 1e-3 * testCase.Stretch); + end + + function dampedOscillatorDecaysAsExpected(testCase) + damping = 4000; % [1/s] + nSteps = 2500; + [x, ~, params] = testCase.runOscillator(damping, nSteps); + t = (1:nSteps).' * params.dt; + omegaD = sqrt(testCase.naturalFrequency()^2 - damping^2 / 4); + expected = testCase.Stretch * exp(-damping * t / 2) .* ... + (cos(omegaD * t) + damping / (2 * omegaD) * sin(omegaD * t)); + testCase.verifyEqual(x, expected, 'AbsTol', 1e-3 * testCase.Stretch); + testCase.verifyLessThan(abs(x(end)), 0.7 * testCase.Stretch); + end + + function energyIsConservedWithoutDamping(testCase) + nSteps = 2000; + [~, states, params] = testCase.runOscillator(0, nSteps); + [mesh, barProps, ~] = testCase.oscillator(); + initial = 0.5 * testCase.E1 / testCase.L * testCase.Stretch^2; + for n = [1 500 1000 2000] + e = ldem.solver.computeEnergies(states{n}, mesh, barProps, params); + testCase.verifyEqual(e.kinetic + e.elastic, initial, 'RelTol', 2e-3); + testCase.verifyEqual(e.damping, 0); + end + end + + function dampingEnergyBalancesTheLostEnergy(testCase) + damping = 4000; + nSteps = 2500; + [~, states, params] = testCase.runOscillator(damping, nSteps); + [mesh, barProps, ~] = testCase.oscillator(); + initial = 0.5 * testCase.E1 / testCase.L * testCase.Stretch^2; + for n = [500 1500 2500] + e = ldem.solver.computeEnergies(states{n}, mesh, barProps, params); + testCase.verifyEqual(e.kinetic + e.elastic + e.damping, initial, 'RelTol', 5e-3); + end + testCase.verifyGreaterThan(e.damping, 0); + end + + function fixedDofsDoNotMove(testCase) + [~, states, ~] = testCase.runOscillator(1000, 50); + last = states{end}; + testCase.verifyEqual(last.displacement(1, :), [0 0 0]); + testCase.verifyEqual(last.displacement(2, 2:3), [0 0]); + end + + function integrateRejectsZeroMass(testCase) + params = ldem.Parameters(); + [mesh, barProps, history] = testCase.oscillator(); + mesh.mass(2) = 0; + state = ldem.solver.initialState(mesh, history); + testCase.verifyError(@() ldem.solver.integrateStep(state, mesh, barProps, params), ... + 'ldem:solver:zeroMass'); + end + + function stretchedBarPullsItsNodesTogether(testCase) + params = ldem.Parameters(); + [mesh, barProps, history] = testCase.oscillator(); + state = ldem.solver.initialState(mesh, history); + state.displacement(2, 1) = testCase.L + testCase.Stretch; + state = ldem.solver.computeBarForces(state, mesh, barProps, params); + + expectedForce = testCase.E1 * testCase.Stretch / testCase.L; + testCase.verifyEqual(state.axialForce, expectedForce, 'RelTol', 1e-9); + testCase.verifyEqual(state.force(1, :), [expectedForce 0 0], 'RelTol', 1e-9, 'AbsTol', 1e-12); + testCase.verifyEqual(state.force(2, :), [-expectedForce 0 0], 'RelTol', 1e-9, 'AbsTol', 1e-12); + end + + function compressedBarPushesItsNodesApart(testCase) + params = ldem.Parameters(); + [mesh, barProps, history] = testCase.oscillator(); + state = ldem.solver.initialState(mesh, history); + state.displacement(2, 1) = testCase.L - testCase.Stretch; + state = ldem.solver.computeBarForces(state, mesh, barProps, params); + + testCase.verifyLessThan(state.axialForce, 0); + testCase.verifyLessThan(state.force(1, 1), 0); + testCase.verifyGreaterThan(state.force(2, 1), 0); + end + + function barDirectionIsFollowedWhenItRotates(testCase) + params = ldem.Parameters(); + [mesh, barProps, history] = testCase.oscillator(); + state = ldem.solver.initialState(mesh, history); + state.displacement(2, :) = [testCase.L, 0, 0] + testCase.L * 1e-3 * [0.6 0.8 0]; + state = ldem.solver.computeBarForces(state, mesh, barProps, params); + direction = state.force(1, :) / norm(state.force(1, :)); + delta = state.displacement(2, :) - state.displacement(1, :); + testCase.verifyEqual(direction, delta / norm(delta), 'AbsTol', 1e-12); + end + + function forcesOnTheLatticeAddUpToZero(testCase) + % Internal forces are in equilibrium: Newton's third law. + params = ldem.Parameters(nModules=[4 3 3]); + mesh = ldem.mesh.buildMesh(params); + [barProps, history] = ldem.material.buildBarProperties(mesh, params); + state = ldem.solver.initialState(mesh, history); + rng(1); + state.displacement = mesh.nodes0 + 1e-6 * randn(size(mesh.nodes0)); + state = ldem.solver.computeBarForces(state, mesh, barProps, params); + + testCase.verifyGreaterThan(max(abs(state.force), [], 'all'), 0); + testCase.verifyLessThan(max(abs(sum(state.force, 1))), 1e-9 * max(abs(state.force), [], 'all')); + end + + function latticeAtRestHasNoForce(testCase) + params = ldem.Parameters(nModules=[4 3 3]); + mesh = ldem.mesh.buildMesh(params); + [barProps, history] = ldem.material.buildBarProperties(mesh, params); + state = ldem.solver.initialState(mesh, history); + state = ldem.solver.computeBarForces(state, mesh, barProps, params); + testCase.verifyEqual(state.force, zeros(size(state.force)), 'AbsTol', 1e-9); + testCase.verifyEqual(state.strain, zeros(size(state.strain)), 'AbsTol', 1e-14); + end + + function coincidentNodesAreReported(testCase) + params = ldem.Parameters(); + [mesh, barProps, history] = testCase.oscillator(); + state = ldem.solver.initialState(mesh, history); + state.displacement(2, :) = state.displacement(1, :); + testCase.verifyError(@() ldem.solver.computeBarForces(state, mesh, barProps, params), ... + 'ldem:solver:zeroLengthBar'); + end + + function dampingCoefficientSwitchesAtTheSwitchStep(testCase) + params = ldem.Parameters(dt=2e-7, dampingInitial=100, dampingFinal=50, ... + dampingSwitchTime=1e-5); % switch step 50 + testCase.verifyEqual(ldem.solver.dampingCoefficient(1, params), 100); + testCase.verifyEqual(ldem.solver.dampingCoefficient(49, params), 100); + testCase.verifyEqual(ldem.solver.dampingCoefficient(50, params), 50); + testCase.verifyEqual(ldem.solver.dampingCoefficient(500, params), 50); + end + + function dampingNeverSwitchesWhenTheSwitchStepIsZero(testCase) + % Same behaviour as the legacy code (STEP == NDAMF with NDAMF = 0). + params = ldem.Parameters(dt=2e-7, dampingInitial=100, dampingFinal=50, ... + dampingSwitchTime=0); + testCase.verifyEqual(ldem.solver.dampingCoefficient(1, params), 100); + testCase.verifyEqual(ldem.solver.dampingCoefficient(1000, params), 100); + end + end +end From 8f4a99cc02e9a4c951ceb764e98ce94beda15c0c Mon Sep 17 00:00:00 2001 From: Boris Rojo Tanzi <71112604+borisrojotanzi@users.noreply.github.com> Date: Thu, 5 Nov 2026 20:00:24 -0300 Subject: [PATCH 05/13] build: add buildtool tasks, CI workflows and developer docs --- .github/workflows/docs.yml | 10 ++- .github/workflows/tests-all.yml | 33 +++++++++ .github/workflows/tests.yml | 32 +++++++-- .gitignore | 2 + CHANGELOG.md | 5 ++ CONTRIBUTING.md | 27 ++++++-- README.md | 24 +++---- buildfile.m | 117 ++++++++++++++++++++++++++++++++ docs/source/en/installation.rst | 25 ++++++- docs/source/es/instalacion.rst | 26 ++++++- tests/unit/TestExporters.m | 12 ++++ tests/unit/TestRunSimulation.m | 14 ++++ tests/unit/TestSimulate.m | 36 ++++++++++ 13 files changed, 337 insertions(+), 26 deletions(-) create mode 100644 .github/workflows/tests-all.yml create mode 100644 buildfile.m diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml index eaeb583..ad34dd2 100644 --- a/.github/workflows/docs.yml +++ b/.github/workflows/docs.yml @@ -1,20 +1,28 @@ name: docs + on: push: branches: [main] pull_request: + permissions: contents: write + jobs: build: runs-on: ubuntu-latest steps: - uses: actions/checkout@v4 + - uses: actions/setup-python@v5 with: python-version: "3.12" + - run: pip install -r docs/requirements.txt - - run: sphinx-build -b html docs/source docs/build/html + + # -W turns warnings into errors: the documentation is warning-free. + - run: sphinx-build -W --keep-going -b html docs/source docs/build/html + - uses: peaceiris/actions-gh-pages@v4 if: github.ref == 'refs/heads/main' with: diff --git a/.github/workflows/tests-all.yml b/.github/workflows/tests-all.yml new file mode 100644 index 0000000..e7d0fd9 --- /dev/null +++ b/.github/workflows/tests-all.yml @@ -0,0 +1,33 @@ +name: tests-all + +# The slow tests start child MATLAB processes that re-run the legacy simulations +# (about 5 minutes). They are run on demand, not on every push. +on: + workflow_dispatch: + +jobs: + matlab: + name: All tests (including slow) + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v4 + + - name: Set up MATLAB + uses: matlab-actions/setup-matlab@v2 + with: + release: R2023b + + - name: Run the build (static analysis + all tests) + uses: matlab-actions/run-build@v2 + with: + tasks: check testAll + + - name: Keep the reports + if: always() + uses: actions/upload-artifact@v4 + with: + name: reports-all + path: | + test-results/ + code-coverage/ + if-no-files-found: ignore diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml index 5d772f8..c8c70f0 100644 --- a/.github/workflows/tests.yml +++ b/.github/workflows/tests.yml @@ -1,11 +1,35 @@ name: tests -on: [push, pull_request] + +on: + push: + pull_request: + jobs: matlab: + name: Code Analyzer and tests runs-on: ubuntu-latest steps: - uses: actions/checkout@v4 - - uses: matlab-actions/setup-matlab@v2 - - uses: matlab-actions/run-command@v2 + + - name: Set up MATLAB + uses: matlab-actions/setup-matlab@v2 with: - command: addpath('tests'); run_tests + # The code uses name=value arguments, the arguments block, buildtool and + # dictionary, so R2022b is the oldest release that can run it. + release: R2023b + + - name: Run the build (static analysis + fast tests with coverage) + uses: matlab-actions/run-build@v2 + with: + tasks: check test + + - name: Keep the reports + if: always() + uses: actions/upload-artifact@v4 + with: + name: reports + path: | + test-results/ + code-coverage/ + code-issues/ + if-no-files-found: ignore diff --git a/.gitignore b/.gitignore index 82aea6c..feb3eb7 100644 --- a/.gitignore +++ b/.gitignore @@ -32,3 +32,5 @@ docs/build/ docs/_build/ BARR_ROMP.dat SIM01.DAT +code-issues/ +.buildtool/ diff --git a/CHANGELOG.md b/CHANGELOG.md index c1723e4..ccbd58f 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -36,6 +36,11 @@ - `ldem.post.plotEnergy` and `ldem.post.plotReaction`; `ldem.Parameters.toStruct`. - Runnable examples: `examples/tension_101/runTension.m` and `examples/beam_102/runBeam.m`; user guides rewritten (EN/ES). +- `buildfile.m` (`buildtool`): `check` (Code Analyzer, any warning fails), `test` + (fast tests, JUnit report, Cobertura coverage), `testAll`, `docs` and `clean`. + Coverage of the `ldem` package is 99.9 %. +- CI: `tests` runs `check` and `test` on R2023b and keeps the reports; `tests-all` + (manual) also runs the slow tests; `docs` builds Sphinx with warnings as errors. - Unit tests (`tests/unit`) and a regression test that compares the new mesh with the legacy one (`tests/regression/TestMeshAgainstLegacy`). diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 4633eea..fa9c53c 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -40,18 +40,35 @@ errors with an identifier of the form `ldem::`. ## Workflow 1. Branch from `dev`. -2. Add/adjust tests in `tests/` (`Test*.m`, `matlab.unittest`). -3. Run `run_tests` in MATLAB and build the docs (`docs/`) locally. -4. Open a pull request. +2. Add or adjust tests in `tests/` (`Test*.m`, `matlab.unittest`): `tests/unit` + for new code, `tests/regression` for comparisons with the legacy results. +3. Run `buildtool` in MATLAB from the repository root. It runs the Code + Analyzer (`check`, which must report nothing) and the fast tests with + coverage (`test`). Before opening the pull request also run + `buildtool testAll` and `buildtool docs`. +4. Open a pull request. CI runs `check` and `test` on every push and builds the + documentation with warnings as errors. + +| Command | What it does | +|---------|--------------| +| `buildtool` | `check` and `test` (default) | +| `buildtool check` | Code Analyzer on `src/`, `tests/` and `examples/`; any warning fails | +| `buildtool test` | Fast tests; writes `test-results/results.xml` and `code-coverage/coverage.xml` | +| `buildtool testAll` | Also the slow tests (re-run the legacy simulations, ~5 min) | +| `buildtool docs` | Sphinx HTML in `docs/build/html` (needs Python and `docs/requirements.txt`) | +| `buildtool clean` | Delete the generated files | + +`run_tests` (in `tests/`) is a lighter alternative that only runs the tests. Files excluded from docs/tests: backups (`*.asv`) and the scratch scripts in `sandbox/`. ## Repository layout during the refactoring +- `src/+ldem/` is the `ldem` package: the refactored code. New work goes here. - `legacy/` is the **frozen** original code. Do not change its numerics: the regression tests compare the refactored code against it. Known problems are listed in `legacy/KNOWN_ISSUES.md`. - `tests/fixtures/*.mat` are golden-master results produced by the legacy code. Regenerate them only if the legacy code is changed on purpose: `addpath('tests/tools'); generateReference`. -- `run_tests` skips slow tests by default; use `run_tests(IncludeSlow=true)` - before opening a pull request. +- Slow tests (tag `Slow`) are skipped by `buildtool test` and `run_tests`; use + `buildtool testAll` or `run_tests(IncludeSlow=true)`. diff --git a/README.md b/README.md index 01b4711..0df08fa 100644 --- a/README.md +++ b/README.md @@ -32,8 +32,8 @@ quasi-brittle materials (concrete, rocks). Run the tests: ```matlab ->> addpath tests ->> run_tests +>> buildtool % static analysis + fast tests (needs R2022b or newer) +>> buildtool testAll % also the slow tests ``` ### Documentation @@ -47,8 +47,8 @@ pip install -r docs/requirements.txt sphinx-build -b html docs/source docs/build/html ``` -Source-code comments are written in Portuguese; the guides are available in -English and Spanish. See [CONTRIBUTING.md](CONTRIBUTING.md) for the docstring +Comments of the new code are written in English (the original code in `legacy/` +keeps its Portuguese comments); the guides are available in English and Spanish. See [CONTRIBUTING.md](CONTRIBUTING.md) for the docstring convention. ### Citation @@ -85,8 +85,8 @@ quase-frágeis (concreto, rochas). Executar os testes: ```matlab ->> addpath tests ->> run_tests +>> buildtool % static analysis + fast tests (needs R2022b or newer) +>> buildtool testAll % also the slow tests ``` ### Documentação @@ -99,8 +99,8 @@ pip install -r docs/requirements.txt sphinx-build -b html docs/source docs/build/html ``` -Os comentários do código estão em português; os guias estão em espanhol e -inglês. Veja [CONTRIBUTING.md](CONTRIBUTING.md) para a convenção de docstrings. +Os comentários do código novo estão em inglês (o código original em `legacy/` +mantém os comentários em português); os guias estão em espanhol e inglês. Veja [CONTRIBUTING.md](CONTRIBUTING.md) para a convenção de docstrings. ### Citação @@ -136,8 +136,8 @@ cuasi-frágiles (hormigón, rocas). Ejecutar los tests: ```matlab ->> addpath tests ->> run_tests +>> buildtool % static analysis + fast tests (needs R2022b or newer) +>> buildtool testAll % also the slow tests ``` ### Documentación @@ -150,8 +150,8 @@ pip install -r docs/requirements.txt sphinx-build -b html docs/source docs/build/html ``` -Los comentarios del código están en portugués; las guías están en español e -inglés. Ver [CONTRIBUTING.md](CONTRIBUTING.md) para la convención de docstrings. +Los comentarios del código nuevo están en inglés (el código original de `legacy/` +mantiene sus comentarios en portugués); las guías están en español e inglés. Ver [CONTRIBUTING.md](CONTRIBUTING.md) para la convención de docstrings. ### Cita diff --git a/buildfile.m b/buildfile.m new file mode 100644 index 0000000..c00ea0e --- /dev/null +++ b/buildfile.m @@ -0,0 +1,117 @@ +function plan = buildfile +%BUILDFILE Build plan of the repository, run with MATLAB's buildtool. +% +% From the repository root: +% +% >> buildtool % default: check + test +% >> buildtool check % static analysis (Code Analyzer) +% >> buildtool test % fast tests, with coverage and JUnit report +% >> buildtool testAll % also the slow tests (re-run the legacy code) +% >> buildtool docs % Sphinx documentation (needs Python) +% >> buildtool clean % remove generated files +% >> buildtool -tasks % list the tasks +% +% Tasks +% check Fails if the Code Analyzer reports any warning or error in +% src/, tests/ or examples/. +% test Runs every test not tagged "Slow", writes +% test-results/results.xml (JUnit) and code-coverage/coverage.xml +% (Cobertura) and prints the coverage of the ldem package. +% testAll Same as test but including the slow tests, which start child +% MATLAB processes (about 5 minutes). +% docs Builds the HTML documentation in docs/build/html. +% clean Deletes test-results/, code-coverage/ and docs/build/. +% +% See also run_tests, buildplan. + +import matlab.buildtool.tasks.CodeIssuesTask + +plan = buildplan(localfunctions); + +plan("check") = CodeIssuesTask(["src", "tests", "examples"], ... + IncludeSubfolders = true, ... + ErrorThreshold = 0, ... + WarningThreshold = 0, ... + Results = "code-issues/results.sarif"); + +plan("test").Dependencies = "check"; +plan("testAll").Dependencies = "check"; + +plan.DefaultTasks = ["check", "test"]; +end + +function testTask(context) +% Fast tests, coverage and JUnit report. +runTests(context, false); +end + +function testAllTask(context) +% All tests, including the slow ones. +runTests(context, true); +end + +function docsTask(context) +% Build the Sphinx documentation. +root = context.Plan.RootFolder; +source = fullfile(root, 'docs', 'source'); +target = fullfile(root, 'docs', 'build', 'html'); +command = sprintf('python -m sphinx -W --keep-going -b html "%s" "%s"', source, target); +[status, output] = system(command); +if status ~= 0 + error('build:docs', ['Sphinx failed (is Python with docs/requirements.txt installed?):' newline '%s'], output); +end +fprintf('Documentation written to %s\n', target); +end + +function cleanTask(context) +% Remove the generated files. +root = context.Plan.RootFolder; +for folder = {'test-results', 'code-coverage', 'code-issues', fullfile('docs', 'build')} + target = fullfile(root, folder{1}); + if isfolder(target) + rmdir(target, 's'); + fprintf('Deleted %s\n', target); + end +end +end + +function runTests(context, includeSlow) +%RUNTESTS Run the test suite with a JUnit report and code coverage. +import matlab.unittest.TestRunner +import matlab.unittest.TestSuite +import matlab.unittest.plugins.XMLPlugin +import matlab.unittest.plugins.CodeCoveragePlugin +import matlab.unittest.plugins.codecoverage.CoberturaFormat +import matlab.unittest.selectors.HasTag + +root = context.Plan.RootFolder; + +% Source code, tests and legacy reference on the path for this run. +originalPath = path; +restorePath = onCleanup(@() path(originalPath)); +addpath(fullfile(root, 'src'), fullfile(root, 'tests'), fullfile(root, 'legacy')); + +resultsFolder = fullfile(root, 'test-results'); +coverageFolder = fullfile(root, 'code-coverage'); +for folder = {resultsFolder, coverageFolder} + if ~isfolder(folder{1}) + mkdir(folder{1}); + end +end + +suite = TestSuite.fromFolder(fullfile(root, 'tests'), 'IncludingSubfolders', true); +if ~includeSlow + suite = suite.selectIf(~HasTag('Slow')); +end + +runner = TestRunner.withTextOutput; +runner.addPlugin(XMLPlugin.producingJUnitFormat(fullfile(resultsFolder, 'results.xml'))); +runner.addPlugin(CodeCoveragePlugin.forPackage('ldem', 'IncludingSubpackages', true, ... + 'Producing', CoberturaFormat(fullfile(coverageFolder, 'coverage.xml')))); + +results = runner.run(suite); + +fprintf('\n%d tests: %d passed, %d failed, %d incomplete.\n', ... + numel(results), nnz([results.Passed]), nnz([results.Failed]), nnz([results.Incomplete])); +assertSuccess(results); +end diff --git a/docs/source/en/installation.rst b/docs/source/en/installation.rst index 6bda7ed..e3e3861 100644 --- a/docs/source/en/installation.rst +++ b/docs/source/en/installation.rst @@ -1,7 +1,9 @@ Installation ============ -Requirements: MATLAB R2021b or newer. +Requirements: MATLAB R2022b or newer (developed and tested on R2023b). The +package itself uses the ``arguments`` block and name=value syntax; the test +suite and ``buildtool`` need R2022b. No toolbox is required. .. code-block:: bash @@ -12,7 +14,26 @@ Requirements: MATLAB R2021b or newer. >> setup_path -To build this documentation: +Check the installation with the fast tests: + +.. code-block:: matlab + + >> buildtool test + +Developer tasks (``buildtool`` is run from the repository root): + +.. code-block:: matlab + + >> buildtool % static analysis + fast tests (the default) + >> buildtool check % Code Analyzer only + >> buildtool testAll % all tests, including the slow ones + >> buildtool docs % build this documentation (needs Python) + >> buildtool clean % delete generated files + +``buildtool test`` writes ``test-results/results.xml`` (JUnit) and +``code-coverage/coverage.xml`` (Cobertura). + +To build this documentation without MATLAB: .. code-block:: bash diff --git a/docs/source/es/instalacion.rst b/docs/source/es/instalacion.rst index a7a6eb1..b9a62be 100644 --- a/docs/source/es/instalacion.rst +++ b/docs/source/es/instalacion.rst @@ -1,7 +1,9 @@ Instalación =========== -Requisitos: MATLAB R2021b o superior. +Requisitos: MATLAB R2022b o superior (desarrollado y probado en R2023b). El +paquete usa el bloque ``arguments`` y la sintaxis nombre=valor; la suite de +tests y ``buildtool`` requieren R2022b. No hace falta ningún toolbox. .. code-block:: bash @@ -12,7 +14,27 @@ Requisitos: MATLAB R2021b o superior. >> setup_path -Para construir esta documentación: +Comprobar la instalación con los tests rápidos: + +.. code-block:: matlab + + >> buildtool test + +Tareas para desarrolladores (``buildtool`` se ejecuta desde la raíz del +repositorio): + +.. code-block:: matlab + + >> buildtool % análisis estático + tests rápidos (por defecto) + >> buildtool check % solo el analizador de código + >> buildtool testAll % todos los tests, incluidos los lentos + >> buildtool docs % construir esta documentación (requiere Python) + >> buildtool clean % borrar los archivos generados + +``buildtool test`` escribe ``test-results/results.xml`` (JUnit) y +``code-coverage/coverage.xml`` (Cobertura). + +Para construir esta documentación sin MATLAB: .. code-block:: bash diff --git a/tests/unit/TestExporters.m b/tests/unit/TestExporters.m index 6eaebc8..63bf137 100644 --- a/tests/unit/TestExporters.m +++ b/tests/unit/TestExporters.m @@ -82,6 +82,18 @@ function ansysCannotWriteToAnInvalidPath(testCase) testCase.Mesh, testCase.State), 'ldem:io:cannotOpenFile'); end + function vtkCannotWriteToAnInvalidPath(testCase) + testCase.verifyError( ... + @() ldem.io.exportVtk(fullfile(testCase.tempFolder(), "missing", "x.vtu"), ... + testCase.Mesh, testCase.State), 'ldem:io:cannotOpenFile'); + end + + function pvdCannotWriteToAnInvalidPath(testCase) + testCase.verifyError( ... + @() ldem.io.writePvd(fullfile(testCase.tempFolder(), "missing", "x.pvd"), 0, "a.vtu"), ... + 'ldem:io:cannotOpenFile'); + end + function vtkFileIsValidXml(testCase) path = fullfile(testCase.tempFolder(), "state.vtu"); ldem.io.exportVtk(path, testCase.Mesh, testCase.State); diff --git a/tests/unit/TestRunSimulation.m b/tests/unit/TestRunSimulation.m index 50fecac..fd99e95 100644 --- a/tests/unit/TestRunSimulation.m +++ b/tests/unit/TestRunSimulation.m @@ -146,6 +146,20 @@ function plotEnergyDrawsFiveCurves(testCase) testCase.verifyEqual(ax.XLabel.String, 'Time [s]'); end + function plotsUseTheCurrentAxesByDefault(testCase) + results = ldem.runSimulation(testCase.quickParams()); + fig = figure('Visible', 'off'); + testCase.addTeardown(@close, fig); + ax = ldem.post.plotEnergy(results); + testCase.verifyEqual(ax, fig.CurrentAxes); + + bending = ldem.runSimulation(ldem.Parameters(testId=102, nModules=[70 4 3], ... + totalTime=2e-6, output=struct('snapshotEvery', 0, 'controlNodesEvery', 2, ... + 'energyEvery', 0, 'trackedBarEvery', 0))); + ax = ldem.post.plotReaction(bending); + testCase.verifyEqual(ax, fig.CurrentAxes); + end + function plotEnergyNeedsAnEnergyHistory(testCase) params = testCase.quickParams(struct('snapshotEvery', 0, ... 'controlNodesEvery', 0, 'energyEvery', 0, 'trackedBarEvery', 0)); diff --git a/tests/unit/TestSimulate.m b/tests/unit/TestSimulate.m index 66d557f..65c1452 100644 --- a/tests/unit/TestSimulate.m +++ b/tests/unit/TestSimulate.m @@ -157,6 +157,42 @@ function unstableTimeStepForTheMeshIsReported(testCase) 'ldem:params:unstableTimeStep'); end + function aDamagedTrackedBarReportsItsDissipatedEnergy(testCase) + output = struct('snapshotEvery', 0, 'controlNodesEvery', 0, ... + 'energyEvery', 0, 'trackedBarEvery', 0); + base = {'nModules', [6 3 3], 'totalTime', 2e-4, 'fractureEnergy', 0.1}; + + % First find a bar that softens in this simulation. + probe = ldem.runSimulation(ldem.Parameters(base{:}, 'output', output)); + bar = find(~probe.final.damage.isUndamaged, 1); + testCase.assumeNotEmpty(bar, 'The probe run must damage at least one bar.'); + + output.trackedBarEvery = 1; + results = ldem.runSimulation(ldem.Parameters(base{:}, 'trackedBar', bar, 'output', output)); + tracked = results.trackedBar; + + testCase.verifyEqual(tracked.damageEnergy(1), 0, 'A bar starts undamaged.'); + testCase.verifyGreaterThan(tracked.damageEnergy(end), 0); + testCase.verifyTrue(all(diff(tracked.damageEnergy) >= -1e-18), ... + 'Dissipated energy cannot decrease.'); + + % Same formula as ldem.solver.computeEnergies, for this bar only. + h = results.final.damage; + E1 = results.barProps.stiffness(bar); + E2 = h.tensionStiffness(bar); + EP = results.barProps.criticalStrain(bar); + EM = h.maxStrain(bar); + expected = results.mesh.barLength(bar) / 2 * ... + (E1*EP^2 - E2*EM^2 + (E1*EP + E2*EM) * (EM - EP)); + testCase.verifyEqual(tracked.damageEnergy(end), expected, 'RelTol', 1e-12); + end + + function bendingScenarioAcceptsALoadingVelocity(testCase) + scenario = ldem.scenarios.FourPointBending(loadingVelocity=1e-3); + testCase.verifyEqual(scenario.loadingVelocity, 1e-3); + testCase.verifyEqual(ldem.scenarios.FourPointBending().loadingVelocity, 400e-5); + end + function verboseModePrintsProgress(testCase) [params, mesh, barProps, history, scenario] = testCase.smallModel(nModules=[3 3 3], totalTime=2e-6); %#ok text = evalc('ldem.solver.simulate(params, mesh, barProps, history, scenario, Verbose=true);'); From dc34a1c269605d3eb23b981fe618471bd45309a9 Mon Sep 17 00:00:00 2001 From: Boris Rojo Tanzi <71112604+borisrojotanzi@users.noreply.github.com> Date: Fri, 6 Nov 2026 00:25:00 -0300 Subject: [PATCH 06/13] feat: complete the ldem package with energy accounting, exporters and fixes --- .github/workflows/tests-all.yml | 4 +- CHANGELOG.md | 43 +- CONTRIBUTING.md | 27 +- README.md | 21 +- buildfile.m | 10 +- docs/known-issues/KNOWN_ISSUES.es.md | 124 ++++ docs/known-issues/KNOWN_ISSUES.md | 117 ++++ docs/source/api/index.rst | 13 +- docs/source/en/usage.rst | 48 +- docs/source/es/uso.rst | 48 +- examples/README.md | 6 +- examples/beam_102/LET.AN1 | 700 ------------------- legacy/ANSYS.m | 392 ----------- legacy/BOUND.m | 137 ---- legacy/CABAR.m | 204 ------ legacy/CACOEV.m | 25 - legacy/CALAUX.m | 32 - legacy/CALCOEV.m | 25 - legacy/CALOAD.m | 146 ---- legacy/CALRES.m | 130 ---- legacy/CONECTI.m | 44 -- legacy/CONSTIT.m | 221 ------ legacy/COORD.m | 42 -- legacy/COORDSUB.m | 50 -- legacy/DEFEP.m | 88 --- legacy/DIACO1.m | 121 ---- legacy/ENERG2.m | 221 ------ legacy/EXTCO1.m | 70 -- legacy/IGN012.m | 288 -------- legacy/IMPERF.m | 108 --- legacy/INTCO1.m | 51 -- legacy/KNOWN_ISSUES.md | 96 --- legacy/NAYFES0.m | 46 -- legacy/NODMASS.m | 68 -- legacy/RMEC.m | 93 --- legacy/RMEC2.m | 114 --- legacy/RMECDI.m | 88 --- legacy/RMECEX.m | 84 --- legacy/RMECIN.m | 59 -- legacy/WRICON.m | 117 ---- legacy/WRIDIPO.m | 84 --- legacy/WRIENE.m | 38 - legacy/ini_DEM3.m | 221 ------ legacy/main1.m | 529 -------------- legacy/prepvar.m | 38 - legacy/read_dat0.m | 132 ---- sandbox/Energy_balance.m | 14 - sandbox/Teste_combinado.m | 239 ------- sandbox/Teste_pot.m | 239 ------- sandbox/gerar_transicao_dupla2.m | 74 -- sandbox/main.m | 14 - sandbox/mainDEM.m | 404 ----------- setup_path.m | 6 +- src/+ldem/+io/SnapshotWriter.m | 10 +- src/+ldem/+io/exportAnsys.m | 27 +- src/+ldem/+material/summarizeMaterial.m | 74 ++ src/+ldem/+mesh/buildMesh.m | 4 +- src/+ldem/+mesh/perturbNodes.m | 5 +- src/+ldem/+mesh/summarizeModel.m | 61 ++ src/+ldem/+post/plotEnergy.m | 9 +- src/+ldem/+scenarios/FourPointBending.m | 117 ++-- src/+ldem/+scenarios/UniaxialTension.m | 18 +- src/+ldem/+solver/computeEnergies.m | 29 +- src/+ldem/+solver/initialState.m | 4 + src/+ldem/+solver/integrateStep.m | 20 +- src/+ldem/+solver/nodalKineticEnergy.m | 31 + src/+ldem/+solver/simulate.m | 3 +- src/+ldem/Parameters.m | 22 +- src/+ldem/runSimulation.m | 11 +- tests/TestLdemPath.m | 22 - tests/fixtures/README.md | 13 + tests/fixtures/bending102.mat | Bin 899199 -> 895155 bytes tests/fixtures/tension101_damage.mat | Bin 165037 -> 165037 bytes tests/fixtures/tension101_elastic.mat | Bin 161402 -> 161402 bytes tests/regression/TestAnsysAgainstLegacy.m | 8 +- tests/regression/TestFixtures.m | 5 +- tests/regression/TestLegacyReproducibility.m | 63 -- tests/regression/TestMaterialAgainstLegacy.m | 2 +- tests/regression/TestMeshAgainstLegacy.m | 4 +- tests/regression/TestSolverAgainstLegacy.m | 9 +- tests/run_tests.m | 5 +- tests/tools/generateReference.m | 48 -- tests/tools/referenceCases.m | 5 +- tests/tools/runLegacyCase.m | 97 --- tests/tools/writeDataFile.m | 10 +- tests/unit/TestEnergies.m | 21 +- tests/unit/TestExporters.m | 31 +- tests/unit/TestParameters.m | 9 +- tests/unit/TestPerturbNodes.m | 19 +- tests/unit/TestRunSimulation.m | 42 +- tests/unit/TestScenarios.m | 62 +- tests/unit/TestSimulate.m | 31 +- tests/unit/TestSolver.m | 33 + 93 files changed, 1016 insertions(+), 6321 deletions(-) create mode 100644 docs/known-issues/KNOWN_ISSUES.es.md create mode 100644 docs/known-issues/KNOWN_ISSUES.md delete mode 100644 examples/beam_102/LET.AN1 delete mode 100644 legacy/ANSYS.m delete mode 100644 legacy/BOUND.m delete mode 100644 legacy/CABAR.m delete mode 100644 legacy/CACOEV.m delete mode 100644 legacy/CALAUX.m delete mode 100644 legacy/CALCOEV.m delete mode 100644 legacy/CALOAD.m delete mode 100644 legacy/CALRES.m delete mode 100644 legacy/CONECTI.m delete mode 100644 legacy/CONSTIT.m delete mode 100644 legacy/COORD.m delete mode 100644 legacy/COORDSUB.m delete mode 100644 legacy/DEFEP.m delete mode 100644 legacy/DIACO1.m delete mode 100644 legacy/ENERG2.m delete mode 100644 legacy/EXTCO1.m delete mode 100644 legacy/IGN012.m delete mode 100644 legacy/IMPERF.m delete mode 100644 legacy/INTCO1.m delete mode 100644 legacy/KNOWN_ISSUES.md delete mode 100644 legacy/NAYFES0.m delete mode 100644 legacy/NODMASS.m delete mode 100644 legacy/RMEC.m delete mode 100644 legacy/RMEC2.m delete mode 100644 legacy/RMECDI.m delete mode 100644 legacy/RMECEX.m delete mode 100644 legacy/RMECIN.m delete mode 100644 legacy/WRICON.m delete mode 100644 legacy/WRIDIPO.m delete mode 100644 legacy/WRIENE.m delete mode 100644 legacy/ini_DEM3.m delete mode 100644 legacy/main1.m delete mode 100644 legacy/prepvar.m delete mode 100644 legacy/read_dat0.m delete mode 100644 sandbox/Energy_balance.m delete mode 100644 sandbox/Teste_combinado.m delete mode 100644 sandbox/Teste_pot.m delete mode 100644 sandbox/gerar_transicao_dupla2.m delete mode 100644 sandbox/main.m delete mode 100644 sandbox/mainDEM.m create mode 100644 src/+ldem/+material/summarizeMaterial.m create mode 100644 src/+ldem/+mesh/summarizeModel.m create mode 100644 src/+ldem/+solver/nodalKineticEnergy.m delete mode 100644 tests/TestLdemPath.m create mode 100644 tests/fixtures/README.md delete mode 100644 tests/regression/TestLegacyReproducibility.m delete mode 100644 tests/tools/generateReference.m delete mode 100644 tests/tools/runLegacyCase.m diff --git a/.github/workflows/tests-all.yml b/.github/workflows/tests-all.yml index e7d0fd9..1dc0d97 100644 --- a/.github/workflows/tests-all.yml +++ b/.github/workflows/tests-all.yml @@ -1,7 +1,7 @@ name: tests-all -# The slow tests start child MATLAB processes that re-run the legacy simulations -# (about 5 minutes). They are run on demand, not on every push. +# The slow tests build the complete beam model of the example (about 167,000 +# nodes). They are run on demand, not on every push. on: workflow_dispatch: diff --git a/CHANGELOG.md b/CHANGELOG.md index ccbd58f..266a3af 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -7,10 +7,9 @@ - `matlab.unittest` test suite and GitHub Actions workflows. - Golden-master regression infrastructure (`tests/tools`, `tests/fixtures`, `tests/regression`): three small reference simulations generated from the - legacy code, plus a slow test that checks the legacy code still reproduces - them (`run_tests(IncludeSlow=true)`). -- `legacy/KNOWN_ISSUES.md`: bugs found in the original code and how the - refactored code will resolve each one. + original code. +- `docs/known-issues/KNOWN_ISSUES.md` (and `.es.md`): bugs found in the original + code and how each one was resolved. - New package `src/+ldem` (refactoring in progress), validated against the legacy fixtures: `ldem.Parameters` (validated input), `ldem.io.readInputFile`, @@ -41,26 +40,50 @@ Coverage of the `ldem` package is 99.9 %. - CI: `tests` runs `check` and `test` on R2023b and keeps the reports; `tests-all` (manual) also runs the slow tests; `docs` builds Sphinx with warnings as errors. +- External work and energy balance: `energy.external` is the work done on the degrees + of freedom held by the scenario and `energy.balance = external - internal` + (0.01-0.5 % of the external work in the reference tests, also with softening + and rupture). +- Kinetic energy of every node (`ldem.solver.nodalKineticEnergy`, stored in + `results.final` and in the snapshots) besides the total of the model. +- `results.model` and `results.material`: counts, mass, material data, lattice + coefficients and statistics of the critical strain (what `WRICON` printed). +- `FourPointBending(supportPosition=, loadPosition=)`: the positions of the beam + test are parameters (the legacy values are the defaults); an error is raised when + a position matches no node. +- Spanish translation of the known issues: `docs/known-issues/KNOWN_ISSUES.es.md`. +- ANSYS files list the displacement imposed on the loaded nodes + (`D,node,direction,value`) in the applied-loads section. +- `Parameters.meshPerturbation`: one number that switches the mesh perturbation + off (`0`, the default) or on with that coefficient of variation (`> 0`). - Unit tests (`tests/unit`) and a regression test that compares the new mesh with the legacy one (`tests/regression/TestMeshAgainstLegacy`). ### Changed -- Original routines moved from `src/ldem` to `legacy/` (frozen reference). -- Experimental scripts moved to `sandbox/`; example inputs to `examples/beam_102/`. +- Example inputs moved to `examples/beam_102/`. - `.gitignore` now targets MATLAB and LDEM output files. - `run_tests` searches subfolders and skips tests tagged `Slow` by default. -- `setup_path` adds both `src/` and `legacy/`; the generated API documentation - now covers the `ldem` package only. +- The generated API documentation covers the `ldem` package only. -### Fixed +### Fixed in the original code (kept in the git tag `legacy-reference`) - `legacy/main1.m`: removed scratch lines; fixed the end-of-run file closing (undefined `fid12/fid15/fid19/fid20`) and the ANSYS output call. -- `legacy/BOUND.m`: `TEST 101` failed because `ini` was not assigned. +- `legacy/BOUND.m`: `TEST 101` failed because `ini` was not assigned, and its + right-end support had a misplaced parenthesis (the loaded nodes were not held, + so the tension test did not conserve energy). +- `legacy/CALOAD.m`: the second load point of the beam test was never loaded. +- `legacy/IGN012.m`: the acceleration in y used a wrong index. - `legacy/IGN012.m`: the time integration was never executed (the nested function `ign012` was not called), so free nodes never moved. Fixed; the golden-master fixtures were regenerated and the damage case re-tuned (1000 steps, Gf = 0.1). ### Removed +- The original routines (`legacy/`) and the scratch scripts (`sandbox/`), with the + tools and tests that ran them (`generateReference`, `runLegacyCase`, + `TestLegacyReproducibility`, `TestLdemPath`). They remain in the git history + under the tag `legacy-reference`; the reference results they produced are kept + in `tests/fixtures/`. +- `examples/beam_102/LET.AN1`, which only the original driver read. - Duplicate files (`* - Copia.m`, `Copy_of_*`), empty `initialization_DEM`, and generated output files that were tracked by mistake (`LET.*`, `*.TXT`, `SIM01.DAT`, `BARR_ROMP.dat`). diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index fa9c53c..ffe07ce 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -33,15 +33,15 @@ Rules that keep the Sphinx build free of warnings: explanations in a paragraph after the list. - Leave a blank comment line before an indented block (list, example, table). -Comments in new code are written in English (the legacy code keeps its original -Portuguese comments). Names: `lowerCamelCase` for functions and variables, +Comments are written in English. Names: `lowerCamelCase` for functions and variables, `UpperCamelCase` for classes. Validate inputs with an `arguments` block and throw errors with an identifier of the form `ldem::`. ## Workflow 1. Branch from `dev`. 2. Add or adjust tests in `tests/` (`Test*.m`, `matlab.unittest`): `tests/unit` - for new code, `tests/regression` for comparisons with the legacy results. + for the behaviour of each function, `tests/regression` for comparisons with + the golden-master results of the original code. 3. Run `buildtool` in MATLAB from the repository root. It runs the Code Analyzer (`check`, which must report nothing) and the fast tests with coverage (`test`). Before opening the pull request also run @@ -54,21 +54,22 @@ errors with an identifier of the form `ldem::`. | `buildtool` | `check` and `test` (default) | | `buildtool check` | Code Analyzer on `src/`, `tests/` and `examples/`; any warning fails | | `buildtool test` | Fast tests; writes `test-results/results.xml` and `code-coverage/coverage.xml` | -| `buildtool testAll` | Also the slow tests (re-run the legacy simulations, ~5 min) | +| `buildtool testAll` | Also the slow tests (complete beam model) | | `buildtool docs` | Sphinx HTML in `docs/build/html` (needs Python and `docs/requirements.txt`) | | `buildtool clean` | Delete the generated files | `run_tests` (in `tests/`) is a lighter alternative that only runs the tests. -Files excluded from docs/tests: backups (`*.asv`) and the scratch scripts in `sandbox/`. +Files excluded from docs/tests: backups (`*.asv`). -## Repository layout during the refactoring -- `src/+ldem/` is the `ldem` package: the refactored code. New work goes here. -- `legacy/` is the **frozen** original code. Do not change its numerics: the - regression tests compare the refactored code against it. Known problems are - listed in `legacy/KNOWN_ISSUES.md`. -- `tests/fixtures/*.mat` are golden-master results produced by the legacy code. - Regenerate them only if the legacy code is changed on purpose: - `addpath('tests/tools'); generateReference`. +## Repository layout +- `src/+ldem/` is the `ldem` package. All the code goes here. +- `tests/fixtures/*.mat` are golden-master results produced by the original + (Fortran-derived) MATLAB code, after correcting its obvious bugs. The original + code is not in the working tree; it is in the git history under the tag + `legacy-reference` (`git checkout legacy-reference`, which also contains the + tools that generated the fixtures). The problems found in it are listed in + `docs/known-issues/KNOWN_ISSUES.md`. Change a fixture only on purpose, and + say in the pull request why the reference result changed. - Slow tests (tag `Slow`) are skipped by `buildtool test` and `run_tests`; use `buildtool testAll` or `run_tests(IncludeSlow=true)`. diff --git a/README.md b/README.md index 0df08fa..4d6caf7 100644 --- a/README.md +++ b/README.md @@ -17,7 +17,6 @@ quasi-brittle materials (concrete, rocks). | Path | Content | |------|---------| | `src/+ldem/` | The `ldem` package (refactored code) | -| `legacy/` | Original LDEM routines (frozen reference used by the regression tests) | | `tests/` | `matlab.unittest` test suite | | `docs/` | Sphinx documentation (English and Spanish), API generated from the `.m` files | | `examples/` | How to run the example simulations | @@ -25,7 +24,7 @@ quasi-brittle materials (concrete, rocks). ### Quick start ```matlab ->> setup_path % adds src/ and legacy/ to the MATLAB path +>> setup_path % adds src/ to the MATLAB path >> run('examples/tension_101/runTension.m') % small example, output in examples/tension_101/output ``` @@ -47,8 +46,8 @@ pip install -r docs/requirements.txt sphinx-build -b html docs/source docs/build/html ``` -Comments of the new code are written in English (the original code in `legacy/` -keeps its Portuguese comments); the guides are available in English and Spanish. See [CONTRIBUTING.md](CONTRIBUTING.md) for the docstring +Comments are written in English (the original code is in the git history under +the tag `legacy-reference`); the guides are available in English and Spanish. See [CONTRIBUTING.md](CONTRIBUTING.md) for the docstring convention. ### Citation @@ -70,7 +69,6 @@ quase-frágeis (concreto, rochas). | Caminho | Conteúdo | |---------|----------| | `src/+ldem/` | O pacote `ldem` (código refatorado) | -| `legacy/` | Rotinas LDEM originais (referência congelada usada nos testes de regressão) | | `tests/` | Suíte de testes com `matlab.unittest` | | `docs/` | Documentação Sphinx (espanhol e inglês), API gerada a partir dos `.m` | | `examples/` | Como executar as simulações de exemplo | @@ -78,7 +76,7 @@ quase-frágeis (concreto, rochas). ### Início rápido ```matlab ->> setup_path % adiciona src/ e legacy/ ao path do MATLAB +>> setup_path % adiciona src/ ao path do MATLAB >> run('examples/tension_101/runTension.m') % exemplo pequeno, saída em examples/tension_101/output ``` @@ -99,8 +97,8 @@ pip install -r docs/requirements.txt sphinx-build -b html docs/source docs/build/html ``` -Os comentários do código novo estão em inglês (o código original em `legacy/` -mantém os comentários em português); os guias estão em espanhol e inglês. Veja [CONTRIBUTING.md](CONTRIBUTING.md) para a convenção de docstrings. +Os comentários estão em inglês (o código original está no histórico do git, na +tag `legacy-reference`); os guias estão em espanhol e inglês. Veja [CONTRIBUTING.md](CONTRIBUTING.md) para a convenção de docstrings. ### Citação @@ -121,7 +119,6 @@ cuasi-frágiles (hormigón, rocas). | Ruta | Contenido | |------|-----------| | `src/+ldem/` | El paquete `ldem` (código refactorizado) | -| `legacy/` | Rutinas LDEM originales (referencia congelada usada en los tests de regresión) | | `tests/` | Suite de tests con `matlab.unittest` | | `docs/` | Documentación Sphinx (español e inglés), API generada desde los `.m` | | `examples/` | Cómo ejecutar las simulaciones de ejemplo | @@ -129,7 +126,7 @@ cuasi-frágiles (hormigón, rocas). ### Inicio rápido ```matlab ->> setup_path % agrega src/ y legacy/ al path de MATLAB +>> setup_path % agrega src/ al path de MATLAB >> run('examples/tension_101/runTension.m') % ejemplo pequeño, salida en examples/tension_101/output ``` @@ -150,8 +147,8 @@ pip install -r docs/requirements.txt sphinx-build -b html docs/source docs/build/html ``` -Los comentarios del código nuevo están en inglés (el código original de `legacy/` -mantiene sus comentarios en portugués); las guías están en español e inglés. Ver [CONTRIBUTING.md](CONTRIBUTING.md) para la convención de docstrings. +Los comentarios están en inglés (el código original está en el historial de git, +etiqueta `legacy-reference`); las guías están en español e inglés. Ver [CONTRIBUTING.md](CONTRIBUTING.md) para la convención de docstrings. ### Cita diff --git a/buildfile.m b/buildfile.m index c00ea0e..691d8f0 100644 --- a/buildfile.m +++ b/buildfile.m @@ -6,7 +6,7 @@ % >> buildtool % default: check + test % >> buildtool check % static analysis (Code Analyzer) % >> buildtool test % fast tests, with coverage and JUnit report -% >> buildtool testAll % also the slow tests (re-run the legacy code) +% >> buildtool testAll % also the slow tests (full beam model) % >> buildtool docs % Sphinx documentation (needs Python) % >> buildtool clean % remove generated files % >> buildtool -tasks % list the tasks @@ -17,8 +17,8 @@ % test Runs every test not tagged "Slow", writes % test-results/results.xml (JUnit) and code-coverage/coverage.xml % (Cobertura) and prints the coverage of the ldem package. -% testAll Same as test but including the slow tests, which start child -% MATLAB processes (about 5 minutes). +% testAll Same as test but including the slow tests (they build the +% complete beam model of the example, about 167,000 nodes). % docs Builds the HTML documentation in docs/build/html. % clean Deletes test-results/, code-coverage/ and docs/build/. % @@ -86,10 +86,10 @@ function runTests(context, includeSlow) root = context.Plan.RootFolder; -% Source code, tests and legacy reference on the path for this run. +% Source code and tests on the path for this run. originalPath = path; restorePath = onCleanup(@() path(originalPath)); -addpath(fullfile(root, 'src'), fullfile(root, 'tests'), fullfile(root, 'legacy')); +addpath(fullfile(root, 'src'), fullfile(root, 'tests')); resultsFolder = fullfile(root, 'test-results'); coverageFolder = fullfile(root, 'code-coverage'); diff --git a/docs/known-issues/KNOWN_ISSUES.es.md b/docs/known-issues/KNOWN_ISSUES.es.md new file mode 100644 index 0000000..5a027bf --- /dev/null +++ b/docs/known-issues/KNOWN_ISSUES.es.md @@ -0,0 +1,124 @@ +# Problemas conocidos del código original + +*English version: [KNOWN_ISSUES.md](KNOWN_ISSUES.md).* + +Las rutinas originales de MATLAB (la carpeta `legacy/`, traducidas del programa +en Fortran) fueron la implementación de referencia de los tests de regresión. +Se quitaron del árbol de trabajo cuando el código refactorizado las reprodujo; +siguen en el historial de git bajo la etiqueta `legacy-reference` +(`git checkout legacy-reference`). Los resultados de referencia que produjeron +están en `tests/fixtures/`. + +Los problemas encontrados en el código original se listan aquí con la decisión +tomada. Cuando un problema era un error evidente de programación se **corrigió +también en el código original**, y los fixtures se regeneraron con la versión +corregida (la etiqueta guarda esa versión). + +Estado de cada ítem: **Corregido** (en el código original y en el nuevo), +**Resuelto** (en el código nuevo; el original conservaba el comportamiento +anterior), **Revisado** (comprobado, sin cambios) o **Aceptado** (se mantiene el +comportamiento original). No queda ningún ítem abierto. + +## Corregido en el código original + +| Archivo | Problema | Corrección | +|---------|----------|------------| +| `main1.m` | Líneas de prueba `a=1, b=2, c=3` al comienzo | Eliminadas | +| `main1.m` | La sección final usaba identificadores sin definir (`fid12/fid15/fid19/fid20`) y fallaba al terminar cada corrida | Cierra los identificadores de archivo que realmente se abrieron | +| `main1.m` | `ARMANS(I3)` (paréntesis) y `[...] = ini==ANSYS(...)` fallaban al activar la salida ANSYS | `ARMANS{I3}` y llamada simple | +| `BOUND.m` | `ini` solo se asignaba con `TEST == 102`, por lo que `TEST 101` fallaba | Se asigna siempre | +| `IGN012.m` | **Crítico.** La integración por diferencias centrales estaba en una función anidada `ign012` que nunca se llamaba, así que ningún nodo se movía salvo los de desplazamiento impuesto (velocidades y aceleraciones exactamente 0) | Se agregó la llamada `ign012;` | +| `IGN012.m` | La aceleración en y usaba `V(2,I)` (un escalar sobrante del bucle de nodos) en lugar de `V(2,:)` (ítem 11) | `V(2,:)` | +| `BOUND.m` | `TEST 101`: paréntesis mal puesto en el apoyo del extremo derecho (ítems 3 y 19) | `(M1 - 0.51)*LCO` | +| `CALOAD.m` | `TEST 102`: condición incorrecta, el segundo punto de carga nunca se cargaba (ítem 15) | `LOGIC2 && LOGIC3` | + +## Ítems + +1. **`ENERG2.m`, líneas 172-174: la energía cinética no se suma.** `ENCN` era un + vector por nodo en lugar de un escalar. **Resuelto.** El código nuevo da las + dos cosas: la energía cinética de cada nodo (`results.final.kineticEnergy`, + y `results.snapshots.kineticEnergy` en los pasos de snapshot) y el total del + modelo (`results.energy.kinetic`). +2. **`WRIENE.m`, línea 35: formato inválido `%25.12` (falta la `e`).** `LET.ENE` + quedaba truncado y desordenado. **Resuelto.** El historial de energías forma + parte del archivo de resultados (`results.energy`); ya no hay archivo de + texto. +3. **`BOUND.m`, `TEST == 101`: precedencia de operadores.** `mask2` usaba + `U0 > (M1 - 0.51*LCO)` en lugar de `(M1 - 0.51)*LCO` y no seleccionaba + ningún nodo. **Corregido.** La columna de nodos centrales del extremo + derecho es la cargada, y ahora está fija en x (es el mismo error que el + ítem 19). +4. **`CABAR.m` / `ENERG2.m`: barra rastreada fija en 7014.** **Resuelto**: + `params.trackedBar`. +5. **`TEST == 102`: geometría escrita en unidades de módulo** (`33.49`, `4.51`, + `50.5`...), por lo que el ensayo solo funcionaba con `M >= ~70`. + **Resuelto**: `FourPointBending(supportPosition=, loadPosition=)`, con los + valores originales por defecto, y un error cuando una posición no coincide + con ningún nodo. +6. **`IMPERF.m`: `LABELN` se pone en 1 y enseguida en 0,** de modo que la + perturbación de la malla nunca se aplica y la semilla no tiene efecto. + **Resuelto** en el código nuevo: el usuario la define con un solo número, + `meshPerturbation`: 0 (el valor por defecto) deja el reticulado regular y + cualquier valor positivo activa la perturbación con ese coeficiente de + variación (por ejemplo `0.02` para el 2 % de la longitud del módulo). Ya no + es un indicador que se edita en el código. La comprobación de estabilidad + del paso de tiempo usa las longitudes reales (perturbadas) de las barras. +7. **`CALCOEV.m`: el coeficiente de variación nunca se guarda** (`COEF` en lugar + de `COEV`). **Resuelto**: `results.barProps.criticalStrainCv` y + `results.material`, que además guarda E, Gf, los coeficientes del reticulado + y la deformación crítica media, mínima y máxima (lo que imprimía `WRICON`). +8. **`DEFEP.m`: verificación de seguridad sin uso** (`KR < 1.01`). **Resuelto**: + `buildBarProperties` lanza `ldem:material:criticalLengthTooShort`. +9. **El campo aleatorio es obligatorio.** **Resuelto**: `params.randomFieldFile` + es opcional (vacío = todos los multiplicadores valen 1). +10. **La prealocación `INT = 168000`, `INB = 2300000`** limitaba el tamaño de la + malla. **Resuelto**: todos los tamaños se deducen del número de módulos. +11. **`ign012`: la aceleración en y usa un índice incorrecto.** **Corregido** + en el código original y en el nuevo (`ldem.solver.integrateStep`); el test de + regresión ahora compara las tres componentes. +12. **`ign012`: la energía de amortiguamiento mezcla vectores y escalares.** + **Resuelto**: `state.dampingEnergy` es un escalar. (Los casos de referencia + tienen `CON = 0`, donde las dos definiciones coinciden.) +13. **`ENERG2.m` / `IGN012.m`: `KL` siempre vale 2.** La condición `B > NBA` que + daría `KL = 4` a las diagonales nunca se cumple porque + `NBA = NBS = NBT`. **Revisado.** El tipo de barra se conoce por cómo se + construye el modelo (arista de la malla, barra entre centros o diagonal, + `mesh.barType`), pero `KL = 2` es correcto para todos los tipos: da la + energía de la barra `E*deformación^2*L/2`, coherente con la ley de fuerza. + Con `KL = 4` en las diagonales el balance de energía se desviaría 13.5 % + (viga elástica; las diagonales guardan el 36 % de la energía elástica) y + 4.6 % (viga con daño), contra 0.05-0.1 % con `KL = 2`. +14. **`ENEX` (trabajo externo) nunca se calcula.** **Resuelto**: + `energy.external` es el trabajo realizado sobre los grados de libertad que + el escenario mantiene fijos y `energy.balance = external - internal`. El + balance es menor al 1 % del trabajo externo (0.01-0.5 % en los tests de + referencia), también con ablandamiento y rotura (tests en `TestSimulate` y + `TestSolver`). +15. **`CALOAD.m`, `TEST == 102`: el segundo punto de carga nunca se carga.** La + condición `LOGIC1 && LOGIC2` no puede cumplirse. **Corregido**: los dos + puntos de carga se mueven (`LOGIC2 && LOGIC3`). +16. **Un `TDAF` menor que medio paso de tiempo nunca cambia el amortiguamiento.** + **Aceptado** (`ldem.solver.dampingCoefficient` lo reproduce). +17. **Convención de signo de `TEST == 101`.** Los nodos cargados se mueven a + `x0 - VF2*TIME`, lo que comprime el prisma para `VF2 > 0` aunque el + comentario dice "tracción". **Aceptado**: misma convención, documentada en + `UniaxialTension`; usar un `loadingVelocity` negativo para traccionar. +18. **`ANSYS.m`: tres problemas en los archivos de macro.** (a) La línea + `ET,IFILE,4` es un comando de ANSYS inválido (un descuido por `ET,3,4`); + (b) las restricciones (`D,nodo,UX`...) solo se escriben para + `TEST == 102`; (c) la sección de "cargas aplicadas" escribe + `F,nodo,Fx,-10` para nodos elegidos con coordenadas fijas en el código + (`50.5*LCO`...) que no coinciden con ningún nodo de la viga. **Resuelto.** + `ldem.io.exportAnsys` escribe `ET,3,4` (a) y las restricciones de valor + cero de todos los escenarios (b). Para (c) la sección de cargas lista el + desplazamiento impuesto a los nodos cargados como `D,nodo,UY,valor`, + medido desde su posición inicial (nada en el tiempo cero). ANSYS conserva + la última restricción de cada grado de libertad, así que estas líneas + reemplazan a las de valor cero. Las coordenadas de los nodos del archivo + siguen siendo las posiciones actuales, por lo que el archivo muestra el + estado de la simulación; no es un reinicio desde el reticulado sin + deformar. +19. **`CALOAD.m`, `TEST == 101`: los nodos cargados no estaban fijos** (el mismo + error que el ítem 3): su posición se sobrescribía en cada paso y luego se + movían libremente, así que ninguna fuerza hacía trabajo sobre ellos y el + balance de energía no podía cerrar. **Corregido** junto con el ítem 3. diff --git a/docs/known-issues/KNOWN_ISSUES.md b/docs/known-issues/KNOWN_ISSUES.md new file mode 100644 index 0000000..6f9c685 --- /dev/null +++ b/docs/known-issues/KNOWN_ISSUES.md @@ -0,0 +1,117 @@ +# Known issues of the legacy code + +*Versión en español: [KNOWN_ISSUES.es.md](KNOWN_ISSUES.es.md).* + +The original MATLAB routines (the `legacy/` folder, translated from the +Fortran program) were the reference implementation of the regression tests. +They were removed from the working tree once the refactored code reproduced +them; they remain in the git history under the tag `legacy-reference` +(`git checkout legacy-reference`). The golden-master results they produced are +stored in `tests/fixtures/`. + +Problems found in the original code are listed here with the decision taken. +Where a problem was an obvious programming error it was **corrected in the +original code as well**, and the fixtures were regenerated from the corrected +version (the tag holds that version). + +Status of each item: **Corrected** (in the original code and in the new code), +**Resolved** (in the new code; the original kept the old behaviour), +**Reviewed** (checked, no change needed) or **Accepted** (the original +behaviour is kept). No item is open. + +## Corrected in the original code + +| File | Problem | Fix | +|------|---------|-----| +| `main1.m` | Scratch lines `a=1, b=2, c=3` at the top | Removed | +| `main1.m` | Closing section used undefined `fid12/fid15/fid19/fid20` and crashed at the end of every run | Closes the file ids that were really opened | +| `main1.m` | `ARMANS(I3)` (parentheses) and `[...] = ini==ANSYS(...)` crashed when ANSYS output was enabled | `ARMANS{I3}`, plain call | +| `BOUND.m` | `ini` only assigned when `TEST == 102`, so `TEST 101` failed | Assigned unconditionally | +| `IGN012.m` | **Critical.** The central-difference integration was in a nested function `ign012` that was never called, so no node moved except those with a prescribed displacement (velocities and accelerations were exactly 0) | Added the call `ign012;` | +| `IGN012.m` | Acceleration in y used `V(2,I)` (a scalar left over from the node loop) instead of `V(2,:)` (item 11) | `V(2,:)` | +| `BOUND.m` | `TEST 101`: misplaced parenthesis in the right-end support (items 3 and 19) | `(M1 - 0.51)*LCO` | +| `CALOAD.m` | `TEST 102`: wrong condition, the second load point was never loaded (item 15) | `LOGIC2 && LOGIC3` | + +## Items + +1. **`ENERG2.m` lines 172-174: kinetic energy is not summed.** `ENCN` is a + per-node vector instead of a scalar. **Resolved.** The new code gives both: + the kinetic energy of every node (`results.final.kineticEnergy`, and + `results.snapshots.kineticEnergy` at the snapshot steps) and the total of + the model (`results.energy.kinetic`). +2. **`WRIENE.m` line 35: invalid format `%25.12` (missing `e`).** `LET.ENE` was + truncated and garbled. **Resolved.** The energy history is part of the + results file (`results.energy`); there is no text file. +3. **`BOUND.m`, `TEST == 101`: operator precedence.** `mask2` used + `U0 > (M1 - 0.51*LCO)` instead of `(M1 - 0.51)*LCO` and selected no node. + **Corrected.** The right-end column of centre nodes is the loaded one, and it + is now held in x (same bug as item 19). +4. **`CABAR.m` / `ENERG2.m`: tracked bar hardcoded to 7014.** **Resolved**: + `params.trackedBar`. +5. **`TEST == 102`: geometry hardcoded in module units** (`33.49`, `4.51`, + `50.5`...), so the test only worked for `M >= ~70`. **Resolved**: + `FourPointBending(supportPosition=, loadPosition=)`, with the legacy values + as defaults, and an error when a position matches no node. +6. **`IMPERF.m`: `LABELN` is set to 1 and then immediately to 0,** so the mesh + perturbation is never applied and the seed has no effect. **Resolved** in + the new code: the user sets it with one number, `meshPerturbation`: 0 (the + default) leaves the lattice regular, and any positive value activates the + perturbation with that coefficient of variation (for example `0.02` for 2 % + of the module length). It is no longer a flag edited in the code. The time-step + stability check uses the real (perturbed) bar lengths. +7. **`CALCOEV.m`: the coefficient of variation is never stored** (`COEF` instead + of `COEV`). **Resolved**: `results.barProps.criticalStrainCv` and + `results.material`, which also stores E, Gf, the lattice coefficients and + the mean, minimum and maximum critical strain (what `WRICON` printed). +8. **`DEFEP.m`: unused safety check** (`KR < 1.01`). **Resolved**: + `buildBarProperties` raises `ldem:material:criticalLengthTooShort`. +9. **Random field is mandatory.** **Resolved**: `params.randomFieldFile` is + optional (empty = all multipliers equal to 1). +10. **Preallocation `INT = 168000`, `INB = 2300000`** limited the mesh size. + **Resolved**: every size follows from the number of modules. +11. **`ign012`: acceleration in y uses a wrong index.** **Corrected** in + the original code and in the new code (`ldem.solver.integrateStep`); the regression + test now compares the three components. +12. **`ign012`: damping energy mixes vectors and scalars.** **Resolved**: + `state.dampingEnergy` is a scalar. (The reference cases have `CON = 0`, + where both definitions coincide.) +13. **`ENERG2.m` / `IGN012.m`: `KL` is always 2.** The test `B > NBA` that + would give `KL = 4` to the diagonals never holds because `NBA = NBS = NBT`. + **Reviewed.** The bar type is known from how the model is built (grid + edge, centre-to-centre bar or diagonal, `mesh.barType`), but `KL = 2` is + right for every type: it gives the bar energy `E*strain^2*L/2`, consistent + with the force law. With `KL = 4` for the diagonals the energy balance + would be off by 13.5 % (elastic beam test; the diagonals hold 36 % of the + elastic energy) and 4.6 % (beam with damage), against 0.05-0.1 % with + `KL = 2`. +14. **`ENEX` (external work) is never computed.** **Resolved**: + `energy.external` is the work done on the degrees of freedom held by the + scenario and `energy.balance = external - internal`. The balance is below + 1 % of the external work (0.01-0.5 % in the reference tests), also with + softening and rupture (tests in `TestSimulate` and `TestSolver`). +15. **`CALOAD.m`, `TEST == 102`: the second load point is never loaded.** The + condition `LOGIC1 && LOGIC2` cannot hold. **Corrected**: both load points + move (`LOGIC2 && LOGIC3`). +16. **`TDAF` shorter than half a time step never switches the damping.** + **Accepted** (`ldem.solver.dampingCoefficient` reproduces it). +17. **`TEST == 101` sign convention.** The loaded nodes move to `x0 - VF2*TIME`, + which compresses the prism for `VF2 > 0` although the comment says + "tension". **Accepted**: same convention, documented in `UniaxialTension`; + use a negative `loadingVelocity` to pull. +18. **`ANSYS.m`: three problems in the macro files.** (a) The line `ET,IFILE,4` + is an invalid ANSYS command (a slip for `ET,3,4`); (b) constraints + (`D,node,UX`...) are only written for `TEST == 102`; (c) the "applied + loads" section writes `F,node,Fx,-10` for nodes selected with hardcoded + coordinates (`50.5*LCO`...) that match no node of the beam. + **Resolved.** `ldem.io.exportAnsys` writes `ET,3,4` (a) and the zero-valued + constraints of every scenario (b). For (c) the loads section lists the + displacement imposed on the loaded nodes as `D,node,UY,value`, measured + from their initial position (nothing at time zero). ANSYS keeps the last + constraint of a degree of freedom, so these lines replace the zero ones. + The node coordinates of the file are still the current positions, so the + file shows the state of the simulation; it is not a restart from the + undeformed lattice. +19. **`CALOAD.m`, `TEST == 101`: the loaded nodes were not held** (the same bug + as item 3): their position was overwritten at every step and then moved + freely, so no force did work on them and the energy balance could not + close. **Corrected** together with item 3. diff --git a/docs/source/api/index.rst b/docs/source/api/index.rst index a2ee2ad..04ac3e8 100644 --- a/docs/source/api/index.rst +++ b/docs/source/api/index.rst @@ -5,11 +5,11 @@ Generated automatically from the comments of the ``.m`` files / Generada automáticamente desde los comentarios de los ``.m``. The ``ldem`` package (``src/+ldem``) is the refactored code. It replaces the -routines of ``legacy/`` step by step; the original routines are kept as a -frozen reference and are not part of this API (their known problems are in -``legacy/KNOWN_ISSUES.md``) / El paquete ``ldem`` (``src/+ldem``) es el código -refactorizado. Las rutinas originales de ``legacy/`` se conservan como -referencia congelada y no forman parte de esta API. +original routines, which are kept in the git history (tag +``legacy-reference``); the problems found in them are listed in +``docs/known-issues/KNOWN_ISSUES.md`` / El paquete ``ldem`` (``src/+ldem``) es +el código refactorizado. Reemplaza a las rutinas originales, que se conservan +en el historial de git (etiqueta ``legacy-reference``). Running a simulation / Ejecutar una simulación ---------------------------------------------- @@ -46,6 +46,7 @@ Mesh / Malla .. mat:autofunction:: ldem.mesh.buildBars .. mat:autofunction:: ldem.mesh.computeNodalMasses .. mat:autofunction:: ldem.mesh.computeBarGeometry +.. mat:autofunction:: ldem.mesh.summarizeModel Material -------- @@ -56,6 +57,7 @@ Material .. mat:autofunction:: ldem.material.computeBarStiffness .. mat:autofunction:: ldem.material.buildBarProperties .. mat:autofunction:: ldem.material.bilinearLaw +.. mat:autofunction:: ldem.material.summarizeMaterial Scenarios / Escenarios de ensayo -------------------------------- @@ -78,6 +80,7 @@ Solver .. mat:autofunction:: ldem.solver.integrateStep .. mat:autofunction:: ldem.solver.dampingCoefficient .. mat:autofunction:: ldem.solver.computeEnergies +.. mat:autofunction:: ldem.solver.nodalKineticEnergy .. mat:autofunction:: ldem.solver.checkStability Post-processing / Postproceso diff --git a/docs/source/en/usage.rst b/docs/source/en/usage.rst index 30d2e7d..9a68a0d 100644 --- a/docs/source/en/usage.rst +++ b/docs/source/en/usage.rst @@ -32,11 +32,25 @@ Tests available Uniaxial load: the centre nodes of the last column of modules move along :math:`x` with a prescribed velocity. ``testId = 102`` - Beam with two supports and a load point (needs a beam longer than about 70 - modules). See ``examples/beam_102``. + Beam with two supports and two load points. The positions are parameters of + ``ldem.scenarios.FourPointBending`` (``supportPosition``, ``loadPosition``, + in modules from each end); the defaults need a beam longer than about 70 + modules. See ``examples/beam_102``. To add a new test, create a subclass of ``ldem.scenarios.Scenario``. +Mesh perturbation +----------------- + +The parameter ``meshPerturbation`` randomly displaces the interior nodes. Its +value is the standard deviation as a fraction of the module length: ``0`` (the +default) keeps the lattice regular and any positive value activates the +perturbation with that value. The random numbers follow ``seed``. + +.. code-block:: matlab + + >> params = ldem.Parameters(testId=101, nModules=[6 3 3], meshPerturbation=0.02); + What you get: the ``results`` struct ------------------------------------ @@ -50,8 +64,16 @@ What you get: the ``results`` struct - ldem version, date, MATLAB release, run time [s]. * - ``params`` - The parameters used, as a plain struct (derived values included). + * - ``model`` + - Counts and mass of the model: modules, nodes, bars by type, fixed degrees + of freedom, total mass and volume. + * - ``material`` + - Material data (E, Gf, ...), lattice coefficients, critical length and the + statistics of the critical strain (mean, coefficient of variation, minimum + and maximum). * - ``mesh`` - - Initial node positions, supports (``fixed``), masses, bars, bar lengths. + - Initial node positions, supports (``fixed``), masses, bars, bar lengths + and bar types. * - ``barProps`` - Stiffness, critical strain and rupture strain of every bar. * - ``controlNodes`` @@ -60,14 +82,21 @@ What you get: the ``results`` struct - Time and reaction force of the test (beam test: vertical force). * - ``energy`` - Time, kinetic, elastic, damage and damping energies [J], their sum - (``internal``) and the damage rate. + (``internal``), the external work, the ``balance`` (external minus + internal) and the damage rate. * - ``trackedBar`` - Strain, force and damage energy of one bar at every step (optional). * - ``snapshots`` - Step, time, number of intact/damaged/broken bars, and compact copies of - the displacements and of the damage state at the snapshot steps. + the displacements, the damage state and the nodal kinetic energy at the + snapshot steps. * - ``final`` - - Final displacement, velocity, force and damage state. + - Final displacement, velocity, force and damage state, and the kinetic + energy of every node. + +The energy ``balance`` is a check of the simulation: it should be a small +fraction (below 1 %) of the final external work. The total kinetic energy is +``energy.kinetic``; the kinetic energy of each node is in ``final.kineticEnergy``. ``results.mat`` contains this struct and loads without the package: @@ -83,7 +112,10 @@ Output files The ``results`` struct (format v7.3, readable from Python with ``h5py``). ``snapshot_0000.mac``, ``snapshot_0001.mac``, ... ANSYS macro files with the deformed lattice. Bars are element types 1 - (intact), 2 (damaged) and 5 (broken). + (intact), 2 (damaged) and 5 (broken). The held degrees of freedom are + listed as ``D,node,direction`` and the displacement imposed on the loaded + nodes, measured from their initial position, as + ``D,node,direction,value``. ``snapshot_0000.vtu``, ... and ``snapshots.pvd`` VTK files. Open ``snapshots.pvd`` in `ParaView `_; colour by ``damageState`` (cell data) to see the cracks and use the time @@ -99,4 +131,4 @@ Run the tests >> addpath tests >> run_tests % fast tests - >> run_tests(IncludeSlow=true) % also re-runs the legacy simulations + >> run_tests(IncludeSlow=true) % also the slow tests diff --git a/docs/source/es/uso.rst b/docs/source/es/uso.rst index 170a239..199c095 100644 --- a/docs/source/es/uso.rst +++ b/docs/source/es/uso.rst @@ -32,12 +32,26 @@ Ensayos disponibles Carga uniaxial: los nodos centrales de la última columna de módulos se mueven en :math:`x` con velocidad impuesta. ``testId = 102`` - Viga con dos apoyos y un punto de carga (requiere una viga de más de unos - 70 módulos). Ver ``examples/beam_102``. + Viga con dos apoyos y dos puntos de carga. Las posiciones son parámetros de + ``ldem.scenarios.FourPointBending`` (``supportPosition``, ``loadPosition``, + en módulos desde cada extremo); los valores por defecto requieren una viga de + más de unos 70 módulos. Ver ``examples/beam_102``. Para agregar un ensayo nuevo se crea una subclase de ``ldem.scenarios.Scenario``. +Perturbación de la malla +------------------------ + +El parámetro ``meshPerturbation`` desplaza al azar los nodos interiores. Su +valor es la desviación estándar como fracción de la longitud del módulo: ``0`` +(el valor por defecto) deja el reticulado regular y cualquier valor positivo +activa la perturbación con ese valor. Los números aleatorios siguen a ``seed``. + +.. code-block:: matlab + + >> params = ldem.Parameters(testId=101, nModules=[6 3 3], meshPerturbation=0.02); + Qué se obtiene: la estructura ``results`` ----------------------------------------- @@ -51,8 +65,16 @@ Qué se obtiene: la estructura ``results`` - Versión de ldem, fecha, versión de MATLAB, tiempo de cálculo [s]. * - ``params`` - Los parámetros usados, como estructura simple (con valores derivados). + * - ``model`` + - Cantidades y masa del modelo: módulos, nodos, barras por tipo, grados de + libertad fijos, masa total y volumen. + * - ``material`` + - Datos del material (E, Gf, ...), coeficientes del reticulado, longitud + crítica y estadísticas de la deformación crítica (media, coeficiente de + variación, mínimo y máximo). * - ``mesh`` - - Posiciones iniciales, apoyos (``fixed``), masas, barras y longitudes. + - Posiciones iniciales, apoyos (``fixed``), masas, barras, longitudes y + tipos de barra. * - ``barProps`` - Rigidez, deformación crítica y deformación de rotura de cada barra. * - ``controlNodes`` @@ -61,15 +83,22 @@ Qué se obtiene: la estructura ``results`` - Tiempo y fuerza de reacción del ensayo (viga: fuerza vertical). * - ``energy`` - Tiempo, energías cinética, elástica, de daño y de amortiguamiento [J], - su suma (``internal``) y la tasa de daño. + su suma (``internal``), el trabajo externo, el balance (``balance``, + externo menos interno) y la tasa de daño. * - ``trackedBar`` - Deformación, fuerza y energía de daño de una barra en cada paso (opcional). * - ``snapshots`` - Paso, tiempo, número de barras intactas/dañadas/rotas y copias - compactas de los desplazamientos y del estado de daño. + compactas de los desplazamientos, del estado de daño y de la energía + cinética de cada nodo. * - ``final`` - - Desplazamiento, velocidad, fuerza y estado de daño finales. + - Desplazamiento, velocidad, fuerza y estado de daño finales, y la energía + cinética de cada nodo. + +El ``balance`` de energía es una comprobación de la simulación: debe ser una +fracción pequeña (menos del 1 %) del trabajo externo final. La energía cinética +total es ``energy.kinetic``; la de cada nodo está en ``final.kineticEnergy``. ``results.mat`` contiene esta estructura y se carga sin el paquete: @@ -85,7 +114,10 @@ Archivos de salida La estructura ``results`` (formato v7.3, legible desde Python con ``h5py``). ``snapshot_0000.mac``, ``snapshot_0001.mac``, ... Macros de ANSYS con el reticulado deformado. Las barras son elementos de - tipo 1 (intactas), 2 (dañadas) y 5 (rotas). + tipo 1 (intactas), 2 (dañadas) y 5 (rotas). Los grados de libertad fijos + se listan como ``D,nodo,dirección`` y el desplazamiento impuesto a los + nodos cargados, medido desde su posición inicial, como + ``D,nodo,dirección,valor``. ``snapshot_0000.vtu``, ... y ``snapshots.pvd`` Archivos VTK. Abrir ``snapshots.pvd`` en `ParaView `_; colorear por ``damageState`` (datos de celda) para ver las fisuras y usar @@ -102,4 +134,4 @@ Ejecutar los tests >> addpath tests >> run_tests % tests rápidos - >> run_tests(IncludeSlow=true) % también repite las simulaciones originales + >> run_tests(IncludeSlow=true) % también los tests lentos diff --git a/examples/README.md b/examples/README.md index ebccccd..949bc55 100644 --- a/examples/README.md +++ b/examples/README.md @@ -23,9 +23,5 @@ Outputs are written to an `output/` folder next to the script (ignored by git): | File | Purpose | |------|---------| -| `DATA0.DAT` | Simulation parameters (legacy format, read by `ldem.Parameters.fromFile`) | -| `LET.AN1` | Names of the ANSYS files of the legacy driver (not needed by the new code) | +| `DATA0.DAT` | Simulation parameters (format of the original program, read by `ldem.Parameters.fromFile`) | | `arquivo_3lc_rnao_cv05` | Random field applied to the critical strain of each bar (11 MB) | - -The legacy driver (`legacy/main1.m`) reads its files from the current folder -and writes its outputs there too, so run it from a scratch copy. diff --git a/examples/beam_102/LET.AN1 b/examples/beam_102/LET.AN1 deleted file mode 100644 index 9bdbe3f..0000000 --- a/examples/beam_102/LET.AN1 +++ /dev/null @@ -1,700 +0,0 @@ - ANSYS00.MAC - ANSYS01.MAC - ANSYS02.MAC - ANSYS03.MAC - ANSYS04.MAC - ANSYS05.MAC - ANSYS06.MAC - ANSYS07.MAC - ANSYS08.MAC - ANSYS09.MAC - ANSYS10.MAC - ANSYS11.MAC - ANSYS12.MAC - ANSYS13.MAC - ANSYS14.MAC - ANSYS15.MAC - ANSYS16.MAC - ANSYS17.MAC - ANSYS18.MAC - ANSYS19.MAC - ANSYS20.MAC - ANSYS21.MAC - ANSYS22.MAC - ANSYS23.MAC - ANSYS24.MAC - ANSYS25.MAC - ANSYS26.MAC - ANSYS27.MAC - ANSYS28.MAC - ANSYS29.MAC - ANSYS30.MAC - ANSYS31.MAC - ANSYS32.MAC - ANSYS33.MAC - ANSYS34.MAC - ANSYS35.MAC - ANSYS36.MAC - ANSYS37.MAC - ANSYS38.MAC - ANSYS39.MAC - ANSYS40.MAC - ANSYS41.MAC - ANSYS42.MAC - ANSYS43.MAC - ANSYS44.MAC - ANSYS45.MAC - ANSYS46.MAC - ANSYS47.MAC - ANSYS48.MAC - ANSYS49.MAC - ANSYS50.MAC - ANSYS51.MAC - ANSYS52.MAC - ANSYS53.MAC - ANSYS54.MAC - ANSYS55.MAC - ANSYS56.MAC - ANSYS57.MAC - ANSYS58.MAC - ANSYS59.MAC - ANSYS60.MAC - ANSYS61.MAC - ANSYS62.MAC - ANSYS63.MAC - ANSYS64.MAC - ANSYS65.MAC - ANSYS66.MAC - ANSYS67.MAC - ANSYS68.MAC - ANSYS69.MAC - ANSYS70.MAC - ANSYS71.MAC - ANSYS72.MAC - ANSYS73.MAC - ANSYS74.MAC - ANSYS75.MAC - ANSYS76.MAC - ANSYS77.MAC - ANSYS78.MAC - ANSYS79.MAC - ANSYS80.MAC - ANSYS81.MAC - ANSYS82.MAC - ANSYS83.MAC - ANSYS84.MAC - ANSYS85.MAC - ANSYS86.MAC - ANSYS87.MAC - ANSYS88.MAC - ANSYS89.MAC - ANSYS90.MAC - ANSYS91.MAC - ANSYS92.MAC - ANSYS93.MAC - ANSYS94.MAC - ANSYS95.MAC - ANSYS96.MAC - ANSYS97.MAC - ANSYS98.MAC - ANSYS99.MAC - ANSYS100.MAC - ANSYS101.MAC - ANSYS102.MAC - ANSYS103.MAC - ANSYS104.MAC - ANSYS105.MAC - ANSYS106.MAC - ANSYS107.MAC - ANSYS108.MAC - ANSYS109.MAC - ANSYS110.MAC - ANSYS111.MAC - ANSYS112.MAC - ANSYS113.MAC - ANSYS114.MAC - ANSYS115.MAC - ANSYS116.MAC - ANSYS117.MAC - ANSYS118.MAC - ANSYS119.MAC - ANSYS120.MAC - ANSYS121.MAC - ANSYS122.MAC - ANSYS123.MAC - ANSYS124.MAC - ANSYS125.MAC - ANSYS126.MAC - ANSYS127.MAC - ANSYS128.MAC - ANSYS129.MAC - ANSYS130.MAC - ANSYS131.MAC - ANSYS132.MAC - ANSYS133.MAC - ANSYS134.MAC - ANSYS135.MAC - ANSYS136.MAC - ANSYS137.MAC - ANSYS138.MAC - ANSYS139.MAC - ANSYS140.MAC - ANSYS141.MAC - ANSYS142.MAC - ANSYS143.MAC - ANSYS144.MAC - ANSYS145.MAC - ANSYS146.MAC - ANSYS147.MAC - ANSYS148.MAC - ANSYS149.MAC - ANSYS150.MAC - ANSYS151.MAC - ANSYS152.MAC - ANSYS153.MAC - ANSYS154.MAC - ANSYS155.MAC - ANSYS156.MAC - ANSYS157.MAC - ANSYS158.MAC - ANSYS159.MAC - ANSYS160.MAC - ANSYS161.MAC - ANSYS162.MAC - ANSYS163.MAC - ANSYS164.MAC - ANSYS165.MAC - ANSYS166.MAC - ANSYS167.MAC - ANSYS168.MAC - ANSYS169.MAC - ANSYS170.MAC - ANSYS171.MAC - ANSYS172.MAC - ANSYS173.MAC - ANSYS174.MAC - ANSYS175.MAC - ANSYS176.MAC - ANSYS177.MAC - ANSYS178.MAC - ANSYS179.MAC - ANSYS180.MAC - ANSYS181.MAC - ANSYS182.MAC - ANSYS183.MAC - ANSYS184.MAC - ANSYS185.MAC - ANSYS186.MAC - ANSYS187.MAC - ANSYS188.MAC - ANSYS189.MAC - ANSYS190.MAC - ANSYS191.MAC - ANSYS192.MAC - ANSYS193.MAC - ANSYS194.MAC - ANSYS195.MAC - ANSYS196.MAC - ANSYS197.MAC - ANSYS198.MAC - ANSYS199.MAC - ANSYS200.MAC - ANSYS201.MAC - ANSYS202.MAC - ANSYS203.MAC - ANSYS204.MAC - ANSYS205.MAC - ANSYS206.MAC - ANSYS207.MAC - ANSYS208.MAC - ANSYS209.MAC - ANSYS210.MAC - ANSYS211.MAC - ANSYS212.MAC - ANSYS213.MAC - ANSYS214.MAC - ANSYS215.MAC - ANSYS216.MAC - ANSYS217.MAC - ANSYS218.MAC - ANSYS219.MAC - ANSYS220.MAC - ANSYS221.MAC - ANSYS222.MAC - ANSYS223.MAC - ANSYS224.MAC - ANSYS225.MAC - ANSYS226.MAC - ANSYS227.MAC - ANSYS228.MAC - ANSYS229.MAC - ANSYS230.MAC - ANSYS231.MAC - ANSYS232.MAC - ANSYS233.MAC - ANSYS234.MAC - ANSYS235.MAC - ANSYS236.MAC - ANSYS237.MAC - ANSYS238.MAC - ANSYS239.MAC - ANSYS240.MAC - ANSYS241.MAC - ANSYS242.MAC - ANSYS243.MAC - ANSYS244.MAC - ANSYS245.MAC - ANSYS246.MAC - ANSYS247.MAC - ANSYS248.MAC - ANSYS249.MAC - ANSYS250.MAC - ANSYS251.MAC - ANSYS252.MAC - ANSYS253.MAC - ANSYS254.MAC - ANSYS255.MAC - ANSYS256.MAC - ANSYS257.MAC - ANSYS258.MAC - ANSYS259.MAC - ANSYS260.MAC - ANSYS261.MAC - ANSYS262.MAC - ANSYS263.MAC - ANSYS264.MAC - ANSYS265.MAC - ANSYS266.MAC - ANSYS267.MAC - ANSYS268.MAC - ANSYS269.MAC - ANSYS270.MAC - ANSYS271.MAC - ANSYS272.MAC - ANSYS273.MAC - ANSYS274.MAC - ANSYS275.MAC - ANSYS276.MAC - ANSYS277.MAC - ANSYS278.MAC - ANSYS279.MAC - ANSYS280.MAC - ANSYS281.MAC - ANSYS282.MAC - ANSYS283.MAC - ANSYS284.MAC - ANSYS285.MAC - ANSYS286.MAC - ANSYS287.MAC - ANSYS288.MAC - ANSYS289.MAC - ANSYS290.MAC - ANSYS291.MAC - ANSYS292.MAC - ANSYS293.MAC - ANSYS294.MAC - ANSYS295.MAC - ANSYS296.MAC - ANSYS297.MAC - ANSYS298.MAC - ANSYS299.MAC - ANSYS300.MAC - ANSYS301.MAC - ANSYS302.MAC - ANSYS303.MAC - ANSYS304.MAC - ANSYS305.MAC - ANSYS306.MAC - ANSYS307.MAC - ANSYS308.MAC - ANSYS309.MAC - ANSYS310.MAC - ANSYS311.MAC - ANSYS312.MAC - ANSYS113.MAC - ANSYS114.MAC - ANSYS115.MAC - ANSYS116.MAC - ANSYS117.MAC - ANSYS118.MAC - ANSYS119.MAC - ANSYS120.MAC - ANSYS121.MAC - ANSYS122.MAC - ANSYS123.MAC - ANSYS124.MAC - ANSYS125.MAC - ANSYS126.MAC - ANSYS127.MAC - ANSYS128.MAC - ANSYS129.MAC - ANSYS130.MAC - ANSYS131.MAC - ANSYS132.MAC - ANSYS133.MAC - ANSYS134.MAC - ANSYS135.MAC - ANSYS136.MAC - ANSYS137.MAC - ANSYS138.MAC - ANSYS139.MAC - ANSYS140.MAC - ANSYS141.MAC - ANSYS142.MAC - ANSYS143.MAC - ANSYS144.MAC - ANSYS145.MAC - ANSYS146.MAC - ANSYS147.MAC - ANSYS148.MAC - ANSYS149.MAC - ANSYS150.MAC - ANSYS151.MAC - ANSYS152.MAC - ANSYS153.MAC - ANSYS154.MAC - ANSYS155.MAC - ANSYS156.MAC - ANSYS157.MAC - ANSYS158.MAC - ANSYS159.MAC - ANSYS160.MAC - ANSYS161.MAC - ANSYS162.MAC - ANSYS163.MAC - ANSYS164.MAC - ANSYS165.MAC - ANSYS166.MAC - ANSYS167.MAC - ANSYS168.MAC - ANSYS169.MAC - ANSYS170.MAC - ANSYS171.MAC - ANSYS172.MAC - ANSYS173.MAC - ANSYS174.MAC - ANSYS175.MAC - ANSYS176.MAC - ANSYS177.MAC - ANSYS178.MAC - ANSYS179.MAC - ANSYS180.MAC - ANSYS181.MAC - ANSYS182.MAC - ANSYS183.MAC - ANSYS184.MAC - ANSYS185.MAC - ANSYS186.MAC - ANSYS187.MAC - ANSYS188.MAC - ANSYS189.MAC - ANSYS190.MAC - ANSYS191.MAC - ANSYS192.MAC - ANSYS193.MAC - ANSYS194.MAC - ANSYS195.MAC - ANSYS196.MAC - ANSYS197.MAC - ANSYS198.MAC - ANSYS199.MAC - ANSYS200.MAC - ANSYS201.MAC - ANSYS202.MAC - ANSYS203.MAC - ANSYS204.MAC - ANSYS205.MAC - ANSYS206.MAC - ANSYS207.MAC - ANSYS208.MAC - ANSYS209.MAC - ANSYS210.MAC - ANSYS211.MAC - ANSYS212.MAC - ANSYS213.MAC - ANSYS214.MAC - ANSYS215.MAC - ANSYS216.MAC - ANSYS217.MAC - ANSYS218.MAC - ANSYS219.MAC - ANSYS220.MAC - ANSYS221.MAC - ANSYS222.MAC - ANSYS223.MAC - ANSYS224.MAC - ANSYS225.MAC - ANSYS226.MAC - ANSYS227.MAC - ANSYS228.MAC - ANSYS229.MAC - ANSYS230.MAC - ANSYS231.MAC - ANSYS232.MAC - ANSYS233.MAC - ANSYS234.MAC - ANSYS235.MAC - ANSYS236.MAC - ANSYS237.MAC - ANSYS238.MAC - ANSYS239.MAC - ANSYS240.MAC - ANSYS241.MAC - ANSYS242.MAC - ANSYS243.MAC - ANSYS244.MAC - ANSYS245.MAC - ANSYS246.MAC - ANSYS247.MAC - ANSYS248.MAC - ANSYS249.MAC - ANSYS250.MAC - ANSYS251.MAC - ANSYS252.MAC - ANSYS253.MAC - ANSYS254.MAC - ANSYS255.MAC - ANSYS256.MAC - ANSYS257.MAC - ANSYS258.MAC - ANSYS259.MAC - ANSYS260.MAC - ANSYS261.MAC - ANSYS262.MAC - ANSYS263.MAC - ANSYS264.MAC - ANSYS265.MAC - ANSYS266.MAC - ANSYS267.MAC - ANSYS268.MAC - ANSYS269.MAC - ANSYS270.MAC - ANSYS271.MAC - ANSYS272.MAC - ANSYS273.MAC - ANSYS274.MAC - ANSYS275.MAC - ANSYS276.MAC - ANSYS277.MAC - ANSYS278.MAC - ANSYS279.MAC - ANSYS280.MAC - ANSYS281.MAC - ANSYS282.MAC - ANSYS283.MAC - ANSYS284.MAC - ANSYS285.MAC - ANSYS286.MAC - ANSYS287.MAC - ANSYS288.MAC - ANSYS289.MAC - ANSYS290.MAC - ANSYS291.MAC - ANSYS292.MAC - ANSYS293.MAC - ANSYS294.MAC - ANSYS295.MAC - ANSYS296.MAC - ANSYS297.MAC - ANSYS298.MAC - ANSYS299.MAC - ANSYS300.MAC - ANSYS301.MAC - ANSYS302.MAC - ANSYS303.MAC - ANSYS304.MAC - ANSYS305.MAC - ANSYS306.MAC - ANSYS307.MAC - ANSYS308.MAC - ANSYS309.MAC - ANSYS310.MAC - ANSYS311.MAC - ANSYS312.MAC - ANSYS313.MAC - ANSYS314.MAC - ANSYS315.MAC - ANSYS316.MAC - ANSYS317.MAC - ANSYS318.MAC - ANSYS319.MAC - ANSYS320.MAC - ANSYS321.MAC - ANSYS322.MAC - ANSYS323.MAC - ANSYS324.MAC - ANSYS325.MAC - ANSYS326.MAC - ANSYS327.MAC - ANSYS328.MAC - ANSYS329.MAC - ANSYS330.MAC - ANSYS331.MAC - ANSYS332.MAC - ANSYS333.MAC - ANSYS334.MAC - ANSYS335.MAC - ANSYS336.MAC - ANSYS337.MAC - ANSYS338.MAC - ANSYS339.MAC - ANSYS340.MAC - ANSYS341.MAC - ANSYS342.MAC - ANSYS343.MAC - ANSYS344.MAC - ANSYS345.MAC - ANSYS346.MAC - ANSYS347.MAC - ANSYS348.MAC - ANSYS349.MAC - ANSYS350.MAC - ANSYS351.MAC - ANSYS352.MAC - ANSYS353.MAC - ANSYS354.MAC - ANSYS355.MAC - ANSYS356.MAC - ANSYS357.MAC - ANSYS358.MAC - ANSYS359.MAC - ANSYS360.MAC - ANSYS361.MAC - ANSYS362.MAC - ANSYS363.MAC - ANSYS364.MAC - ANSYS365.MAC - ANSYS366.MAC - ANSYS367.MAC - ANSYS368.MAC - ANSYS369.MAC - ANSYS370.MAC - ANSYS371.MAC - ANSYS372.MAC - ANSYS373.MAC - ANSYS374.MAC - ANSYS375.MAC - ANSYS376.MAC - ANSYS377.MAC - ANSYS378.MAC - ANSYS379.MAC - ANSYS380.MAC - ANSYS381.MAC - ANSYS382.MAC - ANSYS383.MAC - ANSYS384.MAC - ANSYS385.MAC - ANSYS386.MAC - ANSYS387.MAC - ANSYS388.MAC - ANSYS389.MAC - ANSYS390.MAC - ANSYS391.MAC - ANSYS392.MAC - ANSYS393.MAC - ANSYS394.MAC - ANSYS395.MAC - ANSYS396.MAC - ANSYS397.MAC - ANSYS398.MAC - ANSYS399.MAC - ANSYS400.MAC - ANSYS401.MAC - ANSYS402.MAC - ANSYS403.MAC - ANSYS404.MAC - ANSYS405.MAC - ANSYS406.MAC - ANSYS407.MAC - ANSYS408.MAC - ANSYS409.MAC - ANSYS410.MAC - ANSYS411.MAC - ANSYS412.MAC - ANSYS413.MAC - ANSYS414.MAC - ANSYS415.MAC - ANSYS416.MAC - ANSYS417.MAC - ANSYS418.MAC - ANSYS419.MAC - ANSYS420.MAC - ANSYS421.MAC - ANSYS422.MAC - ANSYS423.MAC - ANSYS424.MAC - ANSYS425.MAC - ANSYS426.MAC - ANSYS427.MAC - ANSYS428.MAC - ANSYS429.MAC - ANSYS430.MAC - ANSYS431.MAC - ANSYS432.MAC - ANSYS433.MAC - ANSYS434.MAC - ANSYS435.MAC - ANSYS436.MAC - ANSYS437.MAC - ANSYS438.MAC - ANSYS439.MAC - ANSYS440.MAC - ANSYS441.MAC - ANSYS442.MAC - ANSYS443.MAC - ANSYS444.MAC - ANSYS445.MAC - ANSYS446.MAC - ANSYS447.MAC - ANSYS448.MAC - ANSYS449.MAC - ANSYS450.MAC - ANSYS451.MAC - ANSYS452.MAC - ANSYS453.MAC - ANSYS454.MAC - ANSYS455.MAC - ANSYS456.MAC - ANSYS457.MAC - ANSYS458.MAC - ANSYS459.MAC - ANSYS460.MAC - ANSYS461.MAC - ANSYS462.MAC - ANSYS463.MAC - ANSYS464.MAC - ANSYS465.MAC - ANSYS466.MAC - ANSYS467.MAC - ANSYS468.MAC - ANSYS469.MAC - ANSYS470.MAC - ANSYS471.MAC - ANSYS472.MAC - ANSYS473.MAC - ANSYS474.MAC - ANSYS475.MAC - ANSYS476.MAC - ANSYS477.MAC - ANSYS478.MAC - ANSYS479.MAC - ANSYS480.MAC - ANSYS481.MAC - ANSYS482.MAC - ANSYS483.MAC - ANSYS484.MAC - ANSYS485.MAC - ANSYS486.MAC - ANSYS487.MAC - ANSYS488.MAC - ANSYS489.MAC - ANSYS490.MAC - ANSYS491.MAC - ANSYS492.MAC - ANSYS493.MAC - ANSYS494.MAC - ANSYS495.MAC - ANSYS496.MAC - ANSYS497.MAC - ANSYS498.MAC - ANSYS499.MAC diff --git a/legacy/ANSYS.m b/legacy/ANSYS.m deleted file mode 100644 index fa65e2f..0000000 --- a/legacy/ANSYS.m +++ /dev/null @@ -1,392 +0,0 @@ - -function ini= ANSYS(IFILE,CONT1,CONT2,CONT3,CONT4,CONT5,CONT6) -global INT INB U V W U0 V0 W0 BDX BDY BDZ VLX VLY VLZ -global ACX ACY ACZ FRX FRY FRZ FX FY FZ MAS MSS CN ENR -global EDG E1 E2 LI DEQB F YNGB GFRB LCRB EPRB EP SS EM -global EN KR KR1 DSS DM FS CAF DT GFR DEQ LCR TEST EST -global DF DF1 DF2 DMP1 DMP2 TDAF CON M N L M1 N1 L1 MNL -global NNO NNS NNT NBA NBS NBT INCO NCON STEP NSTEP NDAMF -global RUN NRUN LCO TIME TTOT PSN ROH YNG EPR EPMAX EPMIN -global MEAN COEV ENEX ENCN ENEL ENGD ENDP ENIN DEN DERIV -global XB YB ZB UBAR VBAR WBAR REACAOX REACAOY REACAOZ -global STRAIN STRESS SEED DM DS - -% SUBROUTINE ANSYS (IFILE,CONT1,CONT2,CONT3,CONT4,CONT5,CONT6) -% ! ================ -% ! -% ! DATA: 14/10/1992 -% ! AUTOR: IGNACIO ITURRIOZ -% ! -% ! Esta subrotina gera arquivos *.ans (arquivos que permitem realizar -% ! saída gráfica compatível com o Ansys). -% ! -% !-------------------------------------------------------------------------- -% PARAMETER (INN=1.2E6,INB=6E6,IRU=6,INCON=10) -% !-------------------------------------------------------------------------- -% ! DEFINIÇÃO DE VARIÁVEIS E GRUPOS COMUNS -% INCLUDE 'COMMON.FOR' -% !-------------------------------------------------------------------------- -% INTEGER NOI,NOF -% LOGICAL LABEL1,LABEL2,LABEL3,LABEL4,LABEL5,LABEL6 -% DOUBLE PRECISION ro,ri(INN),aba -% LOGICAL logic1,logic2,logic3,Logic4,logic5 -% integer cont1,cont2,cont3,cont4,cont5,cont6 -% !variables for the test 5102( fretting test) -% LOGICAL LABEL31,LABEL32,LABEL41,LABEL42 -% DOUBLE PRECISION Asigmax,a,th,AP,AQ,cfric,alph_sig,alph_q,Qast -% DOUBLE PRECISION Past,po,c,xmid,Q,cp,sigmab,eep,pp,xi,ee -% DOUBLE PRECISION Atemp,Qtpdt,qq,coef,rad_noi,rad_nof -% !-------------------------------------------------------------------------- -% ! -% !-------------------------------------------------------------------------- -% WRITE (IFILE,*) '/PREP7' -% WRITE (IFILE,*) '/TITLE, TEMPO =',TIME -% WRITE (IFILE,*) 'ET,1,4' -% WRITE (IFILE,*) 'ET,2,4' -% WRITE (IFILE,*) 'ET,IFILE,4' -% WRITE (IFILE,*) 'ET,4,4' -% WRITE (IFILE,*) 'ET,5,4' -% WRITE (IFILE,*) 'ET,6,4' -% WRITE (IFILE,*) 'ET,8,4' -% WRITE (IFILE,*) 'ET,9,4' -% WRITE (IFILE,*) 'ET,10,4' -% WRITE (IFILE,*) 'ET,11,4' -% WRITE (IFILE,*) 'ET,12,4' -% WRITE (IFILE,*) 'MP,EX,1,2E10' -% WRITE (IFILE,*) 'MP,PRXY,1,0.25' -% WRITE (IFILE,*) 'MP,DENS,1,2500' -% WRITE (IFILE,*) 'R,1,0.13,0.0014,0.36' -% WRITE (IFILE,*) -% !-------------------------------------------------------------------------- -% WRITE (IFILE,*) '!COORDENADAS NODAIS' -% !-------------------------------------------------------------------------- -% DO I=1,NNT -% -% WRITE (IFILE,*) 'N,',I,',',SNGL(U(3,I)),',',SNGL(V(3,I)),',', & -% & SNGL(W(3,I)) -% END DO -% WRITE (IFILE,*) -% !-------------------------------------------------------------------------- -% WRITE (IFILE,*) '!CONECTIVIDADES DOS ELEMENTOS' -% !-------------------------------------------------------------------------- -% CONT1=0 -% CONT2=0 -% CONT3=0 -% CONT4=0 -% CONT5=0 -% CONT6=0 -% CONT7=0 -% -% Write(*,*)DM(1),FS(1) -% -% DO I=1,NBT -% NOI=CN(2*I-1) -% NOF=CN(2*I) -% -% ! -% -% !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! -% -% IF((DM(I)))THEN -% -% WRITE (IFILE,*) 'TYPE,1' -% WRITE (IFILE,*) 'E',',',CN(2*I-1),',',CN(2*I),',!EL',I -% CONT1=CONT1+1 -% else -% -% IF (FS(I)) THEN -% ! BARRAS DANIFICADAS - COR LARANJA -% WRITE (IFILE,*) 'TYPE,2' -% WRITE (IFILE,*) 'E',',',CN(2*I-1),',',CN(2*I),',!EL',I -% CONT2=CONT2+1 -% ELSE -% ! BARRAS ROMPIDAS - COR VERMELHA -% WRITE (IFILE,*) 'TYPE,5' -% WRITE (IFILE,*) 'E',',',CN(2*I-1),',',CN(2*I),',!EL',I -% CONT5=CONT5+1 -% END IF -% END IF -% ! -% END DO -% -% WRITE (IFILE,*) -% WRITE (IFILE,*) '!CORES DOS ELEMENTOS' -% !-------------------------------------------------------------------------- -% -% -% WRITE (IFILE,*) 'ESEL,S,TYPE,,1' -% WRITE (IFILE,*) '/COLOR,ELEM,GCYA' -% WRITE (IFILE,*) '/PNUM,TYPE,0' -% WRITE (IFILE,*) '/NUMBER,1' -% WRITE (IFILE,*) 'ESEL,ALL' -% -% WRITE (IFILE,*) 'ESEL,S,TYPE,,2' -% WRITE (IFILE,*) '/COLOR,ELEM,ORAN' -% WRITE (IFILE,*) '/PNUM,TYPE,0' -% WRITE (IFILE,*) '/NUMBER,1' -% WRITE (IFILE,*) 'ESEL,ALL' -% ! -% WRITE (IFILE,*) 'ESEL,S,TYPE,,5' -% WRITE (IFILE,*) '/COLOR,ELEM,RED' -% WRITE (IFILE,*) '/PNUM,TYPE,0' -% WRITE (IFILE,*) '/NUMBER,1' -% WRITE (IFILE,*) 'ESEL,ALL' -% -% WRITE (IFILE,*) 'ESEL,S,TYPE,,6' -% WRITE (IFILE,*) '/COLOR,ELEM,GREE' -% WRITE (IFILE,*) '/PNUM,TYPE,0' -% WRITE (IFILE,*) '/NUMBER,1' -% WRITE (IFILE,*) 'ESEL,ALL' -% -% -% !-------------------------------------------------------------------------- -% WRITE (IFILE,*) '!CONDIÇÕES DE CONTORNO' -% !-------------------------------------------------------------------------- -% IF (TEST.EQ.102) THEN -% DO I=1,NNT -% IF (BDX(I).EQ.1) THEN -% WRITE (IFILE,*) 'D,',I,',','UX' -% END IF -% IF (BDY(I).EQ.1) THEN -% WRITE (IFILE,*) 'D,',I,',','UY' -% END IF -% IF (BDZ(I).EQ.1) THEN -% WRITE (IFILE,*) 'D,',I,',','UZ' -% END IF -% END DO -% END IF -% WRITE (IFILE,*) -% !WRITE (IFILE,*) 'D,',ncon(1),',','UY' -% !WRITE (IFILE,*) 'D,',ncon(2),',','UY' -% !WRITE (IFILE,*) 'D,',ncon(3),',','UY' -% !WRITE (IFILE,*) 'D,',ncon(4),',','UY' -% !WRITE (IFILE,*) 'D,',ncon(5),',','UY' -% !WRITE (IFILE,*) 'D,',ncon(6),',','UY' -% !WRITE (IFILE,*) 'D,',ncon(7),',','UY' -% !WRITE (IFILE,*) 'D,',ncon(8),',','UY' -% !WRITE (IFILE,*) 'D,',ncon(9),',','UY' -% !WRITE (IFILE,*) 'D,',ncon(10),',','UY' -% -% -% !-------------------------------------------------------------------------- -% WRITE (IFILE,*) '!CARGAS APLICADAS' -% !-------------------------------------------------------------------------- -% IF (TEST.EQ.102) THEN -% -% -% -% DO I=1,NNT -% LOGIC1=u0(I).LT.((M1-0.49)*LCo).AND.u0(I).GT.((M1-0.51)*LCo) -% LOGIC2=(V0(i).GT.(50.5-0.1)*Lco).AND.(V0(i).LT.(51.5+0.1)*Lco) -% IF(LOGIC1.AND.LOGIC2)THEN -% -% WRITE (IFILE,*) 'F,',I,',','Fx',',',-10 -% END IF -% ENDDO -% END IF -% ! -% WRITE (IFILE,*) -% !-------------------------------------------------------------------------- -% WRITE (IFILE,*) '/VIEW,1,0,-1,0' -% WRITE (IFILE,*) 'EPLOT' -% WRITE (IFILE,*) -% !-------------------------------------------------------------------------- -% WRITE (IFILE,*) '!ESTADO DAS BARRAS' -% !-------------------------------------------------------------------------- -% WRITE (IFILE,*)'!BARRAS INTACTAS =',' ',CONT1+CONT3+CONT6 -% WRITE (IFILE,*)'!BARRAS DANIFICADAS =',' ',CONT2+CONT4 -% WRITE (IFILE,*)'!BARRAS ROMPIDAS =',' ',CONT5 -% WRITE (IFILE,*) -% -% ! Imprimir número de barras e em que estado estão -% OPEN (UNIT=30,ACCESS='SEQUENTIAL',FILE='BARR_ROMP.dat', & -% & STATUS='UNKNOWN') -% WRITE (30,100) TIME,VF,CONT1,CONT2,CONT5 -% 100 FORMAT (E12.6,3X,E12.6,3X,I7,3X,I7,3X,I7) -% ! -% -% RETURN -% END -%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -% -% DATA: 14/10/1992 -% AUTOR: IGNACIO ITURRIOZ -% -% Esta subrotina gera arquivos *.ans (arquivos que permitem realizar -% saída gráfica compatível com o Ansys). -% -% Translates the Fortran SUBROUTINE ANSYS. -% IFILE = open file handle for the *.ans output file. - -%========================================================================== -% HEADER / SETUP -%========================================================================== -fprintf(IFILE, '/PREP7\n'); -fprintf(IFILE, '/TITLE, TEMPO =%g\n', TIME); -fprintf(IFILE, 'ET,1,4\n'); -fprintf(IFILE, 'ET,2,4\n'); -fprintf(IFILE, 'ET,IFILE,4\n'); -fprintf(IFILE, 'ET,4,4\n'); -fprintf(IFILE, 'ET,5,4\n'); -fprintf(IFILE, 'ET,6,4\n'); -fprintf(IFILE, 'ET,8,4\n'); -fprintf(IFILE, 'ET,9,4\n'); -fprintf(IFILE, 'ET,10,4\n'); -fprintf(IFILE, 'ET,11,4\n'); -fprintf(IFILE, 'ET,12,4\n'); -fprintf(IFILE, 'MP,EX,1,2E10\n'); -fprintf(IFILE, 'MP,PRXY,1,0.25\n'); -fprintf(IFILE, 'MP,DENS,1,2500\n'); -fprintf(IFILE, 'R,1,0.13,0.0014,0.36\n'); -fprintf(IFILE, '\n'); - -%-------------------------------------------------------------------------- -% NODAL COORDINATES -%-------------------------------------------------------------------------- -fprintf(IFILE, '!COORDENADAS NODAIS\n'); - -for I = 1:NNT - fprintf(IFILE, 'N,%d,%g,%g,%g\n', ... - I, single(U(3,I)), single(V(3,I)), single(W(3,I))); -end -fprintf(IFILE, '\n'); - -%-------------------------------------------------------------------------- -% ELEMENT CONNECTIVITIES -%-------------------------------------------------------------------------- -fprintf(IFILE, '!CONECTIVIDADES DOS ELEMENTOS\n'); - -CONT1 = 0; -CONT2 = 0; -CONT3 = 0; -CONT4 = 0; -CONT5 = 0; -CONT6 = 0; -CONT7 = 0; - -fprintf(1, '%d %d\n', DM(1), FS(1)); - -for I = 1:NBT - NOI = CN(2*I - 1); - NOF = CN(2*I); - - if DM(I) - % --- intact bars (not yet damaged) ------------------------------ - fprintf(IFILE, 'TYPE,1\n'); - fprintf(IFILE, 'E,%d,%d,!EL%d\n', CN(2*I-1), CN(2*I), I); - CONT1 = CONT1 + 1; - - elseif FS(I) - % --- damaged bars (orange) -------------------------------------- - fprintf(IFILE, 'TYPE,2\n'); - fprintf(IFILE, 'E,%d,%d,!EL%d\n', CN(2*I-1), CN(2*I), I); - CONT2 = CONT2 + 1; - - else - % --- broken bars (red) ------------------------------------------ - fprintf(IFILE, 'TYPE,5\n'); - fprintf(IFILE, 'E,%d,%d,!EL%d\n', CN(2*I-1), CN(2*I), I); - CONT5 = CONT5 + 1; - end -end - -fprintf(IFILE, '\n'); -fprintf(IFILE, '!CORES DOS ELEMENTOS\n'); - -%-------------------------------------------------------------------------- -% ELEMENT COLORS (per TYPE) -%-------------------------------------------------------------------------- -fprintf(IFILE, 'ESEL,S,TYPE,,1\n'); -fprintf(IFILE, '/COLOR,ELEM,GCYA\n'); -fprintf(IFILE, '/PNUM,TYPE,0\n'); -fprintf(IFILE, '/NUMBER,1\n'); -fprintf(IFILE, 'ESEL,ALL\n'); - -fprintf(IFILE, 'ESEL,S,TYPE,,2\n'); -fprintf(IFILE, '/COLOR,ELEM,ORAN\n'); -fprintf(IFILE, '/PNUM,TYPE,0\n'); -fprintf(IFILE, '/NUMBER,1\n'); -fprintf(IFILE, 'ESEL,ALL\n'); - -fprintf(IFILE, 'ESEL,S,TYPE,,5\n'); -fprintf(IFILE, '/COLOR,ELEM,RED\n'); -fprintf(IFILE, '/PNUM,TYPE,0\n'); -fprintf(IFILE, '/NUMBER,1\n'); -fprintf(IFILE, 'ESEL,ALL\n'); - -fprintf(IFILE, 'ESEL,S,TYPE,,6\n'); -fprintf(IFILE, '/COLOR,ELEM,GREE\n'); -fprintf(IFILE, '/PNUM,TYPE,0\n'); -fprintf(IFILE, '/NUMBER,1\n'); -fprintf(IFILE, 'ESEL,ALL\n'); - -%-------------------------------------------------------------------------- -% BOUNDARY CONDITIONS -%-------------------------------------------------------------------------- -fprintf(IFILE, '!CONDIÇÕES DE CONTORNO\n'); - -if TEST == 102 - for I = 1:NNT - if BDX(I) == 1 - fprintf(IFILE, 'D,%d,UX\n', I); - end - if BDY(I) == 1 - fprintf(IFILE, 'D,%d,UY\n', I); - end - if BDZ(I) == 1 - fprintf(IFILE, 'D,%d,UZ\n', I); - end - end -end - -fprintf(IFILE, '\n'); -% --- Commented-out D-constraints from original code kept here for reference -% fprintf(IFILE, 'D,%d,UY\n', ncon(1)); -% ... (etc.) - -%-------------------------------------------------------------------------- -% APPLIED LOADS -%-------------------------------------------------------------------------- -fprintf(IFILE, '!CARGAS APLICADAS\n'); - -if TEST == 102 - for I = 1:NNT - LOGIC1 = (U0(I) < (M1 - 0.49) * LCO) && (U0(I) > (M1 - 0.51) * LCO); - LOGIC2 = (V0(I) > (50.5 - 0.1) * LCO) && (V0(I) < (51.5 + 0.1) * LCO); - - if LOGIC1 && LOGIC2 - fprintf(IFILE, 'F,%d,Fx,%d\n', I, -10); - end - end -end - -fprintf(IFILE, '\n'); - -%-------------------------------------------------------------------------- -% VIEW / PLOT -%-------------------------------------------------------------------------- -fprintf(IFILE, '/VIEW,1,0,-1,0\n'); -fprintf(IFILE, 'EPLOT\n'); -fprintf(IFILE, '\n'); - -%-------------------------------------------------------------------------- -% BAR STATE SUMMARY -%-------------------------------------------------------------------------- -fprintf(IFILE, '!ESTADO DAS BARRAS\n'); -fprintf(IFILE, '!BARRAS INTACTAS = %d\n', CONT1 + CONT3 + CONT6); -fprintf(IFILE, '!BARRAS DANIFICADAS = %d\n', CONT2 + CONT4); -fprintf(IFILE, '!BARRAS ROMPIDAS = %d\n', CONT5); -fprintf(IFILE, '\n'); - -%-------------------------------------------------------------------------- -% Separate bar-state summary file -% Fortran: OPEN (UNIT=30,FILE='BARR_ROMP.dat',STATUS='UNKNOWN') -% FORMAT (E12.6,3X,E12.6,3X,I7,3X,I7,3X,I7) -%-------------------------------------------------------------------------- -VF=1.0 -fid30 = fopen('BARR_ROMP.dat', 'w'); -fprintf(fid30, '%12.6E %12.6E %7d %7d %7d\n', ... - TIME, VF, CONT1, CONT2, CONT5); -fclose(fid30); - ini=1; - end diff --git a/legacy/BOUND.m b/legacy/BOUND.m deleted file mode 100644 index b9f8f50..0000000 --- a/legacy/BOUND.m +++ /dev/null @@ -1,137 +0,0 @@ - -function ini=BOUND() -% BOUND Determina as condições de contorno da estrutura. -% Deve ser adaptada para cada exemplo testado. -global INT INB U V W U0 V0 W0 BDX BDY BDZ VLX VLY VLZ -global ACX ACY ACZ FRX FRY FRZ FX FY FZ MAS MSS CN ENR -global EDG E1 E2 LI DEQB F YNGB GFRB LCRB EPRB EP SS EM -global EN KR KR1 DSS DM FS CAF DT GFR DEQ LCR TEST EST -global DF DF1 DF2 DMP1 DMP2 TDAF CON M N L M1 N1 L1 MNL -global NNO NNS NNT NBA NBS NBT INCO NCON STEP NSTEP NDAMF -global RUN NRUN LCO TIME TTOT PSN ROH YNG EPR EPMAX EPMIN -global MEAN COEV ENEX ENCN ENEL ENGD ENDP ENIN DEN DERIV -global XB YB ZB UBAR VBAR WBAR REACAOX REACAOY REACAOZ -global STRAIN STRESS SEED DM FS - -%! Esta subrotina determina as condições de contorno da estrutura. - -%!-------------------------------------------------------------------------- - - -BDX=zeros(NNT,1); -BDY=zeros(NNT,1); -BDZ=zeros(NNT,1); -%!-------------------------------------------------------------------------- -%! ADAPTAR PARA CADA EXEMPLO TESTADO -%!-------------------------------------------------------------------------- -%! - - -% -% ! -% ! TEST = 101 -% IF (TEST.EQ.101) THEN -% -% DO I=1,NNT -% -% Logic2=(u0(I).LT.(0.51*LCO)).AND.(u0(I).GT.(0.49*LCO)) -% -% IF (Logic2) THEN -% BDX(I)=1 -% ! BDY(I)=1 -% ! BDZ(I)=1 -% ! write(*,*) "nobound=",I -% END IF -% -% Logic2=(u0(I).GT.(M1-0.51*LCO)).AND.(u0(I).LT.(M1-0.49*LCO)) -% -% IF (Logic2) THEN -% BDX(I)=1 -% ! BDY(I)=1 -% ! BDZ(I)=1 -% ! write(*,*) "nobound=",I -% END IF -% -% END DO -% END IF -% -% IF (TEST.EQ.102) THEN -% -% DO I=1,NNT -% Logic1=(v0(I).GT.(0.49*LCO)).AND.(v0(I).LT.(0.51*LCO)) -% Logic2=(u0(I).LT.(4.51*LCO)).AND.(u0(I).GT.(4.49*LCO)) -% IF (Logic1.AND.Logic2) THEN -% BDX(I)=1 -% BDY(I)=1 -% epsL! BDZ(I)=1 -% ! write(*,*) "nobound=",I -% END IF -% Logic1=(u0(I).GT.((M1-4.51)*LCO)).AND.(u0(I).LT.((M1-4.49)*LCO)) -% Logic2=(v0(I).LT.(0.51*LCO)).AND.(v0(I).GT.(0.49*LCO)) -% IF(Logic1.AND.Logic2) THEN -% BDy(I)=1 -% ! BDZ(I)=1 -% ! write(*,*) "nobound2=",I -% END IF -% END DO -% DO I=1,NNT -% LOGIC1=u0(I).LT.((M1-33.49)*LCO).AND.u0(I).GT.((M1-33.51)*LCO) -% LOGIC3=v0(I).LT.((N1-0.49)*LCO).AND.v0(I).GT.((N1-0.51)*LCO) -% LOGIC2=u0(I).LT.((33.51)*LCO).AND.u0(I).GT.((33.49)*LCO) -% IF(LOGIC1.AND.LOGIC3)THEN -% BDy(I)=1 -% endif -% IF(LOGIC2.AND.LOGIC3)THEN -% BDy(I)=1 -% endif -% -% END DO -% END IF -% RETURN -% END -% -% FIX: ini was only assigned inside "if TEST == 102", so TEST 101 failed with -% "output argument ini not assigned". Assign it unconditionally. -% NOTE (not changed, physics frozen): in TEST 101 mask2 uses (M1 - 0.51*LCO) -% instead of (M1 - 0.51)*LCO, so it selects no nodes. -ini = 1; - -if TEST == 101 - - % Masks for the two conditions (operate on all elements at once) - mask1 = (U0 < (0.51 * LCO)) & (U0 > (0.49 * LCO)); - mask2 = (U0 > (M1 - 0.51 * LCO)) & (U0 < (M1 - 0.49 * LCO)); - - % Apply BDX=1 where either condition is true - BDX(mask1 | mask2) = 1; - -end - -if TEST == 102 - - % --- First block of conditions (replaces the first loop) --- - mask1 = (V0 > (0.49 * LCO)) & (V0 < (0.51 * LCO)) & ... - (U0 < (4.51 * LCO)) & (U0 > (4.49 * LCO)); - - mask2 = (U0 > ((M1 - 4.51) * LCO)) & (U0 < ((M1 - 4.49) * LCO)) & ... - (V0 < (0.51 * LCO)) & (V0 > (0.49 * LCO)); - - % Apply the assignments - BDX(mask1) = 1; - BDY(mask1) = 1; - BDY(mask2) = 1; % Originally BDy -> unified to BDY (Fortran is case-insensitive) - - - % --- S econd block of conditions (replaces the second loop) --- - mask3 = (U0 < ((M1 - 33.49) * LCO)) & (U0 > ((M1 - 33.51) * LCO)) & ... - (V0 < ((N1 - 0.49) * LCO)) & (V0 > ((N1 - 0.51) * LCO)); - - mask4 = (U0 < (33.51 * LCO)) & (U0 > (33.49 * LCO)) & ... - (V0 < ((N1 - 0.49) * LCO)) & (V0 > ((N1 - 0.51) * LCO)); - - % Apply BDY=1 where mask3 or mask4 are true - BDY(mask3 | mask4) = 1; - - - ini=1; - end diff --git a/legacy/CABAR.m b/legacy/CABAR.m deleted file mode 100644 index 69b0a3a..0000000 --- a/legacy/CABAR.m +++ /dev/null @@ -1,204 +0,0 @@ - -function ini= CABAR (fid_Lei) -global INT INB U V W U0 V0 W0 BDX BDY BDZ VLX VLY VLZ -global ACX ACY ACZ FRX FRY FRZ FX FY FZ MAS MSS CN ENR -global EDG E1 E2 LI DEQB F YNGB GFRB LCRB EPRB EP SS EM -global EN KR KR1 DSS DM FS CAF DT GFR DEQ LCR TEST EST -global DF DF1 DF2 DMP1 DMP2 TDAF CON M N L M1 N1 L1 MNL -global NNO NNS NNT NBA NBS NBT INCO NCON STEP NSTEP NDAMF -global RUN NRUN LCO TIME TTOT PSN ROH YNG EPR EPMAX EPMIN -global MEAN COEV ENEX ENCN ENEL ENGD ENDP ENIN DEN DERIV -global XB YB ZB UBAR VBAR WBAR REACAOX REACAOY REACAOZ -global STRAIN STRESS SEED -%global FORCE,STR,STRRT,R -%!-------------------------------------------------------------------------- -% SUBROUTINE CABAR -% ! ================ -% -% ! -% ! DATA: 22/03/1993 -% ! AUTOR: IGNACIO ITURRIOZ -% ! -% ! Esta subrotina realiza um loop sobre todas as barras para calcular as -% ! novas forças atuantes a partir da nova configuração. -% ! -% !-------------------------------------------------------------------------- -% PARAMETER (INN=1.2E6,INB=6E6,IRU=20,INCON=8) -% !-------------------------------------------------------------------------- -% ! DEFINIÇÃO DE VARIÁVEIS E GRUPOS COMUNS -% INCLUDE 'COMMON.FOR' -% !-------------------------------------------------------------------------- -% INTEGER B,NOI,NOF,R,II,JJ,KK,IMOD -% INTEGER VB(26) -% DOUBLE PRECISION DU,DV,DW,DU1,DV1,DW1,DCX,DCY,DCZ -% DOUBLE PRECISION LBAR,LBAR1,STR,LSTR,STRRT,FORCE -% !-------------------------------------------------------------------------- -% DO B=1,NBT -% NOI=CN(2*B-1) -% NOF=CN(2*B) -% DU=U(2,NOF)-U(2,NOI) -% DV=V(2,NOF)-V(2,NOI) -% DW=W(2,NOF)-W(2,NOI) -% LBAR=DSQRT(DU*DU+DV*DV+DW*DW) -% DU1=U(1,NOF)-U(1,NOI) -% DV1=V(1,NOF)-V(1,NOI) -% DW1=W(1,NOF)-W(1,NOI) -% LBAR1=DSQRT(DU1*DU1+DV1*DV1+DW1*DW1) -% DCX=DU/LBAR -% DCY=DV/LBAR -% DCZ=DW/LBAR -% STR=(LBAR-LI(B))/LI(B) -% LSTR=(LBAR1-LI(B))/LI(B) -% STRRT=(STR-LSTR)/DT -% DSS(B)=STRRT -% CALL CONSTIT (B,STR,STRRT,FORCE,R) -% ! CALL CONSTIT9(B,STR,STRRT,FORCE,R) -% FRX(NOI)=FRX(NOI)+FORCE*DCX -% FRX(NOF)=FRX(NOF)-FORCE*DCX -% FRY(NOI)=FRY(NOI)+FORCE*DCY -% FRY(NOF)=FRY(NOF)-FORCE*DCY -% FRZ(NOI)=FRZ(NOI)+FORCE*DCZ -% FRZ(NOF)=FRZ(NOF)-FORCE*DCZ -% ! -% ! ISSO GRAVA A FORÇA DE CADA BARRA -% F(B)=FORCE -% ! -% !if (b.eq.1) then -% ! write(*,*)b,str,force,LBAR -% !endif -% END DO -% RETURN -% END - -% CABAR -% ===== -% -% DATA: 22/03/1993 -% AUTOR: IGNACIO ITURRIOZ -% -% Esta subrotina realiza um loop sobre todas as barras para calcular as -% novas forças atuantes a partir da nova configuração. -% -% MATLAB translation. The original Fortran used a COMMON block; here the -% shared data is passed in/out via a struct S with fields: -% S.NBT, S.CN, S.U, S.V, S.W, S.LI, S.DT, -% S.DSS, S.FRX, S.FRY, S.FRZ, S.F -% (and any other fields needed by the CONSTIT routine). - -%-------------------------------------------------------------------------- -% PARAMETER (INN=1.2E6, INB=6E6, IRU=20, INCON=8) -% These parameters are not used in this routine. -%-------------------------------------------------------------------------- - -%-------------------------------------------------------------------------- -% Loop over all bars -%-------------------------------------------------------------------------- - -% CABAR -% ===== -% -% DATA: 22/03/1993 -% AUTOR: IGNACIO ITURRIOZ -% -% Esta subrotina realiza um loop sobre todas as barras para calcular as -% novas forças atuantes a partir da nova configuração. -% -% MATLAB translation using GLOBAL variables instead of COMMON. -% The following global variables must be defined in the workspace: -% NBT, CN, U, V, W, LI, DT, DSS, FRX, FRY, FRZ, F -% (and any others required by CONSTIT). - - - -%-------------------------------------------------------------------------- -% PARAMETER (INN=1.2E6, INB=6E6, IRU=20, INCON=8) -% These parameters are not used in this routine. -%-------------------------------------------------------------------------- -NUMBAR = 7014; - -for B = 1:NBT - NOI = CN(2*B - 1); - NOF = CN(2*B); - - % Cinemática atual (U,V,W no tempo 2) - DU = U(2, NOF) - U(2, NOI); - DV = V(2, NOF) - V(2, NOI); - DW = W(2, NOF) - W(2, NOI); - LBAR = sqrt(DU*DU + DV*DV + DW*DW); - - % Cinemática do passo anterior (U,V,W no tempo 1) - DU1 = U(1, NOF) - U(1, NOI); - DV1 = V(1, NOF) - V(1, NOI); - DW1 = W(1, NOF) - W(1, NOI); - LBAR1 = sqrt(DU1*DU1 + DV1*DV1 + DW1*DW1); - - % Cossenos diretores - DCX = DU / LBAR; - DCY = DV / LBAR; - DCZ = DW / LBAR; - - % Deformações (Strain) - STR = (LBAR - LI(B)) / LI(B); - LSTR = (LBAR1 - LI(B)) / LI(B); - STRRT = (STR - LSTR) / DT; - - DSS(B) = STRRT; - - % ================================================================= - % RELAÇÃO CONSTITUTIVA INCORPORADA (Substitui chamada ao CONSTIT.m) - % ================================================================= - SS(B) = STR; - ER = KR(B) * EP(B); - - if STR >= ER - % Ramo 1: Barra totalmente rompida - E2(B) = 0.0; - FORCE = 0.0; - EM(B) = ER; - - if FS(B) - FS(B) = false; - DM(B) = false; - end - - elseif STR >= EM(B) - % Ramo 2: Amolecimento (Strain softening) - AUX = (STR - EP(B)) / (KR(B) - 1.0); - AUX = E1(B) * (EP(B) - AUX); - E2(B) = AUX / STR; - EM(B) = STR; - FORCE = AUX + E2(B) * CON * STRRT; - - if DM(B) - DM(B) = false; - end - - elseif STR >= 0.0 - % Ramo 3: Tração elástica (carga/descarga) - FORCE = E2(B) * STR + E2(B) * CON * STRRT; - - else - % Ramo 4: Compressão - FORCE = E1(B) * STR + E1(B) * CON * STRRT; - end - - % Gravação isolada da barra de rastreio - if B == NUMBAR && fid_Lei ~= -1 - fprintf(fid_Lei, '%25.12E %25.12E %25.12E %25.12E %25.12E %25.12E\n', ... - TIME, STR, SS(B), ER, FORCE, EP(B)); - end - % ================================================================= - - % Montagem do vetor de forças globais nos nós - FRX(NOI) = FRX(NOI) + FORCE*DCX; - FRX(NOF) = FRX(NOF) - FORCE*DCX; - FRY(NOI) = FRY(NOI) + FORCE*DCY; - FRY(NOF) = FRY(NOF) - FORCE*DCY; - FRZ(NOI) = FRZ(NOI) + FORCE*DCZ; - FRZ(NOF) = FRZ(NOF) - FORCE*DCZ; - - F(B) = FORCE; - end - - ini = 1; -end \ No newline at end of file diff --git a/legacy/CACOEV.m b/legacy/CACOEV.m deleted file mode 100644 index afc5015..0000000 --- a/legacy/CACOEV.m +++ /dev/null @@ -1,25 +0,0 @@ - -function ini= CALCOEV() -global INT INB U V W U0 V0 W0 BDX BDY BDZ VLX VLY VLZ -global ACX ACY ACZ FRX FRY FRZ FX FY FZ MAS MSS CN ENR -global EDG E1 E2 LI DEQB F YNGB GFRB LCRB EPRB EP SS EM -global EN KR KR1 DSS DM FS CAF DT GFR DEQ LCR TEST EST -global DF DF1 DF2 DMP1 DMP2 TDAF CON M N L M1 N1 L1 MNL -global NNO NNS NNT NBA NBS NBT INCO NCON STEP NSTEP NDAMF -global RUN NRUN LCO TIME TTOT PSN ROH YNG EPR EPMAX EPMIN -global MEAN COEV ENEX ENCN ENEL ENGD ENDP ENIN DEN DERIV -global XB YB ZB UBAR VBAR WBAR REACAOX REACAOY REACAOZ -global STRAIN STRESS SEED C - - -%-------------------------------------------------------------------------- -% Compute the mean of EP -%-------------------------------------------------------------------------- -MEAN = mean(EP); -%-------------------------------------------------------------------------- -% Compute the coefficient of variation of EP -%-------------------------------------------------------------------------- -COEF=std(EP)/MEAN; -end - ini=1; - end diff --git a/legacy/CALAUX.m b/legacy/CALAUX.m deleted file mode 100644 index 4f7fa6c..0000000 --- a/legacy/CALAUX.m +++ /dev/null @@ -1,32 +0,0 @@ - -function ini=CALAUX() -global INT INB U V W U0 V0 W0 BDX BDY BDZ VLX VLY VLZ -global ACX ACY ACZ FRX FRY FRZ FX FY FZ MAS MSS CN ENR -global EDG E1 E2 LI DEQB F YNGB GFRB LCRB EPRB EP SS EM -global EN KR KR1 DSS DM FS CAF DT GFR DEQ LCR TEST EST -global DF DF1 DF2 DMP1 DMP2 TDAF CON M N L M1 N1 L1 MNL -global NNO NNS NNT NBA NBS NBT INCO NCON STEP NSTEP NDAMF -global RUN NRUN LCO TIME TTOT PSN ROH YNG EPR EPMAX EPMIN -global MEAN COEV ENEX ENCN ENEL ENGD ENDP ENIN DEN DERIV -global XB YB ZB UBAR VBAR WBAR REACAOX REACAOY REACAOZ -global STRAIN STRESS SEED - DM = true(NBT, 1); - FS = true(NBT, 1); - for B = 1:NBT - - NOI = CN(2*B - 1); - NOF = CN(2*B); - - DU = U(1,NOF) - U(1,NOI); - DV = V(1,NOF) - V(1,NOI); - DW = W(1,NOF) - W(1,NOI); - - LI(B) = sqrt(DU*DU + DV*DV + DW*DW); - EM(B) = 0.0; - - XB(B) = (U(1,NOF) + U(1,NOI)) / 2.0; - YB(B) = (V(1,NOF) + V(1,NOI)) / 2.0; - ZB(B) = (W(1,NOF) + W(1,NOI)) / 2.0; - end - ini=1; - end diff --git a/legacy/CALCOEV.m b/legacy/CALCOEV.m deleted file mode 100644 index 0ce12c6..0000000 --- a/legacy/CALCOEV.m +++ /dev/null @@ -1,25 +0,0 @@ - -function ini= CALCOEV() -global INT INB U V W U0 V0 W0 BDX BDY BDZ VLX VLY VLZ -global ACX ACY ACZ FRX FRY FRZ FX FY FZ MAS MSS CN ENR -global EDG E1 E2 LI DEQB F YNGB GFRB LCRB EPRB EP SS EM -global EN KR KR1 DSS DM FS CAF DT GFR DEQ LCR TEST EST -global DF DF1 DF2 DMP1 DMP2 TDAF CON M N L M1 N1 L1 MNL -global NNO NNS NNT NBA NBS NBT INCO NCON STEP NSTEP NDAMF -global RUN NRUN LCO TIME TTOT PSN ROH YNG EPR EPMAX EPMIN -global MEAN COEV ENEX ENCN ENEL ENGD ENDP ENIN DEN DERIV -global XB YB ZB UBAR VBAR WBAR REACAOX REACAOY REACAOZ -global STRAIN STRESS SEED C - - -%-------------------------------------------------------------------------- -% Compute the mean of EP -%-------------------------------------------------------------------------- -MEAN = mean(EP); -%-------------------------------------------------------------------------- -% Compute the coefficient of variation of EP -%-------------------------------------------------------------------------- -COEF=std(EP)/MEAN; - - ini=1; - end diff --git a/legacy/CALOAD.m b/legacy/CALOAD.m deleted file mode 100644 index e713c28..0000000 --- a/legacy/CALOAD.m +++ /dev/null @@ -1,146 +0,0 @@ - -function ini=CALOAD() -% CALOAD Aplica as cargas nos nós em cada passo de tempo. -% Calcula também a energia externa fornecida ao sistema. -global INT INB U V W U0 V0 W0 BDX BDY BDZ VLX VLY VLZ -global ACX ACY ACZ FRX FRY FRZ FX FY FZ MAS MSS CN ENR -global EDG E1 E2 LI DEQB F YNGB GFRB LCRB EPRB EP SS EM -global EN KR KR1 DSS DM FS CAF DT GFR DEQ LCR TEST EST -global DF DF1 DF2 DMP1 DMP2 TDAF CON M N L M1 N1 L1 MNL -global NNO NNS NNT NBA NBS NBT INCO NCON STEP NSTEP NDAMF -global RUN NRUN LCO TIME TTOT PSN ROH YNG EPR EPMAX EPMIN -global MEAN COEV ENEX ENCN ENEL ENGD ENDP ENIN DEN DERIV -global XB YB ZB UBAR VBAR WBAR REACAOX REACAOY REACAOZ -global STRAIN STRESS SEED - -% SUBROUTINE CALOAD -% ! ================= -% ! -% ! DATA: 22/03/1993 -% ! AUTOR: IGNACIO ITURRIOZ -% ! -% ! Esta subrotina aplica as cargas nos nós em cada passo de tempo e calcula -% ! a energia externa fornecida ao sistema. -% ! -% !-------------------------------------------------------------------------- -% PARAMETER (INN=1.2E6,INB=6E6,IRU=6,INCON=10) -% !-------------------------------------------------------------------------- -% ! DEFINIÇÃO DE VARIÁVEIS E GRUPOS COMUNS -% INCLUDE 'COMMON.FOR' -% !-------------------------------------------------------------------------- -% DOUBLE PRECISION TINI -% LOGICAL Logic1,logic2,logic3 -% -% !-------------------------------------------------------------------------- -% DO NO=1,NNT -% FX(NO)=FRX(NO) -% FY(NO)=FRY(NO) -% FZ(NO)=FRZ(NO) -% FRX(NO)=0.0D00 -% FRY(NO)=0.0D00 -% FRZ(NO)=0.0D00 -% END DO -% ! -% !-------------------------------------------------------------------------- -% ! -% !-------------------------------------------------------------------------- -% -% IF (TEST.EQ.101) THEN ! prism solicited by prescribed displacement to traction if Vf2 >0 , or to compression if Vf2<0, Vf2 is the displacement velocity -% !applied in the last column of dentral nodes -% VF2=400.e-5!m/s -% -% DO I=1,NNT -% LOGIC1=u0(I).LT.((M1-0.49)*LCo).AND.u0(I).GT.((M1-0.51)*LCo) -% -% IF(LOGIC1)THEN -% -% U(2,I)=U0(I)-VF2*TIME -% -% ! end if -% -% -% ! IF(time.GT.5000*DT)THEN -% ! ! W(2,I)=W(2,I)-(2*v0(I)/(N1*LCO)-1)*VF2*10.0*(time-5000*DT) -% ! W(2,I)=W(2,I)-(2*v0(I)/(N1*LCO)-1)*VF2*1.0*DT -% ! END IF -% END IF -% -% END DO -% -% ENDIF ! -% IF (TEST.EQ.102) THEN ! prism solicited as beam with two vertical displacement in L/4 and (3/4)L by prescribed displacement, -% !the prism are supported by vertical support in the endsx=L/2 to rpoduce a to traction if Vf2 >0 , or to compression if Vf2<0, Vf2 is the displacement velocity -% -% VF2=400.e-5!m/s -% -% DO I=1,NNT -% LOGIC1=u0(I).LT.((M1-33.49)*LCo).AND.u0(I).GT.((M1-33.51)*LCo) -% LOGIC3=v0(I).LT.((N1-0.49)*LCo).AND.v0(I).GT.((N1-0.51)*LCo) -% LOGIC2=u0(I).LT.((33.51)*LCo).AND.u0(I).GT.((33.49)*LCo) -% IF(LOGIC1.AND.LOGIC3)THEN -% V(2,I)=V0(I)-VF2*TIME -% endif -% IF(LOGIC1.AND.LOGIC2)THEN -% V(2,I)=V0(I)-VF2*TIME -% endif -% -% END DO -% -% ENDIF ! -% RETURN -% END -%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% - FX = FRX; - FY = FRY; - FZ = FRZ; - FRX = zeros(1,NNT); - FRY = zeros(1,NNT); - FRZ = zeros(1,NNT); - - -%========================================================================== -% TEST 101: prism under prescribed axial (X) displacement -%========================================================================== -if TEST == 101 - VF2 = 400.0e-5; % m/s displacement velocity - - for I = 1:NNT - LOGIC1 = (U0(I) < (M1 - 0.49) * LCO) && ... - (U0(I) > (M1 - 0.51) * LCO); - - if LOGIC1 - U(2,I) = U0(I) - VF2 * TIME; - - % --- commented-out block from Fortran, kept for reference ---- - % if TIME > 5000*DT - % W(2,I) = W(2,I) - (2*V0(I)/(N1*LCO) - 1) * VF2 * 1.0 * DT; - % end - end - end -end - -%========================================================================== -% TEST 102: prism as beam, prescribed vertical displacements at L/4 & 3L/4 -%========================================================================== -if TEST == 102 - VF2 = 400.0e-5; % m/s - - for I = 1:NNT - LOGIC1 = (U0(I) < (M1 - 33.49) * LCO) && ... - (U0(I) > (M1 - 33.51) * LCO); - LOGIC3 = (V0(I) < (N1 - 0.49) * LCO) && ... - (V0(I) > (N1 - 0.51) * LCO); - LOGIC2 = (U0(I) < 33.51 * LCO) && ... - (U0(I) > 33.49 * LCO); - - if LOGIC1 && LOGIC3 - V(2,I) = V0(I) - VF2 * TIME; - end - if LOGIC1 && LOGIC2 - V(2,I) = V0(I) - VF2 * TIME; - end - end -end - -ini=1; - end diff --git a/legacy/CALRES.m b/legacy/CALRES.m deleted file mode 100644 index 330f13d..0000000 --- a/legacy/CALRES.m +++ /dev/null @@ -1,130 +0,0 @@ - -function ini=CALRES() -% CALRES Calcula valores que serão guardados no arquivo de resultados. -global INT INB U V W U0 V0 W0 BDX BDY BDZ VLX VLY VLZ -global ACX ACY ACZ FRX FRY FRZ FX FY FZ MAS MSS CN ENR -global EDG E1 E2 LI DEQB F YNGB GFRB LCRB EPRB EP SS EM -global EN KR KR1 DSS DM FS CAF DT GFR DEQ LCR TEST EST -global DF DF1 DF2 DMP1 DMP2 TDAF CON M N L M1 N1 L1 MNL -global NNO NNS NNT NBA NBS NBT INCO NCON STEP NSTEP NDAMF -global RUN NRUN LCO TIME TTOT PSN ROH YNG EPR EPMAX EPMIN -global MEAN COEV ENEX ENCN ENEL ENGD ENDP ENIN DEN DERIV -global XB YB ZB UBAR VBAR WBAR REACAOX REACAOY REACAOZ -global STRAIN STRESS SEED - -% !-------------------------------------------------------------------------- -% !-------------------------------------------------------------------------- -% ! -% SUBROUTINE CALRES -% ! ================= -% ! -% ! DATA: 22/03/1993 -% ! AUTOR: IGNACIO ITURRIOZ -% ! -% ! Esta subrotina calcula valores que serão guardados no arquivo RESNAME. -% ! -% !-------------------------------------------------------------------------- -% PARAMETER (INN=1.2E6,INB=6E6,IRU=6,INCON=10) -% !-------------------------------------------------------------------------- -% ! DEFINIÇÃO DE VARIÁVEIS E GRUPOS COMUNS -% INCLUDE 'COMMON.FOR' -% !-------------------------------------------------------------------------- -% -% DOUBLE PRECISION ReacaoX2,COD_L,COD_R,DELTA -% -% -% CHARACTER*20 NAME -% !-------------------------------------------------------------------------- -% ! ADAPTAR PARA CADA EXEMPLO TESTADO -% !-------------------------------------------------------------------------- -% if (test.eq.102)then -% -% REACAOX = 0.0D00 -% REACAOY = 0.0D00 -% REACAOZ = 0.0D00 -% REACAOX2 = 0.0D00 -% SOMADESZ = 0.0D00 -% SOMADESY = 0.0D00 -% SOMADESX = 0.0D00 -% COD_L=0.0D00 -% COD_R=0.0D00 -% DELTA=0.0D00 -% ! -% DO I=1,NNT -% -% IF((BDY(I).EQ.1).AND.(V0(I).GE.(LCO*(N1-0.51)) ))then -% -% REACAOY=REACAOY+FRY(I) -% -% END IF -% END DO -% -% ! -% IF (PR9.EQ.OU8) THEN -% NAME = 'SIM01.DAT' -% OPEN (21,FILE=NAME) -% WRITE(21,'(4(E25.12,3X))')TIME,REACAOY,Acz(89214),V(2,154928) -% PR9=1 -% ELSE -% PR9=PR9+1 -% END IF -% ENDIF -% RETURN -% END -% !-------------------------------------------------------------------------- - -% CALRES -% ====== -% -% DATA: 22/03/1993 -% AUTOR: IGNACIO ITURRIOZ -% -% Esta subrotina calcula valores que serão guardados no arquivo RESNAME. -% -% MATLAB translation using GLOBAL variables instead of COMMON. - -% ------------------------------------------------------------------------- -% Global variables (equivalent to the COMMON block) -% ------------------------------------------------------------------------- -%----------------------------------------------------- -% - -% ------------------------------------------------------------------------- -% ADAPT FOR EACH TEST EXAMPLE -% ------------------------------------------------------------------------- -if TEST == 102 - - REACAOX = 0.0; - REACAOY = 0.0; - REACAOZ = 0.0; - REACAOX2 = 0.0; - SOMADESZ = 0.0; - SOMADESY = 0.0; - SOMADESX = 0.0; - COD_L = 0.0; - COD_R = 0.0; - DELTA = 0.0; - - % --------------------------------------------------------------------- - for I = 1:NNT - if (BDY(I) == 1) && (V0(I) >= (LCO*(N1 - 0.51))) - REACAOY = REACAOY + FRY(I); - end - end - - % --------------------------------------------------------------------- -% if PR9 == OU8 - NAME = 'SIM01.DAT'; - fid21 = fopen(NAME, 'w'); - fprintf(fid21, '%25.12e %25.12e %25.12e %25.12e\n', ... - TIME, REACAOY, ACZ(100), V(2,100)); - fclose(fid21); - % PR9 = 1; - % else - % PR9 = PR9 + 1; - % end - -end - - ini=1; - end diff --git a/legacy/CONECTI.m b/legacy/CONECTI.m deleted file mode 100644 index 2aea010..0000000 --- a/legacy/CONECTI.m +++ /dev/null @@ -1,44 +0,0 @@ - -function ini=CONECTI() -% CONECTI Define as conectividades de cada barra do reticulado. -global INT INB U V W U0 V0 W0 BDX BDY BDZ VLX VLY VLZ -global ACX ACY ACZ FRX FRY FRZ FX FY FZ MAS MSS CN ENR -global EDG E1 E2 LI DEQB F YNGB GFRB LCRB EPRB EP SS EM -global EN KR KR1 DSS DM FS CAF DT GFR DEQ LCR TEST EST -global DF DF1 DF2 DMP1 DMP2 TDAF CON M N L M1 N1 L1 MNL -global NNO NNS NNT NBA NBS NBT INCO NCON STEP NSTEP NDAMF -global RUN NRUN LCO TIME TTOT PSN ROH YNG EPR EPMAX EPMIN -global MEAN COEV ENEX ENCN ENEL ENGD ENDP ENIN DEN DERIV -global XB YB ZB UBAR VBAR WBAR REACAOX REACAOY REACAOZ -global STRAIN STRESS SEED -% %--------------------------------------------------- -% Esta subrotina define as conectividades de cada barra. -% ------------------------------------------------------------ - NBA=0; - NBS=0; - NBT=0; -% ! - M2=M-2; - N2=N-2; - L2=L-2; - MN=M*N; - MN1=M1*N1; -% ! - ini=EXTCO1(M1,N,L,0,1,1,1); - ini=EXTCO1(M,N1,L,1,0,1,M); - ini=EXTCO1(M,N,L1,1,1,0,MN); -% ! - ini=INTCO1(M2,N1,L1,1); - ini=INTCO1(M1,N2,L1,M1); - ini=INTCO1(M1,N1,L2,MN1); -% ! - ini=DIACO1; -% ! - NBS=NBA; - NI=NNO; -% ! - NBT=NBS; - -% - ini=1; - end diff --git a/legacy/CONSTIT.m b/legacy/CONSTIT.m deleted file mode 100644 index 2112609..0000000 --- a/legacy/CONSTIT.m +++ /dev/null @@ -1,221 +0,0 @@ -function ini= CONSTIT (B,STR,STRRT,FORCE,R,fid_Lei) -global INT INB U V W U0 V0 W0 BDX BDY BDZ VLX VLY VLZ -global ACX ACY ACZ FRX FRY FRZ FX FY FZ MAS MSS CN ENR -global EDG E1 E2 LI DEQB F YNGB GFRB LCRB EPRB EP SS EM -global EN KR KR1 DSS DM FS CAF DT GFR DEQ LCR TEST EST -global DF DF1 DF2 DMP1 DMP2 TDAF CON M N L M1 N1 L1 MNL -global NNO NNS NNT NBA NBS NBT INCO NCON STEP NSTEP NDAMF -global RUN NRUN LCO TIME TTOT PSN ROH YNG EPR EPMAX EPMIN -global MEAN COEV ENEX ENCN ENEL ENGD ENDP ENIN DEN DERIV -global XB YB ZB UBAR VBAR WBAR REACAOX REACAOY REACAOZ -global STRAIN STRESS SEED - -% SUBROUTINE CONSTIT (B,STR,STRRT,FORCE,R) -% ! ================== -% ! -% ! Esta subrotina é chamada pela subrotina cabar para modelar a relação -% ! constitutiva de cada barra de acordo com um diagrama bilinear força vs. -% ! deformação, com amolecimento ("strain softening'). O processo de -% ! descarga é modelado de acordo com a hipótese de dano-elástico. -% ! -% !-------------------------------------------------------------------------- -% PARAMETER (INN=1.2E6,INB=6E6,IRU=20,INCON=8) -% !-------------------------------------------------------------------------- -% ! DEFINIÇÃO DE VARIÁVEIS E GRUPOS COMUNS -% INCLUDE 'COMMON.FOR' -% !-------------------------------------------------------------------------- -% INTEGER B,R,RESP,NUMBAR -% DOUBLE PRECISION AUX,STR,STRRT,ER,FORCE -% !-------------------------------------------------------------------------- -% SS(B)=STR -% ER=KR(B)*EP(B) -% -% R=0 -% -% !-------------------------------------------------------------------------- -% ! VERIFICA SE OCORRE FRATURA -% !-------------------------------------------------------------------------- -% ! IF (STR.GE.EM(B)) THEN -% ! IF (RESP.EQ.1) THEN -% ! GO TO 5 -% ! END IF -% ! ! WRITE (*,*) -% ! ! WRITE (*,*) ' OCORREU FRATURA. DESEJA CONTINUAR? ' -% ! ! WRITE (*,*) ' SE SIM, DIGITE 1. SE NAO, DIGITE 2. ' -% !! READ (*,*) RESP -% ! ! WRITE (*,*) -% ! resp=1 -% ! IF (RESP.EQ.1) THEN -% ! GO TO 5 -% ! ELSE -% ! STOP -% ! END IF -% ! 5 END IF -% !-------------------------------------------------------------------------- -% IF (STR.GE.ER) GO TO 30 -% IF (STR.GE.EM(B)) GO TO 20 -% IF (STR.GE.0.0D00) GO TO 10 -% ! PARA ACOMPANHAR A EVOLUCAO DE UMA BARRA, DEFINIR SEU NUMERO EM NUMBAR -% NUMBAR=7014 -% !-------------------------------------------------------------------------- -% ! Consideração do amortecimento na relação constitutiva: CON > 0.0D00 -% !-------------------------------------------------------------------------- -% FORCE=E1(B)*STR+E1(B)*CON*STRRT -% -% ! Para acompanhar uma barra -% IF (B.EQ.NUMBAR) THEN ! colocar número da barra que se quer seguir -% WRITE (19,'(6(E25.12,3X))') TIME,STR,SS(B),ER,Force,EP(B) -% -% END IF -% -% -% GO TO 40 -% !-------------------------------------------------------------------------- -% -% 10 FORCE=E2(B)*STR+E2(B)*CON*STRRT -% !! Para acompanhar uma barra -% IF (B.EQ.NUMBAR) THEN -% WRITE (19,'(6(E25.12,3X))') TIME,STR,SS(B),ER,Force,EP(B) -% ! -% END IF -% -% -% GO TO 40 -% !-------------------------------------------------------------------------- -% 20 AUX=(STR-EP(B))/(KR(B)-1.0D00) -% AUX=E1(B)*(EP(B)-AUX) -% E2(B)=AUX/STR -% EM(B)=STR -% FORCE=AUX+E2(B)*CON*STRRT -% -% IF (B.EQ.NUMBAR) THEN ! colocar número da barra que se quer seguir -% WRITE (19,'(6(E25.12,3X))') TIME,STR,SS(B),ER,Force,EP(B) -% -% -% END IF -% -% -% IF (DM(B)) THEN -% DM(B)=.FALSE. -% END IF -% -% GO TO 40 -% !-------------------------------------------------------------------------- -% 30 E2(B)=0.0D00 -% FORCE=0.0D00 -% EM(B)=ER -% -% ! ! Para acompanhar uma barra -% IF (B.EQ.NUMBAR) THEN ! colocar número da barra que se quer seguir -% WRITE (19,'(6(E25.12,3X))') TIME,STR,SS(B),ER,Force,EP(B) -% -% -% END IF -% -% IF (FS(B)) THEN -% R=1 -% FS(B)=.FALSE. -% DM(B)=.FALSE. -% END IF -% -% 40 RETURN -% END -% ! -% ================== -% -% Esta subrotina é chamada pela subrotina CABAR para modelar a relação -% constitutiva de cada barra de acordo com um diagrama bilinear força vs. -% deformação, com amolecimento ("strain softening"). O processo de -% descarga é modelado de acordo com a hipótese de dano-elástico. -% -% Translates the Fortran SUBROUTINE CONSTIT. - - -%-------------------------------------------------------------------------- -% Parameters (preserved for fidelity; unused here) -%-------------------------------------------------------------------------- - -%-------------------------------------------------------------------------- -% Record current strain and compute the fracture reference strain -%-------------------------------------------------------------------------- -SS(B) = STR; -ER = KR(B) * EP(B); -R = 0; - -%-------------------------------------------------------------------------- -% Bar to be tracked (writes diagnostic rows to Lei_Barra.TXT) -%-------------------------------------------------------------------------- -NUMBAR = 7014; % change to follow a different bar -TrackBar = (B == NUMBAR); - -%========================================================================== -% Branch 1: STR >= ER --> bar fully broken (Fortran label 30) -%========================================================================== -if STR >= ER - - E2(B) = 0.0; - FORCE = 0.0; - EM(B) = ER; - - if TrackBar - fprintf(fid_Lei, '%25.12E %25.12E %25.12E %25.12E %25.12E %25.12E\n', ... - TIME, STR, SS(B), ER, FORCE, EP(B)); - end - - if FS(B) - R = 1; - FS(B) = false; - DM(B) = false; - end - -%========================================================================== -% Branch 2: EM(B) <= STR < ER --> strain softening (Fortran label 20) -%========================================================================== -elseif STR >= EM(B) - - AUX = (STR - EP(B)) / (KR(B) - 1.0); - AUX = E1(B) * (EP(B) - AUX); - E2(B) = AUX / STR; - EM(B) = STR; - FORCE = AUX + E2(B) * CON * STRRT; - - if TrackBar - fprintf(fid_Lei, '%25.12E %25.12E %25.12E %25.12E %25.12E %25.12E\n', ... - TIME, STR, SS(B), ER, FORCE, EP(B)); - end - - if DM(B) - DM(B) = false; - end - -%========================================================================== -% Branch 3: 0 <= STR < EM --> elastic reload/unload in tension -% (Fortran label 10) -%========================================================================== -elseif STR >= 0.0 - - FORCE = E2(B) * STR + E2(B) * CON * STRRT; - - if TrackBar - fprintf(fid_Lei, '%25.12E %25.12E %25.12E %25.12E %25.12E %25.12E\n', ... - TIME, STR, SS(B), ER, FORCE, EP(B)); - end - -%========================================================================== -% Branch 4 (default): STR < 0 --> linear elastic in compression -%========================================================================== -else - - FORCE = E1(B) * STR + E1(B) * CON * STRRT; - - if TrackBar - fprintf(fid_Lei, '%25.12E %25.12E %25.12E %25.12E %25.12E %25.12E\n', ... - TIME, STR, SS(B), ER, FORCE, EP(B)); - end - -end - - - -ini=1; - end diff --git a/legacy/COORD.m b/legacy/COORD.m deleted file mode 100644 index 5d196b0..0000000 --- a/legacy/COORD.m +++ /dev/null @@ -1,42 +0,0 @@ - -function ini=COORD() -global U V W U0 V0 W0 BDX BDY BDZ VLX VLY VLZ -global ACX ACY ACZ FRX FRY FRZ FX FY FZ MAS MSS CN ENR -global EDG E1 E2 LI DEQB F YNGB GFRB LCRB EPRB EP SS EM -global EN KR KR1 DSS DM FS CAF DT GFR DEQ LCR TEST EST -global DF DF1 DF2 DMP1 DMP2 TDAF CON M N L M1 N1 L1 MNL -global NNO NNS NNT NBA NBS NBT INCO NCON STEP NSTEP NDAMF -global RUN NRUN LCO TIME TTOT PSN ROH YNG EPR EPMAX EPMIN -global MEAN COEV ENEX ENCN ENEL ENGD ENDP ENIN DEN DERIV -global XB YB ZB UBAR VBAR WBAR REACAOX REACAOY REACAOZ -global STRAIN STRESS SEED -%--------------------------------------------------- -% ! -% ! Esta subrotina faz a geração automática de coordenadas nodais. -% ! -% !-------------------------------------------------------------------------- -%!-------------------------------------------------------------------------- -%! DEFINIÇÃO DA QUANTIDADE TOTAL DE NÓS - NNO=MNL+M1*N1*L1 - NNS=NNO - NNT=NNS -% - ini=COORDSUB(2,M1,1,N,1,L,0,M,N,1,2,1,2,1,2,0,0,0) - ini=COORDSUB(1,1,1,N,1,L,0,M,N,0,0,1,2,1,2,0,0,0) - ini=COORDSUB(M,M,1,N,1,L,0,M,N,0,-2*M1,1,2,1,2,0,0,0) - ini=COORDSUB(1,M1,1,N1,1,L1,MNL,M1,N1,1,1,1,1,1,1,0,0,0) -% - NI=NNO -%! -% DO NO=1,NNT -% U0(NO)=U(1,NO) -% V0(NO)=V(1,NO) -% W0(NO)=W(1,NO) -% END DO -U0=U(1,:); -V0=V(1,:); -W0=W(1,:); -% -% - ini=1; - end diff --git a/legacy/COORDSUB.m b/legacy/COORDSUB.m deleted file mode 100644 index dd78d7a..0000000 --- a/legacy/COORDSUB.m +++ /dev/null @@ -1,50 +0,0 @@ - -function ini=COORDSUB (MI,MF,NI,NF,LLI,LF,ST,MX,NX,X1,Y1,X2,Y2,X3,Y3,C1,C2,C3) -global INT INB U V W U0 V0 W0 BDX BDY BDZ VLX VLY VLZ -global ACX ACY ACZ FRX FRY FRZ FX FY FZ MAS MSS CN ENR -global EDG E1 E2 LI DEQB F YNGB GFRB LCRB EPRB EP SS EM -global EN KR KR1 DSS DM FS CAF DT GFR DEQ LCR TEST EST -global DF DF1 DF2 DMP1 DMP2 TDAF CON M N L M1 N1 L1 MNL -global NNO NNS NNT NBA NBS NBT INCO NCON STEP NSTEP NDAMF -global RUN NRUN LCO TIME TTOT PSN ROH YNG EPR EPMAX EPMIN -global MEAN COEV ENEX ENCN ENEL ENGD ENDP ENIN DEN DERIV -global XB YB ZB UBAR VBAR WBAR REACAOX REACAOY REACAOZ -global STRAIN STRESS SEED -%--------------------------------------------------- -% -% ! -% ! Esta subrotina é chamada pela subrotina coord para fazer a geração -% ! automática de coordenadas nodais. -% ! -% !-------------------------------------------------------------------------- - - - %INTEGER I,J,K,LLI,LF,NI,NF,MI,MF,MX,NX - %INTEGER X1,Y1,X2,Y2,X3,Y3,C1,C2,C3,NO,ST -%!-------------------------------------------------------------------------- - for K=LLI:LF - for J=NI:NF - for I=MI:MF -% - NO=ST+(K-1)*MX*NX+(J-1)*MX+I; -%! - U(1,NO)=(X1*I-Y1/2.0D00)*LCO; - U(2,NO)=U(1,NO); - U(3,NO)=U(2,NO); - V(1,NO)=(X2*J-Y2/2.0D00)*LCO; - V(2,NO)=V(1,NO); - V(3,NO)=V(2,NO); - W(1,NO)=(X3*K-Y3/2.0D00)*LCO; - W(2,NO)=W(1,NO); - W(3,NO)=W(2,NO); -%! - BDX(NO)=C1; - BDY(NO)=C2; - BDZ(NO)=C3; -%! - end - end - end -%! - ini=1; - end diff --git a/legacy/DEFEP.m b/legacy/DEFEP.m deleted file mode 100644 index c309599..0000000 --- a/legacy/DEFEP.m +++ /dev/null @@ -1,88 +0,0 @@ - -function ini=DEFEP(B, TYPES) -global INT INB U V W U0 V0 W0 BDX BDY BDZ VLX VLY VLZ -global ACX ACY ACZ FRX FRY FRZ FX FY FZ MAS MSS CN ENR -global EDG E1 E2 LI DEQB F YNGB GFRB LCRB EPRB EP SS EM -global EN KR KR1 DSS DM FS CAF DT GFR DEQ LCR TEST EST -global DF DF1 DF2 DMP1 DMP2 TDAF CON M N L M1 N1 L1 MNL -global NNO NNS NNT NBA NBS NBT INCO NCON STEP NSTEP NDAMF -global RUN NRUN LCO TIME TTOT PSN ROH YNG EPR EPMAX EPMIN -global MEAN COEV ENEX ENCN ENEL ENGD ENDP ENIN DEN DERIV -global XB YB ZB UBAR VBAR WBAR REACAOX REACAOY REACAOZ -global STRAIN STRESS SEED -% SUBROUTINE DEFEP(B,TYPES) -% ! =================== -% ! -% ! Esta subrotina é chamada pelas subrotinas rmecex, rmecin e rmecdi para -% ! definir a aleatoriedade das propriedades mecânicas das barras. -% ! -% !-------------------------------------------------------------------------- -% PARAMETER (INN=1.2E6,INB=6E6,IRU=6,INCON=10) -% !-------------------------------------------------------------------------- -% ! DEFINIÇÃO DE VARIÁVEIS E GRUPOS COMUNS -% INCLUDE 'COMMON.FOR' -% !-------------------------------------------------------------------------- -% INTEGER B,TYPES -% DOUBLE PRECISION RED,NOR,AUX,NOI,NOF -% !-------------------------------------------------------------------------- -% IF (TYPES.EQ.0) RED=1.00D00 -% IF (TYPES.EQ.1) RED=0.50D00 -% IF (TYPES.EQ.2) RED=0.25D00 -% ! -% IF (TYPES.LT.3) THEN -% E1(B)=ENR(B)*RED -% -% ELSE -% E1(B)=EDG(B) -% END IF -% ! -% -% E2(B)=E1(B) -% EP(B)=EPRB(B) -% KR(B)=(LCRB(B)/LI(B)) -% -% -% IF (KR(B).LT.1.01) THEN -% WRITE (*,*) -% WRITE (*,*) ' KR < 1.01CCC ' -% WRITE (*,*) -% STOP ! CUIDADO COM ISTO. VER EXPLICAÇÃO NA DISSERTAÇÃO DO MARCELO -% END IF -% RETURN -% END -if TYPES == 0 - RED = 1.00; -elseif TYPES == 1 - RED = 0.50; -elseif TYPES == 2 - RED = 0.25; -end - -%-------------------------------------------------------------------------- -% Assign E1 (random for exterior/interior bars; deterministic for diagonals) -%-------------------------------------------------------------------------- -if TYPES < 3 - E1(B) = ENR(B)*RED; -else - E1(B) = EDG(B); -end - -%-------------------------------------------------------------------------- -% Other mechanical properties -%-------------------------------------------------------------------------- -E2(B) = E1(B); -EP(B) = EPRB(B); -KR(B) = LCRB(B)/ LI(B); - -%-------------------------------------------------------------------------- -% Sanity check on the stiffness ratio KR -%-------------------------------------------------------------------------- -if KR(B)< 1.01 - fprintf('\n'); - fprintf(' KR < 1.01CCC \n'); - fprintf('\n'); - error('DEFEP: KR < 1.01 — see explanation in Marcelo''s dissertation.'); -end - - ini=1; - end diff --git a/legacy/DIACO1.m b/legacy/DIACO1.m deleted file mode 100644 index a73cf02..0000000 --- a/legacy/DIACO1.m +++ /dev/null @@ -1,121 +0,0 @@ - -function ini=DIACO1() -global INT INB U V W U0 V0 W0 BDX BDY BDZ VLX VLY VLZ -global ACX ACY ACZ FRX FRY FRZ FX FY FZ MAS MSS CN ENR -global EDG E1 E2 LI DEQB F YNGB GFRB LCRB EPRB EP SS EM -global EN KR KR1 DSS DM FS CAF DT GFR DEQ LCR TEST EST -global DF DF1 DF2 DMP1 DMP2 TDAF CON M N L M1 N1 L1 MNL -global NNO NNS NNT NBA NBS NBT INCO NCON STEP NSTEP NDAMF -global RUN NRUN LCO TIME TTOT PSN ROH YNG EPR EPMAX EPMIN -global MEAN COEV ENEX ENCN ENEL ENGD ENDP ENIN DEN DERIV -global XB YB ZB UBAR VBAR WBAR REACAOX REACAOY REACAOZ -global STRAIN STRESS SEED -% SUBROUTINE DIACO1 -% ! ================= -% ! -% ! Esta subrotina é chamada pela subrotina conecti para definir as -% ! conectividades das barras diagonais dos módulos cúbicos. -% ! -% !-------------------------------------------------------------------------- -% PARAMETER (INN=1.2E6,INB=6E6,IRU=6,INCON=10) -% !-------------------------------------------------------------------------- -% ! DEFINIÇÃO DE VARIÁVEIS E GRUPOS COMUNS -% INCLUDE 'COMMON.FOR' -% !-------------------------------------------------------------------------- -% INTEGER G,I,J,K,NOI,NOF,B,ST(8),REF -% !-------------------------------------------------------------------------- -% REF=NBA -% ST(1)=0 -% ST(2)=1 -% ST(3)=M -% ST(4)=M+1 -% ST(5)=N*M -% ST(6)=N*M+1 -% ST(7)=N*M+M -% ST(8)=N*M+M+1 -% ! -% DO 20 K=1,L1 -% DO 20 J=1,N1 -% DO 20 I=1,M1 -% ! -% NOI=(K-1)*M1*N1+(J-1)*M1+I -% NOF=(K-1)*M*N+(J-1)*M+I -% B=REF+(NOI-1)*8 -% NOI=NOI+MNL -% ! -% DO 10 G=1,8 -% B=B+1 -% CN(2*B-1)=NOI -% CN(2*B)=NOF+ST(G) -% 10 CONTINUE -% ! -% NBA=NBA+8 -% ! -% 20 CONTINUE -% ! -% RETURN -% END -% -%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% - -% ================= -% -% Esta subrotina é chamada pela subrotina CONECTI para definir as -% conectividades das barras diagonais dos módulos cúbicos. -% -% Translates the Fortran SUBROUTINE DIACO1. - -%-------------------------------------------------------------------------- -% Local variables -%-------------------------------------------------------------------------- -ST = zeros(1, 8); % 1-based, matches Fortran ST(1..8) - -%-------------------------------------------------------------------------- -% Reference offset and ST table -%-------------------------------------------------------------------------- -REF = NBA; - -ST(1) = 0; -ST(2) = 1; -ST(3) = M; -ST(4) = M + 1; -ST(5) = N * M; -ST(6) = N * M + 1; -ST(7) = N * M + M; -ST(8) = N * M + M + 1; - -%========================================================================== -% Outer nest: K (outer), J (middle), I (inner) -- all share label 20 -%========================================================================== -for K = 1:L1 - for J = 1:N1 - for I = 1:M1 - - NOI = (K - 1) * M1 * N1 + (J - 1) * M1 + I; - NOF = (K - 1) * M * N + (J - 1) * M + I; - B = REF + (NOI - 1) * 8; - NOI = NOI + MNL; - - %-------------------------------------------------------------- - % Inner loop over G = 1..8 (label 10) - %-------------------------------------------------------------- - for G = 1:8 - B = B + 1; - CN(2*B - 1) = NOI; - CN(2*B) = NOF + ST(G); - end - - %-------------------------------------------------------------- - % Executed once per (K, J, I) triple - %-------------------------------------------------------------- - NBA = NBA + 8; - - end - end - - -end - - -ini=1; - end \ No newline at end of file diff --git a/legacy/ENERG2.m b/legacy/ENERG2.m deleted file mode 100644 index a10cfc6..0000000 --- a/legacy/ENERG2.m +++ /dev/null @@ -1,221 +0,0 @@ - -function ini=ENERG2(fid_EnB) -% ENERG2 Avalia o balanço de energia a cada passo de integração. -% Grava as energias (externa, interna, cinética, elástica, dissipada) em fid_EnB. -global INT INB U V W U0 V0 W0 BDX BDY BDZ VLX VLY VLZ -global ACX ACY ACZ FRX FRY FRZ FX FY FZ MAS MSS CN ENR -global EDG E1 E2 LI DEQB F YNGB GFRB LCRB EPRB EP SS EM -global EN KR KR1 DSS DM FS CAF DT GFR DEQ LCR TEST EST -global DF DF1 DF2 DMP1 DMP2 TDAF CON M N L M1 N1 L1 MNL -global NNO NNS NNT NBA NBS NBT INCO NCON STEP NSTEP NDAMF -global RUN NRUN LCO TIME TTOT PSN ROH YNG EPR EPMAX EPMIN -global MEAN COEV ENEX ENCN ENEL ENGD ENDP ENIN DEN DERIV -global XB YB ZB UBAR VBAR WBAR REACAOX REACAOY REACAOZ -global STRAIN STRESS SEED -% !! -% SUBROUTINE ENERG2 -% ! ================= -% ! -% ! Esta subrotina avalia o desempenho da energia a cada passo de -% ! integração. -% ! -% !-------------------------------------------------------------------------- -% ! DEFINIÇÃO DAS VARIÁVEIS REFERENTES A DIFERENTES TIPOS DE ENERGIA QUE -% ! SERÃO CALCULADAS -% ! -% ! ENEX = Trabalho externo realizado sobre o modelo -% ! ENIN = Energia interna total dissipada ou acumulada -% ! ENCN = Energia cinética total do modelo -% ! ENEL = Energia elástica total presente no modelo -% ! ENDP = Energia dissipada por amortecimento -% ! ENGD = Energia dissipada pelo efeito de amolecimento (strain softening) -% ! (somatória sobre todas as barras) -% ! DEN = Diferença entre energia externa e interna -% ! (quanto menor este valor, mais preciso é o resultado) -% !-------------------------------------------------------------------------- -% PARAMETER (INN=1.2E6,INB=6E6,IRU=6,INCON=10) -% !-------------------------------------------------------------------------- -% ! DEFINIÇÃO DE VARIÁVEIS E GRUPOS COMUNS -% INCLUDE 'COMMON.FOR' -% !-------------------------------------------------------------------------- -% INTEGER B,KL -% DOUBLE PRECISION DU1,DU2 -% DOUBLE PRECISION DEF,AREA -% !-------------------------------------------------------------------------- -% ENCN=0.0D00 -% ENEL=0.0D00 -% ENGD=0.0D00 -% DERIV=0.0D00 -% DEN=0.0D00 -% IF (STEP.EQ.1) DU1=0.0D00 -% IF (STEP.EQ.1) DU2=0.0D00 -% !-------------------------------------------------------------------------- -% ! CÁLCULO DA ENERGIA CINÉTICA ENCN -% !-------------------------------------------------------------------------- -% DO I=1,NNT -% IF ((I.LE.NNO)) THEN -% ENCN=ENCN+MAS(I)*VLX(I)*VLX(I)/2.0D00 -% ENCN=ENCN+MAS(I)*VLY(I)*VLY(I)/2.0D00 -% ENCN=ENCN+MAS(I)*VLZ(I)*VLZ(I)/2.0D00 -% END IF -% END DO -% !-------------------------------------------------------------------------- -% ! CÁLCULO DA ENERGIA ELÁSTICA ENEL -% !-------------------------------------------------------------------------- -% DO B=1,NBT -% ! -% KL=2 -% ! Divide-se por 2 a expressão se as barras são as da borda ou simétrica -% ! Isto implica KL=4 -% IF (B.GT.NBA) KL=4 -% DEF=SS(B)*SS(B)*LI(B)/KL -% IF (SS(B).GE.0.0D00) THEN -% ENEL=ENEL+E2(B)*DEF -% EN(1,B)=E2(B)*DEF -% ELSE -% ENEL=ENEL+E1(B)*DEF -% EN(1,B)=E1(B)*DEF -% END IF -% !-------------------------------------------------------------------------- -% ! CÁLCULO DA ENERGIA DISSIPADA POR AMOLECIMENTO (STRAIN SOFTENING) ENGD -% !-------------------------------------------------------------------------- -% ! Barras rompidas e danificadas -% IF (.NOT.DM(B)) THEN -% AREA=E1(B)*EP(B)*EP(B)-E2(B)*EM(B)*EM(B)+(E1(B)*EP(B)+E2(B)* & -% & EM(B))*(EM(B)-EP(B)) -% AREA=LI(B)*AREA/KL -% -% IF (B.EQ.7014) THEN ! colocar número da barra que se quer seguir -% WRITE (20,'(2(E12.6,3X))') TIME,AREA -% END IF -% -% ENGD=ENGD+AREA -% EN(2,B)=AREA -% -% !--------------------------------------------------------------- -% -% END IF -% ! -% ! Armazena só energia dissipada pelas barras rompidas -% IF ((.NOT.DM(B)).AND.(.NOT.FS(B))) THEN -% DEN=DEN+E1(B)*EP(B)*EP(B)*KR(B)*LI(B)/KL -% END IF -% ! -% END DO -% ! -% DU2=ENGD -% DERIV=(DU2-DU1)/DT -% DU1=DU2 -% ! -% RETURN -% END -% !------------- - -% ENERG2 -% ====== -% -% Esta subrotina avalia o desempenho da energia a cada passo de -% integração. -% -% MATLAB translation using GLOBAL variables instead of COMMON. -% -% Energy types: -% ENEX = External work done on the model -% ENIN = Total internal energy dissipated or accumulated -% ENCN = Total kinetic energy of the model -% ENEL = Total elastic energy present in the model -% ENDP = Energy dissipated by damping -% ENGD = Energy dissipated by strain-softening effects -% DEN = Difference between external and internal energy - -% ------------------------------------------------------------------------- -% Global variables (equivalent to the COMMON block) -% ------------------------------------------------------------------------- - - -% ------------------------------------------------------------------------- -% Persistent local variables (keep DU1, DU2 between calls, like Fortran -% SAVE-less but preserved in the calling program's memory) -% ------------------------------------------------------------------------- -persistent DU1 DU2 -if isempty(DU1), DU1 = 0.0; end -if isempty(DU2), DU2 = 0.0; end - -% ------------------------------------------------------------------------- -% Local variables -% ------------------------------------------------------------------------- -DEF = 0.0; -AREA = 0.0; - -ENCN = 0.0; -ENEL = 0.0; -ENGD = 0.0; -DERIV = 0.0; -DEN = 0.0; - -if STEP == 1 - DU1 = 0.0; - DU2 = 0.0; -end - -% ------------------------------------------------------------------------- -% Kinetic energy ENCN -% ------------------------------------------------------------------------- -% for I = 1:NNT -% if I <= NNO -% ENCN = ENCN + MAS(I)*VLX(I)*VLX(I)/2.0; -% ENCN = ENCN + MAS(I)*VLY(I)*VLY(I)/2.0; -% ENCN = ENCN + MAS(I)*VLZ(I)*VLZ(I)/2.0; -% end -% end -%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -ENCN=ENCN+(MAS.*(VLX.^2.0))./2.0; -ENCN=ENCN+(MAS.*(VLY.^2.0))./2.0; -ENCN=ENCN+(MAS.*(VLZ.^2.0))./2.0; -% ------------------------------------------------------------------------- -% Elastic energy ENEL -% ------------------------------------------------------------------------- -for B = 1:NBT - KL = 2; - % Divide by 2 the expression if bars are edge or symmetric bars. - % This implies KL = 4. - if B > NBA - KL = 4; - end - - DEF = SS(B)*SS(B)*LI(B)/KL; - - if SS(B) >= 0.0 - ENEL = ENEL + E2(B)*DEF; - EN(1,B) = E2(B)*DEF; - else - ENEL = ENEL + E1(B)*DEF; - EN(1,B) = E1(B)*DEF; - end - % --------------------------------------------------------------------- - % Strain-softening dissipated energy ENGD - % --------------------------------------------------------------------- - % Broken and damaged bars - if ~DM(B) - AREA = E1(B)*EP(B)*EP(B) - E2(B)*EM(B)*EM(B) + ... - (E1(B)*EP(B) + E2(B)*EM(B))*(EM(B) - EP(B)); - AREA = LI(B)*AREA/KL; - - if B == 7014 % bar number to be followed - fprintf(fid_EnB, '%12.6e %12.6e\n', TIME, AREA); - end - ENGD = ENGD + AREA; - EN(2,B) = AREA; - end - % Store only energy dissipated by broken bars - if (~DM(B)) && (~FS(B)) - DEN = DEN + E1(B)*EP(B)*EP(B)*KR(B)*LI(B)/KL; - end -end - -DU2 = ENGD; -DERIV = (DU2 - DU1)/DT; -DU1 = DU2; - - ini=1; - end diff --git a/legacy/EXTCO1.m b/legacy/EXTCO1.m deleted file mode 100644 index f4d716a..0000000 --- a/legacy/EXTCO1.m +++ /dev/null @@ -1,70 +0,0 @@ -function ini=EXTCO1(MX,NX,LX,C1,C2,C3,ST) -global INT INB U V W U0 V0 W0 BDX BDY BDZ VLX VLY VLZ -global ACX ACY ACZ FRX FRY FRZ FX FY FZ MAS MSS CN ENR -global EDG E1 E2 LI DEQB F YNGB GFRB LCRB EPRB EP SS EM -global EN KR KR1 DSS DM FS CAF DT GFR DEQ LCR TEST EST -global DF DF1 DF2 DMP1 DMP2 TDAF CON M N L M1 N1 L1 MNL -global NNO NNS NNT NBA NBS NBT INCO NCON STEP NSTEP NDAMF -global RUN NRUN LCO TIME TTOT PSN ROH YNG EPR EPMAX EPMIN -global MEAN COEV ENEX ENCN ENEL ENGD ENDP ENIN DEN DERIV -global XB YB ZB UBAR VBAR WBAR REACAOX REACAOY REACAOZ -global STRAIN STRESS SEED -%--------------------------------------------------- -% ! Esta subrotina é chamada pela subrotina conecti para definir as -% ! conectividades das barras externas dos módulos cúbicos. -% ! -%------------------------------------------------------------------------ -% DO 10 K=1,LX -% DO 10 J=1,NX -% DO 10 I=1,MX -% ! -% TYPES=0 -% IF ((I.EQ.1).OR.(I.EQ.M)) TYPES=TYPES+C1 -% IF ((J.EQ.1).OR.(J.EQ.N)) TYPES=TYPES+C2 -% IF ((K.EQ.1).OR.(K.EQ.L)) TYPES=TYPES+C3 -% ! -% NO=(K-1)*M*N+(J-1)*M+I -% B=NBA+(K-1)*MX*NX+(J-1)*MX+I -% ! -% CN(2*B-1)=NO -% CN(2*B)=NO+ST -% ! -% 10 CONTINUE -% ! -% NBA=NBA+MX*NX*LX - - % ----- Triple loop: K=1..LX, J=1..NX, I=1..MX ----- -for K = 1:LX - for J = 1:NX - for I = 1:MX - - % Compute TYPES (unused afterwards, but kept for faithful translation) - TYPES = 0; - if (I == 1) || (I == M) - TYPES = TYPES + C1; - end - if (J == 1) || (J == N) - TYPES = TYPES + C2; - end - if (K == 1) || (K == L) - TYPES = TYPES + C3; - end - - % Linear index into the full-size array (dimensions M x N x L) - NO = (K - 1) * M * N + (J - 1) * M + I; - - % Index into the CN array (based on the subdomain MX x NX x LX) - B = NBA + (K - 1) * MX * NX + (J - 1) * MX + I; - - % Store the pair (NO, NO+ST) in consecutive positions of CN - CN(2 * B - 1) = NO; - CN(2 * B) = NO + ST; - - end - end -end - -% Update the starting offset in CN for a possible next block -NBA = NBA + MX * NX * LX; - ini=1; - end diff --git a/legacy/IGN012.m b/legacy/IGN012.m deleted file mode 100644 index 05b0f91..0000000 --- a/legacy/IGN012.m +++ /dev/null @@ -1,288 +0,0 @@ - -function ini=IGN012() -global INT INB U V W U0 V0 W0 BDX BDY BDZ VLX VLY VLZ -global ACX ACY ACZ FRX FRY FRZ FX FY FZ MAS MSS CN ENR -global EDG E1 E2 LI DEQB F YNGB GFRB LCRB EPRB EP SS EM -global EN KR KR1 DSS DM FS CAF DT GFR DEQ LCR TEST EST -global DF DF1 DF2 DMP1 DMP2 TDAF CON M N L M1 N1 L1 MNL -global NNO NNS NNT NBA NBS NBT INCO NCON STEP NSTEP NDAMF -global RUN NRUN LCO TIME TTOT PSN ROH YNG EPR EPMAX EPMIN -global MEAN COEV ENEX ENCN ENEL ENGD ENDP ENIN DEN DERIV -global XB YB ZB UBAR VBAR WBAR REACAOX REACAOY REACAOZ -global STRAIN STRESS SEED -%! -% SUBROUTINE IGN012 -% ! ================= -% ! -% ! DATA: 08/04/1994 -% ! AUTOR: IGNACIO ITURRIOZ -% ! -% ! Esta subrotina redefine as posições a cada passo de integração. -% ! -% !-------------------------------------------------------------------------- -% ! DESCRIÇÃO DAS VARIÁVEIS -% !-------------------------------------------------------------------------- -% ! -% ! (C) ==> O VALOR DAS VARIÁVEIS MUDAM DENTRO DESTA SUBROTINA -% ! (NC) ==> O VALOR DAS VARIÁVEIS NÃO MUDAM DENTRO DESTA SUBROTINA -% ! (INB) ==> ÍNDICE DE BARRAS -% ! (INN) ==> ÍNDICE DE NÓS -% ! -% ! EST:(NC) int.var Índice que identifica o tipo de amortecimento -% ! EST=0 ==> Amortecimento padrão (C=DF*M) -% ! EST=1 ==> EST=0 + um amortecimento introduzido -% ! na equação constitutiva com CON -% ! EST=2 ==> EST=0, mas o coefic. de amortecimento -% ! DF é multiplicado pelo índice de dano -% ! NNO: -% ! NNT:(NC) int.var Número de nós -% ! NBA: -% ! NBS: -% ! NBT:(NC) int.var Número de barras -% ! CN(2*INB):(NC) int.arr Conectividade das barras -% ! E2(INB): -% ! E1(INB):(NC) dp.arr Módulo de Young das barras inalteradas -% ! -% ! U0(INN): -% ! V0(INN): -% ! W0(INN):(NC) dp.arr Coordenadas nodais na forma inalterada -% ! U(3,INN): -% ! V(3,INN): -% ! W(3,INN): dp.arr Coordenadas nodais da estrutura -% ! BDX(INN): -% ! BDY(INN): -% ! BDZ(INN):(NC) int.arr Condições de contorno aplicadas sobre os nós -% ! ACX(INN): -% ! ACY(INN): -% ! ACZ(INN):(C) dp.arr Acelerações nodais -% ! VLX(INN): -% ! VLY(INN): -% ! VLZ(INN):(C) dp.arr Velocidades nodais -% ! MAS(INN):(NC) dp.arr Massa nodal -% ! FRX(INN): -% ! FRY(INN): -% ! FRZ(INN):(NC) dp.arr Forças nodais -% ! DF1:(C) dp.var Coeficiente de amortecimento -% ! ENDP:(C) dp.var Porção da energia dissipada por amortecimento -% ! LCO:(C) dp.var Comprimento original do elemento -% ! LI(INB):(NC) dp.var Comprimento de cada elemento -% ! DT:(NC) dp.var Incremento de integração -% ! CON:(NC) dp.var Coeficiente de amortecimento se EST=1 -% ! DSS(INB):(NC) dp.arr Velocidades de deformação em cada elemento -% !-------------------------------------------------------------------------- -% PARAMETER (INN=1.2E6,INB=6E6,IRU=20,INCON=8) -% !-------------------------------------------------------------------------- -% ! DEFINIÇÃO DE VARIÁVEIS E GRUPOS COMUNS -% INCLUDE 'COMMON.FOR' -% !-------------------------------------------------------------------------- -% DOUBLE PRECISION DDT,SDT,DF11,TM,DISS -% !-------------------------------------------------------------------------- -% ! -% DO I=1,NNT -% !-------------------------------------------------------------------------- -% ! CÁLCULO DE COEFICIENTES -% !-------------------------------------------------------------------------- -% DDT=2.0D00*DT -% SDT=DT*DT -% DF11=DF1 -% ! -% IF (MAS(I).NE.0.0D00) THEN -% TM=SDT/MAS(I) -% END IF -% ! -% DMP1=(1.0D00-DF11*DT/2.0D00) -% DMP2=(1.0D00+DF11*DT/2.0D00) -% !-------------------------------------------------------------------------- -% ! CÁLCULO DAS NOVAS COORDENADAS POR DIFERENÇAS FINITAS CENTRAIS -% !-------------------------------------------------------------------------- -% IF (BDX(I)) 10,10,20 -% 10 U(3,I)=(TM*FRX(I)+2.0D00*U(2,I)-DMP1*U(1,I))/DMP2 -% GO TO 30 -% 20 U(3,I)=U(2,I) -% 30 CONTINUE -% ! -% IF (BDY(I)) 40,40,50 -% 40 V(3,I)=(TM*FRY(I)+2.0D00*V(2,I)-DMP1*V(1,I))/DMP2 -% GO TO 60 -% 50 V(3,I)=V(2,I) -% 60 CONTINUE -% ! -% IF (BDZ(I)) 70,70,80 -% 70 W(3,I)=(TM*FRZ(I)+2.0D00*W(2,I)-DMP1*W(1,I))/DMP2 -% GO TO 90 -% 80 W(3,I)=W(2,I) -% 90 CONTINUE -% !-------------------------------------------------------------------------- -% END DO -% !-------------------------------------------------------------------------- -% ! CÁLCULO DAS VELOCIDADES E ACELERAÇÕES -% !-------------------------------------------------------------------------- -% DO I=1,NNT -% ! -% VLX(I)=(U(3,I)-U(1,I))/DDT -% VLY(I)=(V(3,I)-V(1,I))/DDT -% VLZ(I)=(W(3,I)-W(1,I))/DDT -% ACX(I)=(U(3,I)-2.0D00*U(2,I)+U(1,I))/SDT -% ACY(I)=(V(3,I)-2.0D00*V(2,I)+V(1,I))/SDT -% ACZ(I)=(W(3,I)-2.0D00*W(2,I)+W(1,I))/SDT -% !-------------------------------------------------------------------------- -% ! CÁLCULO DA ENERGIA DISSIPADA POR AMORTECIMENTO ENDP -% !-------------------------------------------------------------------------- -% DISS=DF11*MAS(I)/2.0D00 -% ENDP=ENDP+DISS*VLX(I)*(U(3,I)-U(1,I)) -% ENDP=ENDP+DISS*VLY(I)*(V(3,I)-V(1,I)) -% ENDP=ENDP+DISS*VLZ(I)*(W(3,I)-W(1,I)) -% ! -% END DO -% !-------------------------------------------------------------------------- -% ! -% !-------------------------------------------------------------------------- -% DO B=1,NBT -% KL=2 -% IF ((B.GT.NBA).AND.(B.LE.NBS)) KL=4 -% IF (SS(B).LT.0.0D00) THEN -% ENDP=ENDP+2.0D00*(E1(B)*CON*DSS(B)*DSS(B)*DT*LI(B)/KL) -% ELSE -% ENDP=ENDP+2.0D00*(E2(B)*CON*DSS(B)*DSS(B)*DT*LI(B)/KL) -% END IF -% END DO -% !-------------------------------------------------------------------------- -% ! ATUALIZA AS COORDENADAS -% !-------------------------------------------------------------------------- -% DO I=1,NNT -% U(1,I)=U(2,I) -% U(2,I)=U(3,I) -% V(1,I)=V(2,I) -% V(2,I)=V(3,I) -% W(1,I)=W(2,I) -% W(2,I)=W(3,I) -% END DO -% ! -% RETURN -% END -% ! -function ign012 -% IGN012 -% ====== -% -% DATA: 08/04/1994 -% AUTOR: IGNACIO ITURRIOZ -% -% Esta subrotina redefine as posições a cada passo de integração. -% -% MATLAB translation using GLOBAL variables instead of COMMON. -% The following globals must be defined in the workspace: -% NNT, NBT, NBA, NBS, DT, DF1, MAS, -% BDX, BDY, BDZ, FRX, FRY, FRZ, -% U, V, W, VLX, VLY, VLZ, ACX, ACY, ACZ, -% ENDP, SS, E1, E2, CON, DSS, LI -% -% Note: The Fortran PARAMETER statement is not used here. - - -%-------------------------------------------------------------------------- -% Local variables -%-------------------------------------------------------------------------- -TM = 0.0; % initialize to avoid undefined use (Fortran local variable) - -DDT = 2.0 * DT; -SDT = DT * DT; -DF11 = DF1; - -DMP1 = (1.0 - DF11*DT/2.0); -DMP2 = (1.0 + DF11*DT/2.0); - -%-------------------------------------------------------------------------- -% Calculate new coordinates by central finite differences -%-------------------------------------------------------------------------- -for I = 1:NNT - if MAS(I) ~= 0.0 - TM = SDT / MAS(I); - end - % If MAS(I) == 0, TM retains its previous value (as in Fortran) - - % X direction - if BDX(I) <= 0 - U(3,I) = (TM*FRX(I) + 2.0*U(2,I) - DMP1*U(1,I)) / DMP2; - else - U(3,I) = U(2,I); - end - - % Y direction - if BDY(I) <= 0 - V(3,I) = (TM*FRY(I) + 2.0*V(2,I) - DMP1*V(1,I)) / DMP2; - else - V(3,I) = V(2,I); - end - - % Z direction - if BDZ(I) <= 0 - W(3,I) = (TM*FRZ(I) + 2.0*W(2,I) - DMP1*W(1,I)) / DMP2; - else - W(3,I) = W(2,I); - end -end - -%-------------------------------------------------------------------------- -% Calculate velocities and accelerations -%-------------------------------------------------------------------------- -%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -% for I = 1:NNT -% VLX(I) = (U(3,I) - U(1,I)) / DDT; -% VLY(I) = (V(3,I) - V(1,I)) / DDT; -% VLZ(I) = (W(3,I) - W(1,I)) / DDT; -% -% ACX(I) = (U(3,I) - 2.0*U(2,I) + U(1,I)) / SDT; -% ACY(I) = (V(3,I) - 2.0*V(2,I) + V(1,I)) / SDT; -% ACZ(I) = (W(3,I) - 2.0*W(2,I) + W(1,I)) / SDT; -% -% % Dissipated energy by damping ENDP -% DISS = DF11 * MAS(I) / 2.0; -% ENDP = ENDP + DISS*VLX(I)*(U(3,I) - U(1,I)); -% ENDP = ENDP + DISS*VLY(I)*(V(3,I) - V(1,I)); -% ENDP = ENDP + DISS*VLZ(I)*(W(3,I) - W(1,I)); -% end -%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% - VLX = (U(3,:) - U(1,:))./ DDT; - VLY = (V(3,:) - V(1,:))./ DDT; - VLZ = (W(3,:) - W(1,:))./ DDT; - ACX = (U(3,:) -U(2,:).*2.0 + U(1,:))./ SDT; - ACY = (V(3,:) - V(2,I).*2.0 + V(1,:))./ SDT; - ACZ = (W(3,:) - W(2,:).*2.0 + W(1,:))./ SDT; - % Dissipated energy by damping ENDP - ENDP = ENDP + (DF11.*(MAS./2.0)).*VLX.*(U(3,:)-U(1,:)); - ENDP = ENDP + (DF11.*(MAS./2.0)).*VLY.*(V(3,:)-V(1,:)); - ENDP = ENDP + (DF11.*(MAS./2.0)).*VLZ.*(W(3,:)-W(1,:)); -%-------------------------------------------------------------------------- -% Additional damping energy in bars -%-------------------------------------------------------------------------- -for B = 1:NBT - KL = 2; - if (B > NBA) && (B <= NBS) - KL = 4; - end - - if SS(B) < 0.0 - ENDP = ENDP + 2.0*(E1(B)*CON*DSS(B)*DSS(B)*DT*LI(B)/KL); - else - ENDP = ENDP + 2.0*(E2(B)*CON*DSS(B)*DSS(B)*DT*LI(B)/KL); - end -end - -%-------------------------------------------------------------------------- -% Update coordinates -%-------------------------------------------------------------------------- - U(1,:) = U(2,:); - U(2,:) = U(3,:); - V(1,:) = V(2,:); - V(2,:) = V(3,:); - W(1,:) = W(2,:); - W(2,:) = W(3,:); -end - -% FIX: ign012 is a nested function and was never called, so the equations of -% motion were not integrated (see legacy/KNOWN_ISSUES.md, item 0). -ign012; - -ini=1; - end diff --git a/legacy/IMPERF.m b/legacy/IMPERF.m deleted file mode 100644 index 19fd74e..0000000 --- a/legacy/IMPERF.m +++ /dev/null @@ -1,108 +0,0 @@ - -function ini=IMPERF() -global INT INB U V W U0 V0 W0 BDX BDY BDZ VLX VLY VLZ -global ACX ACY ACZ FRX FRY FRZ FX FY FZ MAS MSS CN ENR -global EDG E1 E2 LI DEQB F YNGB GFRB LCRB EPRB EP SS EM -global EN KR KR1 DSS DM FS CAF DT GFR DEQ LCR TEST EST -global DF DF1 DF2 DMP1 DMP2 TDAF CON M N L M1 N1 L1 MNL -global NNO NNS NNT NBA NBS NBT INCO NCON STEP NSTEP NDAMF -global RUN NRUN LCO TIME TTOT PSN ROH YNG EPR EPMAX EPMIN -global MEAN COEV ENEX ENCN ENEL ENGD ENDP ENIN DEN DERIV -global XB YB ZB UBAR VBAR WBAR REACAOX REACAOY REACAOZ -global STRAIN STRESS SEED -% %--------------------------------------------------- -% ! -% SUBROUTINE IMPERF - -% ! Esta subrotina introduz imperfeições na malha. - -% !-------------------------------------------------------------------------- -% INTEGER NI,NO -% !-------------------------------------------------------------------------- -% DOUBLE PRECISION FUVW,CVUVW,UNIF,STA101 -% !-------------------------------------------------------------------------- -% ! GERAÇÃO DO CAMPO ALEATÓRIO PARA PERTUBAR A MALHA -% !-------------------------------------------------------------------------- -% ! - -% ! - -rng(SEED)% define the SEED of the Mesh perturbation randon field. - LABELN=1 % The mesh perturbation is active - LABELN=0 % inactive - CVUVW=2.0e-2 ;% define the variation coeficient of the mesh perturbation - % CUVW= 2.75D-02; - -if LABELN == 1; %&&&&&&&& - % ! - U(1,:)=U(1,:)+randn(1,NNT)*CVUVW*LCO; - U(2,:)=U(1,:); - U(3,:)=U(1,:); - V(1,:)=V(1,:)+randn(1,NNT)*CVUVW*LCO; - V(2,:)=V(1,:); - V(3,:)=V(1,:); - W(1,:)=W(1,:)+randn(1,NNT)*CVUVW*LCO; - W(2,:)=W(1,:); - W(3,:)=W(1,:); -% DO I=1,NNT -% UNIF=RAN0(SEED) -% FUVW=STA101(UNIF,1.0D-50) -% U(1,I)=U(1,I)+FUVW*CVUVW*LCO -% U(2,I)=U(1,I) -% U(3,I)=U(1,I) -% UNIF=RAN0(SEED) -% FUVW=STA101(UNIF,1.0D-50) -% V(1,I)=V(1,I)+FUVW*CVUVW*LCO -% V(2,I)=V(1,I) -% V(3,I)=V(1,I) -% UNIF=RAN0(SEED) -% FUVW=STA101(UNIF,1.0D-50) -% W(1,I)=W(1,I)+FUVW*CVUVW*LCO -% W(2,I)=W(1,I) -% W(3,I)=W(1,I) -% !%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -% condition to create a border with no perturbed mesh -% -% Create a logical vector (mask) that is TRUE where ANY condition is satisfied -% (Equivalent to having separate IFs, as the assignments are identical) -mask = (W0 >= (L1 - 1.01) * LCO) | ... % Condition 1 - (W0 <= (1.01 * LCO)) | ... % Condition 2 - (U0 >= (M1 - 1.01) * LCO) | ... % Condition 3 - (U0 <= (1.01 * LCO)) | ... % Condition 4 - (V0 >= (N1 - 1.01) * LCO) | ... % Condition 5 - (V0 <= (1.01 * LCO)); % Condition 6 - -% Apply the assignments ONLY to the columns where mask = true - -% Note: This code assumes U0, V0, W0 are ROW vectors (1 x NNT). -% If they are COLUMN vectors (NNT x 1), use U0(mask).' to transpose. - U(1, mask) = U0(mask); - U(2, mask) = U0(mask); - U(3, mask) = U0(mask); - - V(1, mask) = V0(mask); - V(2, mask) = V0(mask); - V(3, mask) = V0(mask); - - W(1, mask) = W0(mask); - W(2, mask) = W0(mask); - W(3, mask) = W0(mask); -%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -end % here finish the first if condition &&&&&&& -% DO NO=1,NNT -% U0(NO)=U(1,NO) -% V0(NO)=V(1,NO) -% W0(NO)=W(1,NO) -% END DO -U0=U(1,:); -V0=V(1,:); -W0=W(1,:); - -% ! -% END IF -% -% RETURN -% END -%! - ini=1; - end diff --git a/legacy/INTCO1.m b/legacy/INTCO1.m deleted file mode 100644 index 0a792ec..0000000 --- a/legacy/INTCO1.m +++ /dev/null @@ -1,51 +0,0 @@ - -function ini=INTCO1 (MX,NX,LX,ST) -% INTCO1 Define a conectividade das barras internas dos módulos cúbicos. -% Chamada por CONECTI. -global INT INB U V W U0 V0 W0 BDX BDY BDZ VLX VLY VLZ -global ACX ACY ACZ FRX FRY FRZ FX FY FZ MAS MSS CN ENR -global EDG E1 E2 LI DEQB F YNGB GFRB LCRB EPRB EP SS EM -global EN KR KR1 DSS DM FS CAF DT GFR DEQ LCR TEST EST -global DF DF1 DF2 DMP1 DMP2 TDAF CON M N L M1 N1 L1 MNL -global NNO NNS NNT NBA NBS NBT INCO NCON STEP NSTEP NDAMF -global RUN NRUN LCO TIME TTOT PSN ROH YNG EPR EPMAX EPMIN -global MEAN COEV ENEX ENCN ENEL ENGD ENDP ENIN DEN DERIV -global XB YB ZB UBAR VBAR WBAR REACAOX REACAOY REACAOZ -global STRAIN STRESS SEED -%--------------------------------------------------- -% ! -% ! Esta subrotina é chamada pela subrotina conecti para definir as -% ! conectividades das barras internas dos módulos cúbicos. -% ! - -%!-------------------------------------------------------------------------- -% DO 10 K=1,LX -% DO 10 J=1,NX -% DO 10 I=1,MX -% ! -% NO=MNL+(K-1)*M1*N1+(J-1)*M1+I -% B=NBA+(K-1)*MX*NX+(J-1)*MX+I -% ! -% CN(2*B-1)=NO -% CN(2*B)=NO+ST -% ! -% 10 CONTINUE -% ! -% NBA=NBA+MX*NX*LX - -% Create 3D index grids (I varies fastest) -[I, J, K] = ndgrid(1:MX, 1:NX, 1:LX); - -% Compute all NO and B indices at once -NO = MNL + (K - 1) * M1 * N1 + (J - 1) * M1 + I; -B = NBA + (K - 1) * MX * NX + (J - 1) * MX + I; - -% Flatten and assign to CN -CN(2 * B(:) - 1) = NO(:); -CN(2 * B(:)) = NO(:) + ST; - -% Update NBA -NBA = NBA + MX * NX * LX; - - ini=1; - end diff --git a/legacy/KNOWN_ISSUES.md b/legacy/KNOWN_ISSUES.md deleted file mode 100644 index 8bb371d..0000000 --- a/legacy/KNOWN_ISSUES.md +++ /dev/null @@ -1,96 +0,0 @@ -# Known issues of the legacy code - -`legacy/` is the frozen reference implementation. The regression tests compare -the refactored code against it, so its numerics must not change. Issues found -while freezing it are listed here and are **resolved explicitly in the new -code** (each one has a test that documents the decision). - -## Fixed in legacy (no effect on the physics) - -| File | Problem | Fix | -|------|---------|-----| -| `main1.m` | Scratch lines `a=1, b=2, c=3` at the top | Removed | -| `main1.m` | Closing section used undefined `fid12/fid15/fid19/fid20` and crashed at the end of every run | Closes the file ids that were really opened | -| `main1.m` | `ARMANS(I3)` (parentheses) and `[...] = ini==ANSYS(...)` crashed when ANSYS output was enabled | `ARMANS{I3}`, plain call | -| `BOUND.m` | `ini` only assigned when `TEST == 102`, so `TEST 101` failed | Assigned unconditionally | -| `IGN012.m` | **Critical.** The central-difference integration was in a nested function `ign012` that was never called, so no node moved except those with a prescribed displacement (velocities and accelerations were exactly 0) | Added the call `ign012;`. Results change: the fixtures were regenerated and cases that damaged because of the frozen neighbours no longer do | - -## Not fixed (would change results or output) - decide in the new code - -1. **`ENERG2.m` lines 172-174: kinetic energy is not summed.** *(Resolved in the new code.)* - `ENCN = ENCN + (MAS.*VLX.^2)/2` is element-wise, so `ENCN` is a - 1-by-`INT` vector (kinetic energy per node) instead of a scalar. `ENIN`, - `DEN` and the energy balance inherit this shape. - *New code:* `energy.kinetic = sum(...)` (scalar). The regression test - compares `sum(ENCN)` with the new scalar. -2. **`WRIENE.m` line 35: invalid format `%25.12` (missing `e`).** *(Output to be written by the new exporters.)* - `fprintf` stops at the invalid conversion, so `LET.ENE` is truncated and - garbled. Correcting only the format would write one row per element of the - `ENCN` vector (90 MB for 200 steps), so it depends on issue 1. - *New code:* one well-formed row per saved step. -3. **`BOUND.m`, `TEST == 101`: operator precedence.** - `mask2` uses `U0 > (M1 - 0.51*LCO)` instead of `(M1 - 0.51)*LCO`; it - selects no node, so the right end is never fixed in x. - *New code:* decide with the author whether this support was intended. -4. **`CABAR.m` / `ENERG2.m`: tracked bar hardcoded to 7014.** - *New code:* `params.trackedBar`. -5. **`CALOAD.m` / `BOUND.m` / `CALRES.m` / `ANSYS.m` (`TEST == 102`):** - geometry hardcoded in module units (`33.49`, `4.51`, `50.5`...), so the - scenario only works for meshes with `M >= ~70`. - *New code:* scenario parameters. -6. **`IMPERF.m`: `LABELN` is set to 1 and then immediately to 0,** so the mesh - perturbation is never applied (the random generator seed has no effect). -7. **`CALCOEV.m`: the coefficient of variation is never stored.** - It computes `COEF = std(EP)/MEAN` but the global variable is `COEV`, which - therefore stays 0 (and is printed as 0 in the input echo). - *New code:* `barProps.criticalStrainCv` holds the real value. -8. **`DEFEP.m`: unused safety check.** `DEFEP` stops when `KR < 1.01`, but - `RMEC` no longer calls it (the formulas are inlined), so the check never - runs and the softening branch could divide by `KR - 1 ~ 0`. - *New code:* `buildBarProperties` raises `ldem:material:criticalLengthTooShort`. -9. **Random field is mandatory.** The main program fails if the file - `arquivo_3lc_rnao_cv05` is missing, with no way to run a homogeneous - material. *New code:* `params.randomFieldFile` is optional (empty = all - multipliers equal to 1). -10. **Preallocation `INT = 168000`, `INB = 2300000`** limits the mesh size. -11. **`ign012` (IGN012.m): acceleration in y uses a wrong index.** - `ACY = (V(3,:) - V(2,I).*2.0 + V(1,:))./SDT` uses `V(2,I)` (a scalar, with - `I` left over from the node loop) instead of `V(2,:)`. Only the reported - acceleration is affected, not the motion. - *New code:* the three components use the same formula - (`ldem.solver.integrateStep`); the regression test skips `ACY`. -12. **`ign012`: damping energy mixes vectors and scalars.** - `ENDP` becomes a per-node vector, and the viscous dissipation of every bar - (a scalar) is added to every node entry, so `sum(ENDP)` counts the bar - terms `NNT` times. The reference cases have `CON = 0`, where the two - definitions coincide. - *New code:* `state.dampingEnergy` is a scalar. -13. **`ENERG2.m` / `IGN012.m`: `KL` is always 2.** The test `B > NBA` (or - `B <= NBS`) selecting `KL = 4` for the diagonals never holds because - `NBA = NBS = NBT`. `KL = 2` gives the exact bar energy - (`E*strain^2*L/2`), so the results are right; the dead branch was removed. -14. **`ENEX` (external work) is never computed.** It stays 0 and the energy - balance `ENEX - ENIN` is not available. - *New code:* not provided yet; `energy.internal` is. -15. **`CALOAD.m`, `TEST == 102`: the second load point is never loaded.** - The condition is `LOGIC1 && LOGIC2`, two conditions on the x coordinate - that can only both hold for `M1 = 67`; `BOUND` holds both load points in y, - so the left one acts as a support. - *New code:* reproduced (`FourPointBending.loadedNodes`); decide with the - author whether both points should be loaded. -16. **`TDAF` shorter than half a time step never switches the damping.** - The switch is done when `STEP == NDAMF` and `NDAMF` would be 0. - *New code:* reproduced (`ldem.solver.dampingCoefficient`). -17. **`TEST == 101` sign convention.** The loaded nodes move to - `x0 - VF2*TIME`, which compresses the prism for `VF2 > 0` although the - comment says "tension". *New code:* same convention, documented in - `UniaxialTension`. -18. **`ANSYS.m`: three problems in the macro files.** - (a) The line `ET,IFILE,4` is an invalid ANSYS command (a translation slip - for `ET,3,4`); (b) constraints (`D,node,UX`...) are only written for - `TEST == 102`; (c) the "applied loads" section writes `F,node,Fx,-10` for - nodes selected with hardcoded coordinates (`50.5*LCO`...) that match no - node of the beam. - *New code (`ldem.io.exportAnsys`):* writes `ET,3,4`, writes the constraints - of every scenario and leaves the loads section empty. The regression test - normalizes (a) and (b) before comparing with the legacy files. diff --git a/legacy/NAYFES0.m b/legacy/NAYFES0.m deleted file mode 100644 index 33a0023..0000000 --- a/legacy/NAYFES0.m +++ /dev/null @@ -1,46 +0,0 @@ - -function ini=NAYFES0() -global INT INB U V W U0 V0 W0 BDX BDY BDZ VLX VLY VLZ -global ACX ACY ACZ FRX FRY FRZ FX FY FZ MAS MSS CN ENR -global EDG E1 E2 LI DEQB F YNGB GFRB LCRB EPRB EP SS EM -global EN KR KR1 DSS DM FS CAF DT GFR DEQ LCR TEST EST -global DF DF1 DF2 DMP1 DMP2 TDAF CON M N L M1 N1 L1 MNL -global NNO NNS NNT NBA NBS NBT INCO NCON STEP NSTEP NDAMF -global RUN NRUN LCO TIME TTOT PSN ROH YNG EPR EPMAX EPMIN -global MEAN COEV ENEX ENCN ENEL ENGD ENDP ENIN DEN DERIV -global XB YB ZB UBAR VBAR WBAR REACAOX REACAOY REACAOZ -global STRAIN STRESS SEED - - -%---------------------------------------------------------------------- -% Local constants and derived parameters -%---------------------------------------------------------------------- -DELTA = 9.0 * PSN / (4.0 - 8.0 * PSN); -ALFA = (9.0 + 8.0 * DELTA) / (18.0 + 24.0 * DELTA); -%---------------------------------------------------------------------- -% Initialize output arrays -%---------------------------------------------------------------------- -YNGB = ones(1, NBT); -YNGB=YNGB.*YNG; -E1 = ones(1, NBT); -E2 = ones(1, NBT); -GFRB = ones(1, NBT); -GFRB=GFRB.*GFR; -DEQB = ones(1, NBT); -DEQB=DEQB.*DEQ; -ENR =(YNGB.*(LI.^2)).*ALFA; -aux=(2.0*DELTA*(4.0/3.0))/sqrt(3.0); -EDG = ENR*aux; -LCRB = ones(1, NBT); -LCR = DEQ * 2.0 * CAF / ALFA; -LCRB= LCRB.*LCR; -EPRB =sqrt(GFRB./(YNGB.*DEQB)); -LMIN= min(LI) -dt_cmin = LMIN/(sqrt(min(YNGB)/ROH)); - -if dt_cmin < DT - fprintf('dt_cmin = %g, dt = %g\n', dt_cmin, DT); - error('NAYFES0: dt_cmin < DT . Execution stopped.'); -end - ini=1; - end diff --git a/legacy/NODMASS.m b/legacy/NODMASS.m deleted file mode 100644 index 9dc9b32..0000000 --- a/legacy/NODMASS.m +++ /dev/null @@ -1,68 +0,0 @@ - -function ini=NODMASS() -global INT INB U V W U0 V0 W0 BDX BDY BDZ VLX VLY VLZ -global ACX ACY ACZ FRX FRY FRZ FX FY FZ MAS MSS CN ENR -global EDG E1 E2 LI DEQB F YNGB GFRB LCRB EPRB EP SS EM -global EN KR KR1 DSS DM FS CAF DT GFR DEQ LCR TEST EST -global DF DF1 DF2 DMP1 DMP2 TDAF CON M N L M1 N1 L1 MNL -global NNO NNS NNT NBA NBS NBT INCO NCON STEP NSTEP NDAMF -global RUN NRUN LCO TIME TTOT PSN ROH YNG EPR EPMAX EPMIN -global MEAN COEV ENEX ENCN ENEL ENGD ENDP ENIN DEN DERIV -global XB YB ZB UBAR VBAR WBAR REACAOX REACAOY REACAOZ -global STRAIN STRESS SEED - -%! Esta subrotina determina as condições de contorno da estrutura. -% -% ! Esta subrotina calcula a massa nodal, baseada no volume de influência -% ! de cada nó. -MSS=ones(NNT,1); -MSS=MSS.*(LCO*LCO*LCO*ROH/2.0D00); -%! -% DO I=1,NNT -% MSS(I)=LCO*LCO*LCO*ROH/2.0D00 -% END DO -% ! - -% !-------------------------------------------------------------------------- -% DO 10 K=1,L -% DO 10 J=1,N -% DO 10 I=1,M -% RED=1.0D00 -% IF ((K.EQ.1).OR.(K.EQ.L)) RED=RED/2.0D00 -% IF ((J.EQ.1).OR.(J.EQ.N)) RED=RED/2.0D00 -% IF ((I.EQ.1).OR.(I.EQ.M)) RED=RED/2.0D00 -% NO=(K-1)*M*N+(J-1)*M+I -% MAS(NO)=RED*MSS(NO) -% 10 CONTINUE -% ! -% DO 20 K=1,L1 -% DO 20 J=1,N1 -% DO 20 I=1,M1 -% NO=MNL+(K-1)*M1*N1+(J-1)*M1+I -% MAS(NO)=MSS(NO) -% 20 CONTINUE -% ! - -% Create 3D grids of indices -[I, J, K] = ndgrid(1:M, 1:N, 1:L); % I varies fastest (first dimension) - -% Count how many boundaries the point lies on -boundaryCount = (K == 1 | K == L) + (J == 1 | J == N) + (I == 1 | I == M); -RED = 2 .^ (-boundaryCount); % RED = 1/2^count - -% Linear index in column-major order (same formula) -NO = (K-1)*M*N + (J-1)*M + I; - -% Assign scaled values -MAS(NO) = RED .* MSS(NO); - -% Generate indices for the second region -[I, J, K] = ndgrid(1:M1, 1:N1, 1:L1); -NO = MNL + (K-1)*M1*N1 + (J-1)*M1 + I; -MAS(NO) = MSS(NO); -% RETURN -% END -%! - - ini=1; - end diff --git a/legacy/RMEC.m b/legacy/RMEC.m deleted file mode 100644 index 2c86a17..0000000 --- a/legacy/RMEC.m +++ /dev/null @@ -1,93 +0,0 @@ -function ini=RMEC() -% RMEC Calcula as propriedades mecânicas das barras (exteriores, interiores e diagonais). -global INT INB U V W U0 V0 W0 BDX BDY BDZ VLX VLY VLZ -global ACX ACY ACZ FRX FRY FRZ FX FY FZ MAS MSS CN ENR -global EDG E1 E2 LI DEQB F YNGB GFRB LCRB EPRB EP SS EM -global EN KR KR1 DSS DM FS CAF DT GFR DEQ LCR TEST EST -global DF DF1 DF2 DMP1 DMP2 TDAF CON M N L M1 N1 L1 MNL -global NNO NNS NNT NBA NBS NBT INCO NCON STEP NSTEP NDAMF -global RUN NRUN LCO TIME TTOT PSN ROH YNG EPR EPMAX EPMIN -global MEAN COEV ENEX ENCN ENEL ENGD ENDP ENIN DEN DERIV -global XB YB ZB UBAR VBAR WBAR REACAOX REACAOY REACAOZ -global STRAIN STRESS SEED - - NBA=0 - NBS=0 - NBT=0 -%! -M2 = M - 2; -N2 = N - 2; -L2 = L - 2; -MN = M * N; -MN1 = M1 * N1; -%-------------------------------------------------------------------------- -% Calls to exterior / interior / diagonal routines -%-------------------------------------------------------------------------- -RMECEX(M1, N, L, 0, 1, 1, 1); -RMECEX(M, N1, L, 1, 0, 1, M); -RMECEX(M, N, L1, 1, 1, 0, MN); -% -RMECIN(M2, N1, L1, 1); -RMECIN(M1, N2, L1, M1); -RMECIN(M1, N1, L2, MN1); -% -RMECDI(); -% -NBS = NBA; -NI = NNO; -NBT = NBS; -% -% ! -% SUBROUTINE RMEC -% ! =============== -% ! -% ! -% ! -% !-------------------------------------------------------------------------- -% PARAMETER (INN=1.2E6,INB=6E6,IRU=6,INCON=10) -% !-------------------------------------------------------------------------- -% ! DEFINIÇÃO DE VARIÁVEIS E GRUPOS COMUNS -% INCLUDE 'COMMON.FOR' -% !-------------------------------------------------------------------------- -% INTEGER M2,N2,L2,MN,MN1 -% !-------------------------------------------------------------------------- -% NBA=0 -% NBS=0 -% NBT=0 -% ! -% M2=M-2 -% N2=N-2 -% L2=L-2 -% MN=M*N -% MN1=M1*N1 -% ! -% -% CALL RMECEX (M1,N,L,0,1,1,1) -% CALL RMECEX (M,N1,L,1,0,1,M) -% CALL RMECEX (M,N,L1,1,1,0,MN) -% ! -% -% CALL RMECIN (M2,N1,L1,1) -% CALL RMECIN (M1,N2,L1,M1) -% CALL RMECIN (M1,N1,L2,MN1) -% -% CALL RMECDI -% ! -% NBS=NBA -% NI=NNO -% NBT=NBS -% ! -% RETURN -% END - -% MODIFICAÇÃO RODRIGO -% ======================================================== - % VETORIZAÇÃO GLOBAL: Substitui milhões de chamadas ao DEFEP - % Aplica as propriedades comuns a todas as barras instantaneamente - % ======================================================== - EP(1:NBT) = EPRB(1:NBT); - KR(1:NBT) = LCRB(1:NBT) ./ LI(1:NBT); - E2(1:NBT) = E1(1:NBT); - - ini = 1; -end \ No newline at end of file diff --git a/legacy/RMEC2.m b/legacy/RMEC2.m deleted file mode 100644 index 56f5976..0000000 --- a/legacy/RMEC2.m +++ /dev/null @@ -1,114 +0,0 @@ -function ini=RMEC2() -global INT INB U V W U0 V0 W0 BDX BDY BDZ VLX VLY VLZ -global ACX ACY ACZ FRX FRY FRZ FX FY FZ MAS MSS CN ENR -global EDG E1 E2 LI DEQB F YNGB GFRB LCRB EPRB EP SS EM -global EN KR KR1 DSS DM FS CAF DT GFR DEQ LCR TEST EST -global DF DF1 DF2 DMP1 DMP2 TDAF CON M N L M1 N1 L1 MNL -global NNO NNS NNT NBA NBS NBT INCO NCON STEP NSTEP NDAMF -global RUN NRUN LCO TIME TTOT PSN ROH YNG EPR EPMAX EPMIN -global MEAN COEV ENEX ENCN ENEL ENGD ENDP ENIN DEN DERIV -global XB YB ZB UBAR VBAR WBAR REACAOX REACAOY REACAOZ -global STRAIN STRESS SEED - - NBA=0 - NBS=0 - NBT=0 -%! -M2 = M - 2; -N2 = N - 2; -L2 = L - 2; -MN = M * N; -MN1 = M1 * N1; -%-------------------------------------------------------------------------- -% Calls to exterior / interior / diagonal routines -%-------------------------------------------------------------------------- - -for K = 1:LX - for J = 1:NX - for I = 1:MX - TYPES = 0; - if (I == 1) || (I == M) - TYPES = TYPES + C1; - end - if (J == 1) || (J == N) - TYPES = TYPES + C2; - end - if (K == 1) || (K == L) - TYPES = TYPES + C3; - end - - NO = (K - 1) * M * N + (J - 1) * M + I; - B = NBA + (K - 1) * MX * NX + (J - 1) * MX + I; - NOI = NO; - NOF = NO + ST; - - DEFEP(B, TYPES); - - end - end -end - -%-------------------------------------------------------------------------- -% Update global counter -%-------------------------------------------------------------------------- -NBA = NBA + MX * NX * LX; -RMECEX(M1, N, L, 0, 1, 1, 1); -RMECEX(M, N1, L, 1, 0, 1, M); -RMECEX(M, N, L1, 1, 1, 0, MN); -% -RMECIN(M2, N1, L1, 1); -RMECIN(M1, N2, L1, M1); -RMECIN(M1, N1, L2, MN1); -% -RMECDI(); -% -NBS = NBA; -NI = NNO; -NBT = NBS; -% -% ! -% SUBROUTINE RMEC -% ! =============== -% ! -% ! -% ! -% !-------------------------------------------------------------------------- -% PARAMETER (INN=1.2E6,INB=6E6,IRU=6,INCON=10) -% !-------------------------------------------------------------------------- -% ! DEFINIÇÃO DE VARIÁVEIS E GRUPOS COMUNS -% INCLUDE 'COMMON.FOR' -% !-------------------------------------------------------------------------- -% INTEGER M2,N2,L2,MN,MN1 -% !-------------------------------------------------------------------------- -% NBA=0 -% NBS=0 -% NBT=0 -% ! -% M2=M-2 -% N2=N-2 -% L2=L-2 -% MN=M*N -% MN1=M1*N1 -% ! -% -% CALL RMECEX (M1,N,L,0,1,1,1) -% CALL RMECEX (M,N1,L,1,0,1,M) -% CALL RMECEX (M,N,L1,1,1,0,MN) -% ! -% -% CALL RMECIN (M2,N1,L1,1) -% CALL RMECIN (M1,N2,L1,M1) -% CALL RMECIN (M1,N1,L2,MN1) -% -% CALL RMECDI -% ! -% NBS=NBA -% NI=NNO -% NBT=NBS -% ! -% RETURN -% END - - - ini=1; - end diff --git a/legacy/RMECDI.m b/legacy/RMECDI.m deleted file mode 100644 index ec581eb..0000000 --- a/legacy/RMECDI.m +++ /dev/null @@ -1,88 +0,0 @@ - -function ini=RMECDI() -global INT INB U V W U0 V0 W0 BDX BDY BDZ VLX VLY VLZ -global ACX ACY ACZ FRX FRY FRZ FX FY FZ MAS MSS CN ENR -global EDG E1 E2 LI DEQB F YNGB GFRB LCRB EPRB EP SS EM -global EN KR KR1 DSS DM FS CAF DT GFR DEQ LCR TEST EST -global DF DF1 DF2 DMP1 DMP2 TDAF CON M N L M1 N1 L1 MNL -global NNO NNS NNT NBA NBS NBT INCO NCON STEP NSTEP NDAMF -global RUN NRUN LCO TIME TTOT PSN ROH YNG EPR EPMAX EPMIN -global MEAN COEV ENEX ENCN ENEL ENGD ENDP ENIN DEN DERIV -global XB YB ZB UBAR VBAR WBAR REACAOX REACAOY REACAOZ -global STRAIN STRESS SEED -% SUBROUTINE RMECDI -% ! ================= -% ! -% ! Esta subrotina é chamada pela subrotina rmec para definir as -% ! propriedades mecânicas das barras diagonais dos módulos cúbicos. -% ! -% !-------------------------------------------------------------------------- -% PARAMETER (INN=1.2E6,INB=6E6,IRU=6,INCON=10) -% !-------------------------------------------------------------------------- -% ! DEFINIÇÃO DE VARIÁVEIS E GRUPOS COMUNS -% INCLUDE 'COMMON.FOR' -% !-------------------------------------------------------------------------- -% INTEGER G,I,J,K,NOI,NOF,B,ST(8),REF,NOFF -% !-------------------------------------------------------------------------- -% REF=NBA -% ST(1)=0 -% ST(2)=1 -% ST(3)=M -% ST(4)=M+1 -% ST(5)=N*M -% ST(6)=N*M+1 -% ST(7)=N*M+M -% ST(8)=N*M+M+1 -% ! -% DO 20 K=1,L1 -% DO 20 J=1,N1 -% DO 20 I=1,M1 -% NOI=(K-1)*M1*N1+(J-1)*M1+I -% NOF=(K-1)*M*N+(J-1)*M+I -% B=REF+(NOI-1)*8 -% NOI=NOI+MNL -% DO 10 G=1,8 -% B=B+1 -% NOFF=NOF+ST(G) -% ! -% CALL DEFEP(B,3) -% ! -% 10 CONTINUE -% ! -% NBA=NBA+8 -% ! -% 20 CONTINUE -% ! -% RETURN -% END -% ! -% Local variables -%-------------------------------------------------------------------------- -%ST = zeros(1, 8); % 1-based indexing matches Fortran's ST(1..8) -%-------------------------------------------------------------------------- -% Reference offset and ST table -%-------------------------------------------------------------------------- - -% MODIFICAÇÕES RODRIGO -REF = NBA; -ST = [0, 1, M, M+1, N*M, N*M+1, N*M+M, N*M+M+1]; - -%-------------------------------------------------------------------------- -% Outer nest: K (outer), J (middle), I (inner) -- all share label 20 -%-------------------------------------------------------------------------- -for K = 1:L1 - for J = 1:N1 - for I = 1:M1 - NOI = (K - 1) * M1 * N1 + (J - 1) * M1 + I; - B = REF + (NOI - 1) * 8; - - for G = 1:8 - B = B + 1; - E1(B) = EDG(B); % Lógica embutida do DEFEP - end - NBA = NBA + 8; - end - end - end - ini = 1; -end diff --git a/legacy/RMECEX.m b/legacy/RMECEX.m deleted file mode 100644 index b3718e4..0000000 --- a/legacy/RMECEX.m +++ /dev/null @@ -1,84 +0,0 @@ - -function ini=RMECEX (MX,NX,LX,C1,C2,C3,ST) -global INT INB U V W U0 V0 W0 BDX BDY BDZ VLX VLY VLZ -global ACX ACY ACZ FRX FRY FRZ FX FY FZ MAS MSS CN ENR -global EDG E1 E2 LI DEQB F YNGB GFRB LCRB EPRB EP SS EM -global EN KR KR1 DSS DM FS CAF DT GFR DEQ LCR TEST EST -global DF DF1 DF2 DMP1 DMP2 TDAF CON M N L M1 N1 L1 MNL -global NNO NNS NNT NBA NBS NBT INCO NCON STEP NSTEP NDAMF -global RUN NRUN LCO TIME TTOT PSN ROH YNG EPR EPMAX EPMIN -global MEAN COEV ENEX ENCN ENEL ENGD ENDP ENIN DEN DERIV -global XB YB ZB UBAR VBAR WBAR REACAOX REACAOY REACAOZ -global STRAIN STRESS SEED -% SUBROUTINE RMECEX (MX,NX,LX,C1,C2,C3,ST) -% ! ================= -% ! -% ! Esta subrotina é chamada pela subrotina rmec para definir as -% ! propriedades mecânicas das barras externas dos módulos cúbicos. -% ! -% !-------------------------------------------------------------------------- -% PARAMETER (INN=1.2E6,INB=6E6,IRU=6,INCON=10) -% !-------------------------------------------------------------------------- -% ! DEFINIÇÃO DE VARIÁVEIS E GRUPOS COMUNS -% INCLUDE 'COMMON.FOR' -% !-------------------------------------------------------------------------- -% INTEGER I,J,K,NO,B,MX,NX,LX -% INTEGER NOI,NOF,ST -% INTEGER TYPES,C1,C2,C3 -% !-------------------------------------------------------------------------- -% DO 10 K=1,LX -% DO 10 J=1,NX -% DO 10 I=1,MX -% ! -% TYPES=0 -% IF ((I.EQ.1).OR.(I.EQ.M)) TYPES=TYPES+C1 -% IF ((J.EQ.1).OR.(J.EQ.N)) TYPES=TYPES+C2 -% IF ((K.EQ.1).OR.(K.EQ.L)) TYPES=TYPES+C3 -% ! -% NO=(K-1)*M*N+(J-1)*M+I -% B=NBA+(K-1)*MX*NX+(J-1)*MX+I -% NOI=NO -% NOF=NO+ST -% ! -% -% CALL DEFEP(B,TYPES) -% -% ! -% 10 CONTINUE -% ! -% NBA=NBA+MX*NX*LX -% ! -% RETURN -% END -% ! - -% MODIFICAÇÃO RODRIGO -for K = 1:LX - for J = 1:NX - for I = 1:MX - TYPES = 0; - if (I == 1) || (I == M), TYPES = TYPES + C1; end - if (J == 1) || (J == N), TYPES = TYPES + C2; end - if (K == 1) || (K == L), TYPES = TYPES + C3; end - - B = NBA + (K - 1) * MX * NX + (J - 1) * MX + I; - - % Lógica embutida do DEFEP - if TYPES == 0 - RED = 1.00; - elseif TYPES == 1 - RED = 0.50; - else - RED = 0.25; - end - - E1(B) = ENR(B) * RED; - end - end -end -%-------------------------------------------------------------------------- -% Update global counter -%-------------------------------------------------------------------------- - NBA = NBA + MX * NX * LX; - ini = 1; -end \ No newline at end of file diff --git a/legacy/RMECIN.m b/legacy/RMECIN.m deleted file mode 100644 index 7ddf2b8..0000000 --- a/legacy/RMECIN.m +++ /dev/null @@ -1,59 +0,0 @@ - -function ini=RMECIN (MX,NX,LX,ST) -global INT INB U V W U0 V0 W0 BDX BDY BDZ VLX VLY VLZ -global ACX ACY ACZ FRX FRY FRZ FX FY FZ MAS MSS CN ENR -global EDG E1 E2 LI DEQB F YNGB GFRB LCRB EPRB EP SS EM -global EN KR KR1 DSS DM FS CAF DT GFR DEQ LCR TEST EST -global DF DF1 DF2 DMP1 DMP2 TDAF CON M N L M1 N1 L1 MNL -global NNO NNS NNT NBA NBS NBT INCO NCON STEP NSTEP NDAMF -global RUN NRUN LCO TIME TTOT PSN ROH YNG EPR EPMAX EPMIN -global MEAN COEV ENEX ENCN ENEL ENGD ENDP ENIN DEN DERIV -global XB YB ZB UBAR VBAR WBAR REACAOX REACAOY REACAOZ -global STRAIN STRESS SEED -% -% SUBROUTINE RMECIN (MX,NX,LX,ST) -% ! ================= -% ! -% ! Esta subrotina é chamada pela subrotina rmec para definir as -% ! propriedades mecânicas das barras internas dos módulos cúbicos. -% ! -% !-------------------------------------------------------------------------- -% PARAMETER (INN=1.2E6,INB=6E6,IRU=6,INCON=10) -% !-------------------------------------------------------------------------- -% ! DEFINIÇÃO DE VARIÁVEIS E GRUPOS COMUNS -% INCLUDE 'COMMON.FOR' -% !-------------------------------------------------------------------------- -% INTEGER I,J,K,NO,B,MX,NX,LX -% INTEGER NOI,NOF,ST -% !-------------------------------------------------------------------------- -% DO 10 K=1,LX -% DO 10 J=1,NX -% DO 10 I=1,MX -% ! -% NO=MNL+(K-1)*M1*N1+(J-1)*M1+I -% NOI=NO -% NOF=NO+ST -% B=NBA+(K-1)*MX*NX+(J-1)*MX+I -% ! -% CALL DEFEP(B,0) -% -% ! -% 10 CONTINUE -% ! -% NBA=NBA+MX*NX*LX -% ! -% RETURN -% END - -% MODIFICAÇÕES RODRIGO -for K = 1:LX - for J = 1:NX - for I = 1:MX - B = NBA + (K - 1) * MX * NX + (J - 1) * MX + I; - E1(B) = ENR(B); % Lógica embutida do DEFEP - end - end - end - NBA = NBA + MX * NX * LX; - ini = 1; -end \ No newline at end of file diff --git a/legacy/WRICON.m b/legacy/WRICON.m deleted file mode 100644 index 392d837..0000000 --- a/legacy/WRICON.m +++ /dev/null @@ -1,117 +0,0 @@ - -function ini=WRICON(fid) -global INT INB U V W U0 V0 W0 BDX BDY BDZ VLX VLY VLZ -global ACX ACY ACZ FRX FRY FRZ FX FY FZ MAS MSS CN ENR -global EDG E1 E2 LI DEQB F YNGB GFRB LCRB EPRB EP SS EM -global EN KR KR1 DSS DM FS CAF DT GFR DEQ LCR TEST EST -global DF DF1 DF2 DMP1 DMP2 TDAF CON M N L M1 N1 L1 MNL -global NNO NNS NNT NBA NBS NBT INCO NCON STEP NSTEP NDAMF -global RUN NRUN LCO TIME TTOT PSN ROH YNG EPR EPMAX EPMIN -global MEAN COEV ENEX ENCN ENEL ENGD ENDP ENIN DEN DERIV -global XB YB ZB UBAR VBAR WBAR REACAOX REACAOY REACAOZ -global STRAIN STRESS SEED -%!-------------------------------------------------------------------------- -%function WRICON(fid) -% WRICON -% ================= -% -% DATA: 22/03/1993 -% AUTOR: IGNACIO ITURRIOZ -% -% Esta subrotina grava dados no arquivo CONNAME. -% - -fprintf(1, 'entro na wricon\n'); - -fprintf(fid, '\n'); -fprintf(fid, ' ********************* DEM ********************* \n'); -fprintf(fid, '\n'); -fprintf(fid, ' Discrete Element Method \n'); -fprintf(fid, '\n'); -fprintf(fid, ' All Rights Reserved - PPGEC / UFRGS \n'); -fprintf(fid, '\n'); -fprintf(fid, ' DATA CONTROL OUTPUT \n'); -fprintf(fid, ' ******************* \n'); -fprintf(fid, '\n'); -fprintf(fid, ' Simulation =======================>%12d\n', RUN); -fprintf(fid, '\n'); - -% Fortran FORMAT (A40,I12) --> left-justified 40-char label + %12d -fprintf(fid, '%-40s%12d\n', ' Test simulated...................... ', TEST); -fprintf(fid, '%-40s%12d\n', ' Truss modules in X-direction........ ', M1); -fprintf(fid, '%-40s%12d\n', ' Truss modules in Y-direction........ ', N1); -fprintf(fid, '%-40s%12d\n', ' Truss modules in Z-direction........ ', L1); -fprintf(fid, '\n'); - -fprintf(fid, '%-40s%12d\n', ' Principal nodes number.............. ', NNO); -fprintf(fid, '%-40s%12d\n', ' Symmetry nodes number............... ', NNS); -fprintf(fid, '%-40s%12d\n', ' Total nodes number.................. ', NNT); -fprintf(fid, '%-40s%12d\n', ' Principal bars number............... ', NBA); -fprintf(fid, '%-40s%12d\n', ' Symmetry bars number................ ', NBS); -fprintf(fid, '%-40s%12d\n', ' Total bars number................... ', NBT); -fprintf(fid, '\n'); - -%-------------------------------------------------------------------------- -% Control node numbers (Fortran DO 10 I=1,INCO) -%-------------------------------------------------------------------------- -for I = 1:INCO - fprintf(fid, '%-40s%12d\n', ' Control node number................. ', NCON(I)); -end - -fprintf(fid, '\n'); -fprintf(fid, '\n'); - -%-------------------------------------------------------------------------- -% FORMAT (A40,E12.6) --> left-justified 40-char label + %12.6E -%-------------------------------------------------------------------------- -fprintf(fid, '%-40s%12.6E\n', ' Initial damping factor.............. ', DF1); -fprintf(fid, '%-40s%12.6E\n', ' Final damping factor................ ', DF2); -fprintf(fid, '%-40s%12.6E\n', ' Time of damping change.............. ', TDAF); -fprintf(fid, '%-40s%12.6E\n', ' Stiffness proportional damping...... ', CON); -fprintf(fid, '\n'); -fprintf(fid, '%-40s%12.6E\n', ' Truss module length................. ', LCO); -fprintf(fid, '%-40s%12.6E\n', ' Time increment...................... ', DT); -fprintf(fid, '%-40s%12.6E\n', ' Total time of integration........... ', TTOT); - -%-------------------------------------------------------------------------- -% Derived quantities -%-------------------------------------------------------------------------- -KRN = LCR / LCO; -DELTA = 9.0 * PSN / (4.0 - 8.0 * PSN); -ALFA = (9.0 + 8.0 * DELTA) / (18.0 + 24.0 * DELTA); -MASTOT = (M1 * LCO * N1 * LCO * L1 * LCO) * ROH; - -fprintf(fid, '\n'); -fprintf(fid, '%-40s%12.6E\n', ' Poissons ratio...................... ', PSN); -fprintf(fid, '%-40s%12.6E\n', ' Mass density........................ ', ROH); -fprintf(fid, '%-40s%12.6E\n', ' Total mass.......................... ', MASTOT); -fprintf(fid, '%-40s%12.6E\n', ' Youngs modulus...................... ', YNG); -fprintf(fid, '%-40s%12.6E\n', ' Element normal stiffness............ ', ENR(1)); -fprintf(fid, '%-40s%12.6E\n', ' Element diagonal stiffness.......... ', EDG(1)); -fprintf(fid, '%-40s%12.6E\n', ' Specific fracture energy............ ', GFR); -fprintf(fid, '%-40s%12.6E\n', ' equivalent d ........ ', DEQ); -fprintf(fid, '%-40s%12.6E\n', ' Proportionality mean strain......... ', EP(1)); -fprintf(fid, '%-40s%12.6E\n', ' Critical value for Lc............... ', LCR); -fprintf(fid, '%-40s%12.6E\n', ' Kr value for normal bars............ ', KRN); -fprintf(fid, '%-40s%12.6E\n', ' Delta coefficient................... ', DELTA); -fprintf(fid, '%-40s%12.6E\n', ' Alfa coefficient.................... ', ALFA); -fprintf(fid, '\n'); -fprintf(fid, '%-40s%12.6E\n', ' Maximum value for ep................ ', EPMAX); -fprintf(fid, '%-40s%12.6E\n', ' Minimum value for ep................ ', EPMIN); -fprintf(fid, '\n'); - -%-------------------------------------------------------------------------- -% General remarks section -%-------------------------------------------------------------------------- -fprintf(fid, '\n'); -fprintf(fid, ' GENERAL REMARKS \n'); -fprintf(fid, ' *************** \n'); -fprintf(fid, '\n'); -fprintf(fid, '%-40s%12.6E\n', ' Mean ep............................. ', MEAN); -fprintf(fid, '%-40s%12.6E\n', ' Coefficient of variation for ep..... ', COEV); -fprintf(fid, '\n'); - -fprintf(fid, '\n'); - -ini=1; - end diff --git a/legacy/WRIDIPO.m b/legacy/WRIDIPO.m deleted file mode 100644 index 13e3acf..0000000 --- a/legacy/WRIDIPO.m +++ /dev/null @@ -1,84 +0,0 @@ - -function ini=WRIDIPO(fid16, fid17) -global INT INB U V W U0 V0 W0 BDX BDY BDZ VLX VLY VLZ -global ACX ACY ACZ FRX FRY FRZ FX FY FZ MAS MSS CN ENR -global EDG E1 E2 LI DEQB F YNGB GFRB LCRB EPRB EP SS EM -global EN KR KR1 DSS DM FS CAF DT GFR DEQ LCR TEST EST -global DF DF1 DF2 DMP1 DMP2 TDAF CON M N L M1 N1 L1 MNL -global NNO NNS NNT NBA NBS NBT INCO NCON STEP NSTEP NDAMF -global RUN NRUN LCO TIME TTOT PSN ROH YNG EPR EPMAX EPMIN -global MEAN COEV ENEX ENCN ENEL ENGD ENDP ENIN DEN DERIV -global XB YB ZB UBAR VBAR WBAR REACAOX REACAOY REACAOZ -global STRAIN STRESS SEED -% ! -% !-------------------------------------------------------------------------- -% !-------------------------------------------------------------------------- -% ! -% SUBROUTINE WRIDIPO -% ! ================== -% ! -% ! DATA: 22/03/1993 -% ! AUTOR: IGNACIO ITURRIOZ -% ! -% ! Esta subrotina grava os resultados nos arquivos DISNAME e POSNAME. -% ! -% !-------------------------------------------------------------------------- -% PARAMETER (INN=1.2E6,INB=6E6,IRU=6,INCON=10) -% !-------------------------------------------------------------------------- -% ! DEFINIÇÃO DE VARIÁVEIS E GRUPOS COMUNS -% INCLUDE 'COMMON.FOR' -% !-------------------------------------------------------------------------- -% ! ADAPTAR PARA CADA EXEMPLO TESTADO -% !-------------------------------------------------------------------------- -% -% IF (TEST.EQ.102) THEN -% ! -% WRITE (17,'(3(E25.12,3X))') TIME, -% &ACX(NCON(1)),ACX(NCON(2)) -% ! -% END IF -% -% -% -% RETURN -% END -% ! -% !-------------------------------------------------------------------------- - - -% WRIDIPO -% ======= -% -% DATA: 22/03/1993 -% AUTOR: IGNACIO ITURRIOZ -% -% Esta subrotina grava os resultados nos arquivos DISNAME e POSNAME. -% -% MATLAB translation using GLOBAL variables instead of COMMON. -% -% Inputs: -% fid16 -> file identifier for LET.DIS (DISNAME) -% fid17 -> file identifier for LET.POS (POSNAME) - -% ------------------------------------------------------------------------- -% Global variables (equivalent to the COMMON block) -% ------------------------------------------------------------------------- - - -% ------------------------------------------------------------------------- -% ADAPT FOR EACH TEST EXAMPLE -% ------------------------------------------------------------------------- -if TEST == 102 - - % Write to LET.POS (unit 17 in Fortran -> fid17) - fprintf(fid17, '%25.12e %25.12e %25.12e\n', ... - TIME, ACX(NCON(1)), ACX(NCON(2))); - -end - - - - - -ini=1; - end diff --git a/legacy/WRIENE.m b/legacy/WRIENE.m deleted file mode 100644 index 46348dd..0000000 --- a/legacy/WRIENE.m +++ /dev/null @@ -1,38 +0,0 @@ - -function ini=WRIENE(fid18) -global INT INB U V W U0 V0 W0 BDX BDY BDZ VLX VLY VLZ -global ACX ACY ACZ FRX FRY FRZ FX FY FZ MAS MSS CN ENR -global EDG E1 E2 LI DEQB F YNGB GFRB LCRB EPRB EP SS EM -global EN KR KR1 DSS DM FS CAF DT GFR DEQ LCR TEST EST -global DF DF1 DF2 DMP1 DMP2 TDAF CON M N L M1 N1 L1 MNL -global NNO NNS NNT NBA NBS NBT INCO NCON STEP NSTEP NDAMF -global RUN NRUN LCO TIME TTOT PSN ROH YNG EPR EPMAX EPMIN -global MEAN COEV ENEX ENCN ENEL ENGD ENDP ENIN DEN DERIV -global XB YB ZB UBAR VBAR WBAR REACAOX REACAOY REACAOZ -global STRAIN STRESS SEED - -% SUBROUTINE WRIENE -% ! ================= -% ! -% ! DATA: 22/03/1993 -% ! AUTOR: IGNACIO ITURRIOZ -% ! -% ! Esta subrotina grava os resultados em ENENAME. -% ! -% !-------------------------------------------------------------------------- -% PARAMETER (INN=1.2E6,INB=6E6,IRU=6,INCON=10) -% !-------------------------------------------------------------------------- -% ! DEFINIÇÃO DE VARIÁVEIS E GRUPOS COMUNS -% INCLUDE 'COMMON.FOR' -% !-------------------------------------------------------------------------- -% ! ENIN = ENCN + ENEL + ENGD + ENDP -% ! DEN = (ENEX - ENIN) -% ! -% WRITE (18,'(7(E25.12,3X))') TIME,ENEX,ENCN,ENEL,ENGD,ENDP,DEN -% ! -% RETURN -% END - fprintf(fid18, '%25.12e %25.12e %25.12e %25.12e %25.12 %25.12e %25.12e\n', ... - TIME, ENEX,ENCN,ENEL,ENGD,ENDP,DEN); -ini=1; - end diff --git a/legacy/ini_DEM3.m b/legacy/ini_DEM3.m deleted file mode 100644 index b0de085..0000000 --- a/legacy/ini_DEM3.m +++ /dev/null @@ -1,221 +0,0 @@ -function ini=ini_DEM3() -%H1 this function put initial values in the global variables -% -global INT INB U V W U0 V0 W0 BDX BDY BDZ VLX VLY VLZ -global ACX ACY ACZ FRX FRY FRZ FX FY FZ MAS MSS CN ENR -global EDG E1 E2 LI DEQB F YNGB GFRB LCRB EPRB EP SS EM -global EN KR KR1 DSS DM FS CAF DT GFR DEQ LCR TEST EST -global DF DF1 DF2 DMP1 DMP2 TDAF CON M N L M1 N1 L1 MNL -global NNO NNS NNT NBA NBS NBT INCO NCON STEP NSTEP NDAMF -global RUN NRUN LCO TIME TTOT PSN ROH YNG EPR EPMAX EPMIN -global MEAN COEV ENEX ENCN ENEL ENGD ENDP ENIN DEN DERIV -global XB YB ZB UBAR VBAR WBAR REACAOX REACAOY REACAOZ -global STRAIN STRESS SEED -% -% Variables setting -INT=168000 -INB=2300000 -U(3,INT)=0.0; % nodal displacement, U=x,V=y,W=z, i-1,i,i+1 time_ step -V(3,INT)=0.0; -W(3,INT)=0.0; -U0(INT)=0.0;% nodal displacements in the initial configuration -V0(INT)=0.0;% -W0(INT)=0.0;% -BDX(INT)=0;% boundary conditions 1=fix, 0=fix -BDY(INT)=0; -BDZ(INT)=0; -VLX(INT)=0.0;% nodal velocities -VLY(INT)=0.0; -VLZ(INT)=0.0; -ACX(INT)=0.0;%nodal acelerations -ACY(INT)=0.0; -ACZ(INT)=0.0; -FRX(INT)=0.0; %Nodal forces in each step -FRY(INT)=0.0; -FRZ(INT)=0.0; -FX(INT)=0.0; %acumulated nodal forces -FY(INT)=0.0; -FZ(INT)=0.0; -MAS(INT)=0.0; % nodal masses with corrections taken into account -MSS(INT)=0.0; -CN(2*INB)=0; -%,ROMP,ROMP_OLD -%! - -%CN(2,INB)=0; %conectivity i, and j of each element -%ENR(INB)=0.0;% normal specific stifness ENR(i)=YNGB(i)*ALPHA*(LI(i))^2 -%EDG(INB)=0.0;% diagonal stifness bar EDG(B)=2.0D00*DELTA*(4.0D00/3.0D00)*ENR(B)/DSQRT(3.0D00) -%E1(INB)=0.0;% Normal stifness in compression taking into account if the bar is in the border or is a internal bar -%E2(INB)=0.0;% Normal stifness in tension -%LI(INB)=0.0; % cubic module length -% -%DEQB(INB)=0.0;%equivalent distance for each element -%F(INB)=0.0;%element force -%YNGB(INB)=0.0; %Young modules in each bar -%GFRB(INB)=0.0; %toughness in each bar -%LCRB(INB)=0.0; %LCR=DEQ*2.0D00*CAF/ALFA -%EPRB(INB)=0.0;% EPRB(i)=DSQRT(GFRB(i)/(YNGB(i)*DEQB(i))) -%EP(INB)=0.0;%the same of EPRB ??? %%%%%%%% -%SS(INB)=0.0; %the strain in the bar the last step -%EM(INB)=0.0;% te same that SS ?????? %%%%%%%% -%EN(2,INB)=0.0; %elastic energy in each bar computed in each step, 1 undamage, 2 damage. this information it isnt used -%KR(INB)=0.0; %er(i)= kr(i)* ep(i) -%KR1(INB)=0.0;%%%% it is not used -%DSS(INB)=0.0; %the derivative of the strain STRRT in each step -%DM(INB)=true; % damage index if DM=true bar is undamage -%FS(INB)=true; %failure index if DM= true bar is unfail, with partial damage or not. -%DM1(INB)=true; -%FS1(INB)=true; -%TR(INB)=0.0; -%ansysColor=0 -% -CAF=0.1385; %failure area of each normal bars An(i)=CAF*LI(i) -%CUT=0.0; -DT=0.0; % time increment -GFR=0.0; %tougnhess , mean value -DEQ=0.0;% critical distance mean value -LCR=0.0; % critical length -%SEED=0.0; -TEST=0; %number of test to stablish characteristic of each specific problem -EST=0; % establish differetn type of damping |EstEST=0 ==> Amortecimento padrão (C=DF*M) -%! EST=1 ==> EST=0 + um amortecimento introduzido -%! na equação constitutiva com CON -%! EST=2 ==> EST=0, mas o coefic. de amortecimento -%! DF é multiplicado pelo índice de dano -DF=0.0; -DF1=0.0; %input damping value -DF2=0.0; -DMP1=0.0; %%% % DMP1=(1.0D00-DF11*DT/2.0D00)%%%%must be global??? -DMP2=0.0; %%%%must be global??? -TDAF=0.0; %time in which the damping 1 change to damping 2 -CON=0.0; % values that introduce damping proportional to the stifness -%Label=0; -M=0; %number of modules Mx, N(y), L(z) , -N=0; -L=0; -M1=0; -N1=0; -L1=0; -MNL=0;% M*N*L -NNO=0;% NNO=MNL+M1*N1*L1 %%%%%%%%%% -NNS=0;% %%%%%%%%% -NNT=0;% total number of nodes -NBA=0;%partial values %%%%%%% -NBS=0;%partial values %%%%%%%% -NBT=0; % total number of elements -INCO(10)=0;%the specific number of node indicated as input %%%%%%% -NCON(10)=0;%Number of nodes that could be identified -% OU2=0; % the number of output for print the results %%%%%% -% OU3=0; -% OU4=0; -% OU5=0; -% OU6=0; -% OU7=0; -% OU8=0; -% OU9=0; -% PR3=0; % numer os step to skip when th result are save -% PR4=0; -% PR5=0; -% PR67=0; -% PR8=0; -% PR9=0; -STEP=0;% current number of step -NSTEP=0;% tital number of steps -NDAMF=0;% step number correlated with TDAF -RUN=0; %current number of simulation -NRUN=0; % total number of simulations -LCO=0.0; %lenth of the cubic module -TIME=0.0; % current time -TTOT=0.0; % total time of the simulation -PSN=0.0;% poisson coeficient -ROH=0.0; % density -YNG=0.0; %mean young modulus -EPR=0.0; % -EPMAX=0.0; % maximum value of the critical strain -EPMIN=0.0; %minimum value of the critical strain -MEAN=0.0 ; %mean value of critical strain -COEV=0.0 ; % variation coeficient of critical strain -ENEX=0.0 ;% External energy -ENCN=0.0;% kinetic energy -ENEL=0.0;% Elastic energy -ENGD=0.0;% damage energy -ENDP=0.0;% damping energy -ENIN=0.0;% internal energy -DEN=0.0;% ENEX-ENIN -DERIV=0.0;% derivative of the ENGD -XB(INB)=0.0; %baricentric coordinates fo the elements -YB(INB)=0.0; -ZB(INB)=0.0; -UBAR(INB)=0.0;%displacement in the baricentric of each bar -VBAR(INB)=0.0; -WBAR(INB)=0.0; - -REACAOX=0.0;% summation of the reaction in x diretion -REACAOY=0.0; -REACAOZ=0.0; -STRAIN=0.0; -STRESS=0.0; -SEED=0; %seed number to generate a perturbed mesh -%X -%Y -%Z -% ,aaa -% ,ReaV -% ,vmax -% ,tt1 -% ,vmax2 -% ,tt2 -% VF1 -% ,VF2 -% ,VF3 -% ,vmax3 -% ,tt3 -% ,VF4 -% ,vmax4 -% ,vmax5 -% ,tt5 -% ,VF6 -% ,vmax6 -% ,tt6 -% ,dmax -% ,dmax2 - - % NK1 - % ,NK2 - % ,NK3 -% D2,PI,K1,K2,K3,DK1,DK2,DK3 -% PHI1,PHI2,PHI3,PHI4,AN - % CVROH,CVYNG,CVGFR,CORRCAF - %TENNORMZ,TENTANGX - % RKX,RKZ,VF -%FOR1 -%STR1 -%FOR2 -%STR2 -%FOR3 -%STR3 -%FOR4 -%STR4 -%ROHN - % BTA,GMA,IBT - % LCORX,LCORY,LCORZ,NPTX,NPTY,NPTZ,NPTOTAL - - % ,IPT - % MPJ,NPJ,LPJ,MPI,NPI,LPI - % IPT1,IPT2,IPT3,IPT4,IPT5,IPT6,IPT7,IPT8,IPT9 - % MP2,NP2,LP2,PHI - % PMI,PNI,PLI,PHIV - %xc,yc,vfarea,vfareal,time1 - %neib,iicont - % krs,epp,constB - % krsc,E2C,EMC - %g51589,gg51589,g89116,gg89116,ggg89116,giv89116 - % DESELX,DESELXMEDIO,SOMADESX,DESELY,DESELYMEDIO, & - %SOMADESY - -ini=1; -end - - - - diff --git a/legacy/main1.m b/legacy/main1.m deleted file mode 100644 index baf28b1..0000000 --- a/legacy/main1.m +++ /dev/null @@ -1,529 +0,0 @@ -% MAIN1 Legacy LDEM driver (frozen reference implementation). -% Run from the folder that contains DATA0.DAT, LET.AN1 and the random -% field file, with legacy/ on the MATLAB path. Do not modify the numerics: -% the regression tests in tests/regression compare against this code. -clear all -clc -global INT INB U V W U0 V0 W0 BDX BDY BDZ VLX VLY VLZ -global ACX ACY ACZ FRX FRY FRZ FX FY FZ MAS MSS CN ENR -global EDG E1 E2 LI DEQB F YNGB GFRB LCRB EPRB EP SS EM -global EN KR KR1 DSS DM FS CAF DT GFR DEQ LCR TEST EST -global DF DF1 DF2 DMP1 DMP2 TDAF CON M N L M1 N1 L1 MNL -global NNO NNS NNT NBA NBS NBT INCO NCON STEP NSTEP NDAMF -global RUN NRUN LCO TIME TTOT PSN ROH YNG EPR EPMAX EPMIN -global MEAN COEV ENEX ENCN ENEL ENGD ENDP ENIN DEN DERIV -global XB YB ZB UBAR VBAR WBAR REACAOX REACAOY REACAOZ -global STRAIN STRESS SEED -global OU2 OU3 OU4 OU5 OU6 OU7 OU8 OU9 - -% -ini=ini_DEM3() %an initialization of the main variables was done -% -DATNAME=' '; -CONNAME=' '; -ANSNAME=' '; -RESNAME=' '; -DISNAME=' '; -POSNAME=' '; -ENENAME=' '; -%ARMANS(1000)=' '; -cont1=0; -cont2=0; -cont3=0; -cont4=0; -cont5=0; -cont6=0; -%counter of the linked the file writing -PR3=1; %Ansys File -PR67=1; %DIS and POS files -PR8=1; %ENE file -PR9=1; % SIM01 file inside CALRES -% - % CHARACTER*14 DATNAME,CONNAME - % CHARACTER*14 ANSNAME,RESNAME,DISNAME - % CHARACTER*14 POSNAME,ENENAME - % CHARACTER*14 ARMANS(10000000) - % integer cont1,cont2,cont3,cont4,cont5,cont6,B,bb -% -% -% ! -% OPEN (UNIT=10,ACCESS='SEQUENTIAL',FILE='DATA0.DAT',& -% & STATUS='OLD') -% -% ! -% ! READAT -----> L os dados que esto no arquivo DATA0.DAT - % CALL READAT0 - ini=read_dat0() % read the input data saved in DATA0.DAT - 'ini=read_dat0()' - % - % ! -% Close (10) -% ! -% !-------------------------------------------------------------------------- -% ! PREPARAO DAS VARIVEIS E CHAMAMENTO DAS SUBROTINAS PRELIMINARES -% !-------------------------------------------------------------------------- -% ! -% -% ! PREPVAR ----> setting of initial parameters -% CALL PREPVAR - ini=prepvar() %setting of initial parameters -'ini=prepvar()' - - % ! -% ! COORD ------> Gera coordenadas de um prisma -% CALL COORD -ini=COORD() % Build the nodes coordinate of prism with MxNxL modules -'ini=COORD()' - -% ! -% -% -% ! IMPERF -----> Impe uma aleatoriedade (imperfeio) s coordenadas -% CALL IMPERF -ini=IMPERF()% ! -'ini=IMPERF()' -% ! BOUND ------> Determina as condies de contorno da estrutura -% CALL BOUND -ini=BOUND()% ! -'ini=BOUND()' -% ! -% ! NODMASS ----> Atribui um valor de massa a cada n da estrutura -% CALL NODMASS -ini=NODMASS()% ! -'ini=NODMASS()' -% ! -% ! CONECTI ----> Gera conectividades das barras -% CALL CONECTI -ini=CONECTI()% ! -'ini=CONECTI()' -% ! -% ! CALAUX -----> Clculos auxiliares e determinao compr. cada barra -% CALL CALAUX -ini=CALAUX()% ! - -'ini=CALAUX()' -% -% -% OPEN (UNIT=70,ACCESS='SEQUENTIAL',FILE='BARI.txt',& -% & STATUS='UNKNOWN') -% -% DO I=1, NBT -% WRITE(70,'(I7,3X,3(E25.12,3X))') I,XB(I),YB(I),ZB(I) -% -% ENDDO -% -% CLOSE(70) -% Open the file for writing ('w' creates/overwrites, equivalent to STATUS='UNKNOWN') -fid = fopen('BARI.txt', 'w'); - -% Loop equivalent to DO I=1, NBT -for I = 1:NBT - % fprintf replaces WRITE with formatted output - % Format spec: %7d (I7), 3 spaces (3X), 3 floating-point values in scientific notation (E25.12) - fprintf(fid, '%7d %25.12E %25.12E %25.12E\n', I, XB(I), YB(I), ZB(I)); -end - -% Close the file -fclose(fid); -'The file BARI.txt was made' - - - -% ! -% ! NAYFES0 ---->BAR STIFNESS DETERMINATION -% CALL NAYFES0 -ini=NAYFES0() -'ini=NAYFES0()' -% ! RMEC ------->BAR STIFNESS DETERMINATION -% CALL RMEC -ini=RMEC() -'ini=RMEC()' - - -% --- Introduce random field into EP(B) ---------------------------------- -fid = fopen('arquivo_3lc_rnao_cv05', 'r'); -if fid == -1 - error('Console1: cannot open arquivo_3lc_rnao_cv05'); -% !arquivo_lc3l_rnao_cv100.txt -% !arquivo_3lc_rnao_cv05.txt -end -for I = 1:NBT - Phitemp = fscanf(fid, '%f', 1); - EP(I) = Phitemp * EP(I); - EM(I) = EP(I); % very important!!! -end -fprintf('%g\n', EP(1)); -fclose(fid); - -ini=CALCOEV() % computation of Mean value and variation -% coeficient of EP -'ini=CALCOEV()' -% ini= NEIBOUR() !WE NEED THIS SBROUTINE TO COMPUTE BARS -% THAT ARRIVING IN THE NODS i AND J OF THE b BAR -% 'ini=CALCOEV()' ( We need to implement) -% -% !-------------------------------------------------------------------------- -% ! ABRINDO OS ARQUIVOS DE SADA -% !-------------------------------------------------------------------------- -fid_CON = -1; fid_AN1 = -1; fid_RES = -1; -fid_DIS = -1; fid_POS = -1; fid_ENE = -1; -fid_Lei = -1; fid_EnB = -1; - -if OU2 > 0, fid_CON = fopen('LET.CON', 'w'); end -if OU3 > 0, fid_AN1 = fopen('LET.AN1', 'r'); end -if OU5 > 0, fid_RES = fopen('LET.RES', 'w'); end -if OU6 > 0, fid_DIS = fopen('LET.DIS', 'w'); end -if OU7 > 0, fid_POS = fopen('LET.POS', 'w'); end -if OU8 > 0, fid_ENE = fopen('LET.ENE', 'w'); end -if OU9 > 0, fid_Lei = fopen('Lei_Barra.TXT', 'w'); end -if OU9 > 0, fid_EnB = fopen('Energia_Barra.TXT','w'); end -% ! -% IF (OU2.GT.0)& -% & OPEN (UNIT=12,ACCESS='SEQUENTIAL',FILE='LET.CON',& -% & STATUS='UNKNOWN') -% ! -% IF (OU3.GT.0)& -% & OPEN (UNIT=13,ACCESS='SEQUENTIAL',FILE='LET.AN1',& -% & STATUS='UNKNOWN') -% -% IF (OU5.GT.0)& -% & OPEN (UNIT=15,ACCESS='SEQUENTIAL',FILE='LET.RES',& -% & STATUS='UNKNOWN') -% ! -% IF (OU6.GT.0)& -% & OPEN (UNIT=16,ACCESS='SEQUENTIAL',FILE='LET.DIS',& -% & STATUS='UNKNOWN') -% ! -% IF (OU7.GT.0)& -% & OPEN (UNIT=17,ACCESS='SEQUENTIAL',FILE='LET.POS',& -% & STATUS='UNKNOWN') -% ! -% IF (OU8.GT.0)& -% & OPEN (UNIT=18,ACCESS='SEQUENTIAL',FILE='LET.ENE',& -% & STATUS='UNKNOWN') -% -% ! -% IF (OU9.GT.0)& -% & OPEN (UNIT=19,ACCESS='SEQUENTIAL',FILE='Lei_Barra.TXT',& -% & STATUS='UNKNOWN') -% -% ! -% IF (OU9.GT.0)& -% & OPEN (UNIT=20,ACCESS='SEQUENTIAL',FILE='Energia_Barra.TXT',& -% & STATUS='UNKNOWN') -% !-------------------------------------------------------------------------- -% IF (OU2.GT.0) THEN -% ! WRICON -----> Gravao de informao de entrada no arquivo CONNAME -% CALL WRICON -% ! We close(2) in the end of the Main program -% END IF -% !-------------------------------------------------------------------------- -% ! LEITURA NOMES DE ARQUIVOS DO ANSYS -% !-------------------------------------------------------------------------- -% -% ! -% IF (OU3.GT.0) THEN -% DO 30 III=1,(NSTEP/OU3)+1 -% READ (13,*) ARMANS(III) -% 30 CONTINUE -% CLOSE (13) -% ! -% -% !-------------------------------------------------------------------------- -% ! GRAVAO DO PRIMEIRO ARQUIVO DO ANSYS -% !-------------------------------------------------------------------------- -% I3=1 -% OPEN (UNIT=13,ACCESS='SEQUENTIAL',FILE=ARMANS(I3),& -% & STATUS='UNKNOWN') -% WRITE (13,*) '!ARQUIVO NO TEMPO =',TIME -% CALL ANSYS (13,CONT1,CONT2,CONT3,CONT4,CONT5,CONT6) -% CLOSE (13) -% END IF - - -% ------------------------------------------------------------------------- -if OU2 > 0 - % WRICON -----> writes input info to CONNAME - ini=WRICON(fid_CON); % stream passed in (or use global fid) -'ini=WRICON' -end - -% ------------------------------------------------------------------------- -% READ FILENAMES OF ANSYS FILES -% ------------------------------------------------------------------------- -I3 = 1; -if OU3 > 0 -ARMANS = cell(floor(NSTEP/OU3) + 1, 1); -for III = 1:floor(NSTEP/OU3) + 1 -ARMANS{III} = strtrim(fgetl(fid_AN1)); % l uma linha e remove espaos - end - fclose(fid_AN1); - - - - % --- Write first ANSYS file ----------------------------------------- - fid_AN1 = fopen(ARMANS{I3}, 'w'); - fprintf(fid_AN1, '!ARQUIVO NO TEMPO = %g\n', TIME); - - - - ini= ANSYS(fid_AN1, cont1, cont2, cont3, cont4, cont5, cont6); - 'ini=ANSYS' - fclose(fid_AN1); -end - -% -% !-------------------------------------------------------------------------- -% ! CONCLUIU-SE A MONTAGEM DO MODELO. INICIA-SE A INTEGRAO PASSO A PASSO -% !-------------------------------------------------------------------------- -% ! LOOP PRINCIPAL DE INTEGRAO -% !-------------------------------------------------------------------------- -% -% -% -% WRITE (*,*) -% WRITE (*,*) ' *** PERFORMING THE INTEGRATION STEP BY STEP ** ' -% WRITE (*,*) -% ! -% STEPP=1 -% ! -% DO 60 STEP = STEPP,NSTEP -% ! -% !-------------------------------------------------------------------------- -% ! Escreve uma informao de controle na tela em cada passo de integrao -% !-------------------------------------------------------------------------- -% WRITE (*,40) STEP -% 40 FORMAT (' STEP ======================> ',I7,' / ',I2) -% -% ! -% !-------------------------------------------------------------------------- -% ! Controle de mudana de amortecimento -% !-------------------------------------------------------------------------- -% IF (STEP.EQ.NDAMF) THEN -% DF1=DF2 -% DMP1=1.0D00-DF2*DT/2.0D00 -% DMP2=1.0D00+DF2*DT/2.0D00 -% END IF -% ! -% !-------------------------------------------------------------------------- -% ! Incremento do tempo -% !-------------------------------------------------------------------------- -% TIME=TIME+DT -% WRITE (*,50) TIME -% 50 FORMAT (' TIME ======================> ',F12.8) -%------------------------------------------------------------------------- -% ! Avaliao das foras e determinao da nova configurao -% !-------------------------------------------------------------------------- -% ! CALOAD -----> Clculo das cargas sobre os ns -% CALL CALOAD -% write(*,*) 'caload' -% ! -% ! Especifica-se a carga em cada tempo e calcula-se a energia externa -% ! fornecida ao sistema. Em funo do exemplo tem-se que modificar esta -% ! subrotina. -% ! -% !-------------------------------------------------------------------------- -% ! CABAR ------> compute de nodal forces in the structure, in CABAR we have a loop over all the bars and -% ! we call the constit subroutine to compute the forces in each bars -% CALL CABAR -% write(*,*) 'cabar' -% ! -% !-------------------------------------------------------------------------- -% ! IGN012 -----> Clculo das coordenadas no tempo TIME aplicando -% ! diferenas finitas centrais na equao do movimento -% CALL IGN012 -% ! Nesta subrotina realiza-se a integrao via mtodo das diferenas -% ! finitas centrais. Tem-se um loop sobre os ns. Entra-se com as foras -% ! calculadas em CABAR e com a configurao do sistema nos dois tempos -% ! anteriores e determina-se a configurao no tempo novo. -% ! -%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% - -% ------------------------------------------------------------------------- -% MODEL ASSEMBLY COMPLETE. START STEP-BY-STEP INTEGRATION -% ------------------------------------------------------------------------- -fprintf('\n *** PERFORMING THE INTEGRATION STEP BY STEP ** \n\n'); - -STEPP = 1; - -for STEP = STEPP:NSTEP - - fprintf(' STEP ======================> %7d / %2d\n', STEP, 0); - - % --------------------------------------------------------------------- - % Damping change control - % --------------------------------------------------------------------- - if STEP == NDAMF - DF1 = DF2; - DMP1 = 1.0 - DF2 * DT / 2.0; - DMP2 = 1.0 + DF2 * DT / 2.0; - end - - % --------------------------------------------------------------------- - % Time increment - % --------------------------------------------------------------------- - TIME = TIME + DT; - fprintf(' TIME ======================> %12.8f\n', TIME); - fprintf('\n'); - % --------------------------------------------------------------------- - % Evaluate forces and determine new configuration - % --------------------------------------------------------------------- - ini=CALOAD(); - 'ini=CALOAD()' - - ini=CABAR(fid_Lei); - 'ini=CABAR()' - - ini=IGN012(); % central finite differences integration - 'ini=IGN012()' -% !-------------------------------------------------------------------------- -% ! Gerao dos arquivos de sada -% !-------------------------------------------------------------------------- -% ! SADA - VISUALIZAO NO ANSYS -% !-------------------------------------------------------------------------- -% IF (PR3.EQ.OU3) THEN -% I3=I3+1 -% PR3=1 -% OPEN (UNIT=11,ACCESS='SEQUENTIAL',FILE=ARMANS(I3), & -% & STATUS='UNKNOWN') -% WRITE (11,*) '!ARQUIVO NO TEMPO =',TIME -% CALL ANSYS (11,CONT1,CONT2,CONT3,CONT4,CONT5,CONT6) -% CLOSE (11) -% ELSE -% PR3=PR3+1 -% END IF -% ! -% !-------------------------------------------------------------------------- -% ! SADA - REAES NODAIS -% !-------------------------------------------------------------------------- -% ! write(*,*) 'antes de calres' -% ! CALRES -----> Clculo de resultados que sero gravados em RESNAME -% CALL CALRES -% ! write(*,*) 'calres' -% ! -% !-------------------------------------------------------------------------- -% ! SADA - CONTROLE DE DESLOCAMENTOS, VELOCIDADES E ACELERAES -% !-------------------------------------------------------------------------- -% ! -% IF (PR67.EQ.OU6) THEN -% CALL WRIDIPO -% !! Esta subrotina grava os arquivos *.dis e *.pos que tem os valores dos -% ! deslocamentos, velocidades e aceleraes nos ns de controle. -% ! -% PR67=1 -% ELSE -% PR67=PR67+1 -% END IF -% !-------------------------------------------------------------------------- -% ! SADA - AVALIAO DA ENERGIA -% !-------------------------------------------------------------------------- -% ! -% ! ENERG2 -----> Clculo das energias que sero gravadas em ENENAME -% CALL ENERG2 -% ! Esta subrotina calcula em cada tempo as energias que esto se -% ! transformando no processo. -% ! -% IF (PR8.EQ.OU8) THEN -% CALL WRIENE -% ! Esta subrotina grava o arquivo *.ene que tem os valores das energias. -% ! -% PR8=1 -% ELSE -% PR8=PR8+1 -% END IF -% -% ! -% !-------------------------------------------------------------------------- -% 60 CONTINUE -% !-------------------------------------------------------------------------- -% ! -% IF (RUN.EQ.NRUN) GO TO 70 -% ! -% IF (OU5.GT.0) CLOSE (5) -% IF (OU6.GT.0) CLOSE (6) -% IF (OU7.GT.0) CLOSE (7) -% IF (OU8.GT.0) CLOSE (8) -% ! -% ! -% 70 CONTINUE -% ! -% -% WRITE (*,*) -% WRITE (*,*) ' ****************** THE END ******************* ' -% WRITE (*,*) -% -% close(22) -% close(2) -% end program Console1 - % --------------------------------------------------------------------- - % Generate output files - % --------------------------------------------------------------------- - - % Output - ANSYS visualisation - if PR3 == OU3 - I3 = I3 + 1; - PR3 = 1; - % FIX: ARMANS is a cell array (braces) and ANSYS returns only a - % status flag; the bar counters are reset inside ANSYS. - fid11 = fopen(ARMANS{I3}, 'w'); - fprintf(fid11, '!ARQUIVO NO TEMPO = %g\n', TIME); - ini = ANSYS(fid11, cont1, cont2, cont3, cont4, cont5, cont6); - 'ini=ANSYS()' - fclose(fid11); - else - PR3 = PR3 + 1; - end - - - % --------------------------------------------------------------------- - % Output - control of displacements, velocities and accelerations - % --------------------------------------------------------------------- - if PR67 == OU6 - % Output - nodal reactions - % CALRES -----> Compute results to be written to RESNAME - ini=CALRES(); - 'ini=CALRES()' - - ini=WRIDIPO(fid_DIS, fid_POS); - 'ini=WRIDIPO' - PR67 = 1; - else - PR67 = PR67 + 1; - end - - % --------------------------------------------------------------------- - % Output - energy evaluation - % --------------------------------------------------------------------- - % ENERG2 -----> Compute energies to be written to ENENAME - ini=ENERG2(fid_EnB); - 'ini=ENERG2()' - if PR8 == OU8 - ini=WRIENE(fid_ENE); - 'ini=WRIENE' - - PR8 = 1; - else - PR8 = PR8 + 1; - end - -end -% ------------------------------------------------------------------------- - -% 70 CONTINUE - -fprintf('\n'); -fprintf(' ****************** THE END ******************* \n'); -fprintf('\n'); - -% FIX: close every output file that was opened (the original code -% referenced undefined identifiers fid12/fid15/fid19/fid20). -for fidToClose = [fid_CON, fid_RES, fid_DIS, fid_POS, fid_ENE, fid_Lei, fid_EnB] - if fidToClose >= 3 && ~isempty(fopen(fidToClose)) - fclose(fidToClose); - end -end - -% End of program Console1 - - - diff --git a/legacy/prepvar.m b/legacy/prepvar.m deleted file mode 100644 index 799c967..0000000 --- a/legacy/prepvar.m +++ /dev/null @@ -1,38 +0,0 @@ - -function ini=prepvar() -% PREPVAR Inicializa variáveis de tempo, energia e dimensões derivadas do modelo. -global INT INB U V W U0 V0 W0 BDX BDY BDZ VLX VLY VLZ -global ACX ACY ACZ FRX FRY FRZ FX FY FZ MAS MSS CN ENR -global EDG E1 E2 LI DEQB F YNGB GFRB LCRB EPRB EP SS EM -global EN KR KR1 DSS DM FS CAF DT GFR DEQ LCR TEST EST -global DF DF1 DF2 DMP1 DMP2 TDAF CON M N L M1 N1 L1 MNL -global NNO NNS NNT NBA NBS NBT INCO NCON STEP NSTEP NDAMF -global RUN NRUN LCO TIME TTOT PSN ROH YNG EPR EPMAX EPMIN -global MEAN COEV ENEX ENCN ENEL ENGD ENDP ENIN DEN DERIV -global XB YB ZB UBAR VBAR WBAR REACAOX REACAOY REACAOZ -global STRAIN STRESS SEED -%--------------------------------------------------- - TIME=0.0D00; - ENEX=0.0D00; - ENIN=0.0D00; - ENCN=0.0D00; - ENDP=0.0D00; - ENGD=0.0D00; - DERIV=0.0D00; - EPMAX=0.0D00; - EPMIN=9.9D99; -% - M1=M-1; - N1=N-1; - L1=L-1; - MNL=M*N*L; -% - DMP1=1.0D00-DF1*DT/2.0D00; - DMP2=1.0D00+DF1*DT/2.0D00; - NSTEP=int32(TTOT/DT); - NDAMF=int32(TDAF/DT); - CAF=0.1385D00; - - % - ini=1; - end diff --git a/legacy/read_dat0.m b/legacy/read_dat0.m deleted file mode 100644 index 9a89703..0000000 --- a/legacy/read_dat0.m +++ /dev/null @@ -1,132 +0,0 @@ - -function ini= read_dat0() -% READ_DAT0 Lê os dados de entrada dos arquivos DATNAME(I). -global INT INB U V W U0 V0 W0 BDX BDY BDZ VLX VLY VLZ -global ACX ACY ACZ FRX FRY FRZ FX FY FZ MAS MSS CN ENR -global EDG E1 E2 LI DEQB F YNGB GFRB LCRB EPRB EP SS EM -global EN KR KR1 DSS DM FS CAF DT GFR DEQ LCR TEST EST -global DF DF1 DF2 DMP1 DMP2 TDAF CON M N L M1 N1 L1 MNL -global NNO NNS NNT NBA NBS NBT INCO NCON STEP NSTEP NDAMF -global RUN NRUN LCO TIME TTOT PSN ROH YNG EPR EPMAX EPMIN -global MEAN COEV ENEX ENCN ENEL ENGD ENDP ENIN DEN DERIV -global XB YB ZB UBAR VBAR WBAR REACAOX REACAOY REACAOZ -global STRAIN STRESS SEED C -global OU2 OU3 OU4 OU5 OU6 OU7 OU8 OU9 - -% ! DATA: 27/04/2024 -% ! AUTOR: IGNACIO ITURRIOZ -% ! -% ! Esta subrotina lê os dados de entrada dos arquivos DATNAME(I). -% ! -% !-------------------------------------------------------------------------- -% ! VARIÁVEIS LIDAS DO ARQUIVO DE ENTRADA DATNAME(I) -% !-------------------------------------------------------------------------- -% ! -% ! TEST = (INTEGER) NÚMERO DO TESTE A SER REALIZADO -% ! SEED= (INT) SEMENTE DE GERACAO DE NUMEROS ALEATORIOS -% ! -% ! LCo = (REAL) COMPRIMENTO DA ARESTA DO MÓDULO CÚBICO SEM DEFORMAR -% ! -% ! M, N, L = (INTEGER) DIMENSÕES MODULARES DAS ARESTAS DO PRISMA. -% ! REPRESENTAM O NÚMERO DE NÓS PRESENTES NAS ARESTAS DO PRISMA -% ! PARALELAS AOS EIXOS CARTESIANOS X,Y,Z, RESPECTIVAMENTE. -% ! -% ! DF1, DF2 = (REAL) COEFICIENTES DE AMORTECIMENTO PROPORCIONAL À MASSA -% ! INICIAL E FINAL M(X)''+DF(X)'=FX -% ! -% ! TDAF = (REAL) TEMPO DE TROCA DO AMORTECIMENTO DF1 PARA DF2 -% ! -% ! CON = (REAL) AMORTECIMENTO CONSIDERADO DENTRO DA EQUAÇÃO CONSTITUTIVA -% ! (EST=1) -% ! -% ! DT = (REAL) INTERVALO DE INTEGRAÇÃO. DT<=0.6*LCO/C0, SENDO C0=(E/RO)**.5 -% ! -% ! TTOT = (REAL) TEMPO TOTAL DE INTEGRAÇÃO -% ! -% ! INCO = (INTEGER) NÚMERO DE PONTOS DE CONTROLE A CONSIDERAR (INCO<=INCON) -% ! -% ! NCON(I) = (INTEGER) I-ÉSIMO PONTO DE CONTROLE A CONSIDERAR (I=1,INCO) -% ! -% ! OU2, OU3, OU4, OU5, OU6, OU7, OU8, OU9 = (INTEGER) CONTROLE DA EDIÇÃO DE -% ! ARQUIVOS DE SAÍDA -% ! OU2,OU3,OU4,OU5,OU6,OU7,OU8,OU9 = 0, ARQUIVO NÃO SE IMPRIME -% ! OU2 = n, ARQUIVO SE IMPRIME -% ! OU3 = n, SE IMPRIME 1 ARQUIVO NO TEMPO ZERO E ARQUIVOS A CADA n -% ! PASSOS DE INTEGRAÇÃO -% ! OU4 = n, SE IMPRIMEM ARQUIVOS A CADA n PASSOS DE INTEGRAÇÃO -% ! OU5,OU6,OU7,OU8,OU9 = n, SE IMPRIMEM VALORES A CADA n PASSOS DE -% ! INTEGRAÇÃO -% ! -% ! PSN = (REAL) COEFICIENTE DE POISSON -% ! -% ! ROH = (REAL) MASSA ESPECÍFICA -% ! -% ! YNG = (REAL) MÓDULO DE YOUNG -% ! -% ! GFR = (REAL) ENERGIA ESPECÍFICA DE FRATURA -% ! -% ! DEQ= (REAL) Equivalence Distance -% ! -% !-------------------------------------------------------------------------- -% ! FORMATO DO ARQUIVO DE ENTRADA DATNAME(I) -% !-------------------------------------------------------------------------- -% ! TEST,LCO,M,N,L, -% ! DF1,DF2,TDAF,CON, -% ! DT,TTOT, -% ! INCO,NCON(1),NCON(2),...,NCON(INCO), -% ! OU2,OU3,OU4,OU5,OU6,OU7,OU8,OU9, -% ! PSN,ROH,YNG,GFR,DEQ -% ! -%C = textscan(fileID,formatSpec) -[C]=textread('DATA0.DAT','%s %*[^\n]') -% we enter de data in char format -TEST=str2double(C(1)) -SEED=str2double(C(2))% SEED to create a pertubed mesh ' -LCO=str2double(C(3)) %cubic module length -M= str2double(C(4)) -N= str2double(C(5)) -L= str2double(C(6)) -DF1 =str2double(C(7)) -DF2 =str2double(C(8)) - TDAF=str2double(C(9)) - CON =str2double(C(10)) - DT =str2double(C(11)) - TTOT =str2double(C(12)) -INCO= str2double(C(13)) -for i=1:INCO -NCON(i)= str2double(C(13+i)) -end -OU2 =str2double(C(14+INCO));% OU2 -OU3 =str2double(C(15+INCO));% OU3 -OU4 =str2double(C(16+INCO));% OU4 -OU5 =str2double(C(17+INCO));% OU5 -OU6 =str2double(C(18+INCO));% OU6 -OU7 =str2double(C(19+INCO));% OU7 -OU8 =str2double(C(20+INCO));% OU8 -OU9 =str2double(C(21+INCO));% OU9 -PSN =str2double(C(22+INCO)) -ROH =str2double(C(23+INCO)) -YNG =str2double(C(24+INCO)) -GFR=str2double(C(25+INCO)) -DEQ =str2double(C(26+INCO)) - - % fid = fopen('dados.txt', 'r'); -% A = fscanf(fid, '%f'); % Lê todos os números -% fclose(fid); -% READ (10,*)TEST,TEXTO,SEED,TEXTO,LCO,TEXTO,M,TEXTO,N,TEXTO,L,TEXTO -% READ (10,*) DF1,TEXTO,DF2,TEXTO,TDAF,TEXTO,CON,TEXTO -% READ (10,*) DT,TEXTO,TTOT,TEXTO,INCO,TEXTO -% ! -% DO 10 I=1,INCO -% READ (10,*) NCON(I),TEXTO -% 10 CONTINUE -% ! -% READ (10,*) OU2,TEXTO,OU3,TEXTO,OU4,TEXTO,OU5,TEXTO -% READ (10,*) OU6,TEXTO,OU7,TEXTO,OU8,TEXTO,OU9,TEXTO -% READ (10,*) PSN,TEXTO,ROH,TEXTO,YNG,TEXTO -% READ (10,*) GFR,TEXTO,DEQ,TEXTO -% RETURN -% END -% ! - ini=1; - end diff --git a/sandbox/Energy_balance.m b/sandbox/Energy_balance.m deleted file mode 100644 index 21b89d8..0000000 --- a/sandbox/Energy_balance.m +++ /dev/null @@ -1,14 +0,0 @@ -clear all -close all -clc - -[Tempo,enex,Cinetica,Elastica,Dano,amort,Den]=textread('LET.ENE','%f %f %f %f %f %f %f'); - -figure(1) -plot(Tempo,Cinetica,'b.-',Tempo,Elastica,'m.-',Tempo,Dano,'r.-') -title(' ','FontName','Times New Roman Negrito','FontSize',16) -xlabel('Time [s]','FontName','Times New Roman','FontSize',18,'Rotation',0) -ylabel('Energy [Nm]','FontName','Times New Roman','FontSize',18,'Rotation',90) -legend('Kinetic','Elástic','Dissipate') -grid on - diff --git a/sandbox/Teste_combinado.m b/sandbox/Teste_combinado.m deleted file mode 100644 index c32b46f..0000000 --- a/sandbox/Teste_combinado.m +++ /dev/null @@ -1,239 +0,0 @@ -clear all -clc - -% Configurações - n_total = 5000; % Número total de elementos - velocidade1 = 5; % Velocidade de transição entrada potencial(1-10) - velocidade2 = 5; % Velocidade de transição saida potencial (1-10) - expoente = 1; % Expoente da lei de potência - - dados =gerar_transicao_dupla2(n_total, velocidade1, velocidade2, expoente); - %dados = gerar_transicao_uniforme_potencial(n_total, velocidade, expoente); - %unif = rand(n_total /2,1); - %dados=[dados';unif]'; n_total=size(dados,2); - % Criar janela com subplots para visualização - figure('Position', [100, 100, 1200, 800]); - - % Subplot 1: Histograma completo - %subplot(2, 3, [1, 4]); - subplot(2,1,1); - histogram(dados, 100, 'Normalization', 'pdf', 'FaceColor', [0.3, 0.6, 0.9]); - xlabel('Value'); - ylabel('Density'); - title(sprintf('Uniform + Power law distribution + Uniform (N =%d)', n_total)); - grid on; - - % Subplot 4: Evolução temporal dos valores - %subplot(2, 3, [5, 6]); - subplot(2,1,2); - plot(1:n_total, dados', '.', 'MarkerSize', 2); - xlabel('N'); - ylabel('Value'); - title('Evolução Temporal dos Valores'); - grid on; - - % Adicionar linha de tendência móvel - window_size = 500; - media_movel = movmean(dados', window_size); - hold on; - plot(1:n_total, media_movel, 'r-', 'LineWidth', 2); - legend('Data', sprintf('Moving average (W=%d)', window_size), 'Location', 'best'); - hold off; - - % Estatísticas descritivas - fprintf('\n--- Estatísticas ---\n'); - fprintf('Média: %.4f\n', mean(dados)); - fprintf('Mediana: %.4f\n', median(dados)); - fprintf('Desvio padrão: %.4f\n', std(dados)); - fprintf('Mínimo: %.4f\n', min(dados)); - fprintf('Máximo: %.4f\n', max(dados)); - - % Análise da transição - % fprintf('\n--- Análise da Transição ---\n'); - - % % Dividir em 5 segmentos - % segmentos = 5; - % for k = 1:segmentos - % idx_inicio = round((k-1)*n_total/segmentos) + 1; - % idx_fim = round(k*n_total/segmentos); - % segmento = dados(idx_inicio:idx_fim); - % - % % Calcular média e mediana - % fprintf('Segmento %d (%.0f%%-%.0f%%): Média=%.4f, Mediana=%.4f, Coef.Variação=%.4f\n', ... - % k, (k-1)*100/segmentos, k*100/segmentos, ... - % mean(segmento), median(segmento), std(segmento)/mean(segmento)); - % end -%end -%%%%%%%%%%%%%%%% NATURAL TIME -Q=dados'; -% 1. Configuração Inicial e Medida de Energia -% O artigo sugere que a medida adequada é Qk = A^1.5, onde A é a amplitude [4, 5]. -%Q = Amp.^1.5; -Lin = length(Q); - -% Definição de PI_c (ruído uniforme) - calculada uma única vez -fi = 0:0.025:0.5; -ww = 2 * pi * fi; -pi_c = 18./(5*ww.^2) - 6*cos(ww)./(5*ww.^2) - 12*sin(ww)./(5*ww.^3); -pi_c(1) = 1; % Limite quando w -> 0 - -% Pré-alocação de variáveis para velocidade -kapa1 = zeros(Lin, 1); -Snt = zeros(Lin, 1); -Srev = zeros(Lin, 1); -D = zeros(Lin, 1); - -% Loop principal (Evolução dos eventos) -% Nota: Calculamos os parâmetros para cada janela de tamanho k -for k = 1:Lin - % 1. Recorte e Normalização da janela atual - Q_k = Q(1:k); - An = sum(Q_k); - pk = Q_k / An; % Energias normalizadas P_k [4] - - % 2. Vetor de Tempo Natural chi_k [4] - xk = (1:k)' / k; - - % 3. Cálculo Vetorizado de Kappa1 (Variância) - k1 = sum(pk .* (xk.^2)); - k2 = sum(pk .* xk); - kapa1(k) = k1 - k2^2; - - % 4. Cálculo Vetorizado das Entropias (S e S_inv) [1, 3] - % Usando logaritmo natural 'log' conforme recomendado [2] - Snt(k) = sum(pk .* xk .* log(xk)) - k2 * log(k2); - - % Para S_inv, invertemos a ordem das energias P_k -> P_{N-k+1} - pk_rev = flipud(pk); - k2_rev = sum(pk_rev .* xk); - Srev(k) = sum(pk_rev .* xk .* log(xk)) - k2_rev * log(k2_rev); - - % 5. Cálculo Vetorizado de PI(phi) e Distância D - % Criamos uma matriz para evitar o loop 'b' - % xk: (k x 1), ww: (1 x n_fi) -> exp_arg: (k x n_fi) - exp_arg = complex(0, 1) * (xk * ww); - Pi_phi = abs(pk' * exp(exp_arg)).^2; % Produto matricial calcula todos os fi de uma vez - - D(k) = mean(abs(Pi_phi - pi_c)); - - % Convertional time - %ct(k)=tpico(k); - % Natural time - nt(k)=k; - - % Feedback de progresso (opcional) - % if mod(k, 1000) == 0, disp(['Progresso: ', num26(k/Lin*100), '%']); end -end -% -figure() -% nt=ct; -plot(nt,kapa1,'r') -hold on -plot(nt,Snt,'b') -plot(nt,Srev,'m') -plot(nt,D,'g') -grid on - -plot([0 k],[0.07 0.07],'r--') -plot([0 k],[0.096 0.096],'b--') -plot([0 k],[0.02 0.02],'g--') -% ylim([0 0.3]) -legend('\kappa_1','S','S_r_e_v','D','0.07','0.096','0.02') -xlabel('N','FontName','Times New Roman','FontSize',18,'Rotation',0) -ylabel('\kappa_1, S, S_r_e_v, D','FontName','Times New Roman','FontSize',18,'Rotation',90) - -%% ENTROPIAS SHENNON AND HKL - -%Q=dados'; -Lin = length(Q); - -% 2. Pré-alocação de variáveis para desempenho -Hs = zeros(Lin, 1); -Hkl = zeros(Lin, 1); - -% 3. Cálculo Evolutivo (Abordagem de Janela Crescente) -% Conforme o artigo, a janela de detecção inicia no primeiro evento e -% cresce a cada novo hit para capturar o comportamento histórico [3, 6]. -for K = 2:Lin - % Energias da janela atual (do evento 1 até K) - current_Q = Q(1:K); - An = sum(current_Q); % Soma total da área/energia da janela [6, 7] - - % Vetor de probabilidade pK (distribuição de massa de ocorrência) [2] - % pK(k) é o k-ésimo elemento do vetor de probabilidade [2] - pk = current_Q / An; - - % --- Entropia de Shannon (Hs) --- - % Calculada para o hit K usando o logaritmo natural (ln) conforme orientação [2, 5] - % Hs(K) = -sum( pK * ln(pK) ) [2, 6] - Hs(K) = -sum(pk .* log(pk + eps)); - - % --- Entropia de Kullback-Leibler (Hkl) --- - % Expressa a probabilidade do evento atual condicionada pelo anterior [8] - % HKL(K) = -sum_{k=2}^{K} pK(k) * ln( pK(k) / pK(k-1) ) [6] - pk_atual = pk(2:end); - pk_anterior = pk(1:end-1); - Hkl(K) = -sum(pk_atual .* log((pk_atual + eps) ./ (pk_anterior + eps))); -end - -% 4. Valores Cumulativos (Sigma Hs e Sigma Hkl) -% O artigo também avalia a sensibilidade dos valores acumulados ao dano [1, 8]. -sum_Hs = cumsum(Hs); -sum_Hkl = cumsum(Hkl); - -% 5. Visualização dos Resultados -figure; -%subplot(2,1,1); -plot(Hs); -ylabel('\itH_s','FontName','Times New Roman','FontSize',18,'Rotation',90) -%set(gca, 'XTickLabel', []); % Remove os rótulos do eixo x grid on; -grid on -yyaxis right -ax = gca; -ax.YColor = 'k'; % define a cor do eixo Y direito como preto -hold on -%subplot(2,1,2); -plot(Hkl); grid on; -ylabel('\itH_{KL}','FontName','Times New Roman','FontSize',18,'Rotation',90) -legend('\itH_s','itH_{KL}') - -%% TSALLIS ENTROPY -win=50; %initial data size -k=1; -Amp=dados'; -tpico=1:1:size(dados,2) ; tpico=tpico'; -for jj=win+1:1:size(dados,2) -%Interval=[tpico(jj-win) tpico(jj)]; % SLIDING WINDOWN -Interval=[1 jj]; % -Mi=0.05; % division on the Amplitude distribution -[Datavalue, A_fit, lmbda_fit, q_fit, resultados_fit,p2]=EA_Calc_q(Amp,tpico,Interval,Mi,'NHist'); -A(k)=A_fit; -lmbda(k)=lmbda_fit; -q(k)=q_fit; -R(k)=resultados_fit.R_squared; -TPico(k)=jj; -p22(k)=p2; -k=k+1; -end -%% -figure; -plot(TPico,q,'r') -ylabel('q','FontName','Times New Roman','FontSize',20,'Rotation',90) -yyaxis right -hold on -plot(TPico,1./lmbda,'b') -legend('q','lambda') -xlabel('N','FontName','Times New Roman','FontSize',20,'Rotation',0) -ylabel('lambda','FontName','Times New Roman','FontSize',20,'Rotation',90) - -% -figure; -scatter(1./lmbda, q, 8, TPico, 'o'); % 50 = tamanho dos marcadores -colorbar; -xlabel('1/\it\lambda', 'FontSize', 12); -ylabel('\itq', 'FontSize', 12); -grid on -box on -ylabel(colorbar, 'Time [s]'); - - diff --git a/sandbox/Teste_pot.m b/sandbox/Teste_pot.m deleted file mode 100644 index 9344930..0000000 --- a/sandbox/Teste_pot.m +++ /dev/null @@ -1,239 +0,0 @@ -clear all -clc - -% Configurações - n_total = 5000; % Número total de elementos - velocidade1 = 10; % Velocidade de transição entrada potencial(1-10) - velocidade2 = 10; % Velocidade de transição saida potencial (1-10) - expoente = 1; % Expoente da lei de potência - - dados =gerar_transicao_dupla2(n_total, velocidade1, velocidade2, expoente); - %dados = gerar_transicao_uniforme_potencial(n_total, velocidade, expoente); - %unif = rand(n_total /2,1); - %dados=[dados';unif]'; n_total=size(dados,2); - % Criar janela com subplots para visualização - figure('Position', [100, 100, 1200, 800]); - - % Subplot 1: Histograma completo - %subplot(2, 3, [1, 4]); - subplot(2,1,1); - histogram(dados, 100, 'Normalization', 'pdf', 'FaceColor', [0.3, 0.6, 0.9]); - xlabel('Value'); - ylabel('Density'); - title(sprintf('Uniform + Power law distribution + Uniform (N =%d)', n_total)); - grid on; - - % Subplot 4: Evolução temporal dos valores - %subplot(2, 3, [5, 6]); - subplot(2,1,2); - plot(1:n_total, dados', '.', 'MarkerSize', 2); - xlabel('N'); - ylabel('Value'); - title('Evolução Temporal dos Valores'); - grid on; - - % Adicionar linha de tendência móvel - window_size = 500; - media_movel = movmean(dados', window_size); - hold on; - plot(1:n_total, media_movel, 'r-', 'LineWidth', 2); - legend('Data', sprintf('Moving average (W=%d)', window_size), 'Location', 'best'); - hold off; - - % Estatísticas descritivas - fprintf('\n--- Estatísticas ---\n'); - fprintf('Média: %.4f\n', mean(dados)); - fprintf('Mediana: %.4f\n', median(dados)); - fprintf('Desvio padrão: %.4f\n', std(dados)); - fprintf('Mínimo: %.4f\n', min(dados)); - fprintf('Máximo: %.4f\n', max(dados)); - - % Análise da transição - % fprintf('\n--- Análise da Transição ---\n'); - - % % Dividir em 5 segmentos - % segmentos = 5; - % for k = 1:segmentos - % idx_inicio = round((k-1)*n_total/segmentos) + 1; - % idx_fim = round(k*n_total/segmentos); - % segmento = dados(idx_inicio:idx_fim); - % - % % Calcular média e mediana - % fprintf('Segmento %d (%.0f%%-%.0f%%): Média=%.4f, Mediana=%.4f, Coef.Variação=%.4f\n', ... - % k, (k-1)*100/segmentos, k*100/segmentos, ... - % mean(segmento), median(segmento), std(segmento)/mean(segmento)); - % end -%end -%%%%%%%%%%%%%%%% NATURAL TIME -Q=dados'; -% 1. Configuração Inicial e Medida de Energia -% O artigo sugere que a medida adequada é Qk = A^1.5, onde A é a amplitude [4, 5]. -%Q = Amp.^1.5; -Lin = length(Q); - -% Definição de PI_c (ruído uniforme) - calculada uma única vez -fi = 0:0.025:0.5; -ww = 2 * pi * fi; -pi_c = 18./(5*ww.^2) - 6*cos(ww)./(5*ww.^2) - 12*sin(ww)./(5*ww.^3); -pi_c(1) = 1; % Limite quando w -> 0 - -% Pré-alocação de variáveis para velocidade -kapa1 = zeros(Lin, 1); -Snt = zeros(Lin, 1); -Srev = zeros(Lin, 1); -D = zeros(Lin, 1); - -% Loop principal (Evolução dos eventos) -% Nota: Calculamos os parâmetros para cada janela de tamanho k -for k = 1:Lin - % 1. Recorte e Normalização da janela atual - Q_k = Q(1:k); - An = sum(Q_k); - pk = Q_k / An; % Energias normalizadas P_k [4] - - % 2. Vetor de Tempo Natural chi_k [4] - xk = (1:k)' / k; - - % 3. Cálculo Vetorizado de Kappa1 (Variância) - k1 = sum(pk .* (xk.^2)); - k2 = sum(pk .* xk); - kapa1(k) = k1 - k2^2; - - % 4. Cálculo Vetorizado das Entropias (S e S_inv) [1, 3] - % Usando logaritmo natural 'log' conforme recomendado [2] - Snt(k) = sum(pk .* xk .* log(xk)) - k2 * log(k2); - - % Para S_inv, invertemos a ordem das energias P_k -> P_{N-k+1} - pk_rev = flipud(pk); - k2_rev = sum(pk_rev .* xk); - Srev(k) = sum(pk_rev .* xk .* log(xk)) - k2_rev * log(k2_rev); - - % 5. Cálculo Vetorizado de PI(phi) e Distância D - % Criamos uma matriz para evitar o loop 'b' - % xk: (k x 1), ww: (1 x n_fi) -> exp_arg: (k x n_fi) - exp_arg = complex(0, 1) * (xk * ww); - Pi_phi = abs(pk' * exp(exp_arg)).^2; % Produto matricial calcula todos os fi de uma vez - - D(k) = mean(abs(Pi_phi - pi_c)); - - % Convertional time - %ct(k)=tpico(k); - % Natural time - nt(k)=k; - - % Feedback de progresso (opcional) - % if mod(k, 1000) == 0, disp(['Progresso: ', num26(k/Lin*100), '%']); end -end -% -figure() -% nt=ct; -plot(nt,kapa1,'r') -hold on -plot(nt,Snt,'b') -plot(nt,Srev,'m') -plot(nt,D,'g') -grid on - -plot([0 k],[0.07 0.07],'r--') -plot([0 k],[0.096 0.096],'b--') -plot([0 k],[0.02 0.02],'g--') -% ylim([0 0.3]) -legend('\kappa_1','S','S_r_e_v','D','0.07','0.096','0.02') -xlabel('N','FontName','Times New Roman','FontSize',18,'Rotation',0) -ylabel('\kappa_1, S, S_r_e_v, D','FontName','Times New Roman','FontSize',18,'Rotation',90) - -%% ENTROPIAS SHENNON AND HKL - -%Q=dados'; -Lin = length(Q); - -% 2. Pré-alocação de variáveis para desempenho -Hs = zeros(Lin, 1); -Hkl = zeros(Lin, 1); - -% 3. Cálculo Evolutivo (Abordagem de Janela Crescente) -% Conforme o artigo, a janela de detecção inicia no primeiro evento e -% cresce a cada novo hit para capturar o comportamento histórico [3, 6]. -for K = 2:Lin - % Energias da janela atual (do evento 1 até K) - current_Q = Q(1:K); - An = sum(current_Q); % Soma total da área/energia da janela [6, 7] - - % Vetor de probabilidade pK (distribuição de massa de ocorrência) [2] - % pK(k) é o k-ésimo elemento do vetor de probabilidade [2] - pk = current_Q / An; - - % --- Entropia de Shannon (Hs) --- - % Calculada para o hit K usando o logaritmo natural (ln) conforme orientação [2, 5] - % Hs(K) = -sum( pK * ln(pK) ) [2, 6] - Hs(K) = -sum(pk .* log(pk + eps)); - - % --- Entropia de Kullback-Leibler (Hkl) --- - % Expressa a probabilidade do evento atual condicionada pelo anterior [8] - % HKL(K) = -sum_{k=2}^{K} pK(k) * ln( pK(k) / pK(k-1) ) [6] - pk_atual = pk(2:end); - pk_anterior = pk(1:end-1); - Hkl(K) = -sum(pk_atual .* log((pk_atual + eps) ./ (pk_anterior + eps))); -end - -% 4. Valores Cumulativos (Sigma Hs e Sigma Hkl) -% O artigo também avalia a sensibilidade dos valores acumulados ao dano [1, 8]. -sum_Hs = cumsum(Hs); -sum_Hkl = cumsum(Hkl); - -% 5. Visualização dos Resultados -figure; -%subplot(2,1,1); -plot(Hs); -ylabel('\itH_s','FontName','Times New Roman','FontSize',18,'Rotation',90) -%set(gca, 'XTickLabel', []); % Remove os rótulos do eixo x grid on; -grid on -yyaxis right -ax = gca; -ax.YColor = 'k'; % define a cor do eixo Y direito como preto -hold on -%subplot(2,1,2); -plot(Hkl); grid on; -ylabel('\itH_{KL}','FontName','Times New Roman','FontSize',18,'Rotation',90) -legend('\itH_s','itH_{KL}') - -%% TSALLIS ENTROPY -win=50; %initial data size -k=1; -Amp=dados'; -tpico=1:1:size(dados,2) ; tpico=tpico'; -for jj=win+1:1:size(dados,2) -%Interval=[tpico(jj-win) tpico(jj)]; % SLIDING WINDOWN -Interval=[1 jj]; % -Mi=0.05; % division on the Amplitude distribution -[Datavalue, A_fit, lmbda_fit, q_fit, resultados_fit,p2]=EA_Calc_q(Amp,tpico,Interval,Mi,'NHist'); -A(k)=A_fit; -lmbda(k)=lmbda_fit; -q(k)=q_fit; -R(k)=resultados_fit.R_squared; -TPico(k)=jj; -p22(k)=p2; -k=k+1; -end -%% -figure; -plot(TPico,q,'r') -ylabel('q','FontName','Times New Roman','FontSize',20,'Rotation',90) -yyaxis right -hold on -plot(TPico,1./lmbda,'b') -legend('q','lambda') -xlabel('N','FontName','Times New Roman','FontSize',20,'Rotation',0) -ylabel('lambda','FontName','Times New Roman','FontSize',20,'Rotation',90) - -% -figure; -scatter(1./lmbda, q, 8, TPico, 'o'); % 50 = tamanho dos marcadores -colorbar; -xlabel('1/\it\lambda', 'FontSize', 12); -ylabel('\itq', 'FontSize', 12); -grid on -box on -ylabel(colorbar, 'Time [s]'); - - diff --git a/sandbox/gerar_transicao_dupla2.m b/sandbox/gerar_transicao_dupla2.m deleted file mode 100644 index a794295..0000000 --- a/sandbox/gerar_transicao_dupla2.m +++ /dev/null @@ -1,74 +0,0 @@ -function dados = gerar_transicao_dupla(n_total, velocidade1, velocidade2, expoente) - % GERAR_TRANSICAO_DUPLA - Gera números com transição uniforme → potencial → uniforme - % - % Entradas: - % n_total - número total de elementos - % velocidade1 - velocidade da primeira transição (uniforme → potencial) - % valores típicos: 1 a 10 (maior = mais abrupta) - % velocidade2 - velocidade da segunda transição (potencial → uniforme) - % expoente - expoente da distribuição potencial (alfa > 0) - % - % Saída: - % dados - vetor (1 x n_total) com os números gerados - - % Validações - if nargin < 4 - error('São necessários 4 argumentos: n_total, velocidade1, velocidade2, expoente'); - end - if velocidade1 <= 0 || velocidade2 <= 0 - error('As velocidades devem ser positivas'); - end - if expoente <= 0 - error('Expoente deve ser positivo'); - end - - % Pontos de transição fixos (frações normalizadas de 0 a 1) - p1 = 0.01; % fim da primeira zona uniforme - p2 = 0.01; % fim da transição uniforme → potencial - p3 = 1.0; % fim da zona potencial pura - p4 = 1.0; % fim da transição potencial → uniforme - - % Pré‑calcular a distribuição potencial (intervalo [0.01, 1]) - x_min = 0.01; - x_max = 1.0; - if abs(expoente - 1) < 1e-6 - % Expoente = 1 → distribuição logarítmica - log_ratio = log(x_max / x_min); - gerar_potencial = @() x_min * exp(rand() * log_ratio); - else - c1 = x_min^(1 - expoente); - c2 = x_max^(1 - expoente); - gerar_potencial = @() (rand() * (c2 - c1) + c1)^(1/(1 - expoente)); - end - - % Gerar cada elemento - dados = zeros(1, n_total); - for i = 1:n_total - t = (i - 1) / (n_total - 1); % posição normalizada (0 → 1) - - % Determinar o peso da componente potencial (0 = uniforme, 1 = potencial) - if t <= p1 - peso_pot = 0; - elseif t <= p2 - % Transição uniforme → potencial (sigmóide crescente) - t_norm = (t - p1) / (p2 - p1); % mapeia [p1, p2] → [0, 1] - peso_pot = 1 / (1 + exp(-velocidade1 * (t_norm - 0.5) * 8)); - elseif t <= p3 - % Zona potencial pura - peso_pot = 1; - elseif t <= p4 - % Transição potencial → uniforme (sigmóide decrescente) - t_norm = (t - p3) / (p4 - p3); % mapeia [p3, p4] → [0, 1] - peso_pot = 1 / (1 + exp(velocidade2 * (t_norm - 0.5) * 8)); - else - peso_pot = 0; - end - - % Amostrar conforme o peso - if rand() < peso_pot - dados(i) = gerar_potencial(); - else - dados(i) = rand(); % uniforme em [0,1] - end - end -end \ No newline at end of file diff --git a/sandbox/main.m b/sandbox/main.m deleted file mode 100644 index 082baf9..0000000 --- a/sandbox/main.m +++ /dev/null @@ -1,14 +0,0 @@ -clear all -clc -global INT INB U V W U0 V0 W0 BDX BDY BDZ VLX VLY VLZ -global ACX ACY ACZ FRX FRY FRZ FX FY FZ MAS MSS CN ENR -global EDG E1 E2 LI DEQB F YNGB GFRB LCRB EPRB EP SS EM -global EN KR KR1 DSS DM FS CAF DT GFR DEQ LCR TEST EST -global DF DF1 DF2 DMP1 DMP2 TDAF CON M N L M1 N1 L1 MNL -global NNO NNS NNT NBA NBS NBT INCO NCON STEP NSTEP NDAMF -global RUN NRUN LCO TIME TTOT PSN ROH YNG EPR EPMAX EPMIN -global MEAN COEV ENEX ENCN ENEL ENGD ENDP ENIN DEN DERIV -global XB YB ZB UBAR VBAR WBAR REACAOX REACAOY REACAOZ -global STRAIN STRESS - -ini=ini_DEM3() diff --git a/sandbox/mainDEM.m b/sandbox/mainDEM.m deleted file mode 100644 index f5fd5bd..0000000 --- a/sandbox/mainDEM.m +++ /dev/null @@ -1,404 +0,0 @@ -clear all -clc - -% Configurações -INT = 10000; % total number of nodes -IBT = 100000; % total number of bars/elements -U(3, INT) = 0.0; % nodal displacements in the x direction, at (i-1), (i), (i+1) -V(3, INT) = 0.0; % y direction -W(3, INT) = 0.0; % z direction -U0(INT) = 0.0; % initial displacements -V0(INT)=0.0; -W0(INT)=0.0; -BDX(INT)=0.0;% Boundary conditions (1=fix, 0=free) -BDY(INT)=0.0;% nodal velocities -BDZ(INT)=0.0; -VLX(INT)=0.0;% nodal velocities -VLY(INT)=0.0; -VLZ(INT)=0.0; -ACX(INT)=0.0;% nodal acelerations -ACY(INT)=0.0; -ACZ(INT)=0.0; -FRX(INT)=0.0;% nodal force computed in each step -FRY(INT)=0.0; -FRZ(INT)=0.0; -FX(INT)=0.0;% nodal forces acumulated -FY(INT)=0.0; -FZ(INT)=0.0; -MAS(INT)=0.0; % nodal mass with correction by border effect -MSS(INT)=0.0;% nodal mass with correction without border effect -% -CN(2,INB)=0; %C(1,INB)=conect(i), C(2,INB)=conect(j) -ENR(INB)=0.0; -EDG(INB)=0.0; -LI(INB)=0.0; -EP(INB)=0.0; -EM(INB)=0.0; -SS(INB)=0.0; -DSS(INB)=0.0; -EPRB(INB)=0.0; -EPRB(INB)=0.0; -E1(INB)=0.0; -E2(INB)=0.0; -KR(INB)=0.0; -KR1(INB)=0.0; -DM(INB)=true; -FS(INB)=true; -DM1(INB)=true; -FS1(INB)=true; -EN(INB)=0.0 -ansysColor(INB)=0 -DEQB(INB)=0.0; -YNGB(INB)=0.0; -GFRB(INB)=0.0; -F(INB)=0.0; -LCRB(INB)=0.0; -TR(INB)=0.0; - - - COMMON /SIM/ CAF,CUT,DT,GFR,DEQ,LCR,SEED - COMMON /COM0/ TEST,EST,Label - COMMON /COM1/ M,N,L,M1,N1,L1,MNL - COMMON /COM2/ NNO,NNS,NNT,NBA,NBS,NBT - COMMON /COM3/ INCO,NCON - COMMON /COM4/ OU2,OU3,OU4,OU5,OU6,OU7,OU8,OU9 - COMMON /COM5/ PR3,PR4,PR5,PR67,PR8,PR9 - COMMON /COM6/ STEP,NSTEP,NDAMF,RUN,NRUN - COMMON /COM7/ LCO,DF1,DF2,DMP1,DMP2,TDAF,CON - COMMON /COM8/ TIME,TTOT - COMMON /COM9/ PSN,ROH,YNG,EPR - COMMON /CO10/ EPMAX,EPMIN,MEAN,COEV - COMMON /CO11/ ENEX,ENCN,ENEL,ENGD,ENDP,ENIN,DEN,DERIV - COMMON /CO12/ REACAOX,REACAOY,REACAOZ,aaa,ReaV,vmax,tt1,vmax2,tt2, & - &VF1,VF2,VF3,vmax3,tt3,VF4,vmax4,vmax5,tt5,VF6,vmax6,tt6,dmax,dmax2 - - COMMON /CO13/ XB,YB,ZB - COMMON /CO14/ NK1,NK2,NK3 - COMMON /CO15/ D2,PI,K1,K2,K3,DK1,DK2,DK3 - COMMON /CO16/ PHI1,PHI2,PHI3,PHI4,AN - COMMON /CO17/ CVROH,CVYNG,CVGFR,CORRCAF - COMMON /CO18/ TENNORMZ,TENTANGX - COMMON /CO19/ RKX,RKZ,VF - COMMON /CO20/ STRAIN,STRESS - COMMON /CO21/ FOR1,STR1,FOR2,STR2,FOR3,STR3,FOR4,STR4 - COMMON /CO22/ ROHN - COMMON /CO23/ BTA,GMA,IBT - COMMON /CO24/ LCORX,LCORY,LCORZ,NPTX,NPTY,NPTZ,NPTOTAL - COMMON /CO25/ UBAR,VBAR,WBAR,IPT - COMMON /CO26/ MPJ,NPJ,LPJ,MPI,NPI,LPI - COMMON /CO27/ IPT1,IPT2,IPT3,IPT4,IPT5,IPT6,IPT7,IPT8,IPT9 - COMMON /CO28/ X,Y,Z - COMMON /CO29/ MP2,NP2,LP2,PHI - COMMON /CO30/ PMI,PNI,PLI,PHIV - COMMON /CO31/ xc,yc,vfarea,vfareal,time1 - COMMON /CO34/ neib,iicont - COMMON /CO35/ krs,epp,constB - COMMON/C036/krsc,E2C,EMC - common /g/g51589,gg51589,g89116,gg89116,ggg89116,giv89116 - COMMON/str/DESELX,DESELXMEDIO,SOMADESX,DESELY,DESELYMEDIO, & - & SOMADESY - -DOUBLE PRECISION DESELX,DESELXMEDIO,SOMADESX - DOUBLE PRECISION DESELY,DESELYMEDIO,SOMADESY - integer neib(420000,30),iicont - double precision krs,epp,g51589,gg51589,g89116,gg89116,ggg8911, & - & constB - double precision giv89116 - double precision krsc,e2c(inb),emc(inb) - - DOUBLE PRECISION U(3,INN),V(3,INN),W(3,INN),U0(INN),V0(INN), & - &W0(INN),VLX(INN),VLY(INN),VLZ(INN),ACX(INN), & - &ACY(INN),ACZ(INN),FRX(INN),FRY(INN),FRZ(INN), & - &FX(INN),FY(INN),FZ(INN),MAS(INN),MSS(INN), ROMP(INB,1), & - &ROMP_OLD(INB,1) -! - DOUBLE PRECISION UBAR,VBAR,WBAR,MPJ,MP2,NP2,LP2,NPJ,LPJ, & - &MPI,NPI,LPI,PHI(INN),PMI,PNI,PLI,IPT1,IPT7,IPT8,IPT2,IPT3, & - &IPT4,IPT5,IPT6 -! - INTEGER BDX(INN),BDY(INN),BDZ(INN),NPTOTAL -! - INTEGER CN(2*INB) -! - DOUBLE PRECISION ENR(INB),EDG(INB),LI(INB),EP(INB),E1(INB), & - &E2(INB),SS(INB),EM(INB),KR(INB),DSS(INB),EPRB(INB),EN(2,INB), & - &ansysColor (INB), DEQB(INB), F(INB), YNGB(INB),GFRB(INB), & - &LCRB(INB),KR1(INB) -! - DOUBLE PRECISION LCORX,LCORY,LCORZ -! - LOGICAL DM(INB),FS(INB),DM1(INB),FS1(INB),TR(INB) -! - INTEGER SEED - INTEGER TEST,EST,Label - INTEGER M,N,L,M1,N1,L1,MNL - INTEGER NNO,NNS,NNT,NBA,NBS,NBT - INTEGER NCON(INCON),INCO - INTEGER OU2,OU3,OU4,OU5,OU6,OU7,OU8,OU9 - INTEGER PR3,PR4,PR5,PR67,PR8,PR9 - INTEGER STEP,NSTEP,NDAMF,RUN,NRUN - INTEGER NK1,NK2,NK3 - INTEGER NBTX,NBTY,NBTZ,IBT - INTEGER IBTX,IBTY,IBTZ -! - DOUBLE PRECISION CAF,DT,GFR,RFC,LCR,CUT - DOUBLE PRECISION LCO,DF1,DF2,DMP1,DMP2,TDAF,CON - DOUBLE PRECISION TIME,TTOT - DOUBLE PRECISION PSN,ROH,YNG,EPR - DOUBLE PRECISION EPMAX,EPMIN,MEAN,COEV - DOUBLE PRECISION ENEX,ENCN,ENEL,ENGD,ENDP,ENIN,DEN,DERIV - DOUBLE PRECISION REACAOX,REACAOY,REACAOZ,aaa,ReaV,vmax,tt1,vmax2, & - & tt2,VF1,VF2,VF3,vmax3,tt3,VF4,vmax4,tt4,VF5,vmax5,tt5,VF6,vmax6, & - & tt6,dmax,dmax2 - DOUBLE PRECISION XB(INB),YB(INB),ZB(INB) - DOUBLE PRECISION D2,PI,K1,K2,K3,DK1,DK2,DK3 - DOUBLE PRECISION PHI1(16,16,16),PHI2(16,16,16) - DOUBLE PRECISION PHI3(16,16,16),PHI4(16,16,16) - DOUBLE PRECISION AN(16,16,16) - DOUBLE PRECISION CVROH,CVYNG,CVGFR,CORRCAF - DOUBLE PRECISION TENNORMZ,TENTANGX - DOUBLE PRECISION RKX,RKZ,VF -! - DOUBLE PRECISION FOR1,STR1,FOR2,STR2,FOR3,STR3,FOR4,STR4 -! - DOUBLE PRECISION STRESS,STRAIN - DOUBLE PRECISION ROHN(INN) - DOUBLE PRECISION GMA,BTA - DOUBLE PRECISION xc,yc,vfarea,vfareal,time1 - - - n_total = 5000; % Número total de elementos - velocidade1 = 5; % Velocidade de transição entrada potencial(1-10) - velocidade2 = 5; % Velocidade de transição saida potencial (1-10) - expoente = 1; % Expoente da lei de potência - - dados =gerar_transicao_dupla2(n_total, velocidade1, velocidade2, expoente); - %dados = gerar_transicao_uniforme_potencial(n_total, velocidade, expoente); - %unif = rand(n_total /2,1); - %dados=[dados';unif]'; n_total=size(dados,2); - % Criar janela com subplots para visualização - figure('Position', [100, 100, 1200, 800]); - - % Subplot 1: Histograma completo - %subplot(2, 3, [1, 4]); - subplot(2,1,1); - histogram(dados, 100, 'Normalization', 'pdf', 'FaceColor', [0.3, 0.6, 0.9]); - xlabel('Value'); - ylabel('Density'); - title(sprintf('Uniform + Power law distribution + Uniform (N =%d)', n_total)); - grid on; - - % Subplot 4: Evolução temporal dos valores - %subplot(2, 3, [5, 6]); - subplot(2,1,2); - plot(1:n_total, dados', '.', 'MarkerSize', 2); - xlabel('N'); - ylabel('Value'); - title('Evolução Temporal dos Valores'); - grid on; - - % Adicionar linha de tendência móvel - window_size = 500; - media_movel = movmean(dados', window_size); - hold on; - plot(1:n_total, media_movel, 'r-', 'LineWidth', 2); - legend('Data', sprintf('Moving average (W=%d)', window_size), 'Location', 'best'); - hold off; - - % Estatísticas descritivas - fprintf('\n--- Estatísticas ---\n'); - fprintf('Média: %.4f\n', mean(dados)); - fprintf('Mediana: %.4f\n', median(dados)); - fprintf('Desvio padrão: %.4f\n', std(dados)); - fprintf('Mínimo: %.4f\n', min(dados)); - fprintf('Máximo: %.4f\n', max(dados)); - - % Análise da transição - % fprintf('\n--- Análise da Transição ---\n'); - - % % Dividir em 5 segmentos - % segmentos = 5; - % for k = 1:segmentos - % idx_inicio = round((k-1)*n_total/segmentos) + 1; - % idx_fim = round(k*n_total/segmentos); - % segmento = dados(idx_inicio:idx_fim); - % - % % Calcular média e mediana - % fprintf('Segmento %d (%.0f%%-%.0f%%): Média=%.4f, Mediana=%.4f, Coef.Variação=%.4f\n', ... - % k, (k-1)*100/segmentos, k*100/segmentos, ... - % mean(segmento), median(segmento), std(segmento)/mean(segmento)); - % end -%end -%%%%%%%%%%%%%%%% NATURAL TIME -Q=dados'; -% 1. Configuração Inicial e Medida de Energia -% O artigo sugere que a medida adequada é Qk = A^1.5, onde A é a amplitude [4, 5]. -%Q = Amp.^1.5; -Lin = length(Q); - -% Definição de PI_c (ruído uniforme) - calculada uma única vez -fi = 0:0.025:0.5; -ww = 2 * pi * fi; -pi_c = 18./(5*ww.^2) - 6*cos(ww)./(5*ww.^2) - 12*sin(ww)./(5*ww.^3); -pi_c(1) = 1; % Limite quando w -> 0 - -% Pré-alocação de variáveis para velocidade -kapa1 = zeros(Lin, 1); -Snt = zeros(Lin, 1); -Srev = zeros(Lin, 1); -D = zeros(Lin, 1); - -% Loop principal (Evolução dos eventos) -% Nota: Calculamos os parâmetros para cada janela de tamanho k -for k = 1:Lin - % 1. Recorte e Normalização da janela atual - Q_k = Q(1:k); - An = sum(Q_k); - pk = Q_k / An; % Energias normalizadas P_k [4] - - % 2. Vetor de Tempo Natural chi_k [4] - xk = (1:k)' / k; - - % 3. Cálculo Vetorizado de Kappa1 (Variância) - k1 = sum(pk .* (xk.^2)); - k2 = sum(pk .* xk); - kapa1(k) = k1 - k2^2; - - % 4. Cálculo Vetorizado das Entropias (S e S_inv) [1, 3] - % Usando logaritmo natural 'log' conforme recomendado [2] - Snt(k) = sum(pk .* xk .* log(xk)) - k2 * log(k2); - - % Para S_inv, invertemos a ordem das energias P_k -> P_{N-k+1} - pk_rev = flipud(pk); - k2_rev = sum(pk_rev .* xk); - Srev(k) = sum(pk_rev .* xk .* log(xk)) - k2_rev * log(k2_rev); - - % 5. Cálculo Vetorizado de PI(phi) e Distância D - % Criamos uma matriz para evitar o loop 'b' - % xk: (k x 1), ww: (1 x n_fi) -> exp_arg: (k x n_fi) - exp_arg = complex(0, 1) * (xk * ww); - Pi_phi = abs(pk' * exp(exp_arg)).^2; % Produto matricial calcula todos os fi de uma vez - - D(k) = mean(abs(Pi_phi - pi_c)); - - % Convertional time - %ct(k)=tpico(k); - % Natural time - nt(k)=k; - - % Feedback de progresso (opcional) - % if mod(k, 1000) == 0, disp(['Progresso: ', num26(k/Lin*100), '%']); end -end -% -figure() -% nt=ct; -plot(nt,kapa1,'r') -hold on -plot(nt,Snt,'b') -plot(nt,Srev,'m') -plot(nt,D,'g') -grid on - -plot([0 k],[0.07 0.07],'r--') -plot([0 k],[0.096 0.096],'b--') -plot([0 k],[0.02 0.02],'g--') -% ylim([0 0.3]) -legend('\kappa_1','S','S_r_e_v','D','0.07','0.096','0.02') -xlabel('N','FontName','Times New Roman','FontSize',18,'Rotation',0) -ylabel('\kappa_1, S, S_r_e_v, D','FontName','Times New Roman','FontSize',18,'Rotation',90) - -%% ENTROPIAS SHENNON AND HKL - -%Q=dados'; -Lin = length(Q); - -% 2. Pré-alocação de variáveis para desempenho -Hs = zeros(Lin, 1); -Hkl = zeros(Lin, 1); - -% 3. Cálculo Evolutivo (Abordagem de Janela Crescente) -% Conforme o artigo, a janela de detecção inicia no primeiro evento e -% cresce a cada novo hit para capturar o comportamento histórico [3, 6]. -for K = 2:Lin - % Energias da janela atual (do evento 1 até K) - current_Q = Q(1:K); - An = sum(current_Q); % Soma total da área/energia da janela [6, 7] - - % Vetor de probabilidade pK (distribuição de massa de ocorrência) [2] - % pK(k) é o k-ésimo elemento do vetor de probabilidade [2] - pk = current_Q / An; - - % --- Entropia de Shannon (Hs) --- - % Calculada para o hit K usando o logaritmo natural (ln) conforme orientação [2, 5] - % Hs(K) = -sum( pK * ln(pK) ) [2, 6] - Hs(K) = -sum(pk .* log(pk + eps)); - - % --- Entropia de Kullback-Leibler (Hkl) --- - % Expressa a probabilidade do evento atual condicionada pelo anterior [8] - % HKL(K) = -sum_{k=2}^{K} pK(k) * ln( pK(k) / pK(k-1) ) [6] - pk_atual = pk(2:end); - pk_anterior = pk(1:end-1); - Hkl(K) = -sum(pk_atual .* log((pk_atual + eps) ./ (pk_anterior + eps))); -end - -% 4. Valores Cumulativos (Sigma Hs e Sigma Hkl) -% O artigo também avalia a sensibilidade dos valores acumulados ao dano [1, 8]. -sum_Hs = cumsum(Hs); -sum_Hkl = cumsum(Hkl); - -% 5. Visualização dos Resultados -figure; -%subplot(2,1,1); -plot(Hs); -ylabel('\itH_s','FontName','Times New Roman','FontSize',18,'Rotation',90) -%set(gca, 'XTickLabel', []); % Remove os rótulos do eixo x grid on; -grid on -yyaxis right -ax = gca; -ax.YColor = 'k'; % define a cor do eixo Y direito como preto -hold on -%subplot(2,1,2); -plot(Hkl); grid on; -ylabel('\itH_{KL}','FontName','Times New Roman','FontSize',18,'Rotation',90) -legend('\itH_s','itH_{KL}') - -%% TSALLIS ENTROPY -win=50; %initial data size -k=1; -Amp=dados'; -tpico=1:1:size(dados,2) ; tpico=tpico'; -for jj=win+1:1:size(dados,2) -%Interval=[tpico(jj-win) tpico(jj)]; % SLIDING WINDOWN -Interval=[1 jj]; % -Mi=0.05; % division on the Amplitude distribution -[Datavalue, A_fit, lmbda_fit, q_fit, resultados_fit,p2]=EA_Calc_q(Amp,tpico,Interval,Mi,'NHist'); -A(k)=A_fit; -lmbda(k)=lmbda_fit; -q(k)=q_fit; -R(k)=resultados_fit.R_squared; -TPico(k)=jj; -p22(k)=p2; -k=k+1; -end -%% -figure; -plot(TPico,q,'r') -ylabel('q','FontName','Times New Roman','FontSize',20,'Rotation',90) -yyaxis right -hold on -plot(TPico,1./lmbda,'b') -legend('q','lambda') -xlabel('N','FontName','Times New Roman','FontSize',20,'Rotation',0) -ylabel('lambda','FontName','Times New Roman','FontSize',20,'Rotation',90) - -% -figure; -scatter(1./lmbda, q, 8, TPico, 'o'); % 50 = tamanho dos marcadores -colorbar; -xlabel('1/\it\lambda', 'FontSize', 12); -ylabel('\itq', 'FontSize', 12); -grid on -box on -ylabel(colorbar, 'Time [s]'); - - diff --git a/setup_path.m b/setup_path.m index 9bc04b5..df84397 100644 --- a/setup_path.m +++ b/setup_path.m @@ -1,9 +1,8 @@ function setup_path() %SETUP_PATH Add the LDEM code to the MATLAB path. % -% setup_path() adds to the MATLAB path, for the current session: -% src/ the refactored package, used as ldem. -% legacy/ the frozen original routines (reference implementation) +% setup_path() adds src/ to the MATLAB path for the current session, so +% the package can be used as ldem.. % % Example: % >> setup_path @@ -13,5 +12,4 @@ function setup_path() root = fileparts(mfilename('fullpath')); addpath(fullfile(root, 'src')); -addpath(fullfile(root, 'legacy')); end diff --git a/src/+ldem/+io/SnapshotWriter.m b/src/+ldem/+io/SnapshotWriter.m index 57efa91..c915326 100644 --- a/src/+ldem/+io/SnapshotWriter.m +++ b/src/+ldem/+io/SnapshotWriter.m @@ -5,7 +5,7 @@ % calls the writer at the steps chosen by params.output.snapshotEvery. % For every snapshot the writer does the following: % - % * keeps a compact copy (displacement and damage state), stored in the results; + % * keeps a compact copy (displacement, damage state and nodal kinetic energy), stored in the results; % * writes an ANSYS macro file if "ansys" is among the formats; % * writes a VTK file if "vtk" is among the formats. % @@ -40,6 +40,7 @@ BarCounts = zeros(0, 3) Displacements = {} DamageStates = {} + KineticEnergies = {} VtkFiles = strings(0, 1) end @@ -95,6 +96,7 @@ function write(obj, state) obj.BarCounts(end + 1, :) = [counts.intact, counts.damaged, counts.broken]; obj.Displacements{end + 1} = single(state.displacement); obj.DamageStates{end + 1} = damageState; + obj.KineticEnergies{end + 1} = single(ldem.solver.nodalKineticEnergy(state, obj.Mesh)); end function snapshots = finish(obj) @@ -104,7 +106,8 @@ function write(obj, state) % step, time (n-by-1), barCounts (n-by-3: intact, damaged, % broken), and displacement (n-by-1 cell of nNodes-by-3 single) % and damageState (n-by-1 cell of nBars-by-1 uint8: 0 intact, - % 1 damaged, 2 broken). + % 1 damaged, 2 broken), and kineticEnergy (n-by-1 cell of + % nNodes-by-1 single: kinetic energy of every node [J]). arguments obj (1,1) ldem.io.SnapshotWriter end @@ -117,7 +120,8 @@ function write(obj, state) 'time', obj.Times, ... 'barCounts', obj.BarCounts, ... 'displacement', {obj.Displacements(:)}, ... - 'damageState', {obj.DamageStates(:)}); + 'damageState', {obj.DamageStates(:)}, ... + 'kineticEnergy', {obj.KineticEnergies(:)}); end end diff --git a/src/+ldem/+io/exportAnsys.m b/src/+ldem/+io/exportAnsys.m index 6002b06..f04fcb0 100644 --- a/src/+ldem/+io/exportAnsys.m +++ b/src/+ldem/+io/exportAnsys.m @@ -15,8 +15,13 @@ % file, so the damaged zone is easy to see. % % The constraint section lists the degrees of freedom held by the scenario -% (mesh.fixed). Node positions are written in single precision, like the -% legacy code. +% (mesh.fixed), with value zero. The applied-loads section then gives, as +% "D,node,direction,value", the displacement imposed on the loaded nodes +% measured from their initial position (nothing is written at time zero). +% Note that the node coordinates of the file are the current positions, so +% the file shows the state of the simulation; it is not a restart of the +% analysis from the undeformed lattice. Node positions are written in +% single precision, like the legacy code. % % Inputs: % path Path of the file to create. @@ -33,8 +38,9 @@ % Differences from the legacy file: the line "ET,IFILE,4" (an invalid % command caused by a translation slip) is written as "ET,3,4"; the % constraints are written for every scenario, not only for TEST 102; and -% the hardcoded "applied loads" of TEST 102 are not written (they did not -% match any node of the beam). +% the hardcoded "applied loads" of TEST 102 ("F,node,Fx,-10" on nodes that +% matched no node of the beam) are replaced by the imposed displacements +% of the loaded nodes. % % Example: % counts = ldem.io.exportAnsys("step100.mac", mesh, state); @@ -109,7 +115,18 @@ end fprintf(fid, '\n'); -fprintf(fid, '!CARGAS APLICADAS\n'); +% Applied loads: the displacement imposed on the held degrees of freedom of +% the loaded nodes, measured from their initial position. ANSYS keeps the +% last constraint given to a degree of freedom, so these lines replace the +% zero-valued ones of the section above. +fprintf(fid, '!CARGAS APLICADAS (DESLOCAMENTO IMPOSTO DESDE A POSICAO INICIAL)\n'); +imposed = state.displacement - mesh.nodes0; +imposed(~mesh.fixed) = 0; +for node = find(any(imposed ~= 0, 2)).' + for direction = find(imposed(node, :) ~= 0) + fprintf(fid, 'D,%d,%s,%g\n', node, directions(direction), imposed(node, direction)); + end +end fprintf(fid, '\n'); fprintf(fid, '/VIEW,1,0,-1,0\n'); diff --git a/src/+ldem/+material/summarizeMaterial.m b/src/+ldem/+material/summarizeMaterial.m new file mode 100644 index 0000000..2270350 --- /dev/null +++ b/src/+ldem/+material/summarizeMaterial.m @@ -0,0 +1,74 @@ +function summary = summarizeMaterial(barProps, params) +%SUMMARIZEMATERIAL Material data and derived quantities, for the results file. +% +% summary = ldem.material.summarizeMaterial(barProps, params) collects the +% material parameters, the lattice coefficients and the statistics of the +% critical strain in one struct, so that a results file documents the +% material that was simulated. +% +% Fields of summary: +% +% youngModulus E [Pa] +% poissonRatio nu +% density rho [kg/m^3] +% waveSpeed sqrt(E/rho) [m/s] +% fractureEnergy Gf [N/m] +% criticalDistance equivalent distance deq [m] +% failureAreaFactor CAF +% delta lattice coefficient delta +% alpha lattice coefficient alpha +% normalStiffness alpha*E*L^2 of a bar with the length of a module [N] +% diagonalStiffness normalStiffness times the diagonal factor [N] +% criticalLength Lcr = 2*deq*CAF/alpha [m] +% ruptureRatioNormal Lcr divided by the module length (KR of a normal bar) +% baseCriticalStrain sqrt(Gf/(E*deq)), before the random field +% criticalStrainMean mean of the critical strain EP of all bars +% criticalStrainCv coefficient of variation of EP +% criticalStrainMin smallest EP +% criticalStrainMax largest EP +% +% Input: +% barProps Struct from ldem.material.buildBarProperties. +% params ldem.Parameters. +% +% Output: +% summary Struct with the fields above. +% +% Example: +% material = ldem.material.summarizeMaterial(barProps, params); +% +% Legacy: the material block of WRICON (EPMAX and EPMIN were never updated +% there and COEV was never stored, see docs/known-issues/KNOWN_ISSUES.md). +% +% See also ldem.material.buildBarProperties, ldem.mesh.summarizeModel. + +arguments + barProps (1,1) struct + params (1,1) ldem.Parameters +end + +[delta, alpha] = ldem.material.latticeCoefficients(params.poissonRatio); +normalStiffness = alpha * params.youngModulus * params.moduleLength^2; +diagonalFactor = (2.0 * delta * (4.0 / 3.0)) / sqrt(3.0); +criticalLength = params.criticalDistance * 2.0 * params.failureAreaFactor / alpha; + +summary = struct(); +summary.youngModulus = params.youngModulus; +summary.poissonRatio = params.poissonRatio; +summary.density = params.density; +summary.waveSpeed = params.waveSpeed; +summary.fractureEnergy = params.fractureEnergy; +summary.criticalDistance = params.criticalDistance; +summary.failureAreaFactor = params.failureAreaFactor; +summary.delta = delta; +summary.alpha = alpha; +summary.normalStiffness = normalStiffness; +summary.diagonalStiffness = normalStiffness * diagonalFactor; +summary.criticalLength = criticalLength; +summary.ruptureRatioNormal = criticalLength / params.moduleLength; +summary.baseCriticalStrain = sqrt(params.fractureEnergy / (params.youngModulus * params.criticalDistance)); +summary.criticalStrainMean = barProps.criticalStrainMean; +summary.criticalStrainCv = barProps.criticalStrainCv; +summary.criticalStrainMin = min(barProps.criticalStrain); +summary.criticalStrainMax = max(barProps.criticalStrain); +end diff --git a/src/+ldem/+mesh/buildMesh.m b/src/+ldem/+mesh/buildMesh.m index 4b27e72..12963c2 100644 --- a/src/+ldem/+mesh/buildMesh.m +++ b/src/+ldem/+mesh/buildMesh.m @@ -39,9 +39,9 @@ end nodes = ldem.mesh.buildNodes(params.nModules, params.moduleLength); -if params.meshPerturbation.enabled +if params.meshPerturbation > 0 nodes = ldem.mesh.perturbNodes(nodes, params.nModules, params.moduleLength, ... - params.seed, params.meshPerturbation.cv); + params.seed, params.meshPerturbation); end mesh = struct(); diff --git a/src/+ldem/+mesh/perturbNodes.m b/src/+ldem/+mesh/perturbNodes.m index d11804b..7aa3f1d 100644 --- a/src/+ldem/+mesh/perturbNodes.m +++ b/src/+ldem/+mesh/perturbNodes.m @@ -23,8 +23,9 @@ % % Note: the legacy code contains this feature but disables it (it sets % LABELN=1 and immediately LABELN=0), so the legacy results correspond to -% no perturbation. ldem.Parameters.meshPerturbation.enabled is false by -% default for the same reason. +% no perturbation. ldem.Parameters.meshPerturbation is 0 (off) by default +% for the same reason; a positive value switches the perturbation on and is +% used as cv. % % Legacy: IMPERF. % diff --git a/src/+ldem/+mesh/summarizeModel.m b/src/+ldem/+mesh/summarizeModel.m new file mode 100644 index 0000000..8eb42b6 --- /dev/null +++ b/src/+ldem/+mesh/summarizeModel.m @@ -0,0 +1,61 @@ +function summary = summarizeModel(mesh, params) +%SUMMARIZEMODEL Size and mass of the model, for the results file. +% +% summary = ldem.mesh.summarizeModel(mesh, params) collects the counts that +% describe the lattice, so that a results file documents the model that was +% simulated. +% +% Fields of summary: +% +% testId Test number. +% nModules [Mx My Mz], number of cubic modules along x, y and z. +% moduleLength Edge of a module [m]. +% nNodes Total number of nodes. +% nGridNodes Nodes at the corners of the modules. +% nCentreNodes Nodes at the centre of the modules. +% nBars Total number of bars. +% nGridEdges Bars along the edges of the modules. +% nCentreBars Bars between neighbouring centre nodes. +% nDiagonals Bars from a centre node to a corner. +% nFixedDofs Number of degrees of freedom held by the scenario. +% totalMass Sum of the nodal masses [kg]. +% prismVolume Volume of the prism [m^3]. +% controlNodes Control nodes of the output. +% +% Inputs: +% mesh Struct from ldem.mesh.buildMesh. +% params ldem.Parameters. +% +% Output: +% summary Struct with the fields above. +% +% Example: +% model = ldem.mesh.summarizeModel(mesh, params); +% +% Legacy: the geometry and counting block of WRICON. +% +% See also ldem.mesh.buildMesh, ldem.material.summarizeMaterial. + +arguments + mesh (1,1) struct + params (1,1) ldem.Parameters +end + +modules = params.nModules - 1; + +summary = struct(); +summary.testId = params.testId; +summary.nModules = modules; +summary.moduleLength = params.moduleLength; +summary.nNodes = size(mesh.nodes0, 1); +summary.nGridNodes = mesh.nGridNodes; +summary.nCentreNodes = size(mesh.nodes0, 1) - mesh.nGridNodes; +summary.nBars = size(mesh.bars, 1); +summary.nGridEdges = nnz(mesh.barType == 1); +summary.nCentreBars = nnz(mesh.barType == 2); +summary.nDiagonals = nnz(mesh.barType == 3); +summary.nFixedDofs = nnz(mesh.fixed); +summary.totalMass = sum(mesh.mass); +summary.prismVolume = prod(modules) * params.moduleLength^3; +summary.controlNodes = params.controlNodes; +end diff --git a/src/+ldem/+post/plotEnergy.m b/src/+ldem/+post/plotEnergy.m index 942394d..115a322 100644 --- a/src/+ldem/+post/plotEnergy.m +++ b/src/+ldem/+post/plotEnergy.m @@ -2,8 +2,8 @@ %PLOTENERGY Plot the energies of a simulation versus time. % % ax = ldem.post.plotEnergy(results) draws the kinetic, elastic, damage and -% damping energies, and their sum, in the current axes (a new figure if -% there are none). +% damping energies, their sum (internal) and the external work, in the +% current axes (a new figure if there are none). % % ax = ldem.post.plotEnergy(results, ax) draws in the given axes. % @@ -39,8 +39,9 @@ end plot(ax, e.time, e.kinetic, e.time, e.elastic, e.time, e.damage, e.time, e.damping, ... - e.time, e.internal, 'k--', 'LineWidth', 1.2); -legend(ax, 'Kinetic', 'Elastic', 'Damage', 'Damping', 'Total', 'Location', 'best'); + e.time, e.internal, 'k--', e.time, e.external, 'r:', 'LineWidth', 1.2); +legend(ax, 'Kinetic', 'Elastic', 'Damage', 'Damping', 'Internal (sum)', 'External work', ... + 'Location', 'best'); xlabel(ax, 'Time [s]'); ylabel(ax, 'Energy [J]'); title(ax, 'Energies'); diff --git a/src/+ldem/+scenarios/FourPointBending.m b/src/+ldem/+scenarios/FourPointBending.m index 9d86cc3..1a58f2b 100644 --- a/src/+ldem/+scenarios/FourPointBending.m +++ b/src/+ldem/+scenarios/FourPointBending.m @@ -1,24 +1,25 @@ classdef FourPointBending < ldem.scenarios.Scenario - %FOURPOINTBENDING Beam with two supports and a load point (TEST 102). + %FOURPOINTBENDING Beam with two supports and two load points (TEST 102). % - % The beam is supported near both ends. A load point on the top face, - % 33.5 modules from the right end, is moved down with a constant - % velocity. + % The beam is supported near both ends on the bottom face. Two load + % points on the top face are moved down with a constant velocity. % - % The positions are expressed in module units, as in the legacy code - % (supports at 4 modules from each end, load points at 33.5 modules - % from each end), so the scenario only makes sense for beams longer - % than about 70 modules. + % Positions are measured in modules along the beam axis, from the nearest + % end of the beam, and select the line of centre nodes closest to that + % position (windows of +-0.01 modules). Because the centre nodes lie at + % half-integer positions, use values such as 4.5 or 33.5. The defaults are + % the values of the legacy code, which only fit a beam longer than about + % 70 modules. If a position does not match any node, fixedDofs throws + % ldem:scenarios:noNodesSelected. % - % Behaviour reproduced from the legacy code (see - % legacy/KNOWN_ISSUES.md, items 5 and 11): there are two load points - % and both are held in y, but only the right one is actually moved; - % the left one stays at its initial height and acts as a support. + % Create it with other values using + % scenario = ldem.scenarios.FourPointBending( ... + % supportPosition=2.5, loadPosition=10.5, loadingVelocity=1e-3); % - % Create it with a different velocity using - % scenario = ldem.scenarios.FourPointBending(loadingVelocity=1e-3); - % - % Legacy: the "TEST == 102" branches of BOUND, CALOAD and CALRES. + % Legacy: the "TEST == 102" branches of BOUND, CALOAD and CALRES. The + % legacy CALOAD only moved the right load point (a wrong condition left the + % other one acting as a support); this was corrected in the original code and here + % (docs/known-issues/KNOWN_ISSUES.md, item 15). % % See also ldem.scenarios.Scenario. @@ -29,11 +30,17 @@ properties % Downward velocity of the loaded nodes [m/s]. Legacy: VF2 = 400e-5. loadingVelocity (1,1) double {mustBeFinite} = 400e-5 + + % Distance from each end of the beam to the support [modules]. + supportPosition (1,1) double {mustBePositive, mustBeFinite} = 4.5 + + % Distance from each end of the beam to the load point [modules]. + loadPosition (1,1) double {mustBePositive, mustBeFinite} = 33.5 end methods function obj = FourPointBending(props) - %FOURPOINTBENDING Create the scenario, optionally with a new velocity. + %FOURPOINTBENDING Create the scenario, optionally with other values. arguments props.?ldem.scenarios.FourPointBending end @@ -46,52 +53,31 @@ function fixed = fixedDofs(obj, nodes0, params) %FIXEDDOFS Supports and load points of the beam. % - % Fixes x and y at the left support, y at the right support, - % and y at the two load points on the top face (the y-motion - % of the right one is then imposed by applyLoads). + % Fixes x and y at the left support, y at the right support and + % y at the two load points on the top face (the y-motion of the + % load points is then imposed by applyLoads). arguments - obj (1,1) ldem.scenarios.FourPointBending %#ok + obj (1,1) ldem.scenarios.FourPointBending nodes0 (:,3) double params (1,1) ldem.Parameters end - LCO = params.moduleLength; - M1 = params.nModules(1) - 1; - N1 = params.nModules(2) - 1; - x = nodes0(:, 1); - y = nodes0(:, 2); - - leftSupport = (y > (0.49 * LCO)) & (y < (0.51 * LCO)) & ... - (x < (4.51 * LCO)) & (x > (4.49 * LCO)); - rightSupport = (x > ((M1 - 4.51) * LCO)) & (x < ((M1 - 4.49) * LCO)) & ... - (y < (0.51 * LCO)) & (y > (0.49 * LCO)); - - loadRight = (x < ((M1 - 33.49) * LCO)) & (x > ((M1 - 33.51) * LCO)) & ... - (y < ((N1 - 0.49) * LCO)) & (y > ((N1 - 0.51) * LCO)); - loadLeft = (x < (33.51 * LCO)) & (x > (33.49 * LCO)) & ... - (y < ((N1 - 0.49) * LCO)) & (y > ((N1 - 0.51) * LCO)); - + s = obj.selectNodes(nodes0, params); fixed = false(size(nodes0)); - fixed(leftSupport, 1) = true; - fixed(leftSupport | rightSupport | loadRight | loadLeft, 2) = true; + fixed(s.leftSupport, 1) = true; + fixed(s.leftSupport | s.rightSupport | s.loadLeft | s.loadRight, 2) = true; end function loaded = loadedNodes(obj, nodes0, params) %LOADEDNODES Logical vector of the nodes that are moved down. % - % Only the load point at 33.5 modules from the right end (see the - % class description). + % The centre nodes of the two load lines on the top face. arguments - obj (1,1) ldem.scenarios.FourPointBending %#ok + obj (1,1) ldem.scenarios.FourPointBending nodes0 (:,3) double params (1,1) ldem.Parameters end - LCO = params.moduleLength; - M1 = params.nModules(1) - 1; - N1 = params.nModules(2) - 1; - x = nodes0(:, 1); - y = nodes0(:, 2); - loaded = (x < (M1 - 33.49) * LCO) & (x > (M1 - 33.51) * LCO) & ... - (y < (N1 - 0.49) * LCO) & (y > (N1 - 0.51) * LCO); + s = obj.selectNodes(nodes0, params); + loaded = s.loadLeft | s.loadRight; end function state = applyLoads(obj, state, mesh, params) @@ -123,4 +109,37 @@ reaction = [0, sum(state.force(atTop, 2)), 0]; end end + + methods (Access = private) + function s = selectNodes(obj, nodes0, params) + %SELECTNODES Masks of the support and load nodes; errors if one is empty. + LCO = params.moduleLength; + M1 = params.nModules(1) - 1; + N1 = params.nModules(2) - 1; + x = nodes0(:, 1); + y = nodes0(:, 2); + tol = 0.01; + + atBottom = (y > (0.5 - tol) * LCO) & (y < (0.5 + tol) * LCO); + atTop = (y > (N1 - 0.5 - tol) * LCO) & (y < (N1 - 0.5 + tol) * LCO); + nearLeft = @(position) (x > (position - tol) * LCO) & (x < (position + tol) * LCO); + nearRight = @(position) (x > (M1 - position - tol) * LCO) & (x < (M1 - position + tol) * LCO); + + s.leftSupport = atBottom & nearLeft(obj.supportPosition); + s.rightSupport = atBottom & nearRight(obj.supportPosition); + s.loadLeft = atTop & nearLeft(obj.loadPosition); + s.loadRight = atTop & nearRight(obj.loadPosition); + + for name = fieldnames(s).' + if ~any(s.(name{1})) + error('ldem:scenarios:noNodesSelected', ... + ['The %s of the beam test matches no node. The beam has %d modules ' ... + 'along x; supportPosition = %g and loadPosition = %g (modules from ' ... + 'each end) must fall on a line of centre nodes, e.g. 4.5 or 33.5, ' ... + 'and lie inside the beam.'], ... + name{1}, M1, obj.supportPosition, obj.loadPosition); + end + end + end + end end diff --git a/src/+ldem/+scenarios/UniaxialTension.m b/src/+ldem/+scenarios/UniaxialTension.m index 0ef607b..a076850 100644 --- a/src/+ldem/+scenarios/UniaxialTension.m +++ b/src/+ldem/+scenarios/UniaxialTension.m @@ -3,7 +3,9 @@ % % The centre nodes of the last column of the prism are moved along x % with a constant velocity, while the centre nodes of the first column - % are held in x. + % are held in x. The loaded nodes are also held in x, so the prescribed + % displacement is exact and the energy balance of the simulation closes + % (the work done on them is the external work). % % Sign convention (as in the legacy code): the loaded nodes move to % x0 - loadingVelocity*time, so a positive loadingVelocity pushes them @@ -13,7 +15,10 @@ % Create it with a different velocity using % scenario = ldem.scenarios.UniaxialTension(loadingVelocity=1e-3); % - % Legacy: the "TEST == 101" branches of BOUND and CALOAD. + % Legacy: the "TEST == 101" branches of BOUND and CALOAD. The legacy + % BOUND wrote the right-end condition with a misplaced parenthesis, so it + % selected no node and the loaded nodes were not held; this was corrected + % in the original code and here (docs/known-issues/KNOWN_ISSUES.md, items 3 and 19). % % See also ldem.scenarios.Scenario. @@ -41,11 +46,8 @@ function fixed = fixedDofs(obj, nodes0, params) %FIXEDDOFS Fix the x-motion of the centre nodes of both end faces. % - % NOTE (reproduces the legacy code): the right-end condition - % is written with the legacy operator precedence, - % (M1 - 0.51*LCO) instead of (M1 - 0.51)*LCO, so it selects no - % node and only the left end is fixed. See - % legacy/KNOWN_ISSUES.md, item 3. + % The first column of centre nodes is the support and the last + % column is the loaded one (its x-motion is imposed by applyLoads). arguments obj (1,1) ldem.scenarios.UniaxialTension %#ok nodes0 (:,3) double @@ -56,7 +58,7 @@ x = nodes0(:, 1); leftEnd = (x < (0.51 * LCO)) & (x > (0.49 * LCO)); - rightEnd = (x > (M1 - 0.51 * LCO)) & (x < (M1 - 0.49 * LCO)); + rightEnd = (x > ((M1 - 0.51) * LCO)) & (x < ((M1 - 0.49) * LCO)); fixed = false(size(nodes0)); fixed(leftEnd | rightEnd, 1) = true; diff --git a/src/+ldem/+solver/computeEnergies.m b/src/+ldem/+solver/computeEnergies.m index 7d9453d..ab5fb5c 100644 --- a/src/+ldem/+solver/computeEnergies.m +++ b/src/+ldem/+solver/computeEnergies.m @@ -14,6 +14,23 @@ % internal kinetic + elastic + damage + damping. % brokenBars Total fracture energy of the bars that have broken. % damageRate Change of the damage energy per unit time since the previous step [W]. +% external Work done so far by the supports and the prescribed motion (state.externalEnergy). +% balance external - internal: the part of the work that is not accounted for. +% +% Energy balance. In a model whose loading acts on degrees of freedom fixed +% by the scenario, the balance is close to zero: the external work becomes +% kinetic, elastic, damage or damping energy. It is not exactly zero because +% the scheme is second-order accurate and because the kinetic energy of the +% prescribed nodes (which the outside world supplies) is included in +% kinetic like in the legacy code; both effects are small. Judge the balance +% relative to the final external work: in the reference tests it is between +% 0.01 % and 0.5 % (it shrinks with the number of steps, because the scheme +% compares the work of the last step with the energy at its end, an error of +% about 1/N for energies that grow like t^2). +% +% The balance does not close when the loaded nodes are not held by the +% scenario, as in the legacy tension test (see +% ldem.scenarios.UniaxialTension). % % For a damaged bar with critical strain EP, largest strain EM and % stiffnesses E1 (compression) and E2 (tension), the energy dissipated is @@ -34,9 +51,12 @@ % % Legacy: ENERG2. There the kinetic and damping energies were vectors (one % entry per node) that were never summed; here they are scalars. The -% external work (ENEX) was never computed and is not provided. +% external work (ENEX) was never computed in the legacy code. +% +% The kinetic energy of each node is available from +% ldem.solver.nodalKineticEnergy. % -% See also ldem.solver.simulate. +% See also ldem.solver.simulate, ldem.solver.nodalKineticEnergy. arguments state (1,1) struct @@ -46,8 +66,7 @@ end % Kinetic energy. -speedSquared = state.velocity(:, 1).^2 + state.velocity(:, 2).^2 + state.velocity(:, 3).^2; -kinetic = sum(mesh.mass .* speedSquared ./ 2.0); +kinetic = sum(ldem.solver.nodalKineticEnergy(state, mesh)); % Elastic energy of the bars. E1 = barProps.stiffness; @@ -78,4 +97,6 @@ energy.internal = kinetic + elastic + damage + state.dampingEnergy; energy.brokenBars = brokenBars; energy.damageRate = (damage - state.previousDamageEnergy) / params.dt; +energy.external = state.externalEnergy; +energy.balance = state.externalEnergy - energy.internal; end diff --git a/src/+ldem/+solver/initialState.m b/src/+ldem/+solver/initialState.m index 381fdb0..4634e9e 100644 --- a/src/+ldem/+solver/initialState.m +++ b/src/+ldem/+solver/initialState.m @@ -29,6 +29,8 @@ % axialForce nBars-by-1 axial force [N], tension positive (legacy F). % history Damage state of the bars. % dampingEnergy Energy dissipated by damping so far [J]. +% externalEnergy Work done by the supports and the prescribed motion so far [J]. +% previousForce nNodes-by-3 nodal force of the previous step [N]. % previousDamageEnergy Energy dissipated by damage at the previous step [J]. % % Example: @@ -59,5 +61,7 @@ state.axialForce = zeros(nBars, 1); state.history = history; state.dampingEnergy = 0.0; +state.externalEnergy = 0.0; +state.previousForce = zeros(nNodes, 3); state.previousDamageEnergy = 0.0; end diff --git a/src/+ldem/+solver/integrateStep.m b/src/+ldem/+solver/integrateStep.m index ad410c2..971b503 100644 --- a/src/+ldem/+solver/integrateStep.m +++ b/src/+ldem/+solver/integrateStep.m @@ -17,6 +17,18 @@ % differences, the energy dissipated by damping is accumulated and the two % stored positions are shifted (current -> previous, next -> current). % +% External work. A degree of freedom fixed by the scenario follows a +% prescribed path (a support does not move, a loaded node moves with the +% loading velocity). The force that the outside world exerts on it is minus +% the bar force, so the work done on the structure in the step is +% -F*(u - u_prev), with F the average of the bar force of this step and of the +% previous one (trapezoidal rule). It is summed over the fixed degrees of +% freedom: zero for a support that does not move, positive when a prescribed +% motion pushes the structure. The inertia of the prescribed nodes is not +% included; it is negligible against the energy of the structure. Adding up +% the steps gives the external work, which balances the kinetic, elastic, +% damage and damping energies (see ldem.solver.computeEnergies). +% % The energy dissipated in the step has two parts: the mass-proportional % damping of the nodes, c*(m/2)*v*(u_next - u_prev), and the viscous term % of the constitutive law, E*CON*rate^2*dt*L for every bar (E is the @@ -31,7 +43,7 @@ % % Output: % state Updated: displacement, previousDisplacement, velocity, -% acceleration and dampingEnergy. +% acceleration, dampingEnergy, externalEnergy and previousForce. % % Errors: % ldem:solver:zeroMass A node has zero mass. @@ -83,6 +95,12 @@ state.strainRate .* dt .* mesh.barLength ./ 2.0); dissipated = dissipated + sum(barViscous); +% Work of the outside world on the fixed degrees of freedom (trapezoidal rule). +averageForce = (state.force(mesh.fixed) + state.previousForce(mesh.fixed)) / 2.0; +externalWork = -sum(averageForce .* (u(mesh.fixed) - uPrev(mesh.fixed))); + +state.externalEnergy = state.externalEnergy + externalWork; +state.previousForce = state.force; state.dampingEnergy = state.dampingEnergy + dissipated; state.previousDisplacement = u; state.displacement = uNext; diff --git a/src/+ldem/+solver/nodalKineticEnergy.m b/src/+ldem/+solver/nodalKineticEnergy.m new file mode 100644 index 0000000..c49b1d2 --- /dev/null +++ b/src/+ldem/+solver/nodalKineticEnergy.m @@ -0,0 +1,31 @@ +function energy = nodalKineticEnergy(state, mesh) +%NODALKINETICENERGY Kinetic energy of every node. +% +% energy = ldem.solver.nodalKineticEnergy(state, mesh) returns the kinetic +% energy [J] of each node, m*|v|^2/2, with the lumped mass of the node and +% its current velocity. The kinetic energy of the whole model is the sum of +% the vector (it is energy.kinetic of ldem.solver.computeEnergies). +% +% Inputs: +% state Solver state (uses velocity). +% mesh Struct from ldem.mesh.buildMesh (uses mass). +% +% Output: +% energy nNodes-by-1 vector [J]. +% +% Example: +% perNode = ldem.solver.nodalKineticEnergy(state, mesh); +% total = sum(perNode); +% +% Legacy: ENCN of ENERG2, which was left as a vector and never summed. +% +% See also ldem.solver.computeEnergies. + +arguments + state (1,1) struct + mesh (1,1) struct +end + +speedSquared = state.velocity(:, 1).^2 + state.velocity(:, 2).^2 + state.velocity(:, 3).^2; +energy = mesh.mass .* speedSquared ./ 2.0; +end diff --git a/src/+ldem/+solver/simulate.m b/src/+ldem/+solver/simulate.m index 9cdcce7..1e7e415 100644 --- a/src/+ldem/+solver/simulate.m +++ b/src/+ldem/+solver/simulate.m @@ -91,7 +91,8 @@ record.energy = struct('time', zeros(nEnergyRows, 1), 'kinetic', zeros(nEnergyRows, 1), ... 'elastic', zeros(nEnergyRows, 1), 'damage', zeros(nEnergyRows, 1), ... 'damping', zeros(nEnergyRows, 1), 'internal', zeros(nEnergyRows, 1), ... - 'brokenBars', zeros(nEnergyRows, 1), 'damageRate', zeros(nEnergyRows, 1)); + 'brokenBars', zeros(nEnergyRows, 1), 'damageRate', zeros(nEnergyRows, 1), ... + 'external', zeros(nEnergyRows, 1), 'balance', zeros(nEnergyRows, 1)); nTracked = nSteps * trackBar; record.trackedBar = struct('bar', params.trackedBar, 'time', zeros(nTracked, 1), ... 'strain', zeros(nTracked, 1), 'criticalStrain', zeros(nTracked, 1), ... diff --git a/src/+ldem/Parameters.m b/src/+ldem/Parameters.m index 2f8745f..43a0310 100644 --- a/src/+ldem/Parameters.m +++ b/src/+ldem/Parameters.m @@ -95,10 +95,13 @@ % Legacy: file "arquivo_3lc_rnao_cv05". randomFieldFile (1,1) string = "" - % Optional random perturbation of the node coordinates. - % enabled: apply it; cv: standard deviation as a fraction of the - % module length. Legacy: LABELN (always 0) and CVUVW = 0.02. - meshPerturbation (1,1) struct = struct('enabled', false, 'cv', 0.02) + % Random perturbation of the node coordinates, as the standard + % deviation expressed as a fraction of the module length. 0 (the + % default) switches the perturbation off; any positive value + % switches it on with that value (for example 0.02 displaces the + % nodes by about 2 % of the module length). Legacy: LABELN (always + % 0, so the legacy results have no perturbation) and CVUVW = 0.02. + meshPerturbation (1,1) double {mustBeNonnegative, mustBeFinite} = 0 % How often each result is stored, in time steps (0 = never): % @@ -188,22 +191,13 @@ function validate(obj) 'output.trackedBarEvery must be 0 or 1 (the tracked bar is stored at every step).'); end - % Mesh perturbation settings. - mp = obj.meshPerturbation; - if ~isequal(sort(fieldnames(mp)), sort({'enabled'; 'cv'})) || ... - ~(isscalar(mp.enabled) && (islogical(mp.enabled) || isnumeric(mp.enabled))) || ... - ~(isnumeric(mp.cv) && isscalar(mp.cv) && mp.cv >= 0 && isfinite(mp.cv)) - error('ldem:params:badMeshPerturbation', ... - 'meshPerturbation must be a struct with a logical "enabled" and a non-negative "cv".'); - end - % Time integration. if obj.totalTime < obj.dt error('ldem:params:totalTimeTooShort', ... 'totalTime (%g s) must be at least one time step (dt = %g s).', ... obj.totalTime, obj.dt); end - if ~obj.meshPerturbation.enabled && obj.dt > obj.criticalTimeStep + if obj.meshPerturbation == 0 && obj.dt > obj.criticalTimeStep error('ldem:params:unstableTimeStep', ... ['The time step dt = %g s is unstable. For moduleLength = %g m, ' ... 'youngModulus = %g Pa and density = %g kg/m^3 it must not exceed ' ... diff --git a/src/+ldem/runSimulation.m b/src/+ldem/runSimulation.m index 40a745a..e66a456 100644 --- a/src/+ldem/runSimulation.m +++ b/src/+ldem/runSimulation.m @@ -32,6 +32,8 @@ % % info Version of ldem, date, MATLAB release, run time. % params Input parameters (plain struct, derived values included). +% model Counts and mass of the model (ldem.mesh.summarizeModel). +% material Material data and statistics (ldem.material.summarizeMaterial). % mesh Nodes, supports, masses, bars and bar geometry. % barProps Constant properties of the bars. % controlNodes Motion of the control nodes versus time. @@ -39,7 +41,7 @@ % energy Energies versus time. % trackedBar History of the bar params.trackedBar (may be empty). % snapshots Compact copies of the state at the snapshot steps. -% final Final state of nodes and bars. +% final Final state of nodes and bars, with the kinetic energy of each node. % % The fields of each part are described in ldem.solver.simulate, % ldem.mesh.buildMesh, ldem.material.buildBarProperties and @@ -104,6 +106,8 @@ 'matlabRelease', string(version('-release')), ... 'elapsedSeconds', toc(timer)); results.params = params.toStruct(); +results.model = ldem.mesh.summarizeModel(mesh, params); +results.material = ldem.material.summarizeMaterial(barProps, params); results.mesh = mesh; results.barProps = barProps; results.controlNodes = record.controlNodes; @@ -111,7 +115,7 @@ results.energy = record.energy; results.trackedBar = record.trackedBar; results.snapshots = writer.finish(); -results.final = finalState(state); +results.final = finalState(state, mesh); if writeFiles && any(options.Formats == "mat") ldem.io.saveResults(fullfile(options.OutputFolder, "results.mat"), results); @@ -121,7 +125,7 @@ end end -function final = finalState(state) +function final = finalState(state, mesh) %FINALSTATE Fields of the solver state worth keeping after the run. final = struct( ... 'step', state.step, ... @@ -129,6 +133,7 @@ 'displacement', state.displacement, ... 'velocity', state.velocity, ... 'acceleration', state.acceleration, ... + 'kineticEnergy', ldem.solver.nodalKineticEnergy(state, mesh), ... 'force', state.force, ... 'strain', state.strain, ... 'axialForce', state.axialForce, ... diff --git a/tests/TestLdemPath.m b/tests/TestLdemPath.m deleted file mode 100644 index 8f18b7e..0000000 --- a/tests/TestLdemPath.m +++ /dev/null @@ -1,22 +0,0 @@ -classdef TestLdemPath < matlab.unittest.TestCase - %TESTLDEMPATH Check that the main routines are on the path and documented. - properties (TestParameter) - routine = {'ini_DEM3','CALOAD','CALRES','BOUND','CONECTI', ... - 'INTCO1','RMEC','ENERG2','read_dat0','prepvar'} - end - methods (TestClassSetup) - function addSource(testCase) - root = fileparts(fileparts(mfilename('fullpath'))); - testCase.applyFixture(matlab.unittest.fixtures.PathFixture( ... - fullfile(root, 'legacy'))); - end - end - methods (Test) - function routineExists(testCase, routine) - testCase.verifyEqual(exist(routine, 'file'), 2); - end - function routineHasHelp(testCase, routine) - testCase.verifyNotEmpty(help(routine)); - end - end -end diff --git a/tests/fixtures/README.md b/tests/fixtures/README.md new file mode 100644 index 0000000..a4fe488 --- /dev/null +++ b/tests/fixtures/README.md @@ -0,0 +1,13 @@ +# Golden-master fixtures + +`tension101_elastic.mat`, `tension101_damage.mat` and `bending102.mat` hold the +results of three small simulations run with the original MATLAB code (the +`legacy/` folder, translated from Fortran), after correcting its obvious bugs +(see `docs/known-issues/KNOWN_ISSUES.md`). The case definitions are in +`tests/tools/referenceCases.m`. + +The regression tests in `tests/regression` compare the `ldem` package with +these files (relative tolerance 1e-9). The original code is not in the working +tree; it is in the git history under the tag `legacy-reference`, together with +the tools that generated the fixtures (`tests/tools/generateReference.m`). +Change a fixture only on purpose, and say why in the pull request. diff --git a/tests/fixtures/bending102.mat b/tests/fixtures/bending102.mat index bc752228e9c5401396d3e8c2a2cba3de7a7e5690..5b95297e99bf9b94d0f1db26fc4d2a315453898c 100644 GIT binary patch delta 448183 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%0DjJCT8~b?=Bn{rjp+Q5=ANTsc?`Qc9AW4fG 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≪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

    a|(vJf( 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%0AH+ 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%0Dd;O7A~y^ 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 delta 452707 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�ReipA4Dsvcy-B|lg}H$Y!I%N! zn%%+Hq8W54z$#V?oCwjb;Q)auL-NBXsSV!_SBibhZ*hI}z|4HzM9?VIJx!k@pI|bM zf0>*b##--j(F4UYP^^_^{VFOk5T#mXlGif|&8*GbH)gBS z(leR0`8h+*W`wMGB*9WPi`<}g=>E4JzHxGc?%-VrRUIt&Rx06C$qR-@iL#?o(@dowA8AY}i zk*(v>MFqDnjy$^%qfQZ8zWT`qp=*msSZjr2TpHW(f9`M3&mHf8$>cYAk21~(9k zA1}pc=u)X{XX`IR+6!M+k{u;0hkWwau0K62SWRy!-`GZ5+31~rxOwQP`(caa0aG-R zOR~H;i@!kc9@4=}8T0Dh`&_rN5-T*R<^!$u(wa7BbWhb7LO8Y1Wv5imlRbWLS<2iI z22m;C6Z3nbqs)g^vyz^BW?1uB;LMx08|VB^o(Pe=zoxQ4(lMTleVuJ`JD5DknF+ZP zMK>&BUJ>>7)V7pz{?g@B{^b`b z`Kf0{$7T_vWbQ~&Xq(!AVNdA{FGtPX`+*_YNs(NyS(mh}tCWi!$R2E8-Uo*@7iJ#TZ9`qXG(&qlC>jn=Hyc#y?fQWTVuLu=eemn`HbL-vRzTj9e ztCb-WA-{ZnW#U^PGg0o)uL_5ixn*|tt*5@I3+cI_stljF0>|l_o#ZvFDC4Vq+YqzE z5HBHqw*T^sIi=29xK2HIxGd~`qF&kI#l&Pt?3X~Z^^(+LdBlA%IcT|QlR(jtsx+p>=*2l_5 z+k~EN$yViVomfJOqyBH42o8HL+~OdV2z^d(INoaHvS0UbAzfU_`duQCxAbf1*-6es zNsYzCV_P=cD};}>u2zS4*(i2>KH}ulB_0@-n}1QLOVcrSiX-1{k`8e;EAp1m`VEO~ z7-1XKGtVaY%MZ_&#;5*_yD736H0f8|PVQs~H3V;n!@P1+7%L&3FVpP4w%v4pQn3$n zqNY9n^Oq}CO>%Pu-uk4E@IZqu^7uq^O_G<{t}0^ezm;Mo-8wT3*~(3j%q1KSo_1flE-Gz->WHl?rIxXFxZrP28C zw52lLN|q`i)MiNDlfAFunngKF4_$P+jB+kvTB@9-rs+zmcYkipD+)6hbZLiGCjV+5 z`gjv7L+#e_y7F2d#E)LWxa3@>OPy5L(X&rF>C1ReQ4TLXHxiVWT8>M*F#$_1(;fS~ zLp5H~{)&7%%**A95+?SSs1@0$DkS}v*Vmk@*f)A(TWd1iRCdiEtyqKQSLn{dp4TG zQhqNFy<@gRtey#p9pVrp@1wX?w}K(=H^l_VqF$sE^e56ATr)9Vz1~gC))w}gvM26$ zn?f39{+m5MUrlxQ(+cI;UYj*p9FP_^N1MGTQ_`VK*yYseg?>zP)lOXOV_0OuHayJ1 zWhXXJj&`|}jwwETQMDkB_r||X@PEpD5!frBg8!R;M zgjM?M-+Ck4nb?5P+JWC)!nfSpDri_F^Gqg#ZBO>13{+aiJneqvu5S^1irF4~`uyy& zRK9uiwRLN09mw$V5Ik?XSTpcU;lt5}j$#hvw375^&iOUz>aaSq)AeJdi_OH~X8#eg zxge~n;7pj1F}A$(CGk6vTHEu_Dq^MPwCG-cs2>S$`DTH{@xH3K>u-m!ewD-+llYZNM zL|+_+U-&||5tm9-AM--?g7%pjXU?dH!Vp6hUD#m9D|L)FyN+nX$ zKbo4qvH_cJ$X^E5Q}M*zVl|Rk_R3KV@R^`(ekq;!?WE{V1-O#+aSz#s^^JHs-aJM= zL2hP{z#5|HTonWfZQ^9!ho31_*t9FCk*?l=%RXg3Mn2A8zyf~7$BbwhQkEPf$C z{?zU_<5D<=;1lDBn@AuFhcE%*VffkmoHW4j+|n_fz8dLw*ZX63kk08`I!1NU8e}ka zQTcBkuDt7eMqsBpe9!?9@x&?PSK5z|8&ozCg14yV{!=i96F`O7n_I>Jhh8s*3~Dy!RK0-{wW9;1~22NjU}rJ22n;mn1VTuoRF9y;T4dGc!!VJ)VJb z0Fzx~^FYFiX9{_lpnACo8KQ&m3j|Ml(i%B9ahwT#S_;A|K&cPbVecB+0T=Lf7>mJw zKy18V<{OdvJHuzZLVYqo(8xi^@LmRkBBoHh0v6a)VJBqV1@=1MEfUp5fIYd+c_Jp@ z9sm~?Mf?VA`i^Eo9P)tC{5w0agj9<8g!2U2EIzp~QfJz8E zLWW0zS5>gbCk5=;Yrj4PXM7EU+GhoW7a*uk;VC#z{$Hs79U-LwMQ?>V2^qeX09ZIf zFkWFEX-~R3^_U5VeEgDh)l2D2!PnG|bTw2B?BW1m1;-bOm|s7@c9ga+Ucns!M$nAQ zF9N&!Z2;VQ%8ry{D+p+{2&#shzJg@6QB*^jJ7DizbWb%@&PI!U;G+QUd18JOBod5#al^Z3`izbp9`OxHdvY6R>ybeJD6nLIy_N zU5gOtM1Ni4gh65yAAk|LB8hvR2Mprg*^_>M1nl{;7=cBQ72hi&07Vi2mN;ui`pwRa zLpJ}&gfjQZ!Qd@mXJRb?V09maA2fp8&J}q~!4KR4GpUm6FbO0e+-~1s3VzG718}Hx z9fy1?3<1iRfnxkYQcWU>7!|;i!8am?7rYuNl3sp3LOyXEgx5X?nFLww;{Z`cA0c@F z`$-@tJK&fs8zI91Y=;A#0zbY6)AppC8Cn2I5Qyyf?_fF;iUv;RfYfWBfY)n-@b@a< zm0}QrM<#y(ngh18{^lRB{ujHoZ@}``ha6Q_I22cVxY{2u}4UG&IM47fUguFYrWfmuFWlgJ`}{Q z1DJ5!0Zy&K0AFfPdI<`tnI6#mxAZ{Q*uD!=9e0Ej0OXoIJyU=Ia$f^Sa$tWG?;;Vx zxB=Z<(7Ln$-gtDt$hiW*{X`95j)0_rw9nCkWW5CC_nLeMG>E^&@MI9)tqTP9VfEj7 zEst2xGg8^sVe6od#RHF!C%~0>$l^j$z7l^DM1=>z2XciYVKppMS0!HrxtDvK$-d=}20M>Fy@H0r^4hZNk z$b0_-X=hKd1G5$ZMh0AN?!X?@E&?`z(mVbp5I}kZfENMavSPq81sbRf@t4L(;x|2J z-~v?I@ZZ!^tiw3}=A)Sohx7t5C&}KyAq$KEQf6Tg10$G{J_r2+x?Tw8-kyRcv7Pll z0=``Y1ZZYLk3lY*IWwX1G8Q0Jq=G$(`>(iqaiAx@0#SUuwgc1W0x9$3+JO=Nigr;8 zv__CbHLFWIurPQC&;{sPFaCB!z>_aPUJG=<2k;&jf%gqY;0NM*`9IC}fY!G3_dU#M z5Y7XP4Tu21;Tv;+^p(X-r($-OsmyoIy(GE2d;OIdv4H}Y`UhW5T3U{)2CNVgD0dlD zvz&lL?A@z4lCW!g!Q-V-@=H2Cl)<=!DKlSRyQ!D7YP z9=cG~?I8?}joT{+#|jne(tb~ENWI<{oH+G;Ozip*%hLR3TLcjzbDjyP+9>c{QmngSs`MYQyn+6Vd4zj8- z$}&x(NBNC=H~TN|XuH>5@; zEA_&z*;>rYHi5Qs;X-9$;T{~;U;8$M6}~&d_~X^rn5D&?6^tGWYx!_%Gs>M-p1JqR zn#}B(oG?vbg_0fC4&!*5D!;nqY)2i5^qvOC{wF@sIDf3?yfW3ooAr@(`HRt)vtI+N z@PbZ1&7Hv}6iQsmX2P%RqIrHNv{i#?Npdujqbk?15D@T~>Fezib5p3}&Nz`?yY&>Q zOB~}Ra1R}lF(?TghAY<_EJQz|z8t3Uy@sRoo}-X){pw_!MXy&5;$tGuvQDSeqkvxK z#>&T^sI!u5f22?d3+neuSS#n2^^Uu+3ybw~D>|gVMKv^9O9|V`3i+^GLruuVRkBpv zE**X(<>38@tnQJQhwDMj{q02cM8~#x$4;ie>*ly{!uK$gEn2>-*qrk@N+GSvu_qXk z$LGH2{b#y}s65+K-jwNj<&w~Bf5Mn3N4rhoa$636?ur|f4Z*(P*H4N0M=$5Dw zZk$Pr)yL2sP}}y@v#i-eIwQM+XRZ&~ZTtQ?^5&hmqvK~omh{t@`4IPw1$PTKB>#Sh zGbjUtvv!z7FidP`pS&@XZX2=bj!YNn_hr)9 zu}+ccqo^O__A;40@ngc|Q|c~p4Js?A(=@ci8M3C|<8W-1Cdre_i{R z5TsP_QBix8rN@>A$974S^_F|w)3k_JJt*Pgl)WXi&Vl?(!9J+B|EX$GYwvt-zld)N zK?&=gB|qyIuty<#{&YwL;Rm>1HB# z^U&j#YEf4WZ}0A9=t9ho%#^2&cF|6^3N4>sm-39Aq8&3A51*u~SZKNb|+#AL8I3CFv8qquNus6KQ##Cc*Ui1FgVobea_NjUg= zySFCU*^qA=rxYo`74N7VrrW!lc%g}3YX;Ta+r{HQU%pyEK%zdPN!UQWENf@1rd@&r zvj4lj9PeQIfLDM7=>Ti3eJ?Aw0nPQe&PV%^c+i{ITKz12bV^KAL*b)D^RSi0NvC?V zvfy5^j7bc%HB6P((41@;veP;GPB+$7%3kf%9&gQ%M@VC}pAqq6BZZR@p6-9HV4 z=ynwU+HA|&1AYI0dzs62;i?mdDz7Nn)`%|)?qqozLFXHDHY?}GU9a>fOh>`@6%cG1 zWDa%^-Jz)ApI>^<&sHoc3rF5}O_{BnZ|X3v+2t4vcE|aKPjY;ACUd z<&f3W@8D`<{YVRbj9P&J*u%lYxs z!@gfHSD@pV3vp=i#*5QMNx0@O<(-TlCDu+^>@vMXwzKPWWY+MRf*p1=wJCEqHcJ}T z4s}u?bsB=y_hHj&y5!jt&6}mp>Cbp1k<9O)1ea2mG(HbfiIS!KfY0|)!K-~^2wfo( zDY*IA)jATRSGBj}{ytuzfBewY53 zId(+p?VE71F;#h)7LR@GM_gkNIpx8-WY{uO3&Ar{$(=<7)DCMA##?$#-u@A+b+n=a zO}ASK;#JkYm8MgaCtm3E{bx2O%BH5a(^uJMMJ2@293_-_*#fc2mh!8oQ{K-I`l&;o zA@r=}`ZbApEe&4Dej8Ei41M!OjIT+X#db=$#+#v9j9%e+W}u61b+^G|)j_=jcS3j-_wI-G5F~r{ zkRY3o$a)-Rx zH^Vd8aI4Ez&92;hUbj&m-+0Aw2ilU!ewX})GekG1y?5gzO4>Y*cs^0omb6;z?SUG# zYwV|WYPtjWQ^^iXxcAQRS5k-*b4Ui^amI(9TejA-x?cT-b|oO~I^6z)w*T88$UH2ou1Y%1_tLp1V#nf=h`^{I1#FcM>kf z&E}`d91rHfYhj1FLodu&I3TUk)sB=ORGEF@gcbxD?07Zj8WvUD)(ExJKVX}c>HD-=?1;YZj$E?xR777< zac+~CbcrnUWv84^;*Vdl`XJJU?WLScqBu8zI^Cm^wl8*JpCtRdg0^OTJEH8+SF$6L ztnYMTn;kh!h1n&TxaAxwQTLO|e1E(|uRL)O-IMOZ(g4H6yAqQVJ>sSpjb5T%{Fkg! z5m(XJ#>ga!t$PxaI>4a`hp8o}1k-qtzhfm=5ZFlm5*@1q43ynNV|{EpB$(X3Em@_! zL|=K8@=GES!f*j6i7(Nb%3zNp8ycH_1)!9khOJuN3$#aHF)>|8+WsX8HbuQep9Cyf z&E1bI3yMmjIMNGqtZX0$&?z}2baU^cvCVS-zi&0*dr%AbCW}bge#d~uK7p8$%I-id zATGgRM^PhHV6KwGl=q$l#6<5!y=oG%*4k+(X@f(AdwyU^N`}#j$eW1+Z_8pHJFWyaGVS z6^ond#soQvMsS5YRz}pC<1KT175m;wJVWH*1!MaR|WG5U>-;n%uyV1N=!0>?aYy7 zG93St78kG@5Sg^i28`wcr3&AdU=nw~jK-pXX!M>sR62nDxApANC(%Gm(3{9IW$R`j zSc^c%%89=^6Jbs&%lZa1m`p`yh1E2m$r;#ZE4FM+UL18k0ZFCVy%9EEs9z!|M*jOY; zgtjh-;0iEms)){(2ORAJ5;^}`+PY}$+^I}rw*cW;4+-Ulu6D()UHw( zjV%E7JH90q-n|HT`WRVeJOR#4J#(mp1F&qS`D}nT6^BY4a8(tRWK9Q1vjEgXz}!^{ zT>)^p$zkdV8iiWel9eqmW^-R6krPZ`15|?4t|>WGJ^+WCz~R5UV>nDVxj?lI!~&kc z_6abrCIFg%Q)F2oh^-n3%;-L#`Y(ocT~Ho7Ao_~{^$GB!2oyK~l4t>G06B{yIwU4t z-vMGUfEa+39v}s90PY^(S{zV81+rZWTI4<8x&jyg`THq-bJa=!?6Oq+KaJ@_-<6~? zED+^umH@}fQ?P&om~Mar+>vGckUyw*XxU1H!*ud*s{_NPnZ+c?I!*+D#&eiD0`-fh z{I7kZLF^B}L9@s*37}f5O;C&K0D3%!=^@bHpX4R06<}YV1{5<0#m<}-jU65aF&2Ff zbQE280g+59qBVgC?2K8#QY{FQ7L?FWM&OHA&>rmqdT?r&T2dL*{sVB-3z~NuEjXp{ z5_g2D<_W$cv!o_RQgsYzNF6^JZ`~Hy}_o53T zqGeRHqSe2erEkSkN4{c+iF}rsQ&3K}y?*~io!J8&iaV$BH2!;atBxtFQ~0E@P23p% z_;d=~S17Tl^MioXP4=p@csg6OFc?OQAEGcz!$A z085ZyZ@RVxp%(SucnkS5KHzdKE)YZQW7m&|3XZANuZ0Qo-^f(18Bg_igzdDb86M8< zckzFH+imBdF$~s(_<>&6XHIThxUx8#;7_7tyyBoxSa@UGeYxMwa~j=Cm2sga!9zp= zfkhY{p~S_jQh9@!5^)~J^ONEoga3A$kUzg(lWv5BcFjGsT66HWy>HsWC3gt$lc92f zQQ_K`QZI7_a_0q9l8zj8JUACuBfRm~JLA;h(weFm;XD&PU6;v?rpwmR1ufO@PuVX} zRTEr4^(Vd0TPFNmIo(VVrnGF@GXALF*H`X7AhzVmpYbPVt#^s#bV>)?aS~2e9a>rB zAhtCIiK*cQbG>8qM}Ae~mpWKYJ1Kekp1!ad_$3&6rvW}=n^l{0sA}9VaI#_2dze)A z_H9FALfn7^NdfMw6!qK#aZ;)7{bTX=$#TWRZiKW+HPS=Qe=H>0w8*=M-myw|z4Nz) z#Xj~nu9by{!F9VZ(Ve|6p{_G+zp1Iol0nKE!X=&F9_uKK-#%%5r+(M;rNXyzg6$4{ z*FHuviujO-s`nYJBOk=7$`;0IL@_j1bKGkh6nQ2(x#Q3)92Ik+_;*beW4+dIo1y5U zFswvqNqvDh@xyA)Rzd73>=`Th6zjy{Q`=wFR(+O^1Wk*p*xlOEsempllE{!%nU^mN z5g*nG8QC8G+?tJEdA1SS+?Uuubs`ZqcFl^Z#L_*t**LIss@l~!08}4Q;5yZ%vs@Nw ztgve^x{`f(f9JXHv?uC!(!R!s1glLH>JFP-{=P91-WKhABiz_+Ba~YEq)XX!{g6!( zUtGL3tIg3*Z%JGE!ReBh7eIMHb*+`X*nT>f9LjIe1Y%vLKyD%|! zSu5Yh;=>X#s&H0(o=Z$_qszA}_ky)8v5;x*F3LK!7M{xXI&^=yXxl!9@k^=J@nH#T zq2SM)#_ZjwgFAv zYXtLM8=`*GjwBPxc;r*8}o{KU!KEY@PBx2jXhKzuRmbz7&|};*=^vTfMNNGD7=x?^x*C zCnt;6ZBQtXAJq`=itX*g^V~i`KV}l)_awEuDscyG6f4dRPl~~v9itR8G2a3fghgC zNWT!%T;2Cd%Khg{nmdLw(vSP$3HHZ>mc+56H@U}~wxeX|*G7+j+vHF&LW#;18WOPB zylXT%vKY+7!J~>gDTlKW{tHb-?<*Joq$vzDlw6x7R9t4=Ow@uqzZc5F;7sklA1hX~P}Vp>g`)nIlangmHzXaq znHZ;k;BEUjqd+~W5nJ%7Xt*L?FiiOkeawOGJsHgx~p)A!oj=Yz+zMn zpThMdp}_&-PP-S+-2pp|pfjV6BZ@#6R{(s@!xk}k?_*Rq{jAncqP-b+)j|9O>QQ_g z1N)U%=2*^H4N^s+&Hyx~(L&##xuCSOeien>ZMfl|(phDJOF>F;4Yc%C`>)$00zYCq8|gGZCEqa}PMnQ_yFaHJ`;)2A zC7+k5ZtL-&)95+GkBh+n<65HsF7(8=$iRe=m|kGT^`Zhz>>F2WJRJ?9RZM<<=$?#g zylRzjP;!V0C_wl3O?b4txS*9JA$#)kdwqDLV>OhW^dv?`(YMozY+c$h^!-VR?cGHK zDSeF~{sl?n5d(?U(n~yC%2fGMgNp4gltWvl5B6qyu185ir?js;>ky=G6JeqG_h<3O zx0hQ8H%s+Q6D!F43F{h!wz`_+M2BDA-D`p{dZ<%@r#~0p5%%r7R=!YiNJ)<8@4JU| z4SMh()FTVs%R5YwN4yJI*iQYCNFUP*`LNqAzp4J8!2BV-yAvAx5oP89wja&}i@Xy> zW6F-iGPI+h?8B#rFul!xcynKev3At5INwS@Hrd0zTOYxA$J)80l7(H1mraYNE<$ao zF24A&OGWGNaj|tf=+_vk9g0vM9Dh~^x+`mxpE_AOi`^e%qU#q%+7#`cT=Hq}PAd!z z@4sIcwBeJba;bo!+BUQKbDbiJS|Ww}a6a&$io+Fpc>m6&I))Yak0Nj3Lgg5b7V%nL z=a+Hs7_^G!y}lbOvn{seAnFWqNA%d^TZ1q$BB5iocNA2uyH~reGC2AH>d}aU+0Cf^aRPvNl+e_4|Xph*OlZrhxRC>u{;N?LHQI@StIgdGc4lkI+({d&oTFlsCn~o2xfYkNh5O;pXzLsWZIY znx>fGSG=&=ho?^wAu%pXmss}9Oke1SA-GF>ekX3Y(A6~VRyHRe>kP@9yio6%sM9l` z{Us!y$!8JsO(o-FmGPD8oz)Q}b2eAY2y<%|8e(;#C1j)e#>9G_WTm#Znmy|@Cy!qD0> zv3PdThe36lszXNsInU)|s-E6{ZZo@DYpz4f(#X(P{h$v`dPA`1sSuPE9b6V#L|~B< z&{zt`oBZL4KB(~WSh;OiPJ)RNT(;u-tTzZCn9y{UmoPl~)>5T;)yDJiAE z;VJm7=B$iJwKuIvqS*WU9`Jv!XExqxsJ3GW+MH;%(gT zA13YK3(`YtRW^G{1)3JKi`3ok5OzftQ^?O+QjRQZLiAYZYRsAM27!}tir>?d{4WKwc}#k!e^S<^Q`*o?I!e6B%{zo z`_t|jP5Wd8&)6X8chMiLAX;(9`1ta0>C(?kcPpgCZf9IN@yx(& zd<>{W*Bxj$nvPz#LO4tLOinzI#6UI=iY)ss%O;*1d~uD}bdgxiuh6V$?xx5ho+Pe( z3hcL#NoshJn*BZ`?nEMHt69Tvr_cOC*m<3CN_&s-Zc3>Ir0?G>#Wnn1zcjP#&Y(cW z@Sj(YuDEi0McLl$naS5I{Qi#Zr(NbWu4oQ6Wkj7HGG?`9nB+Ov`mxAG7`G4IZAeT(g`1m(j>bE3JG+6PpEfN?pzi{4rtW-SsWv z`X?vZ6|Or;jpp-$T?V16!v!8V?(^()azTW29@j&X$LY#mT@$x{n`l^$@r9Hm4T(1q ze?s1iI!5$7xahku5iH8M>zVs6R4WheME4O&Sf|vO-K$Qlb>@9uv3ly-VQ_Gpyg$Sz z8=bT}Q>u^`g{jYUI(>KQ@k-P6T*`7$ER=J0wCgyTcdp2w`gh&iN639#E!oh!dfl1{ zx@{Ml<*J7!d_pJVeW$Gi=jFElqKz*=ZofHM-`T8s#8AE!nmG@`jCc&>K)km^rViyr zY{QF-jhr@jVzg1;<)_I9Z%-dR^u=uU*EHkneafwEh&L-@Z^?(BE%KNSbw*ca_pc_J zxQF6{RbLctgk&wy38b8?Ka(~ZS(~Ijqms*^ky;dFD7he9>Z0jNp_EEHBQZ{ds;EOt6I_*br}GBnU!@r$?V{?Q%aZc7hL*j*Qmz46MB`5oeiUgLjNf@c{XEAT?T4ya8|%Ggr&lNw2q zA}}EF+T#f~&U}8E01pA8O!kk*(f01pX?uIT7WZshTg_#61$x;1-+DKk>pBUR12`ie z4{@XQAP*SX=G&bj5n25q)2nZjP{-I6UFjFAG z3d|2|>$DVELN@Y(OQ0f?Bugu%0!yu@U3B3F-(Alcj7qB}8-5$K>&>3U${)|igpyl) zN_0RsuG-AdNf=iYH?zmz&T_WosV*9%G{WsS(tQ+>_VA`kE=+S!!O>4*M}$yPa1QfV zzm0;2+;Y<7MN#Vg??Nnpn=ie}K@)_(i4}b)OfI~wCF!-YVE|DTsvn%TYOlI3cYTi# zD9R4Qv}&-|F~C`hHEJcdm|QapCN>$e3>bu|nEUlUjdpvp8%w68yk!FaS5T%aBT(Ux ze7q$+Eqm>470R&5)s@AyX-k6N#^drLA`Jhcu6tJPG%lr)Vgnamf^Tfu@{@u+z&TT0 zIcdWC?qg-H?L)yDO*w=gF^O?fxJR)zH$5>{Y=uz<4%Tj#8O>ZN@G(S5^pN{|r|fEr zoMucmRYgI2;Cg}jv8GSSo4K`7rE66o(M~o7Ohzo)4;}{On@zlV{Kj-mbHtPV;Bxjx zva*QR(YJj4^4%Y7oO?(&M9K~!4eMN@a>zKn#4vP!W(^XGq#oOkS?_vTe#=O&)N0Tq zY9K}L%WA*80d}C%%`l;^#Ax`>*2#9j@DqJs#kke1sS{Y7jJi+6nl}zQyAOFDIOxL|mN=3!P5MdOhkxR8-8~@u(Bs6Ui2+nMLFlb3pe z7M``*LG*pU9e1x(cVCt>mphwJR4_>05VIuipMNskUSK_apUmaa48x|=w7bz=XXjFt zYhx$ZGu9jSK4ug?h<@|I5Zq|R(Lp6wp^MIuWq*qEFt<=E~VJ=Sg``#MI9dr6(zsYfhv?N19|nHux2H~+Q|X)hcSpRcxyW;kT= z39I*lXY!;ij%asF?CthP-Og-Nm)YTi>TV+=%qg?B?97b*r`6x@HX=)}r|DrF4yRhH{kgN|PUW&PE5_$j^kZOG`x>23 z&4stDcvzkmY8mcS4^xs3H%~v%K1aPzJNek4CSe*|Z7`mCR^qXC#;-&9Y}qFj^7yH$ z=5>=0-cG2xQ$glQ7L(ZhhABqFB-el9Ti+m!OcUYc93QOj+s*$mK6t?;Rv?FkY{2=0 zqngh>C3hO#GG<@Y?mw|^^=$+yDVpS6-de=g-E-7DjxuO-{n;bU8!@D>2ji#Q#l5$h z1h?F`MI>dzjj4loOMdkWlP#B2L*UQC>c`)4kA4VR#R%rGZasaAPRQa4?$Z%?`pAX}54bi+HYVKRiN6b|v!%q%1FLxWUWA=sk;xZ20SlbqkMLoSy zUpGcfbb^bbWGJ1|5BcSnOCVi!R-C8Rz3#SmUWory%G^Gtv#_5>KZ0!El&KeNIZ1aY z*7hO67ujTs{sD>IOvC|&9csw{p+e~A?tBO>X?b@mk>D>n3pglAMsV)WH6CR9G8Xr5 z@#gpYac9Q8XG$xSh(W||1I!puXp5946D{165DHh{X^WpBH<}P}^cyW|@xwGW)lSh*m z*Z#!t!PB%aumrXrnp{3(!T;Od#b=taxGzf;(uuJFdH5sKf`754el$f6GI2Fp5X5;c zI3@kiX#damFFu_M_9%ikJ0lA`GK*SL5CJpXhun<5ZgegjtMGOk$*DIusQ)nO%~jfVVY7Wvj24G!d!?)gycl79Y?Eo;)4-{qyloR+xFwBwEV5VP~%S59apXJVIG zXsUj`eX_fJBbHpPm$h@xwf=`2^D}4xk8E=N=%_BUsV$lQ=aD39NRw$vlcNA0zW7d1 z64emSFXyiB#LCB7d3`^ZV%FRwV%=C3pDvfUp^V0aDdOZdmuNn* zIMAH2Y=#}M@Zr^J;@2d9-seX2--1YY6mVpdehU_{)lH%qhacc+4u9(I(n3(6;jTiG zeZyMgJN67UqPUVbP1#t=pSqS$M^dy9tYen+vv%zai*LOC80Kvf)R~4~^C)qH?_H^2 z+WfrHZ>$rF(hxdB1ipK*yoYuugVzW(<%FG?8~aI)umd4YLX#W z{o@61Rq2*_7k)0M6r5-X8e;P97SC4_GhgD;znOZWOZ-tKa8K1|hZ9r{mhny#c zepi+aYwYw1#)p0sxB5L^cglIo-*iYoWe=UAxQ8Aa1}eq25A91$UU~*icFet%6l5{I z&}m2*MfrOmr6(v>J8LQ8$+xA93KIFZA{9cS*4+r|4IG9swC(Mf{Z*ril2(Mq;MerU zh07GwtwfiBu*^mAs%^iGQnIw^5>=Voe#v=~JpSRrS`Ggl8nM?*&Y$H6MBhTN&|MvK z?lBkCqZ9qDUKJ5OR6Prk`xQFc7GxQ9zMhS1W!1MkA!q4Xu64ey>n^&;#iF2mKE%7V zxi|Y|+wGJ=33kJLOj?q#TPgDb1-Y+w)g(t{ zysmC^CR}n0OPyrv`u2uK^r@@;pgO{5{&nCb!=ciQ$@M>{A>EpW5Y_mK^q$gZ5{?rf3bz3X7gJzWgMxRB}JIXBM+xScCF&eHGTd zcK+Quz2DEr{!am9_kIE!=ms%fFn7dPKJwt2xqH*ud7^?%Y<>?OXEY)=1OZMQip@^$N9 z;dyrY>JE3)FHNK!M67C2vuRnx`hDSWOw()h5Sbr|bv-{dH{?&FHWit2P5BsXXR5;d zOTV9$`jtCZ%b%T}Tf+0X?YR$$fvi02UhM9a-N)v+x6Z=quWqyQ9kR^mZgoUHbW35M zon?RfwVHDIg46N5xRuVijoECk{~f>n-5UXJzfQ!f5nHk5KG4II2FEk1jm`;P^H%A! zd7aCLG@@dfR5N(3GqhhA50p9;=iFt-EV{=BA-b9>n9*O9nHH$FRYi(P zx>OS>PSuG|2XdqA5VqP}hE|1^X2 z#WPaUtdgO0v!nowd@-hYwxF(c=cLvzSx@(@jqKqAF8DzERe$LgCx8*u{k=-q4m!QcpS zlXd>)l?Qn(XP=P4Rj+cV9Wn*aQm^37{c&pR zYRvV4c$^F5cg zPWOT0-chgrjvt6Nzj+iG?yBMt2o8F;IJ@;{-fv`2iYmL&&C>7oGRFl+CkFZ%3Jl@#aae!ULblqYW7TKZc93CCK6=kk{y&Xn@5HTpD~%qYLRwj;u_w^C za6#hNyH>g-N1P1?c@4}8W@q}AQ}&1%+e!OY9_(DZ)2Rk=L&=XNB5xmQqtKjxsWps? z(NLD+yBqb2j@8cg17)YAgBJlm=bk|H#Z`2&oXq=gm`CTeW*Bd=7BFAgoeex>x=P~V zZvK;>=N|qreel}Jh%KD~S3OCDX=NE|9+J8`M)Ans-NU;n$WKzl|E7{=-cxrzF$szT z{MnyFY0a^1m!Tn;(Ja*4!VrIPq3f7+Kq&6(_CO zhpo!6g{5~rSL^gxpWrKXF5L=-QbzpUetUDa8ZHaYc|oGt)QH`={<^y7fACyZR*_;* z3Ma{LuRE(`Abd6V+?%O#)dfz!%S@Mhvq<)U`J?TsP-~AX%iWW!LU*M%yHiLe{~uf5 z9o1Cu{41c+JBUaV5D_T>m1Y7+7f`ASNQnUj6{J@oTuKn6N{w_75fG$EuYu5eZ_;}w zw9rD5m+yPO^UitieDg=n+3eiinc11WxjT2})2D+td4uhTe1SKA?`cPP8@*jn*r#z8 zD2H2K#q3Jsb-(kK;Gk_!lm=cs7ub;i{3us{L(b-DOTlwmE$1IKaZR78x21d-$_M&v zLFF8EI`6LZiYob@Ez`Wx6(S!8VEBqm=$kSJxK6~t&WAMR zsS4)#9!ql+^3u0Dw}dxYK-bM)!F^NSY8ilT5A3jYd~&7vwiq ztBW&^mzsr$hEGZ!JUqCkH&_*czr*^uM^%Dfnol)$`W5J7-NfMU8skfTiTlittaJUu zUq69QR)QbGfS6&|nE!vO!Im&=#xt1&M{6QppWyz3af%v`om}MRNb27uu7r5?lV-n9mcVrS~}kNf!D46)g}m7Ty7AR7&^Zq z&j7oa9W&nW#l}t`D&J9N!r9aP_VFyZ%Z*pxGk*0#IK>OqJIK8<=q)E(a1qk?C#i9b zgt+wP%P8?PVa9EL%)0rTj7aQp1fbsG@bYwy%FIoeX*{6zG$M-+CTw~G4RjmQw~sanF6Ae%Q3b8v~Mbv1OzikT5b^2RjUj8Znlq<>HML#ru?c>82eKt zuiS_%3ittzb213OAE6V%dw?Q=0g}#+26AhEAV!XqRO&B3Q7p<9Z#p#wZa<{jCAoU3 z{JPDWFd9}#0&AH`W%Ya*vcFIiQ|}%mZ#(yI6T$TZsv@7W1(>7j(v|fc4lnUPYwj}X zxuk35L6tcE4dJ2%#10j^>OgC$Uk#ZN4C6&iva2}eN~Ob93zU2=^9$=r(}RO__x<`p?q#ekB}S#4)gNXXx*Q#uO%}T5miMG*UJkZ zKh4uW;4>c>FlD8()7x3Yf?T6c8{Sv~EO|@3-DVxhu0SOtbimA*b`*Hi%q8nJU_rR% zn93@L-pm8@=qc2Y46$M3YMNfC((-Nlw`a$H+{6yw_1}QWP8Z4iT1MHW7jbwjrKJ6G ztG7+1Tb#`i+}-reeLLn1W8dBJTCS1rn6l?`gm8GhKKT2E2gG|hWLsO(Ewer`;{39i z6MYJI2fnx|9;Qxd!@!JM13#CgHTqto`#DlXR6Fi=_x(jDu1i;q?3%=vtSZ4CI_fS& zrmS(_-{5lOX3wkLW2@J*qS(NUlW%8CAGF)L>UNy9)#DLO)YA{WaeA)0M=cj-=r6zQ zPjak{!(-|Xpl_Da^6T9xFoX=n{uIrtMDbUD`iYVs-{-XK5b*vb5+y&-IMq)m5KEa`qkK1J2xc;8xT+PpD~Ln@NodAR32`qKpE z6EV0KQ`SZ?ty3erk_5}%C=y{}00hoKskljD-O}RkkIN~|_F@_lY#H@k0q-ds&_=7&gg{|Ae9cPP}o>>4$n8hR7hX&eg`32KivmIHX0;7!AFM;*-AwmS#hx>KDl&MV_Kw_0DSfO_!zLT zqk;W(YznO*mGlicl^VJ>J|}LEaWh*v$Mz^LgzaHrX6ksEDS|nPF_Xt9x}e1;>JLp% z;5iPvJtpaBMX|Mk0g~$F3Mu-d;c?|`R`}{%1S24;YX0gy-EPNLs#HjIsUpw6AgoCx z<2Ypo()J0^dLkNz@O|0tzENy)D!Y7t!|UR-K$79jvSt1e0U9s?8n0lo+!U`@UoXDy zIeWtcw;*;CDdfqsw7YyYo$tZPkbxz{QddZC(wrJKl;$WpEe^Zq$Rknm*pp*LFsD)(Ku5iZ3fi81&qY5##${|vUHW=as#magUv#cp$Qm5)lzLOb0V4^C(G-i&9LmSdL1*>r9WZj-N8*>CwnJeE#ymjqE=BL3AvoBE}@SK71*I*TE9 z(N~xK(l4apV3~b%d$5Rpy*X+ihv)$7&*$ZS@*RjnLya>aC1Lw#-%`SjH zid%?$xAi_Z)fcaWrYq>hQ$FQ7>z*?l#m?Sc5wE$bgn2Z+^)7)b__E}aG1ZvEE0vlt zijUO70~b{5;H|S@r`ckM_v^8LhQD=u$-S#G^L|9ztHTXkuGcn{;q=#cXp)B)j@ik4i?y@w}5Q4(If!&Mu^ZKn4R&*)oKdkM^6 z)}j!fPoRHqb6495mRoPNnW!|B2`~CZx_~w18rvdK4ssem727@69j4=q8Ij)zXfdC^ z$=x&pkt~3P_3YGpHfh~OJi@qW#_L;&-YQMUi1TGr6+&l^&Mo_>$v=$ zP%n5%5WGjdJ@LB_2ac1sRb5k@M8eWy1${Tq+cPg8U@%X~u`E%!LkHixr#8`+?=2n& zC^oiKe2guTRf<5sljin@>M;QT`NJd35rMBiwd@JJTNwsmGB#B^j8`n7Oo@NJdT|am z{nVGpXL3$}7^DMtO^}LJ1^gxrQ1Mh;9FvWE!vpvnJ~o-Ko{vaB35YU2ds#*8^D)2K z)@yHo-5Wr$yssDtIRymQQmYh17v!znCmuH)(87zDwfP#GaYWgN_y{trZjyI7*c)w>VVLx5L*NyfBFe$rsL(+jE8BezMyzu*P z8VpX-5&i*oeVb-y%v`oQ8spfDfU|leB6u-%cN{GW;+k;|VkPgMuwaPnUb`hR3-Ec? zJSj9odxaIp1u^&<;30mCc3#hNtB0AOFdTiV@U6Utn(3pPNV{oceGg`i|qm%xL*{vrHf*bt0re zS?W5V{@Ahp2(mb1kk8~OrE@zq-GwJAw9T3`YdF1)u6P+xa_N6FM*#LY@`x;u1NrL?qy z*-g;`gx>_X&;1G*)4?8fX8f&-OG1c7*WxFabs&Fz@7jm0n2dCR!araAO?+wdD|G-s z4pX(`hv?ecVj`hQXv($LQ*4=5Wd`W?F7dZg(z8&f0J9-y$98_aKGvhpLucL3P}X*j z&W@sDbVL`Q+ldlqr3w83;kEm*bQ7oc8@ zI7BiH==BRi;equ(b=D!}TA51OJP&I@_@}HPC zCh2zxb6Iss-QQ2QeqJo63{gi%NSYJH;;Ukb6TQoFUy=ZPKXZ>R z$>7Lw%v`Q6prks@#Wy}%ADFdJy%}@MP~l&B z>JXsIf7^ZdpJsLKhI}g{@Y$Cd`cWxxd-i0FZSlOmfGNYG@zx$iC83d)d%iM4iT4df zIaFEkNET4|nxJ))@<7K(5bexO@N$1r&NwbOS^D*XQ{#TWnw*l19a5lmS~%nG3#b+2 zZuKfg$IB*FzBMBq%%nT)9DMZZV+S*DQWKx&voAiZkE0-D9d$wnz{JF)Zo$V;F1ctb zJ(q^tuXu_6lEvpBV&mKA2#ALnCBWk+nfG&f`|ZzTp&Gs6uosVYYW(Q%pPIcEoWP!h`6%j$tgBt@XL> zce+cp_)wc;Dg7=SKquY@hwA0<3EGeCAkI$v1`xX8k1}}(%V*nmJ5hg?^d%N~h;m}= zugFSIwuKQk&6k9~F#E?a!V|(7uBIr_Nm&4xt#H}7i55BaIOr(2Vut4OT)zFP=9bPq zB_xrXh|pmD$Z@p($2RN|P9t;Zz+T?czQde_T)h?ww)_mR5XLO1I~e_X9683f#??2J zWNi^lGWW~_tL?`4(Q0M{cx67H+F9*G%6^VyQ@!`Ag)|+-mL*YcE-c5}`7mk3{p@N< zhAlmNLHh^k9Z=K_2f<^uo&Xp89&o4p`$MXwrjkX(d_;`2N8o6 zV8-$AT~0s>VQNPEhG*~5j?iL!pM`^)rN;^wT^Ctf5|!bG8~6aj^MX8nEw6(KV3D1- zQ5-w8{T$z!Tz1xZg4f3ip5JqIKh=0VFPs0*a8k;pOL88P?Eb!?^A zn$LnQKij&2y@!e~(T8+a)8>~#J&^HA`^V7(*&To-_+|fxFZfAa_KK%43P4L{z>F*x9>aj9n&H;tORb{)uqRE%|#@{ z>30D6!8bNf^gQ$C{@l*Zn_6DhFL>&0X>|rz_P$q=T}*dTq>-K!XrmBKJ{acOfWeUx zs=eh+J6Y;t@arZ;r_u5_#OZKa7K(oQFve+zn{PuH3_Us(ot&IxdLMGq=%kYE$#*-- zpkMe|)LL|z4&&Ti$UjBut<_(@nfedM11BH*4RWJnwG^Cu&4d9Z#2>%j;!|qjyDc5Tl37SIM%eD8?Dc{tG42fS&9&`2^K}NO@_H3trSg6pFY0D`m}15@kH~ ze<-tP$bShT{RGMWzbq>x{~Zzy2Tj#Bgp8La&WV8vIju*|gxvR{ra}(DDXhsEr2gAw zUqPhH-qTbSfXGNg>ni>~H1cu!icH8lW(s{IHJHqaLXP2TOaKoJ)0O}8vG*h;cG2GZ zpVlvWGEyh)#{V=kIsZdTtN%aEFHiq>ugU*3MO;YDPe|Nzs+-6z2#JNB|IK+84MnBa ze^UWDn3psc`JU1LQ7qtP2~YBV@f>>Gq?i5R=T{ByTaWa?1nD(67gb3{+r++lW-UT2bR;Lsl?_H$6wd~hdVTLxs)r<(zPi?$WivOF4> zl&hf*SrxgwOI?mSFOwH>uhH*g9LSh8isl|p{P2IOl~h*dOvW!0n7vCeOT}#W2l8oM z<$3rr}KmC1^MlUspr{?gi;$vp!)9fBz|@qCyQ}S1M4fTJ<)}B3z&y? zTZjvXYpq4S-bbdV6UHH+M(#RI$r$cg2KsV668ILFQ%D% zopxU#D;MsSB0B>e*X!aEn3g|nzDs%L3k?eVqtF|7&wlmC*K2BHo|C;yH#rQremk)g zO`Yt^iax&$=sJ3z4>G4aR`4b+lg}#&pFJ9;DJpPxd%42juIE#=!c}N(JGvaX%fy+X z5jVi3?rG-G(2V8b{+AK-bSH9&h5zqVX|(RXPD90gziqb_)^w+t{zdn5M3O7$*Y9Ax z$qE$RX?K&4L(j;w{O7*=Wl<_#Rhoy zjcq^m@7%J)!j%^kE*|GUYjPHo8^vHb&iwX<;wV<$)Svo5J@@>#(DPO zX|)9awbbHZs{GdeOxbw-9R7CY>WQO4$ia$v>6GNn@#)540LRq1{3{|*?7Js#P5Q+c zS^FlctKc(R6fSfBWRhHf)3;oecX?Vwy@#_C$adwm{nCPaJ~;1Xbq8|#Bzx{1lP?Gu z{1Uvo&#RbXtZNXAvw1jECJ7a;p&I6&?_vdxFw0J9{Sm13tKNOR#ydjWG!w${C)*MJ zaxy-}(rV+rs9|KxzU8mI&8(9Cosz`-j5ko`{N-;o8ce(0;prmEGu4M1hP`^UNDgP2 zeIH!^qr#5Me6z_^YFyxG{Y<$s^-^;#{O$q-5fVZC%{bKUJt8-mac6t>$@Ux*zzJOC zT&PZREz&uJ&2cgQY?D>4pYhue84tGK9t2lQpn19+@9fWDjq|1W&Q`B~_7*fcsM#N3 zW%;|%__hBYeJ5+(r4vjL_|R|Mx4(jgry7R`N~) zyv<{?Vl%HS+tU?d8W}T$g+)xz)h49e9oo8mACIc*!76jgD%TqNnhxIo1i`Ny7_3!p z&hB6Sc#vKp;M-W~X_dsb6~EDidCGIaHKz{2Wzm+YiZ@%s6HZh;72=A9}wgsJ?;7f;D-{zqkV;G9PQn zu}@4OQ(Y7ECv`xa9w>BalAbKNq^Q;OJWYH@XUr!F4t>(FkmS>tjTHmF#RwE-tLu)2 z6-(|lSMd~ewqPRS;*zM&pYle{{J8EOOZ&J|y@x@-?lIps*~I-~0_|bsS81rU-6J*U zm!~jcFUu+WWKJ~=T!l^-)lGnyivI)u(tJetb?7L?cym^LTYRy`azf0t;`SGzzN5ek zot@sRqGB*en9U8%oyCT7c6!DpX;Z(?I?UtFT3Wl?dXlIHokqImgNj=5UF@xGt%Meh zR7~gZJ@u0QpVG=L3#{V-Q8eN+#bs`7AM}+%jeJdL_XA6eza&}&4YUE4S{Ynt1IB3& zM)!-pV3{qaERMtUUSr)JTDB0P`I3G23a|It#SA(MujD+%B-@J?`AlXv#qgaY^662- zH15IMu9EV<`06KqmeK|S%CkvJ)~EDynvW9uLdP3Z}1O=VRL`8 zuEYyN<1@ch)6Fa?$pPcT8*Dzqo*#s$PFs`cnjhhaedsobgD5cD55M7q?}< z(9V!PKkMZcHC^%f&&}%QuSFRmZ5MAQoRxS^C<~bFe44M!Ihw^r-}Dk{to`t9?Clx; z@zF=wRumj%BmvjWo!)t|`eL5lK+?z&EmSpKTe~J3zKH_bK zn&G@8*l9(lxCl5{Ae%`&j*^ypt#Pd##Qm;<_5A1C86HE*(_lEMay`P` zz#@}-EbM&A@x_ZE_ciAf{~ltzkNxDPjtNx2g@^dYVkrk`ze=P$Z@QK6tQqgRrkURM zu(~Loj`QT2A~GL$GsHW0GevSmu~qOPZxozyz_bBk?>|GE_aT`9mvTf$tS3JS-uD6J z_vm}+4KUX@@?&aRV{-q&l)f!AtnM{&cr=a$hP>K8$23ecs@}n(RfGyNcsV8_gKEVe zUyggr6&(S?1rtke(!5u5RWz@3@)M4%GN4L(!cdHbrm878F(4 z`J3&GC%!kEnOOA{1_k-4PJY-yQo^4lhQ0TaE2J$0nir;-yg=8oM$d6n)Gy%U+fm3P#QN?HTocYh?VE5Pz_Lu;+(o;; zyJcp%SZl+jr1v@eTx#RW5tTs9Kx#SVkxi2N8wp^~vJIAVF?bqkdqVx&!5`<+dLX<) zOWkL=6Au4^&k1O|skBXF10x#ldVW8p0RT;pco*5$Ta-zTgT>#%T5NEO$yh8ZhYU_z z=Q$7>?c${Lxnljrj_bIkZy6hoV?qRK7Qcu&fO>Ke{I}!t8^(Z^^_P!}`d(1V#=56mjhB~lsc*r+XCqnuoCC9d^f%?m2D+DyJ(SO>Rat%yPK zq0=o|=aJ_SNZ0irZQY)Zxn7X4+nYzDr}Fi`Rab& z5y?J#qH9|IxQ8pOph|neQCf5-^Z?&E0p>T{ISX{}Sl=D&FKEiyfHT7V?G7BTieO^m z!sBuF!LAyYVaK$TFw03OLltfjQ|~g{(cx=4$qR7ekR>_E{gbGjMwAkP-*@kDAxNT^ z&)8+@BTawqZo#}~41hE(-l{8g{NS6P)BXoV6!g8=B*6DVtYDE#CC- zcw87VSzZDa>kqp9u1_ORsW+sk4Vjt2uPuJ7;SFDmX>Ktoy2XJURa_BZEK)k1e;EW1 zPr6tPUfl1p&pww1)^r6Fa@zAX(rfUJ)Z?lSR6vd&XoJC1ZEqBMi728KuKjJ7dJxDv1-k0~e zZG>Sy5yycg0Fx&?{3GHiN2P$sW53-*MKuYe*(l#ymr-L2TYK}q(w~a<+BlgR1%{fr zHE%igBlK^Vq`O79($qFtCksRX{<6Sn4ry}%gL4{{OS9m*`qQ+n6qeP5ze%XCSfa1cC&q4E6*pd%fC zIiLYfJ~hp@HYyi0suBe%pYHAl!+B9Cd11N}g*fNkMIJ?806Stjky*@a!+p~#|z8PIKEImuV~8{{?`bTD}@)ece5#Es+Lru7YndabN-Y(No$d)OMf)Nc-n^HV@F z7d3IO`abyFJ;|cUfEkEqkdc*kdOJR2DCwzjwV?Q2}7YS|E zZTItYR9)x&K-u^dxVO&tWUkMi&nRf(&-U5zrNbNN+8b*@K0XhO$nlkK!{d8u3qV@a zgyo5_)3Xa@2Q+*KYS~#ik9M^lytBqN%44%8-4pGVzI`Zf9gf%W;>#$PF#)X8CqDFo zE#fS<*>A^sCLEEXcwu>rzL0@RzC^65F7=%*#!OT&mwb!Bk&!kSVwDe2f7Qz&v{lYC zY(cLw$K?Y_#c(n_E!gOj92Nw)L}7>*Nc;_#4XDb*eM6$*U$2K)P!Fa^m56?~wwFz4 zd+qQD3j({u4x&O?aT*512le*!7aaL>$uh?vNKWdX4QS|`u+K3FZE#~0^;C7wgH)-I z$2;hP82OfCobi4YvX%lv>cB?KX;>rE;u~g07JgEf1keW^=@_ARP%Uk`+PN)bX@yQt9g>yw!vZf{@LE z#WBcy(@=d2s;$ZM1+~S)@SYX3nXV0iQnniDt+RQTg};ocWRcSP$J8;r&PLY zU>KAnMZYUA7F2)Ukq5y1@w=s_Dv6w&AIB*Un4mpI)Ak$-rI1whQko9lw(uA)ie1@d&_hCcDoI)gN(Y85D#kdq~U1y6gL z*B477cCy}rt~rEd0R*8GjBzl2d;9e@Rc`1Bladh0t7kn(+C-=EYU6d7tbat}#=1!r zOgM@MPV)eMsEroMscbB-5D$d~=Itf1pgmhglFR?e%OvC^6#gItR~b%m;B`)X<>j}a z<){5>MD(BdnlM7J=~RLmzNi1gLlXO{g_@ZFb2tR3BS~SAg~|iGZ|&3I!}q;5u5Ur- zuI}dpobZpF7aZ+q9SoFcWqZr(3SMVik#7t7Gy6|IuqeViikm<=UDp^zNixt^jG}sJ zz0XOz#rVhbA3)6e-E4yTBNH{e&gJ_A>;}{;I{joH#Qv&Z;W9k-M>P#;sJ4ILQB*xp zV6KPnv7S95EncJ1YZ4`=v2Yf!2yZCT#Oq83Jl}w}V)IGABc=q|hfsN8XP6<>H-s^1 zr!x(p$AWC}U$Oz1*IoV%=uha6d;lhDEszHo)UgK|eSWdbqjm|X-(c5iEWEXZiA z-;ns%bBmc|Mt_}eVL=&yraEbN`<9Ul7z_l8c5bl!v80~ZY@xn~A`$VS!6d0?wS z2rup&W1(3n=CaCHX-wYB&-M!28uPktC!F-f8kHqvWmvn{yBRLd+?n%|8s<2uJ3jwb z<8vGH-CPGK6WGxKB>Za0$8!#P$CcJI8NXT1eUNM6Yd7-2+g~e8IX<5H88SC``l3Pd zjPc^rX4>9?(I7|B;%pkCvD4I{QlYnM@HO}i_)^i+({<@pq2A@o3(v)RbxYqv=vTk9 zj?%w^3r0T+K8e#07PBe6coc}e@i}x?<_Su`f*HC5kPT=J^k;zkcoYG+9E@!gEaA}a z-7R|ZVp>b8P|uq_n|@tnF|K0dIqcFrNOBeI6lc(@8x?Y){>ARj+uKO&>raVIUX%2y zvYX089R@LcPPn_~{JSB@j!qjWn>EAQQZ8oGYc8gKL<{Zy?2^|~V_@iIc){YO_M~K- zid+W(jh1idr{Q6{iiJiJ7gk3oKyf%~@7>0{!PfhF0pV&?Se zCBZtnp4&GV3Lp8;3mFSo8SWn~@NoSoDgH3G2b}QWgjaL!-`xk>8)z&jNT2bfy|A_J z?TE|%S+{TAC_22)erW#h)cX3`L5J1u3vOh2MjgwcoRqT(xr?!kQVl45WOqr1^juS8 zbKXFY`~9LwlAM_ScFtx>xTzpMjI#IuGWX|~BpL2+OKxt7$!WqP3L5ssM#(Y@o_>7m zDS(SikOS?Ux~HEJl;$t=b{VCnf5CYUt9~f=ldo5RqK!k-gL0itDcV;mj6txBb%QmV z;Pu^h!Od z&vTnA$sd8G{dM=i^#E_5U?uCL_0*ygH+ugPp! zxc)skT9`rSi?W3;%m_%FUyQPD)tcB&X5G%CFpns{!8ahQO#M4;VXQi9S7c;xIqZ?0 zo|RIDT&Wev%Wk-pyPg^nKOR|D5dxQ>r^>5rfrE_i-n`Del-SMv;)`qeBrsi}=)+fI`;rqFhOt3c}!C-wwU+ZSzo)t@`O5Yo+t@rdl79@K2IZje=v5 zR(#&u8j+ia{_ll9aYkk+4Y>oeVfgOkjgp!TyWpBcQVlGt)BF6vF1Z*6)fEQL-#Rrd z>Aw$mo728g*4^_w^a>I2MAU=g!F&9s@nGX^l>VL=R9tP3$+nC-9!yDVBj_o&{`Gk$ z&zko?iS9JvoRJvt%$W?(oyMUt)yeZpvXIgf;q7_Pb8-b44}NByMgzEntn+dN%`C#T zOMcEUJEAmeSSv-py4ae3qpDGrfsShIJ`Ch#*I!|nZb){~tp54MWj)JMc$LBS zFvUev460Kj_!bgNT#YjMu^Bl7d+Bhw8ij20U12CLn&hi#F_GpuM}lXf*t&TR8W#tM zs|*}<1dylU+Ymud1klizA>i4nV$sdxu@I-)$z$`iWfL{yy?-R<((%;u(H_@a@YKU^ z;GKz=Rx1p$3*AFNjp~KWl+oTzj&{R6d(H{vnz9@xb;i9shELQgdrs4iyf`Fy*ep<% z=+v?Ku~WZ0t)h~lGwsZ{IUby<(*9s2>XEsjZcUjmIFHh^2+*p(=XuwzSZ%L_x&C!G zPn}No{TQ&UDCO~jZgK+aYJaZn-*~VMpP7g!Lz1k~9^FMLeND@6GYz9Xgl!6mf!{mN zYs%d0udGIGQh0W!>7W_o!BF6};a<7KVRtKp*DhPLMsPf1JSCk1KF6oAS06p8Q}Zw% zlJ2tJ2$fw0bVmlryVJZZG`o4CUk1m6<%{D*Jk8s2#|u%5WIql-o*FY&BA%}ubbriH z2?=Hnk(*J=bu=d%N5n9B&yJJWXTlH$R`t$jev@;e`Ymt6Nz z(&FaqD|hm=|E>;mv2_oWUhPjRxE2qdc5xT+e5BK^zc;#*tWs0v`s&7NRJ*y$bpkJG zO9Q(AAuHW8B&I$}To>@X18NW^S+LJ3DX0IZd7Yw5NQKG0pqUs4&b8+?%MetQi}2=} zdw1GG+pTyoz3Rw4PrrYlCwnD-segC!{M~hB+zYh@pDZvG=d2wN+jtJved57O12P{K zs?He##sAXZlZ?f8^2|+>yrRDTi^NLQ3&X=; z7h7#FIOE>sWsy#e>Kd1T=Om<H2Ea)8~UhU|2HAtwQ1Q ztNk?vxgws!(eF>x!(e~Xu`2^)(--${-3-rolSE#O#kwVyU`DZB< zrmp`jQcX6BTRS;lE@nXn?T=62r}+H)CT=$sne*e$ zlnAz*T0K=}H%{fNVgAovh2ZiL4Ut>rnXzol2ZX)#dW?J8gwnvfaocl6)W9hrqId54 zSm`RDCeY#yYxh+AS|s-Rll?9>{q){Pl;vkz;Q>*%g4+F7^|`f-yTG(U{e>D{7aknO z45-1m-kruoRY4L&Z7Lr#XYYHgtG0*>+r3Hfi<54Yy}KX+@2lcli{?jvM)Fu?ac=6* zxdYZx*=Rm%ijEe4jXWNS_}S|oqv+!+A<~twl|0qL zU%=`o)D1J@hE=Gp0S4vb>5z9@tbPd(`;|`_9RKZweY%AAwU5^2im}1i^E2L6??dRFkjZc7mmDNfgo2X~%-cp=3k4*@O zZY6QkVW?#u#SA6t%MS0aN4^D{s{ghNclk_*{`#Yg8Koi&B>N8OmA@#C;w9qL?G2&})LoBDjwc}UQb`svcDQ@{S=k=E92vTkp#&S_4m?&$iK&U623 z6IEZX#epJ|XoMbKb|xSb424t~)aF0`{COEH5yM=hn3DYQ3le#wZpOW$MSw4%eaM&b zQnGoud)%B%0+`V9Q-VG9pI4Op9fdtYSYegF2$Q%asHFaM#uKpCs-mKHcHYjt!K;GubQpMv?)2&0 z{#A8dqj2T zS=p4rfYsZ70_llT;kWz0N-_4Wu^!tWilm5szS@v>DZCU%t)Y|)2~8zxOfwZAJ+T(GiOpxga0 zq{=jyRkxwxye-B+ZOX-b@>j7GVyaSidi;Kr+pYWGYdkt)en{*2-GqD<;&hC<>NeT_ z?FZuT`R}squalq!M%zzUVZY#RRLACeh{rgd{*LRc2Z0V20cDKJJ~l_ceoZx>JA0Zr z**^x99XeQ7#-2-E)W6D+9c0Mn`|yGPclviDGX)X%VkH|k5-`yPJq{Ry_egt!BCcEf zHd?-6HJVz6F&$+QXe?aO=iO0Zdev|~+;v0ISj#6E|0s~gufR-iq;;d=XrWdrPKsq6 zN9PfZ4*dY?$6v;ToFNP9X`x@41Qjk^KPUhzx2?|uw>0;?%6tY9*Q@&t`LJ)pyr1@> zjF^upEl>aEKR@QO%zbUwRF1Bc(p<)vl{|;@4xh568-HJBI%6ha9=(G2a4D{99Ja9_ z47L-EKhb1M{g(f5qgI>!q~(uciORL?IRa|prQYql@fiht1gA2T`}ulTKmWbGse8GA zPBwM--u?Nq@Nk2~!}LPxWvSP`Y7SmxE9!+i?#suJz<4Y#@#a}d=BMSi4}gKz&T|jV z`d{=mov;oeh;T%=rnVTS`b~K*E~JB+F@hy$=$r=HTVB5-mvMc)4EMd<<_(j^{KMFK zSkHX6$L93J6*0?lqn+F>#%LXR5wH(ny@m@}lRfM&AsQ$lKgqPd&oKS1mo5nVtz^!^ zZT`GfLzAQG+02tWr%|ocHX6#hh0pfZT3HBiB_tu=83D!rlCn4DW*)t3$HvgcvbJNC z?Rt4r;JpOrtqdM@{anq#5qD+;%IG|BVhnpVQf@Nm+(jCe$c9CJ@~=1N&3FYU+Hop3 zz_SYhSL)w#!M+W>QWrv9K-nB`_U&v_`uRma{Y2Bj3r6k<^^hEg*>7C=%}1MI-;jxn zg4&PxL1eB4tj`mf+;+Og?NvKzZGE$Mo^^&7s5XVlYFy2N!8TnN8o9sA;j2x!1Xqn$ zi`J|qmwK5}JNJSh&qgLm={LYc)!)is+KCJ)hE3=hS*7YNXD}4K9I>14<0sGx{g75l zdiC{A$9Ug`xH{AFXR|7p|JqJ-yeiLrZ7bvY-Nv9#XLC(as*+Ii8;w)fGeB;QW%909 zHAo>!**O)(JI(C-Gqsr8 zL2r@NW8XNU>W+JF$WO||f-!FxrpEM&YpIJ_DObw>{bu^<^ZU|$QY=FIk?W13vgUi; zu3ICxZ^(YGgBeI?&lHGJc3j!=IF9md!nK=Y>|>noRC#YneD?Ka2~Fx{BBH)rgRQB~ z>&{()G^%;7XRAOXDiO87i^@7>T_0j9ZzG+c-R{|jUxa~&vfcVSF7zES+4TFbpPz-? zXKZzrVQL@rJL?K~iY}MgtnUsy7cfB$Z*#6>+jhR;Q%aZA%n35|LlXsW0jYEm{7WV0 z9CCOA#60}$Kq!(b5bYq*J%>t{bai}9XIgxBWB6s8rcOOIjk_cuHna3pUkj-mu|^ko zm7W>(OW86oG2!8wB$Nfj(Z=@q&E4jWr-gJYZzr5I3Rt5?JYD~lmO0I^6pVoxl`TJW zkLw;=s13$N1%}u5Usa&-=+m{-*7xdOd3nSSLU*$TFFL`|f{!LJ2zkNrFnezXBCVUN zU0sf(ie{pYN8>dhz4vS96pqtHO89&vl+S54Tb#gF*>a+Ouq*DVwzf_;Ym;-y+y^;W ztNuLdGh~gWOsw_Bcyqq&F#E^gx60|o7~GiH&*3gUGLMM#3+3Iq&L-1#60YL<&oPXC z{@{1(c#U*>_gO=3g8ikb`(@7kiT=X3bd5(nJT(&ff}sV#OQHK|>h(kiF7Vy1)c2KJ zX}82>lb=>yzP#%w%P!nMh;(0xYF}HvmWxW0y2~p%@aX({a-3tQb3?oIr==5!YqQcs zr1NY`+-Ac_q4Tus5%c&v-7~8JxiPFkMP$k;gO^6?K}`Bf7wp1 z*@k)rrj$pmfSc&nb=YiCzg!G-QRk4s>%_LT&m%(0`t7+ zSl~<=KsfWIeKlNZn$?^R?0nz}tSxk5SLU31g2WvKv=+wm>*lXGvO(|6ctl4D5)Nn? z`E;WNDd49y;SL?KS4S{eAej!P{L+AdVVCUAUj05mu|t~qZN}loaon}-&<{F*-&oMt z3M{EHxiSb;lX|n_wQzfSYd*wYi3yT+sjG0=@#<}0o6ftoUk?+lDkRE=J6CLUr02W_gqh?;^g&uf8d6%spDA6$4)#*YVnOdGZKAuw=bsm(X`ZLeoefZ zXVOO*pukD1xa7cBclG_HRoa)6^h~Yl$)n+yrx{^q1xqq1mm(N%QRrje`O<}&ds?yc z6;J;>8%0{C^L--*OduQjJzbxI2SAc-OLOx7pta;x^&tfG*N9X&8o(l`<3F6z01=i)N z`HJ=IXJ`|T?K@Gz8~Y`U1HS__+ZEou%CK$mZM>77r|v^PA(N^^VX4&RmMi46Gv?Sb zbn)xzm}hscjxxY0bD!U5?M0x>iXWqnWb?Cl*U8T!Tw)F=-bV$T7vahuUyp0ciZ$l) zqyguYdu12AQ;v~}CWi*>AIz@4v5B7zPrtbVvMDa+2_m39>B>z_Xz{B4-!+!l@dv#If#8XRB)8+yhue&DG@`FNKVjTE4nmtnjqBWm5wx zb7dd=no_i(sed!)>Ua$9_@;W{+w!Oc zF6};OboEOHz7?Q-B~EiU;;naLP8=ibI;!yAvI=0JRm+ZQ`Igz15$(?W9mJ!)N*=|t z#_`8zj0`8z<@y0Gb>qb646h0FlOw%+TtyXq(5a6WP_6;zR-l$K0~5N`6mOU@aJLt^ zj}b@uO+9h+9vi(y-EgmGZ}6+rLd>EfH}Wf&HH{9#zyUtCM4RkMt%^n=}knvB6dP-tphsQh}C`&zPCgeLtuU5f!^NKl0QC?9(nq8fev=~H$I&xMY*-dVwIIZWk4m9*;p zM!UB!*8Dc8(=4mLutZ3@y5@hd&J$g9RacB_38J2N>F66$%EH{`d!MgF24DI5PBZ+K z*dkjnSDkkUb7_U+|6=PbquTnSH{Ie+Deh7zE-g?Tij`8dP~3jF755?+cXxMphhV{_ zI7NzEaS1MggvtD8t(hRtaUpPRSBD%Ys2lnctsE$N(3j#SjUPI~{?f{91@*U;M!g|bhK80! zO>7BfxpeLR2d>;~#X}so%hWg@s~85$r9a40^sYPkr$O z(FE%lpaLjI$NgT?6;$ZCcPwCLvQW^AkC-j?eZ%nILhCQ_q_w-4n|xaY*Y|2Y1`_`y z<9i~~u&AIqX%(+wAulr}Ja3_FgsrSKIJFW|l7&Kgvf=8gf*e%PsE4Kol}NsyUcwRw z?+)d}3RWTG}+9N?ZS7q|7ic&Hn4{eXihJ0-Lm! z?jr#IV3I?4v-&swyS$VTZ;$@R>IpsFkCf1H$J<@M_v{}Mz2};>Nv1p++ItT&1SX33 zY2Ts!#}y%d;7g5}$6hVJCJ*MmtK$r_$-zvzVIJ!vzIrRzEhf_*5I)|Nij)3%bBJU% zQlOxW!}=p(zp$=orJSIjK9yvRmVNeA=vg%oEG@p74<2R069-}WmW@nK7vU_*tqh<~ z-sD4^E%VOd-H~*0;aS-BQox5vBmTP7JGGdsDvMsxMrnJh2QOP&|pvXl<1>HYvg%aVeSKOo=u+r1EOzL-$Z z^?l2zX9Dt37Y|-?)Hct>bivIw`wXBCZ5cuFSk4yEU!37rTaN4(+{n3Z=Z0HG?p@is z`lxVOi&g9H)h(k%&r?q&SQPNhbCvOeyW~B$W=H@)p5$U`gZGfuc?6}O2Un-*C;tlo zj*@?g&7wRazOzkB#g@C_2Btm~5wPDZ&&^hAi7E0H2wtJGs0_q`Z)-Y2=qgwe?#!@rSe+5}#>q(tI#c4eJ}Vm$|X1oMC9%1{C2`o>*zM zYQV{0SsI3|?g>F?!_SSr5ePN2c*z%`-(Hu~oEWhsYBj=3+P#J~j*Wh}eJoXfnfvu6 z4o%!B_K z#udOrBp%y7-Ey;xiv`|t-;0kSC-C_+4UtZ9QI(2{ERC4|6QRL~p+C51~YSLwX$XoC<-eJNrY z!hgn2s_%D4h_P1Pp-i{jk0LH+pQ6ydj zA9A~|AW~c>H2jvkCDI!~BZT@|dr2akdbs@srto8Z1)=``oU$`gfJGHGR9WEPpouF3 z2&SOj%M8JA>_jFYR|6Rad?`>;r$if;6C+)&8-*Z1@;$0YIj~(u^RNV#(I#tz4>^Y- zBGNpE03-lOSgCR~0P?O9iG!xa2}C05V9ENAGE8Au^VV%1oUdL4s{ksjC8!VvsQr>e z>`0`tv=J^l;}&tttri#81efJkxkm{0B#$)Jz%qT7p%g4?P^urAR!=5|@G{iT7#3v^ zOMhadZ@7=hfb#LbNzk;A17HtfSWhf@>@*ISw3BZ=LU!3(d z;%>QRcZ)aGUUodKD-l9AzTo7>meJsxTV6RpV3tM(UjkqFMs*`Lr@t+PSfirSIv*Ya za_o(VlJxg1B%ZTuJa8_3*g@aZ{gdHIYTIRW$a0uyM+!&=bURMXQL|JU6yB!S_Zl zcoxBqO7AOGUlP9`yCy?P_f)P`R9~DmMTSBUaiDymIx)Jtc~E^}Sj0Fhg`>)Qc?uQ4BeQrClyuv|l6MjOe3vr;O*=XIqw}I>snH81J>S7Z+_6na3;`eT zh=wBU**HVkkZ;Jm2*&u4f`!--cdij4Ix{J4)j-8^;V_i6kKo|_u~8y&wDt=_GflQE zEGoq6Eg}NyJ}?lDe2rj2dfhv|rRdl;t9-q;OUHrI3Le z5xI@%H^)ZtlVa@0MyhmJCa`haxYvtdSIiy6%1eFbuqfFwB?MekTF22*4v-%nWh0_L zQlgHqSmY+99FT1MhK8{9k_~AQJa3fw6^0FkJE9{}wZhi`k#)@vz`I*+6O9c7)InxD z#5ME++h3NW&?2!^p@Dg+PcPB=CTvL|k;i?bS7)5$uI$DMC&9jQo z+s5SnoJ#ktAH}nm*!6~Ru*7`KS>BoZQ$t$_oUEruKc)# zL?4miP8ii$?(jFimnjJ>whaOdktd=;KpXt4fFg!4y~oxWTY6Z_DkLsCxJ#xJg~OwjEO_^7gY82wd_`~2mHD^@Dy#Wa!F{yFvj}4Rz8Mz6d8+x7*#HHAE-j%xs!>VNxW&jr<{^Qh=g3;Dr6pLxisHzDMzY^% zy~eO~l85Sb@r8Ij_3X|Mtebq)K?kg*-=uJ!-}Dt0wGOr~x!9Q@>el9cxQ; z)U93Iy3t4nX9|v z=|nyhURQ$~ zFpyZtt9w96$LzGrz&ThC7vo!pkm>_dqif`}baFec*THxlek5O+4e}p9%o?7lVnNz8 zsP<$50gU>u>hZmz)(XCqatF}_;!fRY;s>S!9vbPiQXabvUc3Lr9wzHYh6#-rwGS&j zq=aoid{4ZHJ-r~ykEFQ0d9Q#~-cC|Ui361foq05n=6aoL*H4NrNWS~G%J-7A?6oCg zfrde~z7*bZ`~PGMXyf)_lM8M^Gfyh*!KXdj{u$Tfk0DZ9p~bGB?Vqut&r@5zlz5xM z`whcI&0&ju0QY4;8Rh+GT#;VFcsg0{KR`m4;0wrgw+FFEBwBR-L33j zQcZi9hx)p{X)n+opc#(tIQ90d`UL|VGPhrpSO~oTvP+1)kz^b>7^bm{eBWPUgVQeu-4u;=@N&-t;3x0_zg~_LvIWuvUKfE z#*rO7*xj;E=sZDj$T3(maU6K^nl;5jV`D#Y0y$SMyf=IG2VR3 z=1%9-*B62y&0`>+`4rOq_fmIq1|RKH6|H=bo4?D3_Z8v3^7s6I7hkpINGJK@)C1Rs z#7@r;e`(`-Q0wTNzv_1HPng6V6Wf?;03X2d?Oi%8ZXFkLpb+`e|QOJ3QY ztdG1BczEam{%m%Ox(bi4V{yKI`Ex1%2g@gMVPNVlmuK;m9X{y|l0?fsnC9Vi?tdv; zXTiXhX!D|N)S{%aD(g4Cuxy#INrWl? zQSS&&{sO=Kmngwt(_oH1fnC*UtGo5f#f*m2MC>dz3pgeOf40{w9=w-=Xx#la0R^#r z5ieRh;%lnTU)yF|g8^%xrFti%J-qwY3HjgDK`PS-JztW^i^HSV0OptGe1Ix>w=x zGJxr|h4)Qj^ZZA~&3$UsQa*BVdS=VTAcWQZ$R zDpCNe2Z|=;W3oten<@4lo-ohxr}3PWJ^kM~Q>Pv3$s%v@ni8GEo|-2!ox`$@AF`d% zkGcfqKm*Gawlbi1u?>GGoDbr*gvO~m2hvzP7!TaVO4qglYzr2TokbL;@8=i^iNVfc zJBLz*3$Y>ETyypFi;&PLRu8g` z8{Je9W8S@*ja1cq%FE|4lh(tpO`fn&L832ORj%sHN; z;E_fR#rH@rTdzexOaF9in8vB6RO$Bc)Qc_=;oQvS9(O*d7){%YmF{)_Ox*_TZq5|{2wlyMxnlr=^Pj|c4hi@XVDb1NlBjcDuDn5q*i#k5w6o`IqXsF76XA)ZRaEJ;q5x4D1yk|ghloBpx~_-oeB>tZl%fSqQkB<@*1?`VHcW12fZpRLU!B*pH*EJ$u}s_Z z!pop<%8}fdLPa76&xM-=m`POaTG|Ul3PPq?31MX29(z_zPmkf6?6eM~Zn}ZZt%?e7 zEtTlJdDYmMHx3!q%(bib$!up5WeL-2lGF;^YO~W9lFPojw}JUV<#mdmXju8Z*pr#0 z*IYlzFGatT1&&9i$j$iPbavbinFq7}!B1+n=00;^@{2XM&7L_cW+>wj<4^yXY0({( zlj@@{GjUq$O-x-U33+j4@|j$2Xzn7I?$2ial1rv-akwuKLZj`@Y~~z+lu>=L>=Aft zC2W#$5MhCh++lNH^@r-{vRGy9QDS|XUw(5|A~&sJ7)Z=TcfhruOII>nz~B5~xgskQ zDr1$#=fgC-AyiteE1ach&GzVG*Z8qUe^`%?7cquu!C_8AE+nD&p(QoOHiz-hjPgGF zTUvx!(|TGR$i=(-iGKBcrWw4T!-10JIs8Y7(zjGnLI-~924ab`IZnBR#}g!~jgG1W zHsPq%Xux*RI-~k<=w;A$E>~{EBKM6_!R^R`Ky}4Zq3woIb6Ye~8RSRG&)Z*oDL1<; z_Eg}dcpui&={q|OI=QK_!$pw_8F1%6=Mq+A%{YKTyX~!3W8HCY(Tn?cq+@?8hew2AytEUz-~c$pVr`n zXY4_l5rd_XUI7FgP!X81{#Q7WUkbF*Z`aqF91V|1>+05MWnyzeyX;opnqa zkK1Z#2zPz|NPq1il5iuZ;!+jFS5e~A4c|GVvH4{sX&b-Fa7$%Dgl9N{?*>CiZ`wP@(S(JRquMc;9we zH`65&1!NF$3X)KZd^WxK?^9=e#t!Dvux@l}5s3R^IJXra=LdPa&Nd6m7OM|wF~3DB zb`l5++g!)zkj3+G!JaI$$Xr>;LR!Q}{Bs!!yCf;<_xH+g@4ujp(g?1RyBs@OZDM$iLxGdv3QE2yFfM7c6qtb z6g9QJ91C!*xq1Zm7{FeZKm~T3>(&_H#1x z_+*u4;isoO;)rldT<2TrZ%Q(L>LJ@4fe;aApOj72ta4YSW}f96AnH4{{(q7shMO7SU< z$CHYbm%(M7nGt)EOjDIWV+EigQ2~#s_LFioF&9`Oy)ac_OU-%tLVkK&F1G&=_Qu(M z0w;@8!7%q~Xa7WYj?rtqQ@GzKv$?#Jt8V8$hi5Zq!D^;l_7mr)hJ>nYDX8q<$Ig}T zKV3-dn*scUhZ3Jev}DN*OI;& z$D%Fjk>^vSZND*33*8-7uhb37q9`D`$?hZFc{V;qL_fV+qMap}MC80x1U{TY*CoPo zHQqFJ2yIaNg3AX~xPH>v^{B2KU0K9+$tCil7Hmw5q>LriRa3Q3MHYiguBGzyb(~*f zWzmK6V(G;698fFJ@!kT3S+~y>3J}#&XbZ)1lG$Oq*0;=9v7*D%+CBD@*jqK&dRh`O zE#Dht1$A#D8;>`nSG$y!n^jB*dNgV-@>{-eV!H^5mDcytJDQfzcQzHctXaP}g_!0~ z>NRQ&Pt?O*AN_tET=|#`S9st%RCg%o=TPvhTeo5Jdvp&R5H|trn0p^cI_emE-kxBe z_>neIgu7tfeMzj1V|70>ef&60n=EH$v>5XD)3Lj(m%DRJIK>UQhRw_4`;=DjaYL@< zy9DC#CvEE3(K;9LVB4|C1l`q%EH%Za^3=KC*du`&2yjZ}DIoCI@m4NPkcJC${Ntbf zZZT7OrMHG@$ubb&$5G~L44yNo#-ab@q>7ys)1kEb^_vfJ*?6P#nNO8)((jeTg5%fn z+zTgfI6o@9Ez2P))g$f7R6IYaJi+HmVNh3@)Z)!xl8-tq$Cj_2%%y=e=z)EI5I zE*`zdgl|sY6zq1BXEtlXmOeY_*v-lBv|1Nz6A5dX!gkMjbCRi?MegU<)1y5F#c!On zMEEu67tX%}QUd(vr-^NN*tu_8!$A0@C=q|k{BD@DA({->5bm*+{0iA&h~GFUeTo4& zE-g0G{pZJ{2PM{D;7UQSDF?;DWivZnra3;7gamQ1U(-Xk&fOpRK1>S*Lc}5!D=&QC z%y6mv5?69Py0KxtDXTkWpJOfX5jdNHxYd;1ZMf(In;+UzJ19nzR@}aRwZ`l}{ggM! z)W{%8f-Zy^@my7TP3a!`9fRH;J0b0nc5LdHbmvp&LV0k)xeg@#a;EZQsTf}@&f3e} zQZ(U*tKo1q4%8m*lX{s2?41TPyMq_IamXakz(=$Clv!S5Z&v#zfnv>%XDToAJl9fa ztY2u90JEFI$JuDZWX5Zp=>x1UJ!W@8`qL8!g95xz5Oyr@T#Z^c^0fL5_X&kCzA3uL zPz;jA%l78;VeiY7sqF2|j#mV}cZQqP%jqWzFy%W#)3IOgH+rjS8?!9;XNR+G@3SV1 zz3cx`8bMw@)BAcOlxt)%F_zj-5z9-xFp^yEw-OIQ83IJyyZsg26GBy_T_(^b=u0kdZEGsx zwBDEz!m@LM5h$G@Q#)rqv)0Euw(7S7u&pIL(Y&Fawcw{quk_0TPyDBCBPziSZu94A zpuRFa;TM6dHdf^=S+;+k_y?HWH}Q|oLoxW#KRm`?>RwPN2Qpj&b2&-@GC=y0*mu@s zSkeKxNWkoZ^IgbqacOs6XhBX46LWrT#4M?9%0M-?^<(b@<(H>{0s>~Od(?#Lr0?04atXMH@WM0gqc> z$BY0jL3m(7U;;4xVM0q<5SC_yv*tqH&F&SwX`D9@O|{doElTR;3!R#v++k1seg361 zM-UG23OES8GxfweeY`RP8w1bVtt^$7+k!Y#=JeOoUDg;lbMlZN~lRQ8pBj)h= zb{F*&dM|R2w{p;<5nSjYcv})4qWr%0xrQ5>;e@GRVU%DSi86I<><3S~k81V~eP$m# zx%AIE@0Nx-!g}paE%%=(2Uf#ieG^7mV;6)E^dT7nK=zCD^#^5gSg)n@ zU61iUM_=-t2*Bw(Z)}CifaeaJRv8Wj?kO$AJksMroeuQ+1~D%Z1^K2f2EdnSPw7sN z-67Gy-dRTbYwnMi@V4^_{PO>xVV-8~@GT#U=Smaxkq66g6+ul>nP}hM)o2M7i|0Lo zt&|t2Qt{C(@%=UMzVjpE;pGzQkbA$%1A8uj8kaPb(hkCo zkxmB&Uq25Y_T5I$qTgoe&}!?)F^RMWjb&|j_1^{yEva?~`$$fRZ4ZaoDQ{^s*D{G@6a=i5wTTkx&zDq}-L-kMK#Kn+m`KpJ28C&#3o4M`q zY&h)nHFMGHyR5w&l2S#6^PR#VSPjt*`my268DqSL^u~1ZETf6H&i4^nqANg;lmH*P z@SIjBE|Mx^PwS_BF=$29ZTd$X%sN9d{e%6xKi~pO)oKcL(@fn3w8`SbTRvEp-FQ-j z3^_mL+4c)X2eE6LTK}NlGpqZM^`+3|9>{R-6FN`674RuhT~Lf`D4E$b^&r|X`mcML z$rC7$1b4Uff7J#v|B6XM$+kT?vPp~hZ{)G0ZU64gSJ$UB=Y84>hdV1zfPOZi39=0f z0b~Nn*Su4UteUR^6iPcOVpiVry4eoO&qLZaL}`YFT6+u`1SP8Ay~n>ec3W_J0^PoBQ{7TvH6&ST z+tr4^_d4GS^RhC=FWcJb;=5E3di5INh-& zxu4X!PfIkB8ce6U@Tue(ip7ul+M+*G3D7o_P!qkCRZil0{ep$d0Sx~KK&(RUNiT{P zt&qLLN$-sZD782^#~Xnl!>R>efC_zvJu&5?1NU-|sT#{INYL4=Ctc1-fQ+Pz#GjwF^yE~4fL_i6Y> z%Zhqut(?sI^L>18N3Rv%-?a9z613NTI;Q6L)~y8LDs1v;(&F_|b^;!|0L)&j>fYZs z-m>&sBV6J)v49TB<(sjNr}yPEEN78O2d}oGOFHi~8U-Ji>~CrW>bVcpWYQQOGERJd zCcb;XTsEUt1Mm`^qbZ+|ii?)|>eb>)0!C^rgK$LFd&CKL*sEtoQK{&5H_N;PJ~zTI zlj6`Sk?RxeH`3Vht`~Be>CKtd%jF7~LDC%jgQTBF{AS`l zkytYANoVW5-Ib}&UEky?!8t)C{8$A@Q5uBT$@Z!Qic^O%YEKiNHgj?Xz>!=_|1pmS z9gL)t2IX$5Tm>@HLu|SFp0NLxtQfU5zJ7Ll_~=XHSy1!eov5!DZ~-wsTdTFu7EqS3 ze{=d4bZ#_q90t3~f<8!Pqh2o|zE`aPB|d#XcRbD{5u&_cc5c^e!Prfy8o5VjRmEGp ze!^>SaSFO8r4U+xvi?vm_-^9PFoJgFR`SdGB@?q(Btf4Pd8>?#eX?>qezVY;E0oJW zjnl;bXxeQ{w80OcJjQ-yB&5RZw&S7z_)uazj&D$NmLjXY$)9vVoKl__hT1|Sl&Qx*#>iTM= zy=^64;A{5;lx82<6vp`-lgH0BFw&iP^v|m9pzQ}*QM;|Jt~@IT+bFO18ow=32T3)A zUYho~zPeY>{6@VVn)GdAf6ZJMw>jnxLNF*{;*H{(t0_%S>M1 z|Ktp7ry!_i2dY}i!I)>5so0{F^l^1){K3fFWLmjdY}if~VQlLk&fd*Dc@4=0(gVx# z5vE43jSdYsn$xjw<*k~b)u@AUE+fPnM)_Q@9tIbJW5Sch+bh*ACvlj|B2_r;eaH_t z7`I^BMc6dq1+vZgC*?ptUR#jC$dRbNjr#q(1C-j&p{t^eam^qud8 z-aYQJVQ*ZD+BmMmmh5>ezSCK}!y4vWU&DAnt6Vg_D#&U3miZ6y&g=WEO_$f)`i3tt z(o$CF@-@O)*q+)Y#-}K^$eS&F{js5u?G;0B@E}eQ=>^kHF=`z2clBNUDaw<~mGIHx#Jx`+^s-H}SQ-#5OLGbV z42jhAKwbvM=xf~1@Ni;(8E&*;;nzI}-j;ht5M-FFfWcLdq``KVQ{1a((7HmVH7;Ba zbPf-|jrUNdz$7e#hjw-Di~bGqdK??5YVBp$m-NphxgY{pKT4x*@d1|=uU&cxwe~%- z>fhWoTivPw*8K|a0~~?GiXO5*SA;joWT98vhQniylLP_c z_C<)}6S5&(l#A=~2%6c8QaB*&XREi}1q$LM+gMf%s{&P*n?&38T&FZousDwBO9siN z;wxq1vLa&5t$UhI+qfP2y6AfvVn=$Tc3NmwCM%L`ZT-z`kY`5TvttaZn>_HKE5G~U zLMcnDz=ro?d^#+syOU03-oh+31>axd6I1v4t9w4#$0ZH^L_P|ak{>GQ$NHJ$r$r^I z;Dj^kAo4BJjE0S;(%0gdG0n{Y-^Z(Ib2nDaqkx@Fqt557>){D~DKgq|DEOaf zyK%3ZHjey;?kyl`gk}M8GXo8%;=L}_N_iTC+ceRq8#1~1#y%lhdgQ=X&=C7+6B5m? zZq9`hQZ}1?LyIEPOJx6-;hg^V1oi}u-Y!s+NHMA7BqvWbfl5G^Pv2uPir{DU>4WCL zbtEm=>B&1f7(d>Fa{GbO_SfD&5l7FXertXw zH^xL0gv}xp2n>dmw-$IQLb*p88ldetih1|_*DgEQV8(toH#%Jm^e1;F$a5EnTz zq{}9xR>^3(;LWazS&7W|^O@oVmBm2x9Gk$U*rHUFP2h8}f75bdT9~S|f-u_&hHW34 zcbjYH{=)rt@gn;uaQ>bnV?OE&d;L?l8?1jBh-cn)5xrMh*nq*Ud#@i-lo6ql(|S&i z=Qh@b*3Q4N)iRR}(vzpTTvT}aXp9iD=$P=@Tg^yFiU3~Es61M(1X1=%l-G7z#cn7^ zyjZA{`38^pR_6uPAhwr-Doq0V0hzTtXd99$JDmkFLSA-G@!rCm!1ie{ha<;l*2cvm z(dM5evL*Tx0`~nYXW!ESoD`KM@xVLE)wAz)AL@eTsMyhc_jv12B`L+P9W1kvb((Aw zgtL>bp@$_O93gKMJN%aFkrowbBsN}onupkbdF|+6EVg0{LVq4w{7cY{c}ft0rH{Y$ z@HJ}D$lv?BUVTG5dr#P)k$4We-%i3$wtMW0p^^F^8i3A=gB4S#9lb$mj>4s?4<38p z_eAHgUI|&n|4h?(E@I2+5bP_Y9tiOc#JT+|hJDx22v0x5dOT&^`>0NM)icJ*Y>V}e zb_trQL3~kA5cSYcImfu;^~JYF_1$cNCCPW6c7e#NWNZ^UyytoUqn0;X*97(**8cDK z;FoLb{s3(Po{YxqF+FE%bC(9d}4eu#dE3GtQfUR^hoHhi3>i{oY;KSc9QXsOW+3$R(ZaM510_(s|E%OH$fYr!f+Wyn`GAp&Ng0w4lfAfWjrV6YR zL~tFWX{N_DgM4ID?g*QC`}`o>xHZ#`>%Q&)zRzZTN!&`>=Wa=X5|Xs*&#`~HD6vHS ziA=0oWa6)v$et`d10gyqhP}iqJ3c3~F7YJPOlkBEvr{*+)Q@z8r1r7B_vW?rnwIFJ zK#+*s(til>hO@|6!oK6$<;dgB{rmuQx&7P;bDD!&Fs^8LQR?E|Qmb;ut8u=zJF#|} zQaww<5ua0`c5(dkg7U}jswh3A3YpxkXt`zr_qi*t?yg$wN|jOl_G}m;?8`~5#``Q* ze_A=|Pt_ld+vCU~S1xqHIstQW@#TR}&tOx7Nr$Z5IMc z#0#Gdc0GI+76PFCN_PfEShw1aN{F}HFQOV&hj#zu(=>qgEMs``aCiphU|PJ$ ze^vg=feNAQn(qv7xr_p?F2|n%?YD=3(sAULUzDf{1&tEw7}pyI(a1~VYc3I*VTtQS z^j%1vRETw_6Lms3wqW!lt3x*QKU!&FL;+ODe~Ohvz$!h* zm0#Ub!l-i6!Z!^HyR+ifLg6r4fZtd&XGSf-8wX}COD!I6w07Lmx&!ngkDAvGV^U1f zK6RAfT=Z=?Xjr0p1*nJ76#i&@;2veRyk6Xx{X?7TGL2oiqj z?T(0Bi%Q|aYdt-JqPesCMR_|>_h6&w!5c38pHP-=Qcvhd73{axOY|Q$?6UaJT&U*l zVoPnOzV;@mp6{3VSph{lYMWpBL^pZ}uB$Jh<@mNKTkylyeav}k3Vt0G%r#WIc}qv{ zPxF|mYA17P{vL4QlCpq@>?(0xj^GZ5uKZ<^KHrRywyuJh+rm*^kFG!fERPm zHHr8up;F5{bYMRyf^w4agYxei>7x4TUmx0Nj>QujQlfw1dJ27-dL*m$J|Ij*wBgJ9 zd*(c3p$1-E>b&b_?OC$&CVdU>1bUwr`lQQHqgQo-hs)HY7xxL3*V$rQ-1du5=B#=# z50Pow-di`7?P_e=zVlOS>ZgmR{(+%buLo*oH^{nvIlvrfSJ6sCH#;3h}i)y>JKo3#Bc#A*e6QpJD`7tl=n~EB8sP~Cmz9eb?P4m9mZ(WMlI$gbb z&%9;u&C$k`9Do1%<@95282F`lxH@*|UO33fR$c4jo}alV2=##oQ_a29)X=TtjVb|_ zA4PVK1g_&mi|~3y=%x<3f^*BIi2ROPi>A*ekC=<^GFUU|#Fv|ZB2t*VAKLX)3_y3te5rmlK2!WK7&5=uY^Y@?VWzPPk zzx^2H)8>^s61}Pz`i4nKq$0Y6g-w=8o{g3Ma-CJ`_e^ndG8#p(nbj6(inqFH3EDFC z>m0n@0l7c$Ggv#9n^N@D?XxZO`eo#oG0+%vmg7Ycx@C4<{X^jgmS^<_4$VUY#;T9n zHwZc%hvs$8e>6`#%MQ>(d! zAd;ME^;8mnL9fnZMB@8S^1ii@D@%fqOt+lt)25>R;UN&-!`m-Ge(aI0^}ke`TBa`{5NtY_M6;?! z9#Agik44W8hJSEEjkA)ekFH@KWLo~1NKGPd{&X^uxEv(M8sWq5fVBFvWz-p{Y1Moe z-wW@$k-<1@an0TTWsBN@E)x^$!f2e~ulv(SpNEIL>z;55`&Gd5#9PB76vr3feSzNt z49%*rPW?iCIRLf$*HAZzGTy#har=c{e1xfSd=;$P!kg#u2T1FkMrB@@$pRjBvU%(pybdeO z`E-6Rk2dXr^iVIWBVTV-z*9yN2xF?>FM*`cCZnfL4mG)nOgR0V(gaEIwi*%C?2`bU0IUZdyY;V0-q?Jt)-2~ z4~fz&lPeCw=*5VXfYmpnIguTl-G-ENfVpC_xi@{2lPuhpNdg$fe{*|R?I`>0OVYow zF@hqmEL%0pHk5)Tb*7nS@%9@za^_~9 ze(EUJfbjI>!5!d%zE~7q#!BKE@6AS`deqz7K)Vx%TATj4r%g`_&jEu6zf2|KG$r`$ zk1a=*dAW`)-e~~0Z6W`+*-eWP+oL%5?&N62LU7*}byr^cu{IZz@5=ID)F(Uz)Kvr5 zzC=@l+jly6U%eQNJtb3O`Jg+dmLR^*m#2wCs8v+PKYuKC_%?B>mPWS^LpYFEj@9Al z+?4dDF*5kxhrECnrKiLy0op(ejU#qV;2P1{ zZ#7PASLgfXM567G8~Dl*XAhk0b{)3bLW162ss2~>euaW-DRi1h{k67lZe~=YT$XrF z`3;b79=ixyX$owtO|NMAcaEf|;=^AKcifW`xcMtal-V>*L-zgz5|-Me{G%TVniE zWN2mhGlNJE5EJ@3J{n>n^=UkhWze|%x6^6qT&%2ddJs}sX#?I`8L;c>$+6q zcXZw*k78VbQkss*cv#{)(mD6S;NE5{a3L2yf zl`AQA3{`xnFY9<0E`pbZ({^0*m>SV7*QqHwj~#@15^I++rW>cjz(CJ*hI#Q7=onzK z7o+-{oYrISj2>0l->`>v-5l5l=eU2)ylNdgez3}S zm94_?JG54N-YVdqJd6G%PcvIGW$bD4Z|trs#7W!JG;Jq^yW#8WFpLBADxRk#nX?jP zr!A+?9%YB!xHAW>TE)BJBFR=mHx{=KruV>7fiF(at72xHiI)!rQ8@ecS${;>%bm+X zP(wK)c$9L)+4K{iI|Ub_6GNrb5t zYMwavA@Sj5EW~}P2?&q=c4EzGonJP)@uV*66!ux;;2H9MbkDiQOn(!r>2YyF=ywGW zvTpCjyPiCBC}RFSrQpAaB)K@D?~lGbG7np8>s1Dqj)RapLvj_*ZK8Pe-wCQ}9sKH+ zqpzNcCCK!>2}6$lNHBc6k-jJh{Omh`gM39iAL}-`{EDVLd328oR~BnMGr&o?ozB8e zm&il(nfBE!CgwmyOi zWydq1T{$>bw)Ifr@nX}v5w&#bsq4GU;NBXeB*&}msOWv-h|#3HRK1QVl0hM0^GCa; z1JZF}BYU)3i@=}4&;R+& zV5GTF@$k~D=w(z&XSD{cet|Fo(KX7d59#2H({{Hpm$(PI5$zBYZvdm+yczm^WPm;= zvwh7uk2!jwXRY-P`xR`5i3U%FIzPMKMNv?}eU#sKaYsw-4XL5k{bentnrl<6{mW5k zHIu-jTxPeEQwVvLYbS9r8=Gf_g|`2HeFw_NM4yA>=a-%G19Eov7MQVs=J?@%OSt5% zeS}LUl|uO>F7LJ zW5E3y*Hc|+ZI8wDh02`EQscAOzWbL=g?Giz?MtTPMgEhO+|i9jpw~uP6_87j*Pl0e z^E+Id1Q%_e7aHxnQKmla15BPwA@RP+-6KpMG#^V)2Dq{lCEX&Fy0S>g3l#d!w;~c$ z<2#)W&E*q#&C2qe)&K5bApUfsgndHy*N9Dgs2D2kZBVyXcuJ-f$5VC&`wF~DOCQp! zbH#eKxUJeC)Hy)UZwTD3oe=OWQdJW@EYg%gW+s|A)*G~*G1F=d0Y*RFHs+7|3`9vv zm9TvknXSHmS|V!Y+jOdoQ@?6YF?@&QY_xFOxAG^laUnJn1vZyD?V6()1(ZK}Y^UI&wYMd=zx%U2I`V0~miC$i`ab!u&nlROT=XJXtuduH!B* zkTrKf0>4(q&y)A*eypiW$cMl|d zd2NV={})?V85UL4tqBon5NQx4l^Rq!RX{*WKnaPF2I+F>10vnhQqmwucMV8)Hw?|t zLo>k4aOeB(bN}5xXU?-{pS{<5*IN5L&)#RPmuw_@MAq{DUctB1HD3ES%eL4O&8)*u zA=NXz{T4~TGmk9%0@rbbVm^$P5{P{Gx2*fjPoFGha{nq7naZAzWFDoH0ey_oTe3cF zr{Eqf@#fF8A_Rh@K$qcR^X+}vqXkN$xFx+SRtj}tfoezD@*8ip?c$qJ61MeB?+a>n zjOFYm@@8ODZ&oD2pQ z>}$T(@4E&nnm8Hd-15){N!}Z}@eTw``SK6uh01=Tz3@LE%Pb+vxT`v*^R z`5-LDzV*da|I1klAM*P>huiI!@MtAzZcq;$BH$6AyTJBm&&53WN8a$@C!C84j$zyC z871jfcgK=y!YUM5Ue@3oTZE#V-7+&lN+x4?Q7q&K&)*Dh{#S?o0<6>aK)^w=8!O>o z_&ak#J}D6cOaCF3x79zl0bFMg)$9@Zrmaal z;F+WpC}8)Hu#sD4St7d;FYE8()2q`wP}N5tY!$y?v37gglSpO7XL+sQMmM5*&ayqu}QUi@VkF z0F1s|&Vg0f`pZ;23BmZ9FI|%7;#ueCJVgqfwG&?T__oaZ99FQ*`2HCFoZf%@QG8q= z!j{l!iEsMztr*$5&yY^gruFJ{#}e6O410yUUJ!zMclX>=wmFb>md(sJ_1#*;Gn7cH zk?;EOsnu(Z_3V!D>+{0?XLK{ z;ru~o81l|dj_n#WXc2_kBEJsfVaBDvKc2Ma1lPQn2c;@ZmNdFMf5;U&*wEmO^#I&e z=Hs`C-7@5uHt%Hw6s(!fFEubuS&(Fi2B+ra(9A<%O>+s= zvRCuc&z5Gmb5R7e(5NYmySRMw3@3bj>42s98JAPvI(CjQBdp?BVwg+feAoj8<_bd6YtHLfnBo zDnCzbKW7|@B$?Eip8ACxq)yAT^IZq6!9NwH+hHdBemOS=AxXe$=?lQnwUU^bz3Kd0 zRQ?pL`gkbR&3k)E{Rw70FqJm03%oNdX`2S(T`lAtWbLH_Dxb$km{I}R?vnkFjJYsc zUn}}NlV4V4dig@pgaE_0mkpAIB8)koY~O{1LC=e`79PJrb-(xU*LsiQYy-EwNk@|G zk5g^Ac7Yda

    =3P{7vJ*R(-H;8q2{_0}t!)a@I{xGEE=;`&c1j_V}(C*4BybQky! z-a_j|C^W^n$d2|2CdUt2e#dn}SD1%@GOncJ?6;GZ^qE(IWnPMW)eeIu^gb%hN~Z`M zDRbNlgUX}QCC}oJDr=w81f17F`CA%dbQRYTdU^kvAJWDPR zf^vTD0;f2q4qD8kx1g=?04j9k<|g4fC^BAgNox)jG(&sb9y1IsU4QEfPyr0-ljW#1 zWJJ@iWst-P-AW^Mk4+btUcHQt7(4fluLw*IWl_2jJwYS_XkPir#9k2snvZ^c3+2LA z+iD5s1^kgJy(7_zgV>RE55DUWog|NU6H3%S1U&t=7Zm)~K_%L4wa!$4C&RXfKnQZs zvaHNK060z_&wQ|j?gEpyn`bec(0#?M?r5%q6t564v)8B~jFS5EUr3dvRfAD%tIkU% z>CaecMjeH746l2^^!)1MVR!2wQi9$zKqC}7W`90dM+qnkl+1kP!n{?{@%2eTlKeH_ zEZK6Yihqts5TycAkMuG#HBdp@sDQy3Bnhw1>{JqxWNXW%e>Pj^^*qv3K_Ct4rm=)< zh(kuiR~+;UiU7~`pOpVnKm|4az#IvjB%5Fw_X@heUZOAV@q|H#?B;0wz9WIbE)YZ1 z3S*C8U3ZZg?@97i$sfc8B``lz(BO1RfngJCR*gv;2A8$Iauwph{1jVJp2$K*{216M z{Y@(!CUOt%L1=|S6YTyLxo}}l(F%L5OkLoKvMuP%dsNU%zg`{a z2ZCMAh{DH3%Gt})LNSwF0QedC%$0&4Y6H}1FQEUh3;Y;TQ5S=aSRzB=hKynGdKtyM zPZ+uv+#(|ZUjJ~3FIl(;uCv3evu0g>!D8I+q!ucELig8kUV7IK^R}LzM3)U)dMwck z>%}B1Q$E||SRkG=lU8tJPFt|`x_=@`v~%uOUDiR&!HsNb0A>|5bWS01b=M7EkW$Hq zR9p}Kp8JxoUxz;-uQ4OVj(IuvPuJm!8(=WMyr~BTcAOG66_!NBejA)B&fjGPc8yobO9bLZGt^ssizPeQ6R!Y`3t-+)F>^O3Uj@q(qQ00NCWRt%er zytt_bDj!JT^ue;hN2nXCg+0W^n@eM-N+^_B;cr^j-DNVlv+?v32W0*X>s=r+VwxqF zFe?=L2(QF_m=&c^29G|sSqH6P&q>TNvM39w$il{T3XJK{LjjVfn5x^;x@FtDRZyL` zNb@f$Kyz5K@~W zISQX7S9_l;#$y)}S>Gym>XYO}34)Uqj=K}O_l>>U`0Jo*QP9~b6`(wt(DYFe#i@8S z8F4+*;!1uIS`+?Jk zK;=Z^mLGOKaZRLe@%5CQmZs>jiFl-~cyVM1JcH)IkEZ(3h3q0kDw_MD_G8(3Cd&rFE zmPJRKuoMow6rW~D$18oh{hV8a+ERw-z&h7vWIV*g3%(nt{x%5JEZ&u{<^gR~`O2mL zd1audLUL4qUqB3IHrrwo*3qSFVaOQn2FT1DKD}dc6pyic8vVMt#l#c%5d83RclVoY ztZ;YENZMNJO4wC#k#W>I*_+_uorOwug1nGaBOjFOi+4_R6oqwNre$kV<)^_oA6u)v zEHP(#d2qkJ#`8W(`Uo}KKWAj^d!A8h1x=E6&CT$kKg(g1CaJ#9QzwZZDKrzal{W{Z z_N?PAkK_1=VZT~Q-4DP6CVOuZc1<>=8}@)hYq1YUhmjs|&Ila=Z)P6ubSDp00k@uZ zg6Eyp*&!?8zi$>$ZlP6ooywncsmR-*Dn|%l=>?XF z{3Q3mAtcWI@VCFE>Xr3ZgQ&+G>|%WPsQgF8C$l)kdQEG-E}ZNGpS$ji4~M8d)CpUE zi`Kn|qMsZwl&6TqaDUhxhG&q+3LMr_&V4l_PPnygQw0kVCgq!*uWmB_PP?bXDgEK! znta(vg$uXa&0A#s7*nG+M`=bsy2FU)=fIZ1`htfKQ0o30PS|SqXeIv|?69i}F`Y@^gcIXM3m~b>Y z3#b1O-ShA9-fPWG)5DYNvAoP)Bl;>eB7G=igeEHfU13V~h3?s>Y=@eN$@W3YXY{@L zK8+3i`=3VRkS5-bgvp(+SvFOf--tMwl9NqLj4plsd-bC$255AdSTqXQV_|VI(xxlU z97=Y)q+Sut6iP^`$8osjyQZSqA;x29jaalY47j{-o_NV^@cZslO1G~HnJni(sV0ki zM+2mA#&cx$hYR|a8ezPcGo8H@W2K&ECXTo~Ctp_;T5HvfA?!Cv92u94QR|nEURcVm z5OY`E@1u*=1NI(lvHBs1XfH!Xf>?$X{chQXUo@j$ow(>U)+vu&O!u`Qoqg)_@wK)z zf(GU9;mPe33>_wtQ$m`2l`pjn_?9Y6C+q^5CZsOHy$VPx_>t4wu$Z!Tj|CnkwyzZC z(Sqt^Bs1_^#_e9Xa)NIO3yC$XD|JvKwa*_X*I=H-?QoHLiOUxt-~^TqPp!X#OW8@m^bz- zDY+w!F=QFi-3*V_@>w?EAP zB!M{hH907IyIgWq8(W$V*mck1P#WGf2+Srogd+zP>*C`mb)S?~`%Mu|&iu&yRTc9l zxfY0DAE@DAuG2R}M|}-0{f#Z$Vx%&rvafmbFY(A)2W1BMI8%BQ4}V9x(I0Ujhi(Y3+^1ZqCU0oYoVKK8aECreGYO1`{A{eYnMFx-wB=bjF`C* z4`Q$KU)Ov~u4mKZG&;SW-V6QomsgcsjuPl$`IYKXO!M7$KKWW!+pxmEP{`G8iRIoy z?{nr<(oV90cTfz%p92O zo&Q}krGO{lL~m(r0wE8Gja)&U2c@-)&ZDyqmxp(t`sIRR5#sI z4r3I!RzO@U8+QlMxf>JqpY4_zHbcj+toGGIL*=}14It0l1rpBkB!@sMWy_aHIf&N| z;~6aCcRb&ykz(DEd=1|+gIv=q4*?qm{N0h`n8}NBWyr@ejz~kx{b*SJ6mV6AReRxK z8$ro@)0wQXdJ6#i8ntD&oPARNt`B@uD9Pu|&VTUf-)2knxxL-;yclBfGhN-05XY{r zJ==0Iv5}CDaufBJmLmezU3DvO!&#BKBf)r~-ml7#`vyIV97>QjPpJjw-WirKSlwdC zT=Uth&cT&CIqfC9Fg}iDz@(suWTrg1r-4{_cs5Tmd>J+40zedpyO9^;>jib&1o*H# zNq3!)?GX}8q2vlX*!ff3QIV9ceSVdDFYm#{uS#fhwcyq`T{J<(^ihxI{ay9(c`UDu zGQ`DOVefjbDL1ihBSmIcon|8(EW8`tWh#Sqn8;{~%J_4u3|Rp98n)G{-K`c-SK#vb zrpaqJmt~g;mN4~Ja>Z%U2xW-JQs>1dWypKG*@B}Ck=Nx@uO!&>B+uD$T_pgBm8F;l91VO6`R<puMvulu4p$$T?~}ipScRnnyXtJ_ESUFAXEXo2*aF-_ zY%JZ-_YEN7{N$)#sN^F-S{BJ!=X2TSvv;TAN>2AH?+Kqq8MzlyrPS zyCW1qxY0IsM-|_KGFIf8w2eRcpckNS@S9hM7LIdGazGrdlwXz`TtdUW3C92ud~tdT z{dttIVy%CR1UG5xCZ%V+ZOXOwoAV5IQ*`*UQiP3z_S^|Fu^Tkeq2jat*P^2v`+KD42yI&52iLx(s$vdQHV0c zx;p0?s3IW^@ci0x3tIr1s5KX568dLYO6Eq%W9FMS>Qr1=IoU}6{Mn~}feo#wQ8rE` zNK;7ZS8%m^i0A6gT*u5XA)(|j?_;)Xz`$6tFE#K)vkJ) z*3zNGM8+Ln;dLDS|51%R`48U+PJB5s5x)fa|9+~GA8*3QinoDR7{`G}3>aa_Mm`xV zVc$mbN9}y?Z`;ow*ogX_S)W@7^t&edA6k{?B9ySzu#4 zzKdct0+GH?hWCiMkQVs1euoWsQU;U}P|%uV1kSO!K@LK2eJAA@{j{qoQ^Du;?tM&R z7S;YR#beZu6dz+w2&MBVnp}L9rdY=Kw~x-Q%$Ifp8?acJa4Y})5upB=rqN5hTX5_6 zO&C%MG_em_=c9OcU6aI;E;@W8?GqY50J-s3f7|SM%66lq5OnsWN8P|kHYhsAI}?Uv zavpwhH$~L-Z(cFChcX7n+Iq$k*C{>vpiFx}s51B>!B;|@X!eSBUyrnO#L=u%f^X>W z3yr(&-dl=ju3Fq$I>5Kc|DycrePr+%nlU`6jcspNtQgPCT`uGc@Z0$dV=TO?7Ia*U zveo^9xNxKR?R3H=>ysY)!mkYYT4(l-;lT#{b{o!wG88okT|>9>WFV!FpQW6LX-)o^ zbkNeKKv{Jhg|r_^U0wyGMGYU}X1On#o(82C;ksBc=;DUR0IAEk1L8?E_$q_^t^te` zOAa{uZKSohSyxy55@GbG=au3gWDbAeIu$@e1f32k(!^h%(6PUNUG6|F{skI9%ruf^ zmmOFO+F7C4sXBo_1%c(`-|dP|x=U+wVFNX6GNd*kQW!zs^AGe?eCzj_rs?e!5!U zi=gh`CzFGAp1n!Kv8)( z6Yqp6IwtRUCU4m@U)w&1I&XGbS-NZ(!ms+~2MXB8yLy+03y>MLk=t3f7~qyV@e~u> ze4N{WdzUm*Ii{6Sbqm4%4&WLW#}(m!z9R$I?pJX2e%Xu?aKfbWu>7_*oFZNo?X)BN zJ@ev?`)@$2E)DOvH{QwSOJQKagNm&`XrV8Ytt`1Sp+wNTwIKVteK~{GD(dXO_65d5 zcaczscXSs1>?)D0|1fEUtW$W03s$Imd*I}Kf}|{P#RI*@J(Ep!`KX*Hhb*BKt@hE5 zatUe?E+TSvB9}CC-}`8Kp1*u&Nck+j3HL;PYGN4Jr(F3%YHa>=L|nVO^|9Yd-h_*o z!2Mk!)(W%lXb~P zFzZ;dZ`b`zCF%_!Ycx`qkK8KzODs3#PP4KTv(qqL)k8DxTk^F8f87K4%e+*$$2b`XCXge8JgpPjYm3JRmdW39se!eu_OyydK z>|bCLsBPdTShReut+DEA^k#Iv9e_5rhU}+)JzyoQd(jr&fytHpl^8$=QCf!^GGADW zAI~h{p<2Lx2YSS$^DT^yg$I^=@66F=CV|($`tMg#tVtFz%rNrX!Q2N!cg_lA*4zbk z50UYso-D@;uv~+HZtdXa00mUZ6@GJasw4gk2y`9j#~Q(zw@x7?cC1C)x0)q%pJxOm zN~V`qFNyErYT8Cov6*U0JZ5aej%kw{=*9fLil{A{@9ZMid_8~4)PyKa8mU-o4IKa! zTuI5F^wbftD2xWxf;*>=D06yD3MnbN3XXJSH1rDhNE9LR#Yw)@0-?ESg#?Fh9;NU9 z#GkdD8+tA%ZwKbAe#@*W`E8KFq3gn6Ap~<{TNU|O#38)KjPff$hsEa|w0ZtP1hxEV1`VV5K2PbOoac;`UdU?~ zP3F>0$JysL++B(8OK1MxS=H<&cP98(s$$Uq9FO4KxFS8-%{O4B#0z#o<^||&ZRlsd zCiLW1JYS(Hd2YWgj+ByqKL0=#dP`>9PF9NR{iP=S&}%g$`-z8!9_xzNI@||v7?wtQ zw@a8bs1k`eHptT;^~)GxbV+A_9Hi0J+A zhe>4G2GhFXndMYrYZ!-4u|9Qbd*jC{I>i68O2a%ruFg5@3-pVwBCX&-Jy)hICc3m^ zc5tk?bF_EvGwCR3`5(60scVADW@oS3OQz#9Qey%=57@(e-EPUcmaFnBV8ic|_}4vX(TQ|ZaZ-bM~@58xYT)K)$y zO4gksx6`stB+TOCUlS%+@GdC7?>C(;K5wE}6udMR6pSR5b3 zcoE@klvHzFhqKFwi;f`lUZ{`sy)zZm&M<`_v>_>Np#$ZT%lC`uY%o8JL`1NDj^o>3 zLh^JGwUFy>;F)I-?GWf`nJB0orS;M`hII%evF`g;5XvXCV2J=;`3IK1kb+vvv_!+{-mJKKsHYw* zhh>3Wjb&kN`HjT!!@XT+DoS-cnc(1<^!76qb9ZcY-=pNjwQCE1IJR}^g4Lw_P`&ww zbRB;;Z@+assYvCbK;`=O5mbE7L?6fr*dwq8(*$h>yU63p) z`nyxm;}ip-2vJvih0XGWj71z0Y<^k_cm6}(Js)xVz!W@GPNYc*B)+ZqI? zn;wyQ_4{AAVT!H3s}Sl6mm5f@NW-CF_cFm)beCOU(F=-=8d9f-H4Wm83hyuc3|N%i z$y-M+$#t|3OZ_Ey9o3I?LS}NMG84J6>V2)37&h?}fB5l|#HY>UY=-FgwrO^JK@cja z`hEF}pYq_)SjaUeM1ui;JGlgs^%3Vb6Ll1Vt|Q_x7KCm(<NGl$ta z;UOrs1{yksdCB?qCW7V=v{wV2yDNm=o4}YV-40sg?}E@Z0Msxaz4h`Cq+tVS=At=c zFO&TiznY=HK2%46sgs%O)`|-`@_BI!=IpSOYe*T23jr?^E`BrrqYcH^?$LPn#7!jUnXZ^I|_23IYTe$YN;l`uu05Mx!Xb0 z1#l!qEaqob_&FUya{}CC1L#BJ&XeICc~E-mc+Ah6&~rKlxd{OLSzZZ9tqnO(c3S{% z3vi-2pC_It=cVOAnU9{J6@oA6%G@TvFKvMSZ%@z`yoaDhZzW(Y8_k(=N!O2`2i+XU zOw7vNsJu7?QHkV1i>j1?`8T(NUJKwy*1&EQ=YNgcip8Fx@%_!9}$|$e^Cbj|Ma?$xbF<6P=N`R;8ZG_k%$lC@8!&)Gi zXcy#M13e&RLtDs^?t&(500v358 zk5B^i*)?tkH)ivok9^tCTT?>71o)8+P%O%c&hJS$PY%bO04GggPP?%8qiNWQx8-gI zU8pC(IgCoca~dx67S;{F(kTHp`Do7R^mDpp*F5O)gLsT78jITYRvuJHP#Gw$=RjN3 z)9ixaxyk^MRV*e)Lg^*~K|28swgJWq(D^?vlLN7iGmg;$u>LE&04`JGMsJB8f(jex z8=$Bh^wy%w1Q;o-1Q6w-6?WKnL6TTNGT+=poVrhdbyR<1st(0>K}j{xyrNjl`eo!f z9RU_JYoHjae53N<5R{e_k98d^dMyGIVDo7uVAqxlZ86R@0Z#ds2NlEm$ZwS!6_G;_ z&{XrEP*}f8Ij75@$b*{e#9@B+soe~UxK4n3>adETQqPmG36+4bLi85ZAt(o~3^ZC| z4er3d3o2()22z!8Nn)_NrqRV?s!o`9LDI5Hz=@&!O@utxE@*T#7E^WbbQh#C6Nh=2 zr+O3dPjDB+$dU)O)5p$oAHbgg8k|C3vKM)oo~_=Uk{Qs%`dr?$LxlhFs4n{qZj7-Uy>aV2p-S zl$>ih0eo?Z$r@I*ih7ZJj2qn`KacBJj`sJ;B2bhCyK-0jmFvR==s8NmXKXt3Z}PY5 zh1Y$K&R?&3U$B;cV z(!IymGF?R?12j2(;$>#NbUV>U!bpZ`+P*n06Sb;x>#Yo#LPWdhma=&=LnEnMe;QYi zZ@u=O!x(5|i=Ju<0UkYWVr3g2N-9W9c@VcIVzO)o#V!=<7Z)dxLzC7Z;WK+G15uCK zjwTGzx^<^JV#q6Oc3kR8MXXfL@TVj9hZ-qva_iImCMln?AwO}V7B3r5x^&&;zdqz` zR%?z%=LmH->5|bML>Pghfyxs~y}4UD_fKxn_z^xFSgNG}KqBSW_F%Y@mbtu10ENO_ zUH?Ju{D!jAruR-tAG?;!8$_nE-!URsms0=K?hD4hns(Nwwq8N_!pzE?F`~`!d$$t$;@5lR#({%g2PGkV9<8a#Lj^KDo`yJuVEGi1?u{Wt5 zOU)BOb1hsGXqZLmpH|^lS_B7{bLMyqCab0{go zl$U-S1_a@;t%WWu9Bu@J=4Y#1$2>_I68rQ34i-PQAAHkg8>S*E_Eg5H7-=2ztmOq; z`~4HeJtnn=qoaMir3&)epRkaMXx$M}=>RSP_zJ#8nkPvoT=6PN+TR`g@vkC6IG(*~ z@)86rWi@*dzFfUsw=D9;yOoc~T)!=>wPSBvS(kS84~(quQ`|wl>eama;*$Bvb^~4% zKm8qs&((`fW%3(20{BlZ2ita2cx*P$s+-MSSeHgj2TRiId>_a59~n+a>5Ga6@@q<0 z7R6@#lY!g8if^BU`|iGp9)rFpWSAxEow*MvJ`()b{oUZ>-T;HZ$wZZOh!`ojcr39e zIELZ25Y66CGv8k1W4h4dJj~D&eAZfMALCxpTjt1^ATB$E!Ms233i@7d*Y?yee-eYX zBXZVUIqw&^l+_6@Nql%ShqllS&nms{6R0$()i~&~y-bShFyJD&&p?#Xy~Z;#iKV;L zo^ctSd(z|6WLbKC6A+|o60i{vNf)l#yLG+MqP(X{2z z^1?0k+le89dBH8^{nPT1=(`zH;`zJ>p>`iF{*;3IIL{Ok8uxQ;m-hZS^@uCn=Hrt@ ze$92I<*xcw`t>k_w5)*k^Yk}0vf>|ZfWh>_^K7tggk|8(Yv z$Vd)%w~g0)3l7!$f~3k_sLKmlQJYGwJ&DtC(ZAnR8>hb%|1Rf!t;RpTd#Q;&wX99` zOPG0{zM;6L3Ercs*ympFhYtSiKeUY3Zy76qhpQfyJO-7K2$<;TW*8V))yCRL-T{*W z{nt4|8UGm7n5Lkwc+U2Ia7%K}5ztJ^(ng%ke$C&NMDM2R@J`n`ZxwGM4lrX$(V|sX z^M8ipV`zZE<9gOcOMGDx!Bu|8vY9yajn&D= z@?T>6HvnYTXq(KssP5zeeN*(v%pdTwqP`fh*~>_}^MK=CjCkOljJWQxQ0%ez?y(T= zWgxP`AmrMJmVDUtyVkQPufj|(MgRX?xl_Fq1H8DCBRmSRt)X6uX6-FGG1RBYsNKeo7Kt1ZmSk_~gT=vSFS|t&{It&m=-Uto*&K0G5jpro9X@rclVa zBPBve3n4|!0i()?_2AcPY-plBol1wfFAa=!&pT&@=V#voL$iPwd`yo0;ThSPh{ItbVxe7 zzXcvWK`;+X7*N1G&#yDNJm866yoEgqw@)=3K5b^e5c_!@l2N@}B4{w8Wo*1s^c`%C z2{~Bs zcJpsX{2}Bk8ykd(E{i{CSp?FEUgs8o!ki@lMsIGkDf^{*_sQpjjDZxpgN!!ccXN_t zw@9N7$zU_?m_W!&t+TcOh~*|p|91%Eqe0+1WXRD?<3%haGB_oFH6ub@_I|r$n#KEi zY$ryEAzZ`*n-M=^7?zk&1P75GYG_9S+x=NrjE{(PzuNl_DU&Bg-A5?3>7-cV!#uz7 z*wP?;xPOXX&G=af$x9B!BpT$BG}Yd60ZEPh^vP>`6qA zoA$q%y2sr0*z+G;V&F4GYWnU9A)?eLAn9%CxSnb2Sa!hA&i3+s_|JsU56a34oE9HB z!uKANO|a!EcJ+rQ*;GT&6KeGJAZ_ON@Kn@J+J$VsA zfB9xRtYZ@B+Yo=AuLsiXFuEQ2&OD*Jx0p^G&!p2K_{YZx5F?m6NO{9B#yWqE7g@@>$b|k|IjCBX3QNqVwm7Zxj*!kZPF*y;+stu&z4`fKQ;Am)S1V3q<12p*Zin~8zjt`95naO zNtNp+V9irhs%aa@UrD4QnQMl>EM9qLyY(1;U(}vY1hD`NS2mC+o@ywPTtupkk9HAzwk)Kp4fv%mrob1K9mU@ zf9y{e67Nk95hd+Pg|#y;Cnl_JMdTge#3UZ=uWfXGI%&%Xg2hgI8rSuXKl@N~3to3U zCFW|BEGKen`iD+0ZK;1GJGaNVVP{(ySo*#G8tQ!OzZ0Hzq{Y3oW?#}eH?1W}n&s;b zYFuF|LpPj^FPgAaCCcjg^7+jrk$r{G%)tLybkjRGHt5oW%2C4n(mkq2(zLlw@7m47(mn{AMM#N^bqJ|ypVMjQNqNr^O@GI2JG}8E2S`=SZBMI1-gDuR) zi1jquyJ&6xaF;CtTJd^*eZYS!z$Nxl?uaGQ<&A9pMc_KErk%-!Be|)S;@6Ns+dWaW z2Ee?Amp7jD=r&1HHRs;3JEDgEj*-`=QqX2`vG#t0#(Q1~S;8+@HZ0pUlaItIUkS&} z@I_HUfP-{E;qxlnSH-_0dF(Q6Hw}sdnk=@{rHnN141dGJoHXVVDC`>0TWj;xf9Me( zoafWbBaIN`$Sgh~!YG@I?mwcrU-q~AMh=o6>z$a6$y_K2p56?(+V83Ozs@KjX3YpZ zJ{{bO9^^3{-!8x7v;+FbJ=U!Td;w`wEq&hO4-Gw_ zPO$zi^m^a7=6UqCpTc=W1B*MgY*X^{X*%!=Z_IbZ%h+VnI|Nm4`NPkILFuJ20L z^9O|;(S0&2fk(x$*Uv6?>N58I%L|RsBTbL;-qF5C!tm!TXL1jAzY_S_`FS!eNRQQm zMH|$-Ls32MvqndhEDdd=Eo^}<})9rffyFc&gzM0fr{dU9;7kP*Qy5A zqM$lqs~f_d?scA7Ht7prdr1crOmrO!y7`{HA@0t;8WQHO__alJ)LIIVF*TJNt-gru z%7Xo^Et?Q|R;Q_JeqE9{CuHqsFS0~rd{4?`i+(nkKVflT$+>LDATKq;!X~_s7f)K= zG;(djKUhJhhqr3XK5gBU&Umb1(L!oP9$&Xwn>=Z;;(Pe;8H~L3!LhMKuA5Wf^U|lw zi$~hE*k@*mM{WUMbJ(WOgJ9m1b77#uddID|{ z_(eVljL0;2e-FoJ7pB%`I?R538tC)&2?0p`qjf~hj@*G!2ceo7aN<#Yj7%_UrkJrJ zADAK!@vn1BQkwiH@6*VQ;EM?(&~tXz7r3J*OeW4OI-U9R+MK7Hmrv`vbc``z+v0s{#h*NiCfBSOwF_;D3JaA0`u%60Qgo{O`dBc<4S zOsT(kvx=VORO*J+S8cA6AvUd0Nve4X{g7klTdFm%wG9(}dXARijz2bXNXeWA-;GVa zd^?pghVUAkTlf{5dz&RCqq9~paGV_KI06>Ax#=Z)_@nQLJRfCt1z{G_%1T&GqojCy zR4*0vgNvaFVBivZ80j$AIQcUcbjSdiVmr9loxy9GieTbPMOe&h;S+c~m@hhUc zyR$&-aZ|>MJNvrjjv4ZbiB2BlC!30yIUD_DoGhL`c6P|Yi}cipR zCiK?7=v8M{V?)4P;l?2plM)f~zBijhj$&CBj{>-fYERqS9E~`-=dk;2t>yBT%K&dh zJ*2eSXxA&B$Xol$l)FDtxYf_qR~F7X4gsJiue;6&MS%#I`AaJC6C!p!WB%EVcnqOL-2xEP8&mb+^6+74PpO@ojr? zdY+YacXP4P1DxHBF8$tET|ogTiaScUs~`2ZJ1g=R+f&RknC@Z2Wrj<7BsxpHGc?cy z>&IJxL9(h0=-0i}9o&&(^in;2_<;aDx^E}3jBLD1R%Gxo;`qMO zCb*5$p?G%^iRk$a7jSDCnhp%$_G)p0H^QGx|9ysfjfhrFUFS$q}yT+a#S#ERZUqMpPXX&Mix3gii?RtrIzIklvrs=WJhbQE z5TIohu`VX=WjfEB%l)dR!{*M{R?PE>MiSV(OYZ)XG~3F_T**JG$BFICCIpl#ElaIB zX1E`tw#X6Ez*UBb=QBC6r{8JnX6w8beuZ{Eue8-15viiw2dn+1jr+m!b$XlN@z>)- zjdJ+e0}`E2rF9z=339aC;|2!r8jnZH@rEO5HCGvR(Axte)YUPAe*Hrn z8-)+z%MEhw{l1=#Xx6eVZC@$+ju`xmA4*yRb><`d@C;BeGKbp`zb|Y|%(6)ee)4CB za2-R?<~Wn^DZ}lDFMek9pXj|OeiwClU7;ini94U7GEO^Oj@sKVtN+9{Di@E0o0HOh z?wPzL9)6MieluZY_!%>q2#bKvF0Q5784|)m6#OcC83wt1_yIkuyjwr=X4OafllpHq z+Q*`uho-*(V&)hL@7t&Dl1aLVD2M>5;$lRpPtxTJz1mZ|(L$QahCz{U8X9TBh70+> zI(#|qSvJHZKbEG!QFLI<+{!Na((z;NT4BJ%DIdJGIPbatdkgis`{&XJl+dHTI^z-I z9MvqwM%B4aFH5}z2KG?U41X#4#Z~*O>I{qdH;?C90XTY5;v*hZGBBo|PCMJspO>Fq zli-B2Jk=2Ki{#0ht_!c9_vm7UX_5|M zAoBb3>Y|Q^y7$OpmO&Z}#orhGP8QK#FUOue!x?dxtDz2&b#`<3sSrZNblUu$!0=XP z9nK|fQ}b&51YB5y2VtI^JJj)tvE-gmSFWML?*zUh3f);0(b6jQtUZZjp>!g+qUqYN=sd^e>74$Fse}w{6w8_MLf((Jk}e< zI{^lIZU#;MhpMj(svFwcrchjqyOiRTgBEuvR*JhE+}%A;T#LJFad-FP?(TkYDE@Kp zegAyFGHa6A*~zTER%Yjs9{7{M1G8>B--lWLI}4n)#u_%GO%rnIpj8}Y^w0pU9+q3_ zrJ;XZHUW`Mz`Nv<*M=yhSlz$)la@`C^Cp*f_Jd9R8n zn|r9(-rTmaAW`<<{@A3%fWyrg(B2G_c31PRM=R#dQcJs#<~Lo zF}ZrbnSBCIzxwq@UDt9(gyl|bw|EPVxkaZ=X=fUZ!h=E8W>4&Y{70T@Dvws2a}LYu z8Sc4NFx&+72vNdBsg;M7;W;#{Y&${+;X#VMqdjXL`K+d$%i@EDe34L?#@) zrT+e|78Flt@QYF@7_*tdgzz(+QfMX272k6)hvR=WhGB+{Ca-R3BPZ2$Ia zuwq1;0s`J#5L?ZA7aD&yt}73EM`%1lsYdyU*kSILx2J1Bg-M^9+Ma_W2f#F+iNt2? z6;8G?Yp|5v=7@HKh|VtOJTqTx{IHv}e7S*I*W0P3{P_xJMpDAuBrW>Jr>?2t;$wzh z3iUI!lcg%=Pggy~J8T2E$q-hb%qK(QJ6mUub2My6G~AE=D)mkd_&B^AD6qukiRg&l z(9OVHil&A9m359C4jZ-wK|BI0KkA^NM9uDFdPQ>3#3v8QgoIy!>mJ z#z6=u(xt75tRnp0h;1G%T_^CWN4DZCOR4_5VVisxj+&k9Zx1_pTdK^)KdbUYWFIlN zCg`yIA$HG67bT_Eip+$xly_wdpD>*xiqeqBs!W^;bLl(?Y+6+7N3)mFJ<{mMuwX=l zMYE2GZiC4p*6n8Z7udTr8y8donv_5Ik1CvJ-{TS1vmnFjw}WB}xOE zc-x83iM9v768TAMu6?KPw|9?XW5kWGh2SF^nRyq<*C(IyXNBd!tOaPMv7|0@+m}Tc z#?!?%pp335;NM;LTa)jj5ow=l_coag@l-^}iF+|@2b zOj+*Kg>rZOL5};=PX%(jf-jH$^ZY=^^DrZ(*)`|m4`gKjHJmJkh85yTlPX+Z*1pR? z^PcXn!i0y*hSE09G2L=cI3Sl;mF~^0-S3@TNMF*?IzOi}pv#Gu0xnW1M?1^wtIzbX zh^Hf9b4PMToNw`&4kqE8y>&D>@s^5&v|HGUppzri_HbnmUC_7SG?#}0@jGfRV8NU# zuEM`n?#3qsF!-H<{0#gVkosjTR%#_&C@>qap;_J4gWchEj=xUyk=(?B?2hFthG}Ow zeglJKtsC6`%f}DFlE+yBOwL!FehwC*Mo-}3uY@IkHdY+*K z4!s-NbWHg-u2o_td`zDTI4=&>%Vd9q{a{0C*B5CEG*TqlOf*5*;&!7e6QUl(lu84Vl7p33zz1{LhmH%e3nq?*6+7DvL1Q6+dNzK zpU{w_Kd19&jb8ntrlTu!RtX`PP7>?*VVFi`TS-}-gk>lZcf`-zh}B7CBjjET@;3N$ z)A8nb#e$X(@bN1$I@m_fZwnS4{o(&<8QMy__7Vpx!$z!Wk#wzpQa!U$?{c{v^TZ%| ztgTen(x)cuP&j%a#j|iF$;KICCD@r?7X!mYJa=VA&9vIu(a0LQ2=Yx#chC84xKy>< zw{BqWBd|LDD)RZW4aHwMg0@wiu8%c1&}VmHv2L@|!0{?IE*(nrI!`&tv}D@U5pg5$ zNEGDZndlpT;`ee*@cP3D4vWS2sQaUVg2S;dXM32&NS&D^PNZ7KP#R>FHYY|?10$|- z0Q)v`Zwgj-Pvl^kyneeSjZ{AdTL%*Hi}37`0smaqUJG(Vz5v&jGtNa+vuyZ`B^~4H z@y`4HTU0~|3r{Zm{BiE3n7#DYcbN!#yXBFU-5}RrE{!($pZ`gpU0?l?R6A^0QS)(1 zBjCI0pr*<+52av2^Lv{8gOB6v76U4R<qmw=WTCw!Mz%&=m`2Yt3q$`o+INveBVO>a_*p6~v)Mj6{DXE@dnF3%Vu>8%G}^ zZwx<$xuaLGGMk>>_o&6VQsa2?dFw&7fN4zpD4>aAZd(&RbA~ItxDwSye@}5$=TMw6 z4(u1GW1iS|zBbWDMJ#{m5TuXr&?j3_D>oI!1h_4eXk(AsL<_wn$IH08P_z^HB%b~y zcS(;96m@41k&+#!zOlx9e36df-iusa?Dr^71Sn}Vi#7Aqv7?SceB*U=_Re=Xb7VGDDJe17z3@l~rG39DveP-- zBfdZ6YDH3w>G^WrU-tdzMGF$BZ7*IM`Be*aQXUZS2et0;ANlHT?XT;TY~Gr9L159V zRu)OF&MwgPhG*MLBlz<#SMtU;FB^{=RxYAZ4)F^#0nHX6OHUzM(&08o<6Cq=D^Bpr zk12NF{MtC%pUevS3K!R7tO}p)d^fD675;wk=+S9P<>tSPplzJ&dxjddaY{eBQwXZ; zRz7dQ@oBQKo#neB`u20te)sq{jgFTd?HUckIRjKP!)LxqSf+rgc-I0S)bxKGHe)T}^KFs`B&o}f zn_2E_f`4bd??GlJF(GeSRqX&Z)8~lon%j*q8+-C=*-PzF40vnNk?tmPR7s^U<0JbR zzcthWuQekTFGiE{144=J%^ER8nQv*aTBQ zjMJZ?=ArDXB4O1YT4~g;BF>KS3q7CeMPhy1;oF%zYN4T~n>-dBcqHI%@g{(;8h)NK zbo$CZc5%J&4;QBrnd7&VVSA0_+_#2xV_pOsa;gKKPi-)om)dkJFn*Je6-D>YTo`C& zETzUti2l9HpvvntW9)S$ytXzOW9d6UktfZq{ z2r-MlaU{)E4*mIl!*PL((tq$XEZqYqk~&th$F6xIi^U!4@vVL7)?xpj0?{#t&GlR& zMt5n{N81&6Ba(xF(j1Ei;i=DDJ6SUt)$-V`PP38T(?kXKB=!Kv(OwcSeK`MlROlvXILNBF&s%mhkHl$kgnxwwerq5d{*t+F0(}x9tmukVtH3CLb;OM}% z0VTGxq!EeM@^@UbVzbi5tC1g5VM}FF;gqVVKcX3Peijc z=iqNnN5dP-eh>gAgxB12h9#>5`yQy;zIxFoq6%cZv6l|Z9ZtnImt!zu+Gb8CZ^HpxN3!;d=7*Kel%iaiP$vC##09KrpQ06h>@)jsx;?c#8uq=2 zA1$O47>gd-Rqj%|!6%;7w&{AT!J;*#wt*dSgpPbwFV`0o``}@sSp9ie+d2$l@LN>z zA|P3o0&P>6XlPjoJ2nn5_GEa~7ZlV#;Q6mFB-L)(u7+YZN%Gl^yko}e0!VdEU_Iyl z*eO^Hy_>85M3(34$URpGXTip{VwyQ-gWIb@R-8W>)pL~@`L%WXEgHXucHE~2my}jk zW#}HJLsk)@fg>zl!8H8nU-*vpGHF~!SpQ&{G9Spp^SBu&HgwJ!4Q+p!A@X{J#XekF zXff1iz3ZgLFY6z8ebIbC-JRtZ`xj@75?Ha5n4;s;Rlv;Ww|QeRRdh3Z^s11L@?TP4y)-5MB;~0?`{gYEDS;0xQR6 zQT+pZ5X_(#zWm3c-ct2{tYe%-Q=u_iqOQw4W2(@2<+r#yq1HOc z%)0rx{j!p$lmmu2o%I)j7zuwNUnOrOT zIlcJzSUAxJ-s0H#GsQenVuySi#~>GrK_n5JytanNF+`1Og&upKuA5VG93?cPR9!#+!^F%rNVk+VFlT^-)yfm$xzeiP@sN|!z+i``Z7Ukf zz8sr%jROO=jsCWS9gx82pU-z|@2}L_wo7sTINX zpDQn!MqRnp^Vv_#)^14~%^=vpiLoT0HzVvm;6s^YevlD*j zDT1x(^T?oS#^2pWy^W!BY9nplQ#Iup%us&!$r1a`kD+Ys=Leo@sq$@ZQ8lh(hji2& zC;4DC=+e_xkIE8Mp^E%%A5u{m5g&Tcn{xJdNNR_GNpnxg^D5;YQLR?+Bv399y!P!K zh16dJ&8woUM*=b^oBRfm!*vV#>bJvy}s4dUoa;A^kN%4Y#FZyigXWWOFyU$=rwxL%)mUVaV0{g$US zVJ!0HCv4?T8xDM!uD3$*lQ-hoRU$)C6Q9&x@Hormq#0|vO(s#-CmEm(xtTqxav8Z| zcK5cwy1FZQet+$A0qo4l%(vDMSP_`#noJoP>K}3A;|97i(e6y``e}+^F6ec_{vB-! z(<3tlQn63_EyzwY&#xlK3NG7MmtWG;GI5K#uuY8LQ1rRf-IAZA90CU{>~Lp7Q=eNvlN_c!G*@ZM4G)=%SM z!MNWP{tw!*(=b{!jLBplyM!MS0#6MI{YJ5F7K42QL>f%P)HI)hkg=CgVD&g5r`+*A|x}sM8nE z%bLwHtruQ@q-aio8+{t(0S(S4GjWk2R!1g5dYCzLUbX^sA{bkh*w#8+)Bzgs1VMt8 z{}HJtDIFHeCWj{th}u?4QEte6V00z!Fn&j;km&H3|UcORQ3Q?qix9{bpv1l0?#rIG8KUV@@5CV^{|1Dr2Di{?N`jAb2 zSeM9JE&1LDNX_4;AWuK+GgncbMuiTlDju1?2x+Rr;x-jiT#dP8FZIV{>)OKKto0(Z zwSLW+J~-McV_UW}()^-HDVgw2mJ|W)R8u@06d^Ayk0JI-%%1H%t!h9clC`)Ht=FOPVIOD*rwqqN2CE{x||MO6u*$O5(8MU z@AhnfCRhU97Y@DhY^b_<{K~fh>!^ERj8b#oyS?ZxJn+*RnwW<~-A>@yywN|t#-e^( zLp{dUZ(9aCXk*vi@Lzvf312)8r&+lii2Eb#K~S@gmE+zP=1}$KvaGH7=|YA1Yn4S4$af`Xq@L_&Xz}=;rkW~i%aLB6=S`gt z#V(%o--yJ00t9MLt8b`94fxrtSxT${R32RLYZR)c-!=uLlMwtxUofpKxIF<5QL21n zH=#oA_5M}pAknrZzx`gx_8Jed=3u`g&n*EpvAUeHT z3xpqtSu===iDEFx1Q4Agat4iWtyW-ZtqRrW-@EFi@Y_|!H;q3`#x%{4jf85!#u<6@ zxaQO_6}uHa>nTano;tdnMKd0uzwfhNQPf|EZ1q>hxcL%($w7#3oT?$#W&37kF~IdqDH>68Bv>=D=6 zZ@>;J{;srD-}!Fzyoh$YP!L@Yii@JN`U$I$lsSt%W`@DabxD0^NH~-gja?Si!?c#Z zbEM_ux2|$MyT{Hcq6L(e=b=rwGru)k+d!CK4=PmF5+a;^&5uNy%T!IS>BG@ic9rkUYSf}+{q>&?YGQf+aHV|?6;w2226 zZcHXQrA5yhFvlj`*$uAkYF#D>J*P<&D2QT9W!)MbB*0 zM;W0WFH2)M3XlunQI%K)ROX@ICPZLS@SYS|Y735|la!arMA9)oQ?#c42=A?%n-cmY zfb3@TgEqJOGN0A>xOb5@V;1g|YbYv040-O4Hm~>3N<4F?x*Q!V54Ed^*e`TxHJMqU2lOc-&E>G%h|T!EYGFudr~7Qw z%IifRFa81E#{ULl1(m?*d#$6zkMosN+rsFD^;v?I5@9K8hY;4pJ>g)}T2ZWB~9`s`}cTcO5i8B*8cR4YS9oRI}Jc`dE)WiPy z!>%_U(OWPQK=Zk+swc6fuqs;N!Nhtbz+qdI5eC5SHLOC#Lu$wVmLR5|$!%VzG|bI) zAmTG}lMb3`q~vDnbZtY3p&&_sLj@`pg?D$al9HZYvM=p%L)sC7TJqfaU16a&rvvlY zPxu?`ehgf610VKx4WCq1IJ4uB?IX_$DLV4ag2nZ{Bfoyq?i5brRK=OUO5|1nv%u|d zUINBswpL#b&MT4`+6<%!?>a47?4+{PhZXZb(5))J{QgD|fEmOJAJ@+8J9(?>ep~z~Ox0N{ z8sv=4j45H_?A8!{_`|;wOa`I4fwFm3w+47~hXfVyw(Ow(BuY0EVJji@)^hNgo!jVP zb7(CveiX(!uVkYLf)8aazajB_`VgD`e4<$7j2UltUO?FR_-Vb*|FPL+i&;j{D<_>3 z@d~uajstOlFUcx-Td$`JxUbw=;&w)#R+v_(4#Px}iH@tG#f1qoEHPENDVLJXHv+mt zL-8GMYew#1hz=*8JAmiM2cb!?z6u{Mb*!KyLD>v!g)hdbos~A+dq|(8Wr!?up|iJM z;woz{nX(UOR?2*|gY&69c-FxXS?seyqsBECnuwF;m(WriL@o83{$*SSTICiIL0oGz z$H3p63~b6$Zynwg0!uc1JEDXu5&&2bQ@-V-b>D|9w!V{!reZ$YNs0}#-h!Cov$D3( zIs?9u!5dY4`h7roMkh^=>LEt>7}2q;@#x>QFM%|L^&VpN?^4%^Ng}VLl_~T}%mMZ| zGjAjj4e&@w!gI&%;~3MtZ_#ggFxnTNT)=sHP&5|bH0R9mqvKsi=)5`k{{quDVRyq~ z>3A};;LBYZUqv*9%=@nO)c&yBefD=7B9;2B21%%+5?njk2nU*k6Y#fz$3;K+@49tj zWt`Yub|`7dWGL7=bE?{SaO_kqDv8oi7nyHW-#dN=<^LJnC!%q~{I2(89T$s(;k{kk zj6IG>alK$eYaQn+oEg!|yA8zY_g`{)zHfm_65Z!0*$j_=S*~t;)bjtp2QHn}Ao(PM zA773tg}Kh$p(@bn&4WcdUQG7G4qRmB;K(<&5H#!rLzOClS*;VdLB7?JG;2OhTAC#w ziSKU9KQA{dyyVl)RwVeb`(hwn=K#Jf^oRISlq+~uFMi<$`#yzPQWB_}UP73^AX4EcTYNwaaRPmkvey z-Kjmw>R$(^h@7VX@G=0ob@DFnK~3cqyGwrymaJ=C#CV?9 z7%Gh$jEo0@c7Bnj2Aqtxd$_p6{KfnEXk@oW&_N(~#XnLHZO)X}Kz0ba_u=C&3wzhG z=I(w#d@)v6(ELL5V*Ei_OnVaSC406JoYyI@^KC}`HMhej?Z_CoNvdT*PGidJGgY6HJo z=Op-Wfq0xfr;{1Bui`4ZGhL9h5)%4~+0ZJGya#$nO?r%&1n1sA$Z8Ls4%(_@nV^o)Lr`!M_p|ZC2xh_2HN{O*DJHioH|J6`b{tj1ryD#r zJL1-^tEA+(iH4j`;A65C6fzUJmBqRLGYv96zJEFqKwqBpB@k2|#VvFgsIycB6-RF>X6BUE+F_ zx$3yMX9T1+rt~oUUSqR1Ug{$DK*BG%ckeUxV7itj;_+iCY8wYuW_s!00Umk0GC zuBifO=c2w8NS&h(lHK5q5hcngPl0zAC5ngOzx?e;j62uO?YtRo9ENkAIFz!3_*4YG z_S80Nntptt`V$=aDtLnjVTzlhJOr)R9(6MUM@bw$B*CvWc8%|rHjg7_%@+`po21LW zfVh}LkRVNIQuTBH8|K*-;tihuRIt0lAqbfAR(qSPdER@<0+PN%8mArj3;VPe|6YXP z9*DlrDDi6JeRQN?%x~|{Bv0Dd-;~$+S4>7+{QU`|te!oP-tAU@3d!+2%GgfRDIwn^ zZ5A6=CLe-OSROG@U&Ofv4j0XD@V>#fnu4al$tNOgKu%|wSqagl(L=b@DZ~!A!8@*> zE2%gH^%{ge`yYbZ;CjZP4?z)8I3DKJOn-341gn_ZgO_q zwuU=*(3ml@zby4#CB2@@okSHw9SmSlPS~nGq6sAt@dik-hy96ym#9Npn;b_R#&y#464ZT-Yf1Rr_r;Mbn)X$L&@*X`&OtB}{8S@3eX-)oIJ#3=UtAYaW>i11>( zxTZD)_fl}mW}CqMo{QDB_WX~?JNXW&@2R5lV3qkka@-)}5#r+r(!zMe7$ZvkRx&mFzfSY+eyTc+9vsk;C)>e|xZAjQ8$2l`;-NCkp~YHt52DIi&OAzV4IJ zo$1ZLoX!Zhdp^N{S4;@_UNEs!nR?`aObF26spH@NG6LRic({+(nITf1JxLJ(%uNN` zLia$|;Vv`+xt;h2j1zB>uUBP;fG+c6`1aPc49R@ zLQpsGARIvdVPu1P-)z~tz1~)9rgsud%5pBfE(C1J6B2QX0`~PMpPWU3&`vYE-+Q2T z34^%$NwCNDPC4Hs*kmb$bp$N%v0j5FyOTZUA3|d1?5|MD5pY`+&bV53C-bYgtAG%| zJ>XmszXyszUuJF0?#$N(h;-KdUs-b>`26-jFwzOgVTYi2GFL~<_v+p|C5m!`XYxFQ z{oW3?_8^@p@9*_`DGKMk)-HrbT26xhSbY8MI0Y8jUfXAQ??ZCjvuN3!yM2XA@$Xe? zGF6LX60CbT>qNh)-H$t2bIbNPVt0L+{{E(63Sm2V4nYj3KoWIBZl@c>cAPK#b($sR zjpfrzU`$d5n+5|E%F!DOS$3x~+#oaC6qw!B=J9vvYmL)Il?nU^xJ9m#@P%*16S{{WXbEZ&iT4t;kM)x~fcuklY0p6- zp3AO|j%3}Y0u1YE%;l*NCA?FaQp#G9S9ClMH*Uz9E6h|bJco*ej=sFj+0i?hWm78` ztJ%#AzR&b@mp9o6{ddj$>gM!yfbOH?hW zEBIY1A95p4KDJ|{Qp|J?x-G4GVR)Ar@JY9qoNpp^Q1E$2!K>|z^5!(40IeE)4E`cNxw znbnjZk*ZVARc?_`B*FU6I{4s2{Iub&N)W1iB@=r1AcR`C_{8EclA`rBw8aQ_Fc!um z^!T8LFC?HfsCVs1Qr-Ez)yG=UBcxiMhk9V4!X|lPrpBFyysc7J2Ht+kXC~h_bao*J z9$d={K*d8Ts~y#KJ4^W_+$-L|qDKnlB`tT%n^bS?Z2O;H1%B zp95;L9~J+4<~lz+`+hVoheHq;t>U>=#{FZn+)SY5^q2iwtF$l>Hm9!y?RxI#QSky0 zsa}5m;U<~aIGXa`yQ)>{~p*Q0N*cEOZGT!)~?2Phr0KRfA;?C;<@^f4^y=AE;@oE0eUugkx4QlKf>Q9@$ zvs>Y-FHB^d!Dn!m#E?oK<`a0)Qd`)5Z%+U2v|KCOk!MNU!PSVuPTm}|4EyrsFK7uC z=bBuFKYU%pv_*<2DeatmWiGJ zG=I8vb2m19DbQQR^2ZaU0?^=lg;!iHL^iz01sJm})PH`|HgYEpK*#c8DAf|D2|0J~rWw2ClL=*t2*0#1S=|vN? zGelOVm|}@8ta}>>+m$~oEICRr!LmyV&x(j~`Ji^LqksPUvHM@eBfu6EIWE?1eP7~i zQD`(UcOK~@%KlgKd27oGg}hzc{^5H(m*V}fxq*=(yL=`n6#-ej>(dYo$w)>|=yu-B zQFWFG;#wAza-q^V6Y$0uQ{bZJBDY8|E7Z;xRH z^R~o&a~80h0YUjd2}rq#wZ5pdERjVaz($$bgi!Rdh&L~JZVw5yglVUWeHrB*$`4q0 z@ZZid-B^P>#ZgXCu+<*4>%U{#>{)x^OEv2E2{${u4hA2urC#&%XjB*@CVV4$C(3Wg z4Du&ViM%g^(b=u8auyK#pw_PGSKjIjDV*Ku7B*USyG|`P0Y^^M&qJg`7DAXIJO!${ zJ4OiZHnqdOE`Q&R=V5eMhdrV$H7cU!R5^SGt} z#MX=U$sf8pk9#4XXW?w~>eV;7?f3T0Fj0cP(queptZ6*ah_n*4=CN1|?hZnfTYNM# zqt;k-tr|_70f{-z*A@(yA}YnAl(`HNOYV(*1J_J#k|&Pfwc?I8&^Ct4pqPlVC$~#5 zkC?)0*jn=)Qir&{E4>ZTM0+0u;hkCCR>d2nbOO&<%`5YZGJ$&0!EPrxY zBtaSk9s$b54A!mnT!B+G%GZh;_)|3FgouIiVX|@#h6F>|D&9D!;Om8IUUt|l#AOl! zMHee6?Ton$<*AG-3QNiI09R>l7t_UF*DA!;83i9OD^%;ui-#evo@-b|Cn?vjwQ7DM zO4iV|%hS5l=E$|;7n!V=;5BnXr=8z@5HC4kxa_zGGFxGIuGs^z!n{rDj9Q~R7GSsi zz4pL-?Q%x$68yHAG}y67^7iyiBGbTCAam$XO*f>B{r4o^AcV1H&^vPw^3L_ysOxvU zu{jr3QFZ;2^qO34=t??wVD-;$&D=E$lGY3H(#(TUN30D|a1R_*@qYd>&g^sgQ#29y z$7y>y9;#(~_g&BRUlGyRfBu%viy4QLV)f-^?{fNhC`~*Cu4%wdBN;oo+vr3zPt=zM)D_fVDpc~1#%*}mp2cG(x zf^Np=cRHuC-(|S{B1x)*H&a@*Kn}6AWqZV${xi!b;sFS42Y%}dTx;(Im$L&#tEkjG zA4kt|)HhHXluJ>Kv0WgtORzwWYdLCb9H4ia&g(MBkv2n5(ki+#y`2)Z7PAC!w~Z3E z&J?IQs-d@v4$c0%ogDLT`^z`$O4{nk`aoog>Oup|1f24oj;qBf6@#mJQNfAh6$23F zb%C}gO?l!!+mG9ManxOHWyU*!YdO_PPu2RaL0HclDSEE-M-Lwi${_zvzWgWg^9hlS z?nmpUMZ?DhjGSr8qG@1SdjSsTlQAfl18Ic|b$S<5x{=*LJ{O4?ncWwu)A8^^NrfC^ z!tB?W(pt1ur5`ift$}OYI6Ty|{%bL#S5e-6Yt`C?FE;`%G!0c}(C99vj+Tm|{4Rsl zYW_N~t!$;WXB}KFgI3uT?pQ9tJ6AElheeWt3MNxk*GC3qpNc-nC{Qwb|JnngwZcO( zaXwfd!Ra+z%xL^wv1qLC>aq)qCa33WRJs4@Jx9#W`z2jZqezSJikMs^WY*s$R$Pjx z?}{Pbr%?d}rf$qGG<#|0!!)N+#}a7oU)E85WA7}PD&CjsqE12sSK9uAVD+_}KRo}o zufAJ|Qa5z=LMD-s0S@JA-c?po_<4O-3+_dF=qlcN&YM>CHT^GS=vaf0$v^&>pB71$ zOU)V>7Bg%}=4=#BqmphXPF5E)j!of^Sr;=>71pO%VWj>|KKzYDZe?3E>rx(ou&*tp zB!#abZhC0#My(P2OESw0T$>tp(UKU11Ta3SvHPyYXh<*q1F%|a&xFkWeLWrTe-X5- zt>R_<)y(?7+IaNa|8L{W;|~X9-iq zYk^4flewB#Wi5^kX)(k6mHdcfF@wH7+0W~ATvSs$63T_<&*omM`svT^!b{HOMG{vD z|2PG=-v$GVtYkJjo;hAS`}&@zKOdgR@ND#4?-sr2Aia=hGVB&Z(*Mf$IC%Yk5Uu~o z_ds9&7e`eR^gkRG$)YQH!UkE_rDdU{>QYQh3`vZ0MNREJ!h-IS=Y~;S*=hdh7p7bB z9^u$T+4!0fMkJ|$^VN-w31H&def-H$_h-v~lI3g8l>oK`DV|d8<9dqHkJ%H^|ey^%OW5GXGTIGsQM)a zx`Q#|&h7mlXI*OJS3kJPz4^%ui}VkC&*zIre3l$`b6orNVH{|O7tMH9t$#o4AY5JG zczZ6MlPI6ln;^b<8zHy~7Jm?EAg*V()b!u7Jqec6IrUvN2@lY1qzK_VW$PldxuH(CPpC%&;QPFrFub_okl~gd>a5_~fE*>|IdMM<&g5-jEMD$Yv@cdR zfn)Jn-S>^|iwR!o**V7<%kz9NzNYR?k4D`niC)BbN5B!npyxi}XE`1r6peJ9w;&uw z{<5sL{(LwYS?wRCB{wIO2{kXP(yT& z;gRYa069DN4XDMHGd0~7?O#EqY7C0~I-5exh$ojyT(mj!pV8$0_S&a}r#GXrZfb?6 zcsYa-)8fpjlgMH~!JYStol?otI^&ev9dGoMrqNyE)-hSf$hcBMq#&u7Kd;Bya~chNsi73qB1(yQlmR`O3bW0qvqnAZXzGmDLgwZ4&(xId%^!c_ZO6 zf4;5DMpUz;IEzTkK(`J}+Zbjwjq_;%nky%*4|$bF%7=DqiL2ZBFT$`I`iy8xpD;%^ zZ?L&4T9oN;>8FYlfg5hoV>o}Ba^1w5VVM|$z^_H&KEyw_ji_P9YeA(9^>-I zU^%o>hOnfyyCc*n%SA#En=;=7cJwP~{v3HQjt%a^n`9DnM2s^B7vRb0`i#0j`O9P- z(9@Q8eHYrByg;N33H_M|AQgwh7Whlu_ehEQ3Qs20jTUnGPGyG{lZAY2vYE@DWY;3U zlDuqQr?Ql9y=l4+^e5`m!sb*DPyGOcd^8fSxmBeUtnfTqfpyyE18F&{LmkZ`?zvmL z@rNU+M6b=4g;JsPA=h0;3`2A!P#q8MYVdTPg{$w7r;V}{qMn5TOm5``VpAObZGSSh zte~d|lc8?Z@3o@Y6|gjI(yWtBKd-Mk3poyw5E{)tE)Z&G#VEX*6C)|QoRu@s8w$Im ztlh76Zb4PDy72Hz!Y_aOF6VQN7*x$C08NkB5xu`LNY(&>dNpiGKNrLCtZCH1S3BT*Kwp z{!UtyqDjB#UM_|4Z(Po`GG*1t>f&z3w^*{9<{}^o6&DJ6Fi}>K&rJyIaT*tkj(?b1 zVceDANID$s&ggxC>&uIhaQoxesvUL4@`AS*CQrdMqg90k(1qYR9vV&ToJ^p8;ZQC` zvboM$a9FPm?_Uc*zr(=&#sbR9HNFyKlOLQ6-+%KJP4oLk@ao|^vm?zB+Vr7I)#vtc z$QH#!cOJkt;Dl+~K#%?FoKL}7x_2Nk!A+jQFmxGy%hg4RZ9gEmfP~#>)80I8fp82_ zVyI}`@zv-7BE?Va;5Vt`WjM6WkbhiB5S+UaL7%P*s19Y~NlLnK(WGiXq3k%Lw!lcK zKlYy5M-rrVR`+#W#OV2UkFv%}w7~p;G~ErSluoKCRT=Y8V@(nt~49O z%Li=BHah;IOiy7t28gmhTmW)+N8f9G17wHKnuTEi_0gir4h3r{!Atob7E9Bn_;IR* zZ$=0bbYq5{pGLDm%9!3HCWtI{xl65Kgo+A-HIGGvz2zN-^l5cmAum>rJq2QDCi0%j zLrp2ZJ(h+60W;&i<%i=dyUySXZ4brM4N7$KcVDv72U%R{x6>Whf5#uM8ANt(=&ZNq zOZ+Z?OjcZn*189=EFMJ&OJeICa~NXPFj}X|G#7kq8fR>nEEAN1-x$jxC3I9cY(#B8 zl5a#SEJM^ zpPlOpS@!%__eFGEkvHD$P|w9Gf6FafCuTzsk-cQd>b4 z|0SEb6B}HvMb3(TzGTx6lmf2(7E#Im(!+4F9m?qBi|%eN+hK(N?p~CK=7Sjcta$(w zw)2m?Xd91ICD%Q#eWM3%hB}k(x7mZmbEJP`?zbOmR)wn7jYRTE(QYI`OH?uzP_@*6 zTF){sh`E}E2Xhe%#X)x+a%)uw-$s}97mdi>!>DsFITx|*uD zf!o~yBaY^vD0l)>(wb87yl!K!6~@-5r7l zcbDMq0YY$hmmhZx?jGFT-8Hxk5Evx5>j0N?p0m8GS^Ts3s;avd-EV&-kw8My^ACof zHj@|3mF3S?5#u%ChZP=m{jF6p7A80_j`_Pmf`ikDp`FTCL?=?mul3&LebKN3OfhR8 z9Dr-1-92tWkJ(9WBD5nk*EdOV;{$n2C0lYm24~*Qa5(k{hav zqP~8rCL{X>b?s(C6FkckC?@UH6i4HfT6Wa$^K*MJ8D^BL&z5(rHwTCHDVE5{Z-8-C zjr~7VT1Igv458iL5Qgr)D@=rKOKCjsM0cF+rQcunbL64q`c5);N))!!fg~0R?j0l1 z;BV-~+X~u~*~jhYW=Jgjj5r_Y`zIhuRAA%Oc#sKwAVtVNZgfF%sHeYsQ-d&DR;gk8r>E<%5LqtV2 znp6#+B+1CY4_6NwUwTWN>K$(GJstk#Pi1|GV&$k>>1Jq8y-f7b0kMB|8n%9kt$?^1`6tjuEC@+?N_3ekgF>KXITHBJqA^sso}h# zmx+Ww#(J~L-TIdW!XH0cEe?L}x`D}^VXApsi-Zdd6x5UnLy0f%*N-1yMyB!ADH<*L zB;qZ{QNe7FH8{w(%GB9|?4%E5oHR19K~>A-h8>*|lc{(uJ82Z6{ZK67;iACsFYLU%SUwYFPU@QXNvyy!uQIy$`6~A$7;pgi))tHrp4zC-H9H3cB02g zyK3^|l<=eA^IT%UcXVmVw|4ZC_($K(W)_qsb(eLwjGez^>A!?@xZ7zXgdf#9D-jTJ zlbvzaT|`C3JefM~D)N#5r6%#06pVPh^Y2Lu-Jcv%qzTe91b*1oNb!S$@n>CyF1UGz zKRiTRV#IaI_ZF5u_kt~S6=zK%(tQ>%%Hx|6rss^Gex^Mw^HLXqt4 z@RJv9l7yj58cbBLep~UquE>7M?)zzudEPc;PCM=j?vP;}?{WMD1xNKTcgTnJgF^PR zj#nR-2-k$7Tp0lman58UB5&t4>6cD@D6+9q-icCA{-AM40L6BdXUeZOAQ z`5vaHS#3R_oqwVg@|{Onu$X|;i59I$Wyp5C*MfC#vZT!n8=5smF_^IHruM-u9hdkb z$i2I%d;Q@67N}a^k-q)UOo?TNUpfOs@#54=l-r1?7v2p#zOrJ7CJa$yzrWEz5l>Cy zM?>KdQMSF^6xBi3sbH6V6%6OHU zj)7q=4Q81$USkw^kFKO!=rtU&=i3?u48DJT`+4rGA^A#C`CR_Ud6l{W323=b=&?{E z=z8*pQ1ji}xFBDpaxITAMU5I>*l$!##rGhifI1h0Af~dKRN@~Vk?v@+W4~VEZW+S3 zd>=Jz$CjXucomyTJrKJ|tqP65Z5TB??A8?`dzx6AEW2@e*Sy?u@GZVa8w{A|P#30z zEuyeAoW}RK92uzi#z9Q!56(kIMhzVfaJkMR)I`pA5l7e(dV~rS&Dgw3A3r@J zfvn9VN!sdSLr%Dc-{N~5I!KVE-c#KLx%%_*3Kt^xZOl@jq|;Sb+3CaM1X;vSG1RM6 zgi-}%u~#v=tR_v-*MhV|EC3t{*%J@_mCkvE+dUY@J(bY2FwC%s{<257_ZQn5%p&u` zGC!uIpsfr_)Yery};Poaeq*23;A581>CW*YN@?oM)g+O3y zz!x6Kj}x@1nFp%zJw;)G-~$YOc+{xyA!MScs5&8wvv?qU)#@b+K2cp{(RR z)ku!sv7Eefp0>FjJH0M7~MTWRbo+!UoD+Tnzrlg-`Rr)bDti@(LP9GE4e)8L35 z9*FjjeR^w^)o&+n_Ry>Qu{4ESf6Se5$TT(Ti9 z75I-x`MiGy-s}8vWNg+H%z|@=gBP#d5JnEHev>Woi-5q|FU0`%60bYWG-YXl z5J^9k>@K)RIkF%Pc3Ls_+1w6 zpRS?&wsp=)W*gDhU%OT$FYlRr^47><1G9K@$AGR9dcG0yMd45YZFdKXOG;oCz9rBI zc6?9ix)0ZTE8GESG`jbLAbUQt{Wf@4xb@YA&sOj4Ze=0PfE;+F){AbCeswCWR2Yzr zhhqHu`=*IU(f_LY{2YaC)c?nz*c$?vC7VU-0Vygh$$MC>Bl5k6JmXAFkO2_|zl9uO z-^Bn>?ilesvoXGya+0sAKIb?7SXa1W@o6Ts@42=H0QSfD9>&coKc9Ey`aEG{Tvw?v zj|=%fz%1V%>PI!eEC{}wfBD|`7D7IL)u`dlr1a+0JN~hdHK894k(5jWoikshQhk9R z6aNactz_B%?FLu!@>l~hYRLEt|4xw%=o63;HjjW5H``IkV?4^$jTd#k?-Zg03rTM< z3qWjyJ5x;#d?opTM*cMMgQ4#S!6VYt1lBVZnB`&DO0<5|a0Ah*x&-}Y=-M2Q`@QN` zWrw<878l(c_=I;=$6??w^fUj==lvl|FiQuRJMevzQ#Y&YzcZOAShzd!Jv=(rX>H`d zzm3bKEUDKyop~b~>;Y)x&Q1odgdSjasaUI$96-0$0jG(*_V;z-ZUjQ8W1y9U6y9f3 zDR~x307kwJLYR+HnU7~*?7=J;9WB(U@9mZ}((g{>wf>^ES{36lYFu@wdRMFKyT=VVlm=XYHh!XqB)qQe?P059B6frC2RlSs!#l4E)1D@^I zeSJ3YCPf=()jaTS%b2KBf;@eyS5L>>VJFHxIzsG+C11j03;8}Vew;0zuX8Gr`d~#% zBVdu*3Wp;uH2KwC$KUD+NDt60MQ%RSSD+~So`1=Ll%sJ>b{PNcJ$ajoK$Jte@{B`@ z;?;4dY{EMvf%(FmlBi zE)IHc6?o~7Eg$waS6`M4n+3caKLrQVl4uacIu-P8_3XG zQE}>o>Cnq{xv0s!ge$=2{fD^*?}NbTxKy*}ORtpkBZ_%6cF|EcSxYO<2gg%0u>&UK z{JdIl(~W%{tDi)TMH?03jyYY9vH^D}dqT@{y5J7E&|897_D`zs1oYa<+xKA@7@$Ha zG4k5ogX>fgMjW#fpq@&re&s`Xs)5$oqIBN^%{5X$2tqu_ZXDFhjuyPJt`Fu<{lHZ0 z%SCW+*Y{%8)Dn3@?hxw6>3kC?>`Q zhf&wf*1goIaWRlGntJOx(Fv}7^#WZV__Djz_KJdBco;u%4AqI+=9C0v3Lh9md=xxv zRPiuy{DnFVaL!4GEqv>jTR~!nH17CQifm(nE;t=PbZW!Ws))f@>?ZYJdHWmM%3K@| zH*1xnTQ)Y>0)^)7eO7)41uSVi8w9F<`j*#Q=MdZ~7FLya%>m_6YP0YL=}SZ9$SBrG z=j_Wr2#An@=_9*zYsl3#`jkibqvZP8918iQi>^Z-aP{wQit@`bAoJil@2VjWftfpJ zr#{|=?ma`_ts4A^TI+Jp1an%?Lgmp{KZE7=W4}_5E;m>x{vuI3k{luIQ3)gG@`^0i z@uYLUlNJh2A3tLff0s=2ndv@Mo3$u2`_SNLV_30bN_|_+MqXkH)n0$9NNb18T~xyi z{?jx)AXJTY15M39uPU%0Q#-eJD-x!_NCb`^-MqUBwzIDKTCw9;J6*w;mCg_47sF9f z^z4Y~^n%49I42XD@Ap`;JQqYBa~z10KZ?H}lYW79%Oe_UF}}-?amRXh^5=S{Ol9^& ztZRle6Hj|BzSC=90_!eenNZCz@}o5cN%tg~{0u8Zyb{A9T zXk@uPzLdDX|Mo{Ue+v7C6i1CO?S43KhPFYz&@%Vyh2A?BY&(yT z5f{(?H9YR+O_vH@*?|lY!r6Tf_NxDIhNmX@#DfOS_jm}j=b(Jt%P#@%{_-(Gbmkbs zw7((w>HnBY@4QlKQ2T=h3{Qaq9kM(PgnodldrZSRL~YcGLPVZG{y=Wsrt6o13$ZR{ zstqF99@JJ0T}oFb^FGsX#ug`YNPYEmU`2uNT zJ+M|^N$G!Y8_R-;)aRc$HXlsB35T)@Y9%X`nB#TUVho*LfvIg;P3>u~Bx*g$Fo9JgXK+k+NdNGRA!V z;kk+WiO+r;apZz^T6$mlnDxgM z{*OWFHz)%(WR4dbtAnbjKms@Ex9q~mFgL^MEX-IG|3;kPU&Kf<+8wg%lKSOPOL6!t z7<1Lok;X@i458)QMrzUtIsWwDn6bvl3^m?e)B2Dn0)LT(u{eG?tNgG%4Yb^!uH~Nc zy#2sgk7}P!WzsJQY2S5I{>>ZHZrqnIfEC#8EZD@l1nX+P{Oje#a3Nc5TIP*U#eL(% z(@aO%{d>rh^k&}Kf~|BGxtlaq$4uBtc6Pb0;ZJuglb3>U5O3nJo>h3e^Y1^>F(N0^ zrUIw*M~W=`vGXLZ(rMDO;Q*m4Ep4C3HSdw)Lxj)!KYsMc#$q1DZo~VnfuQ)q6J1>| zBtQueMs}$a6gw^UoE2gSUn*Z6Khns*pAjG(!eu2o5fJ_~3$>O6s7+meraPp)Vd0@a zh0wLcJk-qv%2k?zK{=e%HOwxwhym7>cFICEVuko*S&KFTv>J{MXqZZaR(W1KYu*J> z(*n$wHrTYTpMv6DXR99r;{E{zkW&qeR7q~keSWG zbv>|Sed#b;$j$>v&|@zU!<{l5jD&;Qbh?sb+Y=?e+OkKq&yP@jhrFE)7RR%u2-Dm}6<%X# zK&F3vL2?a?-{2z(Z#S;LUWp=dHGd(2WvJtKl8xnWFXb zKz)QNMI_=N1gsqjw2s7{M#i*&b~P`4Fc0RD;@%GaJJ;Dwz8I)Ccvd@|#o|&BhN<{0 zrdY~PNsD{csN(*e^~;um3gGT_Jq^Dl4nmhlxJ8fxp>vr1^ayA--d1H!eeWdRu1*gd zW<)dF{w^pxGH z%11G}^UfZ;{L-Q%K%QKkS~HRD^V9p^C!^Zc{?1U5hqou*bNv&MD*%UDfS z{(p>>&VLyz*p~k>R=S?w<-M_bR2$>nPJb(SD_Ckd|87i`FAl+(|NYHm;*%?N5_JMK z6}h??dSnKB^G&3Q9Gw)k9<^m+$!6Di&G`YO+1by$>wbe_a-Bp^EXNGNlqX1<&HDkd zCd_&1aZ*HUAf49c{F{-S^2{73K%<>8)bB%x$jm0N?Wcsdgr);bl!#o;IXZMhTq+IaFrTn;+NPDx&wgKmI5TARh z9fqFx(!qXPB^TeuLQd}2MT@h4q`)%sR&856fn043j&}eE=Bp*9Jq_~7Dz29Gnau)e`JDwGj71xBcyT=@wPUP==mK$z^d*Xe8MW*b)hxdk5U{RQJ) zk=jAU5+`=klgRm4p^&()mv)cFptSfO!hUBf+20!uK@?^;P{k(jm2`9bgxh~%HG4Y5 z?c>QuTiZY>xvj`DiVIe`yKcQ*T`x-x+GI)JW${~-Z=m}Q{+te9wr}5m^S*{CV7=w< zmj;rP0$BGCuUBpr@XeEsZHC$K%6_kUMm;&GjlAYmn_ld=EAE1e<`o%*rG^OjIr(91 ze+U%a+&dm}JbT=_TwbQHd>pN}FRh^$lh<_vkHB?D8Cvii8pJ(YZ+xTbSuv(8vHWs3 zNRPg;{5yP7d^(y#5vQD)CC2B&MMQ?23XNVYfZxR_ls*yb1~1o?2$HKXJjV$ktGH;{ zWP5qI<%OH9&vIO%*EU0nS7Cr>TiWSD=FkxfTPsRX*qdRu%qD#_2)oHBE}Kxv>f<+FZz1xWch@r)jtj!6YqT9lI2%o?n~pBt z4Pu&7NS(>i2*BKp)J?qXi_hykYh3C7ftFG)htUyJcla3LProJkZGTIjh{!H*5Qsj! zsOSMM5$ew&p6VaP+UAc(EZOCS*<4MF=&@OLHp7NmcnaeII><)aXDSKBwvMJ5OoNT9 zhii+R&++^m*I83d31bfY%|IrUlf48dz4sf~n@cXn=PCcgUkHN5rSZRt_o9GC{1aax2ENo_bqocL5t`eIK`$%~=T0<|X?=vwL>avn%_N`mSB34+BM;UmJt8Zt}g?{`f!jtcjFY z5nnYc!(VOpHB_(&nkT%;PWu=a1lXKqZEIzk#+x_(n0d)Ags@muI5T?zdIhsr%b7<8 zB7r5$k~TSDXInF^WRlyUGrxiJWw})U@i6u?767()$}d+cAdVmLy2k71)gZFY>==}& z%{f3c3!+phJtk+{)%}zzBI7v0~V07X7p5Vru3?6I|WxwPxwUe=$%5 z>rA|x&)-oZwH76zTFJO}${_N`ek{q*dc)`k`g}FSo)rW8*R{m+x=tW3Y|BAq9rWG) zM(l>bc#nxqj@gXcAUI}U?sq7o|JB6vP@>&~_bl#9!LLIX>(xugS7XMrKu-_Laff6e3DyYNay<6QAL@3_yd zV9TqGong*piDL#(a7hgX2PB3vpJ}C;bqjZk#e$S36dVuxhnd$`wtVhsMp9a%xrDxQ zf;m`1dRKU@3!3A?f9AiXpl-N%a->meUr&o-2hE((b1)=I7%1hu3Fij;PFMbd4~w zDKK0`qXpTUzEHPK6hVB$FE38J(hpy4o_;JBeRj&#ByCmVBfrd(31#{-LAx<+nDLVV z7JDgfVvg`P*+FosbVUF=SW~mxw#gC7ECY}{@r1uobmV=N8~B{eUZcVBJodByciSRc z)YRWTU_RQb#Ytb;FSF}#JOIBpilXRO32Hs^xL~Z00@jejmjubPXU@8d(y5B6WXOAV&w!q_iNngAy ze*2X$Mv-|`kHEaTQmlZM60aBO+GT!@evj&J1f-E-WmPR`g+W@uVs>#8@_}Nat4)Z` zRy~GMFY(xtn1<>u8FYS-qf- zV5@kV{0#wT8j|Z*@)}hDn?tMAU?FrZJgr&s=guVsCnONJ9>4E~FP-!8qo7|I1S*rH zN1N!c)OC|=YML}TA@1o9)#DXdSB6*N5j!&VjDp16Z|%%Qhj7zJNJNp<%uhG+sr@6w zG=g$pu;66Br^!vR%Ljh;J-qfY@R+;j26$%M$m7L~%9ml3o;I}I4?aZh-|XSdag?<} z;&7)9`u#|Jdn)D)g4ho>9%5icQNx%7ad-H_EY=k zOq7(9!kjnjKs7rV-9I}jg~Bw_;-8$2j3Ww%ovfweGkQB>)09=_C@iTNj+l$q4A6`* z>WTb;*_>kVws`&=K~iu&;p@8T7GDp;;ttSEEw`vUL^aQgsJf;S`6|72(c)uy>HZ^9 z%O8%xsqvFPj?oc(Tnz7L7EN14C8^up3Q>;xTwWZ*-s<*v5NV6Gv6>3D&wZ27L4DrKntPDD)xVR$L?`ffb zZeHnT6rT*(7<6+OfA5v=T6HMzX6;m-@I;dEcsT^_k4(;tFzkE&Ph2VTj|1 zTxt0;P*pPNO=YGSN|+si{M%9iHw$>Cn)<*QYgrbslHM7ItUalGb=lGE?z%HGJEZj1 zHpcE5na*aDAWWSo{<4J8&0DS2#S+ExTNS2f;r?@G{eb3WzGcBeyUC+1w=`XQ@ob#j za~Rp+lQoN}dF*^FF$R|Y-0p>D#+o6I%VT3?f7~eS2@fDWJs6(_ z4zD8>+gDUZQS3hhe`jwXRSIV}PuCe^)f`I`*~KqW+5{x>xpJ&WKh6FeQ@*_B-_9_P zqL%EYQg-4>uZwD163IOCKF%o{#u=n0080r%Exxy~d@~8e89QbiFG3w*`*J50hN913 zRDRy}fPT53zDiDrqFL{TeR(0Usd5xy>U41f|HO(Yhs0Q`&?^y7oIeVRVR8T-mN9VvD*V&U6Tlv*}-X;vUS6?Rvcvd+2G2om(2 zlC|uT(A}mwHMiA&A^ayWweIUGbXp?qJp63&tmSS15Ih=g)uh26LbQ?-tQD8TBBSrj z))eKVycZQ0c(_k?iJYIZs8OC$un@a*e5Id1J7+sH5wk@5g|M&P@P-~gxO9Gt#~8-AYz<^oZPWO)`wMF+RFO{qiBrvJ)BS**#6iaaBIacdKg)1}3H zR*9Gf>;qvmxrx4HFhRWk0YY&%8vma7?rf<-t6`#=7UJezMYe}l71x_~Zev;Ap6`1) zk}P~tEly60_qJDX)8_odymDrLpWmCxty-@25TxKcTl5%0u9fnIV;Id=%{X>Zel1 z8;WA!&Z&rJ=1_ZphCBz%8II69x!kzS7Uk=}<Q55B%9r;GZ!1_jd*_q6edf4AOoaEpDGpNhDftgh{sdZEI&e zpMdX1iQx(_NoT zwMdjXX0&GgoVD}S_XO>w2KBoxIQ6u>j^H(~!r2~WEkzcBF|5<-Xc=IV&(R8h5fBZU zdAUn8#E5705{7h7AO)ir0`0UZWRG7?1`&BF(a^+8a`c$t_DghY3Z(~X#S8$;r8^fb zaIkOuUdz*VnxkEGOEXE*x*hYS%8eArnx$gMt~Gyl_{$>wDpcC$0jY<#htd9m!?_gO z$8xE&8UBP;WIV;cG(A_R@kBh#)aWGPi^&MYYS?A3O2^0Jpv(5wF%I|hO$Dj=cu&W@ zX>!tSyG$D!i`x$rJo}moBxHd7ANnvJj2dd)o448XGwYxoJL9`nb z(pSf>s3uV%eWRcWcfX-?r`#J&=#`Ml@8xgM-w%xJuQgp+D@=UvwK6`ZTQj$k9Aehf zRDYi7O;CJ=Nrg3rOwH$OcU^m?Wzd`$w-5oYBDiZM5%;&p)}j+n*eHO`yZJCH%gaq! zxTSUqZnO185y_Q_Fb8ucQxH=NOLp{bSzm93nBp73moyaub?(MFj0nNn~6=<_dJ{_U`>Jh{sWF9yX29dwPC$R-9#6S-&m4yS!Y^R0v{&!t~r#}O*GYLJZ zs`y65=Z(!a)htcoD|*X`am^Sb{!_%0QEt{j7@>5+=m?LGe?z}?4(AF`K$Tnc zYnl$KS}~||Simc4IYr3=PH9qVavJdEGN*EcbB$_GaZHGk{kdp)b+YR1#wBoMz1 zh~TsR9QW(MN3`&99|!X@StQbtuw4pN^;u=obar87-I(5Tjh9}a_9jBpu)&9d&C?T% zO)3VCw;SLuyYx%##uqag*MAs3s?Bu=12rEQU-h={XGe%#s7sjG9=fmwxsyV!wV9O{ z*c#B(KliG62o?;mp#|@k@%d?0iC!EuwrSVGq6s%OoJX%yq#JCWj^sw!s=0MqvqwUy z7AadX4u4$rF6t~D;waTqbgu`E|< zPsQ=v*=j3fHFoxD)ZE5k6k47O;z4;5Dy#{?Dy=DZ_1}JmNBugqBht5T{bdn=ax!p; z7n%o%1#wNolzs>2_eou6lS}o{r9B*+v}Orn9CS?H+0Vm?o|NUCj_rtaP05_=@e;$L zRNL$m5{^g$+GnstNZky|{09V7mi9A5=E z+!_J%Y%mq-kecD%slY&RmCV2MM!CxTyOj<=HPu6n$MLz_$m+&E<*a<$p548%u9*w9 zn(vp`2kyD0?S*hU#=9-&$qIdvq{97HUuWfzAW;UJ!EvepA8OC)BI!|GY~kkR(@-iL zVZAOt-!Q}{PYZ$jxVgT~Fng>j_rrn!1KHQdHnzOY^0Umr#-L`I1G1fF0!C_Alb_## z)fLv`3N!a&lC#ypj)(0f=ug?WjZsHEB2JG#yZ^yDQ$?0n-Y#XCCs6QL8_ZMI9xn7@ zMe)I*rEaD9DUs~UO`9Kc`+Xj&^Y&p+N0B4y$W{H>!u_$eUfAxavq_|2w|!WglwIER zUw=FuF1-s*ZK@D5j980Mx$UYs&T3aDkaX1Z<1CS~rSugke)-p#wN3}wSEts2T|$NLf4sSwfF>+7fxqB!jD!#r2WUI2~5Wei_;u1 z%|^#B_W!&}1wjqPD=a98;|{V~akw_1TK59;wV$2!3_aENGSIBC8BAHIT-uk<08M7P z)M8&rRGNEpDfzz&-5y4`8au6^=|G0>DT~_g3ySk^LTx9$^NtGp~FEXE`!j? z`9_Rv1;^I7QCUwWY*wu~!YRbV5`ApZ08)33-_aIEZR zHCZ9qPq(DGq{h9w!=6>~v9hau#4uVpaf>ai-hD^;1yq-;Pm~p zvW0GD5@jk}n*=MQ zW0>uWizr=j31Jlt;bb1@xl;bpfex`*h|ls1NdN+Kze2w%H`t-mEZOc}jJNQoJ^m>j z9sl}*K@ABK@KNfhNZjNd zEt|s8wVK}N&2c05sCNtew!}wm3%GXy*fn7&1KjTibm1Z3MFCyFgActrD%`AkQV(j3 z)>xpO0pid2O*q-wBFwnBx}tz(WCxe>@mE>yPJ+XU>F~<)PFjWSxfc{Jo(B4Pak6m$ zN4I`!&J&6lk+ob|X?6^uUxwfsR@bKrZpHR4_C2z69i2If@<6b3dPC~N8Cl!QFW!WG zWH3I`U*!h6W)Kgs@jMh5kt67892ukTGm}}2(Qb$HX%yvn43bVpNAUS4bNrB1oAeyJ z>8+!ytlUi3%acV)r{wu)JjE~XXpl*V*W>sate{}>uZQBjm#}~Ai%rRh{u;^d+&S{o9981T~&6*S@{ZJmLom3CwR?@7aNLur! z#W_lI>FA_XwgIbXn|(`{A~P&NYU=}=iZ*2Tg+!9}LV?dd8$$bG=oBj$ULecyur`O^ z&hI~vM@w11Kpv6>ofjz@zaiR*$e^hI7MCm!Qr&MAY?_xNVks-wp?)){knrH ze`K4Dn54bBROsNa_{EIc2 zBd4Bh(dFUK7a^4UNn}bL)TFXe?9qH6;8^(%1DO^Z)qFUE4I=!k#P;JX(vcHAmhY3e zTcd)!7W|pq&@S$TiKtmOo^>B1wn=L+MlQCCvf0NeYgJPtk=wQG3n5rm&&Sb$>cEIF zPBso(VU^pRy8?~ps*VS+k>hH%qE%X!PxaTw6#=ZC-xE3$&Eksr=0?>Ce4+acJx5sp z$%ozN)7AI0xd4ztsV9@ZzxaZYmz@c{ zgTXvyZu;Y;Um=YA;6XLS(>;?SAUeaW?I!9I z%|d!+rXJ&9KT+7!L9*a%Z^sz5UpMTpz0}Me{Zwc%w31TuNXDJf!k3As;`}|}VzgH9 zc7w&k4W0I<W3fL*ax3)WURrJs|m^-TZHL`>F@%SfsW<-SP^-!Nd`cN8A>AIq_Xc| z{qvIp9UkXmLg)^9uYSD2bIZbKJZ@~bIQ#p+&4ogu^0PdiKi)+$f;cjyU$$D=yd5CA zdDF>;VMBf1;C8AMN_Vh-|HwJc=wW-w&9%};lqANrv{HpV=V`$K*YS3;PmrfFLu2eC zxQ6y+(v5Jo$Lc%MgBn1LVz@~4Ig6H+V*Ggbgd$+2i;>nW9V&i=8`O3z_fmsKuEIaT zMv^Xt52MzoNon-Z-|bligT)vn zs&U`-QZ^|??vCgM`T2&Ux1q996|(}4gNo7CZB(FccEU-v zD0c}77U-EgY4goARnOmZ`#HZ$5s^=v5xRTbNAN4fzZ_Xkf4g184$X-ayCvx2fJYk7 zJ=(-Nvs8uZO9+>SfOQVPc(RF*12h=t+4dOK^|Ln5HK5PP%}q! z>Jc8FZ2-@k$wL=gFtae0tvcT{i)h59 zL)WE1byuR^3aw|GQRU}^7k{U9%O%N{V7*?JZuKt!rV41PS$d$XdmVE~o)$BqlEYJV zg&+N+;|=84>mlWjXh1t0>3-umWS^@{6k9AQ)T9Nylywh0fm))2;*;X| zCyFF-1)`FsTh4Vpjj08@H+r8W2<&!N8TAr>ngQ^4Lu9+jw$uN)D?cV>2Ot@7YA7l7 znDe^w8x7&K@W3MxZhPEQyUoCoak|h^55=dv$! zEP(88_H!wmm|ODeB70CJkZT)GUzU!TvC0yA##8iB=FRVWN4*Fk5pNE8WFOYizNJkj zEehy}F>cEZv331w10_2V`NphPQlIz8;zE%8=+(t_QhUMoeJ7)sNrxbecGTg71FdWLh;_Y#`Vi3@i!-Z?pe1vjo5n)qV-8-{$OxUGM$_C z0k2`krIfz-iSEUBD@DUIz@v4mclhYjMJLmRFE=gRij4I1GK1!HP`?L3lwer<2=0^bvN(G6w!8;5Cshl&bOiS@_7Zj{N8xR z^4D~!7wINywd&0=)TmRCx&f!8D)8zEd79-$|FktDS9pYC^Fz|FC;tQrhE%T_f3oDp z`Di~eLG}yP%80AS%!AL*d8Ckf(m8F$3LLP=%egq6pWm8*M4tKd#XnNgO8;*;x9oj` zcw(DRueMvvale{r<0_YC`*E6Tbs}_S>4Zy$_vf*B!3y(lmrf38z~B9{6*4Y(&TrhP zEp^JAaMp#zW8B1_jizr*B!_sYA5dWfUb+7ZGR1EEe<0K5e?g|<{r`bXtCj-l{~5Zc zGOqfjsvFO?`U?%CUf(#?cgy&sW0b^_5&Ktha4?psj80_ZVGd4uc%w`LjfyOJG2Op5 zftvkApXsc}tmjw#`}^SGTwaeTC1jpxrV+MQ?7t1J+y?`8UzFEIg}B_qaFc9My1%}R zi5HD06-XI=`6VJ7$e;k|hTysSOeQv@QdH&^JQ`qEgsY|xHY6)tfu#(V_3I6Cm9NcW zt30d34;z?6+|3vBe6pOyo*S7U(XqPj&C)-0>e6((#>eBxZJ|Tl;gknhJz;&1q-(a2JMPu4b^9Y zN=dY3d?six11|j#y{}$WLdd13?gmq#d>TB$pIarFDZ;%-?rd1Emr!*Ad@^`A}`QMECF1tZd zx^q!e?+O%NIXS5Q^I7fwL7Jy^B+Mj{?}mH9B2=0o&#pR&Y$DRjWp?+zXwmNFvy&F4 zuo$OBnv0hmOx-j0-8kbNj5O2cI$^F?Q0NQPksLMdAunM4e?;A7P#j&*C}7;(-Q9x( zcMl#25@hkfi$ic3G`I&yZ~_DiPH@4L6^@`qZMnmJ7O>0QpA>1Sqy zVuHz?{hIL)9Ia)ijh_p89BPn%-e7V)>HGzTT6W4_{3{l=jyHQ$^2 zq!Q6u?5YLltJgp2!P8EbIKl>M@K<(=7+1S4AGM$=XRx#~8IhfoGK5tzCO`Cy{@PbP zm4VjMU%~ds-!!;}#Lfz^D??h=0PE0c+3V@7)!w(8NsB6h-8KwrG=H7&joo$f0(Pqx zT$N^HhVmdft{TJHCNGSyYQGJ_&WYb0bkrCtu+Vx?;fVi5ZP42J^y+(#&|$~r9YQnOS` zGWFBtZizbY>;nXh9%Y`f-!7RJEPG_FKx2e_vu4mQhv3z*EG{Y+-@Was5i^&d`v zZZbA6QBUy3>BfxN7V4i=OF*0!H4<^Wd}={%6BWJJG`QS#Cah-7qvKv{AyWIgu{oy1 z5HG#lPyOH3v$mqn&c;VV^?L%1^i#;Dth>*5XU>y5xX02_@J;!-XzL5x={7n=%VgIh zomH8%x^W*hP26mxzFI%3u$n~F>Pb#)PmHO`aRF*EY18SKhuE31O(6PKrXY{=$*36a zc$bpa`ji5pW8Y(f_2w)BR}P5lPu93xN~OCipj&SQRD@#R3w|FU8brX z=&*1_+J5RL?Bi1wXaN;l7*50Gm-pTWYTl{QpFWkBXrx(~a9uon$drmQaeL!!T7=Dh zw$>N;DEm4%1zcOD z)2`?Yj_dl>@W(!S}{oWa?{q*g_ z2Uf4(Vwkfh^Q2{oVp zwBO)^?$4SWU?xjY&jwla1|U&95kf(HobP|?u#^c*mpYiw*D|BYY#w#%O|YJ>lg^oU zQkUrL5SxBd$0+qys!DWc4@;U&5gCIn$!;P_9^Qd;-t;T0SwIDmTm1vLvhqXqt<6;r=yVPG4GZ&o(Ii;2Tc;}}Ft%Vul^wl55WFK=F z_i!2N072jRRRUA7Q@nIgH(sMG_cVF=ee9p!w~OTz*-KLg1ul?dv`M+DrHjiv9j@>@ zpaue}7oOaYo|%o?KM$sd+7+?vir#ooD0p^xJD8@dvp_CwSaD;m7HRXgc5`ug#8neI z_KAmw$>a`T^PGTYjCRA^5$l)#@CT}Q+iqSy=ePdK|1?J?KRWseKIl*f>?-VlD35wh z%3(6?&K~}&cFohk9e~p#MYc>3BiK+ z>r-6cq&M5c96NnlYWNiLv~i4w?X&e57iYcwTpUi|st&T4`B6WcD`(J&&+B1drW0Q% zxyH(9HI_E@911ZNizNVdZ8UE_KV3fn#UXEM*S-O2US??ldtTmAF6%5pEhK9E!uCl` z!v8`2p6eNVB5HW5dJ?j)(upNc8Y#JMMvN#w1a!a9M20P5V3L(bQ)WpXtLc-to7B4B zGLp9E&7#bH?0Vx=vemk4;mXnPWE;mz#Uju|8jfx(Go9I%?Nu!wb-_|*e90*Z4DnP? z{iLb&k~xc$-g-xjGWaJ$6LX2Xx-mk`8Y{O-Ano2!i59qN{MwBGey;ZT?F^K$dU0=ATlM^08V?*{fAF~KAZdjN=h>(10=6t%77NYd^4DE7WYsXbJp{?1M`iCV~^U+K&@ z#XgO~Cem3r<&V#FYU@~(`XRT!k5L*ficj(obr-+{}iB zhJLCaoR>emDkg$^T4M0un!o$_?WdNz9ZC4+MZgWBFDaR?sf7qx3+{hF!l}nH>nWy= z;9rV#7d&=L+)giRg;ZlT-)H?BQNq_YoL>yc)RshCR^O?JWvcx0d`u-aP$8e=^_O{< zF^{o~D?M}sYrdvZXh@S`37U1owJ-qtx<&zp|C!QRloY3vtj?>kIi!`1%sI*2jO1Ue z4EUJS_}S=_`@ymC4vyOa9*d#uu?}&QxeDKWyGyPaHqlO=P^K13E{fDMW{Lz4RQL~w zjeqB)1Y0`!-(~dLemiJ2aDQ#VwWua3H2C^m-uiAW(AfQesU#^wx|}s`x#Rp$$50lH zeThjm$1N#5yHP{h`48eY+nAWGO)FeQ_(i#+AWg%chgB|s5c6vfP*&X5c#d!ro9h*t zNok?y!O7jB!1yQQg!R~>bCy&mrW@3=lA*(q$l__-zEGD zD@k?DG2^bL+EyDDdZXMYqx9p1M4*-pJgDN$B6NOshD*pXHUP?pwWi3B`gmN;_g+0; zf?mT{m5k-CkM9#<04yo?dxlF^yC*|2j7kU|_eM7K_wBV^9JNSb(_^Zb4YJY#GVLtP zA@pV`BXf=dd#E!iCj_J7z`B^;X2&s=_k!?-{9o=Ri}4}y$YS~e{$u^v;aQeY$konm zW)p@pUNub1ex(N0gzYNI;P^Kp2H_7fA(Q-OBb^tY^0x)t0Mw$?37RQrAE@#BXf7gM z=?5}$E8aj1`Q_3lIlXt%V~=qtcmuy_N`@$3!hs$kGudS%OAm^Xs}aP4&aG8QYm(T| zvFGd5=h$SMVk3X92_F+?(x{P>Z z>v$lSXE_sQV2us`zEBmQer;$-CwAny6lSjADsOtZnW5kE6t3WDpAPZNzKUlbHMKx= zQ62rx4dmiMxz8)!6>=_9dMEo7{Y1&tXrx}rzAgGUCjjsbW=#K~(l#J+r+@yN5W5hm zM{n4iF5>hi*t|sNa4JJ^NX=`lG{_P3QJRV(cT4dexd{6^UjIa&2e0UmtRx&ql{7EE8drvdy=tbAa zf4Foj$ce|;8Hrt|n!E0Ib%Nt*BwPy9(WBgTkux*dtJI)$XW2Y!Zn`yEOszJp`+4eR z#-wq!DphL=&outAQNkgDko|Cj+~deSxEx<&x0B!LJSk!EabO9DC=6NdM^->ryywpk z@c@m&?ALG3G~R+NqI=h<2K*8QF>_KTo!ums)Rq-_#XjBu$cqM1vHgyU0?YucR#DK$ZZ!x7i@b`Wzv+>n(+5ZhB4g=4|V9n z3+w|cpQGL^^N1NvC!Z*@oE&)(OV6^p;R8FxGu|mO-2x68GyvPi?KIVQJujB`O43$5 zi&N-Lhq`ljPATie}&S;DexbOo3PgpJcn3q!}t-?ahNp(IcVr`7s0Xpg< zUnOaktTlfd1?Nf^02#c#Rh965S&ELd)VPs^PR3%1LXlxg-sg)AcYfwq%rCkRxPZ4@ zZlC5moouw5YGJjFvyYbs{QM^a0@;JNpB%9tY>~0z1$lm#*lLenPyQEWfMgI!nQ5w! zF@%J?S9Vgz8Z?9d&>F(BeUD$fH8%{ec%OmQ(Y#e{gs%6 zSo5Fkewl;}c%(}hpJ(X2u#$WP(KWejZ=Mr50DWlQ(^2RlR!6RB#q>JEV*~Pf2^w+! zv)-%9Kv}lLLJ{cLRVNP^$GynCP;+%gzPNL=-7khh4ab;#y$hf!p8xzuCLxYS$*OPm zd1VKQ!xDZ#k@hp2Nq<1Km#KN5W3?lxwo2Ee_IZ`mvQq>mAd49aKGF&R;O0>~N2ve| z3mipbDgdyY%k?|>>kOHYK?|_m2UeopDKapr>a*1hN?5!L(urSQ-j~up-tvK>mz?z| z?ltMpHOz4f5Wov>^%H(jTX3#4p6d2en7O&GWWUb%j!J&evd^2UoY8;Fd#^S&XQFdW zI(S`ED-XJE#pM(~5Cj znlz+EBzo_RX?;aYr;!Xw#J5`|u{?RH!C98{P>J(w))AuS|$U0=l3CEh<$PQ*;!a*+~-Xs%0c=RXQNu4l<=q?FSX%0Usp-=tavonbqxxH zged{20O(S&41VQcJ|RthV2uPSWdRFiZ1gonpy229PtK=Qq<0xQe-Ds>1)6I(`B3$g_um~sBo9{Pfb<+8$_{Mog9c&xx1|^O=ZI=)dtETFZL?WdbPt%1 zsj<2!53$9=ZLe_85&E~&AuiRT+kGYihw?x{yRG*sI8@sCycH0_`pXfgM)VxuHXms{;DyHwGcY3Jo4@R1f+S8s+oMB*JAM2M|TqPAZ7(P(trv2 zZKPdxpLZ640T-M-1haeofFe)}xwU-txF#L-PN40Wgv14)biM&4Fasr7wC9MH+`lgG zu7!aZqtSLQF(_)rEge?u9)+VbGxfeheJ+mB+6h7g zAv}O}%C#GE7(4#C19F~GOb}!b!fG9=v!B61xg?WyhhH#q)#@|gIzY) zq?zX#SzKTmO-$$qUS~|IP&G?;{p+-G#ufNAW#sL6AWS?M^s z$akGF%xSedI0140sEZ5If_zJBz;*2eWP2x+^;CSAaQAdeFYual>h8mi_ypt>5|I7` zW?p^c^%&tb>B!Z%R@26-%vtQAVd%@h`f6`q+y~5?g?|W&*Q8~3vLRrXq(xRpVK6fA zUGl=xs~dt5ap1Yn>z;$~=r;**4lEw_`~k%>o?RJM1ayLyn4fAVh~@#@z{vT1UL(la zsbbbdI--lC6&8|lo+Jjo{L3Jh= z5c0~nRb&94s3M>19&?S^<`L&Qqh>*^22869)p$(YNk~u;0DP_ClQ#5p>yQVAsXlmZ zDFf^c4tKlCfLod_^k_uLTVsYxQ7r9qYg(GlsU+v};74GxusTvXozx3$GoUBH_Fcgcsl@LEi zq&6Oh3qD|~?F7Bxfuw6C-3Iu#%tX`9W)(oAq>B>3P`CeUZ>OGwU<9Urod&1u3V_-q zsQ}LE=)%7Bu95&OJw&aKfs&S+q4KuQ2Qvzg{|01)arl)`F%KIrX83Fvlxo>tc6cbwI zFXC6tTi!LU_v;W7a9{2gyZn;2H~GEvyv69xzq+zsB)o}}@fs*t2av%1ODF93B>WgW zFw!1HL47?*)UW>AZf!{ws!lL1`eWd9qO+LWbZuFO= zi|XYi`6r7~qvH0ZU=o1Gf4cTDrCk<*z_TQ%!P`914~I5+kw&9OFLu7;Z$Xh++uC>@ zA6hZYbmz*4+g+_wsGnnygl$I^C?5aPt$wmRu5e(zztNfb!RScQPPOE=OhS>=cPOYl zi9mw|dXtG_;>Pk7_qCLe_|anE!L=()<86(9Z*xSkKitN*EHpr}DUjDlV3ZxOh$h|8 zq@By=sD+17r(6*?l8E!O(*I4^L#;}{yvvI4@ARh~E{!hl^G*eE;@^ z({o&5IWwH}$^n>Zm%6ja?>Urr>6++ky;t{<+w8eJ&Ac^~Df*PmTTdUSyEC39zr^vZ zk%|C|spo&33?+&{;`^adAM4k$yx6`=o4mk>sHmFua(2M1#K3sF$gdWgDJTzmT{uKQ zwIWW`^7nH{AoXgiBz|a(Rb&;_Vub=##|x$O4c?r`x4i?a&G&qZ9{K*vh}Hf-PFo5? zC`5Ai?E)Fi<)6l{KAk7}fZ={dP^{ZnAp-Mh}feoJ?9@bp26oc{c6{ALVsK(9Fi{WB%3zkD?C4f$VU2oQO+p% zaU|P%^g;Xlj_r{5+ZFuTq1CS~$PZPmKgcxwS?S>b#YCs=VJdyWL$;x$H~C&S1l&hs zbZ>T8|0-)Quh}Ci2zJ+Ah(%(L3EJJgp|g3R)W^asmme%EG~qyz%Ky)J;%{IV0h#=r zAiMN$bStB}Eg%Ccx_v+IG&Mo6C!L7xW35@VI)-#>Uwg3v8^om&_?nQ{F4gp#lL@WA z?zR-H97k{OFxe}Sw9qHkrTb>)%CUu8DFU!i9rF+M0i2U4N;@2%zi(Sx5hEjhCY7}i zGr0<{Q9|LiJ)wI~e^_wqS}WDhPa5I)>$aPrSLCQ7XG!Bhy;i8ItC?H1d+Nb6H{%QT z=F|sVB&L-6iD%N`#r);3e#wNHe_4Zg?ihiess6`MWM4e_Fug!wAv(di-rSjgV>QJq z3_*?av;$CY(Ln=0_??bhsG&5^{igf!Dc}3o(s$Y9J0BL98833rozyHB8`=@6 zU>~yD4yzGi!^1Gi%Mr6n+9u~2o-{myS$|zuw$-HUVXY6#BA?_^-Xohr!yl6;?0A9X z14Bi_+V}3S^Pa|dz76!pb#_Dt{#HkiCe!I`m!e|8JE(Zup3#s&Rpc`F(lz9?tU#@ zZY<%+i4F+7PK=U0)n|O;j4rrqv}XApX(jv#`z?(fAKhQ_G}B#+5Ihr>fhO-TLcTLL zGe6Q|G>fNUgUYuU-8-DWxevt56x7f30<<2a_}xynb6cWa|6N{J_8FE*!mgTu4TaYz z>ApYY&eRJu=r-lj1mP3@7$vkPtEA>?n?L6q8sh!%Dp%84x(N_3z32Ns@-0&Y7&bKl z{WrHfa&f}dV~DmfOm{;wLVtcVuoYmE1wMseTqh=;7aLF?!}2ws^SlD>J5 z+2%2G=oroH#p-omsW0SJ!T~!@CO;mN%Dti{pU=T4X-+~rP6$?h{n<31qkG4s?`!4V z8Q~)S2;WvXD0`LBf7-75Uhwz8X}F@QYMPZdfxedjW{vnwUdt6@t@vd-P`LM8BR*{< zaa}y0^M1B|Z>dH+0^i|qvqoI9`Y0}(q}Ai_fg;P)Qla(gFvSn_uI#ii@Kb{MaNdq{ z9*-$izXtJs9;|I!Op0Im-hTb#SR!b{pfNZmSnZgfAx5jKAJT-YOtVoJk zF>16R&%pEg)bR20*5Y{VVoopl?Jr22pO2oEQ$3W;Yua~k# z+IZ^Se9rHkax)j8MttOzq~Fle8zoI_E_2J%@a-|Bc&)gzLy2U1UL(@GN7~f2pRF>g z&1CP_7?IMoJ|*H>9K^Nq-Vdt%vW2-K+FRI6(k2gKZ!n{7Bhu1^V4`tlDVL0VjyZIC~Ged0=a!H>2Beg|*@*A!;mO zcc}nKW+%I)w;4nXv1L9d?6XT*KLd@z-5=6j@ncQXkw#0>W6kBtm!I&*V=VEq-6F?h zmoVwWvH6@)0VUhc`J5q$1LT8+w-P95J!7^_-92<&8yt_>`+pDPna@!vA1Zuzta)<< zXq15|puAk}m|81tGx~mO=eecpsa6pb0QWqe-L1%v6HGFu$|6n`XgQvR!MvZRH{5tVyszemmi*1>;EWOjs z(8wwVPQON|Xm)g;_65AhF9r+6(;r}Sv*&bw#+1C#a9zepq65?m-V!taBmY%c zSJx?jr;l*3rS(@d_4hdG_!Q+}trW#3N08$3mHSkdgSc3Q}eB(GQ1i^trPHe7yO%0 z=cd(VYo#vabyvWrDyn(V@Y(E+MigzbVnCsLeX5q)fNJ99Nj>DRPNU-(IoaPdj|R8n zmEWwRP@Y?F<^PD7L;m9%XXN!;3@!j^>+Pr&vEfT%qWER281M)37)N>j4=!y^%8l*l zzmTn;Ssl0{0bPm${+)hi%5*vTHy0xz%v=-oUTCA&2$`GEiZE&u+0J~v*;7%P^rP6_ z_#rF!U6xUlUf>H};Y41<5ne>6O(dlnllIGpmw z>L+_xm*LUmS76~WL|ZUZOk7}&VAJj0GHZ~3Xu#1jLaiL{J-vyIXU{AKhK5JfV5SKY zJS%JByqSB5r&}`PSD{nBzrD8G%NoM-ctdHis z1#obR}-Rd7Noz{=Ua-IVmCc z*GBFN=X5DVdwB(j-e8n$h!>{SL-n#Nzn9{SyH&W4^wKC-xaSu#uu?>5=i!>O}x;2njIK=(A5NAu_v=gq*jSGHh?Z z7qrH}FIKpXe)9YUZ?UoG(x%O*J#D#M*y?~Pn!D_ zPSttaynu`sXS(Bn!Ud;f;(hh3;YGG9JxlIOhQddZ(MFr8DkEo{^?oo8QBT;ckRuU2 zG{+FY**npZ=u^+sX}=}^a75z5-^IU0Cp%yldcI6}zB7UH+bjy)O8FnQuq>cbx=q4U zK#ZaheyA$pf;3G#Bv>?k9+F90*|lAUchB11{!5u2pQdG#f&VQDPQ?52R`R1bI!!H$ z*{$EAjs(k@UAEud*Xq^@OUO0j@&AYAcx+Ud3#6~;w z?i}_RtJLt-`s;RC2O`4@9x@5SBRI(Ei!m@wjE>y*)kD!8F@J5?SXLDHK%ZgmXW0}_ zKjf|cCN1tC{CJ*8(M(_hax*TDR%y0(l%vEQ*~jRf3AVf0R5EuR5ytAz4R;)zRLxVs zlcV2eMy8m{$!KqsswE`Zsf)Eho*_ZG`6*=JZtwt5%hB(eeQ@5aXL3hbRBVM81jcxd>Ich zdQdr#TBf%n!%>tvH{Y}GApXXbH294WzBbGqev_b8!`Y;(yEQeHK{%31R{n4>lBahd z-^9;H!=;DVH7B0oJvM5H^HB+)NHW$t?9MFV5hYAkAw4=jasaQusdmt(_Y@51NZG)h z#4^eFFdG#eGd};QkT;^L7h1BAb4FMPEUJxR#f%RS>YD5nGh68TaDI>P|^NfzF`~ad?M*4x5CAN%qbaC`b1f0ke zOXjLA1!Cb|ZT}5NfwrB9Pa|*~EiEzNdeY}6-~HKgzrjcmgXxX zWS$uY6yALD_eqdy@Cr&jb>dN*?6@B0u_&N;x&tniVX)E5XrIC)`Jm7?DXa(jIg(!2n8C;+@~W;v+&2 z9ee~3HQ@vO8?R10^wyW}&R*Wo4s}g>>Xa;tU=6MO_0oXW$q;3t7iDuUF;JZHZ4863 z))VR9->ESO`Tqre&sPYdI3NG!PW2Bx7zNT%4KJQIqyNRF{*teC(v^OiQ^eRf(-!rXgm$6R|!wNHC+aoL3pZ6|v0 z&)>^7A=f^oTq;vKG*;;Tm1%F$j+JC6T<~1$X0VW~2dr#%G~ioMxEHX02^osg?*CK` zQ+&n0TYJXVA+z0SGt;(0TqH=3Frdhh`9YmQ_o{;lmZ*tb-&p{Ms@={cMEaNP=JuDo z$|`Cy{$>M7hJ55ueOoaRdkqVit7#BTh3L2CRh8=`g)0g6D%YJ*)cqGd`>tnlNte}e z{~2?PRx5A~(rFE_`#C`yx-ReF1_Pw0=Z;;WMir*-T0v2k_{ zs=jNbKz@%;2#2Jz%=3=F@{Lu;vKzw?xp?jVo)B(C?w*LshN147tNNNRWsM0(AiJd=PSpE6yC1=#+r_rWh%8 znl6!A)_wkI%Zzd{aYY$SNwS=B+_m~f91i@%~Tp_-b{Ay9T zAw*mv#+4le{P*EBKplZgldR?eGKKu<^{o`c_$(5EV~dOfT-V4*&lU1`c7D5T7lU#w z;@6rbHtU2Q`07*D-S#Lx*8P_w% z6H&Enc8j8s_0aHlnkS#=F5uE43m0z%mvGCU63L)%mR23NtT*$T#r97Wr{GCi%2H8c zgh)sTZQaQ#o^IW3RyHwirtPA4))^t(;G8j~u*nZun0Q@|35KqW`L=Z%-v-JfnzP*5 zL8`^DG{Dx)PK429Bd1Ai?I#zCwpW2PV7E_9KIHR7kAYS}7Sfb+fTM*%d=Adw)qpHfuL zYrfZA`U@mV=ZAUR?NO+a-?;;yoOQb5z38p97yx+dd3-_V*EqQO{h5pqGo=aJrFrSs z|JdSOscvoF-bMDbeP-sR#HMRO*Q!WJd~2==S=^tTMD)Y9@7?&wpWj%i9r`wsRx0}6 zYCex{xD-RR1Ns<;_MaG_Oc@^&eKN0jUWp{S?4UPe>*A=7?`LJ3DsI!v=gRB|U3~=^ z9XTMjb?z-|*FK~`op(J#zTIyd-RNmzAMK0rA9>{TA*qwG9ZO`|X)-{K%M@YM+xoTa zJ~N~}x+_C+g@SKAy1uE&3$y}GO_sa_$i}9cO>z(GQ6fUy3e7UAgV)^?AS@wL!Jh4r zzl8-c+$GndgXD;DFQ5U@KAhrF-F?|tUjZz*3Z;}bselW*lU?)(g`-hBo`&hb16PE% z*NJ~4!99ar&fC|U$#4^sF*7FH#>r{M+hx2dae^0)S%W(ScKB-wA?rNo8Em&oEF(vuFnEd8Li#QKs- z^jFAYZ8&n2YS6H?OnAt0^W32A0e!KI?7|Kdha-iQi{)@gxq6~V4Ly~LDg-p?~z-?S5jW(@YVQ z{}mfBRRQmESe+e8`=85;!VLWu0&vr(x_)Fh-h8ehnt*)prSn%O`0UXUP~FFh#zvxH zW$;26p2=3BplW(< zhJ}Qd9J@myME9b`R5bSzMAN0Nr!n{!!MJZnh9w&iopou4%a0jkX4a~LXISZjsigJ| z>QoR!W>52T{V4OLRLw^osF9CQ{^Zh1#UZ4U*XJmmIl^^^jL`Fq)6N4GQdDEv?~r{q zVu~bIKL_jDbSG8V!eLEK|5vU-6}NP*`MHNxW~QcWt@y@3_G7i3c)vU)-{(pTlRMmp z)3O`loxwo!;0%@^13L80;kIA2BPOBBc8B^%QAlhJU9z&NDM;h89k*AE$$YOj8@Q`^ zNQTWs(21TbH1y3cs;uvTNxv6~gR3|>LJZ=&Q=&5?xqgVds4->1`QS<6UY|Z1-|ehi z%s9BJqwCgy!;Xa{cE$Rik@Y{>*uJx^k@}W=HVw9*&qByx4{^kbVM%kHa5S~D>klI2 zFRcDTM;K4RzqKn~tg&y_2m_>_-XK9bDQSi7+TgxQjHE_Egk&`V?{T~0FBtc;i#Ku! zI5(@N3iZ%1>aQ6z*DHrbh@oS1x32ZqU6+U5qm5swEurR#6)bZ!Iy@~F<$DOyD#NFi zuiQ+CUYx`}Y&1EjJKksRUh1ldga@O;o>YRt(0Pf!&01KC2DpZiQ_O$H^ZWlcKV5lk%Wq1RYlzn7zEFpG{?7cNE4nvF=}tMsO>xHg{~$ke^$gc(Y#Ht<4u6sP~05KJ*)1i87KgW>=BUT^Kz-d?_@)vq_5t34LL&FqM~C zPDhr!V(MoV+|`M3a#=PemGQ@*cf?63Gc&xBW2aMLK9MC&Db=FEuJwY&2s?VELCem~ z88--}wN~E~fKVRuJjup0et!v*Oy3oq2QiGddRHbzhF9SMX|;{N3`w=CJpI0~s^d%e z2ECQYnxPe|L)tmif0TPv&MGijG@FR6>fEr(W|6o_1K>9&C3W%(D+D?_Oo%xFTMPpAGp}UN@P-R<>m4O$wT_fE{asY4Kbule4<)F>xGtdWf&2*v>}HTn?b-_6HWeFnf{ z^R$144gk9IFs92CUVf~4y}lQ}Bo!MN1NJ~+tn5$Je{{h2mtl=hQBM&OjCPsZyt?%z z2dXaw6kDch2~UcM(r&Tay!FG(B%YuQ7xk@S4m9r`QvDHz&XLnR?v5DN!AK2LGj{*SDYngv{gmC$Fa!Yx>~=*z zB}4hd{c(!u0efeG`8V<}|DK%^k}+VIVQwe1Mk!FXXfj%67$zTh$8lk(4_D$8+GPfd z-}3{AtOckWOs_HkM(8RrjtVaX*D_28ps3ZuSq=q~p^oD`tIe@bih=p(5BtK1hOJDM zoAFN(N)mz_RF@ga(hJ_(fOW0*ZB-<_&4n)=Ey3U6*r#I0qZJxZxC%;ETl$05kYrPL z>dSIT8pb=RCCvc9RJs3Dg+3wco~yo$&Z1p-8Q#_*US_a8E|*bl^O}WV$nOk6rj6^{ zag(79W!vqBFQbT&MT6>0k7Navf8vio(aVC?gK7wX@NGuR3orqqji&Ksp5fRG9fUVSkT0bb0vxI@b@n$lpzGI_7I0vf0^NV& zx}b+)@-AG!Z}aYqF?=Q-f@qTF#uz_Cp(c0z;c?~oBz8{y$>n$^l&Vg%?LE~Ujn!2COl4cG!LG+J-3%uhp*?awvq+?N?1 zMjp64pjbCgeeNpv@r3R!b8AlA7LBA5s!Se$p807cnD>~b}_9O6(U-^CVfnWDY z+q}oZY-@7cyqK@V>Gq63!MlW%bdYW{?4h3xe%i@>BxMJOZoy-O@JbI{@J;O`07@?e z-eGgPdPK8c0 zNDMepBt!L-Oz`~@o+1u&*HkIQyv)C+4vWM*DGKhslS8>A&Ap?)q5!8+%~yfMWGJ3i z!b2%NVBuR(xDor*?{e$b#sSKoe=ZD^*^{9)+gquR-~n0w%VB|Grb>DZW5Y%hZ*?`m zc_`*G4$T8)Owqk#*-O#^PQq4{AqbioJv{sngrbpwj|mtag9^K2!!U)RJ-U?JyoYO} z1R(bK7N>j-nF%mD&uEE#VrJ!hrb7dbL>-$QWH40`2sQa&p_N$#D8|OQRpzW zC4<-jRxteh<@saQaJxh-=N{&B6kn#bV+ZTUZ1YvQrjm#t{)vqDyOh%y0 zo*xU34!ks;5fwv_W39YKZ17|v*{-TYFicNO*a=AHt^C^j16~>v$}e7E-#_1ucdxnI zya*1MUL->hs)bnQRj{zO<-N%Xeo_PmYDBY$VQMS2x}7XT5W@tOC~=fr1f$zThmZKh!jn zc?re8;vfOd&z76NZJ01j!mCXkF3>QX>zMRs0xb6VD?yl)^rUVJ^a!*5W90@%*K!~E z2v(u?`K)=OB&Z6K=GvmtOUi}d`%`UPRCb&>=XM$3CA5;nf&n(V++)_pen}e9gl+?p zj(A_zJ3A-|yNqaNO2AX@9e>mYUm|JDIqJfnY+mgn&Oo#+aZ>8Kt<)`p#e=O+1dLlAv*sq!4KEla1}kmuG~_jC{%r1$36L!NIBIE?`;U-gE&f zaV|4fZ<7xZw|Pm`ilknYUihhm=RGN4vG)^aoQ0r3`Be_#rO~MjT=;#s9ROQ~ZM+n< zJfI`s2>sdO5XR?YXB3$*P(l|c$H8j;?AW!s&LSu{5qh>T=o{3Y^hKC9R9tiIM%F3Y zI!AI0rKU}%0?p|l%-5#)`QuvyvL+x}8YhK8;;T>n_=mG10v)bKt{Js>t;zMD9-;f9~~%<}v6 zrY%@Cy?Kiz1jn^+D6&2Mz1_s3B>T0yJD;C9|vRy zjI0Kf(}zA)|IC?B6-JbQlS}c%Aa#AY7OydOi*t`gU2q29 zDm*uh*Nd)8J~LKO9{m~3R;ODnFbdX4Sio|gaTceM7k7Tv@zd>%Wo1I5ki*XPyb2{ zp7dMicV3(-D?+IH_Wk&N<#o$E@CPwx1k1*^#*JH;!HwVNtSWJbP2p;X~chyAlO zJdSAl2p*nB$oL>`ic8}c+2m&KANe)HzeXZWcm^fSM_B(bk2bBk+UU9d=w^mT8FqD< zi|UiTxxN*@!Hzk98OyQ4&q2bgocqnI@Evn?wm5DM_zVAE{50^rq&`%3EMWMdzzgB) zhKeX}QaaY%Zy@f_1SeE>hitQ;mV(dvfh<5_48ifb;pJbpFx-H2%O8&SJ8(R!t^dwh zz*h4$htHyWOjJkh&j&4>;7)S-0IXsYJx=W6iT6e8k+bP;_eVnF{|#d`IYKMd!eAsA z+0Z5ivh0+WzyLr4ew##H)U^RU*y4qw*@hFPLn&L3Q@v$-MDr$>J2Lvn}uk&KUZ>;{f$4Y~UH=+~&wjrDh{n{Co0$@zfc5t~sx=~uF3VcRk~ znV7EE2eQvA<^lO5jCZWEGBP)Tg^W@daXTW?d(*h6y9dC*X;Udxx0&9{|Do$GqvC41 zZQ&%i2X_b(8g~uS!9obZgS!*l9d;nNOK=PB?jC}>ySq2;G<^NM=Q(%WGrn_w?XIr1 zYE{izy?gBLRdZfUW+S?lzMtFgI6*8_Ef6Nv`}C^*AthY8LSbBT2sGqHgruY+M4H(i z{+j1H++@?j=i|!MNM%nCVYoDg_odRs8;lYL%Nkw{hTxN^JBsUwiQi};CNr#k)(#NzDY2p> zhNnNOeUH;^g7_XiVHMj7%)MghOa zOPHKY*1yq;P<0yiUiJP7e~N(E~Jo%qW$L6N)am9@|?mM)ND}{ zJ5BEHzIT}mF`ji((#(R8QKV=(!u0Cu5a-W-L*N;%8RmXNYO5E2d5f+b0JA2tG|mNj zdv3;zMS>11R1bxMPTWDHY6`B^IxdLZims@m47Xe`akL}3nP-WW&S9(G4>^#p?ae-s zD9!~I(Nam%={?vES$&0qJ1aaTYl^N{W+)>Fxe)F7+6l207~y|MoaoAeshLHY=t}3W z@-|(`mG7RWnI_@Q%C*mZKaDX>!QEOB=5#t%)cz^9f@?WKoONwB#OWm!|Bjj& zC7_9&j1nf@m%)^)k^^}wfgW^JHT>~L|926#b5M)N<1*oNI`vZyz^LT9nZ`Wyd4*Uh zB$V126tP_QYdSqdzSm$)!Szl_a zOtlp7`q`}f6Z-gbI{orJH$!%zU`?0FZ$f9#;9cFM)^vJbV=*->TAORPm4JH9>2#pN`OVzeZ%E@4b_joDvr$QZYHwgO*WSeQBi-w!J*s@q`4jKa8x_yv(%eIIXdSNKBH;!95sA#n4BIZ z$zRQGMOQgw){Vh^gYMf>$JXXiw3e3(-dz{3MwR$t8Va0y+2H zK6hBd)B-uU2#BZCZSuo3&kF@5slOo_6$)DKQHIQBK?*N3{yJnq`XgUvU@Ce=%g3%< zQY#u?g#gr$Lcxh8>}QzlUt0!C9!wXHG5l*SOmwg&s$t|#(KWC=x(KGn)^x5(7ewIP zXXmrwM{_v(^e70gJe^(?lolIND7cIF2&26g^hX2-Do&F#zHSvGI+S~%;5+@UiS;rp6hsF-=tegyuM}L|;~kDtf(fN`09fAb8bcJP(=FGS_|0L8nn6RGJ1|i^ z0;6&r@s$M%!pd(FD;reLIH$vcD0NLaM35#s(X74?q?<1U)4^qZNIVLz%gD|0gNm-S zx-TwCVkPTv#?CUP8GFT>z7TRV!+fiNri_*`K)_m$IgjgdO{Mf4hF zVK{?wQ3{|4&O!ABEYUEjOo3-wAh@{(d4v@?3-Xr48uUTI^@^uX1y0eGU9BjfM8Or= zdFJ@OP!O_{Vwwx7Ekjhbgb7HVXBf~p2MxH$FJn3vxU?q)U^({*Q-jl{$w6{UgIX~C zM@aJAt)gqSYO@rPf~)!`zV2KF*NaCvgs|U`er7hj!W>An?b&ce4n!N6Q5hwYSV8Fw zgb-&zrhi52Fv2u2AKB{=6HlrzLw80>b>d8`R)F`{AIQlUzW?*` z>c>`_(m(uIaQWc>S-SN-@ys2C=#AZfs;X9{|4&sFOzSUV1sA9-sZG4GDY=m>8BAX) zUa_8FZO9cf7soDN{l-|Nh8&+8%p9*UA>4pawp#rSSuG&?OPJVQ`rhr_Ef?2bvVh~L z5bSa}U0S|F*90rF5@gahqzLP2(4wTEV_iP2axNjg=B(<{wI3g3Da}Q5jdP zzbK6bf1=GPZs6BJqTfTItEmyJpH-I?KLLYFXdGa0hvrcQB8jZ(oN)2+_+D~^;qwA! z|4x|YbAs+G&5*?)`8@59g3Tp*?cr#Jbk1yp31066jLMl!`Z3;wP~p1Jk|#ZmhBP{T zrgky*bVKhWo!>-SgMcN1o~%0Pc=hAJzu<5=Iv*x`G-MhSeIBR(eI*6>p3BGtm>3nTKze$*D)Xs9*~xn9|I5<2fkm^Zt6 zaxCV-4zRz_wQGI7IZjw3^W8L>HHUvg|IbJA(4k+ui9rO3Y)xN(4`^e@88uO7GG z+=HcXGc)7izqCE__H%xELm)kqcls^nV}`cqMK^c+-$#YG2_bpeXUD~7V|v0(V%CR4 z8pZ(nrUlZ-A_nRvc~OvrN3J5&q^~TKaIMm7qKeBalCsF2STpB-FMay7 z^yM#(x#ci)8@veDSwPR_;1H+@c-_v_$Tz$6TjX8&PK$gXd9L8)DjtO6(6v^1T-L|9 zHr;tae8NC*d+3W71(-zm`7tqTjOiVGJ}rdJ!r@2V|z0E*M#zP8Qpm=gr!k*tl?+BwB6ZxZr7Df)^^7Bu*c1EWBEDDoA8k9e&2*=N7^5Dr^XSM?{my zYMEJ+S3-)#$+SdB31$@d_+p+3_^-}~U*Z31UvSgz#2Z*kXJ33&1CRtL+sX4;dB(m7 zZ?seeo(HH{;TIh&JSM7GooT41zYm}bmS4enO6fOgu%G-(1NUv`Y;5+na}g#Q@0eb{ zMpnXjD{?d|g3-T}v5?%RjMQt{>tL!{EUsM>GOiRyR=K857TIzgKZqV`+i4m=A$laeii#Yp>nZa(q9GmY>vo3bF4$kb_o%o|u1-rveL9?Jvl zObuG)$E1jX_&T1-w}KzF7jQAw-rDA>tF$*WP7-6|#sA%TApe%1f5qI8D!6Gy{uv#G zL&|^UneC>kH~2>7aP{;xBaxI>dBfZl+^2@1z0eYuVD(cEAAofM5&k)F#o|^L-gG|g z^ZcNK#1b#b8WA?;ad)Rj-6-tu5SXH%9{;PfUA+*_=7;^sK=5227p~%isj$cLUz zL2SF{q>HcSjDdJ7mkvrpB3d@C$%v1=Y*@%Ug%(r`Dn&<8`$4|ywZmD~Na9(;S3|TW z1bYRYm-SOl7!vG@QFr+IV7|&yydII7`P)dxHEdP*&9<4J_!q^&y))BH_T8^IFoFCw zwq!F|z06m8f{Y(!7L>`Fz91M^AiuOzFkwj#nRIoJq5`k-Kvc#$HDsLTnXXoR+@gL_ zQPokVNm(RVVpPqdge;NDvN%T_HGW1j$2RvOW)XmhLy}#FQPa~Q{}q#4jLKT|{KOJ# zXe_8B{Q#g25;0Ls0f~gsaE<w~|$32zJ5syOqlV%{PE#=1yUv3k+`$ZLj!zUv= z>l=ptAz-aS(jnNnxetCy4S|xpc%Dlf3&`T}d^giqZY7`wt3xa&_BtARK(l+n3tOFeWaz~jd-&1JI#ifyh{YwhkL zt;Ha((|fn3B;dkXt!6YQnmTnuutV*htWEbv$8yQa9-H8rBYP4b|i!*?G3s_T7=Tb z%~=&#wBsADjmJcu*7n-lkLCS2XA4tz(pmv-U&q@iynTKv+>bNwrMP6*|2mlKWkAOc zu^+3!OIZM+kiH{p;`FC5HQuF<;+{bv%tqJ}7QhK7MR*J@dEGKC@N?!h!&j`Sxr+h)W-5;&zo0Md78$}kin%z$guoG^ zE1H1_RAuaT!PKu(_11?qs?W^(TgrIn(|Ivm)^5_MXZ)#E!~v0SLxU5$tjuBtoxgpZ z`M#)1IEMY0UZGL0)#>17&zAWuK4@UzJH}S`WJ_ z3weZIM2xP`yC#w$rsDeJ90Q?VGC;5i@lpV{oRmIkv;k<2nC?mdvwnRLCH-Js8|qd5 z{K%z5Ig)n^77X`a4U;WbA8q~M-1Ua0>ai(-cObL0mg)q1j`pqSCT8E8*fBZQLb?+! zrsCPdxChts#Y3YMDp&d;vMHGlT4J*Xi>iN^0rGs|)tNl^xQCulte8s^L_o6ORc~XM z^rQ4+ZC)C;lHMBl1)>pEm7iHLLp)TFmr;KgcOi)J9W%Eral={yrISIFW_S$0Kqc-5XSGo~Ul}Du|F-_6klF91*XE`erD&{Y z`t4A%(UQ2ulbts55~YS*ACOcwIwx~jq-_=7^{^EG3E^+|fO88aElPVTbQXMRD!ioco3Fsl z+m4Kbd+DE{P-moc_L1=UlgAhDn=Mkf$HHqsm9!RdRTy8kpr^SbGSy9>-O*QiSjJH_0E{8E5#ypcR z`W?YryYII@upe&A>agoIdSYOGXM?~_F~}xmv_D#!u-`8yj~B!yv4*jt^gVtWM{JTE z;QvC=?iMUM`dF_-O-wkTQ^qAi6eYPb5kYritJJnFJ$fm#zzH~rnCwaNq*pD=Qpp8{ zzdXSRgm{T+H1(`$pz1yYrwXsaeyfLVqax{hSl(BFjD;wsjdiHD%s4&{PT=$@6LuId zeP3ImeI{*sS(3Pvxug?o|vXqkhrz**N$FRb<@x?(ifa)%6Q~BsvWn zGpD0JS;3%m<^bB%j?A+@P>f}0JAvljyPxLUZi~ptGdA|?{eCr!dC?;qZ8t(a*^{`IpyFBnw`^PfnruB*qOZf2WAH@sr z0+UGfg}5yQC3<5KTALZUm`C~Py@e-mW@VUf8l?#@{qxKHj||Jo*JAg_As_EKW-k>H&G3isCYlu!zTKwLQwQqMt-z={jjW7P&m`40%dA} z$hPZH{Oc1z$c6F{UT6#lvuA>K=F`h+UF=QIVKLkQzka)-4|Bx1 zh0Ara-Efq$PRyq0=xLgyKGCO9r^J0s=F_FKWt2x45zk1Uc(3rIXg?)qN9u>x*H60a zr^R<|4Lw&1N~5w4-X8n+a>f+KXD(`SPotpOpgCZ((Vb18DQLL^?8?T|(dSbQ_hC(h z`f`Aa;(av*M(QQ6bj;L&z*W7$n~qV^0V>;XD#{ zuLb*y;?r&_>JFl%1DLQ*B*juc1z7>-`R6rTIjh^%%aiM=&cJOQytjkF39SZbKWJ<& z#vO>W=5t8`R7+BJ%AAT!A#w?RMqo^YFfLJ?SNPuv;nzhf4(7oLhuGlPo0+fz2;Nt7LA zDE%o`PJ5CkD77o8v1J>y!eQ-Pz3E5T+Yg5nE8Q{Q49>&ozn2W*kG^Jr{+tcK0FqX3 zSLc({fV8?Yrer;%QHu|8=hQAdTYSk4*X@P5TX)78SWxfa+Aa<9GKMh41#uqC3MQ_1 z@<+58NRCVT(s1`aCxEp`SwD`Q#@oAZK2bfxvLrUQHhHLX5*_-v7ow_9ePAUTzjv13 z6}@T%`?uh^g6%63T<@;Ex3rU88BlY%(hk$;@0jBP?B=c`jX%kZD;@GV1tTp zTKPKE5gZ$NQrFY!MT>ImT~$U!_5^)U@y~P*j=WG)yQx19$Vtk1EUNQDm*`H_)H|<+ z&wpNI7$A0)@SNJysGUMf0!j!;EV$4WWAqc^>{dQ?Gc?;~akOG`I8#upnJ|SUC5EiX zIm>)wZIVUWp=f$%I$FF`K9i#G$vG`7nD15S)O@CT3h~7j)~O?}{wwd^ohFMEEOr9= z<%AiL ~n)Ul^Q-8MYcJvipU1PmA{Rfd&Y$}tWRi2~ha*tLJ5gh1g1>^W}M9LpZR z;xPS*Eavlf|GFIzp@cm_0ZC?@L=}Twbg~IL>^z<^&uY;dvv~i?u5Iox^FfcJKPhHS z%ozmkB*O?j4dq2h!CyL|XKgK;Gx(x5HHo|B6yNtXre>-QHZXV=SAtx6HfV;}_I8|| zjC>#5x-JSs$~f5xl>mij_m3F-Y_=H-7A2U8`D&h!F&^J`8(XypUrOeM*3f6l<;CDt z@8hV%3TnoZ5Uu1USrUHi!n^h?Aq8ELZ)fPUl2ft72cklj*q6^H_u(D}(>F)YNBa0u zL~QXg33_jmJgf<+WYx2cgUYX&z?+v(-L8_)%3P%+Yjg`7I)ES%c$c-dAqrDyq8MaU zEc6awWH2f0B*D;e)k41~4d-_`_C)RU=;uG74ai$Z;co9PV)|;t&g;_3eEXgR8}3u4 zOu4j}@QJKRyC+U%Je!mX9Rk%C+wFufwKn~jezW*7+K)bG<{GLurt~Exqh~~NpN@+Y z_CbQ#ifcjmFTnUD&0A&HfZs?l!AYIzESpbG!JfYsan`VrhS&TRCq>LYH}6)ky9!gV zq{!*X+|?po1RR#xy&!~+Mj3BBqYa|+1#=c&1_kDyI>g+UpIudT+R~5`I$1|0?p+SP z`*lowNMo_@U)$w;vWRnjdsFSdX2RCyJJ84KSgQKkPY<~H(@Q5UVb#$rWSdB0*pVb0 zt<*viKC{9}32J(?Bl9a;EQ?1$j-h0FL?K4KsAeF8@F*JCFax==h;!>!>wH{PCe3#x zMx0aT_AM%_vP^wKAF@*E4zJ9kwfJ44wEW)x9rW-lGGYw<9o0K7=NdnT;Sv0iY3Ph^ z4e0L-$$Mb0$nT5ILH>qb;q7Bab=1{!9x8xr!(}QhsB9}*Zua~l?x`}e>3fC5IJO?^+E#JKXuo6~J^(*RMYbFow!p^^# ze@ML$gA{-rT%1}9PDleKOfBWe7fyeqjqUCt`MY&x8yYOld|uxBZOl<#>{?0WlkF{2 z4uO$EZtvk4Vh(?c+4@k``>_UfZB6i_Wcc7;VkucL*_?aGuM(F(?ZO`z6AXVAha0k~E|!6EEoiU7|K&v4W3P18(nQXs!zr1Z}0vsTFB3I405jP~Q3VZh2oZE1&E{ zZTQ9pEy(uU<;bvD_c-E#$J^^EsEZ0pve^MpIij{9JO{hhrEhi5l!AP91y($ zF2g+AiBtZ#9Qp#BT*DvLgSb=|f1}NnFM78r-KHO!^xd;9p9-ij*K5i2xknbCJl4oD z8ONkdw>+HOyC|AB5K(&GOJG8r>-btGqd!a3(5Pug z(X?qXch~8p$dI+C{zR#Ndb`l|8|Xr>2jLsz0+)AUA)bWSddi z0B5==xoENsR(U*9=4U?+gQvu3tZjUFZIUOJBpX6B4=M6_$en`wetdhx9Df!FT#~e- zRcmg1G{@jm9S#%o5lgMnj|Nd2xJu=74Hcg`D3F@b_c5H~VdrI5$(P-b z^ui((u3$%7->My-otrw-)I}3+A_bdy|0?mzw}a2m&G$cgh(j$_$#_4{JfC)oUsE9& zKhc^%nz?>AUQ&9?%fF`WUqdbc{y-ftq8QHAcuE7eL$_94(G_Wpc2+I{+~Pvpd50F! z_mntc!y?o0SvciHaTS?s{mX_pUH+H~scZSm8-yX^hI| zj{t$a`SUlNGg@>T&*Dl-dSHw-@Syw6qy7AVH><&&wj=eQDnT53vF%l??~gQ_0=Jv) zd`A7=*pR0-Fg6izk`FGs4SdaY>Sx)>phfgq*ih>oE*3?WJ%Z;w)c4+etbv}%``4N$ zsPT^rTuPw`RM3`|gopnV*6uU9=FK-*9R6g_rg9u+{Wb$5C4AG8rtLUT? zIJ1eg_pL8^#k%9)HMw8o?@R7s>~;|5{m>}ee|tEHW@sN2kEU%rPL%lTWsy>o-V>(i zKzNd3PMwbw!oB6FUikYq>K89TUzWta%n+Mugr1xPycCIvEiS93(L5^ zx*r#iLlm`of^i|+!P75Y(7yw*w$3|0s`rHfT;BD|!u3qRl$YUE>X5DQbrEUzXA!Q; z20bMEJ;A(Y>)GG_VXyO+Q@_)juK6zcWMIB^W1+8C1pZQJ+>?xILy#rN}s5|B78p9sR+vTkm^S!xOa3*ZzllDv0MfC_%m*`U>`FYp0%1mB!lz;xU z!r}nu*Z%z`g;+#wEnkjeFg6G=G`FrGfPAw*{T=|d^dVxadM@xmL~?Lq5-k%{iNxEt z)-fJ+G(Xa>S+`al3x^pA+ui&|fUwJDG#6`~XDr&?wbgyh=N@-HEe6YJWFzV}d377S zN0^Y~_EyA@9gB$nQd(6Q#xq_;&_>Y1-);}XEUq9Gd?3Ias zRc?(M>17i~=_bRPy1&%IM$mn6o^&6@+X)0ZPCFcCNk-C%mbf1~u?JGU9p$q$;bf^5 z9?DqS)KbVQ+;V&HeYlK=0gK2Sz4*zNmP_#NRk!H63^F^H@Q9bl!;e4mY!d}y8T~g) z%2gbtQZEe~2y5(8v@Ub%^~wXUI7;LI%jK0n2>wxB^=tBG8rQ(#F;vUQL^UjtTQ+t-%8uMEnNlbZARxV`{v}2mqn>l5HFFIIFb^8! zK&}(pmG|lq5xlH%;J%DDfH($~)^Q;3Y$o#%O-KX#Hmh?*8-Ca8t;G0Q<>za;VazBd zOU}}9H+`H*BDNXRD8LB#+7?Ffdh?^BC*SCpb)>fDv9@dQe6}PMAWKF4=BuvB5PF39 zndkmRU9`RxFFH4~7@(I)SMinig`x;HAvq zK8@OxQw;I6WXH*-0;`Go#6?)K=q9#&E~6!72RQqxz#d8c5Kj4g42o7y`tD-%L`{RH zv3RTX3_v&c31|)J>3~A*&nc6Fn99J}# zW?7%wB-F6O7LG87{e4ryN4^x&Ot8$Y3?l55+4H0<8ioy)Hz;@TF^Mk>1T6%$M*OgD z`f^&li&}_f?;zJq9}tS_Bf_lF7Z#2-mAKS2_(~BtjvvBexdZk-l<`1(>3+*ln$6$7 z&#E^q{6L)-aTt4?^2g#{62t3ik}Z%11Gp*O!#Gic+h|U2;5vtL3im#q#7GP1KV^C3 zR^g4O#&PD!9Pwb=dx&h|Hn8L17JIh+brz_UGS588l&>DVdGsgQwxl8%8rBYoh-uke znKUpV(xmTjYyimKovHLS1AMP4y-5vCh*5(VYQly#i%6?A)0Rn0J20DqnQny|G~iAg z48>YgzkgK5+v#&gLV!>(*~C>M6?tc6sF3@9bZ0A2x^c~EG_QiacR&m(q93)WVp@|zP!YfU`ZcZd7_yW89-9&%4Bv!ADQ`rANb_W2(yNs2W>w=->8ho7l2 zVyAY{=4d7$>vg&ry3*_=}#-fll_C+QunKk?`OXPUxusTIPvHyPCN$exct4Nu+BVf zW`7c&A3z{J+Mt_<6CJwS1Wo)pElwGi&}RC_A(|*H^yz8kfZ6#HF-Qpon-73-mS$=( zNc_c5DafxbDwyBG2m0)Lpr}GiInDiTxWwO3OesnRZ;;wBPO&+r2;Smt>^wsz1ER`z zOy4_z4YiPAg0ykyeI)#9TP`0y6IEZQQPtsJ#NVDklmy)rUhqcfiU%o*{wne1!DAWn zmKg-%n8}5Jg?(QXSTj3LHu;YCyc0Xr5Ch&tp-jv;8_7mVCrcMe)-RErUU!&%6n{#$y0`;Rlyg{=e7#zXY#%1lek4A^-24Eg4R zUyS_cMUnQ&e4F;&--Y8&l`;jG;N3~DGg3bO3O`EgD*ZSpzEtq@(QL5n;{$T-!_2{m zXT5|dWf!}9ssevFk4b_YxS-2P^B|B5iQHHHd~IXij+OoS>4Yb4iSSJXi7i$I2K+A2 zm6d|laIF9JYVmtJ8_E5ZX`YC#g`hM|NCpFxUBSMtHbKrOJ&`- zF1T02R>$qmac(zrNAsT?|Jc5uG_W4PaiPHF|2L~v z(%JuX`iE7EAd&474i(NM^L30bIV#b=d{}dov;W`b z(E^M+i#%?e1R3rllWJlzn0@~{&D;d%T{8@6>O&C5C1*Wl4rOq zWVl!G@c(}#h!W3{;NQXNK>uS4MM?bQhVm|vr4aEaoH^G2YOjF{v&Tk%{SRXQ!+xCP z|7~yf^8X*7pYH!{ulfr9-|?ln;XlLmbHe`@br})Y|MdAUko9=rQQ_P?Q2s%xk{TIK z&gLJa&_2KUFKD{EK6>C#*L@DJQ0Ntwl)Rf|HOvvFq0@e z47VSj{%6d8b8SHfX4|On-?oot@ZyLKvzqX_Z{YSd{@)(&jQ=kW*ysw@|En!0Gr~K# zVAub){l<%cU7qN~fba?K9E9*+ScuXi{Ez+o2MZ!JMErALJIboVr9uo|Md$( zz)3YBki%h>sGxzQw`qf&$2<-A=*vSh`V14B!I_|d*1NU&sSIZ0SL;y!sQ)%N5gn_ zBdtmzL;OIsRggnJcdxIB-utM@T`Y%d(?u%P*3$hR@Ow7fc9m)Y^I}=r%(3`HQ|7SE z74=zg_j;Hvl^J+%Zuk1D`~>t*;!j>qme^j6`|*8MB2Xi5Rf23G_PxtYmanPXmlWh}UrVLHQ9U+2 ztvrtmC&LjmUa8MNesiecdue?ge$4nT)LQ4aKijt@z` zal9H#D7b6~%y|#gyRC*o1#Qwt>4f+S7mS>d2Rm*@*My?jwq3404-A8@P1Rg#v`6tA zwCxIB92i}_=652YF~jE#&Z2@SrjBz-oOx+uwfG5(XL0ise5nKSHw{qFKY!&7@iPGl zL3Sj8^OEUPOro(?$>wTi8XBDIr?d|QxA6&}@P_pvevtS?ea{&#Twg6z<{obOSbS)Y zt%u*sYwZR0V^gq&mRY${pOEQVo9SV9e+c4NpLtv2#i^91Bc!nNlhASQYNLc|jC@-- z;qN|M!dqQQTiT7AJO$=LiG0HM%Ot>bqJYn>D$x|H20=mn2jok2-UFp7HpjrD^y2Rp zXfO_W%IsFe=L<$9`ySIP@cO{L3H~{cBi5LsfGrzl|If9w)-)@fA0CmEN=`DB zdKK*_WU8ZtcS0$bDo6aML%dGkU51SpjpUs28Rj?>j>8)W&I^c+0>`tfPNaa1%-wut ziUf|m?)EUOC^m_KS%^LFjs5hx_o#+?Ul3Pdg>;Y5@nEZ})%MbR z%pMUyNAcA1qETx@J&I%x?FLBIclER^>^9Q&c;D*5?HCjX)rj8@y{>XvwK#!)nQtvw z9l<@qwUgf&#HsBg-{L{9!Zd~Wc*|C{YtN)2$(aYGKf5O)&1Rxm37<&&#Nj&qT8zQ# zIb!k83DrA&m%@D196xFT1g7%AH@c={sJlPL{=DIvBDov*#AV&`wbZEa zdf2+pUf5i7Xkg0gD7k?zr#^if&AYz#Dfq)6R+M*KS!)sUsXMS;d8P8mE;rZEbvVWD z!xi)8GySd!yZ2V^{?P&avA9c+wIp2|Tf4)Mt6|#Q3!~8TfR&Nux6L8fO`pUv zp3DZL<)P&`LoSZ?kgV?wlW!9JNZ4?fXdN^V6zCDnGNg1%4R(*&*z46#H@Tf-^#h39Y})esDw&V!SLOq&OzOIA00LY{ zqXu46w4T?AM`Di~=}3y!?q8srxS&sV%S7T!0L5DA2Eb-elw47^0jgU`6z1-7TXh;^ zM#(+j_nyTtiL~EL>M}FaC$B-D<}q|9oGmj8aT6XyND0;Ct;DF1zqdzRd<$a32YO>gwOe|UR>?MiS z<5GnDym4b?4cyX)PpzMkZ8_bYPJwCOguZp{tw@gc zz~kSwQ@Allm?DT{3t3j{6uKg&fEK-Ql+H=Nz*jir_k%iba!#<1Gbb&!croXq@OSq1 zs6`?$$$2>l9?urttVy2KhcV5cWsae!K@AOsZ{V8u$^6^TYJI_`})jC=9f{*c|XL>j4_LF9sz3b4*s{_b?;C^b6p z7wLO0w8kl~Hmy2@r@W7+c2B6sM_3D_z)ZJ%F}ej%z8mGZymBcHGFou~@2>Fv$fR8` z9*ydHjQQ}q&M#FfsMYHBg6e~^RQ-6D|2EwAx-LLwGI=%o^g~>{>xMTySiMf4?@8zZ z8UpV@dDMc%^u-?x9}kiZGbp!1Y4A~J5d*4NXMWaGkKVPB|8AhPpRKbtK)VY8?(zrw z*6^S97Y+K1=zeC}nbqE1cgxfAYAJWhrA9LFg z^8DZT#q>5_aLV&SWq`&BOa33T`Qh0JwIqC0mVm%Pv#QgeOx>}yv(RFUxR4vp*Ho?ZJWopaH%??seR_ZxV_3T1u|K+^~rE((W3avCxamI=12S zkQ3+$C@7}tmd}1l6y9|^3T#R*UT8{E>$ofyG(2l(M}ie?|Mh4LHC4sahqAV~B@uR3 z*yPEfE{x<>q8ij_lCwu5u?!(uiFzl;bJgR552(0G1&CZa7W=6_b;|>~8Nqcl!1%a! zBiSVUo9t)`T-i^^1rH2M1e-ZC_;;omnKW~?Pn-p_+t^SurkAgYun=`nd zPpn7LjOHBmVyv95$7&(oeyE-aw@1b*fe8R~S*|iA?L8JR@U0mPj zaE>;QYd!i+OZ!sWW4~>JSiKw0TikV-3%0pAv2N3yYH-ocR{^XJ7dx!Jh9fLi@Z%l* z-A<5BA_mhB!B7_wGp=N~&4Xedc?+VU(nMu88vz8cqP-x;CebCEspdsqTTqfg)vR7$ z1zY#y?uM)7pig+oZASU?!PRqsboryv$~Bg31D0IBo}2Pqgo3yC_k8MkTuv*5;{g|9p5&dxsyR_ zM)>zgc(3IUH*>MbjaB@;= zYd}4YC*D~De|(dA_-K%5DE7z5DZY8*_&D^L0UGLbYZS^JUC--^XK^JpWbL!>Fs%&a zEHXbnPXO+v)aP;J6n!UQmCvBvK(o^xH@R}2Fu9$lL1?e8al8efdbG2o*ToWf+>(gQu9 zKq|p-NKl(s!>O$8v?uG!jXeGA$j#(vU$=aDz2Na$_;bOSHV1pc+OUsEDR>Ci{`;`? z9z5FcTDUjmz8~ySY$?fB_7T|l7C^PQ1kf!4ukQy!oEP7KImk#^&f?7Af=YjTfGEP9 zKp9Jq-}ujQW0ujSgsXKknXP{a4#`0PJ6G!G2X?SM%9CM+YXztlOH=4_D(Ql9ZQ1?s z7uIP-nyrk`d&8yzmQ9pfQ{6Cz*^Xt;sIPB#EtxD0DFUDBMQ=1OB!;&vexLtTZ%^}# zVR3X6UM=y*U{YiK>s66C`t?Ra==@Hn{R7_h-{-rv&s&~h6bJ4?`K{{{6_MjQz*$FO z6`P0|m8}qIrIjAzQ^A9sW2c8munCMMCdHr~+urkqZcF%!5+-K9r~p;ZxetT#JKag= ztpZfKMyf9~#!Pq8>idRq&~=c39y(scXs3KW#M8*x_a0OLd8D*SXf6IlB_g;*ks4ge9r7V4dfvOhSq*>_GGtT4 zpJ+Folkx9+V(0kaePS=myWXOJ_s`do^$xJevf`=OS(!y#{o5mk=Gk?4Q6x2{!2`W>b1CaGl``35S zZY6_~l;4?m%-U4@Ak9;?7$2NjJ8!fDP{4@COQH`>7VC^WoqDWKb+%Fw=>Z5q+mqq| zR2Exa@fj9g%|FgZsbAPB69w8`y>TsC1z=OzlNmYl;K>(b&SCF zfHJToE3@_sNgux$STtkm5CIC$&K-1xt91k1TEpD;YDN5f{2DjEK1in;dlXY#;okM# zoWdgSsKUl;f;0J@`Kq8jPYhh8-^D1Dm8o8X+Vwmo58+aRcHhxm#o?0iZTWr!3tZto zpxk|CJplEG^}_aBclGc!R6?%Sycc)~QH}kbS^DCD^?>5`HGQ6x*QDKvhZ*1mG{pG$x#`G1NQ*S6QQ<#?ICphD`uR{t zDuJN62{P>W;On?czT5}t$=8#x%-Bjmen4qZcmb|)yJKi_VXO9dihyAw^v#F$D$Yyp z<`HurqWC>b2n@62t-vO`kXH007@KnSBepj?nB zvRvWr;|x%Y%l`pSW{QJ-Gnbz(fI|>NmJ*bfTCzBE9t`~SQ5u{HI+VVSW5~^Xm+7v9 z`TtRL)p1dDU06XxK|sot7Eo4{l+G0a5h(!$$rWitknWuq1nDl3SQ-fd>D&eB?(U_# zVS(M{oA00b&D^NPft1sIlh2Jt z40CPj%7ftN<$mPYfTHW85W_T_=-`uB(XNFIkOx7Z*O$QouPnGXp_PW&jGIs$Jv!!K;3avf7CC76|0fZH!ucX zt?O5p$_Cfp{R!-%yoPB4lw8f{=8m2bDxy@YXN zisSD2f(bCE7;IA@_y2S^{xd=I|3Vw*dXwpPJTqmLD58bWK84{|$Tp#qi9Z1YFo#Ww zv8Gbp!nf{&iN_Fjdhb%1x4Zl1dNuq-e8`Z*Li>c%jk5)HGo1FL5rG zafav;ic?}}fS|>=5Z-1L!1UKft^T6AvECcID?C^cOTJ1-_4mIoy(~1NX&zLapU3o> zb%Yz3tc9E*PYDtZ^gDs)Ke*(6!*<*{M1X>7vx2vey7|w-V-9m2cKBEXC?~!~FxwmY z64VD!)U8xGl?sJv}oTq8O4he$Qkx<=ha%|FtT4#HE}1q>y#hx!@L_Fk^kf0l~}0 zTxB6^*uV^U ztwQBop{6V%6V4J}E$z{KHF(Jt=3z&+eYw^3;LE?zW7_kn5riVkn-^Kq6PO;&55tOf z6BY$a7Z$~boV%ehj`O7f6&e@Y)2bd3v|=d(BUxt&kt~@n0auHO<3=k49$0waF8P#4 zMp&0gw0G_}j{Vea&}`G&M#Cp9RPrKzZtr;60jVZEuYjgn_18HU3HT!;ZL;7!ylY5x z_6~|3YFOalLaU&%3e@nO8XJW#cX8ve^w)$60xIJ6n3J^DU|=y&?UPHfO-m<(ytKrN z;NDv`P__VLxx?NAI%(-=EzkCUKWx^i!X?}JUq-GM0cPLNOyL)4$XCZ=DCw4{_CrAz zU;4i5xqPpcM9jKdZog8!$Wibrp|rezBD<)?r|(OVvH)j6U!np`iUO9Tdzy)*Yq9WQ z8$C6l;D1p%>DhUFZ!1~DaMDs_OJfRf9cK))^aE6u?@hy8HS!Z*6ffwXwoKeSeU=y4 zJ}A!gK-h9SOIp%(!%$ZrzWzf;UK&bi?A~<$7)?K)6H3v@Z!cuDHX?~+zDkT342F;7)8>DH(O1P34jtJK7=T^1P=C@H`a^V2R_x8xO`-HBQM z)jRv~Z0*SJO?fmwDDufaJ*J8MR-#w@n_sWYEADQ)X}`1PS*y5@tmguy62Rt66SJ%d z^lv!g92mRjlbI&WO%T?APxbzil&M{bYIk2iC1KoEBym6Lr*K|_J_)nVXbJ89Yv4)F z_bhO+l%m=N`YORx!T5`PS;vP1O%8QH=%D?G3anZ>j-0c;Xu4vZ9F| ziJ`6bv=y}qHWpZy*R>lU@t&F_>c2(Oq9P-)x~~Jh_Rfchw(}7AL*XFg!)6Y)p^CUdRg2ZqU8bb;RkZB^}flGxnCy`=M&?m)b-q zni)YNZOyvDrtDDaarHw@sI%m%>QXhc21D&J_#e)>uf2!sDOG0;t&O6qfi0WCBqR~} zVBiUQ;@ujgNn<-QG$ipIu51PnoKBnWp{UK4C$LG!iDezd9x3|^u_(8Q24;9~d^a?t z>)sX`zVvVDf1Zj_cc=5%?v=A=>^ST|LbK+^khY@5uVBj1m~IXewQ4)=Y44_o<$~vuc(fH$AW;TMh_O9hz_7>X}gT z&@oBGXYh_SWd&bW@zHOb69^y2UZCDH*VXQ6-)tB98EH2g=+JANbHPh-&ekJS!>qDA z?QL?mE%fl&-1J1V4KRd_yVC2kKbJ|p0jJpy9n$}>jm=M0e+Q~cv>r8$x3=h zNbHWJXRZ1RWo{eEhUL2I8YVjDICgfh(V_3XxV&YfX^1~v9qe|FdTQ*988p=+6u`> z#_N8hJu3O9F$mloB1ruC8R_Xh-)V_*}svf(5#`GTB3+grhZ0P|Fq95vmG6>9>MrE z{7y6ed{f&IZ$&T+!H+OD=zLG4a_ztu2{;+Y9xVRWz6Km>U>wE$Evy5DsSih#_am)z z*~+OaH1g`UM`~!NiBGLqQ>K#;@+MwXGG~(^X}ZEOdHA*4A9`pB4;A2y_CaU#2`;(! z`~PZJ8g~uJ8oD>iPm(6BC_DGRdCv@ISK5BB<*FJm?$mtR$!@kQWUSii^8L(=)@1Gr zW?nUO-4%E?HH2uV+&pT%bG0}!F1)~OuB&$z$#9zZP_X&GcCn{UO9HJ-I;+!<^d^7w zoMnwtmwZ;otx((-E0+#=t({_DimiTA3h$X-dxwkJD1P|%ys*5{dE>k-Qg@=C81Y8B z>}-QQqI^PqP0L$oX5FVZ1T(XnPow=$u!l`3e|`xF_Y_OSNc1o#(uZAowIUA5~RDr3%*NG!-jOd+@ zzrlbkOY;-fip0s&kH&Yu4b=SgXp${bG4*e$plAwi*6SZLSN$vQ@;4%zZkcah%GQp3 zOGd?Qw~lI6kR*R8{~;-Qb+?T|m`$&P8G51}e;_GHIgnSg<*K3JRhJg{!0tO<&j{H0!2~ zxRvrE2lwXj)<`w+1@*tLw^x-iCq-C5Q~y$Uyh5~=>Fzv*J)@uap>oWr=f)1h%qQKs z(6midV29cKtdBn8jJARU-H~r=S?;YWb!sFuC?fpN;lU71#7c=R|B4a>*aJ;d&H|_C zpb0)o&;)x771KmKrU}^Ug&c8?n8&fjJMx(f<2KrSx+4`bW0!7rMwZT7(nPaSN9N$} zyl5a^ReB>PbxC$Hgch(y#4Z1Rw4$WMB@@4bmj>_K&dY%nc=MFS{~bP-B8t zeO8nv1GCIKBi|7i0AJjlt3PnwzDR@*h=|8-6lmc(8VBy|nvji9fD$Jug8R z=IGAV7pb5J!nG;!=9tp~g!@EW0JLSgRvdW!i_NI`{!!MCDY0m_3_{ieaG);GdJbMG zc9@pcZ(8tFsC8%LV&akr*u$8i62kx6uIfefo9vlb5TZn?vp6<}r)PSBxZk7D=g1?@ zjd#!D*c>n(gg8(H?BxD9tDiZ-FtP{_P#P4C$I)!;`}jkO3+jV_a3uube^_|^8u7l{ zI*cJ0cW3!1W=(0<0Q9ga^^iudJJNf6M;>vDNerxiX1WAQk+5nKyg0}_~F_tSkhT7#06sJm8lK7=u;KDrZf=92_sU+q7mRQRID5@B7Qqi$PPA7 zR+Sbzw)wyUR+fgReUYzSW%rcNlRc~vbQaLQNS;}L+|zb9BGAI|3T}|1ZJua0dZ#{? zIJOLyD@)KM?=xa{*t0uxA-LZ^g_zg?FqqDzz@RhZTUAPp5g9vsg{WARTve(mmZ7`Q zysJAOaKvdK%3}^j*9sG@c{JNiwjOR+nYox+2JX%w-s=f?+I5!S8ga7Ava0k1)8;UY zdn%V>)EODVtQCN>ssKwno#^PJ*y6uk@%ZE33_no3(9By&0mpli(hj@}~;J+xg{K#*w5u@C-SJo*}Y^i#W zIQt^^^vEu#fh+ICD7F9=AFzRYxnq13n?vzBXk|)4C>R*7YjsgtWTOM%wY#I)#gqb?-VDwRY_L92fCWE7jF z=XOcvIj5|{xK^A@by}p`KYS^CuOOSP7_~6cNxSPMLHU77t}&J^{7MTE*Wi)fY~!i% z^;re+C)o0xUB^kHwafQV#`CD{vVJ|2~5pCPy%eI19;mOLoc!V~=!FHg7 z0jSqRUD%ZCvtA~bIaxkCsr$%z{NR-H;q|g5=VxD~S+Rj=QVG<3ng*RCVdC-ogG8JCoX=p1@cK&V}4yVy-txGkxoa_spa97wLp`D(+;9<Mr+w}Hc6mU<((HP~4UJjANo#6>w2D(j~F`SIhrqtiOn6!l9>BR$#YKhU%1@mRUG%;#6Z zFz4;*mA@pewxje1)+?F?Gb@RigsO9L`iU%j`@$(x%pfY{G}!OniNTtn2w+B9T!OB9 zV#n02v2AEEf>;$pov;(Wt$x-|=Wny0NZG~@8f(96y?j)WSL?7m{^q2v%H&o)kn^qQJ3Uc3s8-XmA7by{rSV+S0-ql5*1w*(;Q>D1{rsgs zNT{@iLl2oIIO}B@G#eKf1OA~>q+sw)w+Xth4>d$PGOx|TIL{RIaRATOb?x#5!z5L) z%~$|sE9c?k_@*S`JzE%?$f#K7reQ|lmBk(eJ-q*cjCM6a+t~8mpuA3y>2qG$@b=T9 zC-Sk(-()(j%yl(v7I5a-Vrx@ZHl{J8mB@ECsJP2Q9=)A6gxV4fp+knhGl?(1R5&@H z2h7|~64z+xAIvE6^d#GKuH&li*>_jQ8tJ=u(NnB;Y7_LevGd2b+hB%cU6_fIL zqWv*N&AEAz*67jOA4!Mmp7t92lDibW()+9V-BvFq@7eTvgu)gro1>b!9a9#5KH_pY z!28mq-|8rN!3ZcqMZx|Cx|Oh~9S5s2PsZAIVs3=+lU>Sl4LrUs+b5a*=jHuxPogcU z=!>!=<9qwh%SR?=O3eD)8!lJ6kvR+8rirsG>1tP^r$~&gv}L=0pHr*T@$78ju8EA$ zc&=X7JauR_y=V>%yYt!Z^m zm}pj}K4}=ZVkb-@{oktT>X(Sco*V1mu3uTtr|+@GBa>Mu6{MsTx^8a|*`dpAwnyIe zZ^+u4JlInT^r+eS!JCiQN+kB$I?HJ?WL)^pux{O`)YIQJ6?|4jShBNiKJ8f`i{xMp zTA*}u?*NuAqi}-1+L}rx<)D$PnF#saE-I;SKKr*u=I=gS_ZQqxC{n!8JMHINfzG(i zf6c`2ON;JZS!~%K2qvl;vR&AOG>cANd5y{pTS?C|(2fkjyY@Htx}Ns96do)4_bufa zM<_MgE4L)S;hdtF_GyVB&Du_JjWo9k@( zVBXbwkr>VO1CNv2fbX?{AQ6z?*Fy?4yX;?MdoHbf(W52(BtSE2iyH7{5hue1II~dz z2N10Cs;w{jr%@{B0VLT9!+#*Qd~=ciVW8k4WF?uQ6)u33#_-n^d#Eq+>kTCMp@S3( zbc4`~K6{+2{JD|qe(0B$Bk@OxmT-;#(2o%Ij|qO_!W)!W@=K3zx{Lg|B#evvJXgm; zhlyHyWjDbspDoiNB)YTVRX1EA5eP;HeMV=K;}qXZBC+I%bt!2YT)@{ilw1U&TFl); zi000n51>s>0EV9<+AJ;(y|NFEa7Yn%1Zlj_b^vLubYW_OFP6;j5&<3t=W2`m4?v*)G606R{Pl0YPNK#nEfsz=-aeA&)MZvt{2QiqVD>lYaQr_g&uz)j?Z z3XTM^g!<48KAd>^q0^C6v?K(YnLiJ~;t$LB2!5V|QY3`W4`4UJm3E~3(2r0yW4`F9 z1&}yE>Vyc8!)ISD@_$^<5o(4ja1=UY_y;vjb8tB`m4b`>|7GlVFY<3x{{yig^L)qd0SO`INQ4qcQm6VO4*k*j?M2W0YYe}5@k$*DE&w5hAOgpCd0$42 zRk0tEJb)CnbX)kM-;e2mLP8@M!TB4;pfOGG`<4mZzUW7GvQUDbv{?tk0VGW26d8ve zjr$M%>1rW@6u1eaV!1)^b0s~!2~x%97=4sj2zo!6cgelTU;5k=jnuo&v-F z5Kevwksi1Y$T8zwftxrI{D#vazk7ev+eQ9L*`!7O*1(iz_^0s3CiuG&GafAY`16(g zxq*v85LZWxJcy5HG6-efE_jTFsPU5kzOaW7FcnZ7Y3ww^ODQ~v0BV*oD1nGDiy#8~ zlg#E{c42P6!997A2Bm+5(;DRg13QWyl5apdm9YNYCxd90Plxc(DxnHm# z3V`=doj1J{KW8gDFXBz@_z>)!M?BZnh;^;Y`^I`aWhYd&y>o4~oML!g&p@>y<^G*? zfU<5;y84H&L7Z4W=lDb~ob|tbs>**?+%-$y6CuGq7Q?lu)dc-IYE^jj*zgYV%@e%7 z@-;%}&?rgHWAX!O%JFt@Jy$v9I?;1)5kQqTi8a$MIHAkBhTy4_sYcfCmG8Y>7lm5) zF`b>T=GFebuLt`wT-yWV0xw+Rz()?CNSJ=TC$o6Nd9STjH}StQ(h%&3>~`Dhd#Ga! zO56?pG1zJNE}~^Y=Wy3looj7%40GiUi}f+Fbbx(Xz%{qwK7QZri6`#=#7q_n)G2*xXhQ`G(yTPm>(Kp+)Ry1x_OGH zA`mc*8pe8GkAGd;#=WOalJ6&My8pC$C=`3PEq{vBE^%S2_3y7ApZyH|H0Qdzec6`Q zKhSlmx1ql7Tv>z<*iW|93E;^)zV@I>WloomkU-~qu8+V2=)m6Bu|GjI-Io1-4dywj-`b7de9QI(|@L@vHR4TvDnu>M0w$-wil zj>`dKABRR3A4{Pu_bcXK=E$2&gjLJ;!+2Tmdj)45h%SKPad z<7i2r@cNcW#w}0a7CFB0!$+Z5G5WT;loPYx$cg2x69?q3>p>phpN_)s5+fUiCk4$K z7K0ua8L@<^!3#p_w6$FY?1jU5W2Z*DKoPVL`Vnd&i0|KCKAWMtf_o^N#t`FLIt1Nl ze9r9zJoQ>=E`79@t;=~+m(}gjg2bY|Crc9AN0DvkI%L2?qeg>_J-d(C=-InDqUCwB zfpxD>fYOfG&({k^*XsIkg@pmN7+P!pqvD;I!@>_fhYgcsznwU6Pfh%7eo>4YNf@u7 zZf~EIx$3R49m5=SmF+s&M6Mm{U0OcK&zh6Nl?->%Z- zKMHfnnHlX0wfVc3S&(5#_OrAoCZ}X!bkQqXNy-9^{#PwJpZ0OdGuVCsy%x9gr`#KH zT=i}>Z4CEmC`mKc4s&&*xYZ1$PmNQU?{RVBYA*+_bOGT$;0UlRvW2|?za=E$!b zWwr8RQ9yLqF3W!CF{%Y^SC+94X`mA4-fyqN4iwu@Mi3@yWrxF-^FoJbS4by^+^DIB zy?`G>7u$Kr+*?g(zWJ-2PB6W#-&i+Wa$-{x5wli@0)wS|29DyszsBUAf%#& zsv-QV+XM*QGsrlM)4REjH;(pTwaHCw5eSts`1YCffMoreiB#n{oM9oCkE5=IM8u1l;rAk4JcO}ok4)2ODskn~|!fwK8`U!#jeOvzgUun>LHbf{u*oWPl z!H~(Ae^I3+uIn0tvhBTv`uO*k(Fb4taf%7yTi({#LB6&`z2rOa6GbZRJ8&MoDY)q! z_~Q@dIoQnZ`>2XHx$XB+pRRZA!h5H-!|91oMN=1O(7?KYw})-lJ~9W2Mk|e{GzV=l zEaHA3Qq9Q+BsE1)a&KR@6F~JgYSAl(z`>1jP9#P(@mJBHnq&(SFe?AFZ^9FJLrGDe z78YnwlV$O>{`?WP-_w%+%%$BoP`KC)SWzq{^tj_s z%O)OmtCsYNflKTj*3U&k@~rAVepZ;5n=W4ZG{4N0dQkhnMVlAz+gak5gQ9-$hzyqn#2k0Sry&C4S;6m#ue zuplTFtozk1{6Bt-zWh!2Kb~yt(Ne5}QBz{((?xRk;Ez;TKXKX@)F4DTC-Kz4fnpW< z`N8T_OZsPR5Yy9gBGj#2sP|tB*d#5=zbtj1ss!fSM zBP;#+FJ}8Zu0#118>uunz5jkL(YcQbqpqB}k6O73n^ePo&dJGoh5h_z&^hg(t<1!x z?mzy@vwK@q{)rqagGLM zFR&P@z;Pk;#!Dd8Yo_+OE71`HGM;bsm)Ubq+<3-zUqSi%jagsI{XWSPsnd*1Wfo5? zOOyJ@!VSXe@ky&Vtt9OJ)lMO6WwjU<$&n^@Wh>qtwMDAq8ACYp>JXMEmPD^fU9#f) zwc(hkum1sOiF4K|w%ffTBO8YC8?E z+^xRda`rA{qx#3+FOx1`-CSh%?4>>n6CM|z8*MiLQVEGENzT>zJ=S6NJS`~R*RXmD zOQT7$dgCz;H{|g*(NMYD8N6TSN7*Z2N9tT zbJ|3Lf8l{;&yN)%ojb>ozYRH_(q@|HYM!)B3sr#$Av zQLE6%Ypi;XV_SHnQxN>t4zDN?Rd^q>qdJhdw_t#^c`-GZwie>AV$HA1aKo((QLrb# zHGkCOHOkx_I1dLz{Pr}AC2a*{_zOME$xuSa46?ryC1sGm)^p!VyZ8M%CVz^kG}IQ$ zt#R3_+`ThO3*EQX%)ACXKOzMpr{j5q%aj@|Rs)xJ?_9qhlXThinp)D`vdEmbsRfcF zS`(d4w97ZH+l(#Di}ivXtG>Lo6<<5#`C}w@Z&f4I^t?6QkYkDo>F+pPt=X*XE-Q;z zYGiJgTXMIBmn&^R73W|wQEr`NcXmcDe!`xrv-}a_A{{t=2>bd;a?b$9k50Mm)eplC z+z!iHtiAXf|1V2ZR^LL}qP99lo zI~)J4UU^$JYE0iIZAM+-%(9_Afo}C0BxBkiO(g%tJNvWb)wDfa-&t=iIDsi;x}F{v zlvV-@J7d`{HD6q##yNSmVg{s(vIahij-2oi?zd~m2)9j+k=(QjBqcjk_*~6&sK7B4 zX~@wUyY^pN5VQtxqQTsq?a#>*PP=yq!30ks8G@ky)#qMgl$TXnX=kg+UP=41U1~}D zqSxQwIaDaLc!s$<4G5DR`U4Rq@1*4nJua9JZy}iPKW~k_JlhL`9=P?C1VJB8q`z&Y zm0Z7434+dHM(%5*n{pwjF~OF2nO0hyD!z>6@RqRW7ytVjswX*zE9zy!Y2J4--Tj>K z5yS2=HA$Ge9c{B&?*AO-uiIkP*i!Fn>`cnMlKyMD-xuE=D+J9sGy}}mEa?lzX}n zQM&Ysnmw&l>S-GIdn7a*N>-l8nf8dXcQVA??=0_I5Ofj}ZaM7kh&p}L7W?DKkv&b7 zKg->38@nx~qK|H84+5Z8d6FcDx0WSN9v>dEj=Xm0Q}g;Mhv5TH!=PHJze5c z{N0BKKcB%skk+Kh4sTrpr9qgx&JnS68ckxk@1&dY__ZKt>CA18w5Dr<@^bL2CvCLY z)o1*zwAclVWGn5c!BT{~-?|WYTKasY@BcaD(q+`BD+XRmH@hq_4ZD|JL<^^xnSs_* z0iGX%py&~>DlF-CD{Tc+W`MgNfeS7#9ZgTM;X!=Z8cpGq5a!PDoJ=|xpylIAX~tMJ7HhdtelWy2^>1(n|fhjS-ti~T+; z3?zUjerE+>?#@@QJ!*}8VV7J;kLi-Lnnfn@M2l!A5%w2HZP~o%&lhykggT@&Q7-a@a9Vep0Tiekr{_cJ*b@m`< z;;217%-!x>r|iSl3s8Xs%XB9I^m>Qj=kAAnV96H_6%%`u_9(*80L02gddlzk>SM=9 zcn~ybVu^}cqx5hEBm%Ebr4dS{8TlH+SGFXSQir*`cSuFMnr>u-0DDuuTYzA(68J@H0y0oxV z?I&&<$Ose^m-8=P^ncjaP3e>Ae7f*Q1KGkR!w?8}inHW*F-Y8T*{3-A%Of^)gv51wV12u@#AOB9K?8^PY6EMm$j-{O;OnHCHh9!%aI0V_*bs9 z>TPSx6RHZYbPr9wLmGo?U~b}HKlTGu9=)wLC-m8zr(MdV0XV%?H=lQ@lK6Box;)v8 zLqK-^NsYaDHv=)zC5hIop4-3f+YI;8H#D75N-XLR@SzRSXX~5j!C@)sqTPkHuCw&Y6L&HELnt7 zu$P#3Y51MQ-kw81>V} zEO`gPGKu&D9*ZIH9(1p_Hthaa8%xLI;XO0ALiAuZaOI^Q&LtgoAwKmk>DyO@j;(di zgV@XoBVmE-%fI10YWetIYV&Vbs^N}3?ZeWAX(=hMv8y81{#=(MHZhCd#9JPJY=i=h zGTc#Pq!Zic>Th!J17jO|iAsp15un%c2kmpJ>uM<5DeKsV?0hid>+rKQT0S$QtvbJP zs7lom5XF@$PvM3A^^JXL)!tI*Uo!E2-O&E$zT0IijK3ik>nJ%ap<5ENu)ipyFXG%l zF&@~Ln)|jPtV9p(+6* z^&)!w!;+rkhALyA?XLMvDi=vn_4G@p522S@*H2(#YAx=k>uahHa7$+;`;Fg>G7@K0 zfu##1Z2DwVf?xeu>f1^6^k;Z)5G0g?jb_S+ROG= zL%4z7I=UZ6!Cz!q1)mz!c6tZN>lGTX0~+Y_>mhafJSP>`b3i~s+zt3vR}Zl6SsDTY zUqz16*{*Z-=vy8zluYoxga!WGmnt_IS=$xS=%_g&q?XV5Idp9Ve;Lof<#b$xyquhx zx7W5Zlp6g|K37VqhWPpAjgn@ZU(MP;vc08-zt$lE|bs2U5i2Uq8 z5))5n3e1o1MECr2z?aN)k0DA;jq{2!jx9J>;(3B5W-E~w!uRpOB%)XJAs)2@yYPcv zjAYAQcSh#2t+xa;tbem-ahmQ}FL4{l_OUBSV36B3`VDyApQ~m&{7iPya#%-WG%c3o z;`@4qRFhc#p(pG(FSOPBTi*oWb~}9kglzXmPHc`sJ#u;pQ5#DQJkl>E;l!GHl$&*wrVU&Ok<7;0Gpmx>mw_ISaB zDVHrQ`%JJ*(&~sE-sWwB`PTJ=f*rAx=CHlglNlbvfT8DXBD~oPH(p!p`ERyxKm}Yk zsRp*fezpi#o{Siayi7{k8a#Jia9U0}*Elsy;G$Z8{--_6XJ#Ub8|!Y5mdkloj{g<2 zGVXU6_9RwJ`1J5)y9kdI@X9rwdSriE=}(Q|+lCMiyPC6O>)sp+AgzaF>*)19>Hdc6 zY)BH|QZ^UKw0!aTcyryQ+WN)J<(6U~)zC7a*vUYZYC7Owd%A_&%=d*6}KuYnXlPmQm9(&{x#W@XfO95${C*Z!RZ^~@+P0~c9rd`}48ww=sT zeYMs#8o>;rW&_7FPM*h(=PjOQy6UU)gih(dY$8b#XM||oEZ-O9ZV|nL;XASoF3aU? za~A50tJ7y1Cnq1wBWfthKX?phoXb{YCskP#W%KOuDRVNdxSf=j=e#ZLf{q?%`0I!G zp_!GG88@>)4q(Oi-}JuRB%0IONuKe}im0bFdf1i9tTsawTz4~}cj+sW z4_7XF)a=!$MIVqlQ*6mxe!Y30m}UNCf_BeajF{kRUG0Su<9e|=bu-a$>$ZSQQF(ze zQ{U>C86#4-h6f{61>ve`7_!)dhE{L5ZuT?3c$h!7JLF9O<`b?$V9C7h)pW!n;iS8s z^0B#7=V6*_3qMNsP#=<)G*|!;E1z%)pv-J+_V;HWRQ`5`c?m>qwVGA()GW-3wFJ-m zG=p}5HmvC9V)eQI6S!l}l`E5s_I$a>QD#*y^V;eas_W}Tc@ne>XwyluYgm);b}g~! z|MJ-IV$KryDLPWF=)8<=Dfkut_ipuQNaC^SFHy+#$lq0|U!+eJyiJn=oL1v>d)#02 zR&ONV)Na7echPp#7Js_X41Pehcc#}nY6Ki{`Q$QjF3bvlYkS~EDDQnCGBtC%LEp7J zN8X=ah+y1ZG8k*DI-4XEN)?{kLPc*Om6RDVY_3>&Fvl!v z@_;sjFgqaBpTh7yW4mGDT`WwdY2i_EdDhy081Ndym>?w6?^VfGYu&=54ToHAvYhP} z^!y_KuKMtbpgCW4gl$}?I-3m*tx|QF#M%@OMfUIdZZX_4~WOt+UbdO ze21;?RPXM_UwDIeryu8@X>e)6+wiY_1cZdP<{x%3K@r~Hv=Wgs%}$~X<63UVpVO%R z%3`G1Q>Ju2=ZPmXb-_lRjR3L9Uzy5-5xwiC3|sKCOF{dSYw3+utBxIaCn>=E zdjiGr8@)}R^*DOfS6(l3jXeakU7Md@mdA*h4iR>+=n`?a7vk=7oaW|Se1zfsg_f^L zSdGG+cFB^@I#<)9yBcn$?Ob26_|c~LF3n%2=!u!|q@_cze&u!}L`a;hi#>2O0TYmyiH$97+YZEA{7S{1B*8iMO#)g@BhS$y`@(F-d z9TiZtaBjbNW)oZ%!)xIBn$qj_*?i1SSve$->fgs9v%G0{fDbXuAhsr&oO zsB6Dsl?lm#63r>sX(&OJt(~ZP@>04%pLzUl2+e)u{JaxpW+MaNWp(Z{U;Q%)eUM)CTuza9lK9|{k9%n(@WPFDurdc($I+`3mCBwQIlC zkq%sMz|rG-g1?F9?eI1G+qnXqT|YJa`J zvakYcI9BwA?fCB_de#CpQdaLm*MUosV);Fe+a8DpnAtr!qXKPcAiLQ z)+l}nRfN)=D?S$3<090*7B^OY{#?FmzuRbhbNk(r@50U8S7}klpEM)o1j+J^7B}-h z<-c-Jy!e2DZ4I3-DMXSIQCqosiY4?5-Lzg`Q&@4b$o%I&I<}c(^ZqAJZr#O%y1=jI zV=aC&NL?z~@=BX}8YnHb+URgPjui2bdxmo{}NN*^3} zd3en1WUj{o+(*9y3Csmb&pRwD8*2()TC5aa8V@_((Wfr!)!KL^!zHR4aIZL>IkrQs zTDH2WZHanfx7cfO{Le4e%=yrNQhN<$dju*MrigjE37dc$ck6+%!}R)huSYzUu3aJB zsv6tR5ISMrP%C?NiP4tL8Yu`$%k}$OvVoZq@5P&!>vOnQrj)~8V-H+~GN^epfCsSs zF$#FE_H(nOxhSpeji5hP64Eq1g9a5jsQELXn8-gW_X1zfG56f0wDlri)=Pl4S?AWoZ0++$ z)|VgKCU$6M%a6TO<&$sJ($09JkzFsZfZ=2_F z^#+oTFID9Y^j~=$M`zwHWfsW)p7gp!S9Zs|>1_PiezStBfpQ&Y4yB3cW@Y2%>nsku zpfy(2p(Gg;o=$Z*ujG7Y$BuvG$iw8Jt7tzqTX!Rimm5${AZOS6F*f&Xo}>@CJszX> z=4F!Q{O!SF9dLy(p3SpCr!&JN*Gr?@=yhW%`coS3Z8ITZnSsi4=Xv z+K=pa2zk{N*nik5+o_n(M`z;TnDK~K*lG)ypjq3A5x47DtS#tEovLQO2vS%s(n_Au zdm3^6q+Sd#`C;Y4XVmSH7K909+i@G}Q%HPrrg_&TB|!VZl&-aXO{P5SV~EewSWR%k z3um!d$DspNJbF~!WAw`1!b5C|r7@|CmzOR~e$08GzxFgIy?3iM5c$XF9YSt=xYOc3 z+26I`SXR}S|D))-{98439+TcILy_TBkZ_Q;k9XNHuS?30nr z*(;pcq2tUuobmho{=CP-ectcSYdl}i=ga$E?>CHckvU$to2aJllcNl0^W|BC{c4{Z zz%0r6)wBMayn5M(ov_NVm7z- zr^-=IggbYQ=vI%=$aRTr+rht%KWfB;`Fa0EzSNuEfEh2FA5BnV?>4YMtT*;#IE!Sp z{599afxOA~d;9F<+x`n`cFh{GSHJi_bWH*6nkH&NH>)CL&Zj@!!qhs`_YFZ9`k^t6~<>B=I(uq$y$DBO?KSBp~nKdI;&D^sk$~9J>P+nZ~wd)bv$32!?otCvW5*MK$alSa{Gv)c?sOpOy@1bOozKJuP{Te9-DC_9MM>X`S^y5s~rxcLxph}Eb0`^ZtI^B%dLAtYPl;ui^TDjdvP)942i zy0OZ`Gx)J2#jy1rD1>cJmu+4`e{dz(cr5>t@&o55iXXMc`;|J(Ln+gkjfs|b#T z3)ToK2*o#B9GKk_)Nix|mUWt|GWj7w}-opF%Boc$Ck@hL@I{Sr3f|?uhC> zvl>44n(d3y$G&gzxyNtIV=V0Y^-aQXZm02RwPm0|_KftcMf&ro!Qr$89x)ws&P^VL zh|AZo)3FS%S>;*RtqyKc|D3mN&cai)jTw9i*K21s`av=`R0-FLE2u90N4S?;k~}Bv z%oKioZc}{nY{+2CI?NfYJoGnMfR@H(s^&y9Z0-Nj!Nt_iwCZTaS|t6>ZwB^r)f`SAeli@0!Lc zf5e?4C7k}t=aG{Mf*+QLSPL!oha#r5m@SjB{C&9-`T-wLpUJM%=dxW#H`=M2%@7;% z6kT3L9_c)mQSkko&tk!PXHq=8J+5ztrqp93y{(Q(Zr0Sm#Nma-aTMJsl;5(eN{r4k zCtOERA%gX3RZw4B7w6$%f(39b`Lhs@k5aAt8^d8)H+NJZIG5`c^m-*-m0oH96_vI6 zL{h-xn(VM>#iJN*c?~o9_wefUlMsc?0zS?8T|q?oldnEIU)&PIy8&N{+F7%AGzk*F zbp`npj|S8oyg%|7;tC~3UK+MxMth~7>PbITy4(H=BNqQ-lt*@3!BHQuDx7O&>Fs+f zL>bA{RKffoEO9&S(HFfBqNW1ocNWZVKc_s{5B(cf@Zky>cbLsRx%v zpZaY)H)U9v!#|3x|D;&R-=C}UN0h40IJNUuuinx#GA<t}4%!3N9*lAAP z+B+#)+JI1gSdsd%^I$XmO!lusU-qb(bmU~bPU!vU?2T5XHCfVm&&TFxmkxV9h@YDa zz2knW6>q&$eK=@BtQvcCiAA>C8#zMr9G!;|-`5@=wuCz;Zebhc>(1Y`0^#RkvbNWh z?+%{n&4k@r9=3Y^_!B$e=;Io9R_gJOh}v9b5(&fv6-!R$T+`4D>Q}rOz={yRko@{k zlY)Dws_7NBUTg8(9b2WtuUZ%ADKHZfvO`8EC%x)qAlzVC^O}t67__}zt#ZDcSocdx z=WpG-8u~@~{?n67>NwBS)N4{yim?mqYJBpQH{&mk8#)%%hd5z??Rx=@%@;;-55%;Z zP%HiIm_0{Ga<7Gq%v*y-e(p6{3&Eyq%2j5CdyW!bf8_4uQEa6A8TeeD)#Lp`o?xcR zQ8?C@HJD}{erIOAH^N6r?86(51Bu7?zDk?5udH*8JgN$FOV( z#-BikY+S(4VhL=j0FaYti?OzhOay1eVX>JvSJ-aW^&u#FQSKTeZc^cBgS8EWw?#PN zyU@Pu7URv#Xa6ZG+EYWgZzG#DMZ;u->&a5r$|weTra|n=&44KcW07r zg^ExYT%^Ssz9Wk0$D~!tUu`|Up&3s4Dbe{Ud6mcL7L)emCJ@dgHymwVU}S%lqU}e} z*1!0@lHCJeFIcEz3_bFneZZP(bIBL<$1gHhDiW+ej#{Gb-7oxl9^|$!io4r9~*u zf$~}_gx_ELF&9vcO)b0lg}K;xGjS+X=Z&67IoGp{y&Np^4Ef;IJ&uz5+k5ziVv4IF z%H&WlE+LMENb3bW_s!Qf1P=N5Cy7(Du*YWw6j!C1jnjRcX$D86&r%4A!}z<`-G-iu z`?_PilJ`%K4(E{BuZqA^Tp@p7-q^Cx))cSb3dlBJ+FFW zrY};&d(plJ;`K+N$LzPrZ@D(^Xn9Vq7K>jhv+#8?6o+s9+hsPn2ZlA6j zq1QK_yqV#-QW7aC#@Dj=U>-u8a%djO{F}4!D&Ag<0Z8}neWsl$>7c~Ye7Di-ue{=lb;>ma|KbgwN)GVr&5 zbd1p~6Ls?m52RTtk*PZ=F;B~`a!!b~wtgedxmvoyJmOWJJt?4R7A>>mCBInU-zcXz zdbqGI0MjDms&=FeU6NK;-hxPPUZEhp*RCa!_h2){*p zN~B#%Ci~pyDijU>Ds1LvEwi6?M91s(Q?^W~k1vj5wN^4sbF9|yS-0V=L4n#j@IO7Ffi}8UG}2ZhgVOoC6^TZbPDY> zJ*vTS1zau#Y~Q)%d;F?TkP|%nAry?48?y2GLeYG|cr8|VD7TKE{h!HkwZR?S)5l*z z6+V5my;=}eNij=h*4+`TTCwX|M%vMQRfstg!^fn`Ny%sKGG`rz$zpUJKL0rpN=^Xu zzVkyC3>vi#G2dT1s7}oO2!?jCoV;#0_#>LF+vIGl%Vu@Hu8X=WN!g(0T{x6|_XW?T z=cSlN0s#NJ1_3x}7gP552`P>d+w7&j@4Y!69k9a|`-5PV@%il={0n_N-v z9nSODYDuP;-yNT7Z9;lFu3DxHRjw6hM4k4V0YW5W z@x&YC)xRY^w|4A4nK%>~>T)HEk`oXgbbH@_H7+)>$c;-sX`Fm#Qi*n~OvsdA_?_aR zhV#+E;D8J~m@@n2)3*_thLCf(Cb=Qx364w`MdC&Gj%rtCO z#Z*1X(ky33KB9I*sse{@st{R|H9#9T{&oyt&)7L={BywdN9Vw#GTuH!nE@Kien<9> z4J|blX4U@N+OJ1ShM7S;{z?(d*HhQ_hbLYn%|eZjD}PT-zy6+b*%aHrK)w-UPE1;s z9h9;$FzVrET3teG!d{sk>r?G)y0`cn*$SSRBv*eusJO)U8Ie|bSaXT`KnRcwja10{ zS0~|M{2y1ND>}&^5aHm1^ZUw^edyNTaL!hvWvQbj!tER9oe$i#trHIaW6Nw#pOK8k ze81RP@5&VBNgOSXcU+@S9dfb}yPy3|ej~^7%u|*s2gO%p^6K`Y^Wkjvv7>k+NBaRP z`#+7~8&frzKkO-pu-aE5GRMHLlj8Zkd~2#l3I9}gD{nJp>?W-r+kLzIn*AyD=M*dN zngeIHbPEdMmoXoA`Ng%Ic;B7Aw0gb>Tkq18I91p9Vm{eAmh^rg^MG+F&o{M4JLv4A zHP4QJ^I#yXh4VfZ;#FfK5Zd1IGQ<=P|otv{I>u)PDb?v2>%cGN3~*Y z{em;WA)-=TWbM==?7wBoDGw53E>G)h%t|C#+sWbkQHwxmBJVG?qhPG=LH`3swW4ML zxxwxx{RMm^&~f^_`vj%Mx54`T%5MclxEyY%Hj2Fd1+~AnFw3qQr1SZWZi_(Stewer zs<3vWQe=GdnVoO-@!(b}@Hh6C!IRCRv1v-nRQ-bHRarrsjym`Db4GQ}W^6$W_ru4X z#%DHF!S^^*FZOO*T&qlHsQcsntgTutVP{`I&A>s;iTL7~XpG9AEqhHvgtcDco_OR7~=6AWPC`cos>Lw+*L zBKOayz6!o@;qJv}ON`MmY^xPB)g!@^_4wpXoxB$JN+XP3xF##)Gil8Nk_k%3>cN2* z%netux1W*rqr4w@LFU9KA=52&oTmLBG7=ajZ)HB^eITd*a(HdMS7d)hNsD=v?@9Re zJc#~Q;Tn$KcjvG1f(pX(>Jxhay$2(p5qs6^!d0NFK#SET`n7>cP~2n&N2Apy-umMnaI*YM8;>JYbut>_}AB^ovFlS z_B#qdD%Vr<_Zrkc1X$_Bwfl*MQSp1uyTX40j@ka^5U94$+3R%HA$@%>m|KIER zXOG911+P)L2Wo8p?E*Y5_t;qQ(l=+*u%qLs|21v6AEXRs+&hKn>`o2tZ?-YAp1kmh zWrm-o!C3T|TYB!J-@t=j_*V}+Lrm|NMlT+-}S}g zolT-_-Plcig|;n#bur?b853H{c9+tOrD-hmHco48XTqfSiGc7z+4hdO4%;} zU*Ac)+)L09B8m!$qf>%JN|FJI-#T|$ZLYi0$-avGue;+J zwP>;N{9D?=YKx3>z5sGcOM_k~BOZckMo>d&yVP06nDhal_X7d@H};Z)cZsppk!&vcHblL$b51|aoZ{5a?Z`W~p%~`p2ZL zotfH10X*%CA{-r(4g)n(e?HYRd$oS$gO`a*U^ik!iF{IY#uLBp#%p@>^nhxQKQCoX zBYLsI^Fi>IqeT9mIH$(vw5Su(!#i_x>GZMJ5qkyqQkK@A%@Zx=I7EYfg&f8s@9tgNYZxG+C}g;*1=zt zEj9C;QB&EgsW<%pejAaAJJXa}diB0z^-_V{U0~gCHrdK0`jb@GQJ{^<(#xkWvuU?& z@aX||^JCAWY`Y5Wj*osMJ`l07CBc}Y9BKd3uWM3?;{VG$xni0t91X{bzE@-=c~#4u zgxJ*|`?RXrlwD42dAt{wop`U$Tx5KFRNdf|>EFH2KU8@W(9%9njk$Dg^Ts+B3tjGD;6LMKA6+l|SGyMdqD%syZOneTXPQV^6+9^`T<=v1uTa*HDxm-G z_%x%jPl(=yci?tH9hEnWRldL<8vFmMTGl;++0{xiDm?Y#Vs=bk2FsuIq@@W0CcN|)BAA!-RcJ*QXZw?Z|q>ikZn|y3`>upb- z)pkIKbVqC7fbP}<@><}cYut;Ihyl?x@%V{xg(|qC&Lxx3*LJt;D0r@ISTef6p{Z!V=`# z+T?~7B6lIg=KV!V=0Hc|L%VdVOUYbPpR)qZekEwB#W%p)qtGX#Q5R{XmfA9lg{QE& zVHjE{&0mk}(L|W%mp}C*=0AUvN&(KgR8%=G=Qsj44>ul^{?YvV-92ODu7|o;gKYO# zKe%YbWy$mnQ1OY-WH>-(5}pVzky$3P2sfkGKf3x~JG?Oxo*-E6Vx^fjvyiq^Fy7(a zhU-Ose$FLqC-$Tjp1}Z=^S`M^@ol#7rF!^ETG2AcwwPGPJmqaGCC>q~YfJbR%0V^L9tS z!^by8Enn$Qi}h>-&N|5o?p_ah$o;pjAk7{??DAedTIsO-BIB`B$;S%^D&k~b&9!8o z?nvz=FaFcaT4&A&+H-og6)0;aGzF3sq((@Yhs6lF@)9frD|dcrJKzHwWuMpI#QM2{ zLX=nNcKjz>y&gWRKC2`z$XD&tgoOS&am8N+yFJP5wQ@#soSOzO1N3Dnhioj~>#kZRAt>iP#dH;4EXk8}R{wkh&wCmzbN0M`qdw!yp zxWE)Wc6XM)o-YiTzS=S9mow9r`e|rP<P3uI;J(`#mmmhYx?g=afj3O9kAvWAbbG<+v`G zb(ZgrF1$Y?afkBsR#m$zbml1|`|tKpo#{gsV7lEm*2t-V(J{+We$T>NadsKeXMHM< z8hv|NnVuV?4xxky(?R3tR)5<2Wu^=jengb+!jiM)q22u`bh*hgGF1F(y}{c#N%bk! z0FNry9!l{YvZl#FiVf1MU(vy{`U-FK5){Tz005Gnfo= zqTC9m8e_%+?}w+qx)sfhLwqC1D#?vssD9|-3!c2=tc2@qzSw@}_^h>-y-W=sul&Z# z^+P0Q<6YR2yNnmuATB&jrZ;s3|$^TMs`*nh86;0m9 z_WszHMdkHlqA}UB7}mJ*LLwkX_fAJ;YWZfkw=cvEDDVf;pxik{Uwos~7_vt-c-p7) zPMe;+9+CU7Kk;Ff9Bg50UY?jRMBk!T7<`7P8(^h*9MCj0dJ(O~^H)ay)YbA6bd-Cl7Ufl}}~RNjwAg zm*+err-1tPwu6ZBpWXhf?jPpq{1W>wqf5k8{y%HOcagL0z}Lt?1vxPXsnw znfFy)1|t6%#j6yT z+lMW$>G@}Vp|>>svatV9n5#!2g`U)TPO~)+@NI{5q&wx~OFIJn*%(`-&1win@9%@R z8HjJ(ulH71hA*B#1GlS(yer9&JJyVDIc-R{_F^xoIl2vA~q~J*T@-{7k zcR20o*+|TdmIb<^rw6$?uEiYbFQ^k;Mw7!5o@***iAnwE(@4kX@y7ZGTrG(zC_ZBn zxT6Dm_D_F6#y6Ca&)CQzfJf@V$iM3g+gg{ciZ|EY?Q;|VW*nycV_}`A@Y9KTB}zN& z9V4IZ6`@}n`6@EdKA)ZF)%rh{}}j^HM;)6$Jx z=4C3_nVpw_!w7uw;p`7+n_KNv)gva!;O4p)n zD*NA03b91*o;7NmEA!@lmDpJey=%#3`Si@cn3hhGZWlVk5yLrgL*FnHlWWtGlMEz$ zVJi90(Lr9ojjHjd_}RmFVeaDt@VH78=B-!!2R^shS4rh?8!IbowkL{r*CD?27`yX{ zO3U;>%7Dn_=FU;Q!mf!PuG>#z!W3HZ5BHzswi{*eo#3Tt)5g<{q#ECHUMQk*&&0Lv z3kkd;h&51j&!guaRQ$Kj;OhKjrTjinl6HCf)74wGD>?(V+m9X^Od62#Z_==Psu@*Z zi(&Ip{l37rrPw)NQM@X$%v}C8TF#TPHxa6|w`}-^PNG5KUtccjL+&4cOtbDCMcHWX z3)M6RHGHg~tg_GWukWI4yK+_TD+YS)(q-N^Y-H;U8j>#)Zu4$?e)*eg=@4uG2WZ+A z(<|DlYI}VJT|ri>d6YwiyZfO)Myg0~1%G+8nVe_fE`@mqxx7Tr4SVg;RM9vBrG%HLqM{cMPIVEZKon%zJVvTRIV^UgUx>oPrd^L&ID^GU!2Heg6 zt|qd4IIT05wFt`l&V3%UtlPDo4gf>g<)M2!Hw9acB$Ro+5 z6Jo@fj1VbRJzQZD!J`7Ainahd4Kc3#7i-Eb!a2Q1_)ICrEE5TmBFP*f92~-g++eK zSCl~^jA1^=?0PG9`USGB4A9)ssx+B0Zjpu&dBpa zrIyyYz}-J41_jY(NJBPCH-}dvHU`u>rT%eCQ`Ihsa#j`&VkpMvd*V-V#s#~_{bj{@ zvrN8fF}gAKGycgBsjI69d=S_Jk{P)F8?=KwvyZpmvbqQ}yTnCOhBnt)#6^Cu- z3TZjxu3)qO*_)ZJ|4I?rzVrnGTRfgW+-Dooexb=z=(NDW(mpsYSM1F!722oz59Teb z6W`P&->R@=R$;k*+9pQ(we-(o08Fp1cQ^IX6Le4Ve!=_<$;LbA-=^H&$bUx#WXsd_ zL`sQ&cgG*?^AYx;gAaf+buqp@5iG>yP8emwTxnL}Q&pOz8%lc0nNjubbr+SBUv#GI z9g^-J(mqtaSbcM9!5UNVn(O{wQhb+y@UvI^F`*kY6~ZgKyqJd;O9y}Q@BApV(l`e6nPdYEc~W*Rm;2zpkF_LBjV>pueius zD_X@;ut8nMTsGq^e>5V3W#lnb8_9ck#l!ymiob61cDA}~PuE<}{9IHN_rv0h{iLWr zC=H9<#|P$Za=_R$&|T|!m7Q7X*0g(m3ysU?YHZT9Ib5FVyis3e7a+t>ZOnOY5o^^6%ldMw)aA4E(2iJ*c%||PQ)h9HrMj{BOYSC7}2iXZ`;=W^rD*NGOsO}#x}Y! zXj<~yqECL^zymS^h4;>r?l&Gh*x=6Lc3)X)RA145I()5htwCjm(Vk~zkCOj|cgRCHJ%c>&vAMJGAGdmHA#njl)%BmgdUd)C4V7S-_|Crc)miu z{pgA(Y|ACZQmUcPVq<-v`!i4@oFCCS!mm_-xy!D*>YT-Bwh!)%s^P+@wAc1xV#+M~tbiXzn? zJZhXLORbO}?YWM_s)rKq1u|K}>r1cjhQb&-0v=2Q<8ObjsJU5X@{V5w7qyy7)7!-z z<{h+#Ii7hB8}D*_`{ndWRk72EY8i59F8MxE>%HF@!LqZl+HNAw02;z8z_hET_?ExW zfFAs@ymRDniQI>g28X^3401@-5mocXdU92b2pRF`^nW>xvpqYxFUU{Mx*)(qY+pM* z??OicWjoIYn5Sa)boWJA+DTH8cx&D^jqYTbSR5Y_B1n`Oh?~YW%bW~9ILbPH%(Q2Y zzn7DF&vv65jkDi8kDHn%eNx_oaiHC5PJN>IiID1JWr;j+r77a8TL@EmnU$M}_&%1g z#@1=l4F(aF4M(iS;d$W4zQ2QsKaxFv78Fu;l|ra?W$v9P=l5_}BjyBv{cjbkfG?-x`r!lPSxp01={R z7+Y|?5;OAVS_b(YGQM+yu0{zDmrAbd`cp-CbLXpubQF?>Z-pKvM})GUyHzqQh8uBX z=R>D)tFw)?{J%7CH?8iy1Fc*~5-VPJ!g9z$EmY!>7@XqRFgqST>0AvRtRnOdO$JOC zR~0p%SsgPA5h2!-p+~)y7;q@re&EsF^QO;%GqmfVb$-Y!iAqAy*A(I8 za3rS8w%l;Ofe2%(dT{DO8tadf*L8Pbvg-tJU4yP;{4$DMr- z*(KiDdtbjC-5^3m!&zQ6Ib+8*&8qGnWz`lvx0k`gIz72v=}8NY4yn`BQ_0Oa7+vL5=@47_Y+r_2Cj8$Kav(zbL7)I z%Sz^Ncts_dKTQJM@nPtTSftrb%~Y+(H0gAP>#=v6hQ5vO?y)2u7Ge$ltKSK=|1EYl zYzM+bbB~1;?ewSNgGUrZXk1oaUd=SA(BP0Z5eqEq z-Fh7!ku{B*L*9aK3KJpHOEcVIm=W>brj}?V<~PoYe`}f)c>XnnH4JHXbh@DsM&Jsz z{C7l8&PtsA)#s0gJ!$l;rb88Y+*032K*qP9zcSXWBseY2dP;$d`iHmy;2x|mp5(-| zq4mR_8WVYlkXvbu<6#)5IT8@p1_DA22eNc_8b^EmqZu0-XR`A1{VgIizc?a|77K&! zeOFzAo8B+R3n7?sCx##G@UYqb{RmnV%#5rhumpP~iE(8^i#|K35nF;U*EdYJI$>*E zgpWg5h|ocr!y)@l4N;tP8Ost3LF8GVbVL>0<0v&d%2JSx#a;kiXty=pwFyoH_PBK2 zlxT*BZ&oyZ^mfL&`26k?r6y;=4{vpSp2kgohnlFzAWdHxoV8q^#_{qVb5w^S6K0a5 zcD3ADJ zCEg@LUpKwa$ebp{73B!r?m$N(PmM*F;LlPcs93;YnbnmdFcKjsVQGL>BQkiuS7Hg) z=))VHT}jwbX@ZUMJ|U_Ia^KjM<=W9WAh4C71Htx9zNACx24S3& zb|6;$#lnb6LPN@d%*P!lc+%934lC4tZuxcxYGL+Q)72SOb5TaVvIOh2{dol5|5hOP z1BqcH^BUH;4S|t%TADf}f=G}HUF8Cg9Sy#!KmUz(Hlby`~K8xeR=skG6$i_@rKMa$HFrC#s z%Cf$&yf|<|jU7Zk0WE>%AaKxP3xa-(M(jWZW;+k#st8NIz+Mmdd<2qKVF`9c{^JD> zrWixC6GaS_81M-#!R?!aA3iwB5jaehrNt`v97IBw;HiG>hQ?KxH!qT!OpdYyYzXSK zC?PQ?M-V4HnPTp>lf)8J9YhfcI$7?lOYl*a-?AKNedL)p=w{{Z>;9mdKS4Y}uZ><7 zo&xO;TeyBgixq;)ilKI(YMO8lI_y6Dyj*Ds{-oCJJ_xsW0?z@B;)U-|K?Fox^wt}@ zpcLlTcny#E8;ySRwv%|-*TCsJ3COg?tv}PGP61A3QG{vZ5}QpsZovJDIq0f@g(VQM z`5Uf>@)4my38N|%Aa3_?j^~9Vfdtv?Zz4-@%kz6xY#PP>7c}?4%*2*$`WFl?&Cty< zwd1m2MDE)NGb^nQ2ow)z?|onct0cTB$u1B@V7!OsyTdRx$Gg56I}kMvYy%xCCD6St zatG2&=4WO@>l+Rh$zCGo*jEe%wv(o@Rn{U1v%M_VNLeBzuULBFD&UApF+oQ3agwuW z9;<*bHs+^plC=XJ-0G8rOp^vIBkr@KMRgA5?AuA+@pqDvm$Nt`XPCb$5h1G^89HEu z{1coKK`?KP&pa^3!~IPey|C@*;-~4ou{+QQI+Ryyr%ASs$A0egDB}xixoK}_)JlnF zV;}`Ni~VFF!w|s3Ci9OC1)Q)ekda$O?~p7i|I*>cU>?-ez5%TooYvaRK!i}K*u0=a zxn#qM6yVCG&m8^(cY0)XHsghdQ~$AD)S9jBOvhdu-2m=o#;2rj|Jeg{jIfRNzv;{0nA5+g_Mh}M|K z?WkEl3UEeQs9P)R9c6_uvlC45FndqF!`$C!{bd2Y$I3*gOsx`M7@dT~YyCxF<`{BIIfD#rEPp1+5f8KMKE`c3V^c6eci-(mOX)H)!IIz1$(RSQccLS& zW@vK#*1(O8JQi)o{h&ok2_c43Qrg-P(>O)};Stc!^99$Xz_Qn%gYhyu%5grQ#W_?G zX1HZ!!AvoX|LfU~Gck&*W!KPmb9EYFC1(kFSYS9S3F3iknI{}%evt#CVR~{7p_W7F z-8AWkY=-7d#86~sKZFLT!tC-k%(8_dhwNYUrh~BrDI$XTyzzxnaTfIduswzFpG{FvD6$IqU|z5ZnR|H4}dG!0I6$Ec9s-DV19ph#2Mn@)dyy$LI_M? zbci^JM|vOJX;CZUEE2GsVN7olD1Rf`RioM;XFG z&N(BMZi6)qXBq!mgb1PTB?Zx;R98GpDcdaANnrjEO>xtu^e0 zO%E42XGp&R*I7jnN7N;sFp+t;?+~~_8lzJ`x?t^yQn1iVua6ecENMy21B=j7iVPnB zmexmvvA_r<3n_4oc?mB6G3z_Z1qD0m+ZY6E`_02Iic2uY+4KFEof>Y-T6uF%K?3sx zFLvUHUEu+zOMtZRWyI5WAQ$<-ro9n{Nm{0V1BpV$`|az{gSCfg2)Koar!7h!@WjL0 zIeqVeRgxeip?k!i6if9Y8|2^XmKJ~ATu`AmmaqK5iNxiCsLf_3qN>Hp^DK5F zAe%n~;b7tMmQzo>O3p#PXM~0kwtB-v=07Q>?gl*)ov3jd%}mbfkjfm1m57)d!*Yd{hGp@>#e__LqxF!ZDhZCHkS3KUwy*WKKIe^3jIwGYul7 z0R1KB!U-iLpoVUGk2H1CAHAl4hb>oM0XlzxY2~9WevW-FEc}zF@romM%%%93JLuPx zn%ma=%djLMzm^gt?j7T{79dHh%B+p0M?73iI@(ANwKgx~VZ879;y{3C`&lM)b(*Bk^Rmze7)^a&`%Y1y zoirDtqMjRu!~jeoHOhSCyoSQ1s5?YR6{pTQyb?20*Yam93^}w31u6a*-`W}skDab0 z2ySryz0-z{6i>hzY7n8ftK)qkAnjgIFc@V+w$EqLzG`71XLW3tX8I5O@QyT3pLn;H?qgh*y?X_u)5XsLo2_#3*r0H~SVz>pXR_H( zDsmR{{M(D8N=#`AH~me7sn}uh_4F!&x$v9GC%@48KQ~MEH1P13oBW+AbQk9KXDKz( zZvo^`a@A!H2oZvGc)3A`QmApYtqVt*F3$UXRK>$z-7*J$Mxm zbo3<#JV049P^BXtiyV5Hd(5~53v3TIZ2_tFhP4yh565i zrvt1h>FH&b`7_LfqF3EGpRZh_(A%g;)4X)!t!GZfzwLBtJE#w)lnQ0bI5Sc zL8>C;wLV#Q~( z$2p16r{c4_pFuo(DZ2>@j)zMO7XP%UByffNiFUzFmY6tUyWn`()tVubxps|W$*Hqv zAa2XZS~7uz^=sgTI~5W7_i1?~9d@k6Z9Z)Wdj2#gofg$`L`(s-c?e*7f1ORk?OAT> z1qBhpcM_sC2@4i&LvQ-JJ# zFD5gMgPe6%o;r1ogZ~hFbW%ld%JmB}IpRl2*TKQ?uZkHP2CsF~_kRA}6J!P|4txu$ z&Zx1jSC|)I^Z@c?3uV@k>FT&?2!U!{I(4U~XQLk;@8aX7w&vznw> z&>R|(9TjI+mtggQnsuOw&IUdPDG{L?u1>DM!FJooP{0_NAQaO2tYEV)ILu#?2ss&X zS@EC7nQX2J#C2-m2uL708*F6Vz`CldMIjR!npT+FNl`laj3c?W0hgQA#*rRXXxmgDdPI%fwuE+hL4{BRtikW5YHmnh49 zB7lc&`#~`tVE4xW0}#GfVdON*l{mp-?`OreFNueT0LqcuZ`xpj;DiSUl}Z8|=lNre za4-(+`YQ<2xc@{ITW%tlRT{2=z7GjVoC4o6EUFglN1%bZ(}W$U^?Wy~%Mt71cK6E! z*d|*nO}pKWQ>}kY0{;-avgq~_>~Et3BiM>sKf!^@Y%a+e3i4N3&uEa%$Vud%YXL_& zr$#N#;Frd|_d$bhwRwQj*s^^1K1gPZ^PYjKna-hMtE7?;Eg2Pf?}&d%qm&#*c!$$G zq(xawWwzlXknu7PaNBfv80XYE{J|0L&@ffoH9XvBK)jh2Tay{Q5VixQ93`HDA;z3* z2*$_G>^sMH+_S{(3{eDN>e%|{#uBW2bE=cc1-qi^J_5GUzJ(f-FOzfR$TXB;gcpTP zcBV(Xy=_lr!Z1P3tgePfS<@N2E?|da8W{t&6z0=5?869xGxf?^NBqPUqIMXe;qd2I z5R-TrP64pxMiPw%Y4hqz%+qrmY(X-R9gX{OY68mJPlEsu!-_8Uc7}ldi=)0kvue1l zm$qD9f{An*UZ<(Tpg-$JlFZ)>1y$4$4; zq&tA!H5YtUZ@9M~_rbyyv{13-gmR6;n=#S(7sLCEvT$?pLBYi000C$O;2s^a+DabZKu zP!Yt?8e265D27P}M_@yM(zWG?v-$FwpQ6G|1P1dtkI@B`-r3&};QnUM%F01x+`SbG z3U-o&#g$GF(vS9@#Oy%n&0jwXBb2T^Gy$c`g`Wr33lQ9~yYWjY?jhIh(SoA9yhk%d z+6m@KUuN#da!PY^&l>6qUdt~sEG)IW^+GTxllwlT5(&{& z>QjaqfT$TNJsQE>zxwIwan`lEKj%XoI7O)@>}M9Ni{I_Ow}^yWy7#Ue=M1zLPprZ{ z1{fBSFb!SKUb-4M?Y5uCnmZ8K%kLdjJCNGX6`F!r1v@{_Fa(CQZx)bD0Ec00-Nx?k z_LJW1L7t*{KZ>BnxcB>$5vG}8Z-kGt_{+M1*;Tmz33}-k7B+Pk&U4J~xiv|>2bE^F z_gjUX+)%c?je_|;e@%0o<#P7jp%?ry@3&1s>`GwyF7I*9264b#?kMMVl~+RM5}f}6 z>K%hHH8V(OJI?C!fq`pse&azUW1>sEWJR(2y&uP-5GCTI~g5kQA_(;htl7m7@i*ItF2Y9`vEn6W8U?yI_B z8rS#A1?)j^bAtoDxNl`EE8tG^r~XArA`*t?>^i`G`AitfQ6J?be3+8xAzjHVCYN>K z7^wwFFC#JFH5N~uub^uD0Au%DK}5WT{<|g39q46f)!8aM`I-9bryV4NR};Xs2m-{l zamb%uqgZR{VeBPDylcsXBbZ_^>w|lmh@peGzxKdJ5H!I&)@28pZ}XASbqAWzFtGY+ z5$-Ir_B9z(np!6HbiDlAe?1kNIvS#a`A^EZG;npDDIzXMIj(EN&@Vpv&w5FP zpR+whu`9ne3*{M6W2fgK)5b?x4exF-FdbzDGItHG!bbnuH*EeQeG>i+35g`oIWjcq zphdH^D-77tZt4@(s+8pP>-M31kR3>crb7$tnyze<@W|}Y6aniih2Bp<#m;>`iAvRPcN)las3$7ujJAL;+0)AQ(+=saj z=#>&wAh|z`eFRR^@|34#tU!Izipej=Ni)NfX=1P{6oTjK5YCFLzsv^``1RS`2WS^K zFDx+%G?SOrdu%A}@~yv42hzT86eaudO@r|2WOx+eLn+HWoJ0kWL%tJEA_3N2f(;l6 zH5^H0y@9OsR+fl@k3{41q7JKV7W!{S7-RUS>$?BTe z2hcGdoDH-I6H*9gS2GScX-+|o>G>vJ@5CzIQZY#@deHF4>6VaE=SI$*7?Qou>~`*5VK!FKP){$xeFyl0$cKBb2! zaZFs93&S<^e;cGRz%_bRv7mK5$@(ZsNYgFWyYm7Kn-s@ee{I9hhAX|)YsVz2D3>4u z!2>nt+;zwxxn;nT73V2q0;E?46q<}4=>RA#v0&GOPW`???a64IzU^s=`sDyp#+DPK~hG8^6Mw{a51)lv6AY#u2UAv_j1QvT<}vx@}jGWutMkEW$pf2}E3 z60WJC-ELw{NUO3<5Oyb|9b`D}R4=DoRHbPN6rAY2yVKB;eY%prHe^J74(mDai0V)c;gJgm7~0pxaysjNQGC zdw9?S@A@E;iBOrxW9!v-;3HZXjhoVhG%cn>t0=UK?3)Er<~EFY`~|lm5%N&sxy3g! zNU)}$TpVqSje@z?mMI~v?Uc1d4=0_;au_&&97G)fE8>6OhEe7LuNnZzkyNYyJd)KB zug#RNtA5eJhf}aM&>fJ$?j5Hv2V*64O+B8HwJ0?@x^s%bM>5H{MAuv%q+}b!w__Ni z`@E`HAQBG-{*c3|j#Y!{~KC4K>M>Ol@&9n$*|aC`v*~gUl9m0L&)DzhrP}!)JMjw4?@NDT}>_EN`JYXVQ=T znIIUJg#5J_oCHx^kA+DG#^{~UWeGWQb#Hi==^kqJEAX3xo1w*KuqbNPk-)t1{xnMw z>~r=re^rptBZ|rF{71}2mJ3tHVBjUir73L>_ogIIO9>2}c-)Z6{pt>U3Phwr>2^!+ z<#2fEDoz^yjA02hvjsRb7DA5H7NcUQ1}CU(rmX%h=s}t>qL-v7s&=-1=Z7u9xi7!X z0bp*zB|aTR)WT^ofOdHa*U%ZnvPuvbTR2SS!7%<8Xv&5K+U1uw70}{~-O9VroCfVg zXz`^PIq3NnYJGE?3zRo;2t_(V%Iyxw`v#B**Ng>r;v{HlIo9LQE~3Tbd5Pb!Dh(+w zztXn!<`g(xgZN25sgN^f8D^IQoVO^pVfreZl#n2}HB6SE2E*)=7E|@q5KalB01Ik( zRC39oIjC(28LoJ2&7mLLn- zW!rVp9NB@_PXM>Sp(<;ZPu1TO(pJ#a=~Fmq+1nVCpCeAYYxQbirp~7uf;Hk8`X18MSA7^4&#_91d}?_CgU(RKVcstSJ?WQWcSvY}M)`KUnzWDYC0R@Ei{RsBGeU|-k#B21 zrpdz7!r?A*g5h^9{tgI#H8h7oW>V<>D!3mXp<`_P&>u_usCdsC3^N#5xbu)gY`*4y zyno906h)u(h`?B#CQ&XxNC{R{b&tVH==pd?z(-DZRP`UBVXhx6PEY|@m3fJc_b3_1Ycs@-J;dBiidQAb3GVpF|l7ee`MglaaY0IDD ze;MMWJ>IJyGX;zYsN|EeArFy~hHFm=DL|*j{r^+cCKm_D4b-7M!1`f_2ObsXK7Q+z zIU$v-;~h?VemsU6gp^Cm^YW13{cpCYYoEyby;fQTMoeK$Ic5GMGO}vV@dXJM*M9mshD!Zt_n2AIS7JE2^>&)<_3J z)Lpf0$bmFXE}!~8#_i&~)>*J(<&&82-mhDY;qd4UwA{c?Z*z9f8PgMnU1 z6vR`F@$unLiAqaL6FHGoP52-8PE+oezW>KaNFjSr*wBwz;3=$TM@{HBHl@Nf8zcHA zLAtoYD|odAdvbfkloQ$cdt^}+5*#Xx|Mw6cnfoOP0I~XUL8WFt9*4Qm_z!icYWt_0 ztOYX!8RIyRj_m*ZrVrD_shmLFiP?ozrAt#oa^XW^Uk@Y%w|(2!U^Rz1AwRGZ;u)4Q zEtoXbFXIe^G#@hhhBX(H`RZK;zmd>Iyc%es!^LJ)2NH{oe|wI=*uk27StJNUFRkt4 z0YB`Pk#wp;3nrQ!g#=T$bopdqYc57R#dj6aF7fj_Ev(2+L0T>O78@(gpdQdUkNt=w zK9DBHGF12D;UdNzJfIaL1T;Ye)kRoMvIbiyCQo=wNclNcf>?t+ifmOjy@|^Ff)bT! zQ5rB=Wj#&fDb_7nbEztIEr=NbRP-DElZPmI>n;-Xz`7OFg6%%M)KV57I37JqAE{I3 z_1P7QHQ32Hw+|bV3d`#42XX*J<#SL_E&Qkb7*FqpE08>0_YcOc!5p&q`=6o?tSLF;r3JZiS4)nE0f#|Sa@`$g->KKB!DR^+NHVL;$O!cWF@FB%&yku3S9#m4c=59!l1fnabOEnc{q zxd7}}T3Qv@uU)^kQaPN2SXBdm%t(0z&%9=f(uO9S=ajkk*qe9_=2}O}(~q}(zgNkM z6smVKeRawRSHE!73Jmv~u1fCxopRK^K}w3Rf7#_2c!r|d&uIP$*K|?O=%*zxhh9xcQ{f~! zex2#E;Uu6ZJ31h)CUqN&{WelQC{SV%jOB`ow_rncme^$e0YMRxDo^h|>QHzil;)Jt z(7%Zo^f0}33Vj%R?(2uMAi81L`JqRO>NGxS`34^e;&q3EW9k>2OX|cgyfQ)onvmS- z<7moLMwr+>A4p4V*zASTE;RXBj{l)5#}536PSX}7Y41rb!!|Sxp`d~ArS^~AhG3l3 zf?u7coS&pSZY;YzHrOQr-x^S?Tm{38=*%liti1@w|(l$(e2J4n#Qn%@?`!Qt> zs?@+OWaiY25k0t;cm@OY-{6r+LBsnjIBC`0#_@jq0#)?H*I;bDB=vzGZA&hj;r{be zM(xghGYdkBG<|B$E>7a`ro1R-6J*X(mmj*WX zk%w-Aa+VZu^6(x809*nm5v8IB61jI(T|jFexaaE9j!yx^Slsi1v7cTzeRlN6I$aoj zy}kt>HW}&U@dhg-8YalsTpUzCrM(Cq@oIXZh=fOl4tG^Og-0(7r?;`!Hkpc&>cvmpU7}-gCXW!X`X(JxakGL>P8Eu^mFcSR=DPSQDD`EkOnDs z6zf@riAyI`2DW2d)dl|wwqtnCW)wt-AvWDdl7aT%C^H$JF&)Bg-Z!iV=gW280FE>*=bM<67Pyz(;n zaTi6^eb^ie*KD2Hawa0A6?4;(f$Ndj-HDVw%yUM}C+mQbe7DIrG+>Z#Cb6F@V5DDh z)+rEcR<^y$iHdnl&)!VrkurZ_I-7%rxeqR-a3U?@+YZ;b0r>DB{t+|C(j#iFb)*7D zh=&m)3N5|kgQ^EK@DWmJ=|-@SvwUIXvB^kX4C0aAWg=f7mI+g!Kfb}o`cpmyJE)M)sa72<>2TK8idQ;Ig1pW1hw;6 zY7tIC)h>xT4y=QyN7DVonl&w1VZcBDkcxeO3m&Db(2_y}r`UM~x5G(jZj)5q1HH+k zAxz@3i@qfmm^ouwNHM;A-05FSznbqj-#OpgP=;{Vy%m0`I{rUdb zP$%q_85kKUu*y#agJBv!WB!7rn9-d<1iW zOR^-S1!rc6QK4NBG=Zjv!6RmghkWaPBa{`?Cm{hN%U?$jhhRD5R5ja}BN!gUk%oa$ zwFmdceJk@8xnivKwAYmV81_56gxQf6Qga=D!P-e-tN3trhef{~17_V2d`3Kx*~y zC%1v6^GmoC^Gvl!3zOg}t6BIP6r)yC`nI2^1SY~`>+{otB-Pr-Rl6^bM>;6?oNbC8 z%^oRX<^VFChA7pc=W8^qpM8c>8!RIGqAp|q(J$;rjqEL=lC*JfoSS;;mce-S@J` zM~1!LcPrMjv{C5>LH7$=n5R5+Vi%p=D!vF(Rsu%9Rn2VsdfcGQCOMh%zblPSSoho? z+q3N+OxPBYw8D>@T|AypW3-X#P`;9`#*M8LPixVYwuREwjm!So-CMa=$YO(8LH2)d zOIaqh#yi zj0c=oM?`hTky*mxDIpi{4;|x0rDW3EnXr6`Q2D{|-r)!2SsCHp2L)lDibHfqJrdVH z2pk-_UHo+T8FtS=%&YL9Q~Q>k^gh(O5Vv0vm3_caxX;8wS6-cAUoBq?5@5M=U%&7qSUl->}Ps-!8$&VrhnR>QgZVO&4TjTZi z@2`TmE5Lxk7#c z9T(0oI~l&;4+^@9pH#STwgykU6B9t8poV~e*4O?%*MU=45)NbgnuF-t-tS8-4?1a_ zao5f8Q5c)F!vn^5Yy6V_dGdFRFUVU&;$53(xEy$+LAsk0=xjy`>mqGjl^IeBUHheID|QCnl4Cd~2}@xBjaIJM80Ba(gyq&uIS zT%iwA)y4BH;?dLO1MhnWos~m+OzvqAG!ZU)} zpBE(_Oip*)QMcwv`U8w~tnNZlz;g~O^B{>FaqA(qKloV#Ot|sW9B0J`S*maMi>Q#J zPP_nPL!tH1OX<4;gvU(=rUP=v)oe6$-d+BFymv!R9$~B#{;}t zWo4lZ}Qy>;Ge@2^F`&N(|_TzSp*@yCEfO&s>8&GZGKW^8?SjXX9+zYw0@Qg&L|oq#J(*bMc7Ht|k=XGBmr94zHm0 z*XyU0Lgzd@v`+2xbc(C*GjDF-T5LV9R!D`~+x4^kguZTQKH&QgLZn-6X%XWTyvZ=K z`nJ1-`k5Jr)#Iz&Wi~5ufad$;l#u<42a57r>wyWij{mXt+mB>E@nk`qO~B{biH_g0 z>r#B6VGW}2_%0s`e_T+*7N^I1kCFwkr`13i#pJHseLAx7alSHPvRlIjoqdo}sl)5I zduI6MWT5f&q@*!V>puLycPVyDJ5*16h8l^Xz#sXIK=Y4f0Zx8U+ zCPea8kg2P@jk_aBtW)+Osg%PyU8mkcuwb>^fJ~!}KzKkw9ja|I0HI$n{ zliIYu?GGDn{GPcVq+PMY6P5WDTOOoZul-of&6@nV`hjf27)gPzPrhxk?#z!#EKk;^ zx%cm~ktagAhJnt9alq=@@$0lk6iM0IJv{Pcy*@7@t@+eIm5kN?!JF>g@1v=dR?aq# zyzXvQn@RsZwHcFf*3+B5bJ|=yu`?Zh;97M)|Iz63+3v?5ODx{vESh#D%}xu+zOnD$ z(GMguXRz-eDUDIPI81_eZOR{Wr|RWx-R4AcSKaNctsULsJ|*CrMj6cFY5b0XuC@k` zoC|DLBM<8nP}iI06eLw7Zzv6|*G;jP`$sbV&#%?)?b-6j{q3{_al_Gr?86Ouc(v|_ zHswqb(iR`#zRKp?oHO^T#Gxe}b9xs@o$mPMi@eSSnkDJPQFzYawJOmFLOAv!?@746 z4u569uiDj!(`I014QXv2ovqebs<9rj#&{V)VMH^>%*3>n1Vz1UjXgcjMW2t&)(sjAzA@a)<=Q8M2_}cL=v)B4}8g#S$ zA%CtEgMi4iq4}8jjaqR`9+9fpZ^i4O0fy~lt*~6}>!&9q@&XK>qMxgGa{h!t^PVTH z_K-<%vUl=O$`qJg9gMJiL3!^g)>N@@4B(qCIEw*4iu*Ot$8)-Yno2Ji#WDCNjqH%d zvmxP!&(v$LC%$rZ*sW$`okiWzdH$7r*`m6M50?=q@)eAZ~kX@327}zH)^($ z8Ug!Vs|=1s$olU(%Or90c#1*Gj{|*w1d4IOP1$johl{K|Q#>3jB=xV#4zoM47s0Ot zC|MfqX!L_kx#(5we>li*w#+t;cu8;4KlK6lPWQDZJ^fuUbEF#23l%nZXbcIk9P0sU zb=uXugR#0KW3AcuJI%$Ub5E8iwp)-krMD7_=tUya& z4n>d4>nx8>N;n$IA3&0w;H6Mj`kFu8jasA1%j^ASoV<^Puv{Z~cK#~-$GtU`O>k^Z@>-r8i zaoCR}+si^LrWv*@QKXEjHLUjSG7&9!AE;rZ$DF%H_Y{Bby^*EE%U6@O=w<+d0;m^4 zesi00J{I{pP?~96|lobLd{3Vlr6+4kMf=4{riINz<(mFV?0k7nY z3;S;TwO79E!&3EIesqwux3!U_6s!8*=;B8a41T|A&YF1I6uEE3#^=~K!SmTv3s!DA z>_%)2y-M?!(_@wXEadXC(1mOSxEc6$VTX%rJ0>BFBxi();RnC0=7I-G6x}Z~?QZ!Y?E+C|DHG4mjqPNkogDT58^JS=+U#bnKRO$UeZ4RvRT)ll-nw#SFhp4gtJd=J7XdzO3w9$uVLNks>zmIKSy zg&qZa%7W$#>v3P${~mA+zePLW8`!8w%dib%b>lqyO-nOI2p)CoRnlEo{<`~`pG8iD zwI@Z2Jg44#z{h!CY2vM=D~{~?PmUUUM#JitQrlvk za|QQXvUtTW1K23SapkErdIepY7Ohuo#|tvCE&T7`hfaB%ljY5>`6NP3)CL7>LHK3w zBMf8D$E?{IfzjxlNYln>4@TN>Spn&RR<^BoW$oi~|1t_5viH`iD~vuN7zedH$5xQq zEx5jJzVv>$J<$9i8o>{celdhqtUEgs!y`>O^;@66PM2Kq0bbtV2OtrhQA@qejnW!+ zcIzt@D3&daVylnlZ}@UPB8fP3qvBgMNfjSQYCBL8`MgR&B2FP4Lr0{x`2$FCZ>6VOe4%LQiFrTToy1Jn>Ik`O+Tx zyJ#B4%#h)2$THkDluL|(>x@>P?9)#i%G1F&f_7bB&eZxYjCwit=3qdT>S^DLb%lze zLpe*B{OiMzJdqZlQ(rCOyHuB6!iam8@FaS!nO$}0Uw7ScgvT$eJP$|E3#+38N7hrM{MPG%doktT`-IMh6lEnzjLYM< z>=tK&*1dz%qSA_cPnbfPJ}+y&ytMF_d;gTz^ExON7EIWA`M1<(*Tje|P5iHe_u<#u zQh12O0Bo^ikLKL!R3v#nG(@pdZNX1EDQ2?f87J$l^&gKIE^+xMi$RWZJJBO=x@ybL zjD+hFkS0Ryz!M+=Gr$z)(IaU{KCOo6ll`T&{OZ{1i?W7l?!k}uv_GBRi|*8Hy)I?7 z<6qN<$nPvmHyC2<_V*<3G5S-F;O@o0Sb7!yC2{k20+&9nJ=2TGabbv82^vxB_E`+m zxl__|?rM2|KpFS$Pz>K*!k1Z_VR)-OIozEw)uS^k5SVEuGz$A#B=4US)5`BTo^kFE z-1=lW5UMT%ed=`QgkBCB`spFH;mm}rn#pPF2>8@5{0+GbwA>0=?|J)-*nbRi(_oWR zP4TSLWmIz;P9gSp^sHaAH-c`HGt7Qh&f_;SF9K$gpL3N0t?X&)R|Mx4{-^f3@SLcUo(95pp72|2sn)(#9$vSe-^5;92 ze@QL_LSWTi6h|@1^K*=X>BzF_>BlkG6PgcbDe|jjp!<#*V$S}E3R^}N%-zeZA7rUW ze}pUsSO1&hOeLsv-uKNW=h+LB^PzO)+oNA<0QGNV)#5pDx#nPZ{%aLDQ}Jewe!at4 z%&6)kSA{qzIkD>o&WP9h)V?B*KVr`#Od}{HaYKDt#`pTIobS@|A>u&U7mmzULVJtTN@`&Qf?V| zP4j_&8KcFc5atZF^M{mYDyhFQm%!~RM8z?FR_Z8b<$8xRTiIZN?2NdymLan_n~@-f z>a_G@4%X$@d6FOt<${*ICBI}p%IjXx0y{s1*u?5;%JYgo{0mN)*2M?)QB8Y~z2tS1 zsdncF*8WeCWX^Q0S|3 z^$*bfgzDGVTbz0a9Dw_EEi%tF(6A-zm`Z5BdJF4k!qBCQic^u=y z^qw;vIqCd9?w`T1-29T&yyHrBW-!XU3mVM~EW;&kt&WN$lt<*Vil8aCO@cXADfu{Ff2S-niVsXwaV|0c!$R*SPCA+Y%aj7OREs$r%H8u&`ZnF-F9Gwf0MH& zm+HNGI`VnTe9Ryy8gOrqmPfgY$|&BH}h_b#)fV`J2VrZxX^Tdr(4J`1KvrF5n2)N zrkEa4Tn2nxgNA^urb|1}ob^wIn-_t;$Hf}g=Dx|9wV{1m0yLV&a47w6WGth}PqLh2 zDtyg>5cm*Q&`yz#d|<=J;{v*Gx(AzqGElExcg`95vrr%{u>ZRQ=ryhxRnA5=Z(Wxn zaU!+Vpr7~Rl*t{vbJ>MpH2M=|wLdo-`WuLhA4Mf^tgHQV{j-MnNk>;H`7E=HzUGrrG0ju9)3lTAm8 zpZQz>M&y_BVuwo&H;!TuimAOKqnZzb^c^S8`lrY2Y`%PeZtecY1R?~_mSGK&M^yd= z6cyk&-;tM7e2{@^U2wj&t^4gic=n@L9Bh2N*@^ZnbY#M4f3OO{`e<6>-X(hh-X&e= zh$@I_Fc0*!ACZ>(500oZ@01oNjcQt-zX4je<)D-e)7_i*FT2Db?wg>%1gm<3WOq0@ zoLzZFH5;;C&@lW)GM+tWY`Jl{_UB8yHt-wyFqfzVTnN(Nz2HT?h8j#reD(qj4{4n^ zoqi1((EhP%!t!ByhJt|Pjms>p9ncSNc4&~_-sBv`FWP`_oE~NbJ8RvHdk-uzH~lV- zBF#`snJ7v6co5WTt#kIdE_TaNyD|P1>n@)%3HGhRWU1u)TCT+ZSYIC`<&fbb7v?=X zU*BY;$!!(7;-al+cJHv<^%J#wEEK;p&-txdNPU~7l-{4V*mYO(u5`7Fa`kdO9|vQR zsF&p{GwPj?Qv)v{`Df6Q7PECA+@67GI!B|?ydw0=AXVDKBJqm=JVoimhCFaCLWI zfOIUsxQKz5PBr@T)lq4&EF>|@-L+Lw^{L(B;X8D;EQy^oH_R6)c5e`<7k97IjmsFJ zvTB0TJ$kDzi_7~L%i{e<>uW&AY)A$F+*p4+6+ z>K-P;ReMf%^d~*}C<~|uM(O;#sMntR_h^KeOZI=o8{TpzRA9zbq8Np#>b*+`{v%3a zn%X_SxFcoiy*Yu6eh9zu??AfzNw@)BB&l>{WOp$s;%CJxE&c4EEm=e%HAlflm%E^x zDd!zG@36&(0!|if-NQ5|;F*$#O*h|Jn(wwWaffa{mVLnMCoCYs4O~$;9`ZIF$@Hn5 zhH_m%)aBgG;iJbGD4g_N+mTy)ekTL(%l)l^rz#Gdn-UQN?u{ugy>>?0kQ}uFZrg<= zi=09__MSCTvNJ?lCN?_A^7OXzK;EW+A(FVT$QRkxb`{-sK14yLWD%DIX>Eb4(tB{u&HHL-@~Sc$?mlFuvXq_qV&q8 z8*BdPn-8(J(eHi`{f6Lzy}D#CiW_&0x7_j#owr#m4R7DcNpQ>@`5YRy3EOpC^u@@W z-bs~Pk&usl5MOWa()J-MNIV5|A8FWNGt=q5Z0?nw?gF$i-3@iB$W2~87B|k(S<;Yo z6HV|oK?!tQey*gLs2Q$v^>b~A?Y*fTJUa)#`d9rl9~d*#bhvb1&-#94_-s_RUw0e{ z<4Zi-ewzjV#ui!s#CFt@7$d}1bIT&S_U#h4h3t-=V^%(tkNMMmOo+hs0|>Oj4->1F zv1v#Ip9Ivg1HP8xSPKg(VTpf!Ge*@Cm)U=oFH??ftXiqKsdp=&QriI`bQ{qZS%!If z-$b_T93Gx*KfwL+z5(Bwtv;+$V&}e(%CR$y_1%7H+7r#Z>8lvk`&c@58NS?fv8)Dk zoi7UEeJh^29#SNIKJ!+NtTgZ-7~KjxH7{2Ux&s)Uee6oJ;=2jBPivaBAcG9Ar6ln} zDPb6AQ*XO9J#(S6weI9#mgR^9Ccz1O1rF00@YP&}tsz04-`Py)C_YI0`W-}ZxreI~ z?cbeVCsJ(ZjqzsXo{v}V^=ZCY&HQ6A9Ob5ZsOlKsj*77f^#gTYJcqF7d z9r(plZm;D0HNd3qeXthC3e#l=!D*VjKZ%eS%hjD(W!*Y?)TDnj=Ows2Tc|H}u&q-m z*iW=C81gGYnh2}5x~zVEO9(zhAs-!pd;;~7e{jle^8QIQR zhu%z*2A;ig#A$~qaK)X#tmamt+YqOHhCuD_`CZ9t7`rkhan@bed#Yy^srEwN`+PP{ z0Z~T0!gWE)>z%AZn14S=Ff6_lT#6xI8>gkNm8hs%fAp>E;f%~1YtDc3N!ggZb0-KJ zb?HP+jGPtUea+jG%xMW^ zS2N;O_U=a9)efSsK8Be`|GS7;1H@aw(Oaeac=wi8u9pNTYr1`$7A<)b%+ZW(YFi{`=s{ZJ7Yz4Qy?jgT z5sF3&L6MIK^E>m(^K&bJ%CpbnkM<0{UI|k9DYrtepFDC7V$PiVq)r<_I=wmSKBcVI z;*)pi5x|zS;9#Eiu_0dPxI)WadpmkMTWUkjbTRr{*Gm4IFPmP#tBWV1 z?Or!O&kGEa;k9I3YPZKY6+Dmlcb>_ev0hw;D_H^MLK{BEQd@@V0GWf7Wq)enkMAmj zG1ATBp?!S$@Jwq(i5xoy??B5_i%9K(rAVREkd+=!uBtN#->dU%1Dq;r8qiTM4QxcAubH`TBAlM{(JPHZwvR9eoq|GYNZCd|H-CmVJfREUhGWh*Did{;cl zOQ;v|v~oP7@r4Ut17VQg_x`IGh*>oCXm`2rOB*Y69IkuLvprYc>QNTtahcNilb3^r zy>)i4Qcht;L5K<}2NjaMiZ0n;9Y@5>3skb0Xhw-`sGn+hvPTHTbAD%_)ubzFNb`{Y z5EE&*CppVDzaK1t7m6Ll?=(b9COMd|WX`UL?M9HE-GZnK0^%Pl=JY2z=;(^Jnm#n0 zrA1V)^8su8}J8FfEog(BacI&3x)P7}i9)AAIHq`fxQM7`En?OkI zm7b%}>g@V+N@}kqbA=W=byni}nBgoY&;FS9&*}bVob0vZGdGWs*^EqTiVb-y^hM6l zbf7*?E^E&6CZHGnAES-ajy{?i$NOdEu)lzm*M{l#$)kAUyra(FHRCmE?D(_SGJ5>3 zyFUl5U;Lv?d{ef@kyaOFu}5Lo^Ug7&+L`;W3dUFGUh>=oOCX!Gxson3?&a98YtfSG zd#ZoCqTL!RwN`$pJi%T{{ZaWvmR4fhS(27Bs204%iIv%z-f0H%|_z(dUcOqxq7lvIekrag*IW5Sbk zVS6in>|5kLvgq#zi0)&hw%~KiS%=VD*s{~2uloK#?_{@gj^nMR%fBx@*Xww5xI^q5 zMXEY<1{3S=5m_~b@!zNU#`0;`-Yol+a$gCpDoW5=w8)`#Lo3Nk1kb-5ic*x|AopjX z{0#g#nYhS1-g6Mbu_?6ct$4NHO8oLOf0>;SJz(+z;`ZzduC&|bQ_8I}&I{LiVd$%J ztpSP)KzaR5lY-Dtl&9xHaa&Y~+_2JNd(?J8ZS1Tci`I3lI^Q=I6>rO=8h@63_Xkrx zM9_?sl7_`-%VI^yAF{s#Wlg;-ccdU_y_wT-6eEoF@f*M_ zECXux=H22qluGU?3MI5f>Ad1_wEf0XK0U^;cN0qT-7>sM^)OTHQR#eJ)Q1t5-HN+V zU?p4sO%gbN^Q5~q$>Qk-@#=q*&`NZ3s-YR+&%BG|PJ2|IOOwAfTB(TJM^F{5RD7?c zRnwoPnttfQlN7=3QFc{(e<R;L9`wN`ZoTuXiLDwi#dH4=P~xr&`DW^Hc(!K)GgFrF}-D!NkJHE=F%H`Aq=(i+LE~iW%VRn$hAj3&mmGwV34?Hg;iq2KVP5iV_@7Te}72-oAFj zJ|j>zujc&zj8? z#E@{}#}a)@TKy*=weEzdof&RME76~HPkMrLoO9aq9>+G$H{k1nR&u+>C}oRo?P;Tx zuAl5#Px-QZ`lKOsj${cnb+^3>WmT`irQC&Xrw(t=f~tKfx%wScS8Ywaoi9sthECws zHx^!n%j(x?C2km(JUt=$bBIbQI3H4z+0gNe5Z*E%mgPeEqh{iFGJ@98qrroxzgU_Z z*UiWglWu*l@WP;B-7XB5Lo3xRt?~!AN9j}NoY^AeBVw%hd|CRLB#i5*E|j~b(d?vz zG5;uv2}T3~%%CE-CT2#HBIFnORzVe;)5h~=fR-HA)iQdKm*Xe>D||x< zSw8vs7mE*re>k~&o?2>s@r{c-x2OV7K7v-&7ug{h9NUWhShPJZlX5U*%=H(GFNltL2ur2CcK$L{U=tUpDvhvM~yz9$i z9=TsE(tC?JG&v!zzqk-lZBfcEfN8+hkEQz_ej8Mh%~&7A9fUkQTADA}?hYeW&rk&k z?1<3Ad>1`9F6UgKlWO>Ngnr0Q#JKC)p~O{6`(4i~J;o2RSAHyXDL*8dfyMhuu(!`N zu+pJnL1c7t!Dy3+{MXCbne?;nDW$k_Kk+cL1Cb;3pY8OBI{9x|QTcIEjAtfBO1H3c z@h)F(MXxo^0Ht1cGsoRz@I#%xvmUvr7J;T5a7ZiU=rL*A?PM=MqwI=k1;^ugChq<` zQ&tsA)K?xznWAX@7>q?57?*^6u_fzv?#_>?V9|D}`nol-H+_R~Vk|fT(VPB+!fM$~ z!E?C8Ya6j8s(5=jA!jRK)r>y@zho;c|DZ#?(*)!4aQ$REG;jDp7Qrk+bz$~qaL{0= z$TlsT$!e6)#l7;`kL4V&{%4d-R?Z&)5!1ks#X*mMvoYna*SlrkW3CT!!WF7rRrr4f5YU&f-V|uc2;!#EPKQp4S zRla;r(P^~HKW}c1HDKPu=6Snx|IUF+;NYpPbH1wHf5rFrLj|d)oz^oc4_p(HBKR{l zlh++ujf1|3{E#EK-py%%`?&o3AihC`O|s_Jd`+yNG*~yd`c^6_!ycL=FpPl4o73%_$EhIFf zYJH5xZW`aO#7LjW!%-TWa&y7$t&s6yz0f-^MfDFgH%m7b#ZSjjMB3(m$^R-Ue2kN_ zYn5J5{m-R$W_AVmn)Pfo`l(C+>zVXn#_S;Je3nfEBG(`Gkd}`@iCq^}| z+JoOh?c?Kdfx?BQeKz`64t1IVg?u@Afw^VL@*Swsf`ZTe^!?I$>rzX^()JVoU>n&t zZ84!oY4LXfwaYrcKYyJc7H$w9{xn?=X)92xWtJuSX?9ivRPoa9SqTL9|A?WCi|KA? zOXH}-^ew z3K`6?O6Ik+e*+H9wi1QvDyD%0-=;?@@z82qqYowGf?O)Mt6$lN*g#1D@&eA;BbtN`bx?caLN z-@y#+ZHhm1;or+GbN5YJA&Rx3e$`8Ooeo9>+R(%6e^WGmt^am7+(*FY5*6Zc*bXmC zo&Z~HB#^j%d5VhVPCv}KrCNp+zsxLMU`RtI=GWso&EQ;MtJa>6VFgIdHi5e@un?XL zkIE`6lCf?#e;`w15hiw+=y6gN5v8B?+E8B*Qn?-RQ!=AMf`@ zVNXz1fA#irXyk*{e7P)eU2FCYi8vL+8(^S#n;-61UcBhb++~h6{)9{kb|ql9WPt-| zL;^nGHSu>$AR1G-$_lqV3B!~pS6?Qy!M*SFk)yVm0XUt}nkC(x3sK4>f8`WMqE?}| z)U#c&NTcdciT|80B7~1&kuBDkw3uOOcn$dAf0W`4J#Xl@W*!>`?~>E6UXrXWSRb|3w|LuDpf22=hhl7VFe6W$M)K7n++zo z!0wgffrD`Gc89mn-&7k+WK6hjeaMYV$)~$}yn&-ywW~sdp`Tn%+u*v^La! ze*uw#)%$bPZ($1Q&XEUO;au18NJ!?}AWU9q_|*gVsrrvjT`Z1EMk)&4QDr|}(5Od5 zza9zpDf{Td1?d>PJB@eezpe23mMBWosC|HluY#BNzJYstz9fNR<`A@VE8||-5elXV ze?Qip>W9X!IQICA#v-xxtvwdkppS@(e~H}S2Oi}f7*aHgK%o)59%ZR{IHPbeNs2cQ zkBn_%7ibDVv-6S<7ekXVg5ZVaXZgPYHJ&2pBGjY z;;6-~$@PBMQ}eO>yV54H@0Hlyj&0D`o2Azf1>cV z%N14O^~LDopx4frqI5)gfnH1Z!ue*s9H*jr36lP})^zEcA5I|+t}imyU|YInZ3V?> zq*z_NkFg3~U&8O2r3E|6=63w^2)c_~l}w6b72M-yHQvQr0{1h@41TPaQt>#a;}h3k z+1U0i7ZZ<)Keo7`N+sv2~`f@ml&<@_f7x9FMJ%^$0UGXD2`H}J^;Tk zm3D0S3H(CnUXVf5Eu@nK2Tc+#Rq5_+_MJ^w6CKLu9tE@`xYsi_yA~ay0M@ zQK#NW27bwqGKhT${6dkbw4?D$+Ae7!2G>M{Y1M>Y5ejw^+GrB3#BG=KRbdOB)}mnhs{iQsp4Qq{s#@#=c>Bfv3N+Z*1> zi(}sJGQBddE@IyJldiMRm9PrKZe{i>z%Nnvw!CNqewo>5k_7xxFqFP%0sKOAF75w9 z;}?!q9cADb(rk^XAdO#6&V`==e$j~M>y!Q;zdTq7?gM^le{jhxr14952r2-6Db;(F zpbY$Cd*%HudRyR^2e0Yh0>2deeY)TZ{6fSuTABgB5Lp8Zw}D^Y>hSH91AZx9WiqG& zeu?q3H=lve0hMVmO^e1aES1J_z%OJu`tE4p7vkRjpWVPOD*ZEDnZPevd&demY5XFa ze>EQX#fHVifA$RUOI;p|w=?idmo{VhW8fD7zVJ8$;1}aJXSj=jUtIQYd*KEA@>-ke zCG+-ZH0~zDa1Qu|=&N+fr}2vma}_u6i(B{k^g!Sj12ns9j>az<5z$*M{juT;X|4Cb zFT}3TeEPsIHh=HFoS^Z`@-D+@;FsyKnDTTQzf@ele;P#Nmr-<)(bE<2R&Kp{ANVCE z>61}8@JqDBH(N{K7u#y_n_a*!lv6QOY2X)Lv4@h+fnP?_uH5_#{2~|Yt|vm{mmCLS z1pM;j@)eUuG=6!nD{yD(AWreM^=|-vNf=*{!lrMJ0>AL~v)}jRJ%LoLCl0)fR>#qw>PTm` zN$}h*YQJX-=K&d~r%i!h3W9`98fg5|_Ufh+@C)HIkuyi*7ecLl3ize;sF~qw;1`0` z{Ph&@3qg@S_zCz$h22#g#mnQ;Q*y^X(fEZof6hJ%_=P&Z=T{K$3;FNXyNJdw1-yr& zfnQ<--*j@)_+>%&YxDp3#rCz%Sf|XH%7cUu54_owo#jS(P*0D-Zl4OR5oi z2KOY7Asp%UO1wd2V`oVfyOV47A}raDyUIt_Z0)+m&U)QEcZIi z@$$Ct4f}y#h*#>2ZZv*LQA+y-{8HNV?iB~{3vo6gPZ#)wa*xB+pT;lBoSHv8fL|QP z^WuPC2L4>$glPQ2ST2$a{8D$=|D-YS3la1oN)PyjoX`*~4E#bU9~UvUP(VcCe-&ka z;1`vyKlGm}VUMI%?{B^d{Gu1tpp~nM>$*=Ing6B>-v@{|f2dS~_Pxb2y7EOkV|lQ51Z0@+a^M@#)8x*T65@w(Dv%eknK+RggjBmk;|)8-QP^ zVQ-z&fnNkF`izo*UrOIRT8jsMe}QW+-L1ec|D>t>dB87q+ZMD3fM4P{1&G#xEQ9?RyRULV3D}odo}=S_NVLv7#}Vszmz6OCVfXEWmheo46d^6-W-DqeG`=JEi3nO)HTxeNFu@LE-{I`B)vhVAz0z%P7KT??MT zFDX|p+OPq?3{3Y2FTiuVU@TIL5%{Ip_+a=SRx&DW__bS;#xE2{e={!Nmyu709oXTX zU)?s*6<**MvP?wycHkGbf=|y?vPWb~FHhh4J`8=hb*BE?bKvwkjm5AOGTfs%`5|VH zFIKcn9;g4U0QdV_3i={!;9hsVOnx```KZp;{6-R@re9I!IOd9NUXL5Z!#U8fRLB9h zi9kH8Zt$#YXi~dyXz(qMHqyf(hd0+j2e>-`Yo3g?*r&EH}bwic( zxy$j@t~|j_^fg$6y);nz@I!3Co%AI7MFPIVQDDr)U5MUDa^8F7QGrBxR|bm}D$&Dr z*Hdw7MM!=%%b@sn74lKJ?m3)Xi_*hZzKMUTK-{^PUcGlHgzrgMAMTC_LNUSKtzl2| z!H*cf?(Hc;eu9QM~jF_*qb3*EnLEcdRqLeMuIf1YWYX80P7v)BBW z=+|TLDOJv*=Pybz!_$m1-=7V5`n*3^uS5%ex?fph``sFx{r$#DbGaY-eVOGA^=>2T zc%c41&;TP@7Oe-(y9?2Hn8VH|5pkHI`RRuy?reNEfBDV)*NJ$n>c8c)r-}!T4v?33 z)HQ;8bSl@;&I|CI6n>wWOFQR@D1X=Hh{){C{5Q>DPf`U!_@pSPv}1qyme62Cdf~sg zwUdGr3-_n&O_xDL%b_Z&g&(GTzjX6i;$2KJuT7H-f!9N<;`J>HxR>L&*>K>sBO1=$ z#UT8Xe}dL-Y9zcq>V=qN-o}OxTOmcu>S|Z{gLsWcL9dVA0^gX%61q&VPfU*vBo`k+ zOurLd2CAUXe44qTtnQ4cLR$U5YF+TDn7@qsWn=K#EVlll5rPMFj&QL*@k4yE6**S~ z5>V`x?(BtT3i>v1^hG9H6n2$2p5&E@z^{^*e>VI`3q(s2Mflkk1C&1ac4JIuB#OBs z>F}$~8MlU;ZBl}BePVe~&fu9fZk*VB;_KxIRCfCPYIS`s9x>joyEvGMMz#pdUG7Om z0wYPpr;Z$~^5VxMMz>TnRCz3JS`p4Oziifd;hzQf=RBBxk6WTmK{IERJF?K3#`)|Q ze{Yj;)c(EY%`?yoV_KVDD|=z8=7D2D{fYSMVAx&<778+7wXf+F3Po#2bTwbuhM=C_ zUC)mNh2q?bwocRg(08L!-T5{^SG6&pTYCien3nG^o?~-DtN*MW1{mzoiq1%%&WaV% zD3JP_o?(raz8(9$_~I72@@`t%m%|WIe{+@gW%cWzy21ksH`LCdwe^^m)81xyZHBzQ z&H~?WlcSnO>HEU>1TS(Qo412|xqsqTM4^WeHuaa(y@3a{KKwZDfeNyv?`*B3_4Khv zan|sCp??paHORyLTsghGHuDRplx*KpZWMw`CN>Gjl49_{IRozvJkZrxN}VnHf9x=M zry= zcNdj?@4Gy9zY5vt@TsfA_f4d8Ef$&#^O0FW`)=a{#fW==XEOM1E%HpuF(f#Ou@U#Z z&*}T>G1IR33}RmlUj525$>Ua!BmXsAfAypeH^!a1A(vBtTX&q<^trbPe-Ec@%Jkk? ziyMPGQfDgQ`zjJmwNJK%VD42H-l8KV`02OHRsFGd@g4c7={ME6$n&DaJK_!S`Qa-y z0qYv*^KbiGSH@$|g#4a1j==;JO6<7zKDq?aNfv&L8)!gT+BH6HaV^N=+;tAcoEpTo z-I-kR+!T8o82hq6tHtrme+9{gj~j8%NOI7>lsrsT+>o$6EE*-tsBXCQAOi{f;yc93 z3-{^+T&&H%nP5IYVFQXToXf~vpV6!Hg7g1=BT6SX+|Om$!*LAuM6S50ugeut+30u9 z)AnU*Ncziv_Jv`>pM$n9E>{1yFU}Fyp25Dv2xjM3|7Tx_9Xk*0f2ZwB+jPi%*cVF8 ziw(}OFTw+RzCMS2+3Y8?^8;;P@ZftB*caWs9(uHW*$+2zY5TIA{LT3;>`TJ>`v;ZK*cTP4qQCyIFZ0IMXL(^?J~M`!eni*j1(x#n6@vTPNY8AmzClVb#bsSb^o_7 z1o1Fmbvtcef5hI=!@fip<|sageIewc*L-1L1T5*q`Dyzy%=&XP>`Q6%p}sA!FD^y@ zZ(m9^$>%d@`_ip5SXY&+n1iv7cXI7gl{}_6@qhuP0QQ9>(ap39`x2b(<;(h? zed+C3da)Ju#bfl&O)c0LGqGP`w0)8J&MH|7`@+|h*TW6_vi32x`wQ%g>fp7Y=ddq} z2GIxOVP8~)quL+CzDPdJ>Q{w*QS>U^tO)zE6hPN84Exfu6n>=~_J!cC?EVG&Vxp5P ztql7ze|mQM%oyy8?R73zR@fK9(ORP&_GR(~Z`gC#m%0n8qby%7QAMXphYIY=xR_*U zH|z^v@j^%gZC|ilO&#oulrz8PJ=mAk&+DpgurE8>j}}(JzFd`2z{9XFeEDdR74~IE zbbY!3>`R^0k5?hIeG$$t8-RULjVfTUfPMMvfAe$h9_$O1PDH2?_GL*UM%@PXg?f9X z#i8dG`ssf$ypA1uh4SJkZC?mtD8BE?|8HNGe7V{eX!~N#cik2CMWx@UhKsf@g)SWD zPs6@YeoAbBeIeu~7KDW1UaH<$7!z$@zP?Y0g?*ta{cdag&%RKD4CP8-Uy7fz`p3h* zf0V|!d;a5&z~qpx0nW628B||<3j6Y7@0xNp?92a$sq>8I!hPSq6cw^UL{gH7k|G*T zv+R|Ty?3$+*?aH3_sk|5&SX?th)No0r}$P@S@+fN^?z_b>Phvf=zUz*c^$`bGSjU% z4HA8!iFnB2PW0t--G}cAL|-19dRO$7f9Om8!!O?d^kw@0^u_qaQ}HK6Uwk%l6@-Ys zY>!qD`=7pSI`4G#pT7LObFzf!3q?DVLj3=yFSXe2!$b6i;<(3AKB6xa?eY8X5`CeV zb2wT+^d;Dg{+$-l7Yd_LuUxL@fxu=P~XgmBq@`&h*Y2WY( zn*Zqw+-#uG0n=jc6NiYt1Y7!8e+dwM5qNTP=NqCgx=b?b$wXf&xE~+9PxOUnG4{e) zqA%V~SCzj#w8lH|$%=#M%k?k!1PqD3_VTI4@{3FZ_ICi+4_F*(-$gy>5~@5R$ZUz9R*?5PLIfBRJDUyE_n zL<;r*&FJIyp9&$qCwstBSl`_ z)g?aOoa&yJs(Pr;05_jA`J?Xowz*#<-=89wxcfYlEa(ZYhvi3wLxaF`8Q&=K-tpRN zvOL%y$Es`8a#H@~$>zW2e-x5;sC;{ezG8C!q||A8a@!J8Wlav{G^(L)Pna`nW*Cm` zxZc6sn~nVTweP-Ullj4850RX^f$$sc)D(m3!1$iq`5g7Tbz%n;`3pXFkrYt?iQgMdmUqzMDh0JA-k7{yfM1bd&(+kM4UzF?DTH zE$*N%>gsm{KRuF)_PLujK1@_WdV42*qfqi@zBNM1t2V}bc}uJa zPi|yO4#Q`?asJKKfBDEey!)m87jl2xLq9yCOU}VlX9IhcNd7@0i~YG~IGJ1Y*qXdk zLcz_S1pd&6VCQ~ZEb2Um^$U}?di2A<_u*E{Jf-{rIE?**x*OM z81mE-HxD&T_IxtOdgfG(f>kBl&}E@rCVH0; z`E#xw@R{`jf68fZL*eZtXPT=%9DhI&8z_w{I=tfX#mnx50jW^j?3KL#rTU%(DZV^-cZb9-Pv=9HVSwXNv&{C;j0_Zoy ziiHo6`^ClT)?aCUXk+cxEpsCSYJOg~d~uf>qXGZ+V6f}0F!&4dP zl^zmq_}^`y7^oW*Ip>O6N#BFgm|()KeZ?rP{Jq8CSRr!FdEFnD zBtC{mo<>uZF{sJ69wofgj6OzI`SKUZ{r2U0RF9x3HUyUo@9wR_J8`_h_xrQqqp0%L z&t_RTf7|3X#oJ6cB4`>+YUWg_s|g?`_&Nang(Kjkavy@-E- zic=yn7+;hdZyf#*h1wsl$ufK-UoVy(&4-`0K|%S@8WbHQbF3|Qx5yvDl(%k2yS`|F zu|-J3woz@=4>8M9h%iL`fIWw(wpu`arQB?4f0#QosPpHhr4fIcx%}`OJ#{p8a5?kV zp5#iyN8c%md0>O`?*|$cWL_pJef~M&Nsawz>pz}UTo&_HAv`f2cQdvkJfXOyy!j>J zi8ftv$v>WK2(NYs{Nst^nIrv#Cls18zdsV5P+g5393?#2h*Yed{nr=5Xv-E#coHn% ze=(RzctXWwC+~YPa7c{s zB_{S3|liYs7lZ}r*|L!C_X_!ycX!^$!Z_@NcctVlwp8Vt= zPXc&1m|bIH?jD~leQZt`u_1mG;!lQ;YkCH z?yI4HJYi#9JVtoJ-z2#3p72C};&~0tKb|bBRU{LhP|2SwUnV?pvAI}8MR;N?@ZRY> z;mMZ0XIxDPPp+*=KbHN+6V|O?`q;_bpYD>#Rl<{c^}7y-2~Q}3g$G6dfAOT27vTv-^?^u+ zT~^TGb=JO+@MJROd{YGBi3`p9f!Bm5%Lm8A&k&wSUo7wXA5X-pj&3JBq4@dvS|Z`e z=}HU9`-CSGqBH_VgeSa-e;xU9geSC>bzJ{=a@zRa*b~B&?Cs#xO?YxAD*BWe;YoiR zrRWIZ2?Z0q`X|DZ?sVQp5yBHb|EJ7K|9EnMsw|oC8q2MM+r})r+=~k z5lDo}{=Qq~szzaWSu&O#R0bijW{%!jpc(V2Ge|#R{iE)kdX?env zFs5pHLBbP#4MVD9geRSB<^@%RClov&@~QYBdCy&mJ|RPRQrJ41MtDMzooQkIk0(^> zG>n8N6bERcyQv9JSd1zj5T0o7Yx61m$CIHQ;ST!hNMl&jT}gOi{GN~FA5W;V`{VTq zPjrP%wHbGi-$#s&f3up&oN&iq>iGv<;x{O>Rku736qhJy_V^lsl0u3y{fI8fRp_M9 zz83?E`*pm%q`!couhI1W-V3N5#>G9;WCsnZ8&^7Bkv^T+4}?S>Y=Ad?JNGVx zk$*3nt?YExeP*UNX*{?%*j@>KM$UmgiZm&nFC7S+AS!@h%fjGsk>@PKx13!>6pHJR1%^{e-ccMN1tCayKe1DhQMF7y=p;4 zP%%;!I4)BJos|d63diE1vtc~`I%OgTR|c(LzFS1*Nk>Di^~wB=F@rLFuRW-Lskk|P zBoZ330@Y1)h~HX)a#;Db1o0(JXFXz)CG(J?r^>C0M0cdVkI9qwq_L!UNtD3UkrAoa zYZ|0Ke<6WdQc{-W3SHW2=5$G3T~E&-nCW|{i4@&vAsrowqtquhndts*X2QzLH=djU>A&`*Gh&L+~V?nKQfoqfpn1MN(9l^b{P-rq}T&b3q10(_1>3km0!FxY9^6j09%~FHMv0pN9JE ze=r|+?5z)?dGVzLcS*IV_E*(m^HafspIszx++FLd5_%1fYN9ba}HQ+5|EpWZ}#?43u)MS06H z_Ctn;*AsDMy;rvIb%6NSUT(VfXF>*of9&o!U*{s6HN2;x@8=GO7A+f`0;6!lBjjo= zJDCIRFd96(t`1{EW==OAgo3VA(4%qwD^T-@Z7^HY26fkdCc2&WCGT;NmD5Um*Lv>B z)24c`t|Dua)Jx8-X|GuN<}Q%Aghc+2;=SaZ?E9bgWqDYdSw7T7L;SK{VIo>*e+@{k z@zqJ_CVl~l*K|qmh|l1ge1t2d3enedMJd`^s2@dNJy}WKe-C}!D6_W13d5nMKwfeW zN^bd3Qf3CLT_3u7%r1d$kGa>TBi5kgh(7y z-dqg@FLPN?1}cjLf-vkOy9^!<3s2_Mw8QF!?1byeFU(Tx!3jDKL=v!h1T|?uXu}w6>{kC&_Q5zPeiL+j|M# z>adhvl_wlq)T{nNeD$vxe|pr;jHRG-?b!9NpGhu2x&O>nWs+;?hcln&~_mJf!fIQjXS}Yytn=l9NHk~-b41ScLg<2f15+sEpqSz=xcF4 zeqClkas&B;x21`Hz-C1y%wHUhb(ItqhxF07oqy-Z7ZrRXAQHpi#t;4&LLHrT?F_vypF_k9Prjiu2^r`FN-yAoP4yR}g9 zxxfjNizcRgy1*Scv*g~chTHkh^tR?&A+3~1s`)_&i1*!gC-k)*XrE~;)k#&uk4J9S z)m0cFlWbWq!<++n+}Wn|>pyv5w&Iym9oN9c#Zm78ItNs{fA*>aRGi>!gY-1h*YlwE z#wgP{M-w&swH@9}+N0x5)jx+jtU&AWm$z!>9H@Qm%(&X~b1-+Z`g8Mw52owXMs62& z0NNc9oIe{yaSk6n$d=WD%8_qNvbzJ(VlzkjS9eD!Uh=PWQk8@^Rqgrrx^z(EC&NAE zC|5i$&2#HEf62qCEKKaN_ErGt?LjEtsfSYM9^O$kcf-pbCvMK#UINcO{Owi;4Zz0a zjL1iy3;3a$F8{<0R~$)d$c;|C1asp5O53 zZl+2Le_c;0DAYc+#cnCt`^Ic`_(PBBdT1ue9XfgOx1D#z5vRh8J~GH?vH`TQ5_4}Es?lpz*;%pm5eXFPg8BrDS^@FqFjrg5}?tqBsz-BALq>k ze@8x$&mA}Zw3UCD^b`Kg{|jX97$YFw!J!|GeeO+ikLF8|k~1EJrcyvz;dDJbsrK+%pva^Xkw z(ea1&Y_~xmavWIE&TcY*%QiIq>iuE3fB5^!H<#5S{JHg(ar3P-e9pC}y-gYR+#>sQtu9*Tmvo{GK6{}qAR)&_ws!x{Mf$VL8n(o3Xo zrj%Ltfb>i2=Z|SQWWc<{WO8SXD;(x{Cei&(8FHN^Pi&C;z*7Fh^`hIw~-(5JuHJwUAkxc7|P(J2L1OFf@PTYEHlNRJr6CihgqTOI1YSjBZi{VSaLpg8ei$?;W z`rfmwQ%$ls^^n0)7I(}1DJ#cqcXi_@?gZma@e4GU?K5z5=85W)BLz@;-Tlnw z8zEpP`{4P<-Zb3$YO6%fQh&yJ?JrAnJiN5TyTIp6oBJF%jn#j(d9uVsR{y+n1ixChMrVLxU>-ep7RO#kRe zrhs4h;|$TC;qa^Tez7i@f8%Gdh@_qPsD?1xDffy>cK=@3r9+)5E56$5Y z<3b=G% zMy5rJvLJL`LFJ=+4zizWT@LvZ4A1UAKEYI$2F`zLTbM#yKzP4^e^7FB2}b>F&@nS9 zKs*)1v9>c69rBu1IAVf9_f+F6K66(%&!fi{{-^|RanJH=ole2i{j=8WY&Iwp^1Vdz zj~9v-3bq&9r9e-lPwNGWa+K!$#W}Y>62euZ)DIql zu;cvt?@Jm{_{@ruzIk5;sJ@J=3@`{nN^1J;7uAE1`I248e@1l`tW7z19>5Sd^plI* zu|pdg2i2!AzXaddH_=f&%Yg3}t4*xR^YM?U>$*DWb1Mz$k7rlUMvF>{qnSg2P;1w( zc-k=r^EH3a-gsOEf1?KcSyKy@6e92riune?W#kBqsKJNU@7p29TOXi_GMpg#VFz7uWx9!P( z5OQ8i;Qo{kO&6+c8dejL^D+1L$(NOQ)u^yId3QZBd@^rw&WQ$k`)~Vhb>_h&d)(kM zb1VMnUjL7ptAvxrt9ESA*WwL6qj-z7*2a8O-0&QL3K_avcc|i=-2<;4mM<2)hl? zxU5x#I+Q}=vrhr8Y8i0k=g_w8wpD0x`Es93P!ZL*!{LTB^iq)As*;ulcYenj_4!(0d~E+u%Ofdxe=W!3Xi6n;Rju>=m`Dbv zOBF^2f7?LogP~5t>15nKbLIHmwjA)JRGnhXe@KJtzoP@g)LI}sv^(eaXfkwg>@em` zEP<*p=E>E}QnYRL`N=$zi_ZKqW0uF&$lUi^zys=Hh@MMRxk9gr{XBPF4w%$I&Y$Yv ze-wxxW(Q~5%#R`vvdjFwjXM^Y-byMClKxoU{Zu-p!M2zn#x{RevjISi&L^{~7}e6W zf4f*5f>5XBOnwLXJm#|x8Vks~@=WvN4uuqdwEysG?+kkx)a|0wx|vrGGzM4q$48Uz zV{tl~Et{)Aj`lx6i?AS^Wcy?v6YB|LFEh5aG@XZQ(mOORw&&ociQ~&pf0e_Hy;GFZ zFN$IC_Rb{X&?FptF*MKoy9SIh=_<}1f3E;v>7TL!nx#+_mo=fFbOpG5-f{GH#Q|#y z-q!qN56XLMpB&9e#RE}uLCYyMz~waeJuj~ncPAz_f0i$Rz`M!4&KATkvm0WEx7Pv( zzkRBaSsF%tx$bYVyA3*Ds_?mLR3Y8WqkUPWWRBd&vS&y%5gcyG?G*Zv1dOb!e-nSV zmf`6}tpg$n(Wv!&^40sz^(b!hb=sw)45XT?A4C#DUfFZm*d&@*@e{kD4IBfmZ0=;_Lj6>D25FtWcOfMONEWv!Ewq`yE zWo4feY7>#x_&)C;J#VXBHaLa!yS25x$`$ek{iBSA}zs-qr2|&{x%q3q~ zgpRD$y9#`xV1+ZLt+&GqKDOjgW*VhnL?YW=_M&t+pELOMl(ZF=+}VUi6BCPWUn-8!787S48o;mbM5f3QRHL!(n6%3#dj(x*`)X;`FRp%GY+h_6p8(kw(5VC(Cwn5-?^@Vv&u^xqc>u#1<6 zn>o}2_)ha?aPCP1iNPr5q?SC~_DfY^cp(eBg;hSSxg?{}LiD}Gf8rEu^S>{CVRt09 z4E;ED@;mwerS{tLUTg~L`k6uTtwg*!W4|H*2`Fk(*Acck4xKs^cm%4`(ETdqKo2#W;Fnw&3NTY@n0= z#>PYPLYZ$8a@c6D;rnI>@1F@7s58eeIyzbe?|x^nT-eb9m0xyHY{*sPcmBro1AaM} zr~09q;&2(5te3`I;B5lBi2QGx4i=+SaopK*L1hr?>bTnQeR00Qd2tO zQxs69*FDhM=>o-tS9gAvOovTxrH-B;xe&o;N7lmUvmwDqVC^M;HjG;=XuFz);%6&K z{S=v4^q+EbHz4l||K;WiE5 zrgbocItksle}&I~`9*wo{UzOV*GfTlV|V4lJ-MLImYw(BI0dy2Hatm5DZ#M4&mAok zi-6mc|G#xVZ}1E3zY)(Gh@qddm14(oa8XR*F88W4RPB-MbGC4U?=96!%DkcYdn0&Z z#IXRAIQ~5T_?Hq-iR^tp6-{!@>gSn%9F#&+&i@v7e^fal?#oeAvIxViVfO2S;{kZX zOya0$hz8ys5C4?75=_oHt6{N>5x8mfh-{i4>2IE5$}Z5z6(@tM+ zUwgRTe=%Jrvd0`J_`cNaTr$J{Uz^jidSoI0!L7O&Dq9e|zm_-2X^xjqH(2n-9Yh{> zn=p+g88Fa`iINCcf~t1sdlLWYVBmsbl;EZV$Z0`&_rq>EI3T!X%MJr2c%aL*b461h z)oc@q}Nhby9Rg$E18$2DOlXZpQ#f3pbwdd5YW63vG(W2~V0Rua@WxtwnO z(txgHxt!gn52Ns5Hi{BQF&JlAPIjT*4EopdO^rSG!%ao`E`1hx5T}dX8#{UiJhemY za=&ebH{x#ULQhV^fAb#w+_MVM->Kt&UHmu*WYQoJ7|ZdFKgAEzKbk7z ze@4=2ikedpGIvm(;_W_I8SLBkWK0x})Zmg0jU>3;a^msLp6Om0`0psII}MlwXuPmH zbQCTh92b*cVM5WLCaDh$H$&hMd#h_O8*DzdS0;v00xXpn)W7*s;DCYjp+{`0q*u9f z|Ce<`w41%IUE8UE<$BtwG6yXoCy@G;f18p9@IE^uyUR!mUmPqudL7Q=*T-Y~)HrRS zbpQTxxvWb-mz6Q6f6f-aJ$Dbk{>L0=KHfGdOYAAX?go0-{Yd+Q6Dq$f=wO#~KwHJE$Nfca&{J)EHn!FSf8qpV z+qk$K@!P(*@Ao#`++?rY=e|ac9k=}GtjLy*&dtFmwvyWPWZ0oQQxmdyKJyGGt zTRymORtC+op(TSI|@M-qj*UAG~nvsAy}FBRm+$ z7OGTqhXX%Z_S7+Y;lqm$``S9a@jrhZx(OXu7_%KMP%?LerWFgpP+BiEe>gC9=VY-T z{#&r3CVC0H>HMGncisuagmkrEXFK3(2M>id^6 zlFWcP%k;#90dtf*ZF}O8f4UW}>9eT6B6&Y6E3LY}voi4X>4(goE(fTYvZqltlf%V^ zvwyRu?T~hqg`0Xr5%(wmRCFT$Ua_Z+@ePst^y@mEV5$OhGQZpXM1M69nahIAR>Klt z;lR&<`>DYoAA1GQPQ~Ne*h_cAu26g%F@~CV&7;IkJNk#5M*Xo-5 zJ@r!Y%<-+sdji9-`c~~i2kC>?Q{6}7ebo*fJ;L2#zJ~tFD zX?vKoGXz#|)Z`zufANJ%`QvfNv~s~pE#vRe<7N2Y--D?uX*qcKur}i(+cG%RHRUg% znh!1v)g5gzWf;NrA-r5Y7cVM}OY3hUdjsrlo?rP|2K5$<3HdJM+?2a7!{>H6Ds!Y2 z-l@xmJ4|1c!~061DO}Ira3T*QPxMj0c~*+vrkS(*4`zd?f9>Gy$VhW!u=lVTqR$0e zL;YRyJr+3FxOZKR_~6*>9DQfVc{na+1&X?Y@Y@*D#2= zI-m6Cu|C>``5&boOT>vGtIZ0^#78+$!_=@d6}GteXj z1Z6^pmj&tLAS%@U3e`+93Ld?Y;-;B}ZR~6Jmj8=}=+I{&Eak~yxUN6Wb0iL_0wd<{ z-YiDd&hVey6TYy;za^3BX$*wMsrDpSW*{T^%5Vmzpo{+w?T`$TbE!&BQYwjp-7D#q zbhRlEfAA{s6?In%PFLx-@*Db~wJ*i@8)V+8{Ko&l%dzu79jn*5&F&J0H+BV3_c?%D z+V!(z9(zzh_rlKS4ry>y*RtfG5_zY-)j$5?eE=4r)at>UGCI%-TK)O=c(al(t3Ut-QQhe@pfN+;)R(`IHPl9iskwbdLBOW)iKv&sxE-an+fsGufa-aW%U<=o;zI+cn`m z84Ei{B0gPpt;Wq%j_XFh9Y9?6UR}DlC+sTjJ7T)*i+lHmr9>taquW|GzXS*XDAlqj>UbcdqOi&e|d6Q z?$W752u=+YJ!wkv&322XC8;sMqB+83do2p4#jW(&Sq)(v7N~{TO3-o3Xj0IaJ(k5O zG9R`s10K4fN7EeS9d~EmFQq$PI2?AUMBl##L{^a}Te1eMXpI$g*qU&B*Nnu8*RiNK zXSLe#v<$dztK@L7m6JVDI+}>TqJpe zj;7hcreL_nr*@ZC_cn@#zY*lGEc;%AO>jg&!f*TAKwrB2xY`@gK6 zid7(Al=6m!qn+s0A{8|kf4R4@UMtxkxkRyrhwII!N&ny3iWQ%Cr2l6~0yl?|KHyTi zSNe6na5hoBHN33=tSJ8eQA{+(8^vP@O>yMi-lE02{YfQOg~!rdqr8shWI z63NFI>c~_!fJ5rgyU^51P`61^pCUcxr?^_91Wd1EwO-GXC2a;g|8qVsmXgeuZb`{S zW>=!G+R}e7%*g#Fgo9~Vnd}jezAnwSP=Wg=y~Gb3N(FDOV)lYZ#b7FRLhi@iI8^5R zV`8vu1FosE2lwA3fBiHZ3|UFtoh1>QPo+ zni-*^Irjc|PVP+8WUU42W;ACSBdoH*B_jQ(i`VM4)TaKVM@9aT&t>$v*NP{V7i|T8 zS#t8q)19KO>{IHwEII!b-j+Z_)uTqVg45+X256cITFl-e1*>YknLoI`>>dV}I!ba% zY?lB|N0Nv4PHMJs_IDAvUDT_?x+(UtD@b)I`$!lU$I*>igF!OvwpoidmJ z6V@1kOtT`#mG6TSUpA*|Q*@r=%<^3dgrk8cKZ-McHTB#-`Ok#w)qEJvJeyR|>LBy} zA8*a_Lzpr&i$`FvGIE6ZO?r%px4~9b-cG!s)feP<^TORx`dccmK8izlLuVew$~S#x zy-{JWzN(fJdjusrMm#GZ-2c%ej%PPIOSQRBOVsT;66RIK9VKF?`Z8|RJR)Zyf$xcc zhB55yrk;sgO?|Wrk1cgOu(WEhGvahX{ri}~E6+cX@qN3|6$(6<-d1-}d{9rS{Fl5L z%*5fa{Bsmen73J&Q~N|OHvPci1!jHhHvZd7pXQe}?;alrP8avg>`Z9260gWCe>e#G zXjiebVBpFZy>IFuG;%)=z>of=;1a%l>hL(&*7UesFID}>G}GLEdDtpi zPHl+d3t6J@)aW^<^>Bv8j2E7t4%$L9eCjtyX5PrParZ-noPVm&Fb&+K z#B0I+#!YmZ*(&|v_o&?5ZF zdn@iIVZZW!ezxN4-JHYeCufhb4#w{CnnTO~dnh%bo4j8A;+@ore!elglg;?6r;9g! zrT*@EzGTcKJI{X9Gr)6S$G|8lOQ!ePr^sLFd{H?{u zzbh{mmN>tW&XVr9ITCNVp}X&?qwz*K;=$F+Xh{UW1)1Tg#^3_lKPF$XI@9NmFi;<2 zNHRJs=c;$ywMU5#p7B2}OXbG3g#QTo*9hgWxb48d+x`Z@vIzf5rTWb2wWe36tn`-;8Ce$j3I^2@Pt zbB%zI2k~q8w278fP)blhu*@5TouSyW_T_)n7e6@o#yDe}*~%DRG?ahKo!^!YNo$S? zzuerCfBO(w`=8=xpMQK659sZyfrF2RenLN#ZlyiABW~YYl%k>_ytUcn>t|MTpHA@k zix>8n48#35LsSN=0^9DSgekVvB&H}Y%!ig%$f9)R{fuYj?sE<%XRHVOKJ<8vo|955 z83_^}{*J`4=O*l-S~LYB*W9>`;&{vmqu86zz^Sq4(6NcjkG#04B^#BFmjO=o6KHnn z-P7$z3byYD6Pf=0T4wIw=ZV5`47Z&BBm}<0IC1I-R7HM@lPJDy*BIU)qsib{O|Q)C zcY9GL;N>WM_YXYS>7CiJxoY1K_k5F&NuoY@xcO&y)Ys&vn?1<4`3rTdw@1epPTNeA zY3+Q+2ft4)XG@ky6;JWhFHnFA-X7|Y)hnE&%?P+;m zzhM@y**|U4LCLrl+SQaQ2-mycKUdQt1_XHRI!5noeT!&)vD3Z&OVjWp?lz6`fOOTi zN%i~Sw+xCQw zPgN)$V0984wH8^AJJF3v?fjyg)@IPvofM+>;8g2rmc|;jKL^dPDl%y#jnOr^@VZ`} zD&OQDfo;?u5>i!^*e4<~yY2VhQHDHEchAbr|8Bg2)juHp4aS`7+>ydM35yKRJ-hWh zP$uwG=3ly!qz8&mfUdQ!$?D<98f{NL`I?)QWEk;UCQFDFQr^uZ2|nrhDc4iqPZ&SC zT5y%==q=1HfAXL@5p==PXpmg7#+SuT4_wMc?=yJslfLpN{+e5ip#TzC6GM>s1 zP9}8c4o#;G#oNc`w4&t~yXr$0_0`Uzc~|PbC6$J@MPKOc7xyT<3!Hb>a*Mgwm+?Ir z^E@>7>qelBAW!R^A-IHPo6xAq4&CaP{8Nrv9-Y6@P&wPBmmmZ#tp z@<)&#P2;o~pJRYGU6L%YvkvR=vrT$iex3PtU=8AB2O!j_hqn45;QyeO@$ZR%u2+@f zaoYtExc`mmUH`P?wFRS7LYA-F!ZjBGcP?3}_eXU*2S4313z_FARFtuhmEfL1jSc!y z=e9P<{XkMIl?9if=CQXXZ>t< z)eRX!q=4Uf?tAfFa0{NKBZ;xppUgJ$Kge0T?Cil)R0kUD0YBqnKQxjRq4 zx1=5@S8_bdp#MIDL(HZM6&2Z%xZZ8!vVw6|;ZsVxJ}Vv%h?v_eJm|<9Z>306`Cg)N zYr9-y=vz{qXR1vt5i$^UH^fWOfA9 zIsw?Kwx;vZu2Q+_vSOj3*?%ci^tbT`83UbM==hd>4Kl*jp*`_V_f*V4VVj%#DfC5Q z*OM*Y{%SMlXPfl)vsjgNvrUUt){T90A>;T6L13W zK(u?>X46yGm;~*M@J?yI6asALEhNPzcTZe?Q`GVb=)c3g40k_$yCY5(@wnVuw5$2e zw;`mgSez}HqFo!bTQrv~Fk8DR*L|Mrb;x3hF4J{JG*0wuZR=6WirRYOkDRg{?;Hvk(#16 zM?|d(h>VHGIJQhuzo&V~`eaG;O`cWn@Ss=+{hno#JbfnR^MbMeDs)R|&fUu^-tL+^ z@JjN+=%YoKo8-G4H`j?4?KaD~?2xP2jq|;ISs=}v#U2|=)ld@ZMR?z*&1}-i>@`n*U z%2L|#OPP;Z{kLYeAq~0(UOD5zEQR%zTX4?v%9eF|Cw_b(r|YVBy?{pgR|~=%<-Y=E ze=DOSkEJ$iT6D*+w}5Q!BEMQ)%Fj~0?>VM!mK^~jQbdvBT!F$YqZUP{SL&`aW6Dkr zLiZrplGajJ#=2|N+#b8`t}F?JAWhHgx&D2bRH?7*S*1iQ)Z`QND zF4j&y>*?^)&Box4jk8qWjpB!oP9($1aGAIfTw1cE39P;MGogb*5gXM%^!$|4@TuVrMd8#MQ*`#X~TEN030vH247V2lKyPcjWVmB_G3G`%v;ufFW^!vuEj3rMCW~kB=oT zew`~){fA0xUnFlgNQ>S4J?D~?Dd7A2c;S3ZogXXD$Y8DHgJPhae1ZQ`&yF8bz*FkR zqQ-et@9tZ*FI?viefAG}%%mwz-PoA}C;b~V>)@H3BF2i_-=hsaN49yQU9?#2=#wg3 zYY%0aS_^RdQ&ePA)M`XxpiA4G^U@eIGqMgZEZ}Kd7aYcVub@P&yu6t3^7ZSYhhEA) zQ4ghe%rC0_6sZIL^d)H-=M^Fic@dW~*iK&Eb-&rs=r(+sD+b_3|LfW1U%q!+W*8gk z*73lM{e3Eb!SiXu>vBgvw-)DQEKO0OR3 zEv1WSe`j1e3yf--)Gs%*Fa_4vy(xOt*TKn@u|vJF|KQ@O{?pd_4A}Hw^32h(gLvE> zMn~wE$6cBx{XMVQO8(9rS5nbWeoM_&r)*?e{q!}Tz7A|RJ^yi@3q7i~GJ%S$HQSnj ziZtv-flWsDWWk|{zBxq;6s8xLzc8_#+TQ{_7bL1Yto)k=-&PXM+f{q z|AZgH&lR|$>Y@~^oG&Bz!$(oydP}xFBxoRa=!e+VhvlWN)milM(TZ$Fy2E!~(&qlm zTJj{MFRs*g|7t@U;!-b7^If%4SyM9xK+7mB>1i^~>AszbVOc(oh?`{$Q~4eZ!I?)oO45k)w2^CcQ1 z+r^*x#qONbOHau znarOBIq2)@dE@OlLfkYqQT~B<6>@>N!`Sx%`ptRh>dui-G zkF}>XFgXS;(QHQd`iUOC-Mdk2ETY>3sjDJ052B-|9xjQN6s}=5XDqhIUZaU_*gM zn-?Z)?J^Rw<0r|Aq)QtYd=P)fd-X-{dR;apU@tbWPeQD!NHKZ9^%k>2R_~#7g3f09 zGZRY2;FGnG_k z_*0QaVcezsr+Y8mabt622boyGj{qty4=yOQTKoJ4OS zgq&@<(&sK+Z*EFYCs_$iz>vsZXbHl!Y?4hkHvjHIx8k_)ac|)p--?MxJ!I8R%V~LLyYg#uE7bV@OWE$s zS~PO%02$dQYgz!Weqi(M!mS@hH|!$wLOZq7ICqHGD)SD02}9YS61e@s5q1)gY1i9T zE!}3yQ&H#29Ykr0z`@(5|9j}+4y%qrCcSaYnIE%hX_~`_KNvf6LG`n}mjn4NO9k&U z^M_KCA_Z9X?nWm*2c^;ci{NqNk*X{{{eoCTqDrAm!;e3f=wjIgIa%+LjdUrU)CYfW zFE#0U%Sek+6J;h7ZX=ApyULgX34NOibuH(wK^j}#&pGOz>sw%bK6|Ri+M@c!tnTw2 zVuJck<&$3eFO;qZcT)Y?@d-A5<>d|a9=O#Zb9GYNz>rp@b%W?{%ulDWr7nBVjnqh{ z)!|`-FWU#}q3QP``}CEaf+1&(*Vz{YJszmfHC0bSg1D7F9Ch4u(>PZ@4#3&I;#ngO z{&gvwR+bzlbslgY{%3owFsv-@yJKp~am_X9f`scTqTRn=SxjU;jZk3dN8oYKGTW z&d`K(;?qmCDNu>>CkH=?a3uC??iv9eG^yY{iY1wI76*Td!d=LgbgPagOU^-DeT6X2 zrwdS_4-}|^rL4Uh0rBdhT3;nFEOu8v*M2Js_xgn;VV?oLUBBFwa2}~wj-OKzaH@&L zoH1>Rpg<4#*S<~xL`3QJv4;)>#2dNPYDF`_tE-u{c72h!%$$3|!{NB@VIJt#1sKVe zfMX7-ZTel}+>umiyLx_|q@>eBL{yNSWo&ri61R9I4))tge^9TshN5tRPX#m`SAN{Kdz3-EAZVI@+SRJc6a(7)~+~z*5&5a(Jfy!vk~QUiepDK`@?_b*{B8 z?IcR@?t-1G>cbherpAFYXspQC)3N{X!!I`T4BGxgS_k{v>@;Pv?k9F{oAM!(|Dou! z)*dp)0_MOVQH}yBSoNzAqd>+G2lfkdC2wc8r8D%g)E)GgFMkZVBrDhos~ip;Hq6nkLhsS<37l1e=eA_4Y7aKla_;s9@~~CAZ-7NA9l1;)3^o1-h`67 zSNAU-(qXi{J|i`mJ4ikQS;En{{R8Qhcz^+!WJUcMb-D}j;f9S75GO%Vfv4HtqSsCQ z*bI=#8g2TO$rPyNHF5i=6v*s6b)Aj^soQHz|JX{Jmv!qw(n%Nrc~6WvFl0+SXxPI z?{3P=gpv0P)||}G;*I=KngAOnrrzO&J~KXb&vA7SjQy?%*c$kEZL5E&+t6~Hhz=bB z6i6|fw_|cE_1$pK+z15<#Mq@T`Lt87KbWtI#ZsFqKPxN!hZa3=2fe_IuKpnl{d*S1 zT!~j&W=CI=$9${2jB$?W&tB`NK$VdmzBh>o;|KC~k!{p~;a_i~+DJ>oxtvR3IEYX+ zQK^F@6D$;46powt>1SSg0aNV#T z5QTf;EeySL4nS`&dC{peqm3GrC$4j#;REK_B1TLxsW_OkgUaBcbU1hs6XTx!Dflu{ ze-KwIQ{k<<)#7~#b5537<7&G?f64Q|;W)3}i#+HE+=O*{-+4~7(cd-i zlnXHJ?II`O98%w)^5lvL4V4!r`}jLRf!?a+&$&y1HkYYD$6jj0CM(pSuMptI!Qc^D zIyAP=5pKo{lgQcFfN0TBt!j7HVkyuWn;&_%DA0c)96Z$&XqO$nzA9Ii#aGj`KnAIo zmb6#EMH3XMXhU=n;3EO(jcHE&oQo~ZQUIgfAzAqOJjU4@;-1Ql)X$~?d`^z@gONj( z=LXtH&0f&`Di&C=FD3bj95QKX=~L@HWO9Xb<#RqH=jvACFQM%9ih-c#=JuD6dOFf$qMS6rTUc%_BbrbNqMtz#$tkL-&!y`nvUyMQ zk;#9U;=4(ss~35)mQu9P)xnqbVL@xeL;l6e5?K@{kvl<=trB4T>oOm&Wk z@HVZSAx4w;2mF`S!8#ZF$R={(lKu#wQnB1ddP_5ZT#p4ve>&0~_}ZvG#t-g7CX~QEGPlXbBhJ~dOImimq+kxByNIexYl?Uoto=HFx(91Mc^t+ z)?>(dcW8AQ?bN5{5|V6f)RF2aiBo3uoO%6J`YfD-!{V=MC@#~bx~YN#T|F1XrYMTU z>7d{MRk)4%V@6A!dy-?*LxI$sPNbiP5ipydb~ zl}%HL@Mi&8M-2q{!L=MqOe@vgjpwiO8N6IzZT7JwGI{)^)4CN6Rm01y7z|7~Y3Ti~ znaQUK1{Y)w2GVkZ3NqXHXgRhooIkKHQ=sUy%t#`F?c-ioPY?eEUy07TdswPW9l0fg z11)McU=8MHs-UqX7=(XCYO{w4@L#y}pIP&9qO{@oG!P-UpT2urqmH`sFHQMAAEvA0 z$J00T$N_;|@GDtts znUCflSzD>dv2Xs?;EHd*db`hrmb1@Kab!Yc|KZ%~SkT+AmB!!m!<_H5AqKBtNG(!c zT5;q&Mb{5IF=U8&ZTEFLjPrckkfRzchd!HeeKEl(mKVKN@`VV$-f12DkO;rl?_SK_ zPL1UI*|-64;8R=r4Ps^yL)u#S%{J=O90AHFRDuNQqmkN98_C=x()MvU?zIYXTUs8e z_u-Ysh7k<~HARQ)W2u6yRol{G}q@nc9 za}2JesCPUSeA-vVLzEzLpdr<|GCgbK;!K^Md_9)>$P$keiXuZ!^}MV+KFg*UoCn;- zLw={N{gylBKZlmPXZJbd47y--!9sumjcqC3!NErceYe|B`Y2H3{w#AdqgUmL%Fce`$4T*# zY@X=;CPcM?ob{JN?r zCpvX_V`~RYw$0YAPuv)Zb?l0}Gfimfzx;7FOz|&DIo6kk+LOf}%o5=9-J|A)w4CXQ zd+{I+Z0a1@$=Pq12S0&Pv~W!2^9&m3eHlX&GQg86-@}LqehZ)PasY`+M*dLAAVyTf@yykZI~^nCR0YL@ zi-~o)&^T5%YGmUh%He~m%4{V`+!L)0$zPQ4o&SogA;6Og*LDzYMcTJrT+3_PNN1;4 zQ(iwlfBiMPefWo7`L~fOM;tQ5pvbzHi?VwY_6})wvrKoNgch2t?FK4*1|EHk8`QpX zV*hmK=Qy%X-6rknSY^&F!mOwTs=j5s0U7!{gxl8{Uv(~}(=)H@r$*e`X+vPlffe`c zgUt0}vk{+296Hx0mjcONNCPskBwF`M3Dh$K+)NH8fjGBoLbWAY`+<~;_xLha2R25; z_ueAmc~Q7Qq2nVs{st%TqQrX^*WP+2Jbk}M-Hqv?##^!0!yj>M7gFx|?vd)wpUXJBbcNx1Ec6U((*#T|#Y(K115DZ@UG7+7IIaW;MhEY~kV&owjZtTi zdZB(zGdGZ&Z30V&d>9gnB9P@uflg0nOr52n&c$oUJJJLfk5fIsTK*)Gw~>_y|52*| z9SOsIOGq8M2Qmc3{jwF14gI-~Ac1heLz}(RkS6ps$*8G-2;VROkT_1l%K{P!!t6iCkT zUz8dFuDl<~Nou3cqkWatH^Hk%NXM$|_|&H#wj5M8h-O!&Sog3buBihKZ?Js;7G=-D zJi5kru%gf$OZ)g|QIaOabX*`?VtepTG*AK9j;BD2PjJ*54)EXmZKOwx#~5yAG#stG z@{k8P@PmF^LkOAl_XLejCn9Xc#2O8d`rB%mjgmCfx?~0K*kN<*rTsO97y{gVz31iG z2;4H-IvcEP-8@q_9nYafO=?RsK|(lX9dv^eL;ADvv458WHLh)Xs7*wm4%fZ|88Nub zSDx{LAXpb~+^%B;OM2!-p2pmY2mSUB+rU4&`0*1bhyq5o)ogRa$=xtgiYpWTQuUX> zV^B3%8Q+slq(Hc@F^^i_fRR20F9{-(q*nuZ0Gd#5zklaC5%Kp4T1z#Yynp%2`(93b z>a9|05V)}9T?b#YoD3Y0sWpkN*N<1rVVypUw%=btAMhh_Sm@mq6A;)xsk|6NL_FEr zsQd*|%vdBIK?if5DEyTL^1docPcSzv2Nn_1d6NPWch;?dV5#+s#!BUF)Q{T}uisIi z$KLKLk|5>}5CtjWj^60QXGo6ZhITp2=@`F_s-KTHA%Z{z=Le9jnVytZf^6;0rwq;~ zk>m?kRz&RDsC{btX@2KGX!rJ!8FX$ayF#H6nD&g zF`>f%F^fgt4%BEUqs70sxbUJ2-+$cSgf#B^nWj@9S4ym=wTbXDRI<<6R+5sfc(5eK zIdAZ#@+FKjcT3JT1-eqqcab05NkzLN@Z*J?+Gb486XFW^F5-t(4v8flf#!` z+O7j0co5F@BL%fi35XerLQnTKAk%zW?mI7rD59!QIy(;%gWu_V3K3*Jffv5!p=865JFagS@YQgnsS77^z_627 z-3(k%Bb_f00=zvYSs$3_ErRhPcN2*Rq}WM zqxLW?qVa)8^hmBrhTQyx&D9+hBAia;0Vx4g;nLM$)r=qu$?x-)M(WRV@ESd)p^)YK zfiPOmK_+)6s7rmY(MNx4Ckc*COl|SQw29cL^t@i{c>uwCw@?`4?2`rv2q2RU{w+-K z(NL(rTbxl8h)~<6MivEfGUD163sO9%HSZ@BNX3vxDkwGjL7jv1S@7^fe8KNI3KS*6 zQrbp=GGbKB&(Z|D>kCD@DUfTXeVO3TM0H#0E>j?kfq$+143V5;-WhaAT)~i=fDQox zY!p$btZmf7*t2HA5xBu;3yQ9hI4?e>ITw0#L8XroMFgq0roy=Cdm{MK3PcPXNd1W3 z8X}bfEgK5^4y8aL%P;@0+$npTiGt10CGs_kBuv{a0!#Lx<$#R6N3 zW$ArQPCT3n(O$Qqp*mZblcn3Kf>wu$Mhxgn`|lA!z=vCzCS_i~FTkAR$;q)TGG>qR zwR&9yG0y&-9dFq{qzAv{v1Z4GC+`~c$1{Cjv+mE@?a()z( zsfVqkHy#FS0+Hm{CzkKl!pRe*f`yMap?vfHpu1_4%EG~DDtkHJ^UjgjsRNEyt6>tkuUBx^= z9Pz3q=;JKHDJacuqMd5pEIIS$9D43_kGlApmUB6G+ZT+WD0zvVBO)C0OPGHth8%18 z?}1A@6`6~unm>!TSGmh|j~;)CN3koI8&*6gwX#m@`-eJdS-^o^L&R?aI0+2gDsh{!SfoZ>_}@a*Sn;&y3Eq}sa1v5myrXX7eagO2=H)W z(!cZwT!UbJoe>8{d$}tSctU|zqFnZxqsa|`&+$M+QJc(nFS1;%An4Pm%w&MXN5JTp z&^IjUjq`vg8xaoU`p7#SN=|v#o$(3?NSl`NZeF~GOosQ>(C*Pt4OOZSC1^Qg{V-e{ z0sg}q2>!=_)}(H~PL)6=&41X&I8mVGrr#s1h=`47|7XtaR8Lw3joMDV!T+`a7;Pmb z_`Ufs?dGVC`S&$jh7NrRcaMsig}>j4LRt_Iksma<$yn;qBiL7d27KyCg?~!+$?XeM zx6!9Uu&$|(-4cj>r8}Ae)RA++Tpq=l4W=}~pw+lJEebS3-?=uP)z3meRIK<; zn^iy5YkZ`#AuuC*C}T0bq=E!E>`jbE_>lwC+~v?}3IxVn;L1ouFpZru=0=deO_xc$ zJcHlPb-ST{WtTY~M;t;>AilPJLJ$fh&&q~Nzm@dXt$9a=4p!`9O8r69R(~m*;o!!N z#GOfXZcqf@`18Qf6~luaHEeA9YmQC_fVn`$SnUPR)i@^zmsP#}WEa{$=*97Y7$Ou#%Pnf{dj4{d}h zHNWk3`{PHzG~~JX_J7-dR5MFKOk2qWe!i=f`u0t8YB!h}N1}s6Akv$%gpcM~dh?WYbXzvakodVGn&N%Bg%T>(Q6 zhVeIIM(QoQXnJ0Tssv&T`R2r3dlUq(AD5%zzyZ*iG+obC9lRFzF9ilK3(X$9gYj6 z`D}*qt!M(t9sA%4*IMd*CQ+cK5rR(}C{RVry5w*S`2y$kL;x4Y`S;Y=5&$X-2x?Qi zBrS)EDOx}f;5^MPjKv_jVP+EDYa44mE?iDyz{|N+;r+QV5;XOb?2d((FYCJ9c${cC zsweb1I8bkik-G7;mBf|e&&EW6cbcvQAA=fjNI)Wphte41JxAjxu$Xs(rk2VISRtvcOUcDJXq{VvWdh z30?^-Ft4<01C5YLSV(7;IxWZJ8MpBw1@dA&KPedOe*=zIVPXNj@7%&itpXHPT8dD=YS@tR25FW~+Ns8B0QPwFuoQnt!}fZ#Dd|jVd$K;Oe^v zGPvdszP=GG{&%+mJ&Pd7fe~=>4ot=kyTgVlBD^QD&zGGD-`W!%R-1Cu@spEM-8cwI z1Kz~~TREen;p1P^9h>?`v)KL$HCBU$D`LUZF*001E>Rsm# zUOk52ok^N*d{laI%F#(5GYWa?IUUmJdwe9aHNqKDutv@7elvsTwun9YRYJ-;5Z<;^ zbl;hkY%nf<`m6Ns*&~o3u#;rQk)hcM0A|-GQz0|^D$wo7B9tbQ!;}-fCp2<>8ae?5 z@w5xD8tfZ#GfHqR&Z}M5BL9|xh=#RQ(#N0nx0<~kz7KHh>WX!{`w=MnU0KR{K1#1R zY0LBO`MM4>tdbAwM)O7R= z1&H8^*WFI7t zJ9tehUBMI|QsI-zG*l{+m3vPcb^7!K1Cmtzk_U^OQxpiW?NQdbK!khS2qDi#;)tJh zpFz)|;Ys57%1f9SS;wydAXYBy)Cpz+-%%HCw@W}QDZf_ct9W#&Q?HH`LxlTHNeo7{ zlT>rF-x!49^750L^FWm2-Q{+R3!|;B2oDBPU7S~2_gGl7LxOpLngEicw=%VPlmcOQ z^N0jM+h}o#CxSKF@BC(&el}=&-~O2}vJg$a@Ti7WAd38=vUtku48B_IRYazJI` zjyi}|WBFv0y=j6g%dYNH6i>74oZ@{>OFrETrEnxgHqc3?qu#(gIa&$ z2#Cvzrp#)fH}Q2>NG)RZ1QX! z0shqevOYS3d=622?J+aH+M(*(HwH{skB=L(EK;A?T|NR9-5E@CZ?F)o7!f!gHw)jW zbvyt+V*O>O8gy34BG&u(4_K;_KW)#gHRRSLGp_PDl$?oEEVGHmNy4hLB5C26?Og(hhAQg-HM$6nNvSmUj*fHru_lCT1i~KcV)7Qq{^uJPl=NKix*aJK)0_Y$^?fjcsax#f}4?6oLJpTYL?*6_y2x5MGdW$U5%xF3{e>F z18pPDU6?Pxi7C!or&fb8BRCfA{fhu^_SK)h9Er2IdDG(pNH!}CrrcQY!@AqqQjd_Nc_c0ca5YFujKpnDTpXd$!z3P>?@z1Hay7Ev4KRX)MSp%e1E32= zFOjSn(Q@w&s}EI?I5YZ7c_vNpU#0B*mHrgyZdYU%7?V2_SJeE3;Md-3gfD@rZ+MO3 z$k{g1bUm*;APDw1@3l&>!b{)cWEOiTU}l6cf6j`ByFaIRvK**CUAPp;g-$Kq!Z#`- z^=h8_{<(@AsKumz5TXfMx&ib_NSaVsyonqL?7B_*r!LKn3l6zX}O(BfGF~$2&bJ;qm%^Z!c zn6vn57lqtZM*N)dWBcm#i+a{6&aqEGuW4EOpaIDOlL*>t=9NI|WifsDXG;?r%_iFW z6A<@ylR`p3pX`&0A?ZK-C791l*Ev{Brn3X6=>DmCd_5!#x9sp@--Znh-)}*1r-PFj zYf(=mF%or8x`HnulVh&^BY9AubL^v6z#ve7KR;kW>bWgFl;@)fUa6Y|01(|*);(~( z(@Oo_&&qmUsn`_{sl!K*H-%Xj6C=oj)4Nr^46x#Su{{=Uq~0`RHS+-lq8RwQN|lzg zU?(jfO@Z3>CnSPW3gLlt3)q_GENa}r2Oo!w3WA)4oFaXgNQBRvjxFzjnvIDI+Z2e~ z^M2zez<5)Kbpml*`0C-Gv@v=bYGHmM!;k`fIHH)01V4oeek;irl$j3c{NID42$jnc zH@k@NY1pn?28fT9Ebitq;_XM>vk;(qsPw_<7dQn`d0N<^jO0kvec~*QObX1Di%>)k zuzrs8i^C1_AG|xI$7p{vR5ch9fE)lb$3|xie<=gGE-I&tIvNc#r!T~i9C*|)J2)me zY=1N{HnQ6-R$Oka`+wzdS1^kLWiE}r(t@ROd9hY}2BDZ+wR)(w1!Vuz8w-nE}|13C0)m4z$~^?vk!6kT;(6z>yOkroh;P)Zu&x2FWkoA|M^7ba!`$G)LTV$MM_WKli!Y-P@h_nP+Bq-8Ob^rq)h*jg?A!9Xn@7{2LvwdRG zVzz&7h8IY)N6%z3ZvvpRV0|qs@={5FZdoJvQFJLg25ZAvQ`!y zm=HidI+a#~x3)#je|Pr`e2*ndLU1B-!glRe#Lgsel~SA=!Eoo7VvBr4R+zeRHrJWN z5TH^3K7ehTY7NMM5BD@On+T$gJ~P~k>~()8u@;Wd;>rrQW&G7Pyj%qXOzar3EW6n; z?-FzL7*N)}Zt`SJC{W4oaIRFNADOia-n|!wkv>rD0PT~@=KI-ok7!>5r`ipV&J%zB z%S}MkW9L6F-T9oXu7R<+?S~{2sKtBptUWMO4rP5F1txinrTn+FwC?e~U<7jCV+NJDu35lFIN7WO&l#r#vD|G<0gz;~0;A~w0i zxuaF28zSpvD}#Z`y8qzUfV%zFZ05UGmd{RIHwat`8a42RT(~mY57fV;@$+u{T=E4i z1L}vlQ|87a!0ELWN#41Auqa7~O60X4*F!K^SZQ$ZWKF?!8#7|?_Hnc8C@BPym1K&U z8v8c3VWJMO66Jbqh@FObfI;VaCtffVx{QSHL)ikxt|MAM9jtA%58obH2=g8H7jZ4I zfle!Ys>1r`=_K=Rnpd|NrP0%h>JE0{AY)B-0?vDT#w%`|T<1gUL z(H78^C^|*WfMl6yX?>-X@cWSD({m%~*M8%cL|*l~OeB_@GK-0 z{hI6TdA9gQ2V8wYHIw#wQO&cOdCdLa+X<639{YdY5nVUkKVW!dIu6*~#(gADD;^=; z2{5&aI;&@YkIg3)`zPIY$E}R5NyHeb|7mJicuL##?>0sJeqZXjP{pKKdG~y-Iz5?b zTBBQ;btdh_J#LH-T|gQs+2aDNFh|_98Zs<;tl;gVwDSdg$FwtFeCkKXr3pdwkJ>#- zUVp?T06t~;O6#BAW5%A;#WRtn@VrW7;pF_Pou`S3-pE}ciA#X&tPh$}T^=DmI5+6S^-+9`@5uA$z_Z`<{3Wm7ylfJ?E^DP~r&?TYUa%^GUId+)%lIe=c zP{jlG(cv}VgEIZ@w&g-F30>bg@27G#S(=!zfLOG%Keb023uSftVTf_YL>h)g31EId zQ@hPI<9OB)yJ!c4zKko}Y;We$no_>ye(L{n4_tjhJnY_losZGyw=c46jW6E* zZj2-;TD|&bJ^QDiw$q#IX^c9o#-^K~K{ITRy(+@x{P`8n`$&ZuLD3E&rK6lXCs6@H zQr0HD)c`XR9dsq5iic45up!`S33xM;DL2?{XVog(B=qE^ZizC^J}^WGd1BpiC3Djs z>dM;;4q`{6hJXE%{&F6^BFb;6Yr%_Z!}icE&h_yPAhgGCdoMw0y79N)kLa(OOShK9 z$gPl_(2K-?Tkqw?sxu5MjxF50BU=CE2duC<|N`+C2ftX?CG2&Z{WKEk2ROeZ@R{IoG6LUGvhnSsFZ8F8j;6B1c@R&#&B7tStghJMVEmjFJz~=vIyRa1-lk6ZRq_YdVLd6PX-YD!eCeT~Mg@3bG z3ci7bO6iKsz~*WSy*woYji3=>@C;s#g}>6bc~WUG`nodg=RjEz8)9!R5jI(U^vkGb zD=cAY>0JA2Z)~vdw0HTsvg`C(=|f!GWqF=MtH9yb>#`VZgT+JhqbVPSxv>`}Q=&7F_|<>-XE3K7-PlBiXI~3$CWT$F8apqBbkP4V&XDmpjJOe#$A5PJs+K;sPTgZ^Y^(Xmwl0W<`!Lvt79u| z-R>I*RP$!tzZ#N*HV!Ig;a5?%i~QJ++sh(h5ELYBT?53n`YJuUQ;EJlr_fX|t8WgJ zh)5(|T5a6>Zy(aVTF)glHcMAy65&d*hi&y9<gnw)h_vmR^=fNWZke znIoT<@+V+WR6>TpGy5NnPtNHBc=vU9^S}$mbIfW}RY4R7r(@i~V|wfBet+6F7{M<7 z=}40=KOd9nr_SH8AMRb+OGrj=18dsp83ZWqmGT2$;p2HKY8;;s&u?PVB^GWYEArbu z)Gmnn+-={fjg0PlZy)byG-~#lL6#F(ThV9#EsFptFq4Prc6N#STIc*R)d5CwO9Xdh z#?r@EnhwJ*ADhILny5%}e;XINl0_^m7OjaXcU!&RxA=Os!7*$g;r8~g#3N776#|3% zm&<{Ohw0(in_4`Y7EBC5O%0laTlvKQA*A%O$OCJ2?#d1gNrrM1bG(h(YomK2Tf0~F z3~HW%IW>M<+b89(OIqx-PqV*1H27S(JDAuc1aRjrPVA>scBowNg1=UBqxI0*2MDs$Nm?!lTbRiB*nd z{#fDYv@4~gZYp8^XgohSt+~{~w{a!GH;h9RXkVVyZ+=Qwk39E$8xJ+2TpHta-YHNV zD(OL0XuTA*fwzrjaCaYnBtD~*_})}c0PwaV8B^72|5_e=q(yxi+M(!h6xaIX%Uykd zXAe92RhgOnjb^5mSWIKlnljD9d-v#NcSeh%Sq0NmH~+zyVL+1Uy?W(N%oUdvJ?%+3 z@GgV!c9~A1&tF1%^z-ex8_z_F1`Zp|x?4}Bb1Wsl_C>{$p0sZ{&$3*bu{xOfqbCIg z6`oL(MSEkv=VvJ9^&U12=^fmA62|ijE08+nMQlBeOhUz7u|W1&l<~}+62G=`iMYT> z&A4vnjy?f=URXo@pC8_?YCD~=2`SF)U%(*1Lz}K{Q~yx596nL)HgLTh$01&=KX+pB z8^0l%c+0hU!%~P%rPt{(<7dpZUFW>Q$0l?5SRbkQY10V#X`DS{YWT>&>bc_|A?9el zS=N^)Q7S#T(p?j%6OmP+wRG$2?XP=cF@08_J&)==mW>`cx$iSB4-I2+GR556`^kBsFTxgm#z zS{L8AmMiWENxtj+8I4Wx*IUP?zh$*1)DTGzuD zas2BR*}ie6T4^U4=UhkRBaL}Ri2`Kx1mbm~ZQ4!Weq!Qs>najqTJTNrfd|v{x!CZo zFY#o=hEx)aW2cP8M2~JD0&iC=<8uC54?*67Is8-}YoCF$qxa(WBB%7ntGVGudzD1X z><_7qWt!qCEJDSpq&Ke&YA0mSjJ4V?;tmIgdB==v(u?dwwYLq0DR&^reSmLJ`p{C~ zo-bkNQP4v3lrhZ*3-B&SBJubAO?q&W&?i2&?}1-~eK+?E;4gaH`))otRpAdO@!ce% zgS6?^_dFwRL%<#ToXv>g*53B&1;v zJf;sDjy+!WuJC4}ZRt~O8cmWzFS*`+~8nzmti)a zj2WZXnsdYgeF;rOruJiDs zpJ`$gPq>%sy6m$e^9Q)Alid`M-SyPmEQ`X@79#OFSjy=>+LqF`Je7@IFu;AHJth}& z>giXwu=mI2J}sIUrDZi+zQRfZClnBqPtx^}i!(-@*a^$2J-mrEFe;)X_hO*n_1xpdLmZgfp;WAdKv971+;%-#8r`EtIX$UaqaDNt$w-6-pp7(iP zpvC%JN+A6EaF90fEraVko^0JzR!tXqoWo1F#~1!jQ@`C!g0RZiw~XHW33}#Qd9Z7r z&iuWk4vjei5H`@%@6 zE?VZ*<`L|xYjqC%=^-MV2o~=3c3vlMr*@uah$uN1s`e7PuEl8t4EoOa2X3l$n%vs(X@?=JdK zrjVY5*@rhCM*U&u$}xA`wmHA%>eSCYZqhbt5?=gEQR4!@0HLeL3=9)$-|>fDb88Lg z4iOvveQM8evgcRk{R-U0kYCTXtp!$UBWev+gq%)QKQ;mNX_rI~?3o`U)R8HmN zTGDGGFQC0gJE{MssDjrjvm4bm-%IXFt`HBKS)h!=m>$clhza?asw}er=Yc(ftQ~)|f-*E-zI?eZSAWt@Aoj)eoLkE~^~z zndT*DpbL%1nT{MG@M#z{d}A#`Nsx>E7Go9Mq`QelvUbaS-Q~90o)$8px@{4I<`m&h zZ6EC1nzxXi_ph&VFlX7lG;8&8>V8(|MP#;s8Nt5u^MGiU@Z-fGc|-u;m(QVQtCCm# z4mi6;|9E`<40TpkcL3}^C4(gbajJJ4X}hffXE~NEd!BZ26^yN~Z1omns97s3}Wd6}m&b~*}f=O%`~M;Q~4J$i;pn~~i? z5_P|7S^`@MJ@;d<`O+od_IQu`DuqUDIfUGv#YJD%4HppSdWCBGP1?8U`qXU+AZ$$s zw1if&Jn8C4w1t|y$_V<}Vb^V8NqG%W%_Bx~Y`OZLhs!PI1uZP>RJG;pU@ zm_c!%9ZJy}Rw$RSP^NIhz7_ze1gHV-FRf`;azp(n;xXI9VProZ?Q3T!HbM{Nfyt*9 z=+H~{*y0gGHQ)krkz)hOh5Bgp_J+Nq!~v}hY)T^1Pqf|jh?6iZKyE+#WbUsbUr3>x zRdXMJn#)x+n7UJYJ(efBuf3TZv3P(f{4_xh9;2U=l8EWH9jODz3*`oC32PbeqMAl7 zUQXtI!De9D$87I5x5kd=M#}AqCSgJki@2TN+>$e3dr#(q-4(ctQRGP_T}7Tit$_v2 zZIVVrt1gZjKxSldSuJP9uL>}6!e;j^fs2L>kppeN@2T`49ECSh2N>J20l^kIw}t9A zH|!88+I@^7U|T|Upw01KcqR9Y)?WM#(AlqDikQm{waxm5QH<0k;86wg;hz8SF4=85 zN9&G0Pv$nwagE;%{Czl?izgtIamj9$vh{Pt6Uax-1)XSLhyMn5{@SGmfwpkEza_`6 z0`3N`D8O%x6d)`lEcoE);*L(ht>23PH2`pzb=`fluiX@kEu!fOT>QSa1az&)m2b)G z4>Kk64a}W1px*WP&ROr&jyld*3+0fL zEAVsRHmR0N*%NU0IrRh~^^&;#F4Ox#7iNh7^v=WaN>Apr5I^6{m(O1hQK0hxvb?;Naj1psnXi*qGcwTg!24qpuQw)^FQHkvmj zt^k#kj+7nG^)xP@R!YDq9;<0`9BAL>yMrj@*z>I93bSMtqR7Dte1&pRrV^gvm+bk> zx_+RVM^;gwS=g@}v)m1&o%da+0k!29CZY%0n>5pk2N;$(nUoXlPOcGE0GKqD6aN9S zsP$kE}#)TbP?iF<5A`432Y|Lg0!*@Hz|}mKw5L4askXXRR>*7{3UyEer?Zq?i0ELAyDAbl;3Ww z2inTSqA%hx-5>KWVVLd0fBO5{%Dg`>U*6%fvzG>+XhRx!L01qVba;U2mh3*V1U5Nz zRc@2W1K$+NZP6<_;SN=?ZgWlrnGRI2pzOruurW=8ndhQ7beg>St%kbJ| z--Eo+_2L38&BNa_`9wS5=3w$JDi;^y3T%FAbe1{Le*Zj>faOjt>tp2v4AZ?@o_NXr zgVO+1yvIZh=rF)~ktlLCk-*8^={X#SM9j9MVb!-w_N!V#UeGnZNz_rhO+rlbn@;9N zsx4KY1z{8`MG0jw~hpe!J{4?OIYf z?yCQ86$L1>e7b+8RCVg~?gqtS_5?%(*mk$hfhi+ue-pnvOZsB&k*-OIo%P_Cb!?T5 zr}hDFV;ss|BTfyc#hx+6mXb39?N7X3a>_xp24}<-tAt;1Y_c#~m87dLPS~;}w@DtJ z6^DGu8HEoJg;j-oYvv%6J>Bc6TNCePQr0dE+*k=zZMwxQ6j}f*`Z?ci2L|C5Xwb z%t+{W>{hcZ{5GWRhq2-2^v&nCM#|NHlGVlTJyA~7X#|AljO6Jgrpauo+(CCy^Czkw zI%oe|EZBFTQ<`ZN_R)^GGdyF`z51qC1YE6^GgGTz=3}gxhu7yQhM_^e-S-qzG5Q<# z@>tmvlz-gT*V0RIkS0%+b*jI4Gq36R!$!k=t?jdPs)$iT>1R%j^lcr?+fOZDT-R}~ z@3|wSPCueqNa=jc@7LPu%@A$Av2GWH{Wn`g^o-SMYcKEPhu6s2Dn^IHPg_YN0OBsp zM5IQy|6{o4`eiREB0#cFNLa6G-Q#Y*sm4z<;J(Hne<&5Kfh6gq^PtbbE_~@%n*@60 z<5YQ|a{9$${cqQ3lHz5-3@=%*cTh}gJ7>|Og#YT%w-OOtk$nD+FuX`R&F#NfovVS2m z?)*72yT|ygA3Dw=DhWnAeUGNm*0&J7;q{vA{SZx1W5WE^e4rc5d-84eFojeyX8VRdk3? z64nLKDxY=g(TT)tQkY`&d2ye}!*mI8 z71^pC{^+>&6gxe407qa8CL@w28AcsuVSxOHjC{^0yILhq7geaudtsCsnl5Pi$hK19 zg9R;D#{E2=PNY<#te#8wIUlatIUB!Ab~QLgFU zPlbr?pS?ZO3?1{x6Gm{IHCOfQt<31 z>`&$2*30pUIi4yqA^-6?sQPtXtvqayzj)yz?a)~sWpBiCKTuz>nram4u%1@u`rQ7a z(MV-QKjf}TtleIKAujWGo%s*}H&auUmv#Ls^qrA!_rDpV&|IlEEqzZd=JZp1b!c~2 zj!gw*b$`)qaRD%s$MB)`=~}gJ?@^vtn%L&~(XQLosD`Y+Yu-g@T*Tw*QmZN^0M2kJDX_h zSK=^(RKfJ1pTFdW9<6!zp2_+{HB?-}`6NvoumE*->EUizt>3DN0l# zY>(L~R_oV!lwPD{m}C}l3e({J1%5LF)l-AKlVABef@Iⅆy~`Sm#`}sjjehK}@-3 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

    n!HP;VCSDFT$~sjO{S{}#8Q~Q_!2BE$w#gs~ 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�cRjt(=74;ZXgOT|PmS|_8!gI+JU4y*@PNu|(R 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

    fX(0O)@U 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�n-+5gAY-dv(feiZkA54oU=;?ZD-BpSryXw#Mc&D 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 diff --git a/tests/fixtures/tension101_damage.mat b/tests/fixtures/tension101_damage.mat index 04c1fb9e234e5c3c2c4ebddc3323a1e369bf3aef..0b2ba914c91b819262858acad15a5dbd7aba5232 100644 GIT binary patch delta 2258 zcmZuy3s4hR6y+^2gkMqQ{}GBsP*Jdo@(Xzi{)Hk~tO^7L%g8Ta6)M#x5mbUwKHIto zNEkuEPEl~F>vV)Xh7PC*sC>sy(TZ3*S`q0mf+5}PCV?WE+1Y#UJ@?$ZFZaDyBQdCv z807OfpD*|E@bd9oRky*}NV~}9H7PJUgeeW2Zz{$`SsXIOq#H01z9|OqO{Viyz?|{Y zG&z3I%!+a5nQ5G2($yl6%@bJKvqqlPRG5~YLwecVQA-1WbL`C+6$g6_EffE3{&}{Z z!*NYpgs2bDeK`%Plj**8ICZGWWfnq$xkV6i~`{{7B zF6nm#?Twbflq&EA`>m0$c>47umDLx;|6N4{%(bWa~zj#_F$_c!^+!6^M;qPF}R zgaW+e>kwfRTo)FVd|h6K1_Q=ER8NMWrKP&Xwfr<#X*#my&iW$QF_ezEjEKkkuO z2z{)ONyq-`+r=@k%EWE`zRCv3ecV}en#e;pmlXWsBg}?|mCJ&P3Zu}@b^P%-k=Ox+ zukH)75#2@aBM(*HYCG0g{}h6`e^(L=u9m`k%hy*1t=e9*49w2ZU*t*xPXe?{N{AZaesvE{2Nmzth$d{lADTJOFJEm4sdXlMqnb=0~AEcC{^#A|> delta 2253 zcmZvd3se+U7{|Q>#0YF6u*rK#-7pl1h(u7<{*MhDHDlRJzMdD#& zji!bvBI;4VAt%iQ@!bJ2U;&L>H3Th>VNvM8b^B&!cj2gV-Qj+B~eg>Q(05G5u1@(VTcH}ver3#HVS1L zLT+Qr1}kk0K_xZoEeSVHHqD7MDs9KpAZ|vrTiRF?sUT|{HZYIK#$d2MVs3k#@nTZn3vQnyHncP(8 zXsDSh+)liaz9z@>gMU#oKRf1QI9aV1-@fPe)L@?zwi4(>e z9JNGAWSQgCaOwhMJf5^1c&4fq5g*80a9bswF#9<;vEbaf=zgOuq)tQ>$y^-jKJ^_f z@u?F{fSZev`F2Ly^;t;fFKpKKc8IlbDFebHVE`_+uM-!Px|k z=A@b1>STeKsL6A22>K%U>^EToF{AjBGAxruaoQ(LUF;dsDs@~aR|1da_K{nFlt7t&etd0qJUFpuCI*;o-#RNCe86w1mwSW^l%&muvrlw1px*3kD28{qkNm+ z@~#1Y+CQA~J@9Ord3qzzJ=fa#B=C>)Zp&<7bzj~L&t z@)ASEO8?}QK)GJ~RP9T{;<$y*i_^dLMUp zc{Hia*cz=$h^RR&4eX^rsjoS4x2slV$iHlOG#Mdk`)DUSf|er04WSi0#Ff$>GY}u6 z)9q0U&h%h>E<>m#rF7L?w9}mZD6Q%RE%ZaZoRU_eukvWp(A{CEkBiqwqlN6J(tpLG z49=2DkqM^(H_47FoE}a^7Cg3@cD+u9(y9=m`wCIFPN#gLe$j5dzVx6j&aNKaastKj zStY?m#NEauSQkjC8D>h_T|s_qQgm6L1gnd5yNbfuxZ)~`sKK6aw5J#pl&eluU141j}Ndg>) zie*Dd4>rd8zh+m_9o;%fwkJ8zgSe)!SNO)bmr&I)vMAf1bo>>$;N{6)m;YG{o`mtL z3VhnD%GUUk>EJnp4+Ty)4OsKq9^=z)?$>vNol#21-$vZ4Oplj@-qkPBcx>EK-`5K; zOGJ(g>85L_fK8;N>mH(h?&*>W=F=@tkewZ~{Df4Xq~px7Z3d47ZwcKf#FFgw1zhOf zBJ41G7ML+4FA{6g<^5=FBo@NHmTam$bwa8+4Rd2(b4bl6p)XFmXJD~8VX$Br4VO&G6D{CaYnB4Bak1J10-r|=CsW(pO@F3YDBj9qPHtTs7k z32OzSrOQmJx}ONWBSIWZo@M}nLXDVb9 z$amIx1IRggq$X0i&$X!I;@&Mf;mTwuFBKtCOjojzK;P4oyydfq*Tty}noy!?w>gum zPstyIpEtBJm44{Ai zVZ_-r3nYt5z$$~0vGkU6?j=cqa@qdSE7RtinwW9s*bwji9P?n`g3UZQ%FDv?|Jw%V zHpd6}o5LAbh@kqF6;z0FXS7WA$rWaLLF|9`tDm{AE{KhK%Aubt${?TD8qEEs7O%I! zo^MpzOE>dj)(1h4H})x_E8~Wgs3SG-orbQ%7q|`dy;UdLx($UikTsT%`ng{dklAC- zoV@$?(`%y-clBqKKnG;whX1uxp{tW!+Jx%U)ry#0RG$w2&K$O>PZ3lCQ|*%o&02cm z+3`Oj0r=CGw=X|56heLanY8Vtm2}6U?|;bXDug$#<({|3Y@t&Z2VGr0vH;#o7<%l@ zb-U=iL%K?+&w)TD2tLzL@PX3gK`8b%I)BfcvIy^bKCe z5DCE0CyyuPjx3<>*21kw0Cr!uIZo+w=-rmoJnT?dk8L}4=v4dBQRoTiv_Bs7yn!4_ zIo8*S9U47Kzsuv0@Z?C)+nC1*U+itD_S(aR#<-@U40Cl6vgjjQjUHRnk<@(?y#hFG zwWWMkq=qg`I}+?b4jsK#nScaf-{aTUOl&BjFRV;VYUs4m+vnceRL0Gr4e2Wv4eHK< zf6_DRmcoyr&e>Cic(B*Zd%YQpHCq4Hp(#6Y;+n150XVTd>2WiI64!V9_8Creh3(yk z6RAw=3Y<9kdUhh>!St((W+4GME%TrIjMW-V463DAG^ov15u~-{1^OrA`QvIfi++0; z4lI>~7uZFx$}p2lW7Y)u*FL;M)PSi%1i>$Ih+UjB9jWQ%Uy9MTb#d{qp4ihk)p=KM zeeaVoXO`xRQr0gamH~fYjjYm4FoCO+#M_V^oGr-aZ2D;jT_qOQwl(wZ8$c`B zq_b4a#SdiLA#T!ME#{&D;v4J0=Y%P&=`?V#Gfn{Fl)+Y=0Ij}uD^3EpUsT8RQtQ~= zjez(p3g**IfIRbHofbCoG$20U7$?5qQjqoodIy3px-hv0{j)TS2^UOoj8Q1P#5r znS7si&_*25B&br5FiDzDkr}2=@{LGj^Y$AcUhW;SME>tzKtzNPq9f%xw(3`q!gm5{ zndf!;u<$4vV>swqh@9E<2^C+b-pgdZ9-{Tm< UzG7Q*sr5oPDB91D&8Jepzt5F80K8S7HMb2DoTe61Kl#Vv<3&mVar$e_yKi(%vF&B?jz_ZZctI!5a?vX zV6MB4I|GX-C5zKAwoAMlAJUY~8LShqLC8WR2AytoVHs}fvaoY*55b;$M=%ju9o zMjoyvQW(R{Y>-CRXUnK2<-z!gW{Cd)X~!;C39gecPzO_o8r`n9BP za4o5WzOxfIfSfZtrw&t=XD{0QQ`-@}fJ}bM9_2yI2nZPsGo4~2bemH55X`>UiO0pM z($qmj(^Ho1Tt{}POhmi5sMpM-CsP&|XERCCler?=-0b2~^G5*F5*Eb#Q?QD}WAp;X ztPpnNW1A4IvhS8mCPAyxj7&+eoSQ0oB|z@@F)_+ibV$#{S|Vgi>b>Kgmeq3;Hp^d?=&{>yAW5Fsl`un6M{IG*KO z4@7A2*no=tZ&3#NTcsM)Kd8}VIUA=nwe=8b!>w3^*C(%rBMf}uTmeEha%)g6#QgK_ zH72XhX~%d4;~9+o7%yUsNgFx6$*M~Rl}EodLws{d#M1~j?)>Xso>f+IMa)WEgl?g50AOKV0EfBImT0_mD?p+1Z~81G|zh;cFR zZT#v$OMecm)9{X|qR?8UOCGu#WXp#{b@xmVTBOAm9o->Vl$?qkO2iHYWYn!US(BXQ z!PcxD5YKd4@1uCx)%JBL-rV)cS`=$*4&RP^qt`GNa4B;@UgEIl%$@dyzNr}P$TSz@=pc?hPBq{O_EmD)5pwa9QH;5Bn5+MLm?**1 z0FX8K4kaLq@aAWph+|Y~+j;s$aGdBHmUr<{8^9=8Uz;Y%D`?$Dv39})6m#c2ug(P- zkA=28FhTkX&)#FSoS!NJ3Z<`+ytZ6iSUWPvkJbV=+2llnSd0E4+X-=#bgNhkHxPfJ z9W)ZAux2N4v0J(UaT#G-x`BJH-R2%JJ%_Mm9qGr?BLKfIjB?J{Hn0foK z5VXQT)AVN^3KHk_0ym?l$Eq6f%KMts3@8h21LN(N0lFNyuzVIG+vpOyN zWhP}q>3DdL|IoW<=O&AG;mJRCQA%Nh@^Esi*D=VQW!>*mH9|KqI>WCkqcXsM11z)2 diff --git a/tests/regression/TestAnsysAgainstLegacy.m b/tests/regression/TestAnsysAgainstLegacy.m index d57710a..89c9065 100644 --- a/tests/regression/TestAnsysAgainstLegacy.m +++ b/tests/regression/TestAnsysAgainstLegacy.m @@ -11,7 +11,9 @@ % * the legacy line "ET,IFILE,4" is an invalid command and the new % file writes "ET,3,4"; % * for TEST 101 the legacy file has no constraint lines ("D,..."), - % the new one lists the fixed degrees of freedom. + % the new one lists the fixed degrees of freedom; + % * the new applied-loads section lists the imposed displacements + % ("D,node,direction,value"), the legacy one is empty. % % See also TestSolverAgainstLegacy, ldem.io.exportAnsys. @@ -50,6 +52,10 @@ function ansysFilesMatchLegacy(testCase, caseName) if testId == 101 lines(startsWith(lines, "D,")) = []; end + % The new applied-loads section lists the imposed displacements + % ("D,node,dir,value"); the legacy section is empty. + lines(startsWith(lines, "D,") & count(lines, ",") == 3) = []; + lines(startsWith(lines, "!CARGAS APLICADAS")) = "!CARGAS APLICADAS"; % Trailing empty lines are not significant. while ~isempty(lines) && lines(end) == "" lines(end) = []; diff --git a/tests/regression/TestFixtures.m b/tests/regression/TestFixtures.m index 818397d..35a7bd5 100644 --- a/tests/regression/TestFixtures.m +++ b/tests/regression/TestFixtures.m @@ -5,7 +5,10 @@ % definitions and exercise the interesting branches (damage), so they % are useful as references. Does not run any simulation. % - % See also TestLegacyReproducibility, generateReference. + % The fixtures were generated with the corrected original code (git tag + % legacy-reference); see docs/known-issues/KNOWN_ISSUES.md. + % + % See also referenceCases. properties (TestParameter) caseName = {'tension101_elastic', 'tension101_damage', 'bending102'} diff --git a/tests/regression/TestLegacyReproducibility.m b/tests/regression/TestLegacyReproducibility.m deleted file mode 100644 index 8c98db8..0000000 --- a/tests/regression/TestLegacyReproducibility.m +++ /dev/null @@ -1,63 +0,0 @@ -classdef TestLegacyReproducibility < matlab.unittest.TestCase - %TESTLEGACYREPRODUCIBILITY The frozen legacy code reproduces its fixtures. - % - % The golden-master fixtures in tests/fixtures were generated by - % running legacy/main1.m. This test runs the legacy code again and - % checks that the final state and every output file are identical, so - % it guards two things: the fixtures are valid, and the legacy code - % is deterministic and has not been modified by accident. - % - % Each case starts a child MATLAB process (~15 s), hence the "Slow" tag. - % Run it with: run_tests(IncludeSlow=true) - % - % See also generateReference, referenceCases. - - properties (TestParameter) - caseName = {'tension101_elastic', 'tension101_damage', 'bending102'} - end - - properties - FixtureDir - end - - methods (TestClassSetup) - function addTools(testCase) - testsDir = fileparts(fileparts(mfilename('fullpath'))); - testCase.applyFixture(matlab.unittest.fixtures.PathFixture( ... - fullfile(testsDir, 'tools'))); - testCase.FixtureDir = fullfile(testsDir, 'fixtures'); - end - end - - methods (Test, TestTags = {'Regression', 'Slow'}) - function legacyMatchesFixture(testCase, caseName) - fixture = load(fullfile(testCase.FixtureDir, caseName + ".mat")); - - workDir = testCase.applyFixture( ... - matlab.unittest.fixtures.TemporaryFolderFixture).Folder; - [state, files] = runLegacyCase(fixture.caseDef, workDir); - - % Numerical state: every variable, with a descriptive message. - fields = fieldnames(fixture.state); - testCase.verifyEqual(sort(fieldnames(state)), sort(fields), ... - 'The set of saved state variables changed.'); - for k = 1:numel(fields) - f = fields{k}; - testCase.verifyEqual(state.(f), fixture.state.(f), ... - 'RelTol', 1e-12, 'AbsTol', 1e-14, ... - sprintf('State variable %s differs from the fixture.', f)); - end - - % Text outputs: byte-for-byte. - testCase.verifyEqual(sort(fieldnames(files)), ... - sort(fieldnames(fixture.files)), ... - 'The set of output files changed.'); - outputs = fieldnames(fixture.files); - for k = 1:numel(outputs) - f = outputs{k}; - testCase.verifyEqual(files.(f), fixture.files.(f), ... - sprintf('Output file %s differs from the fixture.', f)); - end - end - end -end diff --git a/tests/regression/TestMaterialAgainstLegacy.m b/tests/regression/TestMaterialAgainstLegacy.m index ea6075e..42dd7bc 100644 --- a/tests/regression/TestMaterialAgainstLegacy.m +++ b/tests/regression/TestMaterialAgainstLegacy.m @@ -10,7 +10,7 @@ % end of the legacy run is still the initial one and it is compared % too. % - % See also TestMeshAgainstLegacy, generateReference. + % See also TestMeshAgainstLegacy. properties (TestParameter) caseName = {'tension101_elastic', 'tension101_damage', 'bending102'} diff --git a/tests/regression/TestMeshAgainstLegacy.m b/tests/regression/TestMeshAgainstLegacy.m index 0c9153e..e6245ca 100644 --- a/tests/regression/TestMeshAgainstLegacy.m +++ b/tests/regression/TestMeshAgainstLegacy.m @@ -3,10 +3,10 @@ % % Compares ldem.mesh.buildMesh with the node coordinates, supports, % masses, connectivity and bar geometry stored in the golden-master - % fixtures (generated by legacy/main1.m). No simulation is run, so the + % fixtures (generated by the original main1.m). No simulation is run, so the % test is fast. % - % See also TestFixtures, generateReference. + % See also TestFixtures. properties (TestParameter) caseName = {'tension101_elastic', 'tension101_damage', 'bending102'} diff --git a/tests/regression/TestSolverAgainstLegacy.m b/tests/regression/TestSolverAgainstLegacy.m index 9a7b969..742ae81 100644 --- a/tests/regression/TestSolverAgainstLegacy.m +++ b/tests/regression/TestSolverAgainstLegacy.m @@ -8,10 +8,9 @@ % damage state, damping switch, energies and the reaction and control % node records of the beam. % - % Not compared, because the legacy value is wrong (see - % legacy/KNOWN_ISSUES.md): the acceleration in y (wrong index), the - % external energy (never computed) and the energy vectors, which are - % compared after summing over the nodes. + % Not compared, because the legacy value is not defined (see + % docs/known-issues/KNOWN_ISSUES.md): the external energy (never computed) and the + % energy vectors, which are compared after summing over the nodes. % % See also TestMeshAgainstLegacy, TestMaterialAgainstLegacy. @@ -33,7 +32,7 @@ function finalStateMatchesLegacy(testCase, caseName) testCase.compare(state.displacement, nodal(s.U(2, :), s.V(2, :), s.W(2, :)), 'displacement'); testCase.compare(state.previousDisplacement, nodal(s.U(1, :), s.V(1, :), s.W(1, :)), 'previous displacement'); testCase.compare(state.velocity, nodal(s.VLX, s.VLY, s.VLZ), 'velocity'); - testCase.compare(state.acceleration(:, [1 3]), [s.ACX(:), s.ACZ(:)], 'acceleration (x and z)'); + testCase.compare(state.acceleration, nodal(s.ACX, s.ACY, s.ACZ), 'acceleration'); testCase.compare(state.force, nodal(s.FRX, s.FRY, s.FRZ), 'nodal force'); end diff --git a/tests/run_tests.m b/tests/run_tests.m index 92fc700..0412280 100644 --- a/tests/run_tests.m +++ b/tests/run_tests.m @@ -5,7 +5,7 @@ % except those tagged "Slow", and throws an error if any test fails. % % results = run_tests(IncludeSlow=true) also runs the slow tests (for -% example the ones that execute the legacy simulations, ~1 minute). +% example the one that builds the complete beam model of the example). % % Outputs: % results matlab.unittest.TestResult array. @@ -15,7 +15,7 @@ % >> run_tests % >> run_tests(IncludeSlow=true) % -% See also matlab.unittest.TestSuite, generateReference. +% See also matlab.unittest.TestSuite. arguments options.IncludeSlow (1,1) logical = false @@ -23,7 +23,6 @@ testsFolder = fileparts(mfilename('fullpath')); addpath(testsFolder); -addpath(fullfile(fileparts(testsFolder), 'legacy')); suite = matlab.unittest.TestSuite.fromFolder(testsFolder, ... 'IncludingSubfolders', true); diff --git a/tests/tools/generateReference.m b/tests/tools/generateReference.m deleted file mode 100644 index 24af3b7..0000000 --- a/tests/tools/generateReference.m +++ /dev/null @@ -1,48 +0,0 @@ -function generateReference(caseNames) -%GENERATEREFERENCE Create the golden-master fixtures from the legacy code. -% -% generateReference() runs every case of referenceCases with the frozen -% legacy driver and stores the result in tests/fixtures/.mat. -% generateReference("bending102") regenerates only the named case(s). -% -% Each fixture contains the variables: -% caseDef The case definition (see referenceCases). -% state Final legacy state, trimmed to the real mesh size. -% files Text of every output file written by the legacy code. -% -% Run this ONLY when the legacy code is intentionally changed; the -% fixtures are the reference that all refactored code is compared with. -% -% See also referenceCases, runLegacyCase, TestGoldenMaster. - -arguments - caseNames (1,:) string = string.empty -end - -cases = referenceCases(); -if ~isempty(caseNames) - cases = cases(ismember({cases.name}, caseNames)); - if isempty(cases) - error('ldem:tools:unknownCase', 'No reference case matches the given names.'); - end -end - -fixtureDir = fullfile(fileparts(fileparts(mfilename('fullpath'))), 'fixtures'); -if ~isfolder(fixtureDir) - mkdir(fixtureDir); -end - -for k = 1:numel(cases) - caseDef = cases(k); - fprintf('Running legacy case "%s" ... ', caseDef.name); - workDir = tempname; - mkdir(workDir); - cleaner = onCleanup(@() rmdir(workDir, 's')); - timer = tic; - [state, files] = runLegacyCase(caseDef, workDir); - save(fullfile(fixtureDir, caseDef.name + ".mat"), 'caseDef', 'state', 'files'); - fprintf('done in %.1f s (%d nodes, %d bars, %d damaged bars).\n', ... - toc(timer), state.NNT, state.NBT, nnz(~state.DM)); - clear cleaner -end -end diff --git a/tests/tools/referenceCases.m b/tests/tools/referenceCases.m index 4fa0873..e090066 100644 --- a/tests/tools/referenceCases.m +++ b/tests/tools/referenceCases.m @@ -20,7 +20,10 @@ % % The remaining material and numerical parameters are shared (see below). % -% See also generateReference, runLegacyCase, writeDataFile. +% The golden-master fixtures in tests/fixtures were produced by running +% these cases with the corrected original code (git tag legacy-reference). +% +% See also writeDataFile. shared = struct( ... 'seed', 123, ... diff --git a/tests/tools/runLegacyCase.m b/tests/tools/runLegacyCase.m deleted file mode 100644 index ac744d8..0000000 --- a/tests/tools/runLegacyCase.m +++ /dev/null @@ -1,97 +0,0 @@ -function [state, files] = runLegacyCase(c, workDir) -%RUNLEGACYCASE Run the frozen legacy driver for one case in a child MATLAB. -% -% [state, files] = runLegacyCase(c, workDir) executes legacy/main1.m with -% the input described by case c, inside the (empty) folder workDir. -% -% The legacy driver starts with "clear all" and keeps everything in global -% variables, so it cannot be called from inside a running test. It is -% therefore executed in a separate "matlab -batch" process whose final -% workspace is saved and read back. -% -% Inputs: -% c Case struct, see referenceCases. -% workDir Existing folder where the simulation runs and writes output. -% -% Outputs: -% state Struct with the final legacy state, trimmed to the real mesh -% size (the legacy code preallocates INT=168000 nodes and -% INB=2300000 bars). Node arrays are 1-by-NNT, bar arrays -% 1-by-NBT, CN is 1-by-2*NBT. Scalars are kept unchanged. -% files Struct with the text of every output file, keyed by a valid -% field name (dots replaced by underscores). -% -% See also referenceCases, generateReference. - -root = fileparts(fileparts(fileparts(mfilename('fullpath')))); -legacyDir = fullfile(root, 'legacy'); -exampleDir = fullfile(root, 'examples', 'beam_102'); - -writeDataFile(fullfile(workDir, 'DATA0.DAT'), c); -copyfile(fullfile(exampleDir, 'LET.AN1'), workDir); -copyfile(fullfile(exampleDir, 'arquivo_3lc_rnao_cv05'), workDir); - -batchCmd = sprintf('addpath(''%s''); main1; save(''final_state.mat'');', legacyDir); -matlabExe = fullfile(matlabroot, 'bin', 'matlab'); -logFile = fullfile(workDir, 'legacy_run.log'); -cmd = sprintf('"%s" -batch "%s" > "%s" 2>&1', matlabExe, batchCmd, logFile); - -oldFolder = cd(workDir); -folderRestore = onCleanup(@() cd(oldFolder)); -status = system(cmd); -if status ~= 0 || ~isfile(fullfile(workDir, 'final_state.mat')) - error('ldem:tools:legacyRunFailed', ... - 'Legacy run of case "%s" failed (exit %d). See %s.', c.name, status, logFile); -end - -raw = load(fullfile(workDir, 'final_state.mat')); -state = trimLegacyState(raw); -files = collectTextFiles(workDir); -end - -function state = trimLegacyState(raw) -%TRIMLEGACYSTATE Cut the preallocated legacy arrays down to the real mesh. -nNodes = raw.NNT; -nBars = raw.NBT; -keep = {'U','V','W','U0','V0','W0','BDX','BDY','BDZ','VLX','VLY','VLZ', ... - 'ACX','ACY','ACZ','FRX','FRY','FRZ','FX','FY','FZ','MAS','MSS', ... - 'CN','XB','YB','ZB','UBAR','VBAR','WBAR', ... - 'LI','E1','E2','EP','EM','KR','SS','DSS','F','DM','FS','DEQB', ... - 'EDG','ENR','YNGB','GFRB','LCRB','EPRB','EN', ... - 'TIME','STEP','NSTEP','NNT','NBT','M','N','L','LCO','DT', ... - 'ENEX','ENCN','ENEL','ENGD','ENDP','ENIN','DEN','DERIV', ... - 'REACAOX','REACAOY','REACAOZ','EPMAX','EPMIN','MEAN','COEV'}; -state = struct(); -for k = 1:numel(keep) - name = keep{k}; - if ~isfield(raw, name) - continue - end - value = raw.(name); - if isnumeric(value) || islogical(value) - nCols = size(value, 2); - if nCols == raw.INT - value = value(:, 1:nNodes); - elseif nCols == raw.INB - value = value(:, 1:nBars); - elseif nCols == 2 * raw.INB - value = value(:, 1:2*nBars); - end - end - state.(name) = value; -end -end - -function files = collectTextFiles(workDir) -%COLLECTTEXTFILES Read every generated output file into a struct of strings. -files = struct(); -listing = dir(workDir); -skip = {'DATA0.DAT','LET.AN1','arquivo_3lc_rnao_cv05','final_state.mat','legacy_run.log'}; -for k = 1:numel(listing) - if listing(k).isdir || any(strcmp(listing(k).name, skip)) - continue - end - field = matlab.lang.makeValidName(listing(k).name); - files.(field) = fileread(fullfile(workDir, listing(k).name)); -end -end diff --git a/tests/tools/writeDataFile.m b/tests/tools/writeDataFile.m index d31a4ee..6c198c4 100644 --- a/tests/tools/writeDataFile.m +++ b/tests/tools/writeDataFile.m @@ -1,15 +1,15 @@ function writeDataFile(path, c) -%WRITEDATAFILE Write a legacy DATA0.DAT input file from a case definition. +%WRITEDATAFILE Write a DATA0.DAT input file from a case definition. % -% writeDataFile(path, c) creates the input file read by the legacy routine -% READ_DAT0. Only the first token of each line is read by the legacy code; -% the quoted label after it is a comment for humans. +% writeDataFile(path, c) creates an input file in the format of the original +% program, which ldem.io.readInputFile reads. Only the first token of each +% line is read; the quoted label after it is a comment for humans. % % Inputs: % path Full path of the file to create. % c Case struct, see referenceCases. % -% See also referenceCases, runLegacyCase. +% See also referenceCases. fid = fopen(path, 'w'); if fid == -1 diff --git a/tests/unit/TestEnergies.m b/tests/unit/TestEnergies.m index 9fc139a..740d31e 100644 --- a/tests/unit/TestEnergies.m +++ b/tests/unit/TestEnergies.m @@ -19,7 +19,8 @@ function everythingIsZeroAtRest(testCase) [mesh, barProps, ~, state, params] = testCase.oneBar(); e = ldem.solver.computeEnergies(state, mesh, barProps, params); - for name = {'kinetic', 'elastic', 'damage', 'damping', 'internal', 'brokenBars', 'damageRate'} + for name = {'kinetic', 'elastic', 'damage', 'damping', 'internal', 'brokenBars', ... + 'damageRate', 'external', 'balance'} testCase.verifyEqual(e.(name{1}), 0, name{1}); end end @@ -84,6 +85,24 @@ function internalEnergyIsTheSumOfItsParts(testCase) testCase.verifyEqual(e.damping, 0.25); end + function nodalKineticEnergyAddsUpToTheTotal(testCase) + [mesh, barProps, ~, state, params] = testCase.oneBar(); + state.velocity = [3 4 0; 0 0 2]; + perNode = ldem.solver.nodalKineticEnergy(state, mesh); + testCase.verifyEqual(perNode, [0.5 * 2 * 25; 0.5 * 3 * 4], 'RelTol', 1e-14); + e = ldem.solver.computeEnergies(state, mesh, barProps, params); + testCase.verifyEqual(sum(perNode), e.kinetic, 'RelTol', 1e-14); + end + + function balanceIsExternalMinusInternal(testCase) + [mesh, barProps, ~, state, params] = testCase.oneBar(); + state.strain = 5e-4; + state.externalEnergy = 1e-3; + e = ldem.solver.computeEnergies(state, mesh, barProps, params); + testCase.verifyEqual(e.external, 1e-3); + testCase.verifyEqual(e.balance, 1e-3 - e.internal, 'RelTol', 1e-14); + end + function damageRateUsesThePreviousStep(testCase) [mesh, barProps, ~, state, params] = testCase.oneBar(); state.strain = 2e-3; diff --git a/tests/unit/TestExporters.m b/tests/unit/TestExporters.m index 63bf137..e53ac05 100644 --- a/tests/unit/TestExporters.m +++ b/tests/unit/TestExporters.m @@ -60,11 +60,40 @@ function ansysConstraintsListTheFixedDofs(testCase) path = fullfile(testCase.tempFolder(), "state.mac"); ldem.io.exportAnsys(path, testCase.Mesh, testCase.State); lines = splitlines(string(fileread(path))); - constraints = lines(startsWith(lines, "D,")); + constraints = lines(startsWith(lines, "D,") & count(lines, ",") == 2); testCase.verifyEqual(numel(constraints), nnz(testCase.Mesh.fixed)); testCase.verifyTrue(all(endsWith(constraints, "UX")), 'Tension fixes x only.'); end + function ansysAppliedLoadsAreTheImposedDisplacements(testCase) + path = fullfile(testCase.tempFolder(), "state.mac"); + ldem.io.exportAnsys(path, testCase.Mesh, testCase.State); + lines = splitlines(string(fileread(path))); + loads = lines(startsWith(lines, "D,") & count(lines, ",") == 3); + + imposed = testCase.State.displacement - testCase.Mesh.nodes0; + imposed(~testCase.Mesh.fixed) = 0; + testCase.verifyEqual(numel(loads), nnz(imposed)); + testCase.verifyNotEmpty(loads, 'The loaded nodes have moved by the end of the run.'); + for k = 1:numel(loads) + parts = split(loads(k), ","); + node = str2double(parts(2)); + direction = find(["UX" "UY" "UZ"] == parts(3)); + testCase.verifyTrue(testCase.Mesh.fixed(node, direction), ... + 'Only held degrees of freedom receive an imposed displacement.'); + testCase.verifyEqual(str2double(parts(4)), imposed(node, direction), 'RelTol', 1e-5); + end + end + + function ansysHasNoImposedDisplacementAtTimeZero(testCase) + path = fullfile(testCase.tempFolder(), "initial.mac"); + state = testCase.State; + state.displacement = testCase.Mesh.nodes0; + ldem.io.exportAnsys(path, testCase.Mesh, state); + lines = splitlines(string(fileread(path))); + testCase.verifyFalse(any(startsWith(lines, "D,") & count(lines, ",") == 3)); + end + function ansysCoordinatesAreTheCurrentPositions(testCase) path = fullfile(testCase.tempFolder(), "state.mac"); ldem.io.exportAnsys(path, testCase.Mesh, testCase.State); diff --git a/tests/unit/TestParameters.m b/tests/unit/TestParameters.m index 61b1f2a..ea77e03 100644 --- a/tests/unit/TestParameters.m +++ b/tests/unit/TestParameters.m @@ -86,10 +86,11 @@ function outputSettingsAreChecked(testCase) testCase.verifyError(@() ldem.Parameters(output=tooOften), 'ldem:params:badOutput'); end - function meshPerturbationIsChecked(testCase) - testCase.verifyError( ... - @() ldem.Parameters(meshPerturbation=struct('enabled', true)), ... - 'ldem:params:badMeshPerturbation'); + function meshPerturbationIsOffByDefaultAndMustBeNonNegative(testCase) + testCase.verifyEqual(ldem.Parameters().meshPerturbation, 0); + testCase.verifyEqual(ldem.Parameters(meshPerturbation=0.05).meshPerturbation, 0.05); + testCase.verifyError(@() ldem.Parameters(meshPerturbation=-0.1), ?MException); + testCase.verifyError(@() ldem.Parameters(meshPerturbation=Inf), ?MException); end function valueSemantics(testCase) diff --git a/tests/unit/TestPerturbNodes.m b/tests/unit/TestPerturbNodes.m index 5e743de..b723393 100644 --- a/tests/unit/TestPerturbNodes.m +++ b/tests/unit/TestPerturbNodes.m @@ -54,12 +54,27 @@ function displacementsHaveTheRequestedScale(testCase) function enabledThroughParametersChangesTheMesh(testCase) base = ldem.Parameters(nModules=testCase.Sizes); - perturbed = ldem.Parameters(nModules=testCase.Sizes, ... - meshPerturbation=struct('enabled', true, 'cv', 0.02)); + perturbed = ldem.Parameters(nModules=testCase.Sizes, meshPerturbation=0.02); a = ldem.mesh.buildMesh(base); b = ldem.mesh.buildMesh(perturbed); testCase.verifyNotEqual(a.nodes0, b.nodes0); testCase.verifyEqual(a.bars, b.bars, 'Connectivity must not change.'); end + + function zeroKeepsTheRegularLattice(testCase) + p = ldem.Parameters(nModules=testCase.Sizes, meshPerturbation=0); + mesh = ldem.mesh.buildMesh(p); + testCase.verifyEqual(mesh.nodes0, ... + ldem.mesh.buildNodes(testCase.Sizes, p.moduleLength)); + end + + function theValueIsTheScaleOfTheDisplacement(testCase) + small = ldem.mesh.buildMesh(ldem.Parameters(nModules=testCase.Sizes, meshPerturbation=0.01)); + large = ldem.mesh.buildMesh(ldem.Parameters(nModules=testCase.Sizes, meshPerturbation=0.04)); + regular = ldem.mesh.buildNodes(testCase.Sizes, 1); + regular = regular * ldem.Parameters().moduleLength; + testCase.verifyEqual(norm(large.nodes0 - regular), ... + 4 * norm(small.nodes0 - regular), 'RelTol', 1e-9); + end end end diff --git a/tests/unit/TestRunSimulation.m b/tests/unit/TestRunSimulation.m index fd99e95..eb9e410 100644 --- a/tests/unit/TestRunSimulation.m +++ b/tests/unit/TestRunSimulation.m @@ -40,6 +40,44 @@ function resultsContainNoObjectsSoTheyLoadWithoutThePackage(testCase) 'results must not hold ldem class instances.'); end + function nodalKineticEnergyIsStoredAndAddsUpToTheTotal(testCase) + results = ldem.runSimulation(testCase.quickParams()); + nNodes = size(results.mesh.nodes0, 1); + + testCase.verifySize(results.final.kineticEnergy, [nNodes 1]); + testCase.verifyEqual(sum(results.final.kineticEnergy), results.energy.kinetic(end), 'RelTol', 1e-12); + + snapshots = results.snapshots; + testCase.verifySize(snapshots.kineticEnergy, [5 1]); + testCase.verifyClass(snapshots.kineticEnergy{end}, 'single'); + testCase.verifyEqual(double(sum(snapshots.kineticEnergy{end})), results.energy.kinetic(end), 'RelTol', 1e-5); + testCase.verifyEqual(sum(snapshots.kineticEnergy{1}), single(0), 'At time zero nothing moves.'); + end + + function resultsDescribeTheModelAndTheMaterial(testCase) + params = testCase.quickParams(); + results = ldem.runSimulation(params); + m = results.model; + nBars = size(results.mesh.bars, 1); + + testCase.verifyEqual(m.nNodes, params.nNodes); + testCase.verifyEqual(m.nModules, [3 2 2]); + testCase.verifyEqual(m.nGridEdges + m.nCentreBars + m.nDiagonals, nBars); + testCase.verifyEqual(m.nGridNodes + m.nCentreNodes, m.nNodes); + testCase.verifyEqual(m.totalMass, params.density * m.prismVolume, 'RelTol', 1e-12); + + mat = results.material; + testCase.verifyEqual(mat.youngModulus, params.youngModulus); + testCase.verifyEqual(mat.alpha, 0.4, 'RelTol', 1e-12); + testCase.verifyEqual(mat.delta, 1.125, 'RelTol', 1e-12); + testCase.verifyEqual(mat.criticalStrainMean, results.barProps.criticalStrainMean); + testCase.verifyEqual(mat.criticalStrainCv, results.barProps.criticalStrainCv); + % With no random field all the strains are equal; allow for rounding of the mean. + testCase.verifyLessThanOrEqual(mat.criticalStrainMin, mat.criticalStrainMean * (1 + 1e-12)); + testCase.verifyGreaterThanOrEqual(mat.criticalStrainMax, mat.criticalStrainMean * (1 - 1e-12)); + testCase.verifyEqual(mat.ruptureRatioNormal, mat.criticalLength / params.moduleLength, 'RelTol', 1e-14); + end + function energyPartsAddUp(testCase) results = ldem.runSimulation(testCase.quickParams()); e = results.energy; @@ -137,12 +175,12 @@ function aRunFromAnInputFileMatchesTheEquivalentParameters(testCase) testCase.verifyEqual(fromFile.energy.kinetic, direct.energy.kinetic); end - function plotEnergyDrawsFiveCurves(testCase) + function plotEnergyDrawsSixCurves(testCase) results = ldem.runSimulation(testCase.quickParams()); fig = figure('Visible', 'off'); testCase.addTeardown(@close, fig); ax = ldem.post.plotEnergy(results, axes(fig)); - testCase.verifyEqual(numel(ax.Children), 5); + testCase.verifyEqual(numel(ax.Children), 6); testCase.verifyEqual(ax.XLabel.String, 'Time [s]'); end diff --git a/tests/unit/TestScenarios.m b/tests/unit/TestScenarios.m index f5428c9..721d63f 100644 --- a/tests/unit/TestScenarios.m +++ b/tests/unit/TestScenarios.m @@ -20,17 +20,23 @@ function everyScenarioIsRegisteredUnderItsOwnId(testCase) end end - function tensionFixesOnlyXOfTheLeftEndCentres(testCase) + function tensionHoldsTheCentreNodesOfBothEndColumnsInX(testCase) params = ldem.Parameters(testId=101, nModules=[6 3 3]); nodes = ldem.mesh.buildNodes(params.nModules, params.moduleLength); - fixed = ldem.scenarios.UniaxialTension().fixedDofs(nodes, params); + scenario = ldem.scenarios.UniaxialTension(); + fixed = scenario.fixedDofs(nodes, params); + loaded = scenario.loadedNodes(nodes, params); testCase.verifySize(fixed, [params.nNodes 3]); testCase.verifyFalse(any(fixed(:, 2:3), 'all'), 'Only x may be fixed.'); - % Centre nodes of the first module column: (N-1)*(L-1) = 4 nodes. - testCase.verifyEqual(nnz(fixed(:, 1)), 4); - testCase.verifyEqual(max(nodes(fixed(:, 1), 1)), 0.5 * params.moduleLength, ... - 'RelTol', 1e-12); + % Centre nodes of the first and of the last column of modules: + % 2 columns of (N-1)*(L-1) = 4 nodes. + testCase.verifyEqual(nnz(fixed(:, 1)), 8); + lco = params.moduleLength; + testCase.verifyEqual(unique(round(nodes(fixed(:, 1), 1) / lco * 2) / 2).', [0.5, 4.5]); + % The loaded nodes are the right column, and they are held (exact prescribed motion). + testCase.verifyEqual(nnz(loaded), 4); + testCase.verifyTrue(all(fixed(loaded, 1))); end function bendingFixesYAtEverySupportAndLoadPoint(testCase) @@ -45,6 +51,50 @@ function bendingFixesYAtEverySupportAndLoadPoint(testCase) testCase.verifyGreaterThan(nnz(fixed(:, 2)), nnz(fixed(:, 1))); end + function bendingLoadsBothPointsOnTheTopFace(testCase) + params = ldem.Parameters(testId=102, nModules=[70 4 3]); + nodes = ldem.mesh.buildNodes(params.nModules, params.moduleLength); + scenario = ldem.scenarios.FourPointBending(); + loaded = scenario.loadedNodes(nodes, params); + lco = params.moduleLength; + + % Two lines of (L-1) centre nodes, at 33.5 modules from each end. + testCase.verifyEqual(nnz(loaded), 2 * (params.nModules(3) - 1)); + testCase.verifyEqual(unique(round(nodes(loaded, 1) / lco * 2) / 2).', [33.5, 35.5]); + testCase.verifyEqual(unique(round(nodes(loaded, 2) / lco * 2) / 2).', 2.5); + fixed = scenario.fixedDofs(nodes, params); + testCase.verifyTrue(all(fixed(loaded, 2)), 'Loaded nodes must be held in y.'); + end + + function bendingPositionsAreParameters(testCase) + % A short beam with supports and load points placed by the user. + params = ldem.Parameters(testId=102, nModules=[30 4 3]); + nodes = ldem.mesh.buildNodes(params.nModules, params.moduleLength); + scenario = ldem.scenarios.FourPointBending(supportPosition=2.5, loadPosition=10.5); + lco = params.moduleLength; + + loaded = scenario.loadedNodes(nodes, params); + testCase.verifyEqual(unique(round(nodes(loaded, 1) / lco * 2) / 2).', [10.5, 18.5]); + fixed = scenario.fixedDofs(nodes, params); + testCase.verifyEqual(unique(round(nodes(fixed(:, 1), 1) / lco * 2) / 2).', 2.5); + testCase.verifyEqual(scenario.supportPosition, 2.5); + testCase.verifyEqual(ldem.scenarios.FourPointBending().supportPosition, 4.5, ... + 'The defaults must be the legacy values.'); + end + + function bendingReportsPositionsThatMatchNoNode(testCase) + % The default positions need a beam longer than about 70 modules. + params = ldem.Parameters(testId=102, nModules=[30 4 3]); + nodes = ldem.mesh.buildNodes(params.nModules, params.moduleLength); + testCase.verifyError( ... + @() ldem.scenarios.FourPointBending().fixedDofs(nodes, params), ... + 'ldem:scenarios:noNodesSelected'); + % Positions that fall between two lines of centre nodes. + scenario = ldem.scenarios.FourPointBending(supportPosition=2.0, loadPosition=10.5); + testCase.verifyError(@() scenario.fixedDofs(nodes, params), ... + 'ldem:scenarios:noNodesSelected'); + end + function stabilityCheckReturnsCriticalStep(testCase) params = ldem.Parameters(); lengths = [0.003; 0.0026; 0.003]; diff --git a/tests/unit/TestSimulate.m b/tests/unit/TestSimulate.m index 65c1452..ae36eee 100644 --- a/tests/unit/TestSimulate.m +++ b/tests/unit/TestSimulate.m @@ -37,14 +37,14 @@ function loadingVelocityCanBeChanged(testCase) testCase.verifyGreaterThan(min(state.displacement(loaded, 1) - mesh.nodes0(loaded, 1)), 0); end - function bendingLoadMovesOnlyTheRightLoadPoint(testCase) + function bendingLoadMovesBothLoadPoints(testCase) [params, mesh, ~, history, scenario] = testCase.smallModel(testId=102, nModules=[70 4 3]); state = ldem.solver.initialState(mesh, history); state.time = 1e-4; state = scenario.applyLoads(state, mesh, params); loaded = scenario.loadedNodes(mesh.nodes0, params); - testCase.verifyEqual(nnz(loaded), params.nModules(3) - 1); + testCase.verifyEqual(nnz(loaded), 2 * (params.nModules(3) - 1)); testCase.verifyEqual(state.displacement(loaded, 2), ... mesh.nodes0(loaded, 2) - 400e-5 * 1e-4, 'RelTol', 1e-14); testCase.verifyTrue(all(mesh.fixed(loaded, 2)), 'Loaded nodes must be held in y.'); @@ -193,6 +193,33 @@ function bendingScenarioAcceptsALoadingVelocity(testCase) testCase.verifyEqual(ldem.scenarios.FourPointBending().loadingVelocity, 400e-5); end + function energyBalanceClosesInTheBeamTest(testCase) + % The load acts on held degrees of freedom, so external work equals + % the stored plus dissipated energy. + params = ldem.Parameters(testId=102, nModules=[70 4 3], totalTime=6e-5, ... + output=struct('snapshotEvery', 0, 'controlNodesEvery', 0, ... + 'energyEvery', 10, 'trackedBarEvery', 0)); + results = ldem.runSimulation(params); + e = results.energy; + testCase.verifyGreaterThan(e.external(end), 0); + testCase.verifyEqual(e.internal(end), e.external(end), 'RelTol', 1e-2); + testCase.verifyLessThan(max(abs(e.balance)) / e.external(end), 1e-2); + end + + function energyBalanceClosesInTensionWithSofteningAndRupture(testCase) + % With softening and rupture: the dissipated energy is accounted too. + params = ldem.Parameters(nModules=[6 3 3], totalTime=2e-4, fractureEnergy=0.1, ... + output=struct('snapshotEvery', 0, 'controlNodesEvery', 0, ... + 'energyEvery', 10, 'trackedBarEvery', 0)); + results = ldem.runSimulation(params); + e = results.energy; + + testCase.verifyGreaterThan(nnz(~results.final.damage.isUndamaged), 0, 'The test needs damage.'); + testCase.verifyGreaterThan(e.damage(end), 0); + testCase.verifyEqual(e.internal(end), e.external(end), 'RelTol', 1e-2); + testCase.verifyLessThan(max(abs(e.balance)) / e.external(end), 1e-2); + end + function verboseModePrintsProgress(testCase) [params, mesh, barProps, history, scenario] = testCase.smallModel(nModules=[3 3 3], totalTime=2e-6); %#ok text = evalc('ldem.solver.simulate(params, mesh, barProps, history, scenario, Verbose=true);'); diff --git a/tests/unit/TestSolver.m b/tests/unit/TestSolver.m index 7770ec9..a680b09 100644 --- a/tests/unit/TestSolver.m +++ b/tests/unit/TestSolver.m @@ -138,6 +138,39 @@ function fixedDofsDoNotMove(testCase) testCase.verifyEqual(last.displacement(2, 2:3), [0 0]); end + function movingSupportBalancesTheEnergy(testCase) + % Node 1 is held but moves with constant velocity (prescribed motion); + % node 2 is free. The work done at node 1 must equal the energy stored. + params = ldem.Parameters(dt=2e-7, dampingInitial=0, dampingFinal=0); + [mesh, barProps, history] = testCase.oscillator(); + mesh.fixed(1, :) = true; + % The kinetic energy of a prescribed node is not supplied by the work + % of the bar force, so make it negligible (a real lattice has the same + % property: the prescribed nodes are a tiny part of the mass). + mesh.mass(1) = 1e-12; + state = ldem.solver.initialState(mesh, history); + velocity = 1e-3; % [m/s] + + nSteps = 3000; + for n = 1:nSteps + state.step = n; + state.time = state.time + params.dt; + state.displacement(1, 1) = velocity * state.time; % prescribed + state = ldem.solver.computeBarForces(state, mesh, barProps, params); + state = ldem.solver.integrateStep(state, mesh, barProps, params); + end + e = ldem.solver.computeEnergies(state, mesh, barProps, params); + + testCase.verifyGreaterThan(e.external, 0, 'Pushing the structure is positive work.'); + testCase.verifyEqual(e.internal, e.external, 'RelTol', 5e-3); + testCase.verifyEqual(e.balance, e.external - e.internal); + end + + function aSupportThatDoesNotMoveDoesNoWork(testCase) + [~, states, ~] = testCase.runOscillator(1000, 500); + testCase.verifyEqual(states{end}.externalEnergy, 0); + end + function integrateRejectsZeroMass(testCase) params = ldem.Parameters(); [mesh, barProps, history] = testCase.oscillator(); From 13090e3be09606a0bbdbea876e787a119bb39b5c Mon Sep 17 00:00:00 2001 From: Boris Rojo Tanzi <71112604+borisrojotanzi@users.noreply.github.com> Date: Fri, 6 Nov 2026 00:57:24 -0300 Subject: [PATCH 07/13] feat: add example 1, the bi-clamped beam, with force-controlled loading --- CHANGELOG.md | 7 + README.md | 3 + docs/source/api/index.rst | 1 + docs/source/en/usage.rst | 5 + docs/source/es/uso.rst | 5 + examples/README.md | 27 ++++ examples/example1_clamped_beam/DATA0.DAT | 28 ++++ .../example1_clamped_beam/runClampedBeam.m | 71 ++++++++++ src/+ldem/+scenarios/ClampedBeam.m | 133 ++++++++++++++++++ src/+ldem/+scenarios/Scenario.m | 5 + src/+ldem/+scenarios/fromTestId.m | 4 +- src/+ldem/+solver/initialState.m | 6 +- src/+ldem/+solver/integrateStep.m | 19 ++- tests/fixtures/README.md | 6 + tests/fixtures/clamped103.mat | Bin 0 -> 591549 bytes .../regression/TestClampedBeamAgainstLegacy.m | 127 +++++++++++++++++ tests/unit/TestExamples.m | 32 ++++- tests/unit/TestScenarios.m | 70 ++++++++- tests/unit/TestSimulate.m | 21 +++ tests/unit/TestSolver.m | 40 ++++++ 20 files changed, 601 insertions(+), 9 deletions(-) create mode 100644 examples/example1_clamped_beam/DATA0.DAT create mode 100644 examples/example1_clamped_beam/runClampedBeam.m create mode 100644 src/+ldem/+scenarios/ClampedBeam.m create mode 100644 tests/fixtures/clamped103.mat create mode 100644 tests/regression/TestClampedBeamAgainstLegacy.m diff --git a/CHANGELOG.md b/CHANGELOG.md index 266a3af..849f2bd 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -52,6 +52,13 @@ test are parameters (the legacy values are the defaults); an error is raised when a position matches no node. - Spanish translation of the known issues: `docs/known-issues/KNOWN_ISSUES.es.md`. +- Example 1, `examples/example1_clamped_beam`: the beam clamped at both ends and + loaded with a force at mid-span, by Rodrigo (branch `dev_rodrigo`). It adds + `ldem.scenarios.ClampedBeam` (test 103), the first scenario loaded with a force: + a scenario can now set `state.appliedForce`, which the solver adds to the bar + forces and whose work is counted in the external energy. The new code + reproduces the original routines of the branch with no difference + (`tests/regression/TestClampedBeamAgainstLegacy`). - ANSYS files list the displacement imposed on the loaded nodes (`D,node,direction,value`) in the applied-loads section. - `Parameters.meshPerturbation`: one number that switches the mesh perturbation diff --git a/README.md b/README.md index 4d6caf7..5bdc2d2 100644 --- a/README.md +++ b/README.md @@ -26,6 +26,7 @@ quasi-brittle materials (concrete, rocks). ```matlab >> setup_path % adds src/ to the MATLAB path >> run('examples/tension_101/runTension.m') % small example, output in examples/tension_101/output +>> run('examples/example1_clamped_beam/runClampedBeam.m') % beam clamped at both ends ``` Run the tests: @@ -78,6 +79,7 @@ quase-frágeis (concreto, rochas). ```matlab >> setup_path % adiciona src/ ao path do MATLAB >> run('examples/tension_101/runTension.m') % exemplo pequeno, saída em examples/tension_101/output +>> run('examples/example1_clamped_beam/runClampedBeam.m') % viga biengastada ``` Executar os testes: @@ -128,6 +130,7 @@ cuasi-frágiles (hormigón, rocas). ```matlab >> setup_path % agrega src/ al path de MATLAB >> run('examples/tension_101/runTension.m') % ejemplo pequeño, salida en examples/tension_101/output +>> run('examples/example1_clamped_beam/runClampedBeam.m') % viga empotrada en ambos extremos ``` Ejecutar los tests: diff --git a/docs/source/api/index.rst b/docs/source/api/index.rst index 04ac3e8..22c9eed 100644 --- a/docs/source/api/index.rst +++ b/docs/source/api/index.rst @@ -67,6 +67,7 @@ Scenarios / Escenarios de ensayo .. mat:autoclass:: ldem.scenarios.Scenario .. mat:autoclass:: ldem.scenarios.UniaxialTension .. mat:autoclass:: ldem.scenarios.FourPointBending +.. mat:autoclass:: ldem.scenarios.ClampedBeam .. mat:autofunction:: ldem.scenarios.fromTestId Solver diff --git a/docs/source/en/usage.rst b/docs/source/en/usage.rst index 9a68a0d..6bcf5ab 100644 --- a/docs/source/en/usage.rst +++ b/docs/source/en/usage.rst @@ -36,6 +36,11 @@ Tests available ``ldem.scenarios.FourPointBending`` (``supportPosition``, ``loadPosition``, in modules from each end); the defaults need a beam longer than about 70 modules. See ``examples/beam_102``. +``testId = 103`` + Beam clamped at both ends, loaded at mid-span with a force that grows + linearly and then stays constant (``ldem.scenarios.ClampedBeam``). It is the + only test loaded with a force instead of a displacement. See + ``examples/example1_clamped_beam``. To add a new test, create a subclass of ``ldem.scenarios.Scenario``. diff --git a/docs/source/es/uso.rst b/docs/source/es/uso.rst index 199c095..aef0c44 100644 --- a/docs/source/es/uso.rst +++ b/docs/source/es/uso.rst @@ -36,6 +36,11 @@ Ensayos disponibles ``ldem.scenarios.FourPointBending`` (``supportPosition``, ``loadPosition``, en módulos desde cada extremo); los valores por defecto requieren una viga de más de unos 70 módulos. Ver ``examples/beam_102``. +``testId = 103`` + Viga empotrada en los dos extremos, cargada a media luz con una fuerza que + crece linealmente y luego se mantiene constante + (``ldem.scenarios.ClampedBeam``). Es el único ensayo cargado con una fuerza + en lugar de un desplazamiento. Ver ``examples/example1_clamped_beam``. Para agregar un ensayo nuevo se crea una subclase de ``ldem.scenarios.Scenario``. diff --git a/examples/README.md b/examples/README.md index 949bc55..e3fa5b0 100644 --- a/examples/README.md +++ b/examples/README.md @@ -4,6 +4,7 @@ |--------|---------------|------| | `tension_101/` | Small prism under uniaxial load, all output formats, energy plot | seconds | | `beam_102/` | The 101x41x21-module beam read from `DATA0.DAT` | ~20 s for 50 steps; ~20 h for the full run | +| `example1_clamped_beam/` | Beam clamped at both ends and loaded with a force at mid-span (model by Rodrigo) | see below | Run an example from MATLAB, from any folder: @@ -25,3 +26,29 @@ Outputs are written to an `output/` folder next to the script (ignored by git): |------|---------| | `DATA0.DAT` | Simulation parameters (format of the original program, read by `ldem.Parameters.fromFile`) | | `arquivo_3lc_rnao_cv05` | Random field applied to the critical strain of each bar (11 MB) | + +## example1_clamped_beam + +A beam of 5 x 5 x 50 modules (1 mm each) clamped at both ends and loaded at +mid-span with a force, by Rodrigo (branch `dev_rodrigo`). It runs the 8000 steps +(2.8 ms) of the original model in about one minute. + +| File | Purpose | +|------|---------| +| `runClampedBeam.m` | Reads `DATA0.DAT`, runs the simulation, plots the force on the clamped ends, the vertical displacement of the control nodes and the energies | +| `DATA0.DAT` | Parameters of the model (`TEST 103`, see `ldem.scenarios.ClampedBeam`) | + +The random field of the critical strain is shared with `beam_102`. + +How the model maps to the input file and the scenario: + +- The centre nodes of the first and of the last layer of modules are clamped. +- A line of centre nodes at mid-span (z = 24.5 modules, y = 0.5 modules) carries a + force in +y that grows as `forceRate * t` (1000 N/s per node) up to `rampTime` + (0.35 ms) and then stays constant. Change them with + `ldem.scenarios.ClampedBeam(forceRate=..., rampTime=...)`. +- Control nodes: the original file listed five, but nodes 6870 and 14398 do not + exist in this 3086-node mesh, so `DATA0.DAT` keeps nodes 2441 (a loaded node) + and 884 (a grid node at mid-span). The tracked bar is 14398, as in the original. +- With these values the beam stays elastic (no bar softens). Raise `forceRate` or + lower the fracture energy (`GFR` in `DATA0.DAT`) to see damage. diff --git a/examples/example1_clamped_beam/DATA0.DAT b/examples/example1_clamped_beam/DATA0.DAT new file mode 100644 index 0000000..97308ed --- /dev/null +++ b/examples/example1_clamped_beam/DATA0.DAT @@ -0,0 +1,28 @@ +103 ' TEST ' +123 ' SEED' +1E-3 ' LCO ' +6 ' M ' +6 ' N ' +51 ' L ' +2500 ' DF1 ' +2500 ' DF2 ' +0.015 ' TDAF ' +0.00E-00 ' CON ' +3.5E-7 ' DT ' +2.8E-3 ' TTOT ' +2 ' INCO ' +2441 ' Ncon1 ' +884 ' Ncon2 ' +14398 ' OU2 ' +1000 ' OU3 ' +0 ' OU4 ' +0 ' OU5 ' +1 ' OU6 ' +1 ' OU7 ' +1 ' OU8 ' +1 ' OU9 ' +2.50E-01 ' PSN ' +1500.0E+0 ' ROH ' +3.87E+9 ' YNG ' +0.5E+00 ' GFR ' +4.5E-3 ' DEQ ' diff --git a/examples/example1_clamped_beam/runClampedBeam.m b/examples/example1_clamped_beam/runClampedBeam.m new file mode 100644 index 0000000..da688e2 --- /dev/null +++ b/examples/example1_clamped_beam/runClampedBeam.m @@ -0,0 +1,71 @@ +%% Example 1: beam clamped at both ends, loaded with a force at mid-span +% Model by Rodrigo (branch dev_rodrigo). A small beam of 5 x 5 x 50 modules +% of 1 mm is clamped at both ends and loaded at mid-span with a force that +% grows during 0.35 ms and then stays constant. The run simulates 2.8 ms +% (8000 steps). +% +% What it does +% 1. Reads the input file DATA0.DAT of this folder (test 103, see +% ldem.scenarios.ClampedBeam) and adds what the file does not contain. +% 2. Runs the simulation, writing results.mat, ANSYS macro files and a VTK +% series (open snapshots.pvd in ParaView). +% 3. Plots the force carried by the clamped ends, the vertical displacement +% of the control nodes and the energies. +% +% The model has 3086 nodes and 18085 bars. Output goes to the folder +% "output" next to this script, or to "outputFolder" if that variable +% already exists in the workspace. + +here = fileparts(mfilename('fullpath')); +repoRoot = fileparts(fileparts(here)); +addpath(fullfile(repoRoot, 'src')); +if ~exist('outputFolder', 'var') + outputFolder = fullfile(here, 'output'); +end + +%% 1. Parameters +% fromFile reads DATA0.DAT. The random field that varies the critical strain +% of each bar is shared with the beam_102 example; trackedBar selects the bar +% whose strain and force are stored at every step. +params = ldem.Parameters.fromFile(fullfile(here, 'DATA0.DAT'), ... + randomFieldFile = fullfile(repoRoot, 'examples', 'beam_102', 'arquivo_3lc_rnao_cv05'), ... + trackedBar = 14398); + +fprintf('Clamped beam with %d nodes, %d steps.\n', params.nNodes, params.nSteps); + +%% 2. Scenario +% Test 103 is registered for testId = 103, so runSimulation would find it by +% itself. It is created here to show the load: a force of +% forceRate*min(t, rampTime) newtons on each node of the loaded line. Change +% the values to try other loads, for example forceRate=2000. +scenario = ldem.scenarios.ClampedBeam(forceRate=1000, rampTime=0.00035); + +%% 3. Run +results = ldem.runSimulation(params, ... + Scenario = scenario, ... + OutputFolder = outputFolder, ... + Formats = ["mat" "ansys" "vtk"], ... + Verbose = true); + +%% 4. Look at the results +counts = results.snapshots.barCounts(end, :); +fprintf('\nAfter %.3g s: %d intact, %d damaged and %d broken bars.\n', ... + results.final.time, counts(1), counts(2), counts(3)); +fprintf('Files written to %s\n', outputFolder); + +fig = figure('Name', 'Force on the clamped ends'); +ldem.post.plotReaction(results, axes(fig)); + +fig = figure('Name', 'Vertical displacement of the control nodes'); +ax = axes(fig); +% The stored values are positions; subtract the initial ones to get displacements. +y0 = results.mesh.nodes0(params.controlNodes, 2).'; +plot(ax, results.controlNodes.time, ... + 1e3 * (results.controlNodes.displacement(:, :, 2) - y0)); +xlabel(ax, 'Time [s]'); +ylabel(ax, 'Vertical displacement [mm]'); +legend(ax, "node " + string(params.controlNodes), 'Location', 'best'); +grid(ax, 'on'); + +fig = figure('Name', 'Energies'); +ldem.post.plotEnergy(results, axes(fig)); diff --git a/src/+ldem/+scenarios/ClampedBeam.m b/src/+ldem/+scenarios/ClampedBeam.m new file mode 100644 index 0000000..fe998ed --- /dev/null +++ b/src/+ldem/+scenarios/ClampedBeam.m @@ -0,0 +1,133 @@ +classdef ClampedBeam < ldem.scenarios.Scenario + %CLAMPEDBEAM Beam clamped at both ends with a force at mid-span (TEST 103). + % + % The beam axis is z. The centre nodes of the first and of the last layer + % of modules are clamped (x, y and z fixed). A line of centre nodes at + % mid-span, on the face y = 0, is loaded with a force in the +y direction + % that grows linearly with time and stays constant after rampTime: + % + % F(t) = forceRate * min(t, rampTime) [N on each loaded node] + % + % This test loads with a force, not with a displacement: the scenario + % sets state.appliedForce and the solver counts its work in the external + % energy. + % + % The load position is measured in modules from the first clamped end + % and selects the line of centre nodes closest to it (a window of +-0.01 + % modules). The centre nodes lie at half-integer positions, so use values + % such as 24.5. The default, NaN, is half the beam length minus half a + % module, the position used by the original model. + % + % Create it with other values using + % scenario = ldem.scenarios.ClampedBeam(forceRate=2000, rampTime=2e-4); + % + % Origin: the bi-clamped beam model of Rodrigo (branch dev_rodrigo), which + % modified BOUND, CALOAD and ANSYS of the original code under TEST 102. + % + % See also ldem.scenarios.Scenario, ldem.scenarios.FourPointBending. + + properties (Constant) + testId = 103 + end + + properties + % Force growth rate on each loaded node [N/s]. + forceRate (1,1) double {mustBeFinite} = 1000 + + % Time at which the force stops growing and stays constant [s]. + rampTime (1,1) double {mustBePositive, mustBeFinite} = 0.00035 + + % Position of the load along the beam, from the first clamped end + % [modules]. NaN means mid-span, (L-1)/2 - 0.5. + loadPosition (1,1) double = NaN + + % Height of the loaded line above the face y = 0 [modules]. + loadHeight (1,1) double {mustBeNonnegative, mustBeFinite} = 0.5 + end + + methods + function obj = ClampedBeam(props) + %CLAMPEDBEAM Create the scenario, optionally with other values. + arguments + props.?ldem.scenarios.ClampedBeam + end + names = fieldnames(props); + for k = 1:numel(names) + obj.(names{k}) = props.(names{k}); + end + end + + function fixed = fixedDofs(obj, nodes0, params) + %FIXEDDOFS The two clamped end layers (x, y and z of their centre nodes). + arguments + obj (1,1) ldem.scenarios.ClampedBeam %#ok + nodes0 (:,3) double + params (1,1) ldem.Parameters + end + LCO = params.moduleLength; + L1 = params.nModules(3) - 1; + z = nodes0(:, 3); + tol = 0.01; + atStart = (z > (0.5 - tol) * LCO) & (z < (0.5 + tol) * LCO); + atEnd = (z > (L1 - 0.5 - tol) * LCO) & (z < (L1 - 0.5 + tol) * LCO); + fixed = false(size(nodes0)); + fixed(atStart | atEnd, :) = true; + end + + function loaded = loadedNodes(obj, nodes0, params) + %LOADEDNODES Logical vector of the nodes that carry the force. + % + % The centre nodes of the line at loadPosition along the beam + % and loadHeight above the face y = 0. Throws + % ldem:scenarios:noNodesSelected when there is none. + arguments + obj (1,1) ldem.scenarios.ClampedBeam + nodes0 (:,3) double + params (1,1) ldem.Parameters + end + LCO = params.moduleLength; + L1 = params.nModules(3) - 1; + position = obj.loadPosition; + if isnan(position) + position = L1 / 2 - 0.5; + end + tol = 0.01; + loaded = (nodes0(:, 3) > (position - tol) * LCO) & (nodes0(:, 3) < (position + tol) * LCO) & ... + (nodes0(:, 2) > (obj.loadHeight - tol) * LCO) & (nodes0(:, 2) < (obj.loadHeight + tol) * LCO); + if ~any(loaded) + error('ldem:scenarios:noNodesSelected', ... + ['The load line of the clamped beam matches no node. The beam has %d ' ... + 'modules along z; loadPosition = %g and loadHeight = %g (modules) must ' ... + 'fall on a line of centre nodes, e.g. 24.5 or 0.5, and lie inside the beam.'], ... + L1, position, obj.loadHeight); + end + end + + function state = applyLoads(obj, state, mesh, params) + %APPLYLOADS Set the force of the current time on the loaded nodes. + arguments + obj (1,1) ldem.scenarios.ClampedBeam + state (1,1) struct + mesh (1,1) struct + params (1,1) ldem.Parameters + end + loaded = obj.loadedNodes(mesh.nodes0, params); + state.appliedForce(:) = 0; + state.appliedForce(loaded, 2) = obj.forceRate * min(state.time, obj.rampTime); + end + + function reaction = reactions(obj, state, mesh, params) + %REACTIONS Force that the beam exerts on the clamped ends, [Rx Ry Rz]. + % + % The sum of the bar forces on the clamped degrees of freedom. At + % rest it equals the total applied force. + arguments + obj (1,1) ldem.scenarios.ClampedBeam %#ok + state (1,1) struct + mesh (1,1) struct + params (1,1) ldem.Parameters %#ok + end + reaction = sum(state.force .* mesh.fixed, 1); + end + end +end diff --git a/src/+ldem/+scenarios/Scenario.m b/src/+ldem/+scenarios/Scenario.m index 96094b7..6bf7e72 100644 --- a/src/+ldem/+scenarios/Scenario.m +++ b/src/+ldem/+scenarios/Scenario.m @@ -39,6 +39,11 @@ % for the time state.time. It is called once per step, before the % bar forces are computed. % + % A scenario that loads with forces instead of displacements sets + % state.appliedForce (nNodes-by-3, in N) here; the solver adds it + % to the bar forces and counts its work in the external energy. + % Displacement-controlled scenarios leave it untouched (zeros). + % % Inputs: % state Solver state, see ldem.solver.initialState. % mesh Struct from ldem.mesh.buildMesh. diff --git a/src/+ldem/+scenarios/fromTestId.m b/src/+ldem/+scenarios/fromTestId.m index f7c9d2c..95e8aa7 100644 --- a/src/+ldem/+scenarios/fromTestId.m +++ b/src/+ldem/+scenarios/fromTestId.m @@ -6,6 +6,7 @@ % % 101 ldem.scenarios.UniaxialTension % 102 ldem.scenarios.FourPointBending +% 103 ldem.scenarios.ClampedBeam % % To register a new scenario, add a line to the list inside this file. % @@ -24,7 +25,8 @@ testId (1,1) double end -registered = {ldem.scenarios.UniaxialTension(), ldem.scenarios.FourPointBending()}; +registered = {ldem.scenarios.UniaxialTension(), ldem.scenarios.FourPointBending(), ... + ldem.scenarios.ClampedBeam()}; for k = 1:numel(registered) if registered{k}.testId == testId diff --git a/src/+ldem/+solver/initialState.m b/src/+ldem/+solver/initialState.m index 4634e9e..fc020df 100644 --- a/src/+ldem/+solver/initialState.m +++ b/src/+ldem/+solver/initialState.m @@ -29,8 +29,10 @@ % axialForce nBars-by-1 axial force [N], tension positive (legacy F). % history Damage state of the bars. % dampingEnergy Energy dissipated by damping so far [J]. -% externalEnergy Work done by the supports and the prescribed motion so far [J]. +% externalEnergy Work of the supports, the prescribed motion and the applied forces so far [J]. % previousForce nNodes-by-3 nodal force of the previous step [N]. +% appliedForce nNodes-by-3 external force set by the scenario in applyLoads [N]. +% previousAppliedForce nNodes-by-3 applied force of the previous step [N]. % previousDamageEnergy Energy dissipated by damage at the previous step [J]. % % Example: @@ -63,5 +65,7 @@ state.dampingEnergy = 0.0; state.externalEnergy = 0.0; state.previousForce = zeros(nNodes, 3); +state.appliedForce = zeros(nNodes, 3); +state.previousAppliedForce = zeros(nNodes, 3); state.previousDamageEnergy = 0.0; end diff --git a/src/+ldem/+solver/integrateStep.m b/src/+ldem/+solver/integrateStep.m index 971b503..e169c28 100644 --- a/src/+ldem/+solver/integrateStep.m +++ b/src/+ldem/+solver/integrateStep.m @@ -12,6 +12,8 @@ % % u_next = (dt^2/m * F + 2*u - (1 - c*dt/2)*u_prev) / (1 + c*dt/2) % +% F is the sum of the bar force (state.force) and of the force applied by the +% scenario (state.appliedForce, zero when the scenario imposes displacements). % Degrees of freedom fixed by the scenario keep their current value. After % the update the velocity and acceleration are obtained with central % differences, the energy dissipated by damping is accumulated and the two @@ -29,6 +31,11 @@ % the steps gives the external work, which balances the kinetic, elastic, % damage and damping energies (see ldem.solver.computeEnergies). % +% A force applied to a free degree of freedom does work on the structure as +% the node moves: the average of the applied force of this step and of the +% previous one times the displacement of the step, summed over the free +% degrees of freedom and added to the same external work. +% % The energy dissipated in the step has two parts: the mass-proportional % damping of the nodes, c*(m/2)*v*(u_next - u_prev), and the viscous term % of the constitutive law, E*CON*rate^2*dt*L for every bar (E is the @@ -43,7 +50,8 @@ % % Output: % state Updated: displacement, previousDisplacement, velocity, -% acceleration, dampingEnergy, externalEnergy and previousForce. +% acceleration, dampingEnergy, externalEnergy, previousForce and +% previousAppliedForce. % % Errors: % ldem:solver:zeroMass A node has zero mass. @@ -77,7 +85,8 @@ uPrev = state.previousDisplacement; timeFactor = sdt ./ mesh.mass; % nNodes-by-1, applies to x, y and z -uNext = (timeFactor .* state.force + 2.0 .* u - dampingPrevious .* uPrev) ./ dampingNext; +totalForce = state.force + state.appliedForce; +uNext = (timeFactor .* totalForce + 2.0 .* u - dampingPrevious .* uPrev) ./ dampingNext; uNext(mesh.fixed) = u(mesh.fixed); velocity = (uNext - uPrev) ./ ddt; @@ -99,8 +108,14 @@ averageForce = (state.force(mesh.fixed) + state.previousForce(mesh.fixed)) / 2.0; externalWork = -sum(averageForce .* (u(mesh.fixed) - uPrev(mesh.fixed))); +% Work of the applied forces on the free degrees of freedom. +averageApplied = (state.appliedForce + state.previousAppliedForce) / 2.0; +free = ~mesh.fixed; +externalWork = externalWork + sum(averageApplied(free) .* (u(free) - uPrev(free))); + state.externalEnergy = state.externalEnergy + externalWork; state.previousForce = state.force; +state.previousAppliedForce = state.appliedForce; state.dampingEnergy = state.dampingEnergy + dissipated; state.previousDisplacement = u; state.displacement = uNext; diff --git a/tests/fixtures/README.md b/tests/fixtures/README.md index a4fe488..1977242 100644 --- a/tests/fixtures/README.md +++ b/tests/fixtures/README.md @@ -6,6 +6,12 @@ results of three small simulations run with the original MATLAB code (the (see `docs/known-issues/KNOWN_ISSUES.md`). The case definitions are in `tests/tools/referenceCases.m`. +`clamped103.mat` is the bi-clamped beam of Rodrigo (branch `dev_rodrigo`, +commit 3249300): it was produced with the same original code but with the +`BOUND` and `CALOAD` routines of that branch (they modify `TEST 102`; the new +code registers the model as test 103). It is a reduced version of the model +(5x5x21 nodes, 1600 steps, fracture energy 0.02 N/m so that bars soften). + The regression tests in `tests/regression` compare the `ldem` package with these files (relative tolerance 1e-9). The original code is not in the working tree; it is in the git history under the tag `legacy-reference`, together with diff --git a/tests/fixtures/clamped103.mat b/tests/fixtures/clamped103.mat new file mode 100644 index 0000000000000000000000000000000000000000..7daaa14bfd63b5b5355c9b5eed47d0a9cd43e4e4 GIT binary patch literal 591549 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ⅅ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 JiEHfh7ry%Jq!2|7( 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

    H3Y?Sf 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͕I2*lIX3j><;00s_b@-M5wCn#%@lUnzx`!(`!BVw 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

    !^#}Q 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 Date: Fri, 6 Nov 2026 07:56:44 -0300 Subject: [PATCH 08/13] docs: add multilingual site, auto-generated authors and build/model guides --- .github/workflows/docs.yml | 2 + .gitignore | 4 + .mailmap | 4 + AUTHORS.md | 9 ++ CHANGELOG.md | 6 + README.md | 8 +- docs/source/_templates/sidebar/languages.html | 17 ++ docs/source/conf.py | 22 ++- docs/source/en/authors.rst | 17 ++ docs/source/en/contributing.rst | 2 +- docs/source/en/docs.rst | 67 ++++++++ docs/source/en/index.rst | 3 + docs/source/en/installation.rst | 7 +- docs/source/en/introduction.rst | 20 ++- docs/source/en/model.rst | 108 +++++++++++++ docs/source/en/usage.rst | 10 +- docs/source/es/authors.rst | 18 +++ .../es/{contribuir.rst => contributing.rst} | 2 +- docs/source/es/docs.rst | 68 ++++++++ docs/source/es/index.rst | 11 +- .../es/{instalacion.rst => installation.rst} | 7 +- docs/source/es/introduccion.rst | 19 --- docs/source/es/introduction.rst | 25 +++ docs/source/es/model.rst | 111 +++++++++++++ docs/source/es/{uso.rst => usage.rst} | 11 +- docs/source/index.rst | 19 ++- docs/source/it/authors.rst | 18 +++ docs/source/it/contributing.rst | 16 ++ docs/source/it/docs.rst | 67 ++++++++ docs/source/it/index.rst | 13 ++ docs/source/it/installation.rst | 37 +++++ docs/source/it/introduction.rst | 24 +++ docs/source/it/model.rst | 111 +++++++++++++ docs/source/it/usage.rst | 147 ++++++++++++++++++ docs/source/pt/authors.rst | 17 ++ docs/source/pt/contributing.rst | 16 ++ docs/source/pt/docs.rst | 68 ++++++++ docs/source/pt/index.rst | 13 ++ docs/source/pt/installation.rst | 37 +++++ docs/source/pt/introduction.rst | 24 +++ docs/source/pt/model.rst | 111 +++++++++++++ docs/source/pt/usage.rst | 146 +++++++++++++++++ docs/tools/generate_authors.py | 101 ++++++++++++ src/+ldem/+io/exportAnsys.m | 21 +++ src/+ldem/+scenarios/Scenario.m | 3 +- src/+ldem/+solver/computeEnergies.m | 6 +- src/+ldem/Parameters.m | 3 +- tests/unit/TestExporters.m | 18 +++ 48 files changed, 1551 insertions(+), 63 deletions(-) create mode 100644 .mailmap create mode 100644 AUTHORS.md create mode 100644 docs/source/_templates/sidebar/languages.html create mode 100644 docs/source/en/authors.rst create mode 100644 docs/source/en/docs.rst create mode 100644 docs/source/en/model.rst create mode 100644 docs/source/es/authors.rst rename docs/source/es/{contribuir.rst => contributing.rst} (92%) create mode 100644 docs/source/es/docs.rst rename docs/source/es/{instalacion.rst => installation.rst} (86%) delete mode 100644 docs/source/es/introduccion.rst create mode 100644 docs/source/es/introduction.rst create mode 100644 docs/source/es/model.rst rename docs/source/es/{uso.rst => usage.rst} (91%) create mode 100644 docs/source/it/authors.rst create mode 100644 docs/source/it/contributing.rst create mode 100644 docs/source/it/docs.rst create mode 100644 docs/source/it/index.rst create mode 100644 docs/source/it/installation.rst create mode 100644 docs/source/it/introduction.rst create mode 100644 docs/source/it/model.rst create mode 100644 docs/source/it/usage.rst create mode 100644 docs/source/pt/authors.rst create mode 100644 docs/source/pt/contributing.rst create mode 100644 docs/source/pt/docs.rst create mode 100644 docs/source/pt/index.rst create mode 100644 docs/source/pt/installation.rst create mode 100644 docs/source/pt/introduction.rst create mode 100644 docs/source/pt/model.rst create mode 100644 docs/source/pt/usage.rst create mode 100644 docs/tools/generate_authors.py diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml index ad34dd2..1e2524c 100644 --- a/.github/workflows/docs.yml +++ b/.github/workflows/docs.yml @@ -13,6 +13,8 @@ jobs: runs-on: ubuntu-latest steps: - uses: actions/checkout@v4 + with: + fetch-depth: 0 # the authors page is generated from the git history - uses: actions/setup-python@v5 with: diff --git a/.gitignore b/.gitignore index feb3eb7..3ad5b82 100644 --- a/.gitignore +++ b/.gitignore @@ -34,3 +34,7 @@ BARR_ROMP.dat SIM01.DAT code-issues/ .buildtool/ + +# Documentation build +docs/build/ +docs/source/_generated/ diff --git a/.mailmap b/.mailmap new file mode 100644 index 0000000..7a8164a --- /dev/null +++ b/.mailmap @@ -0,0 +1,4 @@ +# Merges the different identities of one person so that AUTHORS is correct. +Boris Rojo Tanzi <71112604+borisrojotanzi@users.noreply.github.com> +Boris Rojo Tanzi <71112604+borisrojotanzi@users.noreply.github.com> +Rodrigo Cavasotto Oscar Montanha diff --git a/AUTHORS.md b/AUTHORS.md new file mode 100644 index 0000000..246bfaf --- /dev/null +++ b/AUTHORS.md @@ -0,0 +1,9 @@ +# Authors + +Generated from the git history and `CITATION.cff` by `docs/tools/generate_authors.py`. Do not edit by hand. + +| Name | Commits | +|------|---------| +| Boris Rojo Tanzi | 19 | +| Rodrigo Cavasotto Oscar Montanha | 7 | +| Ignacio Iturrioz | - | diff --git a/CHANGELOG.md b/CHANGELOG.md index 849f2bd..8760b43 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -65,6 +65,12 @@ off (`0`, the default) or on with that coefficient of variation (`> 0`). - Unit tests (`tests/unit`) and a regression test that compares the new mesh with the legacy one (`tests/regression/TestMeshAgainstLegacy`). +- `ldem.io.exportAnsys` writes the applied forces (`F,node,FX|FY|FZ,value`) of force-controlled + scenarios (test 103); before, the ANSYS files of that test had no load. +- Documentation brought in line with the code: the introductions (EN/ES) describe the `ldem` package + instead of the legacy routines, `Parameters.testId` and `Scenario` mention test 103, the results tables + include `brokenBars` and the reaction of test 103, and the Portuguese and Spanish READMEs translate the + `buildtool` comments. ### Changed - Example inputs moved to `examples/beam_102/`. diff --git a/README.md b/README.md index 5bdc2d2..0a79183 100644 --- a/README.md +++ b/README.md @@ -85,8 +85,8 @@ quase-frágeis (concreto, rochas). Executar os testes: ```matlab ->> buildtool % static analysis + fast tests (needs R2022b or newer) ->> buildtool testAll % also the slow tests +>> buildtool % análise estática + testes rápidos (requer R2022b ou superior) +>> buildtool testAll % inclui também os testes lentos ``` ### Documentação @@ -136,8 +136,8 @@ cuasi-frágiles (hormigón, rocas). Ejecutar los tests: ```matlab ->> buildtool % static analysis + fast tests (needs R2022b or newer) ->> buildtool testAll % also the slow tests +>> buildtool % análisis estático + tests rápidos (requiere R2022b o posterior) +>> buildtool testAll % incluye también los tests lentos ``` ### Documentación diff --git a/docs/source/_templates/sidebar/languages.html b/docs/source/_templates/sidebar/languages.html new file mode 100644 index 0000000..ce41a8f --- /dev/null +++ b/docs/source/_templates/sidebar/languages.html @@ -0,0 +1,17 @@ +{#- Language switcher: the same page in the other languages. -#} +{%- set langs = [('en', 'English'), ('es', 'Español'), ('pt', 'Português'), ('it', 'Italiano')] -%} +{%- set parts = pagename.split('/') -%} +{%- if parts|length > 1 and parts[0] in ['en', 'es', 'pt', 'it'] %} +

    +{%- endif %} diff --git a/docs/source/conf.py b/docs/source/conf.py index 87be76f..1537657 100644 --- a/docs/source/conf.py +++ b/docs/source/conf.py @@ -1,5 +1,7 @@ """Sphinx configuration for LDEM-MATLAB.""" import os +import subprocess +import sys project = "LDEM-MATLAB" author = "Boris Rojo Tanzi" @@ -21,9 +23,27 @@ # --- General ---------------------------------------------------------------- source_suffix = {".rst": "restructuredtext", ".md": "markdown"} -exclude_patterns = ["_build"] +exclude_patterns = ["_build", "_generated/*"] language = "en" +# --- Authors: generated from the git history on every build ----------------- +_tools = os.path.abspath(os.path.join(os.path.dirname(__file__), "..", "tools")) +subprocess.run([sys.executable, os.path.join(_tools, "generate_authors.py")], + check=True, stdout=subprocess.DEVNULL) + +templates_path = ["_templates"] +html_sidebars = { + "**": [ + "sidebar/scroll-start.html", + "sidebar/brand.html", + "sidebar/search.html", + "sidebar/languages.html", + "sidebar/navigation.html", + "sidebar/ethical-ads.html", + "sidebar/scroll-end.html", + ] +} + html_theme = "furo" html_title = "LDEM-MATLAB" html_static_path = ["_static"] diff --git a/docs/source/en/authors.rst b/docs/source/en/authors.rst new file mode 100644 index 0000000..3b38b7e --- /dev/null +++ b/docs/source/en/authors.rst @@ -0,0 +1,17 @@ +Authors +======= + +This list is generated automatically from the commits of the git history +(people with the same name or e-mail are merged through ``.mailmap``) and +from the authors of ``CITATION.cff``. Authors without commits in this +repository appear with ``-``. The same list is in ``AUTHORS.md``. + +.. include:: ../_generated/authors.rst + +To update it after new commits, build the documentation or run: + +.. code-block:: bash + + python docs/tools/generate_authors.py + +If a person appears twice, add a line to ``.mailmap``. diff --git a/docs/source/en/contributing.rst b/docs/source/en/contributing.rst index 7cd1017..8f392c9 100644 --- a/docs/source/en/contributing.rst +++ b/docs/source/en/contributing.rst @@ -4,7 +4,7 @@ Contributing The API documentation is generated from the ``.m`` comments. The docstring must be the comment block placed **immediately after** the ``function`` line (before any ``global`` declaration). Source comments are written in -Portuguese. +English. .. code-block:: matlab diff --git a/docs/source/en/docs.rst b/docs/source/en/docs.rst new file mode 100644 index 0000000..f773731 --- /dev/null +++ b/docs/source/en/docs.rst @@ -0,0 +1,67 @@ +Building this documentation +=========================== + +The documentation is written in English and translated into Spanish, +Portuguese and Italian; the four versions are in one site and the sidebar +lets the reader switch language. The API reference is generated from the +comments of the ``.m`` files. + +Requirements +------------ + +* Python 3.9 or newer. +* ``git`` (the list of authors is generated from the commit history; with a + shallow clone use ``git fetch --unshallow`` first). +* No MATLAB is needed; the API is read from the source text. + +.. code-block:: bash + + pip install -r docs/requirements.txt + +Build +----- + +From the repository root, with any of these: + +.. code-block:: bash + + sphinx-build -W --keep-going -b html docs/source docs/build/html + +.. code-block:: bash + + cd docs && make html + +.. code-block:: matlab + + >> buildtool docs + +Open ``docs/build/html/index.html`` in a browser. ``-W`` turns warnings into +errors: the documentation must build without any. ``buildtool clean`` deletes +the result. + +Where things are +---------------- + +``docs/source/en/`` + The reference text, in English. +``docs/source/es/``, ``pt/``, ``it/`` + Translations. Each page has the same file name as in ``en/`` so that the + language list in the sidebar links to the same page. +``docs/source/api/`` + API reference, generated from the ``.m`` comments. +``docs/tools/generate_authors.py`` + Writes the authors page and ``AUTHORS.md`` (run by the build). + +Write or change a page +---------------------- + +1. Edit the English page in ``docs/source/en/``. +2. Apply the same change to the translations. A new page needs a file with + the same name in each language and an entry in each ``index.rst``. +3. Build with ``-W`` and fix any warning. + +Publishing +---------- + +The workflow ``.github/workflows/docs.yml`` builds the documentation on every +pull request and publishes it to GitHub Pages when ``main`` changes. diff --git a/docs/source/en/index.rst b/docs/source/en/index.rst index 680fb1d..b2e7764 100644 --- a/docs/source/en/index.rst +++ b/docs/source/en/index.rst @@ -7,4 +7,7 @@ User guide introduction installation usage + model contributing + docs + authors diff --git a/docs/source/en/installation.rst b/docs/source/en/installation.rst index e3e3861..0128adb 100644 --- a/docs/source/en/installation.rst +++ b/docs/source/en/installation.rst @@ -33,9 +33,4 @@ Developer tasks (``buildtool`` is run from the repository root): ``buildtool test`` writes ``test-results/results.xml`` (JUnit) and ``code-coverage/coverage.xml`` (Cobertura). -To build this documentation without MATLAB: - -.. code-block:: bash - - pip install -r docs/requirements.txt - sphinx-build -b html docs/source docs/build/html +To build this documentation without MATLAB see :doc:`docs`. diff --git a/docs/source/en/introduction.rst b/docs/source/en/introduction.rst index c838d75..11e2459 100644 --- a/docs/source/en/introduction.rst +++ b/docs/source/en/introduction.rst @@ -8,11 +8,17 @@ include damage/fracture, and the equations of motion are integrated with an explicit central-difference scheme. Energies (external, kinetic, elastic, dissipated) are tracked at every step. -Main routines (see :doc:`../api/index`): +Main parts of the ``ldem`` package (see :doc:`../api/index`): -* ``ini_DEM3`` – initialises the global variables. -* ``read_dat0`` – reads the input data file. -* ``CONECTI`` / ``INTCO1`` / ``EXTCO1`` – bar connectivity. -* ``RMEC`` – mechanical properties of the bars. -* ``BOUND`` / ``CALOAD`` – boundary conditions and loads. -* ``ENERG2`` – energy balance. +* ``ldem.Parameters`` / ``ldem.io.readInputFile`` – validated input data. +* ``ldem.mesh`` – nodes, bars, masses and bar geometry. +* ``ldem.material`` – bar stiffness, critical strain and the bilinear damage law. +* ``ldem.scenarios`` – supports, loads and reactions of each test. +* ``ldem.solver`` – time integration and energy balance. +* ``ldem.runSimulation`` – the whole simulation, with ``results.mat``, ANSYS and + VTK output. + +The routines of the original program (``ini_DEM3``, ``read_dat0``, ``RMEC``, +``BOUND``, ``CALOAD``, ``ENERG2``, ...) are kept in the git history under the tag +``legacy-reference``; the ``Legacy:`` line of each help text names the routine it +replaces. diff --git a/docs/source/en/model.rst b/docs/source/en/model.rst new file mode 100644 index 0000000..6b9654e --- /dev/null +++ b/docs/source/en/model.rst @@ -0,0 +1,108 @@ +Building a different model +========================== + +A model is defined by three things: the **geometry** of the lattice, the +**material** and the **test** (supports and loads). The first two are +parameters; the third is a *scenario* class. You can change any of them +without touching the solver. + +1. Change the geometry and the material +--------------------------------------- + +Everything is a property of ``ldem.Parameters``: + +.. code-block:: matlab + + >> params = ldem.Parameters(testId=101, ... + moduleLength=0.002, ... % edge of the cubic module [m] + nModules=[21 6 6], ... % nodes along x, y and z + youngModulus=30e9, density=2400, poissonRatio=0.2, ... + fractureEnergy=80, criticalDistance=0.02, ... + meshPerturbation=0.02); % optional irregular mesh + +* ``nModules = [M N L]`` is the number of grid nodes along each axis, so the + prism has ``(M-1)*(N-1)*(L-1)`` modules. +* ``randomFieldFile`` multiplies the critical strain of each bar by a value + read from a text file (a random field of the material strength). +* ``dt`` must be below ``params.criticalTimeStep``; ``Parameters`` rejects an + unstable value and says so. + +The same data can come from an input file in the format of the original +program with ``ldem.Parameters.fromFile("DATA0.DAT", ...)``; extra +name=value pairs override the file. The mesh can be built and inspected +before running anything: + +.. code-block:: matlab + + >> mesh = ldem.mesh.buildMesh(params); + >> fprintf("%d nodes, %d bars\n", size(mesh.nodes0, 1), size(mesh.bars, 1)); + +2. Change the test: write a scenario +------------------------------------ + +A *scenario* says which degrees of freedom are fixed, how the load is +applied at every time step and which reaction is reported. The solver never +checks the test number, it only asks the scenario. To model a new test, +create a subclass of ``ldem.scenarios.Scenario`` in ``src/+ldem/+scenarios/``. + +The example below is a cantilever beam along :math:`z`: the first layer of +centre nodes is clamped and a force that grows linearly is applied in +:math:`y` at the free end. + +.. code-block:: matlab + + classdef Cantilever < ldem.scenarios.Scenario + properties (Constant) + testId = 104 % new number, unique + end + properties + forceRate (1,1) double = 500 % [N/s] on each loaded node + end + methods + function fixed = fixedDofs(~, nodes0, params) + z = nodes0(:, 3); + atStart = abs(z - 0.5*params.moduleLength) < 0.01*params.moduleLength; + fixed = false(size(nodes0)); + fixed(atStart, :) = true; % x, y and z held + end + function state = applyLoads(obj, state, mesh, params) + L1 = params.nModules(3) - 1; + z = mesh.nodes0(:, 3); + atEnd = abs(z - (L1 - 0.5)*params.moduleLength) < 0.01*params.moduleLength; + state.appliedForce(:) = 0; + state.appliedForce(atEnd, 2) = obj.forceRate * state.time; + end + end + end + +Rules to follow: + +* ``fixedDofs`` returns an ``nNodes``-by-3 logical matrix, true where the node + cannot move (``1 = x``, ``2 = y``, ``3 = z``). +* ``applyLoads`` runs once per step. A **displacement-controlled** test sets + ``state.displacement`` of the loaded nodes (see ``UniaxialTension``); a + **force-controlled** test sets ``state.appliedForce`` in newtons (see + ``ClampedBeam``) and the solver counts its work in the external energy. +* Override ``reactions`` if the test reports a reaction force (default: + ``NaN``). +* The centre nodes of the modules lie at half-integer multiples of + ``moduleLength``; select nodes with a small tolerance, never with ``==``. + +3. Register and run it +---------------------- + +Either pass the object directly, with no registration: + +.. code-block:: matlab + + >> scenario = ldem.scenarios.Cantilever(forceRate=1000); + >> results = ldem.runSimulation(params, Scenario=scenario, ... + OutputFolder="output", Formats=["mat" "vtk"]); + +or add it to the list in ``ldem.scenarios.fromTestId`` so that +``testId = 104`` finds it, which is also what an input file does. Then add a +test in ``tests/unit`` and, if it is a reference case, an example in +``examples/`` (see ``examples/example1_clamped_beam``). + +The result is the same ``results`` struct as for any other test, see +:doc:`usage`. diff --git a/docs/source/en/usage.rst b/docs/source/en/usage.rst index 6bcf5ab..d7dedca 100644 --- a/docs/source/en/usage.rst +++ b/docs/source/en/usage.rst @@ -84,11 +84,12 @@ What you get: the ``results`` struct * - ``controlNodes`` - Time and displacement, velocity and acceleration of the control nodes. * - ``reactions`` - - Time and reaction force of the test (beam test: vertical force). + - Time and reaction force ``[Rx Ry Rz]`` of the test: vertical force at the load points + (test 102), force on the clamped ends (test 103); ``NaN`` where the test defines none. * - ``energy`` - Time, kinetic, elastic, damage and damping energies [J], their sum - (``internal``), the external work, the ``balance`` (external minus - internal) and the damage rate. + (``internal``), the energy of the broken bars (``brokenBars``), the external work, + the ``balance`` (external minus internal) and the damage rate. * - ``trackedBar`` - Strain, force and damage energy of one bar at every step (optional). * - ``snapshots`` @@ -120,7 +121,8 @@ Output files (intact), 2 (damaged) and 5 (broken). The held degrees of freedom are listed as ``D,node,direction`` and the displacement imposed on the loaded nodes, measured from their initial position, as - ``D,node,direction,value``. + ``D,node,direction,value``. In test 103 the applied forces are listed as + ``F,node,direction,value``. ``snapshot_0000.vtu``, ... and ``snapshots.pvd`` VTK files. Open ``snapshots.pvd`` in `ParaView `_; colour by ``damageState`` (cell data) to see the cracks and use the time diff --git a/docs/source/es/authors.rst b/docs/source/es/authors.rst new file mode 100644 index 0000000..d1a9473 --- /dev/null +++ b/docs/source/es/authors.rst @@ -0,0 +1,18 @@ +Autores +======= + +Esta lista se genera automáticamente desde los commits del historial de git +(las personas con el mismo nombre o correo se unifican con ``.mailmap``) y +desde los autores de ``CITATION.cff``. Los autores sin commits en este +repositorio aparecen con ``-``. La misma lista está en ``AUTHORS.md``. + +.. include:: ../_generated/authors.rst + +Para actualizarla después de nuevos commits, construir la documentación o +ejecutar: + +.. code-block:: bash + + python docs/tools/generate_authors.py + +Si una persona aparece dos veces, agregar una línea a ``.mailmap``. diff --git a/docs/source/es/contribuir.rst b/docs/source/es/contributing.rst similarity index 92% rename from docs/source/es/contribuir.rst rename to docs/source/es/contributing.rst index 9ba339d..2869ebb 100644 --- a/docs/source/es/contribuir.rst +++ b/docs/source/es/contributing.rst @@ -4,7 +4,7 @@ Contribuir La documentación de la API se genera desde los comentarios de los ``.m``. El docstring debe ser el bloque de comentarios ubicado **inmediatamente después** de la línea ``function`` (antes de cualquier ``global``). Los comentarios del -código se escriben en portugués. +código se escriben en inglés. .. code-block:: matlab diff --git a/docs/source/es/docs.rst b/docs/source/es/docs.rst new file mode 100644 index 0000000..ee63154 --- /dev/null +++ b/docs/source/es/docs.rst @@ -0,0 +1,68 @@ +Construir esta documentación +============================ + +La documentación está escrita en inglés y traducida al español, portugués e +italiano; las cuatro versiones forman un solo sitio y la barra lateral permite +cambiar de idioma. La referencia de la API se genera desde los comentarios de +los ``.m``. + +Requisitos +---------- + +* Python 3.9 o superior. +* ``git`` (la lista de autores se genera desde el historial de commits; con un + clon superficial ejecutar antes ``git fetch --unshallow``). +* No se necesita MATLAB; la API se lee del texto de las fuentes. + +.. code-block:: bash + + pip install -r docs/requirements.txt + +Construcción +------------ + +Desde la raíz del repositorio, con cualquiera de estas opciones: + +.. code-block:: bash + + sphinx-build -W --keep-going -b html docs/source docs/build/html + +.. code-block:: bash + + cd docs && make html + +.. code-block:: matlab + + >> buildtool docs + +Abrir ``docs/build/html/index.html`` en un navegador. ``-W`` convierte las +advertencias en errores: la documentación debe construirse sin ninguna. +``buildtool clean`` borra el resultado. + +Dónde está cada cosa +-------------------- + +``docs/source/en/`` + El texto de referencia, en inglés. +``docs/source/es/``, ``pt/``, ``it/`` + Traducciones. Cada página tiene el mismo nombre de archivo que en ``en/`` + para que la lista de idiomas de la barra lateral enlace a la misma página. +``docs/source/api/`` + Referencia de la API, generada desde los comentarios de los ``.m``. +``docs/tools/generate_authors.py`` + Escribe la página de autores y ``AUTHORS.md`` (lo ejecuta la construcción). + +Escribir o cambiar una página +----------------------------- + +1. Editar la página en inglés en ``docs/source/en/``. +2. Aplicar el mismo cambio a las traducciones. Una página nueva necesita un + archivo con el mismo nombre en cada idioma y una entrada en cada + ``index.rst``. +3. Construir con ``-W`` y corregir cualquier advertencia. + +Publicación +----------- + +El workflow ``.github/workflows/docs.yml`` construye la documentación en cada +pull request y la publica en GitHub Pages cuando cambia ``main``. diff --git a/docs/source/es/index.rst b/docs/source/es/index.rst index 956333f..b9dacc8 100644 --- a/docs/source/es/index.rst +++ b/docs/source/es/index.rst @@ -4,7 +4,10 @@ Guía de usuario .. toctree:: :maxdepth: 1 - introduccion - instalacion - uso - contribuir + introduction + installation + usage + model + contributing + docs + authors diff --git a/docs/source/es/instalacion.rst b/docs/source/es/installation.rst similarity index 86% rename from docs/source/es/instalacion.rst rename to docs/source/es/installation.rst index b9a62be..507aba6 100644 --- a/docs/source/es/instalacion.rst +++ b/docs/source/es/installation.rst @@ -34,9 +34,4 @@ repositorio): ``buildtool test`` escribe ``test-results/results.xml`` (JUnit) y ``code-coverage/coverage.xml`` (Cobertura). -Para construir esta documentación sin MATLAB: - -.. code-block:: bash - - pip install -r docs/requirements.txt - sphinx-build -b html docs/source docs/build/html +Para construir esta documentación sin MATLAB ver :doc:`docs`. diff --git a/docs/source/es/introduccion.rst b/docs/source/es/introduccion.rst deleted file mode 100644 index f760e78..0000000 --- a/docs/source/es/introduccion.rst +++ /dev/null @@ -1,19 +0,0 @@ -Introducción -============ - -El **Método de Elementos Discretos tipo Reticulado (LDEM)** modela un -continuo como un reticulado regular de nodos conectados por barras -dispuestas en módulos cúbicos (aristas más diagonales). Las masas son -concentradas en los nodos, las leyes constitutivas de las barras incluyen -daño/fractura y las ecuaciones de movimiento se integran con un esquema -explícito de diferencias centrales. Las energías (externa, cinética, -elástica, disipada) se controlan en cada paso. - -Rutinas principales (ver :doc:`../api/index`): - -* ``ini_DEM3`` – inicializa las variables globales. -* ``read_dat0`` – lee el archivo de datos de entrada. -* ``CONECTI`` / ``INTCO1`` / ``EXTCO1`` – conectividad de barras. -* ``RMEC`` – propiedades mecánicas de las barras. -* ``BOUND`` / ``CALOAD`` – condiciones de contorno y cargas. -* ``ENERG2`` – balance de energía. diff --git a/docs/source/es/introduction.rst b/docs/source/es/introduction.rst new file mode 100644 index 0000000..eb779a4 --- /dev/null +++ b/docs/source/es/introduction.rst @@ -0,0 +1,25 @@ +Introducción +============ + +El **Método de Elementos Discretos tipo Reticulado (LDEM)** modela un +continuo como un reticulado regular de nodos conectados por barras +dispuestas en módulos cúbicos (aristas más diagonales). Las masas son +concentradas en los nodos, las leyes constitutivas de las barras incluyen +daño/fractura y las ecuaciones de movimiento se integran con un esquema +explícito de diferencias centrales. Las energías (externa, cinética, +elástica, disipada) se controlan en cada paso. + +Partes principales del paquete ``ldem`` (ver :doc:`../api/index`): + +* ``ldem.Parameters`` / ``ldem.io.readInputFile`` – datos de entrada validados. +* ``ldem.mesh`` – nodos, barras, masas y geometría de las barras. +* ``ldem.material`` – rigidez de las barras, deformación crítica y ley bilineal de daño. +* ``ldem.scenarios`` – apoyos, cargas y reacciones de cada ensayo. +* ``ldem.solver`` – integración en el tiempo y balance de energía. +* ``ldem.runSimulation`` – la simulación completa, con salida ``results.mat``, + ANSYS y VTK. + +Las rutinas del programa original (``ini_DEM3``, ``read_dat0``, ``RMEC``, +``BOUND``, ``CALOAD``, ``ENERG2``, ...) se conservan en el historial de git, con +la etiqueta ``legacy-reference``; la línea ``Legacy:`` de cada ayuda nombra la +rutina que reemplaza. diff --git a/docs/source/es/model.rst b/docs/source/es/model.rst new file mode 100644 index 0000000..5da99d0 --- /dev/null +++ b/docs/source/es/model.rst @@ -0,0 +1,111 @@ +Construir un modelo distinto +============================ + +Un modelo se define con tres cosas: la **geometría** del reticulado, el +**material** y el **ensayo** (apoyos y cargas). Las dos primeras son +parámetros; la tercera es una clase *escenario*. Se puede cambiar cualquiera +sin tocar el solver. + +1. Cambiar la geometría y el material +------------------------------------- + +Todo es una propiedad de ``ldem.Parameters``: + +.. code-block:: matlab + + >> params = ldem.Parameters(testId=101, ... + moduleLength=0.002, ... % arista del módulo cúbico [m] + nModules=[21 6 6], ... % nodos en x, y y z + youngModulus=30e9, density=2400, poissonRatio=0.2, ... + fractureEnergy=80, criticalDistance=0.02, ... + meshPerturbation=0.02); % malla irregular (opcional) + +* ``nModules = [M N L]`` es el número de nodos de la grilla en cada eje, de + modo que el prisma tiene ``(M-1)*(N-1)*(L-1)`` módulos. +* ``randomFieldFile`` multiplica la deformación crítica de cada barra por un + valor leído de un archivo de texto (campo aleatorio de la resistencia). +* ``dt`` debe ser menor que ``params.criticalTimeStep``; ``Parameters`` + rechaza un valor inestable y lo explica. + +Los mismos datos pueden venir de un archivo de entrada con el formato del +programa original: ``ldem.Parameters.fromFile("DATA0.DAT", ...)``; los pares +nombre=valor adicionales reemplazan a los del archivo. La malla se puede +construir e inspeccionar antes de ejecutar nada: + +.. code-block:: matlab + + >> mesh = ldem.mesh.buildMesh(params); + >> fprintf("%d nodos, %d barras\n", size(mesh.nodes0, 1), size(mesh.bars, 1)); + +2. Cambiar el ensayo: escribir un escenario +------------------------------------------- + +Un *escenario* dice qué grados de libertad están fijos, cómo se aplica la +carga en cada paso de tiempo y qué reacción se informa. El solver nunca +consulta el número del ensayo; se lo pregunta al escenario. Para modelar un +ensayo nuevo se crea una subclase de ``ldem.scenarios.Scenario`` en +``src/+ldem/+scenarios/``. + +El ejemplo es una viga en voladizo según :math:`z`: la primera capa de nodos +centrales está empotrada y en el extremo libre se aplica en :math:`y` una +fuerza que crece linealmente. + +.. code-block:: matlab + + classdef Cantilever < ldem.scenarios.Scenario + properties (Constant) + testId = 104 % número nuevo, único + end + properties + forceRate (1,1) double = 500 % [N/s] en cada nodo cargado + end + methods + function fixed = fixedDofs(~, nodes0, params) + z = nodes0(:, 3); + atStart = abs(z - 0.5*params.moduleLength) < 0.01*params.moduleLength; + fixed = false(size(nodes0)); + fixed(atStart, :) = true; % x, y y z fijos + end + function state = applyLoads(obj, state, mesh, params) + L1 = params.nModules(3) - 1; + z = mesh.nodes0(:, 3); + atEnd = abs(z - (L1 - 0.5)*params.moduleLength) < 0.01*params.moduleLength; + state.appliedForce(:) = 0; + state.appliedForce(atEnd, 2) = obj.forceRate * state.time; + end + end + end + +Reglas: + +* ``fixedDofs`` devuelve una matriz lógica de ``nNodes`` por 3, verdadera donde + el nodo no puede moverse (``1 = x``, ``2 = y``, ``3 = z``). +* ``applyLoads`` se ejecuta en cada paso. Un ensayo **controlado por + desplazamiento** asigna ``state.displacement`` de los nodos cargados (ver + ``UniaxialTension``); uno **controlado por fuerza** asigna + ``state.appliedForce`` en newtons (ver ``ClampedBeam``) y el solver cuenta su + trabajo en la energía externa. +* Se redefine ``reactions`` si el ensayo informa una fuerza de reacción (por + defecto: ``NaN``). +* Los nodos centrales de los módulos están en múltiplos semienteros de + ``moduleLength``; los nodos se seleccionan con una tolerancia pequeña, nunca + con ``==``. + +3. Registrarlo y ejecutarlo +--------------------------- + +Se puede pasar el objeto directamente, sin registrar nada: + +.. code-block:: matlab + + >> scenario = ldem.scenarios.Cantilever(forceRate=1000); + >> results = ldem.runSimulation(params, Scenario=scenario, ... + OutputFolder="output", Formats=["mat" "vtk"]); + +o agregarlo a la lista de ``ldem.scenarios.fromTestId`` para que +``testId = 104`` lo encuentre, que es lo que hace un archivo de entrada. +Después se agrega un test en ``tests/unit`` y, si es un caso de referencia, un +ejemplo en ``examples/`` (ver ``examples/example1_clamped_beam``). + +El resultado es la misma estructura ``results`` de cualquier otro ensayo, ver +:doc:`usage`. diff --git a/docs/source/es/uso.rst b/docs/source/es/usage.rst similarity index 91% rename from docs/source/es/uso.rst rename to docs/source/es/usage.rst index aef0c44..81b046f 100644 --- a/docs/source/es/uso.rst +++ b/docs/source/es/usage.rst @@ -85,11 +85,13 @@ Qué se obtiene: la estructura ``results`` * - ``controlNodes`` - Tiempo y desplazamiento, velocidad y aceleración de los nodos de control. * - ``reactions`` - - Tiempo y fuerza de reacción del ensayo (viga: fuerza vertical). + - Tiempo y fuerza de reacción ``[Rx Ry Rz]`` del ensayo: fuerza vertical en los puntos + de carga (ensayo 102), fuerza en los extremos empotrados (ensayo 103); ``NaN`` + donde el ensayo no la define. * - ``energy`` - Tiempo, energías cinética, elástica, de daño y de amortiguamiento [J], - su suma (``internal``), el trabajo externo, el balance (``balance``, - externo menos interno) y la tasa de daño. + su suma (``internal``), la energía de las barras rotas (``brokenBars``), el trabajo + externo, el balance (``balance``, externo menos interno) y la tasa de daño. * - ``trackedBar`` - Deformación, fuerza y energía de daño de una barra en cada paso (opcional). @@ -122,7 +124,8 @@ Archivos de salida tipo 1 (intactas), 2 (dañadas) y 5 (rotas). Los grados de libertad fijos se listan como ``D,nodo,dirección`` y el desplazamiento impuesto a los nodos cargados, medido desde su posición inicial, como - ``D,nodo,dirección,valor``. + ``D,nodo,dirección,valor``. En el ensayo 103 las fuerzas aplicadas se listan como + ``F,nodo,dirección,valor``. ``snapshot_0000.vtu``, ... y ``snapshots.pvd`` Archivos VTK. Abrir ``snapshots.pvd`` en `ParaView `_; colorear por ``damageState`` (datos de celda) para ver las fisuras y usar diff --git a/docs/source/index.rst b/docs/source/index.rst index d623e1f..c4544f1 100644 --- a/docs/source/index.rst +++ b/docs/source/index.rst @@ -1,8 +1,11 @@ LDEM-MATLAB =========== -Lattice Discrete Element Method (LDEM) in MATLAB / -Método de Elementos Discretos tipo Reticulado en MATLAB. +Lattice Discrete Element Method (LDEM) in MATLAB. + +The documentation is written in English and translated into Spanish, +Portuguese and Italian. Use the language list in the sidebar of any page to +switch language; the same page is shown in the chosen language. .. toctree:: :maxdepth: 2 @@ -16,6 +19,18 @@ Método de Elementos Discretos tipo Reticulado en MATLAB. es/index +.. toctree:: + :maxdepth: 2 + :caption: Português + + pt/index + +.. toctree:: + :maxdepth: 2 + :caption: Italiano + + it/index + .. toctree:: :maxdepth: 2 :caption: API diff --git a/docs/source/it/authors.rst b/docs/source/it/authors.rst new file mode 100644 index 0000000..4d0bed5 --- /dev/null +++ b/docs/source/it/authors.rst @@ -0,0 +1,18 @@ +Autori +====== + +Questo elenco è generato automaticamente dai commit della cronologia di git +(le persone con lo stesso nome o e-mail sono unificate tramite ``.mailmap``) e +dagli autori di ``CITATION.cff``. Gli autori senza commit in questo repository +compaiono con ``-``. Lo stesso elenco è in ``AUTHORS.md``. + +.. include:: ../_generated/authors.rst + +Per aggiornarlo dopo nuovi commit, costruire la documentazione oppure +eseguire: + +.. code-block:: bash + + python docs/tools/generate_authors.py + +Se una persona compare due volte, aggiungere una riga a ``.mailmap``. diff --git a/docs/source/it/contributing.rst b/docs/source/it/contributing.rst new file mode 100644 index 0000000..6d591b1 --- /dev/null +++ b/docs/source/it/contributing.rst @@ -0,0 +1,16 @@ +Contribuire +=========== + +La documentazione dell'API è generata dai commenti dei ``.m``. Il docstring +deve essere il blocco di commenti posto **subito dopo** la riga ``function`` +(prima di qualsiasi ``global``). I commenti del codice sono scritti in +inglese. + +.. code-block:: matlab + + function ini = CALOAD() + % CALOAD Riepilogo in una riga. + % Descrizione più lunga. + global ... + +Vedi ``CONTRIBUTING.md`` nella radice del repository. diff --git a/docs/source/it/docs.rst b/docs/source/it/docs.rst new file mode 100644 index 0000000..7bba5c9 --- /dev/null +++ b/docs/source/it/docs.rst @@ -0,0 +1,67 @@ +Costruire questa documentazione +=============================== + +La documentazione è scritta in inglese e tradotta in spagnolo, portoghese e +italiano; le quattro versioni formano un unico sito e la barra laterale +permette di cambiare lingua. Il riferimento dell'API è generato dai commenti +dei ``.m``. + +Requisiti +--------- + +* Python 3.9 o successivo. +* ``git`` (l'elenco degli autori è generato dalla cronologia dei commit; con + un clone superficiale eseguire prima ``git fetch --unshallow``). +* MATLAB non è necessario; l'API viene letta dal testo dei sorgenti. + +.. code-block:: bash + + pip install -r docs/requirements.txt + +Costruzione +----------- + +Dalla radice del repository, con una qualsiasi di queste opzioni: + +.. code-block:: bash + + sphinx-build -W --keep-going -b html docs/source docs/build/html + +.. code-block:: bash + + cd docs && make html + +.. code-block:: matlab + + >> buildtool docs + +Aprire ``docs/build/html/index.html`` in un browser. ``-W`` trasforma gli +avvisi in errori: la documentazione deve essere costruita senza alcun avviso. +``buildtool clean`` elimina il risultato. + +Dove si trova ogni cosa +----------------------- + +``docs/source/en/`` + Il testo di riferimento, in inglese. +``docs/source/es/``, ``pt/``, ``it/`` + Traduzioni. Ogni pagina ha lo stesso nome di file che in ``en/``, così + l'elenco delle lingue nella barra laterale porta alla stessa pagina. +``docs/source/api/`` + Riferimento dell'API, generato dai commenti dei ``.m``. +``docs/tools/generate_authors.py`` + Scrive la pagina degli autori e ``AUTHORS.md`` (eseguito dalla costruzione). + +Scrivere o modificare una pagina +-------------------------------- + +1. Modificare la pagina in inglese in ``docs/source/en/``. +2. Applicare la stessa modifica alle traduzioni. Una pagina nuova richiede un + file con lo stesso nome in ogni lingua e una voce in ogni ``index.rst``. +3. Costruire con ``-W`` e correggere ogni avviso. + +Pubblicazione +------------- + +Il workflow ``.github/workflows/docs.yml`` costruisce la documentazione a ogni +pull request e la pubblica su GitHub Pages quando cambia ``main``. diff --git a/docs/source/it/index.rst b/docs/source/it/index.rst new file mode 100644 index 0000000..722920e --- /dev/null +++ b/docs/source/it/index.rst @@ -0,0 +1,13 @@ +Guida per l'utente +================== + +.. toctree:: + :maxdepth: 1 + + introduction + installation + usage + model + contributing + docs + authors diff --git a/docs/source/it/installation.rst b/docs/source/it/installation.rst new file mode 100644 index 0000000..1ca8b8d --- /dev/null +++ b/docs/source/it/installation.rst @@ -0,0 +1,37 @@ +Installazione +============= + +Requisiti: MATLAB R2022b o successivo (sviluppato e testato su R2023b). Il +pacchetto usa il blocco ``arguments`` e la sintassi nome=valore; la suite di +test e ``buildtool`` richiedono R2022b. Non serve alcun toolbox. + +.. code-block:: bash + + git clone ldem-matlab + cd ldem-matlab + +.. code-block:: matlab + + >> setup_path + +Verificare l'installazione con i test rapidi: + +.. code-block:: matlab + + >> buildtool test + +Attività per sviluppatori (``buildtool`` si esegue dalla radice del +repository): + +.. code-block:: matlab + + >> buildtool % analisi statica + test rapidi (predefinito) + >> buildtool check % solo l'analizzatore di codice + >> buildtool testAll % tutti i test, compresi quelli lenti + >> buildtool docs % costruire questa documentazione (richiede Python) + >> buildtool clean % eliminare i file generati + +``buildtool test`` scrive ``test-results/results.xml`` (JUnit) e +``code-coverage/coverage.xml`` (Cobertura). + +Per costruire questa documentazione senza MATLAB vedi :doc:`docs`. diff --git a/docs/source/it/introduction.rst b/docs/source/it/introduction.rst new file mode 100644 index 0000000..5211352 --- /dev/null +++ b/docs/source/it/introduction.rst @@ -0,0 +1,24 @@ +Introduzione +============ + +Il **Metodo degli Elementi Discreti a Reticolo (LDEM)** modella un continuo +come un reticolo regolare di nodi collegati da barre disposte in moduli cubici +(spigoli più diagonali). Le masse sono concentrate nei nodi, le leggi +costitutive delle barre includono danno/frattura e le equazioni del moto sono +integrate con uno schema esplicito alle differenze centrali. Le energie +(esterna, cinetica, elastica, dissipata) sono monitorate a ogni passo. + +Parti principali del pacchetto ``ldem`` (vedi :doc:`../api/index`): + +* ``ldem.Parameters`` / ``ldem.io.readInputFile`` – dati di ingresso validati. +* ``ldem.mesh`` – nodi, barre, masse e geometria delle barre. +* ``ldem.material`` – rigidezza delle barre, deformazione critica e legge bilineare di danno. +* ``ldem.scenarios`` – vincoli, carichi e reazioni di ogni prova. +* ``ldem.solver`` – integrazione nel tempo e bilancio energetico. +* ``ldem.runSimulation`` – la simulazione completa, con uscita ``results.mat``, + ANSYS e VTK. + +Le routine del programma originale (``ini_DEM3``, ``read_dat0``, ``RMEC``, +``BOUND``, ``CALOAD``, ``ENERG2``, ...) sono conservate nella cronologia di +git, con il tag ``legacy-reference``; la riga ``Legacy:`` di ogni guida indica +la routine che sostituisce. diff --git a/docs/source/it/model.rst b/docs/source/it/model.rst new file mode 100644 index 0000000..e7c4b40 --- /dev/null +++ b/docs/source/it/model.rst @@ -0,0 +1,111 @@ +Costruire un modello diverso +============================ + +Un modello è definito da tre cose: la **geometria** del reticolo, il +**materiale** e la **prova** (vincoli e carichi). Le prime due sono parametri; +la terza è una classe *scenario*. Ciascuna si può cambiare senza toccare il +solver. + +1. Cambiare la geometria e il materiale +--------------------------------------- + +Tutto è una proprietà di ``ldem.Parameters``: + +.. code-block:: matlab + + >> params = ldem.Parameters(testId=101, ... + moduleLength=0.002, ... % spigolo del modulo cubico [m] + nModules=[21 6 6], ... % nodi in x, y e z + youngModulus=30e9, density=2400, poissonRatio=0.2, ... + fractureEnergy=80, criticalDistance=0.02, ... + meshPerturbation=0.02); % mesh irregolare (opzionale) + +* ``nModules = [M N L]`` è il numero di nodi della griglia lungo ogni asse, + quindi il prisma ha ``(M-1)*(N-1)*(L-1)`` moduli. +* ``randomFieldFile`` moltiplica la deformazione critica di ogni barra per un + valore letto da un file di testo (campo casuale della resistenza). +* ``dt`` deve essere minore di ``params.criticalTimeStep``; ``Parameters`` + rifiuta un valore instabile e ne spiega il motivo. + +Gli stessi dati possono provenire da un file di ingresso nel formato del +programma originale: ``ldem.Parameters.fromFile("DATA0.DAT", ...)``; le +coppie nome=valore aggiuntive sostituiscono quelle del file. La mesh può +essere costruita e ispezionata prima di eseguire qualsiasi cosa: + +.. code-block:: matlab + + >> mesh = ldem.mesh.buildMesh(params); + >> fprintf("%d nodi, %d barre\n", size(mesh.nodes0, 1), size(mesh.bars, 1)); + +2. Cambiare la prova: scrivere uno scenario +------------------------------------------- + +Uno *scenario* dice quali gradi di libertà sono bloccati, come viene applicato +il carico a ogni passo di tempo e quale reazione viene riportata. Il solver +non controlla mai il numero della prova: lo chiede allo scenario. Per +modellare una prova nuova si crea una sottoclasse di +``ldem.scenarios.Scenario`` in ``src/+ldem/+scenarios/``. + +L'esempio è una trave a mensola lungo :math:`z`: il primo strato di nodi +centrali è incastrato e all'estremità libera si applica in :math:`y` una forza +che cresce linearmente. + +.. code-block:: matlab + + classdef Cantilever < ldem.scenarios.Scenario + properties (Constant) + testId = 104 % numero nuovo, univoco + end + properties + forceRate (1,1) double = 500 % [N/s] su ogni nodo caricato + end + methods + function fixed = fixedDofs(~, nodes0, params) + z = nodes0(:, 3); + atStart = abs(z - 0.5*params.moduleLength) < 0.01*params.moduleLength; + fixed = false(size(nodes0)); + fixed(atStart, :) = true; % x, y e z bloccati + end + function state = applyLoads(obj, state, mesh, params) + L1 = params.nModules(3) - 1; + z = mesh.nodes0(:, 3); + atEnd = abs(z - (L1 - 0.5)*params.moduleLength) < 0.01*params.moduleLength; + state.appliedForce(:) = 0; + state.appliedForce(atEnd, 2) = obj.forceRate * state.time; + end + end + end + +Regole: + +* ``fixedDofs`` restituisce una matrice logica ``nNodes`` per 3, vera dove il + nodo non può muoversi (``1 = x``, ``2 = y``, ``3 = z``). +* ``applyLoads`` viene eseguito a ogni passo. Una prova **a spostamento + controllato** assegna ``state.displacement`` dei nodi caricati (vedi + ``UniaxialTension``); una **a forza controllata** assegna + ``state.appliedForce`` in newton (vedi ``ClampedBeam``) e il solver ne conta + il lavoro nell'energia esterna. +* Ridefinire ``reactions`` se la prova riporta una forza di reazione + (predefinito: ``NaN``). +* I nodi centrali dei moduli si trovano a multipli semi-interi di + ``moduleLength``; selezionare i nodi con una piccola tolleranza, mai con + ``==``. + +3. Registrarlo ed eseguirlo +--------------------------- + +L'oggetto si può passare direttamente, senza registrare nulla: + +.. code-block:: matlab + + >> scenario = ldem.scenarios.Cantilever(forceRate=1000); + >> results = ldem.runSimulation(params, Scenario=scenario, ... + OutputFolder="output", Formats=["mat" "vtk"]); + +oppure aggiungerlo all'elenco di ``ldem.scenarios.fromTestId`` in modo che +``testId = 104`` lo trovi, come fa un file di ingresso. Poi si aggiunge un +test in ``tests/unit`` e, se è un caso di riferimento, un esempio in +``examples/`` (vedi ``examples/example1_clamped_beam``). + +Il risultato è la stessa struttura ``results`` di qualsiasi altra prova, vedi +:doc:`usage`. diff --git a/docs/source/it/usage.rst b/docs/source/it/usage.rst new file mode 100644 index 0000000..05a19e8 --- /dev/null +++ b/docs/source/it/usage.rst @@ -0,0 +1,147 @@ +Uso +=== + +Eseguire una simulazione +------------------------ + +.. code-block:: matlab + + >> setup_path % aggiunge src/ al path di MATLAB + >> params = ldem.Parameters(testId=101, nModules=[6 3 3], totalTime=2e-4, ... + fractureEnergy=0.1, ... + output=struct('snapshotEvery', 250, 'controlNodesEvery', 10, ... + 'energyEvery', 10, 'trackedBarEvery', 0)); + >> results = ldem.runSimulation(params, OutputFolder="output", ... + Formats=["mat" "ansys" "vtk"]); + >> ldem.post.plotEnergy(results); + +``ldem.Parameters`` valida ogni valore quando viene assegnato e spiega cosa +non va (per esempio un passo di tempo instabile). La versione completa e +pronta all'uso è in ``examples/tension_101/runTension.m``. + +Per usare un file di ingresso nel formato del programma originale: + +.. code-block:: matlab + + >> params = ldem.Parameters.fromFile("DATA0.DAT"); + +Prove disponibili +----------------- + +``testId = 101`` + Carico uniassiale: i nodi centrali dell'ultima colonna di moduli si + muovono in :math:`x` con velocità imposta. +``testId = 102`` + Trave con due appoggi e due punti di carico. Le posizioni sono parametri di + ``ldem.scenarios.FourPointBending`` (``supportPosition``, ``loadPosition``, + in moduli da ciascuna estremità); i valori predefiniti richiedono una trave + di oltre 70 moduli circa. Vedi ``examples/beam_102``. +``testId = 103`` + Trave incastrata alle due estremità, caricata in mezzeria con una forza che + cresce linearmente e poi resta costante (``ldem.scenarios.ClampedBeam``). È + l'unica prova caricata con una forza invece che con uno spostamento. Vedi + ``examples/example1_clamped_beam``. + +Per aggiungere una prova nuova si crea una sottoclasse di +``ldem.scenarios.Scenario`` (vedi :doc:`model`). + +Perturbazione della mesh +------------------------ + +Il parametro ``meshPerturbation`` sposta in modo casuale i nodi interni. Il +suo valore è la deviazione standard come frazione della lunghezza del modulo: +``0`` (il predefinito) mantiene il reticolo regolare e qualsiasi valore +positivo attiva la perturbazione con quel valore. I numeri casuali seguono +``seed``. + +.. code-block:: matlab + + >> params = ldem.Parameters(testId=101, nModules=[6 3 3], meshPerturbation=0.02); + +Cosa si ottiene: la struttura ``results`` +----------------------------------------- + +.. list-table:: + :header-rows: 1 + :widths: 22 78 + + * - Campo + - Contenuto + * - ``info`` + - Versione di ldem, data, versione di MATLAB, tempo di esecuzione [s]. + * - ``params`` + - I parametri usati, come struttura semplice (con i valori derivati). + * - ``model`` + - Conteggi e massa del modello: moduli, nodi, barre per tipo, gradi di + libertà bloccati, massa totale e volume. + * - ``material`` + - Dati del materiale (E, Gf, ...), coefficienti del reticolo, lunghezza + critica e statistiche della deformazione critica (media, coefficiente + di variazione, minimo e massimo). + * - ``mesh`` + - Posizioni iniziali dei nodi, vincoli (``fixed``), masse, barre, + lunghezze e tipi di barra. + * - ``barProps`` + - Rigidezza, deformazione critica e deformazione di rottura di ogni barra. + * - ``controlNodes`` + - Tempo e spostamento, velocità e accelerazione dei nodi di controllo. + * - ``reactions`` + - Tempo e forza di reazione ``[Rx Ry Rz]`` della prova: forza verticale + nei punti di carico (prova 102), forza alle estremità incastrate + (prova 103); ``NaN`` dove la prova non la definisce. + * - ``energy`` + - Tempo, energie cinetica, elastica, di danno e di smorzamento [J], la + loro somma (``internal``), l'energia delle barre rotte + (``brokenBars``), il lavoro esterno, il bilancio (``balance``, esterno + meno interno) e la velocità di danno. + * - ``trackedBar`` + - Deformazione, forza ed energia di danno di una barra a ogni passo + (opzionale). + * - ``snapshots`` + - Passo, tempo, numero di barre intatte/danneggiate/rotte e copie + compatte degli spostamenti, dello stato di danno e dell'energia + cinetica nodale nei passi salvati. + * - ``final`` + - Spostamento, velocità, forza e stato di danno finali, e l'energia + cinetica di ogni nodo. + +Il ``balance`` energetico è un controllo della simulazione: deve essere una +piccola frazione (meno dell'1 %) del lavoro esterno finale. L'energia cinetica +totale è ``energy.kinetic``; quella di ogni nodo è in ``final.kineticEnergy``. + +``results.mat`` contiene questa struttura e si carica senza il pacchetto: + +.. code-block:: matlab + + >> data = load("output/results.mat"); + >> results = data.results; + +File di uscita +-------------- + +``results.mat`` + La struttura ``results`` (formato v7.3, leggibile da Python con ``h5py``). +``snapshot_0000.mac``, ``snapshot_0001.mac``, ... + Macro ANSYS con il reticolo deformato. Le barre sono elementi di tipo 1 + (intatte), 2 (danneggiate) e 5 (rotte). I gradi di libertà bloccati sono + elencati come ``D,nodo,direzione`` e lo spostamento imposto ai nodi + caricati, misurato dalla posizione iniziale, come + ``D,nodo,direzione,valore``. Nella prova 103 le forze applicate sono + elencate come ``F,nodo,direzione,valore``. +``snapshot_0000.vtu``, ... e ``snapshots.pvd`` + File VTK. Aprire ``snapshots.pvd`` in `ParaView `_; + colorare per ``damageState`` (dati di cella) per vedere le fessure e usare + il cursore del tempo per seguirle. Spostamento e velocità sono dati di + punto. + +I file ANSYS e VTK vengono scritti al tempo zero e ogni +``params.output.snapshotEvery`` passi. + +Eseguire i test +--------------- + +.. code-block:: matlab + + >> addpath tests + >> run_tests % test rapidi + >> run_tests(IncludeSlow=true) % anche i test lenti diff --git a/docs/source/pt/authors.rst b/docs/source/pt/authors.rst new file mode 100644 index 0000000..f3fc683 --- /dev/null +++ b/docs/source/pt/authors.rst @@ -0,0 +1,17 @@ +Autores +======= + +Esta lista é gerada automaticamente a partir dos commits do histórico do git +(pessoas com o mesmo nome ou e-mail são unificadas com ``.mailmap``) e dos +autores de ``CITATION.cff``. Autores sem commits neste repositório aparecem +com ``-``. A mesma lista está em ``AUTHORS.md``. + +.. include:: ../_generated/authors.rst + +Para atualizá-la depois de novos commits, construa a documentação ou execute: + +.. code-block:: bash + + python docs/tools/generate_authors.py + +Se uma pessoa aparecer duas vezes, adicione uma linha ao ``.mailmap``. diff --git a/docs/source/pt/contributing.rst b/docs/source/pt/contributing.rst new file mode 100644 index 0000000..4576e89 --- /dev/null +++ b/docs/source/pt/contributing.rst @@ -0,0 +1,16 @@ +Contribuir +========== + +A documentação da API é gerada a partir dos comentários dos ``.m``. O +docstring deve ser o bloco de comentários colocado **imediatamente depois** da +linha ``function`` (antes de qualquer ``global``). Os comentários do código +são escritos em inglês. + +.. code-block:: matlab + + function ini = CALOAD() + % CALOAD Resumo em uma linha. + % Descrição mais longa. + global ... + +Veja ``CONTRIBUTING.md`` na raiz do repositório. diff --git a/docs/source/pt/docs.rst b/docs/source/pt/docs.rst new file mode 100644 index 0000000..86545fd --- /dev/null +++ b/docs/source/pt/docs.rst @@ -0,0 +1,68 @@ +Construir esta documentação +=========================== + +A documentação é escrita em inglês e traduzida para espanhol, português e +italiano; as quatro versões formam um único site e a barra lateral permite +trocar de idioma. A referência da API é gerada a partir dos comentários dos +``.m``. + +Requisitos +---------- + +* Python 3.9 ou superior. +* ``git`` (a lista de autores é gerada a partir do histórico de commits; com um + clone superficial execute antes ``git fetch --unshallow``). +* Não é necessário MATLAB; a API é lida do texto das fontes. + +.. code-block:: bash + + pip install -r docs/requirements.txt + +Construção +---------- + +A partir da raiz do repositório, com qualquer uma destas opções: + +.. code-block:: bash + + sphinx-build -W --keep-going -b html docs/source docs/build/html + +.. code-block:: bash + + cd docs && make html + +.. code-block:: matlab + + >> buildtool docs + +Abra ``docs/build/html/index.html`` em um navegador. ``-W`` transforma os +avisos em erros: a documentação deve ser construída sem nenhum. +``buildtool clean`` apaga o resultado. + +Onde fica cada coisa +-------------------- + +``docs/source/en/`` + O texto de referência, em inglês. +``docs/source/es/``, ``pt/``, ``it/`` + Traduções. Cada página tem o mesmo nome de arquivo que em ``en/`` para que + a lista de idiomas da barra lateral leve à mesma página. +``docs/source/api/`` + Referência da API, gerada a partir dos comentários dos ``.m``. +``docs/tools/generate_authors.py`` + Escreve a página de autores e ``AUTHORS.md`` (executado pela construção). + +Escrever ou alterar uma página +------------------------------ + +1. Edite a página em inglês em ``docs/source/en/``. +2. Aplique a mesma alteração às traduções. Uma página nova precisa de um + arquivo com o mesmo nome em cada idioma e de uma entrada em cada + ``index.rst``. +3. Construa com ``-W`` e corrija qualquer aviso. + +Publicação +---------- + +O workflow ``.github/workflows/docs.yml`` constrói a documentação a cada pull +request e a publica no GitHub Pages quando ``main`` muda. diff --git a/docs/source/pt/index.rst b/docs/source/pt/index.rst new file mode 100644 index 0000000..926cd52 --- /dev/null +++ b/docs/source/pt/index.rst @@ -0,0 +1,13 @@ +Guia do usuário +=============== + +.. toctree:: + :maxdepth: 1 + + introduction + installation + usage + model + contributing + docs + authors diff --git a/docs/source/pt/installation.rst b/docs/source/pt/installation.rst new file mode 100644 index 0000000..83da9d4 --- /dev/null +++ b/docs/source/pt/installation.rst @@ -0,0 +1,37 @@ +Instalação +========== + +Requisitos: MATLAB R2022b ou superior (desenvolvido e testado na R2023b). O +pacote usa o bloco ``arguments`` e a sintaxe nome=valor; a suíte de testes e o +``buildtool`` exigem a R2022b. Nenhum toolbox é necessário. + +.. code-block:: bash + + git clone ldem-matlab + cd ldem-matlab + +.. code-block:: matlab + + >> setup_path + +Verifique a instalação com os testes rápidos: + +.. code-block:: matlab + + >> buildtool test + +Tarefas para desenvolvedores (``buildtool`` é executado a partir da raiz do +repositório): + +.. code-block:: matlab + + >> buildtool % análise estática + testes rápidos (padrão) + >> buildtool check % somente o analisador de código + >> buildtool testAll % todos os testes, inclusive os lentos + >> buildtool docs % construir esta documentação (requer Python) + >> buildtool clean % apagar os arquivos gerados + +``buildtool test`` escreve ``test-results/results.xml`` (JUnit) e +``code-coverage/coverage.xml`` (Cobertura). + +Para construir esta documentação sem MATLAB, veja :doc:`docs`. diff --git a/docs/source/pt/introduction.rst b/docs/source/pt/introduction.rst new file mode 100644 index 0000000..e3605b7 --- /dev/null +++ b/docs/source/pt/introduction.rst @@ -0,0 +1,24 @@ +Introdução +========== + +O **Método dos Elementos Discretos tipo Treliça (LDEM)** modela um contínuo +como um reticulado regular de nós ligados por barras dispostas em módulos +cúbicos (arestas mais diagonais). As massas são concentradas nos nós, as leis +constitutivas das barras incluem dano/fratura e as equações de movimento são +integradas com um esquema explícito de diferenças centrais. As energias +(externa, cinética, elástica, dissipada) são acompanhadas a cada passo. + +Principais partes do pacote ``ldem`` (ver :doc:`../api/index`): + +* ``ldem.Parameters`` / ``ldem.io.readInputFile`` – dados de entrada validados. +* ``ldem.mesh`` – nós, barras, massas e geometria das barras. +* ``ldem.material`` – rigidez das barras, deformação crítica e lei bilinear de dano. +* ``ldem.scenarios`` – apoios, cargas e reações de cada ensaio. +* ``ldem.solver`` – integração no tempo e balanço de energia. +* ``ldem.runSimulation`` – a simulação completa, com saída ``results.mat``, + ANSYS e VTK. + +As rotinas do programa original (``ini_DEM3``, ``read_dat0``, ``RMEC``, +``BOUND``, ``CALOAD``, ``ENERG2``, ...) são mantidas no histórico do git, com +a tag ``legacy-reference``; a linha ``Legacy:`` de cada ajuda indica a rotina +que ela substitui. diff --git a/docs/source/pt/model.rst b/docs/source/pt/model.rst new file mode 100644 index 0000000..b2e042d --- /dev/null +++ b/docs/source/pt/model.rst @@ -0,0 +1,111 @@ +Construir um modelo diferente +============================= + +Um modelo é definido por três coisas: a **geometria** do reticulado, o +**material** e o **ensaio** (apoios e cargas). As duas primeiras são +parâmetros; a terceira é uma classe *cenário*. Qualquer uma pode ser alterada +sem tocar no solver. + +1. Alterar a geometria e o material +----------------------------------- + +Tudo é uma propriedade de ``ldem.Parameters``: + +.. code-block:: matlab + + >> params = ldem.Parameters(testId=101, ... + moduleLength=0.002, ... % aresta do módulo cúbico [m] + nModules=[21 6 6], ... % nós em x, y e z + youngModulus=30e9, density=2400, poissonRatio=0.2, ... + fractureEnergy=80, criticalDistance=0.02, ... + meshPerturbation=0.02); % malha irregular (opcional) + +* ``nModules = [M N L]`` é o número de nós da grade em cada eixo, de modo que + o prisma tem ``(M-1)*(N-1)*(L-1)`` módulos. +* ``randomFieldFile`` multiplica a deformação crítica de cada barra por um + valor lido de um arquivo de texto (campo aleatório da resistência). +* ``dt`` deve ser menor que ``params.criticalTimeStep``; ``Parameters`` + rejeita um valor instável e explica o motivo. + +Os mesmos dados podem vir de um arquivo de entrada no formato do programa +original: ``ldem.Parameters.fromFile("DATA0.DAT", ...)``; os pares +nome=valor adicionais substituem os do arquivo. A malha pode ser construída e +inspecionada antes de executar qualquer coisa: + +.. code-block:: matlab + + >> mesh = ldem.mesh.buildMesh(params); + >> fprintf("%d nós, %d barras\n", size(mesh.nodes0, 1), size(mesh.bars, 1)); + +2. Alterar o ensaio: escrever um cenário +---------------------------------------- + +Um *cenário* diz quais graus de liberdade estão fixos, como a carga é +aplicada a cada passo de tempo e qual reação é informada. O solver nunca +consulta o número do ensaio; ele pergunta ao cenário. Para modelar um ensaio +novo, crie uma subclasse de ``ldem.scenarios.Scenario`` em +``src/+ldem/+scenarios/``. + +O exemplo é uma viga em balanço segundo :math:`z`: a primeira camada de nós +centrais é engastada e, na extremidade livre, aplica-se em :math:`y` uma força +que cresce linearmente. + +.. code-block:: matlab + + classdef Cantilever < ldem.scenarios.Scenario + properties (Constant) + testId = 104 % número novo, único + end + properties + forceRate (1,1) double = 500 % [N/s] em cada nó carregado + end + methods + function fixed = fixedDofs(~, nodes0, params) + z = nodes0(:, 3); + atStart = abs(z - 0.5*params.moduleLength) < 0.01*params.moduleLength; + fixed = false(size(nodes0)); + fixed(atStart, :) = true; % x, y e z fixos + end + function state = applyLoads(obj, state, mesh, params) + L1 = params.nModules(3) - 1; + z = mesh.nodes0(:, 3); + atEnd = abs(z - (L1 - 0.5)*params.moduleLength) < 0.01*params.moduleLength; + state.appliedForce(:) = 0; + state.appliedForce(atEnd, 2) = obj.forceRate * state.time; + end + end + end + +Regras: + +* ``fixedDofs`` devolve uma matriz lógica de ``nNodes`` por 3, verdadeira onde + o nó não pode se mover (``1 = x``, ``2 = y``, ``3 = z``). +* ``applyLoads`` é executado a cada passo. Um ensaio **controlado por + deslocamento** atribui ``state.displacement`` dos nós carregados (ver + ``UniaxialTension``); um **controlado por força** atribui + ``state.appliedForce`` em newtons (ver ``ClampedBeam``) e o solver conta seu + trabalho na energia externa. +* Redefina ``reactions`` se o ensaio informar uma força de reação (padrão: + ``NaN``). +* Os nós centrais dos módulos estão em múltiplos semi-inteiros de + ``moduleLength``; selecione os nós com uma tolerância pequena, nunca com + ``==``. + +3. Registrar e executar +----------------------- + +O objeto pode ser passado diretamente, sem registrar nada: + +.. code-block:: matlab + + >> scenario = ldem.scenarios.Cantilever(forceRate=1000); + >> results = ldem.runSimulation(params, Scenario=scenario, ... + OutputFolder="output", Formats=["mat" "vtk"]); + +ou adicioná-lo à lista de ``ldem.scenarios.fromTestId`` para que +``testId = 104`` o encontre, que é o que faz um arquivo de entrada. Depois, +adicione um teste em ``tests/unit`` e, se for um caso de referência, um +exemplo em ``examples/`` (ver ``examples/example1_clamped_beam``). + +O resultado é a mesma estrutura ``results`` de qualquer outro ensaio, ver +:doc:`usage`. diff --git a/docs/source/pt/usage.rst b/docs/source/pt/usage.rst new file mode 100644 index 0000000..4aec8b1 --- /dev/null +++ b/docs/source/pt/usage.rst @@ -0,0 +1,146 @@ +Uso +=== + +Executar uma simulação +---------------------- + +.. code-block:: matlab + + >> setup_path % adiciona src/ ao path do MATLAB + >> params = ldem.Parameters(testId=101, nModules=[6 3 3], totalTime=2e-4, ... + fractureEnergy=0.1, ... + output=struct('snapshotEvery', 250, 'controlNodesEvery', 10, ... + 'energyEvery', 10, 'trackedBarEvery', 0)); + >> results = ldem.runSimulation(params, OutputFolder="output", ... + Formats=["mat" "ansys" "vtk"]); + >> ldem.post.plotEnergy(results); + +``ldem.Parameters`` valida cada valor ao atribuí-lo e explica o que está +errado (por exemplo, um passo de tempo instável). A versão completa e pronta +para executar está em ``examples/tension_101/runTension.m``. + +Para usar um arquivo de entrada no formato do programa original: + +.. code-block:: matlab + + >> params = ldem.Parameters.fromFile("DATA0.DAT"); + +Ensaios disponíveis +------------------- + +``testId = 101`` + Carga uniaxial: os nós centrais da última coluna de módulos se movem em + :math:`x` com velocidade imposta. +``testId = 102`` + Viga com dois apoios e dois pontos de carga. As posições são parâmetros de + ``ldem.scenarios.FourPointBending`` (``supportPosition``, ``loadPosition``, + em módulos a partir de cada extremidade); os valores padrão exigem uma viga + com mais de uns 70 módulos. Ver ``examples/beam_102``. +``testId = 103`` + Viga engastada nas duas extremidades, carregada no meio do vão com uma + força que cresce linearmente e depois se mantém constante + (``ldem.scenarios.ClampedBeam``). É o único ensaio carregado com força em + vez de deslocamento. Ver ``examples/example1_clamped_beam``. + +Para adicionar um ensaio novo, crie uma subclasse de +``ldem.scenarios.Scenario`` (ver :doc:`model`). + +Perturbação da malha +-------------------- + +O parâmetro ``meshPerturbation`` desloca aleatoriamente os nós interiores. Seu +valor é o desvio padrão como fração do comprimento do módulo: ``0`` (o padrão) +mantém o reticulado regular e qualquer valor positivo ativa a perturbação com +esse valor. Os números aleatórios seguem ``seed``. + +.. code-block:: matlab + + >> params = ldem.Parameters(testId=101, nModules=[6 3 3], meshPerturbation=0.02); + +O que se obtém: a estrutura ``results`` +--------------------------------------- + +.. list-table:: + :header-rows: 1 + :widths: 22 78 + + * - Campo + - Conteúdo + * - ``info`` + - Versão do ldem, data, versão do MATLAB, tempo de execução [s]. + * - ``params`` + - Os parâmetros usados, como estrutura simples (com valores derivados). + * - ``model`` + - Contagens e massa do modelo: módulos, nós, barras por tipo, graus de + liberdade fixos, massa total e volume. + * - ``material`` + - Dados do material (E, Gf, ...), coeficientes do reticulado, comprimento + crítico e estatísticas da deformação crítica (média, coeficiente de + variação, mínimo e máximo). + * - ``mesh`` + - Posições iniciais dos nós, apoios (``fixed``), massas, barras, + comprimentos e tipos de barra. + * - ``barProps`` + - Rigidez, deformação crítica e deformação de ruptura de cada barra. + * - ``controlNodes`` + - Tempo e deslocamento, velocidade e aceleração dos nós de controle. + * - ``reactions`` + - Tempo e força de reação ``[Rx Ry Rz]`` do ensaio: força vertical nos + pontos de carga (ensaio 102), força nas extremidades engastadas + (ensaio 103); ``NaN`` onde o ensaio não a define. + * - ``energy`` + - Tempo, energias cinética, elástica, de dano e de amortecimento [J], sua + soma (``internal``), a energia das barras rompidas (``brokenBars``), o + trabalho externo, o balanço (``balance``, externo menos interno) e a + taxa de dano. + * - ``trackedBar`` + - Deformação, força e energia de dano de uma barra a cada passo + (opcional). + * - ``snapshots`` + - Passo, tempo, número de barras intactas/danificadas/rompidas e cópias + compactas dos deslocamentos, do estado de dano e da energia cinética + nodal nos passos salvos. + * - ``final`` + - Deslocamento, velocidade, força e estado de dano finais, e a energia + cinética de cada nó. + +O ``balance`` de energia é uma verificação da simulação: deve ser uma fração +pequena (menos de 1 %) do trabalho externo final. A energia cinética total é +``energy.kinetic``; a de cada nó está em ``final.kineticEnergy``. + +``results.mat`` contém esta estrutura e carrega-se sem o pacote: + +.. code-block:: matlab + + >> data = load("output/results.mat"); + >> results = data.results; + +Arquivos de saída +----------------- + +``results.mat`` + A estrutura ``results`` (formato v7.3, legível em Python com ``h5py``). +``snapshot_0000.mac``, ``snapshot_0001.mac``, ... + Macros do ANSYS com o reticulado deformado. As barras são elementos do tipo + 1 (intactas), 2 (danificadas) e 5 (rompidas). Os graus de liberdade fixos + são listados como ``D,nó,direção`` e o deslocamento imposto aos nós + carregados, medido a partir da posição inicial, como + ``D,nó,direção,valor``. No ensaio 103 as forças aplicadas são listadas como + ``F,nó,direção,valor``. +``snapshot_0000.vtu``, ... e ``snapshots.pvd`` + Arquivos VTK. Abra ``snapshots.pvd`` no `ParaView `_; + colora por ``damageState`` (dados de célula) para ver as fissuras e use o + controle de tempo para acompanhá-las. Deslocamento e velocidade são dados + de ponto. + +Os arquivos ANSYS e VTK são escritos no tempo zero e a cada +``params.output.snapshotEvery`` passos. + +Executar os testes +------------------ + +.. code-block:: matlab + + >> addpath tests + >> run_tests % testes rápidos + >> run_tests(IncludeSlow=true) % também os testes lentos diff --git a/docs/tools/generate_authors.py b/docs/tools/generate_authors.py new file mode 100644 index 0000000..60819ad --- /dev/null +++ b/docs/tools/generate_authors.py @@ -0,0 +1,101 @@ +#!/usr/bin/env python +"""Generate the list of authors from the git history. + +The authors are the people who made commits (``git shortlog``, with the +identities merged through ``.mailmap``) plus the authors listed in +``CITATION.cff`` who have no commit yet (original code, scientific +supervision, ...). Nothing is typed by hand: run this script, or build the +documentation, and the list is up to date. + +Outputs + AUTHORS.md list for the repository root + docs/source/_generated/authors.rst table included by the "Authors" pages + +Usage: python docs/tools/generate_authors.py +""" +import re +import subprocess +from pathlib import Path + +ROOT = Path(__file__).resolve().parents[2] + + +def git_authors(): + """Return [(name, commits)] ordered by number of commits (mailmap applied).""" + try: + out = subprocess.run( + ["git", "shortlog", "-sn", "--all"], + cwd=ROOT, capture_output=True, text=True, check=True, encoding="utf-8", + ).stdout + except (OSError, subprocess.CalledProcessError): + return None + authors = [] + for line in out.splitlines(): + match = re.match(r"\s*(\d+)\s+(.+)", line) + if match and "[bot]" not in match.group(2): + authors.append((match.group(2).strip(), int(match.group(1)))) + return authors + + +def citation_authors(): + """Names listed under ``authors:`` in CITATION.cff.""" + path = ROOT / "CITATION.cff" + if not path.is_file(): + return [] + names, family = [], None + in_authors = False + for line in path.read_text(encoding="utf-8").splitlines(): + if re.match(r"^authors:", line): + in_authors = True + elif in_authors and re.match(r"^\S", line): + in_authors = False + if not in_authors: + continue + m = re.search(r"family-names:\s*(.+)", line) + if m: + family = m.group(1).strip().strip('"') + m = re.search(r"given-names:\s*(.+)", line) + if m and family: + names.append(f"{m.group(1).strip().strip(chr(34))} {family}") + family = None + return names + + +def collect(): + authors = git_authors() + cited = citation_authors() + if authors is None: # no git available: only the citation file + return [(n, None) for n in cited] + known = {n.casefold() for n, _ in authors} + return authors + [(n, 0) for n in cited if n.casefold() not in known] + + +def write(authors): + gen = ROOT / "docs" / "source" / "_generated" + gen.mkdir(parents=True, exist_ok=True) + + def commits(n): + return "" if n is None else str(n) + + rows = "\n".join( + f" * - {name}\n - {commits(n) if n else '-'}" for name, n in authors + ) + (gen / "authors.rst").write_text( + ".. list-table::\n :header-rows: 1\n :widths: 75 25\n\n" + " * - Name\n - Commits\n" + rows + "\n", + encoding="utf-8", + ) + + md = ["# Authors", "", + "Generated from the git history and `CITATION.cff` by " + "`docs/tools/generate_authors.py`. Do not edit by hand.", "", + "| Name | Commits |", "|------|---------|"] + md += [f"| {name} | {commits(n) if n else '-'} |" for name, n in authors] + (ROOT / "AUTHORS.md").write_text("\n".join(md) + "\n", encoding="utf-8") + + +if __name__ == "__main__": + result = collect() + write(result) + for name, n in result: + print(f"{name}: {n}") diff --git a/src/+ldem/+io/exportAnsys.m b/src/+ldem/+io/exportAnsys.m index f04fcb0..ab23c0d 100644 --- a/src/+ldem/+io/exportAnsys.m +++ b/src/+ldem/+io/exportAnsys.m @@ -18,6 +18,9 @@ % (mesh.fixed), with value zero. The applied-loads section then gives, as % "D,node,direction,value", the displacement imposed on the loaded nodes % measured from their initial position (nothing is written at time zero). +% For a scenario loaded with forces (test 103) a further section lists the +% applied forces of the state as "F,node,direction,value" (FX, FY, FZ); it is +% omitted when there are none. % Note that the node coordinates of the file are the current positions, so % the file shows the state of the simulation; it is not a restart of the % analysis from the undeformed lattice. Node positions are written in @@ -129,6 +132,24 @@ end fprintf(fid, '\n'); +% Applied forces: scenarios loaded with forces (test 103) set state.appliedForce. +% The section is written only when there is a force, so that the files of the +% displacement-controlled tests stay equal to the legacy ones. +forces = zeros(nNodes, 3); +if isfield(state, 'appliedForce') + forces = state.appliedForce; +end +if any(forces(:) ~= 0) + forceLabels = ["FX", "FY", "FZ"]; + fprintf(fid, '!FORCAS APLICADAS\n'); + for node = find(any(forces ~= 0, 2)).' + for direction = find(forces(node, :) ~= 0) + fprintf(fid, 'F,%d,%s,%g\n', node, forceLabels(direction), forces(node, direction)); + end + end + fprintf(fid, '\n'); +end + fprintf(fid, '/VIEW,1,0,-1,0\n'); fprintf(fid, 'EPLOT\n'); fprintf(fid, '\n'); diff --git a/src/+ldem/+scenarios/Scenario.m b/src/+ldem/+scenarios/Scenario.m index 6bf7e72..7cbc8b8 100644 --- a/src/+ldem/+scenarios/Scenario.m +++ b/src/+ldem/+scenarios/Scenario.m @@ -13,7 +13,8 @@ % 4. Register the class in ldem.scenarios.fromTestId. % % See also ldem.scenarios.UniaxialTension, - % ldem.scenarios.FourPointBending, ldem.scenarios.fromTestId. + % ldem.scenarios.FourPointBending, ldem.scenarios.ClampedBeam, + % ldem.scenarios.fromTestId. properties (Abstract, Constant) % Number that identifies the scenario in the input file (TEST). diff --git a/src/+ldem/+solver/computeEnergies.m b/src/+ldem/+solver/computeEnergies.m index ab5fb5c..775ce33 100644 --- a/src/+ldem/+solver/computeEnergies.m +++ b/src/+ldem/+solver/computeEnergies.m @@ -28,8 +28,10 @@ % compares the work of the last step with the energy at its end, an error of % about 1/N for energies that grow like t^2). % -% The balance does not close when the loaded nodes are not held by the -% scenario, as in the legacy tension test (see +% In a scenario loaded with forces (ldem.scenarios.ClampedBeam) the work of +% the applied forces on the free degrees of freedom is part of the external +% work. The balance does not close when a prescribed motion is not held by +% the scenario, as happened in the legacy tension test (fixed here, see % ldem.scenarios.UniaxialTension). % % For a damaged bar with critical strain EP, largest strain EM and diff --git a/src/+ldem/Parameters.m b/src/+ldem/Parameters.m index 43a0310..0d3af9b 100644 --- a/src/+ldem/Parameters.m +++ b/src/+ldem/Parameters.m @@ -26,7 +26,8 @@ properties % Test identifier selecting the boundary conditions and loads - % (101 = uniaxial tension, 102 = four-point bending). Legacy: TEST. + % (101 = uniaxial tension, 102 = four-point bending, 103 = beam + % clamped at both ends loaded with a force). Legacy: TEST. testId (1,1) double {mustBeInteger, mustBePositive} = 101 % Seed of the random number generator used for the optional mesh diff --git a/tests/unit/TestExporters.m b/tests/unit/TestExporters.m index e53ac05..9e8a37b 100644 --- a/tests/unit/TestExporters.m +++ b/tests/unit/TestExporters.m @@ -94,6 +94,24 @@ function ansysHasNoImposedDisplacementAtTimeZero(testCase) testCase.verifyFalse(any(startsWith(lines, "D,") & count(lines, ",") == 3)); end + function ansysListsTheAppliedForces(testCase) + path = fullfile(testCase.tempFolder(), "forces.mac"); + state = testCase.State; + state.appliedForce = zeros(size(state.displacement)); + state.appliedForce([2 5], 2) = [3.5; -1]; + ldem.io.exportAnsys(path, testCase.Mesh, state); + lines = splitlines(string(fileread(path))); + testCase.verifyEqual(lines(startsWith(lines, "F,")), ["F,2,FY,3.5"; "F,5,FY,-1"]); + end + + function ansysHasNoForceSectionWithoutAppliedForces(testCase) + path = fullfile(testCase.tempFolder(), "noforces.mac"); + ldem.io.exportAnsys(path, testCase.Mesh, testCase.State); + lines = splitlines(string(fileread(path))); + testCase.verifyFalse(any(startsWith(lines, "F,"))); + testCase.verifyFalse(any(contains(lines, "FORCAS"))); + end + function ansysCoordinatesAreTheCurrentPositions(testCase) path = fullfile(testCase.tempFolder(), "state.mac"); ldem.io.exportAnsys(path, testCase.Mesh, testCase.State); From 47f83c4c8eb9d4e12ecc9b27d3baf1ba8037722d Mon Sep 17 00:00:00 2001 From: Boris Rojo Tanzi <71112604+borisrojotanzi@users.noreply.github.com> Date: Fri, 6 Nov 2026 14:05:41 -0300 Subject: [PATCH 09/13] feat: generate the random field in memory and store it in the results --- CHANGELOG.md | 8 ++ docs/known-issues/KNOWN_ISSUES.es.md | 15 +++ docs/known-issues/KNOWN_ISSUES.md | 13 ++ docs/source/api/index.rst | 1 + docs/source/en/model.rst | 5 + docs/source/es/model.rst | 5 + docs/source/it/model.rst | 6 + docs/source/pt/model.rst | 5 + src/+ldem/+material/buildBarProperties.m | 30 ++++- src/+ldem/+material/generateRandomField.m | 144 ++++++++++++++++++++++ src/+ldem/+material/summarizeMaterial.m | 4 + src/+ldem/Parameters.m | 38 +++++- tests/unit/TestGenerateRandomField.m | 108 ++++++++++++++++ tests/unit/TestMaterial.m | 39 ++++++ tests/unit/TestParameters.m | 16 +++ tests/unit/TestRunSimulation.m | 16 +++ 16 files changed, 446 insertions(+), 7 deletions(-) create mode 100644 src/+ldem/+material/generateRandomField.m create mode 100644 tests/unit/TestGenerateRandomField.m diff --git a/CHANGELOG.md b/CHANGELOG.md index 8760b43..ea047bf 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -71,6 +71,14 @@ instead of the legacy routines, `Parameters.testId` and `Scenario` mention test 103, the results tables include `brokenBars` and the reaction of test 103, and the Portuguese and Spanish READMEs translate the `buildtool` comments. +- Random field generated in memory: `ldem.material.generateRandomField` ports the + external script `Aleat_novo4.m` (Weibull values on a grid of poles, trilinear + interpolation to the bar centres), vectorised and without toolboxes. It is + switched on with `Parameters.randomFieldCv > 0`, with + `randomFieldCorrelationLength` (in module lengths, default 3) and + `randomFieldSeed` (default 515); no text file is needed. The multiplier of each + bar is stored in `results.barProps.randomField` and its origin and statistics in + `results.material.randomField`, also for a field read from a file. ### Changed - Example inputs moved to `examples/beam_102/`. diff --git a/docs/known-issues/KNOWN_ISSUES.es.md b/docs/known-issues/KNOWN_ISSUES.es.md index 5a027bf..737faaf 100644 --- a/docs/known-issues/KNOWN_ISSUES.es.md +++ b/docs/known-issues/KNOWN_ISSUES.es.md @@ -122,3 +122,18 @@ comportamiento original). No queda ningún ítem abierto. error que el ítem 3): su posición se sobrescribía en cada paso y luego se movían libremente, así que ninguna fuerza hacía trabajo sobre ellos y el balance de energía no podía cerrar. **Corregido** junto con el ítem 3. +20. **`Aleat_novo4.m` (generador externo del archivo de campo aleatorio): la + media no es 1 y la interpolación tiene dos erratas.** La escala de la + Weibull es `Gamma(1+1/k)` en lugar de `1/Gamma(1+1/k)`, así que la media del + campo es `Gamma(1+1/k)^2` (0,957 para `Cv = 0.05`, la media de + `arquivo_3lc_rnao_cv05`). En la interpolación trilineal el término x-z usa + `V6-V5-V3+V1` en lugar de `V6-V5-V2+V1` y `ZZp(ii)` en lugar de `ZZp(iip)`, + lo que agrega dispersión: el archivo incluido tiene un CV de 0,054 aunque + los polos tenían 0,05, mientras que una interpolación correcta siempre lo + reduce. El script además necesitaba `BARI.txt` (centros de las barras), que + ningún código del repositorio escribe. **Resuelto**: + `ldem.material.generateRandomField` (se activa con `params.randomFieldCv`) + usa media 1 y la interpolación trilineal exacta, y toma los centros de las + barras de la malla. Por eso sus campos no son iguales a los archivos + legacy; para reproducir una corrida legacy hay que seguir usando + `randomFieldFile`. diff --git a/docs/known-issues/KNOWN_ISSUES.md b/docs/known-issues/KNOWN_ISSUES.md index 6f9c685..bcfed9b 100644 --- a/docs/known-issues/KNOWN_ISSUES.md +++ b/docs/known-issues/KNOWN_ISSUES.md @@ -115,3 +115,16 @@ behaviour is kept). No item is open. as item 3): their position was overwritten at every step and then moved freely, so no force did work on them and the energy balance could not close. **Corrected** together with item 3. +20. **`Aleat_novo4.m` (external generator of the random field file): the mean is + not 1 and the interpolation has two typos.** The Weibull scale is + `Gamma(1+1/k)` instead of `1/Gamma(1+1/k)`, so the mean of the field is + `Gamma(1+1/k)^2` (0.957 for `Cv = 0.05`, the mean of + `arquivo_3lc_rnao_cv05`). In the trilinear interpolation the x-z term uses + `V6-V5-V3+V1` instead of `V6-V5-V2+V1` and `ZZp(ii)` instead of `ZZp(iip)`, + which adds scatter: the bundled file has a CV of 0.054 although the poles + had 0.05, while a correct interpolation always lowers it. The script also + needed `BARI.txt` (bar centres), which no code of the repository writes. + **Resolved**: `ldem.material.generateRandomField` (enabled with + `params.randomFieldCv`) uses mean 1 and the exact trilinear interpolation + and takes the bar centres from the mesh. Its fields are therefore not equal + to the legacy files; to reproduce a legacy run keep `randomFieldFile`. diff --git a/docs/source/api/index.rst b/docs/source/api/index.rst index 22c9eed..95313f2 100644 --- a/docs/source/api/index.rst +++ b/docs/source/api/index.rst @@ -56,6 +56,7 @@ Material .. mat:autofunction:: ldem.material.latticeCoefficients .. mat:autofunction:: ldem.material.computeBarStiffness .. mat:autofunction:: ldem.material.buildBarProperties +.. mat:autofunction:: ldem.material.generateRandomField .. mat:autofunction:: ldem.material.bilinearLaw .. mat:autofunction:: ldem.material.summarizeMaterial diff --git a/docs/source/en/model.rst b/docs/source/en/model.rst index 6b9654e..f69811e 100644 --- a/docs/source/en/model.rst +++ b/docs/source/en/model.rst @@ -24,6 +24,11 @@ Everything is a property of ``ldem.Parameters``: prism has ``(M-1)*(N-1)*(L-1)`` modules. * ``randomFieldFile`` multiplies the critical strain of each bar by a value read from a text file (a random field of the material strength). +* ``randomFieldCv`` generates that random field in memory instead, with no + file: Weibull values with mean 1 and that coefficient of variation on a grid + of poles spaced ``randomFieldCorrelationLength`` module lengths apart (default + 3), interpolated to each bar; ``randomFieldSeed`` fixes the random numbers. + The value of each bar is kept in ``results.barProps.randomField``. * ``dt`` must be below ``params.criticalTimeStep``; ``Parameters`` rejects an unstable value and says so. diff --git a/docs/source/es/model.rst b/docs/source/es/model.rst index 5da99d0..1bfa52d 100644 --- a/docs/source/es/model.rst +++ b/docs/source/es/model.rst @@ -24,6 +24,11 @@ Todo es una propiedad de ``ldem.Parameters``: modo que el prisma tiene ``(M-1)*(N-1)*(L-1)`` módulos. * ``randomFieldFile`` multiplica la deformación crítica de cada barra por un valor leído de un archivo de texto (campo aleatorio de la resistencia). +* ``randomFieldCv`` genera ese campo aleatorio en memoria, sin archivo: valores + Weibull con media 1 y ese coeficiente de variación en una grilla de polos + separados ``randomFieldCorrelationLength`` longitudes de módulo (3 por + defecto), interpolados a cada barra; ``randomFieldSeed`` fija los números + aleatorios. El valor de cada barra queda en ``results.barProps.randomField``. * ``dt`` debe ser menor que ``params.criticalTimeStep``; ``Parameters`` rechaza un valor inestable y lo explica. diff --git a/docs/source/it/model.rst b/docs/source/it/model.rst index e7c4b40..31a5024 100644 --- a/docs/source/it/model.rst +++ b/docs/source/it/model.rst @@ -24,6 +24,12 @@ Tutto è una proprietà di ``ldem.Parameters``: quindi il prisma ha ``(M-1)*(N-1)*(L-1)`` moduli. * ``randomFieldFile`` moltiplica la deformazione critica di ogni barra per un valore letto da un file di testo (campo casuale della resistenza). +* ``randomFieldCv`` genera invece quel campo casuale in memoria, senza file: + valori di Weibull con media 1 e quel coefficiente di variazione su una + griglia di poli distanziati ``randomFieldCorrelationLength`` lunghezze di + modulo (3 per default), interpolati su ogni barra; ``randomFieldSeed`` fissa + i numeri casuali. Il valore di ogni barra resta in + ``results.barProps.randomField``. * ``dt`` deve essere minore di ``params.criticalTimeStep``; ``Parameters`` rifiuta un valore instabile e ne spiega il motivo. diff --git a/docs/source/pt/model.rst b/docs/source/pt/model.rst index b2e042d..378fadb 100644 --- a/docs/source/pt/model.rst +++ b/docs/source/pt/model.rst @@ -24,6 +24,11 @@ Tudo é uma propriedade de ``ldem.Parameters``: o prisma tem ``(M-1)*(N-1)*(L-1)`` módulos. * ``randomFieldFile`` multiplica a deformação crítica de cada barra por um valor lido de um arquivo de texto (campo aleatório da resistência). +* ``randomFieldCv`` gera esse campo aleatório na memória, sem arquivo: valores + Weibull com média 1 e esse coeficiente de variação numa grade de polos + espaçados ``randomFieldCorrelationLength`` comprimentos de módulo (3 por + padrão), interpolados para cada barra; ``randomFieldSeed`` fixa os números + aleatórios. O valor de cada barra fica em ``results.barProps.randomField``. * ``dt`` deve ser menor que ``params.criticalTimeStep``; ``Parameters`` rejeita um valor instável e explica o motivo. diff --git a/src/+ldem/+material/buildBarProperties.m b/src/+ldem/+material/buildBarProperties.m index 5c41d98..1cdcdd5 100644 --- a/src/+ldem/+material/buildBarProperties.m +++ b/src/+ldem/+material/buildBarProperties.m @@ -14,8 +14,10 @@ % KR = Lcr / L rupture strain / critical strain % % with the material data of ldem.Parameters, the failure-area factor CAF -% and the lattice coefficient alpha. EP is EP0 times a random field when -% params.randomFieldFile is set. +% and the lattice coefficient alpha. EP is EP0 times a random field, which +% is read from params.randomFieldFile when it is set, or generated in +% memory (ldem.material.generateRandomField) when params.randomFieldCv is +% positive. % % Inputs: % mesh Struct from ldem.mesh.buildMesh. @@ -23,8 +25,9 @@ % % Name-value options: % RandomField nBars-by-1 vector of multipliers of the critical strain. -% Overrides params.randomFieldFile. Default: use the file -% if there is one, otherwise all ones. +% Overrides params.randomFieldFile and params.randomFieldCv. +% Default: read the file if there is one, else generate the +% field if randomFieldCv > 0, otherwise all ones. % % Outputs: % barProps Struct of properties that stay constant during the simulation. @@ -38,6 +41,11 @@ % ruptureStrain ER = KR*EP, strain at which the bar breaks % criticalStrainMean scalar, mean of EP % criticalStrainCv scalar, coefficient of variation of EP +% randomField multiplier of EP0 of each bar (all ones without field) +% randomFieldInfo struct: source ("none", "file", "generated" or +% "given"), fieldMean, fieldCv and, for a generated +% field, the fields listed in +% ldem.material.generateRandomField % % Fields of history (nBars-by-1), updated by ldem.material.bilinearLaw: % @@ -59,7 +67,7 @@ % Legacy: NAYFES0, RMEC, the random-field loop of the main program, CALCOEV. % % See also ldem.material.bilinearLaw, ldem.material.computeBarStiffness, -% ldem.io.readRandomField. +% ldem.io.readRandomField, ldem.material.generateRandomField. arguments mesh (1,1) struct @@ -86,15 +94,25 @@ % Random scatter of the critical strain. if ~isempty(options.RandomField) field = options.RandomField; + fieldInfo = struct('source', "given"); elseif strlength(params.randomFieldFile) > 0 field = ldem.io.readRandomField(params.randomFieldFile, nBars); + fieldInfo = struct('source', "file", 'file', params.randomFieldFile); +elseif params.randomFieldCv > 0 + [field, fieldInfo] = ldem.material.generateRandomField(mesh.barCentres, ... + params.randomFieldCv, ... + params.randomFieldCorrelationLength * params.moduleLength, ... + params.randomFieldSeed); else field = ones(nBars, 1); + fieldInfo = struct('source', "none"); end if numel(field) ~= nBars error('ldem:material:randomFieldSize', ... 'The random field has %d values but the mesh has %d bars.', numel(field), nBars); end +fieldInfo.fieldMean = mean(field); +fieldInfo.fieldCv = std(field) / mean(field); criticalStrain = field .* baseCriticalStrain; barProps = struct(); @@ -104,6 +122,8 @@ barProps.ruptureStrain = ruptureRatio .* criticalStrain; barProps.criticalStrainMean = mean(criticalStrain); barProps.criticalStrainCv = std(criticalStrain) / mean(criticalStrain); +barProps.randomField = field; +barProps.randomFieldInfo = fieldInfo; history = struct(); history.tensionStiffness = stiffness; diff --git a/src/+ldem/+material/generateRandomField.m b/src/+ldem/+material/generateRandomField.m new file mode 100644 index 0000000..cee158d --- /dev/null +++ b/src/+ldem/+material/generateRandomField.m @@ -0,0 +1,144 @@ +function [field, info] = generateRandomField(barCentres, cv, correlationLength, seed) +%GENERATERANDOMFIELD Spatially correlated Weibull field of critical-strain multipliers. +% +% [field, info] = ldem.material.generateRandomField(barCentres, cv, +% correlationLength, seed) returns one positive multiplier per bar, so +% that bars close to each other get similar values. It replaces the +% external script Aleat_novo4.m and its text file: the field is computed +% in memory, in a fraction of a second, and ldem.runSimulation keeps it in +% the results. +% +% Method (the one of Aleat_novo4.m): +% +% 1. A regular grid of "poles" with spacing correlationLength covers +% the bar centres, with one extra pole on each side. +% 2. Each pole gets an independent Weibull value with mean 1 and +% coefficient of variation cv. The shape k solves +% Gamma(1+2/k) / Gamma(1+1/k)^2 = 1 + cv^2 +% and the scale is 1/Gamma(1+1/k). +% 3. The value of a bar is the trilinear interpolation of the 8 poles +% of the grid cell that contains its centre. +% +% The interpolation averages neighbouring poles, so the coefficient of +% variation of the bars (info.fieldCv) is somewhat smaller than cv; the +% larger the correlation length compared with the bars, the closer the +% values of neighbouring bars. +% +% Inputs: +% barCentres nBars-by-3 bar midpoints [m] (mesh.barCentres). +% cv Coefficient of variation of the pole values, > 0. +% correlationLength Pole spacing [m], a scalar or [lx ly lz]. +% seed Seed of the random numbers (non-negative integer). +% +% Outputs: +% field nBars-by-1 vector of positive multipliers. +% info Struct describing the field: +% source "generated" +% cv cv requested +% correlationLength 1-by-3 pole spacing [m] +% seed seed used +% weibullShape shape k of the pole distribution +% weibullScale scale of the pole distribution +% nPoles 1-by-3 number of poles along x, y, z +% fieldMean mean of field +% fieldCv coefficient of variation of field +% +% The random numbers come from a private stream (Mersenne Twister seeded +% with seed), so the global random state is not touched and the same seed +% always gives the same field. No toolbox is needed. +% +% Differences with Aleat_novo4.m, see docs/known-issues/KNOWN_ISSUES.md: +% the legacy script used the scale Gamma(1+1/k) (mean Gamma(1+1/k)^2, +% below 1) and had two typos in the interpolation formula. Its rotation of +% the pole grid (angles that were always zero) is not implemented. +% +% Example: +% params = ldem.Parameters(nModules=[6 3 3]); +% mesh = ldem.mesh.buildMesh(params); +% field = ldem.material.generateRandomField(mesh.barCentres, 0.05, ... +% 3 * params.moduleLength, 515); +% +% Legacy: Aleat_novo4.m (outside the main program; it wrote the file read +% by ldem.io.readRandomField). +% +% See also ldem.material.buildBarProperties, ldem.io.readRandomField. + +arguments + barCentres (:,3) double {mustBeFinite} + cv (1,1) double {mustBePositive, mustBeFinite} + correlationLength (1,:) double {mustBePositive, mustBeFinite} + seed (1,1) double {mustBeInteger, mustBeNonnegative} +end + +if isscalar(correlationLength) + correlationLength = repmat(correlationLength, 1, 3); +elseif numel(correlationLength) ~= 3 + error('ldem:material:badCorrelationLength', ... + 'correlationLength must be a scalar or have 3 values [lx ly lz], got %d values.', ... + numel(correlationLength)); +end + +[shape, scale] = weibullForUnitMean(cv); + +% Pole grid: one cell beyond the bars on each side, as in Aleat_novo4.m. +nBars = size(barCentres, 1); +first = floor(min(barCentres, [], 1) ./ correlationLength) - 1; +last = ceil(max(barCentres, [], 1) ./ correlationLength) + 1; +nPoles = last - first + 1; + +% Weibull values by inverse transform: scale * (-log(U))^(1/shape). +stream = RandStream('mt19937ar', 'Seed', seed); +uniform = rand(stream, nPoles); +poles = scale * (-log(uniform)) .^ (1 / shape); + +% Cell containing each bar centre and local coordinates t in [0, 1]. +position = barCentres ./ correlationLength - first; % in pole spacings +corner = floor(position); +corner = min(max(corner, 0), nPoles - 2); % bars on the last pole +t = position - corner; +ix = corner(:, 1) + 1; iy = corner(:, 2) + 1; iz = corner(:, 3) + 1; +tx = t(:, 1); ty = t(:, 2); tz = t(:, 3); + +pole = @(dx, dy, dz) poles(sub2ind(nPoles, ix + dx, iy + dy, iz + dz)); +field = zeros(nBars, 1); +for dx = 0:1 + wx = (1 - dx) * (1 - tx) + dx * tx; + for dy = 0:1 + wy = (1 - dy) * (1 - ty) + dy * ty; + for dz = 0:1 + wz = (1 - dz) * (1 - tz) + dz * tz; + field = field + wx .* wy .* wz .* pole(dx, dy, dz); + end + end +end + +info = struct( ... + 'source', "generated", ... + 'cv', cv, ... + 'correlationLength', correlationLength, ... + 'seed', seed, ... + 'weibullShape', shape, ... + 'weibullScale', scale, ... + 'nPoles', nPoles, ... + 'fieldMean', mean(field), ... + 'fieldCv', std(field) / mean(field)); +end + +function [shape, scale] = weibullForUnitMean(cv) +%WEIBULLFORUNITMEAN Weibull shape and scale with mean 1 and the given CV. +% The squared CV of a Weibull distribution is +% Gamma(1+2/k)/Gamma(1+1/k)^2 - 1, which decreases with k. +target = log1p(cv^2); +excess = @(k) gammaln(1 + 2 ./ k) - 2 * gammaln(1 + 1 ./ k) - target; +bounds = [0.02 1e5]; +if excess(bounds(2)) > 0 + error('ldem:material:randomFieldCvTooSmall', ... + 'cv = %g is too small for a Weibull field; use at least 1e-4.', cv); +end +if excess(bounds(1)) < 0 + error('ldem:material:randomFieldCvTooLarge', ... + 'cv = %g is too large for a Weibull field.', cv); +end +shape = fzero(excess, bounds); +scale = 1 / gamma(1 + 1 / shape); +end diff --git a/src/+ldem/+material/summarizeMaterial.m b/src/+ldem/+material/summarizeMaterial.m index 2270350..f30fd25 100644 --- a/src/+ldem/+material/summarizeMaterial.m +++ b/src/+ldem/+material/summarizeMaterial.m @@ -26,6 +26,9 @@ % criticalStrainCv coefficient of variation of EP % criticalStrainMin smallest EP % criticalStrainMax largest EP +% randomField where the random field came from and its +% statistics (barProps.randomFieldInfo); the value +% of each bar is barProps.randomField % % Input: % barProps Struct from ldem.material.buildBarProperties. @@ -71,4 +74,5 @@ summary.criticalStrainCv = barProps.criticalStrainCv; summary.criticalStrainMin = min(barProps.criticalStrain); summary.criticalStrainMax = max(barProps.criticalStrain); +summary.randomField = barProps.randomFieldInfo; end diff --git a/src/+ldem/Parameters.m b/src/+ldem/Parameters.m index 0d3af9b..b8a5a39 100644 --- a/src/+ldem/Parameters.m +++ b/src/+ldem/Parameters.m @@ -92,10 +92,28 @@ trackedBar (1,1) double {mustBeInteger, mustBePositive} = 7014 % Text file with one multiplier of the critical strain per bar - % (random field). Empty means "no random field" (all multipliers 1). - % Legacy: file "arquivo_3lc_rnao_cv05". + % (random field). Empty means "no random field" (all multipliers 1) + % unless randomFieldCv is positive. Legacy: file + % "arquivo_3lc_rnao_cv05". randomFieldFile (1,1) string = "" + % Coefficient of variation of the random field generated in memory + % (see ldem.material.generateRandomField). 0 (the default) generates + % nothing; a positive value, between 1e-4 and 3, generates the field + % and cannot be combined with randomFieldFile. Legacy: Cv of + % Aleat_novo4.m (0.05 for "arquivo_3lc_rnao_cv05"). + randomFieldCv (1,1) double {mustBeNonnegative, mustBeFinite} = 0 + + % Correlation length of the generated random field, that is the + % spacing of its pole grid, in module lengths (multiples of + % moduleLength): a scalar or [x y z]. Legacy: lcorx, lcory, lcorz + % of Aleat_novo4.m divided by Lc ("3lc" means 3). + randomFieldCorrelationLength (1,:) double {mustBePositive, mustBeFinite} = 3 + + % Seed of the random numbers of the generated random field. + % Legacy: semente of Aleat_novo4.m. + randomFieldSeed (1,1) double {mustBeInteger, mustBeNonnegative} = 515 + % Random perturbation of the node coordinates, as the standard % deviation expressed as a fraction of the module length. 0 (the % default) switches the perturbation off; any positive value @@ -192,6 +210,22 @@ function validate(obj) 'output.trackedBarEvery must be 0 or 1 (the tracked bar is stored at every step).'); end + % Random field: from a file or generated, not both. + if obj.randomFieldCv > 0 && strlength(obj.randomFieldFile) > 0 + error('ldem:params:twoRandomFields', ... + ['Set either randomFieldFile (read the field) or randomFieldCv ' ... + '(generate it), not both.']); + end + if obj.randomFieldCv > 0 && (obj.randomFieldCv < 1e-4 || obj.randomFieldCv > 3) + error('ldem:params:badRandomFieldCv', ... + 'randomFieldCv must be 0 or between 1e-4 and 3, got %g.', obj.randomFieldCv); + end + if ~any(numel(obj.randomFieldCorrelationLength) == [1 3]) + error('ldem:params:badCorrelationLength', ... + ['randomFieldCorrelationLength must be a scalar or have 3 values ' ... + '[x y z], got %d values.'], numel(obj.randomFieldCorrelationLength)); + end + % Time integration. if obj.totalTime < obj.dt error('ldem:params:totalTimeTooShort', ... diff --git a/tests/unit/TestGenerateRandomField.m b/tests/unit/TestGenerateRandomField.m new file mode 100644 index 0000000..046b522 --- /dev/null +++ b/tests/unit/TestGenerateRandomField.m @@ -0,0 +1,108 @@ +classdef TestGenerateRandomField < LdemTestCase + %TESTGENERATERANDOMFIELD Unit tests of ldem.material.generateRandomField. + + methods (Access = private) + function centres = gridCentres(~, n, spacing) + % Points of a regular n(1)-by-n(2)-by-n(3) grid with the given spacing. + [x, y, z] = ndgrid((0:n(1)-1) * spacing, (0:n(2)-1) * spacing, (0:n(3)-1) * spacing); + centres = [x(:), y(:), z(:)]; + end + end + + methods (Test, TestTags = {'Unit'}) + function oneValuePerBarAllPositive(testCase) + centres = testCase.gridCentres([10 6 6], 1e-3); + field = ldem.material.generateRandomField(centres, 0.2, 3e-3, 1); + testCase.verifySize(field, [size(centres, 1) 1]); + testCase.verifyGreaterThan(min(field), 0); + testCase.verifyTrue(all(isfinite(field))); + end + + function weibullOfThePolesHasMeanOneAndTheRequestedCv(testCase) + for cv = [0.01 0.05 0.2 1] + [~, info] = ldem.material.generateRandomField([0 0 0], cv, 1, 1); + k = info.weibullShape; + lambda = info.weibullScale; + m1 = lambda * gamma(1 + 1/k); + m2 = lambda^2 * gamma(1 + 2/k); + testCase.verifyEqual(m1, 1, 'RelTol', 1e-10); + testCase.verifyEqual(sqrt(m2 - m1^2) / m1, cv, 'RelTol', 1e-8); + end + end + + function polesHaveTheRequestedStatistics(testCase) + % Bars exactly on the poles take the pole values, so with a + % correlation length equal to the spacing the field is the + % (independent) pole values: check their sample mean and CV. + centres = testCase.gridCentres([40 40 40], 1); + field = ldem.material.generateRandomField(centres, 0.1, 1, 7); + testCase.verifyEqual(mean(field), 1, 'AbsTol', 0.005); + testCase.verifyEqual(std(field) / mean(field), 0.1, 'RelTol', 0.03); + end + + function interpolationReducesTheScatter(testCase) + centres = testCase.gridCentres([30 30 30], 1); + [~, info] = ldem.material.generateRandomField(centres, 0.1, 6, 7); + testCase.verifyLessThan(info.fieldCv, 0.1); + testCase.verifyGreaterThan(info.fieldCv, 0); + end + + function longerCorrelationMakesNeighboursMoreAlike(testCase) + centres = testCase.gridCentres([60 4 4], 1); + jump = @(f) mean(abs(diff(reshape(f, 60, []), 1, 1)), 'all') / mean(f); + short = ldem.material.generateRandomField(centres, 0.2, 1.5, 3); + long = ldem.material.generateRandomField(centres, 0.2, 10, 3); + testCase.verifyLessThan(jump(long), jump(short)); + end + + function fieldIsLinearBetweenTwoPoles(testCase) + % Along a line between two poles the field is a straight line. + centres = [linspace(0, 1, 11).', zeros(11, 1), zeros(11, 1)]; + field = ldem.material.generateRandomField(centres, 0.3, 1, 4); + testCase.verifyEqual(diff(field, 2), zeros(9, 1), 'AbsTol', 1e-12); + end + + function sameSeedSameFieldAndGlobalStreamUntouched(testCase) + centres = testCase.gridCentres([8 5 5], 1e-3); + rng(42); + before = rand(); + rng(42); + a = ldem.material.generateRandomField(centres, 0.1, 2e-3, 11); + after = rand(); + b = ldem.material.generateRandomField(centres, 0.1, 2e-3, 11); + c = ldem.material.generateRandomField(centres, 0.1, 2e-3, 12); + testCase.verifyEqual(a, b); + testCase.verifyNotEqual(a, c); + testCase.verifyEqual(after, before, 'The global random stream must not be used.'); + end + + function anisotropicCorrelationLength(testCase) + centres = testCase.gridCentres([10 10 10], 1); + [~, info] = ldem.material.generateRandomField(centres, 0.1, [1 2 5], 1); + testCase.verifyEqual(info.correlationLength, [1 2 5]); + testCase.verifyEqual(info.nPoles, [12 8 5]); + end + + function infoDescribesTheField(testCase) + centres = testCase.gridCentres([5 5 5], 1); + [field, info] = ldem.material.generateRandomField(centres, 0.05, 2, 515); + testCase.verifyEqual(info.source, "generated"); + testCase.verifyEqual(info.cv, 0.05); + testCase.verifyEqual(info.seed, 515); + testCase.verifyEqual(info.fieldMean, mean(field)); + testCase.verifyEqual(info.fieldCv, std(field) / mean(field)); + end + + function badCorrelationLengthIsRejected(testCase) + testCase.verifyError( ... + @() ldem.material.generateRandomField([0 0 0], 0.1, [1 2], 1), ... + 'ldem:material:badCorrelationLength'); + end + + function tooSmallCvIsRejected(testCase) + testCase.verifyError( ... + @() ldem.material.generateRandomField([0 0 0], 1e-7, 1, 1), ... + 'ldem:material:randomFieldCvTooSmall'); + end + end +end diff --git a/tests/unit/TestMaterial.m b/tests/unit/TestMaterial.m index b930008..1bd822a 100644 --- a/tests/unit/TestMaterial.m +++ b/tests/unit/TestMaterial.m @@ -110,6 +110,45 @@ function randomFieldIsReadFromTheParametersFile(testCase) testCase.verifyEqual(props.criticalStrain, field .* base.criticalStrain, 'RelTol', 1e-9); end + function randomFieldIsGeneratedFromTheParameters(testCase) + params = ldem.Parameters(nModules=[6 4 4], randomFieldCv=0.1, ... + randomFieldCorrelationLength=2, randomFieldSeed=9); + probe = ldem.Parameters(nModules=[6 4 4]); + mesh = ldem.mesh.buildMesh(params); + [props, ~] = ldem.material.buildBarProperties(mesh, params); + [base, ~] = ldem.material.buildBarProperties(mesh, probe); + + expected = ldem.material.generateRandomField(mesh.barCentres, 0.1, ... + 2 * params.moduleLength, 9); + testCase.verifyEqual(props.randomField, expected); + testCase.verifyEqual(props.criticalStrain, expected .* base.criticalStrain, 'RelTol', 1e-12); + testCase.verifyEqual(props.randomFieldInfo.source, "generated"); + testCase.verifyEqual(props.randomFieldInfo.correlationLength, ... + repmat(2 * params.moduleLength, 1, 3)); + end + + function randomFieldIsStoredWithItsSource(testCase) + params = ldem.Parameters(nModules=[3 3 3]); + mesh = ldem.mesh.buildMesh(params); + nBars = size(mesh.bars, 1); + + props = ldem.material.buildBarProperties(mesh, params); + testCase.verifyEqual(props.randomField, ones(nBars, 1)); + testCase.verifyEqual(props.randomFieldInfo.source, "none"); + + given = 1 + 0.01 * (1:nBars).'; + props = ldem.material.buildBarProperties(mesh, params, RandomField=given); + testCase.verifyEqual(props.randomField, given); + testCase.verifyEqual(props.randomFieldInfo.source, "given"); + testCase.verifyEqual(props.randomFieldInfo.fieldMean, mean(given)); + + path = testCase.writeNumbers(given); + props = ldem.material.buildBarProperties(mesh, ... + ldem.Parameters(nModules=[3 3 3], randomFieldFile=path)); + testCase.verifyEqual(props.randomFieldInfo.source, "file"); + testCase.verifyEqual(props.randomFieldInfo.file, string(path)); + end + function randomFieldOfWrongSizeIsRejected(testCase) params = ldem.Parameters(nModules=[3 3 3]); mesh = ldem.mesh.buildMesh(params); diff --git a/tests/unit/TestParameters.m b/tests/unit/TestParameters.m index ea77e03..e4ef36d 100644 --- a/tests/unit/TestParameters.m +++ b/tests/unit/TestParameters.m @@ -100,6 +100,22 @@ function valueSemantics(testCase) testCase.verifyEqual(a.seed, 123, 'Parameters must be a value class.'); end + function randomFieldSettingsAreValidated(testCase) + p = ldem.Parameters(randomFieldCv=0.05, randomFieldCorrelationLength=[2 2 4]); + testCase.verifyEqual(p.randomFieldCv, 0.05); + testCase.verifyEqual(p.randomFieldSeed, 515); + testCase.verifyError(@() ldem.Parameters(randomFieldCv=0.05, randomFieldFile="f.txt"), ... + 'ldem:params:twoRandomFields'); + testCase.verifyError(@() ldem.Parameters(randomFieldCv=1e-6), ... + 'ldem:params:badRandomFieldCv'); + testCase.verifyError(@() ldem.Parameters(randomFieldCv=5), ... + 'ldem:params:badRandomFieldCv'); + testCase.verifyError(@() ldem.Parameters(randomFieldCorrelationLength=[1 2]), ... + 'ldem:params:badCorrelationLength'); + testCase.verifyError(@() ldem.Parameters(randomFieldCorrelationLength=0), ?MException); + testCase.verifyError(@() ldem.Parameters(randomFieldCv=-0.1), ?MException); + end + function validateCatchesChangesAfterConstruction(testCase) p = ldem.Parameters(); p.dt = 1e-5; diff --git a/tests/unit/TestRunSimulation.m b/tests/unit/TestRunSimulation.m index eb9e410..68c6237 100644 --- a/tests/unit/TestRunSimulation.m +++ b/tests/unit/TestRunSimulation.m @@ -111,6 +111,22 @@ function outputFilesAreWrittenForTheRequestedFormats(testCase) testCase.verifyEqual(loaded.results.params.nSteps, 100); end + function generatedRandomFieldIsSavedInTheResults(testCase) + params = testCase.quickParams(); + params.randomFieldCv = 0.05; + folder = fullfile(testCase.tempFolder(), "run"); + results = ldem.runSimulation(params, OutputFolder=folder); + + nBars = size(results.mesh.bars, 1); + testCase.verifySize(results.barProps.randomField, [nBars 1]); + testCase.verifyEqual(results.material.randomField.source, "generated"); + testCase.verifyEqual(results.params.randomFieldCv, 0.05); + + loaded = load(fullfile(folder, "results.mat")); + testCase.verifyEqual(loaded.results.barProps.randomField, results.barProps.randomField); + testCase.verifyEqual(loaded.results.material.randomField.seed, params.randomFieldSeed); + end + function onlyTheRequestedFormatsAreWritten(testCase) folder = fullfile(testCase.tempFolder(), "run"); ldem.runSimulation(testCase.quickParams(), OutputFolder=folder, Formats="vtk"); From f613e76fa4b0aff510a9754615a29ae65a8c4aee Mon Sep 17 00:00:00 2001 From: Boris Rojo Tanzi <71112604+borisrojotanzi@users.noreply.github.com> Date: Fri, 6 Nov 2026 15:44:31 -0300 Subject: [PATCH 10/13] feat: add readable case files (.ldem) to replace DATA0.DAT --- CHANGELOG.md | 17 + docs/source/api/index.rst | 23 + docs/source/en/usage.rst | 102 ++++ docs/source/es/usage.rst | 105 ++++ docs/source/it/usage.rst | 104 ++++ docs/source/pt/usage.rst | 105 ++++ examples/README.md | 14 + examples/beam_102/case.ldem | 80 +++ examples/example1_clamped_beam/case.ldem | 69 +++ src/+ldem/+io/convertLegacyInput.m | 95 ++++ src/+ldem/+io/parseCaseJson.m | 91 ++++ src/+ldem/+io/parseCaseText.m | 226 ++++++++ src/+ldem/+io/readCase.m | 643 +++++++++++++++++++++++ src/+ldem/+io/writeCase.m | 327 ++++++++++++ src/+ldem/+io/writeTemplate.m | 35 ++ src/+ldem/+scenarios/Scenario.m | 4 +- src/+ldem/+scenarios/fromName.m | 32 ++ src/+ldem/+scenarios/fromTestId.m | 24 +- src/+ldem/+scenarios/registry.m | 49 ++ src/+ldem/+schema/caseSchema.m | 127 +++++ src/+ldem/+schema/formatQuantity.m | 64 +++ src/+ldem/+schema/parseQuantity.m | 88 ++++ src/+ldem/+schema/raise.m | 22 + src/+ldem/+schema/shortestText.m | 32 ++ src/+ldem/+schema/suggest.m | 56 ++ src/+ldem/+schema/unitTable.m | 74 +++ src/+ldem/Parameters.m | 19 +- src/+ldem/check.m | 108 ++++ src/+ldem/run.m | 46 ++ tests/LdemTestCase.m | 2 + tests/tools/TestUnregisteredScenario.m | 21 + tests/tools/writeTextFile.m | 28 + tests/unit/TestParseCase.m | 106 ++++ tests/unit/TestQuantities.m | 89 ++++ tests/unit/TestReadCase.m | 421 +++++++++++++++ tests/unit/TestRunCase.m | 101 ++++ tests/unit/TestWriteCase.m | 229 ++++++++ 37 files changed, 3759 insertions(+), 19 deletions(-) create mode 100644 examples/beam_102/case.ldem create mode 100644 examples/example1_clamped_beam/case.ldem create mode 100644 src/+ldem/+io/convertLegacyInput.m create mode 100644 src/+ldem/+io/parseCaseJson.m create mode 100644 src/+ldem/+io/parseCaseText.m create mode 100644 src/+ldem/+io/readCase.m create mode 100644 src/+ldem/+io/writeCase.m create mode 100644 src/+ldem/+io/writeTemplate.m create mode 100644 src/+ldem/+scenarios/fromName.m create mode 100644 src/+ldem/+scenarios/registry.m create mode 100644 src/+ldem/+schema/caseSchema.m create mode 100644 src/+ldem/+schema/formatQuantity.m create mode 100644 src/+ldem/+schema/parseQuantity.m create mode 100644 src/+ldem/+schema/raise.m create mode 100644 src/+ldem/+schema/shortestText.m create mode 100644 src/+ldem/+schema/suggest.m create mode 100644 src/+ldem/+schema/unitTable.m create mode 100644 src/+ldem/check.m create mode 100644 src/+ldem/run.m create mode 100644 tests/tools/TestUnregisteredScenario.m create mode 100644 tests/tools/writeTextFile.m create mode 100644 tests/unit/TestParseCase.m create mode 100644 tests/unit/TestQuantities.m create mode 100644 tests/unit/TestReadCase.m create mode 100644 tests/unit/TestRunCase.m create mode 100644 tests/unit/TestWriteCase.m diff --git a/CHANGELOG.md b/CHANGELOG.md index ea047bf..84988f2 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -2,6 +2,23 @@ ## [Unreleased] ### Added +- Case files (`.ldem`): a readable, commented input file that replaces + `DATA0.DAT` and describes the whole model (mesh, material, random scatter, + time, damping, scenario, control nodes, output). Keys are read by name, numbers + carry units (`3.87 GPa`, `0.35 us`), `time.step = auto` takes 0.9 times the + critical step, output cadence can be given in steps or in time, control nodes + can be given by position, and every error names the file, line, section and key + (with "did you mean ...?"). JSON with the same structure is also read. + `ldem.io.readCase`, `ldem.io.writeCase`, `ldem.io.writeTemplate`, + `ldem.io.convertLegacyInput` (DATA0.DAT to `.ldem`, same `Parameters`), + `ldem.run`, `ldem.check` (dry run: size of the model, stability margin, random + field file, snapshot memory), and `ldem.Parameters.fromFile` reads `.ldem` and + `.json` too. The keys live in one table, `ldem.schema.caseSchema`, with + `ldem.schema.parseQuantity` / `formatQuantity` for the units. +- `ldem.scenarios.registry` is the single list of scenarios; + `ldem.scenarios.fromTestId` reads it and `ldem.scenarios.fromName` is new. +- `case.ldem` next to the `DATA0.DAT` of `examples/beam_102` and + `examples/example1_clamped_beam`; user guide (EN/ES/IT/PT) and API pages. - Repository structure: README, LICENSE, CITATION, CONTRIBUTING. - Sphinx documentation (English/Spanish) with API generated from `.m` files. - `matlab.unittest` test suite and GitHub Actions workflows. diff --git a/docs/source/api/index.rst b/docs/source/api/index.rst index 95313f2..6cbab19 100644 --- a/docs/source/api/index.rst +++ b/docs/source/api/index.rst @@ -19,6 +19,8 @@ Running a simulation / Ejecutar una simulación .. mat:autofunction:: ldem.runSimulation .. mat:autoclass:: ldem.Parameters :members: +.. mat:autofunction:: ldem.run +.. mat:autofunction:: ldem.check .. mat:autofunction:: ldem.version Input and output / Entrada y salida @@ -26,6 +28,12 @@ Input and output / Entrada y salida .. mat:module:: ldem.io +.. mat:autofunction:: ldem.io.readCase +.. mat:autofunction:: ldem.io.writeCase +.. mat:autofunction:: ldem.io.writeTemplate +.. mat:autofunction:: ldem.io.convertLegacyInput +.. mat:autofunction:: ldem.io.parseCaseText +.. mat:autofunction:: ldem.io.parseCaseJson .. mat:autofunction:: ldem.io.readInputFile .. mat:autofunction:: ldem.io.readRandomField .. mat:autofunction:: ldem.io.saveResults @@ -70,6 +78,21 @@ Scenarios / Escenarios de ensayo .. mat:autoclass:: ldem.scenarios.FourPointBending .. mat:autoclass:: ldem.scenarios.ClampedBeam .. mat:autofunction:: ldem.scenarios.fromTestId +.. mat:autofunction:: ldem.scenarios.fromName +.. mat:autofunction:: ldem.scenarios.registry + +Case-file schema / Esquema de los archivos de caso +-------------------------------------------------- + +.. mat:module:: ldem.schema + +.. mat:autofunction:: ldem.schema.caseSchema +.. mat:autofunction:: ldem.schema.parseQuantity +.. mat:autofunction:: ldem.schema.formatQuantity +.. mat:autofunction:: ldem.schema.unitTable +.. mat:autofunction:: ldem.schema.shortestText +.. mat:autofunction:: ldem.schema.suggest +.. mat:autofunction:: ldem.schema.raise Solver ------ diff --git a/docs/source/en/usage.rst b/docs/source/en/usage.rst index d7dedca..70ebba1 100644 --- a/docs/source/en/usage.rst +++ b/docs/source/en/usage.rst @@ -25,6 +25,108 @@ To use an input file in the format of the original program: >> params = ldem.Parameters.fromFile("DATA0.DAT"); +Case files (``.ldem``) +---------------------- + +A *case file* describes the whole model in one readable text file: named keys +instead of positions, units next to the numbers, comments, and the test, the +random scatter and the output files together. It replaces ``DATA0.DAT``. + +.. code-block:: text + + format = 1 + title = "Small tension test" + + [mesh] + module_size = 3 mm + modules = [5, 2, 2] # cubic modules along x, y and z + + [material] + young_modulus = 32 GPa + density = 2000 kg/m3 + + [time] + step = auto # 0.9 times the critical step + duration = 40 us + + [scenario] + type = "uniaxial_tension" + + [output] + folder = "output" + +.. code-block:: matlab + + >> ldem.io.writeTemplate("my_test.ldem", "clamped_beam"); % a commented file to edit + >> ldem.check("my_test.ldem") % validate and report, no simulation + >> results = ldem.run("my_test.ldem"); % run it + >> ldem.io.convertLegacyInput("DATA0.DAT", "case.ldem"); % convert an old input file + +Rules of the format: + +* Keys are read by **name**; the order of the lines does not matter. Keys that + are missing take the default of ``ldem.Parameters``. Only ``scenario.type``, + ``mesh.modules`` and ``time.duration`` are required. +* A number may carry a **unit**: ``3.87 GPa``, ``0.35 us``, ``1500 kg/m3``, + ``2 kN/s``. Without a unit the value is in SI. The wrong unit for the key is + an error that lists the valid ones. +* ``#`` starts a comment, ``[section]`` opens a table, ``[[monitor.node]]`` + starts the next element of a repeated table, lists are written ``[5, 5, 50]``. +* ``mesh.modules`` counts **modules**: the ``M N L`` of ``DATA0.DAT`` count + nodes, one more. +* ``time.step = auto`` (or no ``step``) takes 0.9 times the critical step. +* Every error names the file, the line, the section and the key, and suggests + the closest valid name for a mistyped one. +* Relative paths (the random-field file, the output folder) are relative to + the case file. +* A JSON file with the same structure (values with units as strings) is also + read. + +.. list-table:: + :header-rows: 1 + :widths: 25 75 + + * - Section + - Keys + * - (top) + - ``format`` (1), ``title``, ``authors`` + * - ``[mesh]`` + - ``module_size``, ``modules``, ``perturbation`` (random displacement of + the nodes, fraction of the module), ``seed`` (of the perturbation) + * - ``[material]`` + - ``law``, ``young_modulus``, ``poisson_ratio``, ``density``, + ``fracture_energy``, ``critical_distance``, ``failure_area_factor`` + * - ``[material.scatter]`` + - Scatter of the critical strain of the bars. ``type = "none"``; + ``"file"`` with ``file`` (one multiplier per bar); or ``"generated"`` + with ``cv``, ``correlation_length`` (in modules) and ``seed`` (the + field is computed in memory) + * - ``[time]`` + - ``step`` (or ``auto``), ``duration`` + * - ``[damping]`` + - ``type``, ``initial``, ``final``, ``switch_time``, ``constitutive`` + * - ``[scenario]`` + - ``type`` (``uniaxial_tension``, ``four_point_bending`` or + ``clamped_beam``) and the properties of that scenario in snake_case, + for example ``force_rate``, ``ramp_time``, ``load_position`` (``"midspan"`` + is allowed) + * - ``[[monitor.node]]`` + - One element per control node: ``id`` (node number) or ``at = [x, y, z]`` + (position in modules, the nearest node is used), and ``name`` + * - ``[monitor.bar]`` + - ``tracked``: bar whose strain history is stored at every step + * - ``[output]`` + - ``folder``, ``mat``, ``ansys``, ``vtk`` (true or false) + * - ``[output.snapshots]``, ``[output.control_nodes]``, ``[output.energy]`` + - ``every``: ``1000 steps`` or a time such as ``0.1 ms`` (converted to + steps); ``0`` means never + +``ldem.io.readCase`` returns the parameters, the scenario and the output +options; ``ldem.Parameters.fromFile`` also accepts a case file. The list of +keys lives in one table, ``ldem.schema.caseSchema``, which drives the reader, +the writer and the template. To add a scenario, add a line to +``ldem.scenarios.registry``. + Tests available --------------- diff --git a/docs/source/es/usage.rst b/docs/source/es/usage.rst index 81b046f..f8f784b 100644 --- a/docs/source/es/usage.rst +++ b/docs/source/es/usage.rst @@ -25,6 +25,111 @@ Para usar un archivo de entrada con el formato del programa original: >> params = ldem.Parameters.fromFile("DATA0.DAT"); +Archivos de caso (``.ldem``) +---------------------------- + +Un *archivo de caso* describe todo el modelo en un único texto legible: claves +con nombre en lugar de posiciones, unidades junto a los números, comentarios, y +el ensayo, la dispersión aleatoria y los archivos de salida juntos. Reemplaza al +``DATA0.DAT``. + +.. code-block:: text + + format = 1 + title = "Ensayo de tracción pequeño" + + [mesh] + module_size = 3 mm + modules = [5, 2, 2] # módulos cúbicos en x, y y z + + [material] + young_modulus = 32 GPa + density = 2000 kg/m3 + + [time] + step = auto # 0.9 veces el paso crítico + duration = 40 us + + [scenario] + type = "uniaxial_tension" + + [output] + folder = "output" + +.. code-block:: matlab + + >> ldem.io.writeTemplate("mi_ensayo.ldem", "clamped_beam"); % archivo comentado para editar + >> ldem.check("mi_ensayo.ldem") % valida e informa, sin simular + >> results = ldem.run("mi_ensayo.ldem"); % lo ejecuta + >> ldem.io.convertLegacyInput("DATA0.DAT", "caso.ldem"); % convierte un archivo antiguo + +Reglas del formato: + +* Las claves se leen por **nombre**; el orden de las líneas no importa. Las + claves ausentes toman el valor por defecto de ``ldem.Parameters``. Solo son + obligatorias ``scenario.type``, ``mesh.modules`` y ``time.duration``. +* Un número puede llevar **unidad**: ``3.87 GPa``, ``0.35 us``, ``1500 kg/m3``, + ``2 kN/s``. Sin unidad el valor está en SI. Una unidad incorrecta para la + clave es un error que lista las válidas. +* ``#`` inicia un comentario, ``[sección]`` abre una tabla, ``[[monitor.node]]`` + inicia el siguiente elemento de una tabla repetida y las listas se escriben + ``[5, 5, 50]``. +* ``mesh.modules`` cuenta **módulos**: los ``M N L`` del ``DATA0.DAT`` cuentan + nodos, uno más. +* ``time.step = auto`` (o sin ``step``) toma 0.9 veces el paso crítico. +* Cada error indica el archivo, la línea, la sección y la clave, y sugiere el + nombre válido más parecido cuando hay un error de tipeo. +* Las rutas relativas (archivo del campo aleatorio, carpeta de salida) son + relativas al archivo de caso. +* También se lee un archivo JSON con la misma estructura (los valores con + unidades, como texto). + +.. list-table:: + :header-rows: 1 + :widths: 25 75 + + * - Sección + - Claves + * - (inicio) + - ``format`` (1), ``title``, ``authors`` + * - ``[mesh]`` + - ``module_size``, ``modules``, ``perturbation`` (desplazamiento aleatorio + de los nodos, fracción del módulo), ``seed`` (de la perturbación) + * - ``[material]`` + - ``law``, ``young_modulus``, ``poisson_ratio``, ``density``, + ``fracture_energy``, ``critical_distance``, ``failure_area_factor`` + * - ``[material.scatter]`` + - Dispersión de la deformación crítica de las barras. ``type = "none"``; + ``"file"`` con ``file`` (un multiplicador por barra); o ``"generated"`` + con ``cv``, ``correlation_length`` (en módulos) y ``seed`` (el campo se + calcula en memoria) + * - ``[time]`` + - ``step`` (o ``auto``), ``duration`` + * - ``[damping]`` + - ``type``, ``initial``, ``final``, ``switch_time``, ``constitutive`` + * - ``[scenario]`` + - ``type`` (``uniaxial_tension``, ``four_point_bending`` o + ``clamped_beam``) y las propiedades de ese escenario en snake_case, por + ejemplo ``force_rate``, ``ramp_time``, ``load_position`` (se admite + ``"midspan"``) + * - ``[[monitor.node]]`` + - Un elemento por nodo de control: ``id`` (número de nodo) o + ``at = [x, y, z]`` (posición en módulos, se usa el nodo más cercano), y + ``name`` + * - ``[monitor.bar]`` + - ``tracked``: barra cuya historia de deformación se guarda en cada paso + * - ``[output]`` + - ``folder``, ``mat``, ``ansys``, ``vtk`` (true o false) + * - ``[output.snapshots]``, ``[output.control_nodes]``, ``[output.energy]`` + - ``every``: ``1000 steps`` o un tiempo como ``0.1 ms`` (se convierte a + pasos); ``0`` significa nunca + +``ldem.io.readCase`` devuelve los parámetros, el escenario y las opciones de +salida; ``ldem.Parameters.fromFile`` también acepta un archivo de caso. La lista +de claves está en una sola tabla, ``ldem.schema.caseSchema``, que gobierna el +lector, el escritor y la plantilla. Para agregar un escenario, se agrega una +línea a ``ldem.scenarios.registry``. + Ensayos disponibles ------------------- diff --git a/docs/source/it/usage.rst b/docs/source/it/usage.rst index 05a19e8..ab04f66 100644 --- a/docs/source/it/usage.rst +++ b/docs/source/it/usage.rst @@ -25,6 +25,110 @@ Per usare un file di ingresso nel formato del programma originale: >> params = ldem.Parameters.fromFile("DATA0.DAT"); +File di caso (``.ldem``) +------------------------ + +Un *file di caso* descrive l'intero modello in un unico testo leggibile: chiavi +con nome invece di posizioni, unità accanto ai numeri, commenti, e la prova, la +dispersione casuale e i file di uscita insieme. Sostituisce ``DATA0.DAT``. + +.. code-block:: text + + format = 1 + title = "Piccola prova di trazione" + + [mesh] + module_size = 3 mm + modules = [5, 2, 2] # moduli cubici lungo x, y e z + + [material] + young_modulus = 32 GPa + density = 2000 kg/m3 + + [time] + step = auto # 0.9 volte il passo critico + duration = 40 us + + [scenario] + type = "uniaxial_tension" + + [output] + folder = "output" + +.. code-block:: matlab + + >> ldem.io.writeTemplate("mia_prova.ldem", "clamped_beam"); % file commentato da modificare + >> ldem.check("mia_prova.ldem") % valida e riferisce, senza simulare + >> results = ldem.run("mia_prova.ldem"); % la esegue + >> ldem.io.convertLegacyInput("DATA0.DAT", "caso.ldem"); % converte un vecchio file + +Regole del formato: + +* Le chiavi si leggono per **nome**; l'ordine delle righe non conta. Le chiavi + assenti prendono il valore predefinito di ``ldem.Parameters``. Sono + obbligatorie solo ``scenario.type``, ``mesh.modules`` e ``time.duration``. +* Un numero può avere un'**unità**: ``3.87 GPa``, ``0.35 us``, ``1500 kg/m3``, + ``2 kN/s``. Senza unità il valore è in SI. Un'unità sbagliata per la chiave è + un errore che elenca quelle valide. +* ``#`` inizia un commento, ``[sezione]`` apre una tabella, ``[[monitor.node]]`` + inizia l'elemento successivo di una tabella ripetuta e le liste si scrivono + ``[5, 5, 50]``. +* ``mesh.modules`` conta **moduli**: gli ``M N L`` di ``DATA0.DAT`` contano nodi, + uno in più. +* ``time.step = auto`` (o senza ``step``) prende 0.9 volte il passo critico. +* Ogni errore indica il file, la riga, la sezione e la chiave, e suggerisce il + nome valido più vicino se c'è un errore di battitura. +* I percorsi relativi (file del campo casuale, cartella di uscita) sono + relativi al file di caso. +* Si legge anche un file JSON con la stessa struttura (i valori con unità come + testo). + +.. list-table:: + :header-rows: 1 + :widths: 25 75 + + * - Sezione + - Chiavi + * - (inizio) + - ``format`` (1), ``title``, ``authors`` + * - ``[mesh]`` + - ``module_size``, ``modules``, ``perturbation`` (spostamento casuale dei + nodi, frazione del modulo), ``seed`` (della perturbazione) + * - ``[material]`` + - ``law``, ``young_modulus``, ``poisson_ratio``, ``density``, + ``fracture_energy``, ``critical_distance``, ``failure_area_factor`` + * - ``[material.scatter]`` + - Dispersione della deformazione critica delle barre. ``type = "none"``; + ``"file"`` con ``file`` (un moltiplicatore per barra); oppure + ``"generated"`` con ``cv``, ``correlation_length`` (in moduli) e ``seed`` + (il campo è calcolato in memoria) + * - ``[time]`` + - ``step`` (o ``auto``), ``duration`` + * - ``[damping]`` + - ``type``, ``initial``, ``final``, ``switch_time``, ``constitutive`` + * - ``[scenario]`` + - ``type`` (``uniaxial_tension``, ``four_point_bending`` o + ``clamped_beam``) e le proprietà di quello scenario in snake_case, per + esempio ``force_rate``, ``ramp_time``, ``load_position`` (è ammesso + ``"midspan"``) + * - ``[[monitor.node]]`` + - Un elemento per nodo di controllo: ``id`` (numero del nodo) oppure + ``at = [x, y, z]`` (posizione in moduli, si usa il nodo più vicino), e + ``name`` + * - ``[monitor.bar]`` + - ``tracked``: barra la cui storia di deformazione è salvata a ogni passo + * - ``[output]`` + - ``folder``, ``mat``, ``ansys``, ``vtk`` (true o false) + * - ``[output.snapshots]``, ``[output.control_nodes]``, ``[output.energy]`` + - ``every``: ``1000 steps`` o un tempo come ``0.1 ms`` (convertito in + passi); ``0`` significa mai + +``ldem.io.readCase`` restituisce i parametri, lo scenario e le opzioni di +uscita; ``ldem.Parameters.fromFile`` accetta anche un file di caso. L'elenco +delle chiavi è in un'unica tabella, ``ldem.schema.caseSchema``, che governa il +lettore, lo scrittore e il modello. Per aggiungere uno scenario si aggiunge una +riga a ``ldem.scenarios.registry``. + Prove disponibili ----------------- diff --git a/docs/source/pt/usage.rst b/docs/source/pt/usage.rst index 4aec8b1..4c70811 100644 --- a/docs/source/pt/usage.rst +++ b/docs/source/pt/usage.rst @@ -25,6 +25,111 @@ Para usar um arquivo de entrada no formato do programa original: >> params = ldem.Parameters.fromFile("DATA0.DAT"); +Arquivos de caso (``.ldem``) +---------------------------- + +Um *arquivo de caso* descreve todo o modelo em um único texto legível: chaves +com nome em vez de posições, unidades junto aos números, comentários, e o +ensaio, a dispersão aleatória e os arquivos de saída juntos. Ele substitui o +``DATA0.DAT``. + +.. code-block:: text + + format = 1 + title = "Pequeno ensaio de tração" + + [mesh] + module_size = 3 mm + modules = [5, 2, 2] # módulos cúbicos em x, y e z + + [material] + young_modulus = 32 GPa + density = 2000 kg/m3 + + [time] + step = auto # 0.9 vezes o passo crítico + duration = 40 us + + [scenario] + type = "uniaxial_tension" + + [output] + folder = "output" + +.. code-block:: matlab + + >> ldem.io.writeTemplate("meu_ensaio.ldem", "clamped_beam"); % arquivo comentado para editar + >> ldem.check("meu_ensaio.ldem") % valida e informa, sem simular + >> results = ldem.run("meu_ensaio.ldem"); % executa + >> ldem.io.convertLegacyInput("DATA0.DAT", "caso.ldem"); % converte um arquivo antigo + +Regras do formato: + +* As chaves são lidas por **nome**; a ordem das linhas não importa. As chaves + ausentes assumem o valor padrão de ``ldem.Parameters``. Só são obrigatórias + ``scenario.type``, ``mesh.modules`` e ``time.duration``. +* Um número pode ter **unidade**: ``3.87 GPa``, ``0.35 us``, ``1500 kg/m3``, + ``2 kN/s``. Sem unidade o valor está em SI. Uma unidade incorreta para a + chave é um erro que lista as válidas. +* ``#`` inicia um comentário, ``[seção]`` abre uma tabela, ``[[monitor.node]]`` + inicia o próximo elemento de uma tabela repetida e as listas são escritas + ``[5, 5, 50]``. +* ``mesh.modules`` conta **módulos**: os ``M N L`` do ``DATA0.DAT`` contam nós, + um a mais. +* ``time.step = auto`` (ou sem ``step``) assume 0.9 vez o passo crítico. +* Cada erro indica o arquivo, a linha, a seção e a chave, e sugere o nome + válido mais parecido quando há erro de digitação. +* Os caminhos relativos (arquivo do campo aleatório, pasta de saída) são + relativos ao arquivo de caso. +* Também é lido um arquivo JSON com a mesma estrutura (os valores com unidades, + como texto). + +.. list-table:: + :header-rows: 1 + :widths: 25 75 + + * - Seção + - Chaves + * - (início) + - ``format`` (1), ``title``, ``authors`` + * - ``[mesh]`` + - ``module_size``, ``modules``, ``perturbation`` (deslocamento aleatório + dos nós, fração do módulo), ``seed`` (da perturbação) + * - ``[material]`` + - ``law``, ``young_modulus``, ``poisson_ratio``, ``density``, + ``fracture_energy``, ``critical_distance``, ``failure_area_factor`` + * - ``[material.scatter]`` + - Dispersão da deformação crítica das barras. ``type = "none"``; + ``"file"`` com ``file`` (um multiplicador por barra); ou ``"generated"`` + com ``cv``, ``correlation_length`` (em módulos) e ``seed`` (o campo é + calculado na memória) + * - ``[time]`` + - ``step`` (ou ``auto``), ``duration`` + * - ``[damping]`` + - ``type``, ``initial``, ``final``, ``switch_time``, ``constitutive`` + * - ``[scenario]`` + - ``type`` (``uniaxial_tension``, ``four_point_bending`` ou + ``clamped_beam``) e as propriedades desse cenário em snake_case, por + exemplo ``force_rate``, ``ramp_time``, ``load_position`` (é aceito + ``"midspan"``) + * - ``[[monitor.node]]`` + - Um elemento por nó de controle: ``id`` (número do nó) ou + ``at = [x, y, z]`` (posição em módulos, usa-se o nó mais próximo), e + ``name`` + * - ``[monitor.bar]`` + - ``tracked``: barra cuja história de deformação é guardada a cada passo + * - ``[output]`` + - ``folder``, ``mat``, ``ansys``, ``vtk`` (true ou false) + * - ``[output.snapshots]``, ``[output.control_nodes]``, ``[output.energy]`` + - ``every``: ``1000 steps`` ou um tempo como ``0.1 ms`` (convertido em + passos); ``0`` significa nunca + +``ldem.io.readCase`` devolve os parâmetros, o cenário e as opções de saída; +``ldem.Parameters.fromFile`` também aceita um arquivo de caso. A lista de chaves +está em uma única tabela, ``ldem.schema.caseSchema``, que governa o leitor, o +escritor e o modelo. Para adicionar um cenário, adiciona-se uma linha a +``ldem.scenarios.registry``. + Ensaios disponíveis ------------------- diff --git a/examples/README.md b/examples/README.md index e3fa5b0..bf39e74 100644 --- a/examples/README.md +++ b/examples/README.md @@ -20,10 +20,23 @@ Outputs are written to an `output/` folder next to the script (ignored by git): - `snapshot_0000.vtu`, ... and `snapshots.pvd` - open `snapshots.pvd` in [ParaView](https://www.paraview.org/) to see the damage evolve in time. +## Case files + +Each beam example has a `case.ldem` next to its `DATA0.DAT`: the same model in +the readable case-file format (named keys, units, comments, the scenario and +the output files in one place; see the user guide). It is generated from the +`DATA0.DAT` and gives the same parameters. + +```matlab +>> ldem.check('examples/example1_clamped_beam/case.ldem') % what would be simulated +>> results = ldem.run('examples/example1_clamped_beam/case.ldem'); +``` + ## beam_102 input files | File | Purpose | |------|---------| +| `case.ldem` | The same parameters as a case file (`ldem.io.readCase`, `ldem.run`) | | `DATA0.DAT` | Simulation parameters (format of the original program, read by `ldem.Parameters.fromFile`) | | `arquivo_3lc_rnao_cv05` | Random field applied to the critical strain of each bar (11 MB) | @@ -35,6 +48,7 @@ mid-span with a force, by Rodrigo (branch `dev_rodrigo`). It runs the 8000 steps | File | Purpose | |------|---------| +| `case.ldem` | The same model as a case file (run it with `ldem.run`) | | `runClampedBeam.m` | Reads `DATA0.DAT`, runs the simulation, plots the force on the clamped ends, the vertical displacement of the control nodes and the energies | | `DATA0.DAT` | Parameters of the model (`TEST 103`, see `ldem.scenarios.ClampedBeam`) | diff --git a/examples/beam_102/case.ldem b/examples/beam_102/case.ldem new file mode 100644 index 0000000..e2add10 --- /dev/null +++ b/examples/beam_102/case.ldem @@ -0,0 +1,80 @@ +# Case file generated by ldem.io.convertLegacyInput from DATA0.DAT. +# The legacy value OU2 was 9999999 (not used by ldem). If it is the number of the tracked bar, set [monitor.bar] tracked. +# Bending test (TEST 102) on the 101x41x21-module beam of the paper + +format = 1 # Version of the case-file format (currently 1). +title = "Bending test (TEST 102) on the 101x41x21-module beam of the paper" # Free text title of the case. + +[mesh] +module_size = 3 mm # Edge length of each cubic module. Legacy: LCO. +modules = [100, 40, 20] # Cubic modules along x, y and z (M N L of the legacy file count nodes: one more). Legacy: M N L. +perturbation = 0 # Random node displacement as a fraction of the module size; 0 = regular lattice. +seed = 123 # Seed of the mesh perturbation (the random field has its own seed). Legacy: SEED. + +[material] +law = "bilinear" # Constitutive law of the bars. +young_modulus = 32 GPa # Young's modulus. Legacy: YNG. +poisson_ratio = 0.25 # Poisson's ratio, from 0 up to less than 0.5. Legacy: PSN. +density = 2000 kg/m3 # Mass density. Legacy: ROH. +fracture_energy = 50 N/m # Specific fracture energy. Legacy: GFR. +critical_distance = 28 mm # Equivalent (critical) distance. Legacy: DEQ. +failure_area_factor = 0.1385 # Fraction of the module face that fails per bar. Legacy: CAF. + +[material.scatter] +type = "file" # Scatter of the critical strain: none, file (one multiplier per bar) or generated. +file = "arquivo_3lc_rnao_cv05" # Text file with one multiplier per bar, relative to this file. + +[time] +step = 0.2 us # Integration time step, or auto (0.9 times the critical step). Legacy: DT. +duration = 30 ms # Total simulated time. Legacy: TTOT. + +[damping] +type = "mass_proportional" # Damping model. +initial = 25000 1/s # Mass-proportional damping before switch_time. Legacy: DF1. +final = 25000 1/s # Mass-proportional damping after switch_time. Legacy: DF2. +switch_time = 15 ms # Time at which the damping changes from initial to final. Legacy: TDAF. +constitutive = 0 s # Stiffness-proportional damping inside the bar law. Legacy: CON. + +[scenario] +type = "four_point_bending" # Test case (see ldem.scenarios.registry); its other keys follow. Legacy: TEST. +loading_velocity = 0.004 m/s # Property loadingVelocity of ldem.scenarios.FourPointBending. +support_position = 4.5 modules # Property supportPosition of ldem.scenarios.FourPointBending. +load_position = 33.5 modules # Property loadPosition of ldem.scenarios.FourPointBending. + +[[monitor.node]] +name = "node_1" # Label of the node. +id = 1 # (x, y, z) = (0, 0, 0) modules + +[[monitor.node]] +name = "node_2" # Label of the node. +id = 2 # (x, y, z) = (1, 0, 0) modules + +[[monitor.node]] +name = "node_3" # Label of the node. +id = 3 # (x, y, z) = (2, 0, 0) modules + +[[monitor.node]] +name = "node_4" # Label of the node. +id = 4 # (x, y, z) = (3, 0, 0) modules + +[[monitor.node]] +name = "node_5" # Label of the node. +id = 5 # (x, y, z) = (4, 0, 0) modules + +[monitor.bar] +tracked = 7014 # Number of the bar whose strain history is stored at every step. Legacy: OU9. + +[output] +folder = "output" # Output folder, relative to the case file. +mat = true # Write results.mat. +ansys = true # Write ANSYS macro files (needs snapshots.every > 0). +vtk = true # Write VTK files for ParaView (needs snapshots.every > 0). + +[output.snapshots] +every = 10000 steps # Steps or time between full-field snapshots; 0 = never. Legacy: OU3. + +[output.control_nodes] +every = 1 step # Steps or time between records of the control nodes and reactions; 0 = never. Legacy: OU6. + +[output.energy] +every = 1 step # Steps or time between records of the energies; 0 = never. Legacy: OU8. diff --git a/examples/example1_clamped_beam/case.ldem b/examples/example1_clamped_beam/case.ldem new file mode 100644 index 0000000..3f61d3c --- /dev/null +++ b/examples/example1_clamped_beam/case.ldem @@ -0,0 +1,69 @@ +# Case file generated by ldem.io.convertLegacyInput from DATA0.DAT. +# Example 1: beam clamped at both ends, loaded with a force at mid-span + +format = 1 # Version of the case-file format (currently 1). +title = "Example 1: beam clamped at both ends, loaded with a force at mid-span" # Free text title of the case. +authors = ["Rodrigo"] # Names of the authors. + +[mesh] +module_size = 1 mm # Edge length of each cubic module. Legacy: LCO. +modules = [5, 5, 50] # Cubic modules along x, y and z (M N L of the legacy file count nodes: one more). Legacy: M N L. +perturbation = 0 # Random node displacement as a fraction of the module size; 0 = regular lattice. +seed = 123 # Seed of the mesh perturbation (the random field has its own seed). Legacy: SEED. + +[material] +law = "bilinear" # Constitutive law of the bars. +young_modulus = 3.87 GPa # Young's modulus. Legacy: YNG. +poisson_ratio = 0.25 # Poisson's ratio, from 0 up to less than 0.5. Legacy: PSN. +density = 1500 kg/m3 # Mass density. Legacy: ROH. +fracture_energy = 0.5 N/m # Specific fracture energy. Legacy: GFR. +critical_distance = 4.5 mm # Equivalent (critical) distance. Legacy: DEQ. +failure_area_factor = 0.1385 # Fraction of the module face that fails per bar. Legacy: CAF. + +[material.scatter] +type = "file" # Scatter of the critical strain: none, file (one multiplier per bar) or generated. +file = "../beam_102/arquivo_3lc_rnao_cv05" # Text file with one multiplier per bar, relative to this file. + +[time] +step = 0.35 us # Integration time step, or auto (0.9 times the critical step). Legacy: DT. +duration = 2.8 ms # Total simulated time. Legacy: TTOT. + +[damping] +type = "mass_proportional" # Damping model. +initial = 2500 1/s # Mass-proportional damping before switch_time. Legacy: DF1. +final = 2500 1/s # Mass-proportional damping after switch_time. Legacy: DF2. +switch_time = 15 ms # Time at which the damping changes from initial to final. Legacy: TDAF. +constitutive = 0 s # Stiffness-proportional damping inside the bar law. Legacy: CON. + +[scenario] +type = "clamped_beam" # Test case (see ldem.scenarios.registry); its other keys follow. Legacy: TEST. +force_rate = 1000 N/s # Property forceRate of ldem.scenarios.ClampedBeam. +ramp_time = 0.35 ms # Property rampTime of ldem.scenarios.ClampedBeam. +load_position = "midspan" # Property loadPosition of ldem.scenarios.ClampedBeam. +load_height = 0.5 modules # Property loadHeight of ldem.scenarios.ClampedBeam. + +[[monitor.node]] +name = "node_2441" # Label of the node. +id = 2441 # (x, y, z) = (4.5, 0.5, 24.5) modules + +[[monitor.node]] +name = "node_884" # Label of the node. +id = 884 # (x, y, z) = (1, 3, 24) modules + +[monitor.bar] +tracked = 14398 # Number of the bar whose strain history is stored at every step. Legacy: OU9. + +[output] +folder = "output" # Output folder, relative to the case file. +mat = true # Write results.mat. +ansys = true # Write ANSYS macro files (needs snapshots.every > 0). +vtk = true # Write VTK files for ParaView (needs snapshots.every > 0). + +[output.snapshots] +every = 1000 steps # Steps or time between full-field snapshots; 0 = never. Legacy: OU3. + +[output.control_nodes] +every = 1 step # Steps or time between records of the control nodes and reactions; 0 = never. Legacy: OU6. + +[output.energy] +every = 1 step # Steps or time between records of the energies; 0 = never. Legacy: OU8. diff --git a/src/+ldem/+io/convertLegacyInput.m b/src/+ldem/+io/convertLegacyInput.m new file mode 100644 index 0000000..618600d --- /dev/null +++ b/src/+ldem/+io/convertLegacyInput.m @@ -0,0 +1,95 @@ +function text = convertLegacyInput(dataPath, casePath, options) +%CONVERTLEGACYINPUT Convert a DATA0.DAT input file into a case file (.ldem). +% +% text = ldem.io.convertLegacyInput(dataPath, casePath) reads the legacy +% input file with ldem.io.readInputFile and writes the equivalent case +% file: named keys, units, comments, M N L converted to modules, the control +% nodes with their coordinates, and the scenario of the TEST number with its +% default values. The case file gives exactly the same ldem.Parameters as +% ldem.Parameters.fromFile(dataPath). +% +% Values that the legacy file does not contain can be given as options. The +% converter never guesses them: in the examples of this repository the value +% OU2 of the DATA0.DAT is the number of the tracked bar, but the legacy code +% does not use it, so it is only copied into a comment. +% +% Inputs: +% dataPath Path of the DATA0.DAT file. +% casePath Path of the .ldem file to create ("" to only return the text). +% +% Name-value options: +% RandomFieldFile File with the random field (enables scatter type "file"). +% TrackedBar Bar whose strain history is stored (see monitor.bar). +% Scenario Scenario object (default: the one of the TEST number). +% Title Title for the case file (default: the DATA0 file name). +% Authors String array of authors. +% OutputFolder Value of output.folder (default "output"). +% +% Output: +% text Content of the case file. +% +% Example: +% ldem.io.convertLegacyInput("examples/beam_102/DATA0.DAT", ... +% "examples/beam_102/case.ldem"); +% +% See also ldem.io.readCase, ldem.io.readInputFile, ldem.io.writeCase. + +arguments + dataPath (1,1) string + casePath (1,1) string + options.RandomFieldFile (1,1) string = "" + options.TrackedBar = [] + options.Scenario = [] + options.Title (1,1) string = "" + options.Authors (1,:) string = string.empty + options.OutputFolder (1,1) string = "output" +end + +overrides = {}; +if strlength(options.RandomFieldFile) > 0 + overrides = [overrides, {'randomFieldFile', options.RandomFieldFile}]; +end +if ~isempty(options.TrackedBar) + overrides = [overrides, {'trackedBar', options.TrackedBar}]; +end +params = ldem.Parameters.fromFile(dataPath, overrides{:}); +if ~isempty(options.TrackedBar) + output = params.output; + output.trackedBarEvery = 1; + params.output = output; +end + +[~, dataName, dataExt] = fileparts(dataPath); +title = options.Title; +if title == "" + title = "Converted from " + string(dataName) + string(dataExt); +end +header = "Case file generated by ldem.io.convertLegacyInput from " + string(dataName) + string(dataExt) + "."; +ou2 = legacyOu2(dataPath); +if ~isnan(ou2) && isempty(options.TrackedBar) + header(end+1) = "The legacy value OU2 was " + ldem.schema.shortestText(ou2) + ... + " (not used by ldem). If it is the number of the tracked bar, set [monitor.bar] tracked."; +end + +text = ldem.io.writeCase(casePath, params, options.Scenario, ... + Title = title, Authors = options.Authors, Header = header, ... + OutputFolder = options.OutputFolder); +end + +function value = legacyOu2(dataPath) +%LEGACYOU2 The OU2 value of a DATA0.DAT file, or NaN if it cannot be read. +try + lines = splitlines(string(fileread(dataPath))); + tokens = strings(0, 1); + for k = 1:numel(lines) + word = strtok(strtrim(lines(k))); + if strlength(word) > 0 + tokens(end+1, 1) = word; %#ok + end + end + nControl = str2double(tokens(13)); + value = str2double(tokens(13 + nControl + 1)); +catch + value = NaN; +end +end diff --git a/src/+ldem/+io/parseCaseJson.m b/src/+ldem/+io/parseCaseJson.m new file mode 100644 index 0000000..efdeb3b --- /dev/null +++ b/src/+ldem/+io/parseCaseJson.m @@ -0,0 +1,91 @@ +function entries = parseCaseJson(text, source) +%PARSECASEJSON Parse a case file written in JSON into a list of entries. +% +% entries = ldem.io.parseCaseJson(text, source) gives the same list as +% ldem.io.parseCaseText for the same case, so ldem.io.readCase treats both +% formats alike. The JSON has one object per section and the values that +% carry a unit are strings: +% +% { +% "format": 1, +% "mesh": { "module_size": "1 mm", "modules": [5, 5, 50] }, +% "monitor": { "node": [ {"id": 2441}, {"id": 884} ] } +% } +% +% A repeated table such as [[monitor.node]] is an array of objects. JSON has +% no comments; use the .ldem format for files written by hand. +% +% Inputs: +% text Content of the file. +% source Name used in the error messages. +% +% Output: +% entries Struct array, see ldem.io.parseCaseText (line is 0). +% +% Errors: +% ldem:case:syntax The text is not valid JSON or has an unsupported shape. +% +% See also ldem.io.readCase, ldem.io.parseCaseText. + +arguments + text (1,1) string + source (1,1) string = "case" +end + +try + data = jsondecode(text); +catch err + ldem.schema.raise('ldem:case:syntax', source, 'Invalid JSON: %s', err.message); +end +if ~isstruct(data) || ~isscalar(data) + ldem.schema.raise('ldem:case:syntax', source, 'The JSON must be an object at the top level.'); +end + +entries = struct('section', {}, 'index', {}, 'key', {}, 'value', {}, 'line', {}); +entries = addObject(entries, data, "", 0, source); +end + +function entries = addObject(entries, object, section, index, source) +names = string(fieldnames(object)).'; +for name = names + value = object.(name); + childSection = joinSection(section, name); + if isstruct(value) && isscalar(value) + entries = addObject(entries, value, childSection, 0, source); + elseif isstruct(value) || (iscell(value) && ~isempty(value) && all(cellfun(@isstruct, value))) + if iscell(value) + items = value; + else + items = num2cell(value); + end + for k = 1:numel(items) + entries = addObject(entries, items{k}, childSection, k, source); + end + else + entries(end+1) = struct('section', section, 'index', index, 'key', name, ... + 'value', {leafValue(value, section, name, source)}, 'line', 0); %#ok + end +end +end + +function value = leafValue(raw, section, name, source) +if ischar(raw) + value = string(raw); +elseif iscell(raw) && all(cellfun(@ischar, raw)) + value = reshape(string(raw), 1, []); +elseif isnumeric(raw) || islogical(raw) + value = reshape(raw, 1, []); + if isscalar(value) + value = value(1); + end +else + ldem.schema.raise('ldem:case:syntax', source, ... + 'The value of "%s" in section "%s" has an unsupported type.', name, section); +end +end + +function name = joinSection(section, name) +if section ~= "" + name = section + "." + name; +end +end diff --git a/src/+ldem/+io/parseCaseText.m b/src/+ldem/+io/parseCaseText.m new file mode 100644 index 0000000..a18313d --- /dev/null +++ b/src/+ldem/+io/parseCaseText.m @@ -0,0 +1,226 @@ +function entries = parseCaseText(text, source) +%PARSECASETEXT Parse the text of a case file (.ldem) into a list of entries. +% +% entries = ldem.io.parseCaseText(text, source) reads the TOML-like syntax +% of the case files. It only checks the syntax: it does not know which keys +% exist (see ldem.io.readCase for that). +% +% Syntax: +% +% # a comment, from # to the end of the line (not inside quotes) +% title = "Text in double quotes" +% [section] a table; names may be dotted: [a.b] +% key = 3.87 GPa a number with an optional unit +% key = [5, 5, 50] a list of numbers or of quoted strings +% key = true true or false +% [[monitor.node]] starts the next element of a repeated table +% +% A value that is neither quoted, a list nor true/false is a number when it +% is a plain number and otherwise kept as text ("3.87 GPa", "1000 steps", +% "auto"); ldem.io.readCase interprets it according to the key. Lists must +% fit in one line. There are no escape sequences in quoted strings. +% +% Inputs: +% text Content of the file. +% source Name used in the error messages, usually the file name. +% +% Output: +% entries Struct array with the fields +% section Table name ("" before the first table). +% index 0 for [section]; k for the k-th [[section]]. +% key Key name. +% value double, double row, logical, string or string row. +% line Line number in the text. +% +% Errors: +% ldem:case:syntax The text does not follow the syntax above. +% +% Example: +% e = ldem.io.parseCaseText("[time]" + newline + "duration = 2.8 ms"); +% e.value % "2.8 ms" +% +% See also ldem.io.readCase, ldem.io.parseCaseJson. + +arguments + text (1,1) string + source (1,1) string = "case" +end + +utf8Bom = string(char([239 187 191])); % a UTF-8 file read with an 8-bit encoding +if startsWith(text, utf8Bom) + text = extractAfter(text, 3); +elseif startsWith(text, string(char(65279))) + text = extractAfter(text, 1); +end + +lines = splitlines(text); +entries = struct('section', {}, 'index', {}, 'key', {}, 'value', {}, 'line', {}); +section = ""; +index = 0; +tablesSeen = strings(0, 1); +arrayCount = struct(); +keysSeen = strings(0, 1); +namePattern = '^[A-Za-z_]\w*(\.[A-Za-z_]\w*)*$'; + +for n = 1:numel(lines) + where = source + ":" + string(n); + line = strtrim(stripComment(char(lines(n)))); + if isempty(line) + continue + end + + if startsWith(line, "[[") + if ~endsWith(line, "]]") + ldem.schema.raise('ldem:case:syntax', where, 'The header "%s" must end with ]].', line); + end + name = strtrim(string(extractBetween(string(line), 3, strlength(line) - 2))); + checkName(name, namePattern, where); + field = regexprep(char(name), '\W', '_'); + if ~isfield(arrayCount, field) + arrayCount.(field) = 0; + end + arrayCount.(field) = arrayCount.(field) + 1; + section = name; + index = arrayCount.(field); + keysSeen = strings(0, 1); + elseif startsWith(line, "[") + if ~endsWith(line, "]") + ldem.schema.raise('ldem:case:syntax', where, 'The header "%s" must end with ].', line); + end + name = strtrim(string(extractBetween(string(line), 2, strlength(line) - 1))); + checkName(name, namePattern, where); + if any(tablesSeen == name) + ldem.schema.raise('ldem:case:syntax', where, 'The section [%s] appears twice.', name); + end + tablesSeen(end+1, 1) = name; %#ok + section = name; + index = 0; + keysSeen = strings(0, 1); + else + eq = find(line == '=', 1); + if isempty(eq) + ldem.schema.raise('ldem:case:syntax', where, ... + 'Expected "key = value" or a [section] header, found "%s".', line); + end + key = strtrim(string(line(1:eq-1))); + if isempty(regexp(key, '^[A-Za-z_]\w*$', 'once')) + ldem.schema.raise('ldem:case:syntax', where, ... + '"%s" is not a valid key name (letters, digits and _, not starting with a digit).', key); + end + if any(keysSeen == key) + ldem.schema.raise('ldem:case:syntax', where, ... + 'The key "%s" appears twice in the same section.', key); + end + keysSeen(end+1, 1) = key; %#ok + value = parseValue(strtrim(string(line(eq+1:end))), where); + entries(end+1) = struct('section', section, 'index', index, 'key', key, ... + 'value', {value}, 'line', n); %#ok + end +end +end + +function checkName(name, pattern, where) +if isempty(regexp(name, pattern, 'once')) + ldem.schema.raise('ldem:case:syntax', where, ... + '"%s" is not a valid section name (words separated by dots).', name); +end +end + +function text = stripComment(text) +%STRIPCOMMENT Remove a # comment that is not inside double quotes. +inQuote = false; +for k = 1:numel(text) + if text(k) == '"' + inQuote = ~inQuote; + elseif text(k) == '#' && ~inQuote + text = text(1:k-1); + return + end +end +end + +function value = parseValue(text, where) +%PARSEVALUE Interpret the right-hand side of "key = value". +if strlength(text) == 0 + ldem.schema.raise('ldem:case:syntax', where, 'The key has no value.'); +end +chars = char(text); +if chars(1) == '"' + closing = find(chars == '"'); + if numel(closing) < 2 + ldem.schema.raise('ldem:case:syntax', where, 'The quoted text %s is not closed.', text); + end + if closing(2) ~= numel(chars) + ldem.schema.raise('ldem:case:syntax', where, ... + 'Unexpected text after the closing quote: %s.', text); + end + value = string(chars(2:closing(2)-1)); +elseif chars(1) == '[' + if chars(end) ~= ']' + ldem.schema.raise('ldem:case:syntax', where, ... + 'The list %s must close with ] on the same line.', text); + end + value = parseList(chars(2:end-1), where); +elseif text == "true" + value = true; +elseif text == "false" + value = false; +elseif ~isempty(regexp(text, '^[+-]?(\d+\.?\d*|\.\d+)([eE][+-]?\d+)?$', 'once')) + value = str2double(text); +else + value = text; +end +end + +function value = parseList(inner, where) +%PARSELIST Items of a one-line list, separated by commas outside quotes. +items = strings(0, 1); +current = ''; +inQuote = false; +for k = 1:numel(inner) + c = inner(k); + if c == '"' + inQuote = ~inQuote; + current(end+1) = c; %#ok + elseif c == ',' && ~inQuote + items(end+1, 1) = strtrim(string(current)); %#ok + current = ''; + else + current(end+1) = c; %#ok + end +end +if inQuote + ldem.schema.raise('ldem:case:syntax', where, 'A quoted text in the list is not closed.'); +end +last = strtrim(string(current)); +if last ~= "" || ~isempty(items) + items(end+1, 1) = last; +end +if ~isempty(items) && items(end) == "" && numel(items) > 1 + items(end) = []; % trailing comma +end + +if isempty(items) || (isscalar(items) && items == "") + value = zeros(1, 0); + return +end + +isText = startsWith(items, '"'); +if any(isText) && ~all(isText) + ldem.schema.raise('ldem:case:syntax', where, 'A list cannot mix numbers and quoted texts.'); +end +if all(isText) + if any(~endsWith(items, '"') | strlength(items) < 2) + ldem.schema.raise('ldem:case:syntax', where, 'A quoted text in the list is not closed.'); + end + value = reshape(extractBetween(items, 2, strlength(items) - 1), 1, []); +else + numbers = str2double(items); + bad = find(isnan(numbers), 1); + if ~isempty(bad) + ldem.schema.raise('ldem:case:syntax', where, ... + '"%s" in the list is not a number.', items(bad)); + end + value = reshape(numbers, 1, []); +end +end diff --git a/src/+ldem/+io/readCase.m b/src/+ldem/+io/readCase.m new file mode 100644 index 0000000..4764eac --- /dev/null +++ b/src/+ldem/+io/readCase.m @@ -0,0 +1,643 @@ +function c = readCase(path) +%READCASE Read a case file (.ldem or .json) and build the simulation inputs. +% +% c = ldem.io.readCase(path) reads a case file, checks every key against +% ldem.schema.caseSchema, converts the units to SI and returns the objects +% that ldem.runSimulation needs. The format is described in +% docs/source/en/usage.rst and in the template written by +% ldem.io.writeTemplate. A short example: +% +% format = 1 +% [mesh] +% module_size = 3 mm +% modules = [5, 2, 2] # cubic modules along x, y and z +% [time] +% step = auto +% duration = 40 us +% [scenario] +% type = "uniaxial_tension" +% +% Keys that are missing take the default of ldem.Parameters; the keys +% scenario.type, mesh.modules and time.duration are required. Every error +% names the file, the line, the section and the key. +% +% Relative paths (the random-field file and the output folder) are relative +% to the folder of the case file. +% +% Input: +% path Path of a .ldem file or of a .json file with the same structure. +% +% Output: +% c Struct with the fields +% params Validated ldem.Parameters. +% scenario Scenario object with the values of the [scenario] section. +% options Struct with OutputFolder and Formats, for runSimulation. +% info Struct: source, format, title, authors, controlNodeNames +% and nodeNotes (how each "at" position was resolved). +% +% Errors: +% ldem:io:fileNotFound The file does not exist. +% ldem:io:unknownExtension The extension is not .ldem or .json. +% ldem:case:syntax The text is not valid. +% ldem:case:unknownKey A key or section does not exist. +% ldem:case:missingKey A required key is missing. +% ldem:case:badValue A value has the wrong type or unit. +% ldem:case:invalidValue ldem.Parameters rejects a value. +% ldem:case:inconsistentKey A key does not fit the chosen type. +% ldem:params:* The cross-checks of ldem.Parameters/validate. +% +% Example: +% c = ldem.io.readCase("examples/example1_clamped_beam/case.ldem"); +% results = ldem.runSimulation(c.params, Scenario=c.scenario); +% +% See also ldem.run, ldem.check, ldem.io.writeCase, +% ldem.io.convertLegacyInput, ldem.Parameters.fromFile. + +arguments + path (1,1) string +end + +if ~isfile(path) + error('ldem:io:fileNotFound', 'Case file "%s" does not exist.', path); +end +absPath = absolutePath(path); +[folder, name, ext] = fileparts(absPath); +ctx = struct('source', string(name) + string(ext), 'folder', string(folder)); + +text = string(fileread(absPath)); +switch lower(string(ext)) + case ".ldem" + entries = ldem.io.parseCaseText(text, ctx.source); + case ".json" + entries = ldem.io.parseCaseJson(text, ctx.source); + otherwise + error('ldem:io:unknownExtension', ... + 'Case files must be .ldem or .json, got "%s".', ext); +end + +schema = ldem.schema.caseSchema(); +reg = ldem.scenarios.registry(); +defaults = ldem.Parameters(); + +checkKnownKeys(entries, schema, ctx); +checkRequired(entries, schema, ctx); +checkFormat(entries, ctx); + +values = struct(); +origin = struct(); +[values, origin] = readSimpleKeys(values, origin, entries, schema, ctx); +[values, origin] = readModules(values, origin, entries, ctx); +readEnum(entries, schema, "material.law", ctx); +readEnum(entries, schema, "damping.type", ctx); +checkScatter(entries, schema, ctx); + +% Time step: explicit, or "auto" (also when the key is absent). +[values, origin] = readTimeStep(values, origin, entries, defaults, ctx); + +% Cadence of the outputs, in steps. +output = defaults.output; +for row = schema(string({schema.kind}) == "cadence").' + e = findEntry(entries, sectionOf(row.path), keyOf(row.path)); + if ~isempty(e) + output.(row.prop) = cadenceToSteps(e.value, values.dt, location(e, ctx)); + end +end +eTracked = findEntry(entries, "monitor.bar", "tracked"); +output.trackedBarEvery = double(~isempty(eTracked)); + +% Scenario. +[scenario, testId] = readScenario(entries, reg, ctx); + +% Control nodes. +nodeItems = readNodeItems(entries, ctx); + +% Build the parameters, attributing every error to its line. +p = ldem.Parameters(); +for field = string(fieldnames(values)).' + try + p.(field) = values.(field); + catch err + ldem.schema.raise('ldem:case:invalidValue', origin.(field), '%s', firstLine(err.message)); + end +end +p.testId = testId; + +nodeNotes = strings(0, 1); +if ~isempty(nodeItems) + [ids, nodeNotes] = resolveNodes(nodeItems, p, ctx); + try + p.controlNodes = ids; + catch err + ldem.schema.raise('ldem:case:invalidValue', ctx.source + " [monitor.node]", ... + '%s', firstLine(err.message)); + end + names = [nodeItems.name]; + emptyName = names == ""; + names(emptyName) = "node_" + string(ids(emptyName)); +else + names = "node_" + string(p.controlNodes); +end +p.output = output; + +try + p.validate(); +catch err + error(err.identifier, '%s', char(ctx.source + ": " + string(err.message))); +end + +c = struct(); +c.params = p; +c.scenario = scenario; +c.options = readOutputOptions(entries, output, ctx); +c.info = struct('source', string(absPath), 'format', 1, ... + 'title', stringValue(entries, "", "title", ""), ... + 'authors', stringValue(entries, "", "authors", strings(1, 0)), ... + 'controlNodeNames', names, 'nodeNotes', nodeNotes); +end + +% ------------------------------------------------------------------------ + +function checkKnownKeys(entries, schema, ctx) +paths = string({schema.path}); +pathSections = sectionsOf(paths); +known = unique(pathSections); +for e = entries + if e.section == "scenario" && e.key ~= "type" + continue % keys of the scenario class, checked in readScenario + end + if any(paths == fullPath(e)) + continue + end + if ~any(known == e.section) + ldem.schema.raise('ldem:case:unknownKey', location(e, ctx), ... + 'The section [%s] does not exist.%s Sections: %s.', e.section, ... + ldem.schema.suggest(e.section, known(known ~= "")), strjoin([known(known ~= ""), "scenario"], ', ')); + end + siblings = keysOf(paths(pathSections == e.section)); + ldem.schema.raise('ldem:case:unknownKey', location(e, ctx), ... + 'The key "%s" does not exist in [%s].%s Valid keys: %s.', e.key, e.section, ... + ldem.schema.suggest(e.key, siblings), strjoin(siblings, ', ')); +end +end + +function checkRequired(entries, schema, ctx) +for row = schema([schema.required]).' + if isempty(findEntry(entries, sectionOf(row.path), keyOf(row.path), true)) + ldem.schema.raise('ldem:case:missingKey', ctx.source, ... + 'Missing the required key "%s" in [%s].', keyOf(row.path), sectionOf(row.path)); + end +end +end + +function checkFormat(entries, ctx) +e = findEntry(entries, "", "format"); +if ~isempty(e) && ~(isnumeric(e.value) && isscalar(e.value) && e.value == 1) + ldem.schema.raise('ldem:case:unsupportedFormat', location(e, ctx), ... + 'This version of ldem reads format = 1.'); +end +end + +function [values, origin] = readSimpleKeys(values, origin, entries, schema, ctx) +simple = ["integer" "number" "quantity" "path" "numberlist"]; +for row = schema.' + if row.prop == "" || ~any(row.kind == simple) + continue + end + e = findEntry(entries, sectionOf(row.path), keyOf(row.path)); + if isempty(e) + continue + end + where = location(e, ctx); + values.(row.prop) = convertValue(e.value, row, where, ctx); + origin.(row.prop) = where; +end +end + +function value = convertValue(v, row, where, ctx) +switch row.kind + case "integer" + if ~(isnumeric(v) && isscalar(v) && isfinite(v) && v == fix(v)) + ldem.schema.raise('ldem:case:badValue', where, ... + 'Expected an integer, found %s.', describe(v)); + end + value = v; + case "number" + if ~(isnumeric(v) && isscalar(v) && isfinite(v)) + ldem.schema.raise('ldem:case:badValue', where, ... + 'Expected a number, found %s.', describe(v)); + end + value = v; + case "quantity" + value = ldem.schema.parseQuantity(v, row.dimension, where); + case "numberlist" + if ~(isnumeric(v) && ~isempty(v) && all(isfinite(v))) + ldem.schema.raise('ldem:case:badValue', where, ... + 'Expected a number or a list of numbers, found %s.', describe(v)); + end + value = reshape(v, 1, []); + case "path" + if ~(isstring(v) && isscalar(v)) + ldem.schema.raise('ldem:case:badValue', where, ... + 'Expected a path in quotes, found %s.', describe(v)); + end + if isempty(regexp(v, '^([A-Za-z]:|[\\/])', 'once')) && strlength(v) > 0 + value = string(fullfile(ctx.folder, v)); + else + value = v; + end +end +end + +function [values, origin] = readModules(values, origin, entries, ctx) +e = findEntry(entries, "mesh", "modules"); +where = location(e, ctx); +v = e.value; +if ~(isnumeric(v) && numel(v) == 3 && all(v >= 1) && all(v == fix(v))) + ldem.schema.raise('ldem:case:badValue', where, ... + 'Expected three integers >= 1 (modules along x, y and z), found %s.', describe(v)); +end +values.nModules = reshape(v, 1, 3) + 1; % the legacy M N L count nodes +origin.nModules = where; +end + +function word = readEnum(entries, schema, path, ctx) +%READENUM Value of an "enum" key, or "" if absent. Throws if not allowed. +e = findEntry(entries, sectionOf(path), keyOf(path)); +if isempty(e) + word = ""; + return +end +row = schema(string({schema.path}) == path); +choices = split(string(row.choices), "|").'; +word = enumWord(e, choices, ctx); +end + +function word = enumWord(e, choices, ctx) +where = location(e, ctx); +if ~(isstring(e.value) && isscalar(e.value)) + ldem.schema.raise('ldem:case:badValue', where, ... + 'Expected one of %s in quotes, found %s.', strjoin(choices, ', '), describe(e.value)); +end +word = lower(strtrim(e.value)); +if ~any(choices == word) + ldem.schema.raise('ldem:case:badValue', where, ... + 'Unknown value "%s".%s Allowed: %s.', e.value, ldem.schema.suggest(word, choices), ... + strjoin(choices, ', ')); +end +end + +function checkScatter(entries, schema, ctx) +keys = ["file" "cv" "correlation_length" "seed"]; +present = false(size(keys)); +for k = 1:numel(keys) + present(k) = ~isempty(findEntry(entries, "material.scatter", keys(k))); +end +kind = readEnum(entries, schema, "material.scatter.type", ctx); +if kind == "" + if any(present) + ldem.schema.raise('ldem:case:missingKey', ctx.source, ... + 'Missing "type" in [material.scatter] (none, file or generated).'); + end + return +end +switch kind + case "none" + allowed = strings(1, 0); + case "file" + allowed = "file"; + case "generated" + allowed = ["cv" "correlation_length" "seed"]; +end +for k = find(present) + if ~any(allowed == keys(k)) + e = findEntry(entries, "material.scatter", keys(k)); + ldem.schema.raise('ldem:case:inconsistentKey', location(e, ctx), ... + 'The key "%s" does not apply when type = "%s".', keys(k), kind); + end +end +if kind == "file" && ~present(1) + ldem.schema.raise('ldem:case:missingKey', ctx.source, ... + 'type = "file" needs the key "file" in [material.scatter].'); +end +if kind == "generated" && ~present(2) + ldem.schema.raise('ldem:case:missingKey', ctx.source, ... + 'type = "generated" needs the key "cv" in [material.scatter].'); +end +end + +function [values, origin] = readTimeStep(values, origin, entries, defaults, ctx) +e = findEntry(entries, "time", "step"); +isAuto = isempty(e) || (isstring(e.value) && isscalar(e.value) && lower(strtrim(e.value)) == "auto"); +if isAuto + L = valueOr(values, 'moduleLength', defaults.moduleLength); + E = valueOr(values, 'youngModulus', defaults.youngModulus); + rho = valueOr(values, 'density', defaults.density); + values.dt = 0.9 * (sqrt(3) / 2 * L) / sqrt(E / rho); + origin.dt = ctx.source + " [time] step"; +else + where = location(e, ctx); + values.dt = ldem.schema.parseQuantity(e.value, "time", where); + origin.dt = where; +end +end + +function steps = cadenceToSteps(v, dt, where) +%CADENCETOSTEPS Number of steps for "every = 1000 steps" or "every = 0.1 ms". +if isnumeric(v) && isscalar(v) + steps = checkSteps(v, where); + return +end +if ~(isstring(v) && isscalar(v)) + ldem.schema.raise('ldem:case:badValue', where, ... + 'Expected a number of steps or a time, found %s.', describe(v)); +end +tokens = regexp(strtrim(v), '^(\S+)\s*(\S*)$', 'tokens', 'once'); +if isempty(tokens) + ldem.schema.raise('ldem:case:badValue', where, ... + 'Expected "1000 steps" or a time such as "0.1 ms", found "%s".', v); +end +unit = lower(string(tokens{2})); +if any(unit == ["" "step" "steps"]) + steps = checkSteps(str2double(tokens{1}), where); + return +end +t = ldem.schema.parseQuantity(v, "time", where); +steps = round(t / dt); +if t > 0 && steps < 1 + ldem.schema.raise('ldem:case:badValue', where, ... + '%s is shorter than the time step (%g s).', v, dt); +end +if abs(t / dt - steps) > 1e-6 * max(1, steps) + warning('ldem:case:cadenceNotMultiple', ... + '%s: %s is not a multiple of the time step (%g s); using %d steps.', where, v, dt, steps); +end +end + +function steps = checkSteps(x, where) +if ~(isfinite(x) && x >= 0 && x == fix(x)) + ldem.schema.raise('ldem:case:badValue', where, ... + 'Expected a non-negative whole number of steps, found %g.', x); +end +steps = x; +end + +function [scenario, testId] = readScenario(entries, reg, ctx) +eType = findEntry(entries, "scenario", "type"); +choices = [reg.name]; +name = enumWord(eType, choices, ctx); +k = find(choices == name, 1); +spec = reg(k); + +propNames = string(fieldnames(spec.units)).'; +snake = lower(regexprep(propNames, '([a-z0-9])([A-Z])', '$1_$2')); +args = struct(); +for e = entries + if e.section ~= "scenario" || e.key == "type" + continue + end + j = find(snake == e.key, 1); + where = location(e, ctx); + if isempty(j) + ldem.schema.raise('ldem:case:unknownKey', where, ... + 'The scenario "%s" has no key "%s".%s Valid keys: %s.', name, e.key, ... + ldem.schema.suggest(e.key, snake), strjoin(["type" snake], ', ')); + end + prop = propNames(j); + if isfield(spec.keywords, prop) && isstring(e.value) && isscalar(e.value) ... + && lower(strtrim(e.value)) == spec.keywords.(prop) + args.(prop) = NaN; + else + args.(prop) = ldem.schema.parseQuantity(e.value, spec.units.(prop), where); + end +end +try + argList = namedargs2cell(args); + scenario = feval(spec.className, argList{:}); +catch err + ldem.schema.raise('ldem:case:invalidValue', location(eType, ctx) + " (scenario)", ... + '%s', firstLine(err.message)); +end +testId = spec.testId; +end + +function items = readNodeItems(entries, ctx) +%READNODEITEMS The [[monitor.node]] elements, as a struct array. +items = struct('id', {}, 'at', {}, 'name', {}, 'line', {}); +sections = string({entries.section}); +indices = [entries.index]; +for k = unique(indices(sections == "monitor.node")) + pick = entries(sections == "monitor.node" & indices == k); + eId = pick(string({pick.key}) == "id"); + eAt = pick(string({pick.key}) == "at"); + eName = pick(string({pick.key}) == "name"); + where = location(pick(1), ctx); + if isempty(eId) && isempty(eAt) + ldem.schema.raise('ldem:case:missingKey', where, ... + 'A [[monitor.node]] needs either "id" or "at".'); + end + if ~isempty(eId) && ~isempty(eAt) + ldem.schema.raise('ldem:case:inconsistentKey', where, ... + 'A [[monitor.node]] takes either "id" or "at", not both.'); + end + item = struct('id', NaN, 'at', zeros(1, 0), 'name', "", 'line', pick(1).line); + if ~isempty(eId) + v = eId.value; + if ~(isnumeric(v) && isscalar(v) && v == fix(v) && v >= 1) + ldem.schema.raise('ldem:case:badValue', location(eId, ctx), ... + 'Expected a node number (integer >= 1), found %s.', describe(v)); + end + item.id = v; + else + v = eAt.value; + if ~(isnumeric(v) && numel(v) == 3 && all(isfinite(v))) + ldem.schema.raise('ldem:case:badValue', location(eAt, ctx), ... + 'Expected three numbers [x, y, z] in modules, found %s.', describe(v)); + end + item.at = reshape(v, 1, 3); + end + if ~isempty(eName) + item.name = string(eName.value); + end + items(end+1) = item; %#ok +end +end + +function [ids, notes] = resolveNodes(items, p, ctx) +%RESOLVENODES Node numbers of the control nodes; "at" positions use the nearest node. +ids = zeros(1, numel(items)); +notes = strings(0, 1); +nodes = []; +for k = 1:numel(items) + if ~isnan(items(k).id) + ids(k) = items(k).id; + continue + end + if isempty(nodes) + nodes = ldem.mesh.buildNodes(p.nModules, p.moduleLength) / p.moduleLength; + end + [distance, ids(k)] = min(vecnorm(nodes - items(k).at, 2, 2)); + if distance > 1e-6 + notes(end+1, 1) = sprintf('%s:%d: the position [%g, %g, %g] modules is not a node; using node %d at [%g, %g, %g] modules.', ... + ctx.source, items(k).line, items(k).at, ids(k), nodes(ids(k), :)); %#ok + warning('ldem:case:nodeApproximated', '%s', notes(end)); + end +end +end + +function options = readOutputOptions(entries, output, ctx) +eFolder = findEntry(entries, "output", "folder"); +if isempty(eFolder) + folder = ""; +else + folder = eFolder.value; + if ~(isstring(folder) && isscalar(folder)) + ldem.schema.raise('ldem:case:badValue', location(eFolder, ctx), ... + 'Expected a folder name in quotes, found %s.', describe(folder)); + end + if strlength(folder) > 0 && isempty(regexp(folder, '^([A-Za-z]:|[\\/])', 'once')) + folder = string(fullfile(ctx.folder, folder)); + end +end +formats = strings(1, 0); +for format = ["mat" "ansys" "vtk"] + e = findEntry(entries, "output", format); + if isempty(e) + wanted = format == "mat"; + else + wanted = e.value; + if ~(islogical(wanted) && isscalar(wanted)) + ldem.schema.raise('ldem:case:badValue', location(e, ctx), ... + 'Expected true or false, found %s.', describe(wanted)); + end + end + if wanted + formats(end+1) = format; %#ok + end +end +if any(formats == ["ansys"; "vtk"], 'all') && output.snapshotEvery == 0 + warning('ldem:case:noSnapshots', ... + ['%s: ansys/vtk files are requested but [output.snapshots] every is 0, ' ... + 'so none will be written.'], ctx.source); +end +options = struct('OutputFolder', folder, 'Formats', formats); +end + +% ------------------------------------------------------------------------ + +function e = findEntry(entries, section, key, anyIndex) +%FINDENTRY The entry of a key of a plain table (index 0), or [] if absent. +if nargin < 4 + anyIndex = false; +end +if isempty(entries) + e = []; + return +end +match = string({entries.section}) == section & string({entries.key}) == key; +if ~anyIndex + match = match & [entries.index] == 0; +end +k = find(match, 1); +if isempty(k) + e = []; +else + e = entries(k); +end +end + +function section = sectionOf(path) +path = string(path); +dot = find(char(path) == '.', 1, 'last'); +if isempty(dot) + section = ""; +else + section = extractBefore(path, dot); +end +end + +function sections = sectionsOf(paths) +sections = strings(size(paths)); +for k = 1:numel(paths) + sections(k) = sectionOf(paths(k)); +end +end + +function keys = keysOf(paths) +keys = strings(size(paths)); +for k = 1:numel(paths) + keys(k) = keyOf(paths(k)); +end +end + +function key = keyOf(path) +path = string(path); +dot = find(char(path) == '.', 1, 'last'); +if isempty(dot) + key = path; +else + key = extractAfter(path, dot); +end +end + +function p = fullPath(e) +if e.section == "" + p = e.key; +else + p = e.section + "." + e.key; +end +end + +function w = location(e, ctx) +%LOCATION "file:line [section] key" for the error messages. +w = ctx.source; +if e.line > 0 + w = w + ":" + string(e.line); +end +if e.section ~= "" + w = w + " [" + e.section + "]"; +end +w = w + " " + e.key; +end + +function text = describe(v) +%DESCRIBE Short text of a value for the error messages. +if isstring(v) || ischar(v) + text = '"' + strjoin(string(v), '", "') + '"'; +elseif islogical(v) + text = strjoin(string(v), ", "); +else + text = "[" + strjoin(string(v), ", ") + "]"; +end +end + +function value = valueOr(values, field, fallback) +if isfield(values, field) + value = values.(field); +else + value = fallback; +end +end + +function value = stringValue(entries, section, key, fallback) +e = findEntry(entries, section, key); +if isempty(e) + value = fallback; +else + value = reshape(string(e.value), 1, []); + if isscalar(fallback) || ischar(fallback) + value = value(1); + end +end +end + +function line = firstLine(message) +line = strtok(string(message), newline); +end + +function p = absolutePath(path) +if isempty(regexp(path, '^([A-Za-z]:|[\\/])', 'once')) + p = string(fullfile(pwd, path)); +else + p = path; +end +end diff --git a/src/+ldem/+io/writeCase.m b/src/+ldem/+io/writeCase.m new file mode 100644 index 0000000..9898ee7 --- /dev/null +++ b/src/+ldem/+io/writeCase.m @@ -0,0 +1,327 @@ +function text = writeCase(path, params, scenario, options) +%WRITECASE Write the case file (.ldem) of a parameter set and a scenario. +% +% text = ldem.io.writeCase(path, params, scenario) writes a complete, +% commented case file that ldem.io.readCase reads back into the same +% parameters and scenario, and returns its text. Every key is written, with +% units, so the file documents the model by itself. Use it to save what was +% run, to build a template, and (through ldem.io.convertLegacyInput) to +% convert a DATA0.DAT. +% +% text = ldem.io.writeCase("", params, scenario) only returns the text. +% +% Inputs: +% path Path of the file to create ("" to only return the text). +% params ldem.Parameters. +% scenario Scenario object (default: the one of params.testId). +% +% Name-value options: +% Title Text of the "title" key. +% Authors String array for the "authors" key. +% Header Extra comment lines at the top (without the #). +% OutputFolder Value of output.folder (default "output"). +% Formats Files to enable in [output]: "mat", "ansys", "vtk" +% (default all; ansys and vtk are switched off when +% snapshots are never taken). +% ControlNodeNames One label per control node (default "node_"). +% Comments false to omit the explanatory comments (default true). +% +% Output: +% text The content of the file, a string scalar. +% +% Errors: +% ldem:io:unregisteredScenario The scenario class is not in +% ldem.scenarios.registry. +% ldem:io:cannotOpenFile The file cannot be created. +% +% Example: +% p = ldem.Parameters(testId=101, nModules=[6 3 3]); +% ldem.io.writeCase("tension.ldem", p, ldem.scenarios.UniaxialTension()); +% +% See also ldem.io.readCase, ldem.io.convertLegacyInput, +% ldem.io.writeTemplate. + +arguments + path (1,1) string + params (1,1) ldem.Parameters + scenario = [] + options.Title (1,1) string = "" + options.Authors (1,:) string = string.empty + options.Header (1,:) string = string.empty + options.OutputFolder (1,1) string = "output" + options.Formats (1,:) string {mustBeMember(options.Formats, ["mat" "ansys" "vtk"])} = ["mat" "ansys" "vtk"] + options.ControlNodeNames (1,:) string = string.empty + options.Comments (1,1) logical = true +end + +if isempty(scenario) + scenario = ldem.scenarios.fromTestId(params.testId); +end +reg = ldem.scenarios.registry(); +k = find([reg.className] == string(class(scenario)), 1); +if isempty(k) + error('ldem:io:unregisteredScenario', ... + 'The scenario class %s is not in ldem.scenarios.registry.', class(scenario)); +end +spec = reg(k); + +schema = ldem.schema.caseSchema(); +paths = string({schema.path}); +withComments = options.Comments; +doc = @(key) docText(schema(paths == key)); + +lines = strings(0, 1); +for h = options.Header + lines(end+1, 1) = "# " + h; %#ok +end +if options.Title ~= "" + lines(end+1, 1) = "# " + options.Title; +end +if ~isempty(lines) + lines(end+1, 1) = ""; +end +rows = {"format", "1", doc("format")}; +if options.Title ~= "" + rows(end+1, :) = {"title", quote(options.Title), doc("title")}; +end +if ~isempty(options.Authors) + rows(end+1, :) = {"authors", "[" + strjoin(quote(options.Authors), ", ") + "]", doc("authors")}; +end +lines = [lines; block(rows, withComments); ""]; + +q = @ldem.schema.formatQuantity; +num = @ldem.schema.shortestText; + +% [mesh] +rows = { + "module_size", q(params.moduleLength, "length"), doc("mesh.module_size") + "modules", listText(params.nModules - 1), doc("mesh.modules") + "perturbation", num(params.meshPerturbation), doc("mesh.perturbation") + "seed", num(params.seed), doc("mesh.seed")}; +lines = [lines; section("mesh", rows, withComments)]; + +% [material] +rows = { + "law", quote("bilinear"), doc("material.law") + "young_modulus", q(params.youngModulus, "pressure"), doc("material.young_modulus") + "poisson_ratio", num(params.poissonRatio), doc("material.poisson_ratio") + "density", q(params.density, "density"), doc("material.density") + "fracture_energy", q(params.fractureEnergy, "toughness"), doc("material.fracture_energy") + "critical_distance", q(params.criticalDistance, "length"), doc("material.critical_distance") + "failure_area_factor", num(params.failureAreaFactor), doc("material.failure_area_factor")}; +lines = [lines; section("material", rows, withComments)]; + +% [material.scatter] +if strlength(params.randomFieldFile) > 0 + rows = { + "type", quote("file"), doc("material.scatter.type") + "file", quote(relativeTo(params.randomFieldFile, path)), doc("material.scatter.file")}; +elseif params.randomFieldCv > 0 + rows = { + "type", quote("generated"), doc("material.scatter.type") + "cv", num(params.randomFieldCv), doc("material.scatter.cv") + "correlation_length", listOrScalar(params.randomFieldCorrelationLength), ... + doc("material.scatter.correlation_length") + "seed", num(params.randomFieldSeed), doc("material.scatter.seed")}; +else + rows = {"type", quote("none"), doc("material.scatter.type")}; +end +lines = [lines; section("material.scatter", rows, withComments)]; + +% [time] +rows = { + "step", q(params.dt, "time"), doc("time.step") + "duration", q(params.totalTime, "time"), doc("time.duration")}; +lines = [lines; section("time", rows, withComments)]; + +% [damping] +rows = { + "type", quote("mass_proportional"), doc("damping.type") + "initial", q(params.dampingInitial, "rate"), doc("damping.initial") + "final", q(params.dampingFinal, "rate"), doc("damping.final") + "switch_time", q(params.dampingSwitchTime, "time"), doc("damping.switch_time") + "constitutive", q(params.constitutiveDamping, "time"), doc("damping.constitutive")}; +lines = [lines; section("damping", rows, withComments)]; + +% [scenario] +rows = {"type", quote(spec.name), doc("scenario.type")}; +for prop = string(fieldnames(spec.units)).' + key = lower(regexprep(prop, '([a-z0-9])([A-Z])', '$1_$2')); + value = scenario.(prop); + if isnan(value) && isfield(spec.keywords, prop) + valueText = quote(spec.keywords.(prop)); + else + valueText = q(value, spec.units.(prop)); + end + rows(end+1, :) = {key, valueText, "Property " + prop + " of " + string(class(scenario)) + "."}; %#ok +end +lines = [lines; section("scenario", rows, withComments)]; + +% [[monitor.node]] +names = options.ControlNodeNames; +if numel(names) ~= numel(params.controlNodes) + names = "node_" + string(params.controlNodes); +end +nodes = ldem.mesh.buildNodes(params.nModules, params.moduleLength) / params.moduleLength; +for j = 1:numel(params.controlNodes) + id = params.controlNodes(j); + where = ""; + if id <= size(nodes, 1) + where = "(x, y, z) = (" + strjoin(string(nodes(id, :)), ", ") + ") modules"; + end + rows = { + "name", quote(names(j)), doc("monitor.node.name") + "id", num(id), where}; + lines = [lines; "[[monitor.node]]"; block(rows, withComments); ""]; %#ok +end + +% [monitor.bar] +if params.output.trackedBarEvery > 0 + rows = {"tracked", num(params.trackedBar), doc("monitor.bar.tracked")}; + lines = [lines; section("monitor.bar", rows, withComments)]; +elseif withComments + lines = [lines; "[monitor.bar]"; ... + "# tracked = " + num(params.trackedBar) + " # uncomment to store the strain history of this bar"; ""]; +end + +% [output] +formats = options.Formats; +if params.output.snapshotEvery == 0 + formats = setdiff(formats, ["ansys" "vtk"], 'stable'); +end +rows = { + "folder", quote(options.OutputFolder), doc("output.folder") + "mat", boolText(any(formats == "mat")), doc("output.mat") + "ansys", boolText(any(formats == "ansys")), doc("output.ansys") + "vtk", boolText(any(formats == "vtk")), doc("output.vtk")}; +lines = [lines; section("output", rows, withComments)]; +lines = [lines; section("output.snapshots", ... + {"every", stepsText(params.output.snapshotEvery), doc("output.snapshots.every")}, withComments)]; +lines = [lines; section("output.control_nodes", ... + {"every", stepsText(params.output.controlNodesEvery), doc("output.control_nodes.every")}, withComments)]; +lines = [lines; section("output.energy", ... + {"every", stepsText(params.output.energyEvery), doc("output.energy.every")}, withComments)]; + +text = strjoin(lines, newline); +text = regexprep(text, '\n+$', '') + newline; + +if strlength(path) > 0 + folder = fileparts(path); + if strlength(folder) > 0 && ~isfolder(folder) + mkdir(folder); + end + fid = fopen(path, 'w', 'n', 'UTF-8'); + if fid == -1 + error('ldem:io:cannotOpenFile', 'Cannot create "%s".', path); + end + fprintf(fid, '%s', text); + fclose(fid); +end +end + +function note = docText(row) +%DOCTEXT Comment of a key: its description and the legacy variable it replaces. +note = string(row.doc); +if row.legacy ~= "" + note = note + " Legacy: " + string(row.legacy) + "."; +end +end + +function lines = section(name, rows, withComments) +lines = ["[" + name + "]"; block(rows, withComments); ""]; +end + +function lines = block(rows, withComments) +%BLOCK Aligned "key = value # comment" lines. +n = size(rows, 1); +keyWidth = max(strlength(string(rows(:, 1)))); +texts = strings(n, 1); +for r = 1:n + texts(r) = string(sprintf('%-*s', keyWidth, rows{r, 1})) + " = " + string(rows{r, 2}); +end +width = max(strlength(texts)); +lines = texts; +if withComments + for r = 1:n + comment = string(rows{r, 3}); + if comment ~= "" + lines(r) = string(sprintf('%-*s', width, texts(r))) + " # " + comment; + end + end +end +end + +function t = quote(s) +if any(contains(s, '"')) + error('ldem:io:badText', 'Texts written to a case file cannot contain double quotes: %s', s(1)); +end +t = '"' + s + '"'; +end + +function t = listText(v) +parts = strings(size(v)); +for k = 1:numel(v) + parts(k) = ldem.schema.shortestText(v(k)); +end +t = "[" + strjoin(parts, ", ") + "]"; +end + +function t = listOrScalar(v) +if isscalar(v) + t = ldem.schema.shortestText(v); +else + t = listText(v); +end +end + +function t = boolText(flag) +if flag + t = "true"; +else + t = "false"; +end +end + +function t = stepsText(n) +if n == 0 + t = "0"; +elseif n == 1 + t = "1 step"; +else + t = string(n) + " steps"; +end +end + +function t = relativeTo(file, casePath) +%RELATIVETO Path of a file relative to the folder of the case file, with / separators. +file = strrep(string(file), '\', '/'); +folder = strrep(string(fileparts(absoluteOf(casePath))), '\', '/'); +if folder == "" || isempty(regexp(file, '^([A-Za-z]:|/)', 'once')) + t = file; % no case folder to compare with, or already relative + return +end +fileParts = split(file, "/"); +folderParts = split(folder, "/"); +n = 0; +while n < min(numel(fileParts) - 1, numel(folderParts)) && ... + strcmpi(fileParts(n + 1), folderParts(n + 1)) + n = n + 1; +end +if n == 0 + t = file; % another drive + return +end +up = repmat("..", 1, numel(folderParts) - n); +t = strjoin([up, fileParts(n + 1:end).'], "/"); +end + +function p = absoluteOf(path) +path = string(path); +if path == "" + p = ""; +elseif isempty(regexp(path, '^([A-Za-z]:|[\\/])', 'once')) + p = string(fullfile(pwd, path)); +else + p = path; +end +end diff --git a/src/+ldem/+io/writeTemplate.m b/src/+ldem/+io/writeTemplate.m new file mode 100644 index 0000000..6a0700a --- /dev/null +++ b/src/+ldem/+io/writeTemplate.m @@ -0,0 +1,35 @@ +function text = writeTemplate(path, scenarioName) +%WRITETEMPLATE Write a commented case file to start a new model from. +% +% text = ldem.io.writeTemplate(path) writes a complete case file with the +% default values of ldem.Parameters for the "uniaxial_tension" scenario, +% with one comment per key (taken from ldem.schema.caseSchema), ready to +% edit. +% +% text = ldem.io.writeTemplate(path, scenarioName) uses another scenario: +% "uniaxial_tension", "four_point_bending" or "clamped_beam". The keys of +% the [scenario] section are those of that scenario. +% +% Inputs: +% path Path of the file to create ("" to only return the text). +% scenarioName Name in ldem.scenarios.registry (default "uniaxial_tension"). +% +% Output: +% text Content of the file. +% +% Example: +% ldem.io.writeTemplate("my_test.ldem", "clamped_beam"); +% +% See also ldem.io.writeCase, ldem.io.readCase, ldem.scenarios.fromName. + +arguments + path (1,1) string + scenarioName (1,1) string = "uniaxial_tension" +end + +scenario = ldem.scenarios.fromName(scenarioName); +params = ldem.Parameters(testId = scenario.testId); +text = ldem.io.writeCase(path, params, scenario, ... + Title = "New case (template for " + scenarioName + ")", ... + Header = "Edit the values; every key has a comment. Units go after the number."); +end diff --git a/src/+ldem/+scenarios/Scenario.m b/src/+ldem/+scenarios/Scenario.m index 7cbc8b8..420b893 100644 --- a/src/+ldem/+scenarios/Scenario.m +++ b/src/+ldem/+scenarios/Scenario.m @@ -10,7 +10,9 @@ % 1. Set the constant property testId to a new number. % 2. Implement fixedDofs and applyLoads. % 3. Optionally override reactions. - % 4. Register the class in ldem.scenarios.fromTestId. + % 4. Register the class in ldem.scenarios.registry (one line with its + % name for the case files, its test number and the units of the + % properties that a case file may set). % % See also ldem.scenarios.UniaxialTension, % ldem.scenarios.FourPointBending, ldem.scenarios.ClampedBeam, diff --git a/src/+ldem/+scenarios/fromName.m b/src/+ldem/+scenarios/fromName.m new file mode 100644 index 0000000..005b13f --- /dev/null +++ b/src/+ldem/+scenarios/fromName.m @@ -0,0 +1,32 @@ +function scenario = fromName(name) +%FROMNAME Create the scenario object with a name used in the case files. +% +% scenario = ldem.scenarios.fromName(name) returns an instance, with its +% default values, of the scenario registered under name in +% ldem.scenarios.registry: "uniaxial_tension", "four_point_bending" or +% "clamped_beam". +% +% Input: +% name Scenario name (case is ignored). +% +% Output: +% scenario Object of a subclass of ldem.scenarios.Scenario. +% +% Errors: +% ldem:scenarios:unknownName No scenario has that name. +% +% See also ldem.scenarios.registry, ldem.scenarios.fromTestId. + +arguments + name (1,1) string +end + +reg = ldem.scenarios.registry(); +k = find([reg.name] == lower(name), 1); +if isempty(k) + error('ldem:scenarios:unknownName', ... + 'There is no scenario named "%s".%s Available: %s.', name, ... + ldem.schema.suggest(name, [reg.name]), strjoin([reg.name], ', ')); +end +scenario = feval(reg(k).className); +end diff --git a/src/+ldem/+scenarios/fromTestId.m b/src/+ldem/+scenarios/fromTestId.m index 95e8aa7..9737bad 100644 --- a/src/+ldem/+scenarios/fromTestId.m +++ b/src/+ldem/+scenarios/fromTestId.m @@ -8,7 +8,7 @@ % 102 ldem.scenarios.FourPointBending % 103 ldem.scenarios.ClampedBeam % -% To register a new scenario, add a line to the list inside this file. +% To register a new scenario, add a line to ldem.scenarios.registry. % % Input: % testId Test number (Parameters.testId). @@ -19,24 +19,18 @@ % Errors: % ldem:scenarios:unknownTest No scenario has that number. % -% See also ldem.scenarios.Scenario. +% See also ldem.scenarios.Scenario, ldem.scenarios.registry. arguments testId (1,1) double end -registered = {ldem.scenarios.UniaxialTension(), ldem.scenarios.FourPointBending(), ... - ldem.scenarios.ClampedBeam()}; - -for k = 1:numel(registered) - if registered{k}.testId == testId - scenario = registered{k}; - return - end +reg = ldem.scenarios.registry(); +k = find([reg.testId] == testId, 1); +if isempty(k) + error('ldem:scenarios:unknownTest', ... + 'There is no scenario for testId = %g. Available: %s.', ... + testId, strjoin(string([reg.testId]), ', ')); end - -known = cellfun(@(s) s.testId, registered); -error('ldem:scenarios:unknownTest', ... - 'There is no scenario for testId = %g. Available: %s.', ... - testId, strjoin(string(known), ', ')); +scenario = feval(reg(k).className); end diff --git a/src/+ldem/+scenarios/registry.m b/src/+ldem/+scenarios/registry.m new file mode 100644 index 0000000..8b56134 --- /dev/null +++ b/src/+ldem/+scenarios/registry.m @@ -0,0 +1,49 @@ +function reg = registry() +%REGISTRY List of the available scenarios (test cases). +% +% reg = ldem.scenarios.registry() returns one element per scenario class. +% It is the only place that has to be edited to register a new scenario: +% ldem.scenarios.fromTestId, ldem.scenarios.fromName and the case-file +% reader (the [scenario] section) all read it. +% +% Fields of every element: +% +% name Name used in the case file, "type = ..." (snake_case). +% className Name of the class, a subclass of ldem.scenarios.Scenario. +% testId Value of the constant property testId of the class. +% units Struct that maps each property that can be set from a case +% file to its dimension (see ldem.schema.unitTable). The key in +% the file is the property name in snake_case: forceRate is +% force_rate. +% keywords Struct that maps a property to a word that stands for NaN +% in the file (ClampedBeam.loadPosition: "midspan"). +% +% Output: +% reg Struct array. +% +% Example: +% reg = ldem.scenarios.registry(); +% [reg.name] % "uniaxial_tension" "four_point_bending" ... +% +% See also ldem.scenarios.Scenario, ldem.scenarios.fromTestId, +% ldem.scenarios.fromName. + +reg = struct('name', {}, 'className', {}, 'testId', {}, 'units', {}, 'keywords', {}); + +reg(end+1) = makeEntry("uniaxial_tension", "ldem.scenarios.UniaxialTension", 101, ... + struct('loadingVelocity', "velocity"), struct()); + +reg(end+1) = makeEntry("four_point_bending", "ldem.scenarios.FourPointBending", 102, ... + struct('loadingVelocity', "velocity", 'supportPosition', "modules", ... + 'loadPosition', "modules"), struct()); + +reg(end+1) = makeEntry("clamped_beam", "ldem.scenarios.ClampedBeam", 103, ... + struct('forceRate', "forcerate", 'rampTime', "time", ... + 'loadPosition', "modules", 'loadHeight', "modules"), ... + struct('loadPosition', "midspan")); +end + +function entry = makeEntry(name, className, testId, units, keywords) +entry = struct('name', name, 'className', className, 'testId', testId, ... + 'units', units, 'keywords', keywords); +end diff --git a/src/+ldem/+schema/caseSchema.m b/src/+ldem/+schema/caseSchema.m new file mode 100644 index 0000000..0af24f5 --- /dev/null +++ b/src/+ldem/+schema/caseSchema.m @@ -0,0 +1,127 @@ +function schema = caseSchema() +%CASESCHEMA Table of the keys of a case file (.ldem), the single source of truth. +% +% schema = ldem.schema.caseSchema() returns one row per key. The reader +% (ldem.io.readCase), the writer (ldem.io.writeCase) and the template are +% all driven by this table, so adding a key to the file format means adding +% a row here and, when it maps to an ldem.Parameters property, nothing else. +% +% Fields of every row: +% +% path Section and key, for example "material.young_modulus". +% kind How the value is read: "integer", "number", "quantity" (a +% number with a unit), "string", "stringlist", "path" (a file, +% relative to the case file), "intlist", "numberlist", "bool", +% "enum", "stepOrAuto" or "cadence" (steps or time). +% dimension Dimension of a "quantity", see ldem.schema.unitTable. +% prop Name of the ldem.Parameters property it sets ("" if the key +% needs special handling). +% required True if the file must contain the key. +% legacy Variable of the legacy DATA0.DAT file it replaces. +% doc One-line description, used for the comments of the template. +% choices Allowed words of an "enum", separated by "|". +% +% The keys of the [scenario] section other than "type" belong to the chosen +% scenario class and are described by ldem.scenarios.registry. +% +% Output: +% schema Struct array (one element per key). +% +% Example: +% schema = ldem.schema.caseSchema(); +% schema(strcmp({schema.path}, "mesh.module_size")).legacy % "LCO" +% +% See also ldem.io.readCase, ldem.io.writeCase, ldem.scenarios.registry. + +fields = ["path" "kind" "dimension" "prop" "required" "legacy" "doc" "choices"]; +rows = { + "format", "integer", "number", "", false, "", ... + "Version of the case-file format (currently 1).", "" + "title", "string", "number", "", false, "", ... + "Free text title of the case.", "" + "authors", "stringlist", "number", "", false, "", ... + "Names of the authors.", "" + + "mesh.module_size", "quantity", "length", "moduleLength", false, "LCO", ... + "Edge length of each cubic module.", "" + "mesh.modules", "intlist", "number", "nModules", true, "M N L", ... + "Cubic modules along x, y and z (M N L of the legacy file count nodes: one more).", "" + "mesh.perturbation", "number", "number", "meshPerturbation", false, "", ... + "Random node displacement as a fraction of the module size; 0 = regular lattice.", "" + "mesh.seed", "integer", "number", "seed", false, "SEED", ... + "Seed of the mesh perturbation (the random field has its own seed).", "" + + "material.law", "enum", "number", "", false, "", ... + "Constitutive law of the bars.", "bilinear" + "material.young_modulus", "quantity", "pressure", "youngModulus", false, "YNG", ... + "Young's modulus.", "" + "material.poisson_ratio", "number", "number", "poissonRatio", false, "PSN", ... + "Poisson's ratio, from 0 up to less than 0.5.", "" + "material.density", "quantity", "density", "density", false, "ROH", ... + "Mass density.", "" + "material.fracture_energy", "quantity", "toughness", "fractureEnergy", false, "GFR", ... + "Specific fracture energy.", "" + "material.critical_distance", "quantity", "length", "criticalDistance", false, "DEQ", ... + "Equivalent (critical) distance.", "" + "material.failure_area_factor", "number", "number", "failureAreaFactor", false, "CAF", ... + "Fraction of the module face that fails per bar.", "" + + "material.scatter.type", "enum", "number", "", false, "", ... + "Scatter of the critical strain: none, file (one multiplier per bar) or generated.", ... + "none|file|generated" + "material.scatter.file", "path", "number", "randomFieldFile", false, "", ... + "Text file with one multiplier per bar, relative to this file.", "" + "material.scatter.cv", "number", "number", "randomFieldCv", false, "", ... + "Coefficient of variation of the generated field (1e-4 to 3).", "" + "material.scatter.correlation_length", "numberlist", "number", ... + "randomFieldCorrelationLength", false, "", ... + "Correlation length of the generated field in modules: one value or [x, y, z].", "" + "material.scatter.seed", "integer", "number", "randomFieldSeed", false, "", ... + "Seed of the generated field.", "" + + "time.step", "stepOrAuto", "time", "dt", false, "DT", ... + "Integration time step, or auto (0.9 times the critical step).", "" + "time.duration", "quantity", "time", "totalTime", true, "TTOT", ... + "Total simulated time.", "" + + "damping.type", "enum", "number", "", false, "", ... + "Damping model.", "mass_proportional" + "damping.initial", "quantity", "rate", "dampingInitial", false, "DF1", ... + "Mass-proportional damping before switch_time.", "" + "damping.final", "quantity", "rate", "dampingFinal", false, "DF2", ... + "Mass-proportional damping after switch_time.", "" + "damping.switch_time", "quantity", "time", "dampingSwitchTime", false, "TDAF", ... + "Time at which the damping changes from initial to final.", "" + "damping.constitutive", "quantity", "time", "constitutiveDamping", false, "CON", ... + "Stiffness-proportional damping inside the bar law.", "" + + "scenario.type", "enum", "number", "", true, "TEST", ... + "Test case (see ldem.scenarios.registry); its other keys follow.", "" + + "monitor.node.id", "integer", "number", "", false, "NCON", ... + "Number of a node whose motion is recorded.", "" + "monitor.node.at", "numberlist", "number", "", false, "", ... + "Position [x, y, z] in modules; the nearest node is recorded.", "" + "monitor.node.name", "string", "number", "", false, "", ... + "Label of the node.", "" + "monitor.bar.tracked", "integer", "number", "trackedBar", false, "OU9", ... + "Number of the bar whose strain history is stored at every step.", "" + + "output.folder", "string", "number", "", false, "", ... + "Output folder, relative to the case file.", "" + "output.mat", "bool", "number", "", false, "", ... + "Write results.mat.", "" + "output.ansys", "bool", "number", "", false, "", ... + "Write ANSYS macro files (needs snapshots.every > 0).", "" + "output.vtk", "bool", "number", "", false, "", ... + "Write VTK files for ParaView (needs snapshots.every > 0).", "" + "output.snapshots.every", "cadence", "number", "snapshotEvery", false, "OU3", ... + "Steps or time between full-field snapshots; 0 = never.", "" + "output.control_nodes.every", "cadence", "number", "controlNodesEvery", false, "OU6", ... + "Steps or time between records of the control nodes and reactions; 0 = never.", "" + "output.energy.every", "cadence", "number", "energyEvery", false, "OU8", ... + "Steps or time between records of the energies; 0 = never.", "" + }; + +schema = cell2struct(rows, fields, 2); +end diff --git a/src/+ldem/+schema/formatQuantity.m b/src/+ldem/+schema/formatQuantity.m new file mode 100644 index 0000000..28a7afd --- /dev/null +++ b/src/+ldem/+schema/formatQuantity.m @@ -0,0 +1,64 @@ +function text = formatQuantity(value, dimension) +%FORMATQUANTITY Write an SI value as a readable number with a unit. +% +% text = ldem.schema.formatQuantity(value, dimension) is the inverse of +% ldem.schema.parseQuantity. Lengths, times and pressures use the unit that +% gives a mantissa of at least 0.1 ("3 mm", "0.35 us", "3.87 GPa"); the other +% dimensions are written in their SI unit. The text always converts back to +% exactly the same value: if a unit would lose a digit, a longer mantissa or +% the SI unit is used. +% +% Inputs: +% value Value in SI units, finite. +% dimension Dimension, see ldem.schema.unitTable. +% +% Output: +% text String scalar. +% +% Example: +% ldem.schema.formatQuantity(3.5e-7, "time") % "0.35 us" +% +% See also ldem.schema.parseQuantity. + +arguments + value (1,1) double {mustBeFinite} + dimension (1,1) string +end + +[names, exps] = ldem.schema.unitTable(dimension); +base = find(exps == 0, 1); + +order = base; +if any(dimension == ["length" "time" "pressure"]) && value ~= 0 + ratios = abs(value) ./ 10.^exps; + usable = find(ratios >= 0.1 & exps ~= -2); + if isempty(usable) + [~, preferred] = max(ratios); + else + [~, i] = min(ratios(usable)); + preferred = usable(i); + end + order = unique([preferred, base], 'stable'); +end + +for k = order + mantissa = value / str2double("1e" + string(exps(k))); + for digits = 1:17 + shown = ldem.schema.shortestText(str2double(sprintf('%.*g', digits, mantissa))); + candidate = joinUnit(shown, names(k)); + if ldem.schema.parseQuantity(candidate, dimension) == value + text = candidate; + return + end + end +end +text = joinUnit(string(sprintf('%.17g', value)), names(base)); +end + +function text = joinUnit(number, unit) +if unit == "" + text = number; +else + text = number + " " + unit; +end +end diff --git a/src/+ldem/+schema/parseQuantity.m b/src/+ldem/+schema/parseQuantity.m new file mode 100644 index 0000000..3a05930 --- /dev/null +++ b/src/+ldem/+schema/parseQuantity.m @@ -0,0 +1,88 @@ +function value = parseQuantity(input, dimension, where) +%PARSEQUANTITY Convert a number with a unit, such as "3.87 GPa", to SI. +% +% value = ldem.schema.parseQuantity(input, dimension) returns the value in +% SI units (m, s, kg, Pa, N). The input is either +% +% * a number, taken as already being in SI units, or +% * text made of a number and, optionally, a unit: "3.87 GPa", "0.35 us", +% "1e-3 m", "3.87e9". +% +% The decimal exponent of the unit is appended to the digits of the text +% before converting ("0.35" and "e-6" become 0.35e-6), so the result is the +% double nearest to the decimal value that was written. "0.35 us" is +% exactly 3.5e-7. +% +% Inputs: +% input Number or text. +% dimension Dimension of the quantity, see ldem.schema.unitTable. +% where Optional location text for the error messages. +% +% Output: +% value Value in SI units. +% +% Errors: +% ldem:case:badQuantity The text is not a number with a unit. +% ldem:case:badUnit The unit does not belong to the dimension. +% +% Example: +% E = ldem.schema.parseQuantity("3.87 GPa", "pressure"); % 3.87e9 +% +% See also ldem.schema.formatQuantity, ldem.schema.unitTable. + +arguments + input + dimension (1,1) string + where (1,1) string = "" +end + +[names, exps] = ldem.schema.unitTable(dimension); + +if isnumeric(input) || islogical(input) + if ~isscalar(input) || ~isfinite(double(input)) + ldem.schema.raise('ldem:case:badQuantity', where, ... + 'Expected a single finite number.'); + end + value = double(input); + return +end + +if ~(isstring(input) || ischar(input)) || ~isscalar(string(input)) + ldem.schema.raise('ldem:case:badQuantity', where, ... + 'Expected a number with an optional unit, for example "3 mm".'); +end + +text = strtrim(string(input)); +pattern = '^([+-]?(?:\d+\.?\d*|\.\d+)(?:[eE][+-]?\d+)?)\s*(\S*)$'; +tokens = regexp(text, pattern, 'tokens', 'once'); +if isempty(tokens) + ldem.schema.raise('ldem:case:badQuantity', where, ... + '"%s" is not a number with an optional unit.', text); +end +mantissa = string(tokens{1}); +unit = string(tokens{2}); + +if unit == "" + k = find(exps == 0, 1); +else + k = find(names == unit, 1); + if isempty(k) + if all(names == "") + allowed = "no unit"; + else + allowed = strjoin(names, ", "); + end + ldem.schema.raise('ldem:case:badUnit', where, ... + 'Unit "%s" is not valid here; use %s.', unit, allowed); + end +end + +e = exps(k); +if e == 0 + value = str2double(mantissa); +elseif ~contains(mantissa, ["e" "E"]) + value = str2double(mantissa + "e" + string(e)); +else + value = str2double(mantissa) * 10^e; +end +end diff --git a/src/+ldem/+schema/raise.m b/src/+ldem/+schema/raise.m new file mode 100644 index 0000000..2487c77 --- /dev/null +++ b/src/+ldem/+schema/raise.m @@ -0,0 +1,22 @@ +function raise(id, where, message, varargin) +%RAISE Throw an error that points at a place in a case file. +% +% ldem.schema.raise(id, where, message, args...) formats the message with +% sprintf and throws it with the identifier id. When where is not empty, +% for example "case.ldem:14 [time] step", the message starts with it so the +% user knows which line to edit. +% +% Inputs: +% id Error identifier, for example "ldem:case:unknownKey". +% where Location text, or "" for none. +% message sprintf format. +% args Values for the format. +% +% See also ldem.io.readCase. + +text = sprintf(message, varargin{:}); +if strlength(string(where)) > 0 + text = char(string(where) + ": " + string(text)); +end +error(id, '%s', text); +end diff --git a/src/+ldem/+schema/shortestText.m b/src/+ldem/+schema/shortestText.m new file mode 100644 index 0000000..35b8d05 --- /dev/null +++ b/src/+ldem/+schema/shortestText.m @@ -0,0 +1,32 @@ +function text = shortestText(x) +%SHORTESTTEXT Shortest decimal text that converts back to exactly x. +% +% text = ldem.schema.shortestText(x) returns, for example, "0.1" for 0.1, +% "32" for 32 and "3.5e-07" for 3.5e-7. str2double(text) == x always holds +% for a finite x. +% +% Input: +% x Finite real scalar. +% +% Output: +% text String scalar. +% +% See also ldem.schema.formatQuantity. + +arguments + x (1,1) double +end + +if x == fix(x) && abs(x) < 1e15 + text = string(sprintf('%d', x)); + return +end +for digits = 1:17 + candidate = sprintf('%.*g', digits, x); + if str2double(candidate) == x + text = string(candidate); + return + end +end +text = string(sprintf('%.17g', x)); +end diff --git a/src/+ldem/+schema/suggest.m b/src/+ldem/+schema/suggest.m new file mode 100644 index 0000000..53b7b52 --- /dev/null +++ b/src/+ldem/+schema/suggest.m @@ -0,0 +1,56 @@ +function text = suggest(word, candidates) +%SUGGEST Ask "did you mean ...?" for a mistyped word. +% +% text = ldem.schema.suggest(word, candidates) returns a sentence such as +% " Did you mean 'young_modulus'?" when one of the candidates is close to +% word (small edit distance), and "" otherwise. The sentence starts with a +% space so it can be appended to an error message. +% +% Inputs: +% word The word that was written. +% candidates String array of valid words. +% +% Output: +% text String scalar. +% +% Example: +% ldem.schema.suggest("young_modulos", ["young_modulus" "density"]) +% +% See also ldem.io.readCase. + +arguments + word (1,1) string + candidates (1,:) string +end + +best = ""; +bestDistance = inf; +for candidate = candidates + d = editDistance(char(lower(word)), char(lower(candidate))); + if d < bestDistance + bestDistance = d; + best = candidate; + end +end +limit = max(2, floor(strlength(word) / 3)); +if bestDistance <= limit + text = " Did you mean '" + best + "'?"; +else + text = ""; +end +end + +function d = editDistance(a, b) +%EDITDISTANCE Levenshtein distance between two char vectors. +previous = 0:numel(b); +for i = 1:numel(a) + current = zeros(1, numel(b) + 1); + current(1) = i; + for j = 1:numel(b) + cost = double(a(i) ~= b(j)); + current(j + 1) = min([previous(j + 1) + 1, current(j) + 1, previous(j) + cost]); + end + previous = current; +end +d = previous(end); +end diff --git a/src/+ldem/+schema/unitTable.m b/src/+ldem/+schema/unitTable.m new file mode 100644 index 0000000..7350522 --- /dev/null +++ b/src/+ldem/+schema/unitTable.m @@ -0,0 +1,74 @@ +function [names, exps] = unitTable(dimension) +%UNITTABLE Units accepted for a physical dimension in the case files. +% +% [names, exps] = ldem.schema.unitTable(dimension) returns the unit names +% and the decimal exponent of each one with respect to the SI unit, so that +% 1 = 10^exps SI units. The SI unit is the one with exponent 0. +% +% Dimensions: +% +% length m, cm, mm, um, km +% time s, ms, us, ns +% pressure Pa, kPa, MPa, GPa +% density kg/m3, g/cm3 +% rate 1/s, 1/ms (damping coefficient) +% toughness N/m, kN/m (fracture energy) +% velocity m/s, mm/s +% forcerate N/s, kN/s +% modules modules (length in module lengths) +% number no unit +% +% Input: +% dimension One of the names above. +% +% Outputs: +% names 1-by-n string array of unit names ("" for a dimensionless value). +% exps 1-by-n decimal exponents. +% +% Errors: +% ldem:schema:unknownDimension The dimension does not exist. +% +% Example: +% [names, exps] = ldem.schema.unitTable("pressure"); +% +% See also ldem.schema.parseQuantity, ldem.schema.formatQuantity. + +arguments + dimension (1,1) string +end + +switch dimension + case "length" + names = ["m" "cm" "mm" "um" "km"]; + exps = [0 -2 -3 -6 3]; + case "time" + names = ["s" "ms" "us" "ns"]; + exps = [0 -3 -6 -9]; + case "pressure" + names = ["Pa" "kPa" "MPa" "GPa"]; + exps = [0 3 6 9]; + case "density" + names = ["kg/m3" "g/cm3"]; + exps = [0 3]; + case "rate" + names = ["1/s" "1/ms"]; + exps = [0 3]; + case "toughness" + names = ["N/m" "kN/m"]; + exps = [0 3]; + case "velocity" + names = ["m/s" "mm/s"]; + exps = [0 -3]; + case "forcerate" + names = ["N/s" "kN/s"]; + exps = [0 3]; + case "modules" + names = "modules"; + exps = 0; + case "number" + names = ""; + exps = 0; + otherwise + error('ldem:schema:unknownDimension', 'Unknown dimension "%s".', dimension); +end +end diff --git a/src/+ldem/Parameters.m b/src/+ldem/Parameters.m index b8a5a39..bf1b55a 100644 --- a/src/+ldem/Parameters.m +++ b/src/+ldem/Parameters.m @@ -281,20 +281,33 @@ function validate(obj) methods (Static) function obj = fromFile(path, overrides) - %FROMFILE Read the legacy input file (DATA0.DAT format). + %FROMFILE Read an input file: a case file or the legacy DATA0.DAT. % % p = ldem.Parameters.fromFile(path) reads the file and - % returns a validated parameter set. + % returns a validated parameter set. A path ending in .ldem or + % .json is a case file (see ldem.io.readCase, which also gives + % the scenario and the output options); any other file is read + % in the legacy DATA0.DAT format. % % p = ldem.Parameters.fromFile(path, Name=Value) additionally % overrides properties that are not stored in the file, for % example randomFieldFile or trackedBar. % - % See also ldem.io.readInputFile. + % See also ldem.io.readCase, ldem.io.readInputFile. arguments path (1,1) string overrides.?ldem.Parameters end + [~, ~, extension] = fileparts(path); + if any(lower(extension) == [".ldem" ".json"]) + obj = ldem.io.readCase(path).params; + names = fieldnames(overrides); + for k = 1:numel(names) + obj.(names{k}) = overrides.(names{k}); + end + obj.validate(); + return + end fromFile = ldem.io.readInputFile(path); names = fieldnames(overrides); for k = 1:numel(names) diff --git a/src/+ldem/check.m b/src/+ldem/check.m new file mode 100644 index 0000000..d1449cf --- /dev/null +++ b/src/+ldem/check.m @@ -0,0 +1,108 @@ +function report = check(casePath) +%CHECK Dry run of a case file: validate it and report the model without simulating. +% +% ldem.check(casePath) reads the case file, builds the lattice (without +% integrating in time) and prints what the simulation would do: size of the +% model, stability margin of the time step, where each "at" control node +% landed, the state of the random-field file, and the memory that the +% snapshots will need. +% +% report = ldem.check(casePath) returns the same information in a struct +% and prints nothing. +% +% Input: +% casePath Path of the case file (.ldem or .json). +% +% Output: +% report Struct with the fields +% params, scenario As returned by ldem.io.readCase. +% model ldem.mesh.summarizeModel of the lattice. +% timeStepRatio dt divided by the critical time step. +% nSteps Number of time steps. +% nSnapshots Snapshots taken (0 if never). +% snapshotMemoryMB Memory of the snapshots kept in results. +% randomField Text: "none", "generated" or the state of the file. +% controlNodes Struct array: number, name and position +% [x y z] in modules. +% +% Errors: +% The ones of ldem.io.readCase, and ldem:scenarios:noNodesSelected when +% the scenario selects no node of the lattice. +% +% Example: +% ldem.check("examples/example1_clamped_beam/case.ldem") +% +% See also ldem.run, ldem.io.readCase. + +arguments + casePath (1,1) string +end + +c = ldem.io.readCase(casePath); +p = c.params; +mesh = ldem.mesh.buildMesh(p, c.scenario); +model = ldem.mesh.summarizeModel(mesh, p); + +report = struct(); +report.params = p; +report.scenario = c.scenario; +report.model = model; +report.timeStepRatio = p.dt / p.criticalTimeStep; +report.nSteps = p.nSteps; + +every = p.output.snapshotEvery; +if every > 0 + report.nSnapshots = floor(p.nSteps / every) + 1; +else + report.nSnapshots = 0; +end +bytesPerSnapshot = 4 * 3 * model.nNodes + model.nBars + 4 * model.nNodes; +report.snapshotMemoryMB = report.nSnapshots * bytesPerSnapshot / 2^20; + +if strlength(p.randomFieldFile) > 0 + try + ldem.io.readRandomField(p.randomFieldFile, model.nBars); + report.randomField = "file OK: " + p.randomFieldFile + " has at least " + string(model.nBars) + " values"; + catch err + report.randomField = "file PROBLEM: " + string(err.message); + end +elseif p.randomFieldCv > 0 + report.randomField = "generated in memory (cv " + string(p.randomFieldCv) + ")"; +else + report.randomField = "none"; +end + +nodes = mesh.nodes0 / p.moduleLength; +report.controlNodes = struct('number', num2cell(p.controlNodes), ... + 'name', cellstr(c.info.controlNodeNames), ... + 'position', num2cell(nodes(p.controlNodes, :), 2).'); + +if nargout == 0 + printReport(report, c, casePath); + clear report +end +end + +function printReport(report, c, casePath) +p = report.params; +m = report.model; +fprintf('Case file %s\n', casePath); +if strlength(c.info.title) > 0 + fprintf('Title %s\n', c.info.title); +end +fprintf('Scenario %s (testId %d)\n', class(report.scenario), p.testId); +fprintf('Model %d x %d x %d modules of %g m, %d nodes, %d bars, mass %.4g kg\n', ... + m.nModules, p.moduleLength, m.nNodes, m.nBars, m.totalMass); +fprintf('Time %d steps of %g s (%.0f %% of the critical step %g s), %g s in total\n', ... + report.nSteps, p.dt, 100 * report.timeStepRatio, p.criticalTimeStep, p.totalTime); +fprintf('Random field %s\n', report.randomField); +fprintf('Snapshots %d (about %.1f MB kept in results)\n', ... + report.nSnapshots, report.snapshotMemoryMB); +for node = report.controlNodes + fprintf('Control node %-12s number %d at [%g %g %g] modules\n', ... + node.name, node.number, node.position); +end +for note = c.info.nodeNotes.' + fprintf('Note %s\n', note); +end +end diff --git a/src/+ldem/run.m b/src/+ldem/run.m new file mode 100644 index 0000000..a352c3f --- /dev/null +++ b/src/+ldem/run.m @@ -0,0 +1,46 @@ +function results = run(casePath, options) +%RUN Run a simulation described by a case file (.ldem or .json). +% +% results = ldem.run(casePath) reads the case file with ldem.io.readCase and +% runs it with ldem.runSimulation, writing the files requested in its +% [output] section (relative to the case file). It is the one-line way to +% run a model: +% +% results = ldem.run("examples/example1_clamped_beam/case.ldem"); +% +% results = ldem.run(casePath, Name=Value) overrides parts of the case: +% +% OutputFolder Other output folder ("" writes nothing). +% Formats Other files to write, for example "mat". +% Verbose Print the progress (default true). +% +% Input: +% casePath Path of the case file. +% +% Output: +% results Struct returned by ldem.runSimulation. +% +% Example: +% results = ldem.run("my_test.ldem", OutputFolder=tempname); +% +% See also ldem.check, ldem.io.readCase, ldem.runSimulation. + +arguments + casePath (1,1) string + options.OutputFolder = [] + options.Formats = [] + options.Verbose (1,1) logical = true +end + +c = ldem.io.readCase(casePath); +folder = c.options.OutputFolder; +formats = c.options.Formats; +if ~isempty(options.OutputFolder) + folder = string(options.OutputFolder); +end +if ~isempty(options.Formats) + formats = string(options.Formats); +end +results = ldem.runSimulation(c.params, Scenario = c.scenario, ... + OutputFolder = folder, Formats = formats, Verbose = options.Verbose); +end diff --git a/tests/LdemTestCase.m b/tests/LdemTestCase.m index 42d7209..b40ed01 100644 --- a/tests/LdemTestCase.m +++ b/tests/LdemTestCase.m @@ -20,6 +20,8 @@ function addSourceToPath(testCase) testCase.RepoRoot = string(fileparts(here)); testCase.applyFixture(matlab.unittest.fixtures.PathFixture( ... fullfile(testCase.RepoRoot, 'src'))); + testCase.applyFixture(matlab.unittest.fixtures.PathFixture( ... + fullfile(testCase.RepoRoot, 'tests', 'tools'))); end end end diff --git a/tests/tools/TestUnregisteredScenario.m b/tests/tools/TestUnregisteredScenario.m new file mode 100644 index 0000000..78d0302 --- /dev/null +++ b/tests/tools/TestUnregisteredScenario.m @@ -0,0 +1,21 @@ +classdef TestUnregisteredScenario < ldem.scenarios.Scenario + %TESTUNREGISTEREDSCENARIO A scenario that is not in ldem.scenarios.registry (for the tests). + % + % It fixes nothing and applies no load. The tests use it to check that + % code which needs the registry refuses a scenario that is not in it. + % + % See also ldem.scenarios.Scenario, ldem.scenarios.registry. + + properties (Constant) + testId = 999 + end + + methods + function fixed = fixedDofs(~, nodes0, ~) + fixed = false(size(nodes0)); + end + + function state = applyLoads(~, state, ~, ~) + end + end +end diff --git a/tests/tools/writeTextFile.m b/tests/tools/writeTextFile.m new file mode 100644 index 0000000..9300cff --- /dev/null +++ b/tests/tools/writeTextFile.m @@ -0,0 +1,28 @@ +function writeTextFile(path, lines) +%WRITETEXTFILE Write a text file from a list of lines (for the tests). +% +% writeTextFile(path, lines) writes the lines, separated by line feeds, +% creating the folder if needed. +% +% Inputs: +% path Full path of the file. +% lines String array or cell array of lines. +% +% See also writeDataFile. + +arguments + path (1,1) string + lines (:,1) string +end + +folder = fileparts(path); +if strlength(folder) > 0 && ~isfolder(folder) + mkdir(folder); +end +fid = fopen(path, 'w'); +if fid == -1 + error('ldem:tools:cannotOpenFile', 'Cannot create "%s".', path); +end +fprintf(fid, '%s\n', lines); +fclose(fid); +end diff --git a/tests/unit/TestParseCase.m b/tests/unit/TestParseCase.m new file mode 100644 index 0000000..db6140e --- /dev/null +++ b/tests/unit/TestParseCase.m @@ -0,0 +1,106 @@ +classdef TestParseCase < LdemTestCase + %TESTPARSECASE Unit tests of the syntax of the case files (.ldem and .json). + + methods (Access = private) + function e = parse(~, varargin) + e = ldem.io.parseCaseText(strjoin(string(varargin), newline), "t.ldem"); + end + end + + methods (Test, TestTags = {'Unit'}) + function readsSectionsKeysAndValueTypes(testCase) + e = testCase.parse( ... + 'title = "A # not a comment" # but this is', ... + '[mesh]', ... + 'modules = [5, 5, 50]', ... + 'module_size = 1 mm', ... + 'perturbation = 0.02', ... + 'seed = 123', ... + '[output]', ... + 'mat = true', ... + 'vtk = false', ... + 'formats = ["mat", "vtk"]'); + testCase.verifyEqual([e.section], ["" "mesh" "mesh" "mesh" "mesh" "output" "output" "output"]); + testCase.verifyEqual(e(1).value, "A # not a comment"); + testCase.verifyEqual(e(2).value, [5 5 50]); + testCase.verifyEqual(e(3).value, "1 mm"); + testCase.verifyEqual(e(4).value, 0.02); + testCase.verifyEqual(e(5).value, 123); + testCase.verifyTrue(e(6).value); + testCase.verifyFalse(e(7).value); + testCase.verifyEqual(e(8).value, ["mat" "vtk"]); + testCase.verifyEqual([e.line], [1 3 4 5 6 8 9 10]); + end + + function ignoresBlankLinesCommentsAndWindowsLineEnds(testCase) + text = "# header" + string(char([13 10])) + string(char([13 10])) + ... + "[time] # section" + string(char([13 10])) + "duration = 2.8 ms" + string(char([13 10])); + e = ldem.io.parseCaseText(text, "t.ldem"); + testCase.verifySize(e, [1 1]); + testCase.verifyEqual(e.value, "2.8 ms"); + end + + function repeatedTablesGetAnIndex(testCase) + e = testCase.parse('[[monitor.node]]', 'id = 2', '[[monitor.node]]', 'id = 5', 'name = "x"'); + testCase.verifyEqual([e.index], [1 2 2]); + testCase.verifyEqual([e.section], repmat("monitor.node", 1, 3)); + end + + function skipsAUtf8ByteOrderMark(testCase) + text = string(char([239 187 191])) + "format = 1"; + e = ldem.io.parseCaseText(text, "t.ldem"); + testCase.verifyEqual(e.key, "format"); + end + + function emptyAndTrailingCommaLists(testCase) + e = testCase.parse('a = []', 'b = [1, 2,]'); + testCase.verifyEmpty(e(1).value); + testCase.verifyEqual(e(2).value, [1 2]); + end + + function reportsSyntaxErrorsWithTheLine(testCase) + bad = { ... + "[mesh", ... + "[[mesh]", ... + "novalue", ... + "key = ", ... + "1key = 3", ... + "k = ""open", ... + "k = ""a"" b", ... + "k = [1, 2", ... + "k = [1, ""a""]", ... + "k = [1, x]", ... + "[a b]"}; + for k = 1:numel(bad) + try + ldem.io.parseCaseText("# first" + newline + bad{k}, "t.ldem"); + testCase.verifyFail("No error for: " + bad{k}); + catch err + testCase.verifyEqual(err.identifier, 'ldem:case:syntax', bad{k}); + testCase.verifySubstring(err.message, "t.ldem:2"); + end + end + end + + function rejectsRepeatedKeysAndSections(testCase) + testCase.verifyError(@() testCase.parse('[a]', 'x = 1', 'x = 2'), 'ldem:case:syntax'); + testCase.verifyError(@() testCase.parse('[a]', '[a]'), 'ldem:case:syntax'); + end + + function jsonGivesTheSameEntries(testCase) + json = '{"format": 1, "mesh": {"module_size": "1 mm", "modules": [5, 5, 50]}, "output": {"mat": true}, "monitor": {"node": [{"id": 2441}, {"id": 884, "name": "b"}]}}'; + e = ldem.io.parseCaseJson(json, "t.json"); + keys = [e.section] + "." + [e.key]; + testCase.verifyEqual(keys, [".format" "mesh.module_size" "mesh.modules" "output.mat" ... + "monitor.node.id" "monitor.node.id" "monitor.node.name"]); + testCase.verifyEqual([e.index], [0 0 0 0 1 2 2]); + testCase.verifyEqual(e(3).value, [5 5 50]); + testCase.verifyEqual(e(2).value, "1 mm"); + end + + function jsonErrorsAreSyntaxErrors(testCase) + testCase.verifyError(@() ldem.io.parseCaseJson('{"a": ', "t.json"), 'ldem:case:syntax'); + testCase.verifyError(@() ldem.io.parseCaseJson('[1, 2]', "t.json"), 'ldem:case:syntax'); + end + end +end diff --git a/tests/unit/TestQuantities.m b/tests/unit/TestQuantities.m new file mode 100644 index 0000000..2227ac9 --- /dev/null +++ b/tests/unit/TestQuantities.m @@ -0,0 +1,89 @@ +classdef TestQuantities < LdemTestCase + %TESTQUANTITIES Unit tests of the units of the case files (ldem.schema). + + methods (Test, TestTags = {'Unit'}) + function convertsEveryDimension(testCase) + parse = @ldem.schema.parseQuantity; + testCase.verifyEqual(parse("3.87 GPa", "pressure"), 3.87e9); + testCase.verifyEqual(parse("32 GPa", "pressure"), 32e9); + testCase.verifyEqual(parse("1 mm", "length"), 1e-3); + testCase.verifyEqual(parse("28 mm", "length"), 0.028); + testCase.verifyEqual(parse("0.5 km", "length"), 500); + testCase.verifyEqual(parse("0.35 us", "time"), 3.5e-7); + testCase.verifyEqual(parse("2.8 ms", "time"), 2.8e-3); + testCase.verifyEqual(parse("1500 kg/m3", "density"), 1500); + testCase.verifyEqual(parse("2 g/cm3", "density"), 2000); + testCase.verifyEqual(parse("25 1/ms", "rate"), 25000); + testCase.verifyEqual(parse("0.5 kN/m", "toughness"), 500); + testCase.verifyEqual(parse("4 mm/s", "velocity"), 4e-3); + testCase.verifyEqual(parse("2 kN/s", "forcerate"), 2000); + testCase.verifyEqual(parse("24.5 modules", "modules"), 24.5); + end + + function numbersWithoutUnitAreSi(testCase) + testCase.verifyEqual(ldem.schema.parseQuantity(0.003, "length"), 0.003); + testCase.verifyEqual(ldem.schema.parseQuantity("3.87e9", "pressure"), 3.87e9); + testCase.verifyEqual(ldem.schema.parseQuantity(" 7 ", "number"), 7); + end + + function exponentInTheMantissaIsAccepted(testCase) + testCase.verifyEqual(ldem.schema.parseQuantity("3.5E-1 us", "time"), 3.5e-1 * 1e-6, 'RelTol', 1e-15); + end + + function wrongUnitsAndTextAreRejected(testCase) + testCase.verifyError(@() ldem.schema.parseQuantity("3 kg", "length"), 'ldem:case:badUnit'); + testCase.verifyError(@() ldem.schema.parseQuantity("fast", "time"), 'ldem:case:badQuantity'); + testCase.verifyError(@() ldem.schema.parseQuantity("3 mm", "number"), 'ldem:case:badUnit'); + testCase.verifyError(@() ldem.schema.parseQuantity(Inf, "time"), 'ldem:case:badQuantity'); + testCase.verifyError(@() ldem.schema.parseQuantity([1 2], "time"), 'ldem:case:badQuantity'); + testCase.verifyError(@() ldem.schema.parseQuantity("1", "colour"), 'ldem:schema:unknownDimension'); + end + + function errorMessageNamesTheLocation(testCase) + try + ldem.schema.parseQuantity("3 kg", "length", "case.ldem:7 [mesh] module_size"); + testCase.verifyFail('An error was expected.'); + catch err + testCase.verifySubstring(err.message, 'case.ldem:7 [mesh] module_size'); + testCase.verifySubstring(err.message, 'mm'); + end + end + + function formatsReadableUnits(testCase) + format = @ldem.schema.formatQuantity; + testCase.verifyEqual(format(3.5e-7, "time"), "0.35 us"); + testCase.verifyEqual(format(2.8e-3, "time"), "2.8 ms"); + testCase.verifyEqual(format(0.015, "time"), "15 ms"); + testCase.verifyEqual(format(0.003, "length"), "3 mm"); + testCase.verifyEqual(format(3.87e9, "pressure"), "3.87 GPa"); + testCase.verifyEqual(format(1500, "density"), "1500 kg/m3"); + testCase.verifyEqual(format(0, "time"), "0 s"); + testCase.verifyEqual(format(24.5, "modules"), "24.5 modules"); + end + + function formatThenParseGivesTheSameValue(testCase) + values = [1e-3 0.003 3.5e-7 2.8e-3 0.015 4.5e-3 3.87e9 32e9 0.1385 1/3 pi*1e-5 123456789.123 5e-10]; + for dimension = ["length" "time" "pressure" "density" "rate" "toughness" "number"] + for v = values + text = ldem.schema.formatQuantity(v, dimension); + testCase.verifyEqual(ldem.schema.parseQuantity(text, dimension), v, ... + "Round trip of " + string(v) + " as " + dimension + ": " + text); + end + end + end + + function shortestTextRoundTrips(testCase) + for x = [0 1 -4 32 0.1 3.5e-7 1/3 2/3 1e15 1e-300 123456.789] + testCase.verifyEqual(str2double(ldem.schema.shortestText(x)), x); + end + testCase.verifyEqual(ldem.schema.shortestText(0.1), "0.1"); + testCase.verifyEqual(ldem.schema.shortestText(32), "32"); + end + + function suggestsCloseWordsOnly(testCase) + words = ["young_modulus" "density" "poisson_ratio"]; + testCase.verifySubstring(ldem.schema.suggest("young_modulos", words), "young_modulus"); + testCase.verifyEqual(ldem.schema.suggest("zzzzzzzz", words), ""); + end + end +end diff --git a/tests/unit/TestReadCase.m b/tests/unit/TestReadCase.m new file mode 100644 index 0000000..ae81edd --- /dev/null +++ b/tests/unit/TestReadCase.m @@ -0,0 +1,421 @@ +classdef TestReadCase < LdemTestCase + %TESTREADCASE Unit tests of ldem.io.readCase and of the case-file keys. + + properties (Access = private) + Folder (1,1) string + Last = [] + end + + methods (TestMethodSetup) + function makeFolder(testCase) + testCase.Folder = string(testCase.applyFixture( ... + matlab.unittest.fixtures.TemporaryFolderFixture).Folder); + end + end + + methods (Access = private) + function lines = minimal(~) + lines = [ ... + "format = 1" + "[mesh]" + "module_size = 3 mm" + "modules = [5, 2, 2]" + "[time]" + "step = 0.2 us" + "duration = 40 us" + "[scenario]" + "type = ""uniaxial_tension"""]; + end + + function c = read(testCase, extra, name) + % Minimal case plus extra lines (which may open new sections). + if nargin < 3 + name = "case.ldem"; + end + path = fullfile(testCase.Folder, name); + writeTextFile(path, [testCase.minimal(); string(extra(:))]); + c = ldem.io.readCase(path); + end + + function storeRead(testCase, extra) + % Keeps the result in Last, to read it after verifyWarning. + testCase.Last = testCase.read(extra); + end + + function verifyCaseError(testCase, extra, id, fragment) + path = fullfile(testCase.Folder, "bad.ldem"); + writeTextFile(path, [testCase.minimal(); string(extra(:))]); + try + ldem.io.readCase(path); + testCase.verifyFail("An error was expected for: " + strjoin(string(extra), " / ")); + catch err + testCase.verifyEqual(string(err.identifier), string(id)); + testCase.verifySubstring(err.message, fragment); + end + end + end + + methods (Test, TestTags = {'Unit'}) + function minimalCaseTakesTheDefaults(testCase) + c = testCase.read(strings(0, 1)); + p = c.params; + d = ldem.Parameters(); + testCase.verifyEqual(p.nModules, [6 3 3]); + testCase.verifyEqual(p.moduleLength, 0.003); + testCase.verifyEqual(p.dt, 2e-7); + testCase.verifyEqual(p.totalTime, 4e-5); + testCase.verifyEqual(p.testId, 101); + testCase.verifyEqual(p.youngModulus, d.youngModulus); + testCase.verifyEqual(p.output, d.output); + testCase.verifyEqual(p.controlNodes, d.controlNodes); + testCase.verifyClass(c.scenario, 'ldem.scenarios.UniaxialTension'); + testCase.verifyEqual(c.options.OutputFolder, ""); + testCase.verifyEqual(c.options.Formats, "mat"); + end + + function convertsUnitsOfTheMaterial(testCase) + c = testCase.read([ ... + "[material]" + "young_modulus = 3.87 GPa" + "density = 1.5 g/cm3" + "fracture_energy = 0.5 N/m" + "critical_distance = 4.5 mm" + "poisson_ratio = 0.2" + "failure_area_factor = 0.2" + "[damping]" + "initial = 2.5 1/ms" + "final = 1000" + "switch_time = 15 ms" + "constitutive = 1 us"]); + p = c.params; + testCase.verifyEqual(p.youngModulus, 3.87e9); + testCase.verifyEqual(p.density, 1500); + testCase.verifyEqual(p.fractureEnergy, 0.5); + testCase.verifyEqual(p.criticalDistance, 4.5e-3); + testCase.verifyEqual(p.poissonRatio, 0.2); + testCase.verifyEqual(p.failureAreaFactor, 0.2); + testCase.verifyEqual(p.dampingInitial, 2500); + testCase.verifyEqual(p.dampingFinal, 1000); + testCase.verifyEqual(p.dampingSwitchTime, 0.015); + testCase.verifyEqual(p.constitutiveDamping, 1e-6); + end + + function autoStepIsNinetyPercentOfTheCriticalOne(testCase) + path = fullfile(testCase.Folder, "auto.ldem"); + lines = testCase.minimal(); + writeTextFile(path, lines(~startsWith(lines, "step"))); % no step key + p = ldem.io.readCase(path).params; + testCase.verifyEqual(p.dt, 0.9 * p.criticalTimeStep, 'RelTol', 1e-12); + + lines(startsWith(lines, "step")) = "step = ""auto"""; % explicit + writeTextFile(path, lines); + testCase.verifyEqual(ldem.io.readCase(path).params.dt, p.dt); + end + + function outputCadenceInStepsOrTime(testCase) + c = testCase.read([ ... + "[output.snapshots]" + "every = 10 us" + "[output.control_nodes]" + "every = 5 steps" + "[output.energy]" + "every = 1 step"]); + testCase.verifyEqual(c.params.output.snapshotEvery, 50); + testCase.verifyEqual(c.params.output.controlNodesEvery, 5); + testCase.verifyEqual(c.params.output.energyEvery, 1); + c = testCase.read(["[output.snapshots]"; "every = 0"; "[output.energy]"; "every = 20"]); + testCase.verifyEqual(c.params.output.snapshotEvery, 0); + testCase.verifyEqual(c.params.output.energyEvery, 20); + end + + function cadenceThatIsNotAMultipleWarns(testCase) + testCase.verifyWarning(@() testCase.storeRead(["[output.snapshots]"; "every = 10.05 us"]), ... + 'ldem:case:cadenceNotMultiple'); + end + + function badCadences(testCase) + testCase.verifyCaseError(["[output.snapshots]"; "every = 0.05 us"], 'ldem:case:badValue', 'shorter than the time step'); + testCase.verifyCaseError(["[output.snapshots]"; "every = -3"], 'ldem:case:badValue', 'non-negative'); + testCase.verifyCaseError(["[output.snapshots]"; "every = 2.5 steps"], 'ldem:case:badValue', 'whole number'); + end + + function trackedBarSwitchesTheStrainHistoryOn(testCase) + c = testCase.read(["[monitor.bar]"; "tracked = 5"]); + testCase.verifyEqual(c.params.trackedBar, 5); + testCase.verifyEqual(c.params.output.trackedBarEvery, 1); + c = testCase.read(strings(0, 1)); + testCase.verifyEqual(c.params.output.trackedBarEvery, 0); + end + + function controlNodesByNumberAndByPosition(testCase) + c = testCase.read([ ... + "[[monitor.node]]" + "id = 2" + "[[monitor.node]]" + "name = ""first module""" + "at = [0.5, 0.5, 0.5]"]); + % The prism has 6*3*3 = 54 grid nodes; the first centre node is 55. + testCase.verifyEqual(c.params.controlNodes, [2 55]); + testCase.verifyEqual(c.info.controlNodeNames, ["node_2" "first module"]); + testCase.verifyEmpty(c.info.nodeNotes); + end + + function aPositionThatIsNotANodeWarnsAndNamesTheChosenOne(testCase) + extra = ["[[monitor.node]]"; "at = [0.45, 0.5, 0.5]"]; + testCase.verifyWarning(@() testCase.storeRead(extra), 'ldem:case:nodeApproximated'); + c = testCase.Last; + testCase.verifyEqual(c.params.controlNodes, 55); + testCase.verifySubstring(c.info.nodeNotes, "using node 55"); + end + + function badControlNodes(testCase) + testCase.verifyCaseError(["[[monitor.node]]"; "name = ""x"""], 'ldem:case:missingKey', 'either "id" or "at"'); + testCase.verifyCaseError(["[[monitor.node]]"; "id = 2"; "at = [1, 1, 1]"], ... + 'ldem:case:inconsistentKey', 'not both'); + testCase.verifyCaseError(["[[monitor.node]]"; "id = 0"], 'ldem:case:badValue', 'node number'); + testCase.verifyCaseError(["[[monitor.node]]"; "at = [1, 1]"], 'ldem:case:badValue', 'three numbers'); + testCase.verifyCaseError(["[[monitor.node]]"; "id = 5000"], 'ldem:params:controlNodeOutOfRange', 'bad.ldem'); + end + + function scenarioKeysBelongToTheScenarioClass(testCase) + lines = testCase.minimal(); + lines = lines(~startsWith(lines, ["[scenario]" "type"])); + path = fullfile(testCase.Folder, "beam.ldem"); + writeTextFile(path, [lines; "[scenario]"; "type = ""clamped_beam"""; ... + "force_rate = 2 kN/s"; "ramp_time = 1 ms"; "load_position = 2.5 modules"; ... + "load_height = 1.5"]); + c = ldem.io.readCase(path); + testCase.verifyClass(c.scenario, 'ldem.scenarios.ClampedBeam'); + testCase.verifyEqual(c.params.testId, 103); + testCase.verifyEqual(c.scenario.forceRate, 2000); + testCase.verifyEqual(c.scenario.rampTime, 1e-3); + testCase.verifyEqual(c.scenario.loadPosition, 2.5); + testCase.verifyEqual(c.scenario.loadHeight, 1.5); + + writeTextFile(path, [lines; "[scenario]"; "type = ""clamped_beam"""; "load_position = ""midspan"""]); + c = ldem.io.readCase(path); + testCase.verifyTrue(isnan(c.scenario.loadPosition)); + end + + function everyScenarioCanBeNamed(testCase) + lines = testCase.minimal(); + lines = lines(~startsWith(lines, ["[scenario]" "type"])); + path = fullfile(testCase.Folder, "any.ldem"); + for entry = ldem.scenarios.registry() + writeTextFile(path, [lines; "[scenario]"; "type = """ + entry.name + """"]); + c = ldem.io.readCase(path); + testCase.verifyClass(c.scenario, entry.className); + testCase.verifyEqual(c.params.testId, entry.testId); + end + end + + function scatterFromAFileIsRelativeToTheCase(testCase) + c = testCase.read(["[material.scatter]"; "type = ""file"""; "file = ""sub/field.txt"""]); + testCase.verifyEqual(c.params.randomFieldFile, string(fullfile(testCase.Folder, "sub/field.txt"))); + testCase.verifyEqual(c.params.randomFieldCv, 0); + end + + function scatterGeneratedInMemory(testCase) + c = testCase.read([ ... + "[material.scatter]" + "type = ""generated""" + "cv = 0.05" + "correlation_length = [2, 3, 4]" + "seed = 7"]); + p = c.params; + testCase.verifyEqual(p.randomFieldCv, 0.05); + testCase.verifyEqual(p.randomFieldCorrelationLength, [2 3 4]); + testCase.verifyEqual(p.randomFieldSeed, 7); + testCase.verifyEqual(p.randomFieldFile, ""); + c = testCase.read(["[material.scatter]"; "type = ""none"""]); + testCase.verifyEqual(c.params.randomFieldCv, 0); + end + + function scatterKeysMustFitTheType(testCase) + testCase.verifyCaseError(["[material.scatter]"; "cv = 0.1"], 'ldem:case:missingKey', 'type'); + testCase.verifyCaseError(["[material.scatter]"; "type = ""none"""; "seed = 1"], ... + 'ldem:case:inconsistentKey', 'type = "none"'); + testCase.verifyCaseError(["[material.scatter]"; "type = ""file"""; "cv = 0.1"], ... + 'ldem:case:inconsistentKey', 'type = "file"'); + testCase.verifyCaseError(["[material.scatter]"; "type = ""file"""], 'ldem:case:missingKey', '"file"'); + testCase.verifyCaseError(["[material.scatter]"; "type = ""generated"""; "file = ""f"""], ... + 'ldem:case:inconsistentKey', 'generated'); + testCase.verifyCaseError(["[material.scatter]"; "type = ""generated"""], 'ldem:case:missingKey', '"cv"'); + testCase.verifyCaseError(["[material.scatter]"; "type = ""lognormal"""], 'ldem:case:badValue', 'Allowed'); + end + + function outputFolderAndFormats(testCase) + c = testCase.read([ ... + "[output]" + "folder = ""results""" + "mat = true" + "ansys = false" + "vtk = true" + "[output.snapshots]" + "every = 100 steps"]); + testCase.verifyEqual(c.options.OutputFolder, string(fullfile(testCase.Folder, "results"))); + testCase.verifyEqual(c.options.Formats, ["mat" "vtk"]); + c = testCase.read(["[output]"; "mat = false"]); + testCase.verifyEmpty(c.options.Formats); + end + + function requestingFilesWithoutSnapshotsWarns(testCase) + testCase.verifyWarning(@() testCase.storeRead(["[output]"; "folder = ""o"""; "vtk = true"]), ... + 'ldem:case:noSnapshots'); + end + + function titleAndAuthorsAreKept(testCase) + lines = testCase.minimal(); + path = fullfile(testCase.Folder, "meta.ldem"); + writeTextFile(path, [lines(1); "title = ""My beam"""; "authors = [""A"", ""B""]"; lines(2:end)]); + c = ldem.io.readCase(path); + testCase.verifyEqual(c.info.title, "My beam"); + testCase.verifyEqual(c.info.authors, ["A" "B"]); + testCase.verifyEqual(c.info.format, 1); + end + + function jsonGivesTheSameAsTheTextFormat(testCase) + json = ['{"format":1,"mesh":{"module_size":"3 mm","modules":[5,2,2]},' ... + '"time":{"step":"0.2 us","duration":"40 us"},' ... + '"material":{"young_modulus":"30 GPa"},' ... + '"monitor":{"node":[{"id":2},{"id":7}]},' ... + '"scenario":{"type":"uniaxial_tension"}}']; + jsonPath = fullfile(testCase.Folder, "case.json"); + writeTextFile(jsonPath, string(json)); + fromJson = ldem.io.readCase(jsonPath); + fromText = testCase.read(["[material]"; "young_modulus = 30 GPa"; ... + "[[monitor.node]]"; "id = 2"; "[[monitor.node]]"; "id = 7"]); + testCase.verifyEqual(fromJson.params.toStruct(), fromText.params.toStruct()); + testCase.verifyEqual(ldem.Parameters.fromFile(jsonPath).toStruct(), fromText.params.toStruct()); + end + + function fromFileReadsCaseFilesAndAppliesOverrides(testCase) + path = fullfile(testCase.Folder, "o.ldem"); + writeTextFile(path, testCase.minimal()); + p = ldem.Parameters.fromFile(path, trackedBar = 11, seed = 9); + testCase.verifyEqual(p.trackedBar, 11); + testCase.verifyEqual(p.seed, 9); + testCase.verifyEqual(p.nModules, [6 3 3]); + end + + function unknownKeysAreSuggested(testCase) + testCase.verifyCaseError(["[material]"; "young_modulos = 3 GPa"], ... + 'ldem:case:unknownKey', "Did you mean 'young_modulus'?"); + testCase.verifyCaseError(["[matrial]"; "x = 1"], 'ldem:case:unknownKey', "Did you mean 'material'?"); + testCase.verifyCaseError("speed = 3", 'ldem:case:unknownKey', 'no key "speed"'); + testCase.verifyCaseError("flavour = 3", 'ldem:case:unknownKey', 'flavour'); + end + + function errorsNameTheLineSectionAndKey(testCase) + try + testCase.read(["[material]"; "young_modulus = 3 mm"]); + testCase.verifyFail('An error was expected.'); + catch err + testCase.verifyEqual(err.identifier, 'ldem:case:badUnit'); + testCase.verifySubstring(err.message, 'case.ldem:11 [material] young_modulus'); + end + end + + function valuesRejectedByParametersNameTheirLine(testCase) + testCase.verifyCaseError(["[material]"; "young_modulus = -3 GPa"], 'ldem:case:invalidValue', ... + 'bad.ldem:11 [material] young_modulus'); + testCase.verifyCaseError(["[mesh2]"; "x = 1"], 'ldem:case:unknownKey', 'mesh2'); + end + + function crossChecksOfParametersKeepTheirIdentifier(testCase) + testCase.verifyCaseError(["[material]"; "poisson_ratio = 0.5"], 'ldem:params:badPoissonRatio', 'bad.ldem'); + end + + function typeErrors(testCase) + testCase.verifyCaseError(["[material]"; "poisson_ratio = ""high"""], 'ldem:case:badValue', 'Expected a number'); + testCase.verifyCaseError("[mesh]", 'ldem:case:syntax', 'appears twice'); + testCase.verifyCaseError(["[output]"; "mat = 1"], 'ldem:case:badValue', 'true or false'); + testCase.verifyCaseError(["[material]"; "law = ""exponential"""], 'ldem:case:badValue', 'bilinear'); + testCase.verifyCaseError(["[damping]"; "type = ""rayleigh"""], 'ldem:case:badValue', 'mass_proportional'); + end + + function requiredKeysAreChecked(testCase) + path = fullfile(testCase.Folder, "r.ldem"); + for drop = ["type" "modules" "duration"] + lines = testCase.minimal(); + lines = lines(~startsWith(lines, drop)); + writeTextFile(path, lines); + try + ldem.io.readCase(path); + testCase.verifyFail("Missing " + drop + " must fail."); + catch err + testCase.verifyEqual(err.identifier, 'ldem:case:missingKey'); + testCase.verifySubstring(err.message, drop); + end + end + end + + function badModulesAndFormat(testCase) + path = fullfile(testCase.Folder, "m.ldem"); + lines = testCase.minimal(); + lines(startsWith(lines, "modules")) = "modules = [5, 2]"; + writeTextFile(path, lines); + testCase.verifyError(@() ldem.io.readCase(path), 'ldem:case:badValue'); + lines(startsWith(lines, "modules")) = "modules = [5, 0, 2]"; + writeTextFile(path, lines); + testCase.verifyError(@() ldem.io.readCase(path), 'ldem:case:badValue'); + lines = testCase.minimal(); + lines(1) = "format = 2"; + writeTextFile(path, lines); + testCase.verifyError(@() ldem.io.readCase(path), 'ldem:case:unsupportedFormat'); + end + + function missingFileAndWrongExtension(testCase) + testCase.verifyError(@() ldem.io.readCase(fullfile(testCase.Folder, "none.ldem")), 'ldem:io:fileNotFound'); + path = fullfile(testCase.Folder, "case.txt"); + writeTextFile(path, testCase.minimal()); + testCase.verifyError(@() ldem.io.readCase(path), 'ldem:io:unknownExtension'); + end + + function unstableTimeStepNamesTheFile(testCase) + lines = testCase.minimal(); + lines(startsWith(lines, "step")) = "step = 4 ms"; + lines(startsWith(lines, "duration")) = "duration = 40 ms"; + path = fullfile(testCase.Folder, "u.ldem"); + writeTextFile(path, lines); + try + ldem.io.readCase(path); + testCase.verifyFail('An error was expected.'); + catch err + testCase.verifyEqual(err.identifier, 'ldem:params:unstableTimeStep'); + testCase.verifySubstring(err.message, 'u.ldem'); + end + end + + function theRegistryAgreesWithTheScenarioClasses(testCase) + reg = ldem.scenarios.registry(); + testCase.verifyEqual(numel(unique([reg.name])), numel(reg)); + testCase.verifyEqual(numel(unique([reg.testId])), numel(reg)); + for entry = reg + scenario = feval(entry.className); + testCase.verifyEqual(scenario.testId, entry.testId); + testCase.verifyClass(ldem.scenarios.fromName(entry.name), entry.className); + testCase.verifyClass(ldem.scenarios.fromTestId(entry.testId), entry.className); + for prop = string(fieldnames(entry.units)).' + testCase.verifyTrue(isprop(scenario, prop), entry.className + "." + prop); + end + end + testCase.verifyError(@() ldem.scenarios.fromName("rocket"), 'ldem:scenarios:unknownName'); + end + + function everyKeyOfTheSchemaIsConsistent(testCase) + schema = ldem.schema.caseSchema(); + testCase.verifyEqual(numel(unique(string({schema.path}))), numel(schema)); + kinds = ["integer" "number" "quantity" "string" "stringlist" "path" "intlist" ... + "numberlist" "bool" "enum" "stepOrAuto" "cadence"]; + props = string(properties('ldem.Parameters')); + for row = schema.' + testCase.verifyTrue(any(row.kind == kinds), row.path); + [~, ~] = ldem.schema.unitTable(row.dimension); % the dimension exists + if row.prop ~= "" && row.kind ~= "cadence" % cadences are fields of Parameters.output + testCase.verifyTrue(any(props == row.prop), row.path + " -> " + row.prop); + end + end + end + end +end diff --git a/tests/unit/TestRunCase.m b/tests/unit/TestRunCase.m new file mode 100644 index 0000000..4acd53b --- /dev/null +++ b/tests/unit/TestRunCase.m @@ -0,0 +1,101 @@ +classdef TestRunCase < LdemTestCase + %TESTRUNCASE Unit tests of ldem.run and ldem.check. + + properties (Access = private) + Folder (1,1) string + CasePath (1,1) string + end + + methods (TestMethodSetup) + function makeCase(testCase) + testCase.Folder = string(testCase.applyFixture( ... + matlab.unittest.fixtures.TemporaryFolderFixture).Folder); + testCase.CasePath = fullfile(testCase.Folder, "small.ldem"); + writeTextFile(testCase.CasePath, [ ... + "format = 1" + "[mesh]" + "module_size = 3 mm" + "modules = [5, 2, 2]" + "[time]" + "step = 0.2 us" + "duration = 20 us" + "[scenario]" + "type = ""uniaxial_tension""" + "[output]" + "folder = ""out""" + "mat = true" + "ansys = false" + "vtk = true" + "[output.snapshots]" + "every = 50 steps" + "[output.control_nodes]" + "every = 10 steps" + "[output.energy]" + "every = 10 steps"]); + end + end + + methods (Test, TestTags = {'Unit'}) + function runMatchesRunSimulation(testCase) + viaCase = ldem.run(testCase.CasePath, OutputFolder = "", Verbose = false); + + c = ldem.io.readCase(testCase.CasePath); + direct = ldem.runSimulation(c.params, Scenario = c.scenario); + + testCase.verifyEqual(viaCase.final.displacement, direct.final.displacement); + testCase.verifyEqual(viaCase.energy, direct.energy); + testCase.verifyEqual(viaCase.controlNodes.displacement, direct.controlNodes.displacement); + testCase.verifyEqual(viaCase.params.dt, 2e-7); + testCase.verifyEqual(viaCase.final.step, 100); + end + + function runWritesTheFilesOfTheOutputSection(testCase) + ldem.run(testCase.CasePath, Verbose = false); + out = fullfile(testCase.Folder, "out"); + testCase.verifyTrue(isfile(fullfile(out, "results.mat"))); + testCase.verifyTrue(isfile(fullfile(out, "snapshots.pvd"))); + testCase.verifyTrue(isfile(fullfile(out, "snapshot_0000.vtu"))); + testCase.verifyFalse(isfile(fullfile(out, "snapshot_0000.mac"))); + end + + function runOptionsOverrideTheCase(testCase) + other = fullfile(testCase.Folder, "other"); + ldem.run(testCase.CasePath, OutputFolder = other, Formats = "mat", Verbose = false); + testCase.verifyTrue(isfile(fullfile(other, "results.mat"))); + testCase.verifyFalse(isfolder(fullfile(testCase.Folder, "out"))); + end + + function checkReportsTheModelWithoutSimulating(testCase) + report = ldem.check(testCase.CasePath); + testCase.verifyEqual(report.model.nNodes, 6 * 3 * 3 + 5 * 2 * 2); + testCase.verifyEqual(report.nSteps, 100); + testCase.verifyEqual(report.nSnapshots, 3); + testCase.verifyGreaterThan(report.snapshotMemoryMB, 0); + testCase.verifyEqual(report.randomField, "none"); + testCase.verifyEqual(report.timeStepRatio, 2e-7 / report.params.criticalTimeStep); + testCase.verifyEqual([report.controlNodes.number], [1 2]); + testCase.verifyEqual(report.controlNodes(1).position, [0 0 0]); + end + + function checkPrintsWhenThereIsNoOutput(testCase) + text = evalc('ldem.check(testCase.CasePath)'); + testCase.verifySubstring(text, 'UniaxialTension'); + end + + function checkSaysWhetherTheRandomFieldFileIsUsable(testCase) + path = fullfile(testCase.Folder, "scatter.ldem"); + lines = splitlines(string(fileread(testCase.CasePath))); + writeTextFile(path, [lines(1:end-1); "[material.scatter]"; "type = ""file"""; "file = ""missing.txt"""]); + report = ldem.check(path); + testCase.verifySubstring(report.randomField, "PROBLEM"); + + writeTextFile(fullfile(testCase.Folder, "field.txt"), string(ones(1000, 1))); + writeTextFile(path, [lines(1:end-1); "[material.scatter]"; "type = ""file"""; "file = ""field.txt"""]); + report = ldem.check(path); + testCase.verifySubstring(report.randomField, "file OK"); + + writeTextFile(path, [lines(1:end-1); "[material.scatter]"; "type = ""generated"""; "cv = 0.1"]); + testCase.verifySubstring(ldem.check(path).randomField, "generated"); + end + end +end diff --git a/tests/unit/TestWriteCase.m b/tests/unit/TestWriteCase.m new file mode 100644 index 0000000..3e704e9 --- /dev/null +++ b/tests/unit/TestWriteCase.m @@ -0,0 +1,229 @@ +classdef TestWriteCase < LdemTestCase + %TESTWRITECASE Unit tests of ldem.io.writeCase, writeTemplate and convertLegacyInput. + + properties (Access = private) + Folder (1,1) string + end + + methods (TestMethodSetup) + function makeFolder(testCase) + testCase.Folder = string(testCase.applyFixture( ... + matlab.unittest.fixtures.TemporaryFolderFixture).Folder); + end + end + + methods (Test, TestTags = {'Unit'}) + function roundTripKeepsParametersAndScenario(testCase) + output = struct('snapshotEvery', 400, 'controlNodesEvery', 3, ... + 'energyEvery', 7, 'trackedBarEvery', 1); + p = ldem.Parameters(testId = 103, seed = 77, moduleLength = 0.002, ... + nModules = [6 6 21], dt = 3.5e-7, totalTime = 1.4e-4, ... + dampingInitial = 2500, dampingFinal = 1800, dampingSwitchTime = 5e-5, ... + constitutiveDamping = 1e-6, controlNodes = [3 40 100], ... + youngModulus = 3.87e9, density = 1500, poissonRatio = 0.2, ... + fractureEnergy = 0.5, criticalDistance = 4.5e-3, failureAreaFactor = 0.14, ... + trackedBar = 33, meshPerturbation = 0.02, ... + randomFieldCv = 0.05, randomFieldCorrelationLength = [2 3 4], randomFieldSeed = 9, ... + output = output); + scenario = ldem.scenarios.ClampedBeam(forceRate = 1234.5, rampTime = 2e-4, ... + loadPosition = 7.5, loadHeight = 1.5); + path = fullfile(testCase.Folder, "round.ldem"); + + ldem.io.writeCase(path, p, scenario); + c = ldem.io.readCase(path); + + testCase.verifyEqual(c.params.toStruct(), p.toStruct()); + testCase.verifyEqual(c.scenario.forceRate, 1234.5); + testCase.verifyEqual(c.scenario.rampTime, 2e-4); + testCase.verifyEqual(c.scenario.loadPosition, 7.5); + testCase.verifyEqual(c.scenario.loadHeight, 1.5); + end + + function defaultsAndMidspanRoundTrip(testCase) + p = ldem.Parameters(testId = 103); + path = fullfile(testCase.Folder, "defaults.ldem"); + text = ldem.io.writeCase(path, p); + testCase.verifySubstring(text, 'load_position = "midspan"'); + c = ldem.io.readCase(path); + testCase.verifyEqual(c.params.toStruct(), p.toStruct()); + testCase.verifyTrue(isnan(c.scenario.loadPosition)); + end + + function randomFieldFileIsWrittenRelativeToTheCase(testCase) + file = fullfile(testCase.Folder, "data", "field.txt"); + p = ldem.Parameters(randomFieldFile = file); + path = fullfile(testCase.Folder, "case.ldem"); + text = ldem.io.writeCase(path, p); + testCase.verifySubstring(text, 'file = "data/field.txt"'); + testCase.verifyEqual(string(ldem.io.readCase(path).params.randomFieldFile), ... + string(fullfile(testCase.Folder, "data/field.txt"))); + end + + function randomFieldFileOfAnotherFolderUsesDotDot(testCase) + file = fullfile(testCase.Folder, "shared", "field.txt"); + p = ldem.Parameters(randomFieldFile = file); + path = fullfile(testCase.Folder, "a", "b", "case.ldem"); + text = ldem.io.writeCase(path, p); + testCase.verifySubstring(text, 'file = "../../shared/field.txt"'); + testCase.verifyEqual(strrep(string(ldem.io.readCase(path).params.randomFieldFile), '\', '/'), ... + strrep(string(fullfile(testCase.Folder, "a", "b", "../../shared/field.txt")), '\', '/')); + end + + function exampleCaseFilesMatchTheirDataFiles(testCase) + examples = fullfile(testCase.RepoRoot, "examples"); + field = fullfile(examples, "beam_102", "arquivo_3lc_rnao_cv05"); + legacy = ldem.Parameters.fromFile(fullfile(examples, "beam_102", "DATA0.DAT"), ... + randomFieldFile = field); + c = ldem.io.readCase(fullfile(examples, "beam_102", "case.ldem")); + testCase.verifyEqual(testCase.normalizePaths(c.params.toStruct()), ... + testCase.normalizePaths(legacy.toStruct())); + testCase.verifyClass(c.scenario, 'ldem.scenarios.FourPointBending'); + + legacy = ldem.Parameters.fromFile(fullfile(examples, "example1_clamped_beam", "DATA0.DAT"), ... + randomFieldFile = field, trackedBar = 14398); + c = ldem.io.readCase(fullfile(examples, "example1_clamped_beam", "case.ldem")); + testCase.verifyEqual(testCase.normalizePaths(c.params.toStruct()), ... + testCase.normalizePaths(legacy.toStruct())); + testCase.verifyClass(c.scenario, 'ldem.scenarios.ClampedBeam'); + testCase.verifyEqual(c.scenario.forceRate, 1000); + testCase.verifyEqual(c.scenario.rampTime, 0.00035); + end + + function trackedBarIsACommentWhenOff(testCase) + p = ldem.Parameters(trackedBar = 55); + text = ldem.io.writeCase("", p); + testCase.verifySubstring(text, '# tracked = 55'); + output = p.output; + output.trackedBarEvery = 1; + p.output = output; + text = ldem.io.writeCase("", p); + testCase.verifyTrue(contains(text, newline + "tracked = 55") || contains(text, "tracked = 55")); + end + + function filesAreOnlyEnabledWhenThereAreSnapshots(testCase) + p = ldem.Parameters(); % snapshotEvery = 0 + c = testCase.readBack(ldem.io.writeCase("", p), "none.ldem"); + testCase.verifyEqual(c.options.Formats, "mat"); + output = p.output; + output.snapshotEvery = 10; + p.output = output; + c = testCase.readBack(ldem.io.writeCase("", p), "some.ldem"); + testCase.verifyEqual(c.options.Formats, ["mat" "ansys" "vtk"]); + c = testCase.readBack(ldem.io.writeCase("", p, [], Formats = "vtk", OutputFolder = "out"), "vtk.ldem"); + testCase.verifyEqual(c.options.Formats, "vtk"); + testCase.verifyEqual(c.options.OutputFolder, string(fullfile(testCase.Folder, "out"))); + end + + function commentsCanBeOmitted(testCase) + p = ldem.Parameters(); + withComments = ldem.io.writeCase("", p); + without = ldem.io.writeCase("", p, [], Comments = false); + testCase.verifySubstring(withComments, "Legacy: YNG"); + testCase.verifyFalse(contains(without, "#")); + c = testCase.readBack(without, "plain.ldem"); + testCase.verifyEqual(c.params.toStruct(), p.toStruct()); + end + + function titleAuthorsHeaderAndNodeNames(testCase) + p = ldem.Parameters(controlNodes = [1 2]); + text = ldem.io.writeCase("", p, [], Title = "My test", Authors = ["Ana" "Luis"], ... + Header = "Line one", ControlNodeNames = ["left" "right"]); + c = testCase.readBack(text, "meta.ldem"); + testCase.verifyEqual(c.info.title, "My test"); + testCase.verifyEqual(c.info.authors, ["Ana" "Luis"]); + testCase.verifyEqual(c.info.controlNodeNames, ["left" "right"]); + testCase.verifySubstring(text, "# Line one"); + end + + function writesTheFileInAnewFolder(testCase) + path = fullfile(testCase.Folder, "new", "deeper", "case.ldem"); + ldem.io.writeCase(path, ldem.Parameters()); + testCase.verifyTrue(isfile(path)); + end + + function everyTemplateReadsBack(testCase) + for entry = ldem.scenarios.registry() + path = fullfile(testCase.Folder, entry.name + ".ldem"); + ldem.io.writeTemplate(path, entry.name); + c = ldem.io.readCase(path); + testCase.verifyClass(c.scenario, entry.className); + testCase.verifyEqual(c.params.testId, entry.testId); + end + testCase.verifyError(@() ldem.io.writeTemplate("", "rocket"), 'ldem:scenarios:unknownName'); + end + + function everyKeyOfTheSchemaAppearsInATemplate(testCase) + text = ldem.io.writeTemplate("", "uniaxial_tension"); + schema = ldem.schema.caseSchema(); + onlyWithAnOption = ["material.scatter.file" "material.scatter.cv" ... + "material.scatter.correlation_length" "material.scatter.seed" ... + "monitor.bar.tracked" "format" "title" "authors" "scenario.type"]; + for row = schema.' + if startsWith(row.path, "monitor.node") || any(row.path == onlyWithAnOption) + continue + end + key = string(regexprep(row.path, '^.*\.', '')); + testCase.verifyTrue(contains(text, key + " "), row.path); + end + end + + function legacyExamplesConvertToTheSameParameters(testCase) + for name = ["beam_102" "example1_clamped_beam"] + dataFile = fullfile(testCase.RepoRoot, "examples", name, "DATA0.DAT"); + path = fullfile(testCase.Folder, name + ".ldem"); + ldem.io.convertLegacyInput(dataFile, path); + fromCase = ldem.io.readCase(path); + legacy = ldem.Parameters.fromFile(dataFile); + testCase.verifyEqual(fromCase.params.toStruct(), legacy.toStruct(), name); + testCase.verifyClass(fromCase.scenario, class(ldem.scenarios.fromTestId(legacy.testId))); + testCase.verifyEqual(ldem.Parameters.fromFile(path).toStruct(), legacy.toStruct(), name); + end + end + + function theConverterNeverGuessesTheTrackedBar(testCase) + dataFile = fullfile(testCase.RepoRoot, "examples", "example1_clamped_beam", "DATA0.DAT"); + text = ldem.io.convertLegacyInput(dataFile, ""); + testCase.verifySubstring(text, "The legacy value OU2 was 14398"); + c = testCase.readBack(text, "ou2.ldem"); + testCase.verifyEqual(c.params.trackedBar, ldem.Parameters().trackedBar); + end + + function converterOptionsAreApplied(testCase) + dataFile = fullfile(testCase.RepoRoot, "examples", "example1_clamped_beam", "DATA0.DAT"); + field = fullfile(testCase.Folder, "field.txt"); + path = fullfile(testCase.Folder, "conv.ldem"); + ldem.io.convertLegacyInput(dataFile, path, RandomFieldFile = field, TrackedBar = 14398, ... + Title = "Beam", Authors = "Rodrigo", OutputFolder = "out"); + c = ldem.io.readCase(path); + testCase.verifyEqual(c.params.trackedBar, 14398); + testCase.verifyEqual(c.params.output.trackedBarEvery, 1); + testCase.verifyEqual(string(c.params.randomFieldFile), string(fullfile(testCase.Folder, "field.txt"))); + testCase.verifyEqual(c.info.title, "Beam"); + testCase.verifyEqual(c.info.authors, "Rodrigo"); + end + + function aScenarioOutsideTheRegistryIsRefused(testCase) + testCase.verifyError(@() ldem.io.writeCase("", ldem.Parameters(), TestWriteCase.unregistered()), ... + 'ldem:io:unregisteredScenario'); + end + end + + methods (Access = private) + function s = normalizePaths(~, s) + % The random-field path may differ in separators (\ or /) and in .. + s.randomFieldFile = string(java.io.File(char(s.randomFieldFile)).getCanonicalPath()); + end + + function c = readBack(testCase, text, name) + path = fullfile(testCase.Folder, name); + writeTextFile(path, splitlines(string(text))); + c = ldem.io.readCase(path); + end + end + + methods (Static, Access = private) + function s = unregistered() + s = TestUnregisteredScenario(); + end + end +end From 0a21592295fa7b391f1c07b48074e0a427b7a7b8 Mon Sep 17 00:00:00 2001 From: Boris Rojo Tanzi <71112604+borisrojotanzi@users.noreply.github.com> Date: Fri, 6 Nov 2026 16:08:39 -0300 Subject: [PATCH 11/13] feat: record the case that was run and fix the Sphinx docstring warnings --- CHANGELOG.md | 4 +++ src/+ldem/+io/parseCaseJson.m | 6 +--- src/+ldem/+io/readCase.m | 3 +- src/+ldem/+io/writeCase.m | 7 ++-- src/+ldem/+material/buildBarProperties.m | 5 +-- src/+ldem/+material/generateRandomField.m | 37 +++++++++---------- src/+ldem/+material/summarizeMaterial.m | 4 +-- src/+ldem/+scenarios/registry.m | 8 ++--- src/+ldem/+schema/caseSchema.m | 8 ++--- src/+ldem/check.m | 3 +- src/+ldem/run.m | 43 ++++++++++++++++++++++- src/+ldem/runSimulation.m | 7 +++- tests/unit/TestRunCase.m | 35 ++++++++++++++++++ 13 files changed, 115 insertions(+), 55 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 84988f2..dbf45a2 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -15,6 +15,10 @@ field file, snapshot memory), and `ldem.Parameters.fromFile` reads `.ldem` and `.json` too. The keys live in one table, `ldem.schema.caseSchema`, with `ldem.schema.parseQuantity` / `formatQuantity` for the units. +- `ldem.run` makes every run reproducible: `results.info.case` keeps the SHA-256 + of the case file, its text and the resolved case (all defaults and overrides), + and the resolved case is saved as `case.ldem` in the output folder + (`ldem.runSimulation` has a new `CaseInfo` option for this). - `ldem.scenarios.registry` is the single list of scenarios; `ldem.scenarios.fromTestId` reads it and `ldem.scenarios.fromName` is new. - `case.ldem` next to the `DATA0.DAT` of `examples/beam_102` and diff --git a/src/+ldem/+io/parseCaseJson.m b/src/+ldem/+io/parseCaseJson.m index efdeb3b..444313e 100644 --- a/src/+ldem/+io/parseCaseJson.m +++ b/src/+ldem/+io/parseCaseJson.m @@ -6,11 +6,7 @@ % formats alike. The JSON has one object per section and the values that % carry a unit are strings: % -% { -% "format": 1, -% "mesh": { "module_size": "1 mm", "modules": [5, 5, 50] }, -% "monitor": { "node": [ {"id": 2441}, {"id": 884} ] } -% } +% {"format": 1, "mesh": {"module_size": "1 mm", "modules": [5, 5, 50]}} % % A repeated table such as [[monitor.node]] is an array of objects. JSON has % no comments; use the .ldem format for files written by hand. diff --git a/src/+ldem/+io/readCase.m b/src/+ldem/+io/readCase.m index 4764eac..5bab516 100644 --- a/src/+ldem/+io/readCase.m +++ b/src/+ldem/+io/readCase.m @@ -32,8 +32,7 @@ % params Validated ldem.Parameters. % scenario Scenario object with the values of the [scenario] section. % options Struct with OutputFolder and Formats, for runSimulation. -% info Struct: source, format, title, authors, controlNodeNames -% and nodeNotes (how each "at" position was resolved). +% info Struct: source, format, title, authors, controlNodeNames and nodeNotes. % % Errors: % ldem:io:fileNotFound The file does not exist. diff --git a/src/+ldem/+io/writeCase.m b/src/+ldem/+io/writeCase.m index 9898ee7..03fe50d 100644 --- a/src/+ldem/+io/writeCase.m +++ b/src/+ldem/+io/writeCase.m @@ -20,9 +20,7 @@ % Authors String array for the "authors" key. % Header Extra comment lines at the top (without the #). % OutputFolder Value of output.folder (default "output"). -% Formats Files to enable in [output]: "mat", "ansys", "vtk" -% (default all; ansys and vtk are switched off when -% snapshots are never taken). +% Formats Files to enable in [output]: "mat", "ansys", "vtk" (default all; ansys and vtk are off without snapshots). % ControlNodeNames One label per control node (default "node_"). % Comments false to omit the explanatory comments (default true). % @@ -30,8 +28,7 @@ % text The content of the file, a string scalar. % % Errors: -% ldem:io:unregisteredScenario The scenario class is not in -% ldem.scenarios.registry. +% ldem:io:unregisteredScenario The scenario class is not in ldem.scenarios.registry. % ldem:io:cannotOpenFile The file cannot be created. % % Example: diff --git a/src/+ldem/+material/buildBarProperties.m b/src/+ldem/+material/buildBarProperties.m index 1cdcdd5..8db1690 100644 --- a/src/+ldem/+material/buildBarProperties.m +++ b/src/+ldem/+material/buildBarProperties.m @@ -42,10 +42,7 @@ % criticalStrainMean scalar, mean of EP % criticalStrainCv scalar, coefficient of variation of EP % randomField multiplier of EP0 of each bar (all ones without field) -% randomFieldInfo struct: source ("none", "file", "generated" or -% "given"), fieldMean, fieldCv and, for a generated -% field, the fields listed in -% ldem.material.generateRandomField +% randomFieldInfo struct: source ("none", "file", "generated" or "given"), fieldMean, fieldCv and, for a generated field, those of ldem.material.generateRandomField % % Fields of history (nBars-by-1), updated by ldem.material.bilinearLaw: % diff --git a/src/+ldem/+material/generateRandomField.m b/src/+ldem/+material/generateRandomField.m index cee158d..e9279e0 100644 --- a/src/+ldem/+material/generateRandomField.m +++ b/src/+ldem/+material/generateRandomField.m @@ -10,14 +10,9 @@ % % Method (the one of Aleat_novo4.m): % -% 1. A regular grid of "poles" with spacing correlationLength covers -% the bar centres, with one extra pole on each side. -% 2. Each pole gets an independent Weibull value with mean 1 and -% coefficient of variation cv. The shape k solves -% Gamma(1+2/k) / Gamma(1+1/k)^2 = 1 + cv^2 -% and the scale is 1/Gamma(1+1/k). -% 3. The value of a bar is the trilinear interpolation of the 8 poles -% of the grid cell that contains its centre. +% 1. A regular grid of "poles" with spacing correlationLength covers the bar centres, with one extra pole on each side. +% 2. Each pole gets an independent Weibull value with mean 1 and coefficient of variation cv. The shape k solves Gamma(1+2/k)/Gamma(1+1/k)^2 = 1 + cv^2 and the scale is 1/Gamma(1+1/k). +% 3. The value of a bar is the trilinear interpolation of the 8 poles of the grid cell that contains its centre. % % The interpolation averages neighbouring poles, so the coefficient of % variation of the bars (info.fieldCv) is somewhat smaller than cv; the @@ -32,16 +27,19 @@ % % Outputs: % field nBars-by-1 vector of positive multipliers. -% info Struct describing the field: -% source "generated" -% cv cv requested -% correlationLength 1-by-3 pole spacing [m] -% seed seed used -% weibullShape shape k of the pole distribution -% weibullScale scale of the pole distribution -% nPoles 1-by-3 number of poles along x, y, z -% fieldMean mean of field -% fieldCv coefficient of variation of field +% info Struct describing the field (fields listed below). +% +% Fields of info: +% +% source "generated" +% cv cv requested +% correlationLength 1-by-3 pole spacing [m] +% seed seed used +% weibullShape shape k of the pole distribution +% weibullScale scale of the pole distribution +% nPoles 1-by-3 number of poles along x, y, z +% fieldMean mean of field +% fieldCv coefficient of variation of field % % The random numbers come from a private stream (Mersenne Twister seeded % with seed), so the global random state is not touched and the same seed @@ -55,8 +53,7 @@ % Example: % params = ldem.Parameters(nModules=[6 3 3]); % mesh = ldem.mesh.buildMesh(params); -% field = ldem.material.generateRandomField(mesh.barCentres, 0.05, ... -% 3 * params.moduleLength, 515); +% field = ldem.material.generateRandomField(mesh.barCentres, 0.05, 3 * params.moduleLength, 515); % % Legacy: Aleat_novo4.m (outside the main program; it wrote the file read % by ldem.io.readRandomField). diff --git a/src/+ldem/+material/summarizeMaterial.m b/src/+ldem/+material/summarizeMaterial.m index f30fd25..592fd9c 100644 --- a/src/+ldem/+material/summarizeMaterial.m +++ b/src/+ldem/+material/summarizeMaterial.m @@ -26,9 +26,7 @@ % criticalStrainCv coefficient of variation of EP % criticalStrainMin smallest EP % criticalStrainMax largest EP -% randomField where the random field came from and its -% statistics (barProps.randomFieldInfo); the value -% of each bar is barProps.randomField +% randomField where the random field came from and its statistics (barProps.randomFieldInfo); the value of each bar is barProps.randomField % % Input: % barProps Struct from ldem.material.buildBarProperties. diff --git a/src/+ldem/+scenarios/registry.m b/src/+ldem/+scenarios/registry.m index 8b56134..8e548e6 100644 --- a/src/+ldem/+scenarios/registry.m +++ b/src/+ldem/+scenarios/registry.m @@ -11,12 +11,8 @@ % name Name used in the case file, "type = ..." (snake_case). % className Name of the class, a subclass of ldem.scenarios.Scenario. % testId Value of the constant property testId of the class. -% units Struct that maps each property that can be set from a case -% file to its dimension (see ldem.schema.unitTable). The key in -% the file is the property name in snake_case: forceRate is -% force_rate. -% keywords Struct that maps a property to a word that stands for NaN -% in the file (ClampedBeam.loadPosition: "midspan"). +% units Struct mapping each property a case file may set to its dimension (key in the file: snake_case, forceRate is force_rate). +% keywords Struct mapping a property to a word that stands for NaN in the file (ClampedBeam.loadPosition: "midspan"). % % Output: % reg Struct array. diff --git a/src/+ldem/+schema/caseSchema.m b/src/+ldem/+schema/caseSchema.m index 0af24f5..58e560b 100644 --- a/src/+ldem/+schema/caseSchema.m +++ b/src/+ldem/+schema/caseSchema.m @@ -9,13 +9,9 @@ % Fields of every row: % % path Section and key, for example "material.young_modulus". -% kind How the value is read: "integer", "number", "quantity" (a -% number with a unit), "string", "stringlist", "path" (a file, -% relative to the case file), "intlist", "numberlist", "bool", -% "enum", "stepOrAuto" or "cadence" (steps or time). +% kind How the value is read: integer, number, quantity (number with a unit), string, stringlist, path, intlist, numberlist, bool, enum, stepOrAuto or cadence. % dimension Dimension of a "quantity", see ldem.schema.unitTable. -% prop Name of the ldem.Parameters property it sets ("" if the key -% needs special handling). +% prop Name of the ldem.Parameters property it sets ("" if the key needs special handling). % required True if the file must contain the key. % legacy Variable of the legacy DATA0.DAT file it replaces. % doc One-line description, used for the comments of the template. diff --git a/src/+ldem/check.m b/src/+ldem/check.m index d1449cf..9012037 100644 --- a/src/+ldem/check.m +++ b/src/+ldem/check.m @@ -22,8 +22,7 @@ % nSnapshots Snapshots taken (0 if never). % snapshotMemoryMB Memory of the snapshots kept in results. % randomField Text: "none", "generated" or the state of the file. -% controlNodes Struct array: number, name and position -% [x y z] in modules. +% controlNodes Struct array: number, name and position [x y z] in modules. % % Errors: % The ones of ldem.io.readCase, and ldem:scenarios:noNodesSelected when diff --git a/src/+ldem/run.m b/src/+ldem/run.m index a352c3f..087be6f 100644 --- a/src/+ldem/run.m +++ b/src/+ldem/run.m @@ -14,6 +14,17 @@ % Formats Other files to write, for example "mat". % Verbose Print the progress (default true). % +% To make the run reproducible, results.info.case keeps +% +% source Path of the case file. +% sha256 SHA-256 hash of the file that was read (text, 64 hex digits). +% original Text of that file. +% resolved Complete case with every default and the overrides, as ldem.io.writeCase writes it. +% +% and, when files are written, the resolved case is also saved as +% "case.ldem" in the output folder, so a result folder can be run again with +% ldem.run(fullfile(folder, "case.ldem")). +% % Input: % casePath Path of the case file. % @@ -41,6 +52,36 @@ if ~isempty(options.Formats) formats = string(options.Formats); end + +original = string(fileread(c.info.source)); +resolvedFormats = formats; +if isempty(resolvedFormats) + resolvedFormats = "mat"; +end +resolved = ldem.io.writeCase("", c.params, c.scenario, ... + Title = c.info.title, Authors = c.info.authors, ... + ControlNodeNames = c.info.controlNodeNames, ... + Header = "Resolved from " + c.info.source + " by ldem.run.", ... + Formats = resolvedFormats); +caseInfo = struct('source', c.info.source, 'sha256', sha256Of(original), ... + 'original', original, 'resolved', resolved); + results = ldem.runSimulation(c.params, Scenario = c.scenario, ... - OutputFolder = folder, Formats = formats, Verbose = options.Verbose); + OutputFolder = folder, Formats = formats, Verbose = options.Verbose, ... + CaseInfo = caseInfo); + +if strlength(folder) > 0 + ldem.io.writeCase(fullfile(folder, "case.ldem"), c.params, c.scenario, ... + Title = c.info.title, Authors = c.info.authors, ... + ControlNodeNames = c.info.controlNodeNames, ... + Header = "Resolved from " + c.info.source + " by ldem.run.", ... + OutputFolder = ".", Formats = resolvedFormats); +end +end + +function hash = sha256Of(text) +%SHA256OF SHA-256 of a text as 64 lower-case hexadecimal digits. +digest = java.security.MessageDigest.getInstance('SHA-256'); +bytes = typecast(digest.digest(uint8(char(text))), 'uint8'); +hash = string(lower(reshape(dec2hex(bytes, 2).', 1, []))); end diff --git a/src/+ldem/runSimulation.m b/src/+ldem/runSimulation.m index e66a456..f786a40 100644 --- a/src/+ldem/runSimulation.m +++ b/src/+ldem/runSimulation.m @@ -20,6 +20,7 @@ % Formats Files to write: "mat", "ansys" and/or "vtk" (default "mat"). % Scenario Scenario object (default: the one registered for params.testId). % Verbose Print the progress (default false). +% CaseInfo Struct stored in results.info.case (ldem.run keeps the case file that was run there). % % With an empty OutputFolder the results are only returned. The ANSYS and % VTK files are written at time zero and every params.output.snapshotEvery @@ -62,6 +63,7 @@ options.Formats (1,:) string {mustBeMember(options.Formats, ["mat", "ansys", "vtk"])} = "mat" options.Scenario = [] options.Verbose (1,1) logical = false + options.CaseInfo = [] end params.validate(); @@ -105,7 +107,10 @@ 'date', string(datetime('now', 'Format', 'yyyy-MM-dd HH:mm:ss')), ... 'matlabRelease', string(version('-release')), ... 'elapsedSeconds', toc(timer)); -results.params = params.toStruct(); +if ~isempty(options.CaseInfo) + results.info.case = options.CaseInfo; +end +results.params = params.toStruct(); results.model = ldem.mesh.summarizeModel(mesh, params); results.material = ldem.material.summarizeMaterial(barProps, params); results.mesh = mesh; diff --git a/tests/unit/TestRunCase.m b/tests/unit/TestRunCase.m index 4acd53b..7851f0a 100644 --- a/tests/unit/TestRunCase.m +++ b/tests/unit/TestRunCase.m @@ -58,6 +58,41 @@ function runWritesTheFilesOfTheOutputSection(testCase) testCase.verifyFalse(isfile(fullfile(out, "snapshot_0000.mac"))); end + function resultsKeepTheCaseThatWasRun(testCase) + results = ldem.run(testCase.CasePath, Formats = "mat", Verbose = false); + info = results.info.case; + + fid = fopen(testCase.CasePath, 'r'); + bytes = fread(fid, Inf, '*uint8'); + fclose(fid); + digest = java.security.MessageDigest.getInstance('SHA-256'); + expected = string(lower(reshape(dec2hex(typecast(digest.digest(bytes), 'uint8'), 2).', 1, []))); + testCase.verifyEqual(info.sha256, expected); + testCase.verifyEqual(info.original, string(fileread(testCase.CasePath))); + testCase.verifyEqual(strlength(info.sha256), 64); + + % The resolved case reads back into the parameters that ran. + path = fullfile(testCase.Folder, "resolved.ldem"); + writeTextFile(path, splitlines(info.resolved)); + again = ldem.io.readCase(path); + testCase.verifyEqual(again.params.toStruct(), results.params); + end + + function theResolvedCaseIsSavedNextToTheResults(testCase) + results = ldem.run(testCase.CasePath, Verbose = false); + saved = fullfile(testCase.Folder, "out", "case.ldem"); + testCase.verifyTrue(isfile(saved)); + again = ldem.io.readCase(saved); + testCase.verifyEqual(again.params.toStruct(), results.params); + data = load(fullfile(testCase.Folder, "out", "results.mat")); + testCase.verifyEqual(data.results.info.case.sha256, results.info.case.sha256); + end + + function runSimulationWithoutACaseHasNoCaseInfo(testCase) + results = ldem.runSimulation(ldem.Parameters(totalTime = 2e-6)); + testCase.verifyFalse(isfield(results.info, 'case')); + end + function runOptionsOverrideTheCase(testCase) other = fullfile(testCase.Folder, "other"); ldem.run(testCase.CasePath, OutputFolder = other, Formats = "mat", Verbose = false); From 30dfad131ca5fbb04da7e039699d88887ea6e534 Mon Sep 17 00:00:00 2001 From: Boris Rojo Tanzi <71112604+borisrojotanzi@users.noreply.github.com> Date: Sun, 8 Nov 2026 16:57:07 -0300 Subject: [PATCH 12/13] feat: pluggable laws and damping, custom tests in the case file, inheritance and sweeps --- CHANGELOG.md | 30 ++ docs/source/api/index.rst | 17 + docs/source/case-keys.inc | 519 ++++++++++++++++++++ docs/source/en/usage.rst | 123 ++++- docs/source/es/usage.rst | 128 ++++- docs/source/it/usage.rst | 126 ++++- docs/source/pt/usage.rst | 127 ++++- src/+ldem/+io/readCase.m | 461 ++++++++++++++++- src/+ldem/+io/writeCase.m | 102 +++- src/+ldem/+io/writeTemplate.m | 22 +- src/+ldem/+material/BilinearBarLaw.m | 71 +++ src/+ldem/+material/LinearElasticBarLaw.m | 44 ++ src/+ldem/+material/MaterialLaw.m | 76 +++ src/+ldem/+material/lawFromName.m | 30 ++ src/+ldem/+material/lawRegistry.m | 31 ++ src/+ldem/+mesh/buildMesh.m | 5 + src/+ldem/+scenarios/Declarative.m | 339 +++++++++++++ src/+ldem/+scenarios/Scenario.m | 11 + src/+ldem/+scenarios/coordinateText.m | 55 +++ src/+ldem/+scenarios/parseCoordinate.m | 84 ++++ src/+ldem/+scenarios/registry.m | 2 + src/+ldem/+scenarios/selectNodes.m | 84 ++++ src/+ldem/+scenarios/timeFunction.m | 50 ++ src/+ldem/+schema/caseSchema.m | 67 ++- src/+ldem/+schema/unitTable.m | 4 + src/+ldem/+schema/writeKeyReference.m | 175 +++++++ src/+ldem/+solver/DampingModel.m | 32 ++ src/+ldem/+solver/MassProportionalDamping.m | 21 + src/+ldem/+solver/NoDamping.m | 21 + src/+ldem/+solver/computeBarForces.m | 13 +- src/+ldem/+solver/computeEnergies.m | 35 +- src/+ldem/+solver/dampingFromName.m | 30 ++ src/+ldem/+solver/dampingRegistry.m | 33 ++ src/+ldem/+solver/integrateStep.m | 21 +- src/+ldem/+solver/simulate.m | 24 +- src/+ldem/Parameters.m | 22 + src/+ldem/run.m | 21 +- src/+ldem/sweep.m | 195 ++++++++ tests/tools/TestHalfStiffnessLaw.m | 32 ++ tests/unit/TestDeclarative.m | 373 ++++++++++++++ tests/unit/TestExtendsAndSweep.m | 329 +++++++++++++ tests/unit/TestKeyReference.m | 42 ++ tests/unit/TestLawsAndDamping.m | 281 +++++++++++ tests/unit/TestReadCase.m | 2 +- tests/unit/TestWriteCase.m | 7 +- 45 files changed, 4210 insertions(+), 107 deletions(-) create mode 100644 docs/source/case-keys.inc create mode 100644 src/+ldem/+material/BilinearBarLaw.m create mode 100644 src/+ldem/+material/LinearElasticBarLaw.m create mode 100644 src/+ldem/+material/MaterialLaw.m create mode 100644 src/+ldem/+material/lawFromName.m create mode 100644 src/+ldem/+material/lawRegistry.m create mode 100644 src/+ldem/+scenarios/Declarative.m create mode 100644 src/+ldem/+scenarios/coordinateText.m create mode 100644 src/+ldem/+scenarios/parseCoordinate.m create mode 100644 src/+ldem/+scenarios/selectNodes.m create mode 100644 src/+ldem/+scenarios/timeFunction.m create mode 100644 src/+ldem/+schema/writeKeyReference.m create mode 100644 src/+ldem/+solver/DampingModel.m create mode 100644 src/+ldem/+solver/MassProportionalDamping.m create mode 100644 src/+ldem/+solver/NoDamping.m create mode 100644 src/+ldem/+solver/dampingFromName.m create mode 100644 src/+ldem/+solver/dampingRegistry.m create mode 100644 src/+ldem/sweep.m create mode 100644 tests/tools/TestHalfStiffnessLaw.m create mode 100644 tests/unit/TestDeclarative.m create mode 100644 tests/unit/TestExtendsAndSweep.m create mode 100644 tests/unit/TestKeyReference.m create mode 100644 tests/unit/TestLawsAndDamping.m diff --git a/CHANGELOG.md b/CHANGELOG.md index dbf45a2..f5c2043 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -19,6 +19,36 @@ of the case file, its text and the resolved case (all defaults and overrides), and the resolved case is saved as `case.ldem` in the output folder (`ldem.runSimulation` has a new `CaseInfo` option for this). +- Pluggable constitutive law and damping model, chosen by name in the case file + (`[material] law`, `[damping] type`) and in `ldem.Parameters` + (`constitutiveLaw`, `dampingModel`). `ldem.material.MaterialLaw` is the + interface of a law (force, energies, damage energy of a bar, viscous + stiffness); `bilinear` (the legacy law, results unchanged) and the new + `linear_elastic` implement it, registered in `ldem.material.lawRegistry`. + `ldem.solver.DampingModel` is the interface of a damping model; `mass_proportional` + (legacy) and the new `none` are in `ldem.solver.dampingRegistry`. The solver + functions take the law and the model as optional last arguments. +- Case files can inherit: `extends = "base.ldem"` (or a list) starts from other files; keys + replace the inherited ones, repeated tables replace the whole list, a change of scenario, + scatter or damping type drops the keys of the old type, relative paths follow the file + that writes them, and errors name that file. Loops and missing parents are errors. +- Parameter sweeps: `[[sweep]]` blocks (`key`, `values`; `sweep_mode = "product"` or + `"zip"`) and `ldem.sweep`, which validates every run first, runs each in + `run_NNN` with its resolved `case.ldem`, and returns a table (also written as + `sweep_summary.csv`) with the varied values, status, time and damaged and broken bars. + `ldem.io.readCase` has an `Overrides` option and `ldem.run` too; `results.info.case` also + keeps `parents` (with hashes) and `overrides`. +- The key reference of the user guide (`docs/source/case-keys.inc`) is generated from + `ldem.schema.caseSchema` by `ldem.schema.writeKeyReference`; a test fails if it is out of date. +- Tests defined in the case file, without a class: `[scenario] type = "custom"` with + `[[support]]` and `[[load]]` blocks. Nodes are selected by kind (all, grid, centre), + by number and by coordinate ranges in modules with `min`, `max` and `mid`; a load is a + force or a prescribed displacement following `constant`, `linear`, `ramp` or `table`; + blocks can join the reaction of the test. `ldem.scenarios.Declarative` (test 900) is + the class behind it, with `selectNodes`, `parseCoordinate`, `coordinateText` and + `timeFunction`. The three built-in tests written as blocks give exactly the same + results. `Scenario.prepare` lets a scenario compute its node lists once; they are + stored in `mesh.scenarioData`. New unit `force` (N, kN, MN). - `ldem.scenarios.registry` is the single list of scenarios; `ldem.scenarios.fromTestId` reads it and `ldem.scenarios.fromName` is new. - `case.ldem` next to the `DATA0.DAT` of `examples/beam_102` and diff --git a/docs/source/api/index.rst b/docs/source/api/index.rst index 6cbab19..59fb6cb 100644 --- a/docs/source/api/index.rst +++ b/docs/source/api/index.rst @@ -21,6 +21,7 @@ Running a simulation / Ejecutar una simulación :members: .. mat:autofunction:: ldem.run .. mat:autofunction:: ldem.check +.. mat:autofunction:: ldem.sweep .. mat:autofunction:: ldem.version Input and output / Entrada y salida @@ -66,6 +67,11 @@ Material .. mat:autofunction:: ldem.material.buildBarProperties .. mat:autofunction:: ldem.material.generateRandomField .. mat:autofunction:: ldem.material.bilinearLaw +.. mat:autoclass:: ldem.material.MaterialLaw +.. mat:autoclass:: ldem.material.BilinearBarLaw +.. mat:autoclass:: ldem.material.LinearElasticBarLaw +.. mat:autofunction:: ldem.material.lawRegistry +.. mat:autofunction:: ldem.material.lawFromName .. mat:autofunction:: ldem.material.summarizeMaterial Scenarios / Escenarios de ensayo @@ -79,6 +85,11 @@ Scenarios / Escenarios de ensayo .. mat:autoclass:: ldem.scenarios.ClampedBeam .. mat:autofunction:: ldem.scenarios.fromTestId .. mat:autofunction:: ldem.scenarios.fromName +.. mat:autoclass:: ldem.scenarios.Declarative +.. mat:autofunction:: ldem.scenarios.selectNodes +.. mat:autofunction:: ldem.scenarios.parseCoordinate +.. mat:autofunction:: ldem.scenarios.coordinateText +.. mat:autofunction:: ldem.scenarios.timeFunction .. mat:autofunction:: ldem.scenarios.registry Case-file schema / Esquema de los archivos de caso @@ -93,6 +104,7 @@ Case-file schema / Esquema de los archivos de caso .. mat:autofunction:: ldem.schema.shortestText .. mat:autofunction:: ldem.schema.suggest .. mat:autofunction:: ldem.schema.raise +.. mat:autofunction:: ldem.schema.writeKeyReference Solver ------ @@ -101,6 +113,11 @@ Solver .. mat:autofunction:: ldem.solver.simulate .. mat:autofunction:: ldem.solver.initialState +.. mat:autoclass:: ldem.solver.DampingModel +.. mat:autoclass:: ldem.solver.MassProportionalDamping +.. mat:autoclass:: ldem.solver.NoDamping +.. mat:autofunction:: ldem.solver.dampingRegistry +.. mat:autofunction:: ldem.solver.dampingFromName .. mat:autofunction:: ldem.solver.computeBarForces .. mat:autofunction:: ldem.solver.integrateStep .. mat:autofunction:: ldem.solver.dampingCoefficient diff --git a/docs/source/case-keys.inc b/docs/source/case-keys.inc new file mode 100644 index 0000000..31b462a --- /dev/null +++ b/docs/source/case-keys.inc @@ -0,0 +1,519 @@ +.. This file is generated by ldem.schema.writeKeyReference from ldem.schema.caseSchema. +.. Do not edit it by hand: change the schema and generate it again. + +.. rubric:: ``(top level)`` + +.. list-table:: + :header-rows: 1 + :widths: 18 24 12 8 38 + + * - Key + - Value + - Default + - Legacy + - Description + * - ``format`` + - integer + - 1 + - (none) + - Version of the case-file format (currently 1). + * - ``title`` + - text + - (none) + - (none) + - Free text title of the case. + * - ``authors`` + - list of texts + - (none) + - (none) + - Names of the authors. + * - ``extends`` + - list of texts + - (none) + - (none) + - Case file(s) to inherit from; the keys of this file replace the inherited ones. + * - ``sweep_mode`` + - product, zip + - "product" + - (none) + - How several [[sweep]] blocks combine: all combinations (product) or one by one (zip). + +.. rubric:: ``[mesh]`` + +.. list-table:: + :header-rows: 1 + :widths: 18 24 12 8 38 + + * - Key + - Value + - Default + - Legacy + - Description + * - ``module_size`` + - number + unit (m, cm, mm, um, km) + - 3 mm + - LCO + - Edge length of each cubic module. + * - ``modules`` + - list of integers + - required + - M N L + - Cubic modules along x, y and z (M N L of the legacy file count nodes: one more). + * - ``perturbation`` + - number + - 0 + - (none) + - Random node displacement as a fraction of the module size; 0 = regular lattice. + * - ``seed`` + - integer + - 123 + - SEED + - Seed of the mesh perturbation (the random field has its own seed). + +.. rubric:: ``[material]`` + +.. list-table:: + :header-rows: 1 + :widths: 18 24 12 8 38 + + * - Key + - Value + - Default + - Legacy + - Description + * - ``law`` + - bilinear, linear\_elastic + - "bilinear" + - (none) + - Constitutive law of the bars (see ldem.material.lawRegistry). + * - ``young_modulus`` + - number + unit (Pa, kPa, MPa, GPa) + - 32 GPa + - YNG + - Young's modulus. + * - ``poisson_ratio`` + - number + - 0.25 + - PSN + - Poisson's ratio, from 0 up to less than 0.5. + * - ``density`` + - number + unit (kg/m3, g/cm3) + - 2000 kg/m3 + - ROH + - Mass density. + * - ``fracture_energy`` + - number + unit (N/m, kN/m) + - 50 N/m + - GFR + - Specific fracture energy. + * - ``critical_distance`` + - number + unit (m, cm, mm, um, km) + - 28 mm + - DEQ + - Equivalent (critical) distance. + * - ``failure_area_factor`` + - number + - 0.1385 + - CAF + - Fraction of the module face that fails per bar. + +.. rubric:: ``[material.scatter]`` + +.. list-table:: + :header-rows: 1 + :widths: 18 24 12 8 38 + + * - Key + - Value + - Default + - Legacy + - Description + * - ``type`` + - none, file, generated + - "none" + - (none) + - Scatter of the critical strain: none, file (one multiplier per bar) or generated. + * - ``file`` + - file path + - (none) + - (none) + - Text file with one multiplier per bar, relative to this file. + * - ``cv`` + - number + - 0 + - (none) + - Coefficient of variation of the generated field (1e-4 to 3). + * - ``correlation_length`` + - list of numbers + - [3] + - (none) + - Correlation length of the generated field in modules: one value or [x, y, z]. + * - ``seed`` + - integer + - 515 + - (none) + - Seed of the generated field. + +.. rubric:: ``[time]`` + +.. list-table:: + :header-rows: 1 + :widths: 18 24 12 8 38 + + * - Key + - Value + - Default + - Legacy + - Description + * - ``step`` + - time, or auto + - "auto" + - DT + - Integration time step, or auto (0.9 times the critical step). + * - ``duration`` + - number + unit (s, ms, us, ns) + - required + - TTOT + - Total simulated time. + +.. rubric:: ``[damping]`` + +.. list-table:: + :header-rows: 1 + :widths: 18 24 12 8 38 + + * - Key + - Value + - Default + - Legacy + - Description + * - ``type`` + - mass\_proportional, none + - "mass\_proportional" + - (none) + - Damping model of the nodes (see ldem.solver.dampingRegistry). + * - ``initial`` + - number + unit (1/s, 1/ms) + - 25000 1/s + - DF1 + - Mass-proportional damping before switch\_time. + * - ``final`` + - number + unit (1/s, 1/ms) + - 25000 1/s + - DF2 + - Mass-proportional damping after switch\_time. + * - ``switch_time`` + - number + unit (s, ms, us, ns) + - 15 ms + - TDAF + - Time at which the damping changes from initial to final. + * - ``constitutive`` + - number + unit (s, ms, us, ns) + - 0 s + - CON + - Stiffness-proportional damping inside the bar law. + +.. rubric:: ``[scenario]`` + +.. list-table:: + :header-rows: 1 + :widths: 18 24 12 8 38 + + * - Key + - Value + - Default + - Legacy + - Description + * - ``type`` + - + - required + - TEST + - Test case (see ldem.scenarios.registry); its other keys follow. + +.. rubric:: ``[[support]]`` + +.. list-table:: + :header-rows: 1 + :widths: 18 24 12 8 38 + + * - Key + - Value + - Default + - Legacy + - Description + * - ``name`` + - text + - (none) + - (none) + - Label of the support. + * - ``nodes`` + - all, centre, grid + - "all" + - (none) + - Kind of nodes: all, grid (module corners) or centre (module centres). + * - ``ids`` + - list of integers + - (none) + - (none) + - Node numbers to select. + * - ``x`` + - modules: number, text or [lo, hi] + - (none) + - (none) + - Positions along x in modules: 0.5, "max - 0.5" or a range [lo, hi]. + * - ``y`` + - modules: number, text or [lo, hi] + - (none) + - (none) + - Positions along y in modules (see x). + * - ``z`` + - modules: number, text or [lo, hi] + - (none) + - (none) + - Positions along z in modules (see x). + * - ``fix`` + - list of texts + - (none) + - (none) + - Directions held at their initial position: ["x", "y", "z"]. + * - ``reaction`` + - true or false + - false + - (none) + - Include the force on the held directions in the reaction of the test. + +.. rubric:: ``[[load]]`` + +.. list-table:: + :header-rows: 1 + :widths: 18 24 12 8 38 + + * - Key + - Value + - Default + - Legacy + - Description + * - ``name`` + - text + - (none) + - (none) + - Label of the load. + * - ``nodes`` + - all, centre, grid + - "all" + - (none) + - Kind of nodes: all, grid (module corners) or centre (module centres). + * - ``ids`` + - list of integers + - (none) + - (none) + - Node numbers to select. + * - ``x`` + - modules: number, text or [lo, hi] + - (none) + - (none) + - Positions along x in modules: 0.5, "max - 0.5" or a range [lo, hi]. + * - ``y`` + - modules: number, text or [lo, hi] + - (none) + - (none) + - Positions along y in modules (see x). + * - ``z`` + - modules: number, text or [lo, hi] + - (none) + - (none) + - Positions along z in modules (see x). + * - ``direction`` + - x, y, z + - (none) + - (none) + - Direction of the load. + * - ``type`` + - force, displacement + - (none) + - (none) + - force (N on each selected node) or displacement (m from the initial position). + * - ``time_function`` + - constant, linear, ramp, table + - (none) + - (none) + - How the value changes with time. + * - ``value`` + - N, N/s, m or m/s, by type + - (none) + - (none) + - constant: the value (N or m). + * - ``rate`` + - N, N/s, m or m/s, by type + - (none) + - (none) + - linear and ramp: change per second (N/s or m/s). + * - ``until`` + - number + unit (s, ms, us, ns) + - (none) + - (none) + - ramp: time at which it stops growing. + * - ``times`` + - list of numbers + - (none) + - (none) + - table: increasing times in seconds. + * - ``values`` + - list of numbers + - (none) + - (none) + - table: one value per time (N or m). + * - ``reaction`` + - true or false + - false + - (none) + - Include the force on the loaded direction in the reaction of the test. + +.. rubric:: ``[[sweep]]`` + +.. list-table:: + :header-rows: 1 + :widths: 18 24 12 8 38 + + * - Key + - Value + - Default + - Legacy + - Description + * - ``key`` + - text + - (none) + - (none) + - Key to vary, for example "material.fracture\_energy" (see ldem.sweep). + * - ``values`` + - list of numbers + - (none) + - (none) + - Values to try: numbers, or texts with units such as ["0.1 N/m", "0.5 N/m"]. + +.. rubric:: ``[[monitor.node]]`` + +.. list-table:: + :header-rows: 1 + :widths: 18 24 12 8 38 + + * - Key + - Value + - Default + - Legacy + - Description + * - ``id`` + - integer + - (none) + - NCON + - Number of a node whose motion is recorded. + * - ``at`` + - list of numbers + - (none) + - (none) + - Position [x, y, z] in modules; the nearest node is recorded. + * - ``name`` + - text + - (none) + - (none) + - Label of the node. + +.. rubric:: ``[monitor.bar]`` + +.. list-table:: + :header-rows: 1 + :widths: 18 24 12 8 38 + + * - Key + - Value + - Default + - Legacy + - Description + * - ``tracked`` + - integer + - off + - OU9 + - Number of the bar whose strain history is stored at every step. + +.. rubric:: ``[output]`` + +.. list-table:: + :header-rows: 1 + :widths: 18 24 12 8 38 + + * - Key + - Value + - Default + - Legacy + - Description + * - ``folder`` + - text + - no files + - (none) + - Output folder, relative to the case file. + * - ``mat`` + - true or false + - true + - (none) + - Write results.mat. + * - ``ansys`` + - true or false + - false + - (none) + - Write ANSYS macro files (needs snapshots.every > 0). + * - ``vtk`` + - true or false + - false + - (none) + - Write VTK files for ParaView (needs snapshots.every > 0). + +.. rubric:: ``[output.snapshots]`` + +.. list-table:: + :header-rows: 1 + :widths: 18 24 12 8 38 + + * - Key + - Value + - Default + - Legacy + - Description + * - ``every`` + - steps or time (0 = never) + - (none) + - OU3 + - Steps or time between full-field snapshots; 0 = never. + +.. rubric:: ``[output.control_nodes]`` + +.. list-table:: + :header-rows: 1 + :widths: 18 24 12 8 38 + + * - Key + - Value + - Default + - Legacy + - Description + * - ``every`` + - steps or time (0 = never) + - (none) + - OU6 + - Steps or time between records of the control nodes and reactions; 0 = never. + +.. rubric:: ``[output.energy]`` + +.. list-table:: + :header-rows: 1 + :widths: 18 24 12 8 38 + + * - Key + - Value + - Default + - Legacy + - Description + * - ``every`` + - steps or time (0 = never) + - (none) + - OU8 + - Steps or time between records of the energies; 0 = never. diff --git a/docs/source/en/usage.rst b/docs/source/en/usage.rst index 70ebba1..2591ee0 100644 --- a/docs/source/en/usage.rst +++ b/docs/source/en/usage.rst @@ -94,7 +94,8 @@ Rules of the format: - ``module_size``, ``modules``, ``perturbation`` (random displacement of the nodes, fraction of the module), ``seed`` (of the perturbation) * - ``[material]`` - - ``law``, ``young_modulus``, ``poisson_ratio``, ``density``, + - ``law`` (``bilinear``, the legacy law, or ``linear_elastic``: no damage and no + rupture), ``young_modulus``, ``poisson_ratio``, ``density``, ``fracture_energy``, ``critical_distance``, ``failure_area_factor`` * - ``[material.scatter]`` - Scatter of the critical strain of the bars. ``type = "none"``; @@ -104,10 +105,12 @@ Rules of the format: * - ``[time]`` - ``step`` (or ``auto``), ``duration`` * - ``[damping]`` - - ``type``, ``initial``, ``final``, ``switch_time``, ``constitutive`` + - ``type`` (``mass_proportional``, the legacy damping, or ``none``), + ``initial``, ``final``, ``switch_time`` (not allowed with ``none``), + ``constitutive`` * - ``[scenario]`` - - ``type`` (``uniaxial_tension``, ``four_point_bending`` or - ``clamped_beam``) and the properties of that scenario in snake_case, + - ``type`` (``uniaxial_tension``, ``four_point_bending``, + ``clamped_beam`` or ``custom``, see below) and the properties of that scenario in snake_case, for example ``force_rate``, ``ramp_time``, ``load_position`` (``"midspan"`` is allowed) * - ``[[monitor.node]]`` @@ -125,7 +128,117 @@ Rules of the format: options; ``ldem.Parameters.fromFile`` also accepts a case file. The list of keys lives in one table, ``ldem.schema.caseSchema``, which drives the reader, the writer and the template. To add a scenario, add a line to -``ldem.scenarios.registry``. +``ldem.scenarios.registry``. A new constitutive law is a subclass of +``ldem.material.MaterialLaw`` registered in ``ldem.material.lawRegistry``; a new +damping model is a subclass of ``ldem.solver.DampingModel`` registered in +``ldem.solver.dampingRegistry``. + +Reuse a case: extends +--------------------- + +A case file can start from another one and change only what differs: + +.. code-block:: text + + extends = "base.ldem" # or a list: ["base.ldem", "material.ldem"] + + [material] + fracture_energy = 1 N/m # only what changes + +The keys of the file replace the inherited ones. A repeated table (``[[support]]``, +``[[load]]``, ``[[monitor.node]]``, ``[[sweep]]``) replaces the whole inherited +list. When the ``type`` of the scenario, of ``[material.scatter]`` or of +``[damping]`` changes, the keys of the old type that are not set again are +dropped. With a list, later files win. Relative paths (the random-field file, the +output folder) are relative to the file that contains them, and an error names the +file and line where the problem is written. ``results.info.case.parents`` keeps +the hash of every inherited file. + +Parameter sweeps +---------------- + +To study how the result depends on a value, list the values in ``[[sweep]]`` +blocks and run ``ldem.sweep``: + +.. code-block:: text + + [[sweep]] + key = "material.fracture_energy" + values = ["0.1 N/m", "0.5 N/m", "1 N/m"] + + [[sweep]] + key = "time.duration" + values = ["20 us", "40 us"] + +.. code-block:: matlab + + >> summary = ldem.sweep("case.ldem"); % 3 x 2 = 6 runs, one folder each + >> ldem.sweep("case.ldem", DryRun=true); % only validate and list the runs + >> ldem.sweep("case.ldem", Vary={"scenario.force_rate", ["1 kN/s" "2 kN/s"]}); + >> results = ldem.run("case.ldem", Overrides=struct("path", "material.fracture_energy", "value", "2 N/m")); + +Several blocks give every combination; ``sweep_mode = "zip"`` (a key at the top of +the file) takes them one by one. Any key with a single value can be varied, and +the keys of the scenario as ``scenario.``. Values are numbers or texts with +units. Every run is validated before the first one starts. The runs go to +``run_001``, ``run_002``, ... (each with its resolved ``case.ldem``) and the +table ``sweep_summary.csv`` lists them, with the number of damaged and broken +bars; a run that fails is recorded and the sweep goes on. + +Reference of every key +---------------------- + +The tables below are generated from ``ldem.schema.caseSchema``, the same table +that the reader uses, so they always agree with it. + +.. include:: ../case-keys.inc + +Your own test: supports and loads +--------------------------------- + +With ``type = "custom"`` the test is described in the case file by +``[[support]]`` and ``[[load]]`` blocks, without writing a class. This is the +uniaxial test (``testId = 101``) as blocks: + +.. code-block:: text + + [scenario] + type = "custom" + + [[support]] + name = "left end" + x = 0.5 # the layer of centre nodes at x = 0.5 modules + fix = ["x"] # directions that cannot move + + [[load]] + name = "right end" + x = "max - 0.5" + direction = "x" + type = "displacement" # or "force" + time_function = "linear" + rate = -4 mm/s + reaction = true # its force is the reaction of the test + +**Nodes** are chosen with ``nodes`` (``all``, ``grid`` for the corners of the +modules or ``centre`` for their centres), ``ids`` (node numbers) and ``x``, +``y``, ``z``. A position is in modules (centre nodes lie at half-integers, grid +nodes at integers), a range ``[lo, hi]``, or a text with the references +``min``, ``max`` and ``mid`` and an offset, such as ``"max - 0.5"``. A node must +satisfy every condition. The positions refer to the regular lattice, so they do +not change when ``mesh.perturbation`` moves the nodes. + +**Supports** hold the directions listed in ``fix``. **Loads** act on one +``direction`` as a ``force`` (newtons on each selected node) or as a prescribed +``displacement`` (metres from the initial position, and the solver holds that +direction). The value follows ``time_function``: ``constant`` (``value``), +``linear`` (``rate``), ``ramp`` (``rate`` until the time ``until``, then +constant) or ``table`` (``times`` and ``values`` in SI units, linear between +points and constant outside). + +A block with ``reaction = true`` adds its force to the reaction of the test +(the sum of the bar forces on its held directions); with none, the reaction is +NaN. A block that selects no node is an error that names it. The three built-in +tests written this way give exactly the same results as their classes. Tests available --------------- diff --git a/docs/source/es/usage.rst b/docs/source/es/usage.rst index f8f784b..53c4993 100644 --- a/docs/source/es/usage.rst +++ b/docs/source/es/usage.rst @@ -96,7 +96,8 @@ Reglas del formato: - ``module_size``, ``modules``, ``perturbation`` (desplazamiento aleatorio de los nodos, fracción del módulo), ``seed`` (de la perturbación) * - ``[material]`` - - ``law``, ``young_modulus``, ``poisson_ratio``, ``density``, + - ``law`` (``bilinear``, la ley original, o ``linear_elastic``: sin daño ni + rotura), ``young_modulus``, ``poisson_ratio``, ``density``, ``fracture_energy``, ``critical_distance``, ``failure_area_factor`` * - ``[material.scatter]`` - Dispersión de la deformación crítica de las barras. ``type = "none"``; @@ -106,10 +107,12 @@ Reglas del formato: * - ``[time]`` - ``step`` (o ``auto``), ``duration`` * - ``[damping]`` - - ``type``, ``initial``, ``final``, ``switch_time``, ``constitutive`` + - ``type`` (``mass_proportional``, el amortiguamiento original, o ``none``), + ``initial``, ``final``, ``switch_time`` (no se admiten con ``none``), + ``constitutive`` * - ``[scenario]`` - - ``type`` (``uniaxial_tension``, ``four_point_bending`` o - ``clamped_beam``) y las propiedades de ese escenario en snake_case, por + - ``type`` (``uniaxial_tension``, ``four_point_bending``, + ``clamped_beam`` o ``custom``, ver más abajo) y las propiedades de ese escenario en snake_case, por ejemplo ``force_rate``, ``ramp_time``, ``load_position`` (se admite ``"midspan"``) * - ``[[monitor.node]]`` @@ -128,7 +131,122 @@ Reglas del formato: salida; ``ldem.Parameters.fromFile`` también acepta un archivo de caso. La lista de claves está en una sola tabla, ``ldem.schema.caseSchema``, que gobierna el lector, el escritor y la plantilla. Para agregar un escenario, se agrega una -línea a ``ldem.scenarios.registry``. +línea a ``ldem.scenarios.registry``. Una ley constitutiva nueva es una subclase +de ``ldem.material.MaterialLaw`` registrada en ``ldem.material.lawRegistry``; un +modelo de amortiguamiento nuevo, una subclase de ``ldem.solver.DampingModel`` +registrada en ``ldem.solver.dampingRegistry``. + +Reutilizar un caso: extends +--------------------------- + +Un archivo de caso puede partir de otro y cambiar solo lo que difiere: + +.. code-block:: text + + extends = "base.ldem" # or a list: ["base.ldem", "material.ldem"] + + [material] + fracture_energy = 1 N/m # only what changes + +Las claves del archivo reemplazan a las heredadas. Una tabla repetida +(``[[support]]``, ``[[load]]``, ``[[monitor.node]]``, ``[[sweep]]``) reemplaza +toda la lista heredada. Cuando cambia el ``type`` del escenario, de +``[material.scatter]`` o de ``[damping]``, se descartan las claves del tipo +anterior que no se vuelven a definir. Con una lista, los últimos archivos +ganan. Las rutas relativas (archivo del campo aleatorio, carpeta de salida) son +relativas al archivo que las contiene, y un error nombra el archivo y la línea +donde está escrito el problema. ``results.info.case.parents`` guarda el hash de +cada archivo heredado. + +Barridos de parámetros +---------------------- + +Para estudiar cómo depende el resultado de un valor, se listan los valores en +bloques ``[[sweep]]`` y se ejecuta ``ldem.sweep``: + +.. code-block:: text + + [[sweep]] + key = "material.fracture_energy" + values = ["0.1 N/m", "0.5 N/m", "1 N/m"] + + [[sweep]] + key = "time.duration" + values = ["20 us", "40 us"] + +.. code-block:: matlab + + >> summary = ldem.sweep("case.ldem"); % 3 x 2 = 6 runs, one folder each + >> ldem.sweep("case.ldem", DryRun=true); % only validate and list the runs + >> ldem.sweep("case.ldem", Vary={"scenario.force_rate", ["1 kN/s" "2 kN/s"]}); + >> results = ldem.run("case.ldem", Overrides=struct("path", "material.fracture_energy", "value", "2 N/m")); + +Varios bloques dan todas las combinaciones; ``sweep_mode = "zip"`` (una clave al +principio del archivo) los toma uno a uno. Se puede variar cualquier clave de un +solo valor, y las del escenario como ``scenario.``. Los valores son +números o textos con unidades. Cada corrida se valida antes de empezar la +primera. Las corridas van a ``run_001``, ``run_002``, ... (cada una con su +``case.ldem`` resuelto) y la tabla ``sweep_summary.csv`` las lista, con el +número de barras dañadas y rotas; una corrida que falla queda registrada y el +barrido continúa. + +Referencia de todas las claves +------------------------------ + +Las tablas siguientes se generan desde ``ldem.schema.caseSchema``, la misma tabla +que usa el lector, así que siempre coinciden con él. Las descripciones están en +inglés. + +.. include:: ../case-keys.inc + +Su propio ensayo: apoyos y cargas +--------------------------------- + +Con ``type = "custom"`` el ensayo se describe en el archivo de caso con bloques +``[[support]]`` y ``[[load]]``, sin escribir una clase. Este es el ensayo +uniaxial (``testId = 101``) como bloques: + +.. code-block:: text + + [scenario] + type = "custom" + + [[support]] + name = "left end" + x = 0.5 # the layer of centre nodes at x = 0.5 modules + fix = ["x"] # directions that cannot move + + [[load]] + name = "right end" + x = "max - 0.5" + direction = "x" + type = "displacement" # or "force" + time_function = "linear" + rate = -4 mm/s + reaction = true # its force is the reaction of the test + +Los **nodos** se eligen con ``nodes`` (``all``, ``grid`` para las esquinas de +los módulos o ``centre`` para sus centros), ``ids`` (números de nodo) y ``x``, +``y``, ``z``. Una posición está en módulos (los nodos centrales están en +semienteros, los de esquina en enteros), un rango ``[lo, hi]``, o un texto con +las referencias ``min``, ``max`` y ``mid`` y un desplazamiento, como +``"max - 0.5"``. Un nodo debe cumplir todas las condiciones. Las posiciones se +refieren a la malla regular, así que no cambian cuando ``mesh.perturbation`` +mueve los nodos. + +Los **apoyos** fijan las direcciones de ``fix``. Las **cargas** actúan en una +``direction`` como ``force`` (newtons en cada nodo elegido) o como +``displacement`` impuesto (metros desde la posición inicial; el solver fija esa +dirección). El valor sigue ``time_function``: ``constant`` (``value``), +``linear`` (``rate``), ``ramp`` (``rate`` hasta el tiempo ``until`` y luego +constante) o ``table`` (``times`` y ``values`` en unidades SI, lineal entre +puntos y constante fuera). + +Un bloque con ``reaction = true`` suma su fuerza a la reacción del ensayo (la +suma de las fuerzas de barra en sus direcciones fijas); si ninguno la pide, la +reacción es NaN. Un bloque que no elige ningún nodo es un error que lo nombra. +Los tres ensayos incorporados escritos así dan exactamente los mismos +resultados que sus clases. Ensayos disponibles ------------------- diff --git a/docs/source/it/usage.rst b/docs/source/it/usage.rst index ab04f66..4f1e82f 100644 --- a/docs/source/it/usage.rst +++ b/docs/source/it/usage.rst @@ -95,7 +95,8 @@ Regole del formato: - ``module_size``, ``modules``, ``perturbation`` (spostamento casuale dei nodi, frazione del modulo), ``seed`` (della perturbazione) * - ``[material]`` - - ``law``, ``young_modulus``, ``poisson_ratio``, ``density``, + - ``law`` (``bilinear``, la legge originale, o ``linear_elastic``: senza danno né + rottura), ``young_modulus``, ``poisson_ratio``, ``density``, ``fracture_energy``, ``critical_distance``, ``failure_area_factor`` * - ``[material.scatter]`` - Dispersione della deformazione critica delle barre. ``type = "none"``; @@ -105,10 +106,12 @@ Regole del formato: * - ``[time]`` - ``step`` (o ``auto``), ``duration`` * - ``[damping]`` - - ``type``, ``initial``, ``final``, ``switch_time``, ``constitutive`` + - ``type`` (``mass_proportional``, lo smorzamento originale, o ``none``), + ``initial``, ``final``, ``switch_time`` (non ammessi con ``none``), + ``constitutive`` * - ``[scenario]`` - - ``type`` (``uniaxial_tension``, ``four_point_bending`` o - ``clamped_beam``) e le proprietà di quello scenario in snake_case, per + - ``type`` (``uniaxial_tension``, ``four_point_bending``, + ``clamped_beam`` o ``custom``, vedi sotto) e le proprietà di quello scenario in snake_case, per esempio ``force_rate``, ``ramp_time``, ``load_position`` (è ammesso ``"midspan"``) * - ``[[monitor.node]]`` @@ -127,7 +130,120 @@ Regole del formato: uscita; ``ldem.Parameters.fromFile`` accetta anche un file di caso. L'elenco delle chiavi è in un'unica tabella, ``ldem.schema.caseSchema``, che governa il lettore, lo scrittore e il modello. Per aggiungere uno scenario si aggiunge una -riga a ``ldem.scenarios.registry``. +riga a ``ldem.scenarios.registry``. Una nuova legge costitutiva è una sottoclasse +di ``ldem.material.MaterialLaw`` registrata in ``ldem.material.lawRegistry``; un +nuovo modello di smorzamento, una sottoclasse di ``ldem.solver.DampingModel`` +registrata in ``ldem.solver.dampingRegistry``. + +Riutilizzare un caso: extends +----------------------------- + +Un file di caso può partire da un altro e cambiare solo ciò che differisce: + +.. code-block:: text + + extends = "base.ldem" # or a list: ["base.ldem", "material.ldem"] + + [material] + fracture_energy = 1 N/m # only what changes + +Le chiavi del file sostituiscono quelle ereditate. Una tabella ripetuta +(``[[support]]``, ``[[load]]``, ``[[monitor.node]]``, ``[[sweep]]``) sostituisce +l'intero elenco ereditato. Quando cambia il ``type`` dello scenario, di +``[material.scatter]`` o di ``[damping]``, le chiavi del tipo precedente non +ridefinite vengono scartate. Con un elenco, i file successivi prevalgono. I +percorsi relativi (file del campo casuale, cartella di uscita) sono relativi al +file che li contiene, e un errore indica il file e la riga in cui il problema è +scritto. ``results.info.case.parents`` conserva l'hash di ogni file ereditato. + +Scansioni di parametri +---------------------- + +Per studiare come il risultato dipende da un valore, si elencano i valori in +blocchi ``[[sweep]]`` e si esegue ``ldem.sweep``: + +.. code-block:: text + + [[sweep]] + key = "material.fracture_energy" + values = ["0.1 N/m", "0.5 N/m", "1 N/m"] + + [[sweep]] + key = "time.duration" + values = ["20 us", "40 us"] + +.. code-block:: matlab + + >> summary = ldem.sweep("case.ldem"); % 3 x 2 = 6 runs, one folder each + >> ldem.sweep("case.ldem", DryRun=true); % only validate and list the runs + >> ldem.sweep("case.ldem", Vary={"scenario.force_rate", ["1 kN/s" "2 kN/s"]}); + >> results = ldem.run("case.ldem", Overrides=struct("path", "material.fracture_energy", "value", "2 N/m")); + +Più blocchi danno tutte le combinazioni; ``sweep_mode = "zip"`` (una chiave +all'inizio del file) li prende uno a uno. Si può variare qualsiasi chiave a +valore singolo, e quelle dello scenario come ``scenario.``. I valori +sono numeri o testi con unità. Ogni esecuzione viene validata prima di iniziare +la prima. Le esecuzioni vanno in ``run_001``, ``run_002``, ... (ciascuna con il +proprio ``case.ldem`` risolto) e la tabella ``sweep_summary.csv`` le elenca, con +il numero di barre danneggiate e rotte; un'esecuzione che fallisce viene +registrata e la scansione prosegue. + +Riferimento di tutte le chiavi +------------------------------ + +Le tabelle seguenti sono generate da ``ldem.schema.caseSchema``, la stessa +tabella usata dal lettore, quindi concordano sempre con esso. Le descrizioni +sono in inglese. + +.. include:: ../case-keys.inc + +La propria prova: appoggi e carichi +----------------------------------- + +Con ``type = "custom"`` la prova si descrive nel file di caso con blocchi +``[[support]]`` e ``[[load]]``, senza scrivere una classe. Questa è la prova +uniassiale (``testId = 101``) come blocchi: + +.. code-block:: text + + [scenario] + type = "custom" + + [[support]] + name = "left end" + x = 0.5 # the layer of centre nodes at x = 0.5 modules + fix = ["x"] # directions that cannot move + + [[load]] + name = "right end" + x = "max - 0.5" + direction = "x" + type = "displacement" # or "force" + time_function = "linear" + rate = -4 mm/s + reaction = true # its force is the reaction of the test + +I **nodi** si scelgono con ``nodes`` (``all``, ``grid`` per gli angoli dei +moduli o ``centre`` per i loro centri), ``ids`` (numeri di nodo) e ``x``, ``y``, +``z``. Una posizione è in moduli (i nodi centrali sono a semi-interi, quelli +d'angolo a interi), un intervallo ``[lo, hi]``, o un testo con i riferimenti +``min``, ``max`` e ``mid`` e uno scostamento, come ``"max - 0.5"``. Un nodo deve +soddisfare tutte le condizioni. Le posizioni si riferiscono al reticolo +regolare, quindi non cambiano quando ``mesh.perturbation`` sposta i nodi. + +Gli **appoggi** bloccano le direzioni di ``fix``. I **carichi** agiscono su una +``direction`` come ``force`` (newton su ogni nodo scelto) o come +``displacement`` imposto (metri dalla posizione iniziale; il solver blocca quella +direzione). Il valore segue ``time_function``: ``constant`` (``value``), +``linear`` (``rate``), ``ramp`` (``rate`` fino al tempo ``until``, poi costante) +o ``table`` (``times`` e ``values`` in unità SI, lineare tra i punti e costante +fuori). + +Un blocco con ``reaction = true`` aggiunge la sua forza alla reazione della prova +(la somma delle forze di barra nelle sue direzioni bloccate); se nessuno la +richiede, la reazione è NaN. Un blocco che non sceglie alcun nodo è un errore che +lo nomina. Le tre prove incorporate scritte così danno esattamente gli stessi +risultati delle loro classi. Prove disponibili ----------------- diff --git a/docs/source/pt/usage.rst b/docs/source/pt/usage.rst index 4c70811..7ff4f0a 100644 --- a/docs/source/pt/usage.rst +++ b/docs/source/pt/usage.rst @@ -96,7 +96,8 @@ Regras do formato: - ``module_size``, ``modules``, ``perturbation`` (deslocamento aleatório dos nós, fração do módulo), ``seed`` (da perturbação) * - ``[material]`` - - ``law``, ``young_modulus``, ``poisson_ratio``, ``density``, + - ``law`` (``bilinear``, a lei original, ou ``linear_elastic``: sem dano nem + ruptura), ``young_modulus``, ``poisson_ratio``, ``density``, ``fracture_energy``, ``critical_distance``, ``failure_area_factor`` * - ``[material.scatter]`` - Dispersão da deformação crítica das barras. ``type = "none"``; @@ -106,10 +107,12 @@ Regras do formato: * - ``[time]`` - ``step`` (ou ``auto``), ``duration`` * - ``[damping]`` - - ``type``, ``initial``, ``final``, ``switch_time``, ``constitutive`` + - ``type`` (``mass_proportional``, o amortecimento original, ou ``none``), + ``initial``, ``final``, ``switch_time`` (não aceitos com ``none``), + ``constitutive`` * - ``[scenario]`` - - ``type`` (``uniaxial_tension``, ``four_point_bending`` ou - ``clamped_beam``) e as propriedades desse cenário em snake_case, por + - ``type`` (``uniaxial_tension``, ``four_point_bending``, + ``clamped_beam`` ou ``custom``, veja abaixo) e as propriedades desse cenário em snake_case, por exemplo ``force_rate``, ``ramp_time``, ``load_position`` (é aceito ``"midspan"``) * - ``[[monitor.node]]`` @@ -128,7 +131,121 @@ Regras do formato: ``ldem.Parameters.fromFile`` também aceita um arquivo de caso. A lista de chaves está em uma única tabela, ``ldem.schema.caseSchema``, que governa o leitor, o escritor e o modelo. Para adicionar um cenário, adiciona-se uma linha a -``ldem.scenarios.registry``. +``ldem.scenarios.registry``. Uma nova lei constitutiva é uma subclasse de +``ldem.material.MaterialLaw`` registrada em ``ldem.material.lawRegistry``; um novo +modelo de amortecimento, uma subclasse de ``ldem.solver.DampingModel`` registrada +em ``ldem.solver.dampingRegistry``. + +Reutilizar um caso: extends +--------------------------- + +Um arquivo de caso pode partir de outro e mudar só o que difere: + +.. code-block:: text + + extends = "base.ldem" # or a list: ["base.ldem", "material.ldem"] + + [material] + fracture_energy = 1 N/m # only what changes + +As chaves do arquivo substituem as herdadas. Uma tabela repetida +(``[[support]]``, ``[[load]]``, ``[[monitor.node]]``, ``[[sweep]]``) substitui +toda a lista herdada. Quando muda o ``type`` do cenário, de +``[material.scatter]`` ou de ``[damping]``, as chaves do tipo anterior que não +são definidas de novo são descartadas. Com uma lista, os últimos arquivos +vencem. Os caminhos relativos (arquivo do campo aleatório, pasta de saída) são +relativos ao arquivo que os contém, e um erro indica o arquivo e a linha onde o +problema está escrito. ``results.info.case.parents`` guarda o hash de cada +arquivo herdado. + +Varreduras de parâmetros +------------------------ + +Para estudar como o resultado depende de um valor, listam-se os valores em +blocos ``[[sweep]]`` e executa-se ``ldem.sweep``: + +.. code-block:: text + + [[sweep]] + key = "material.fracture_energy" + values = ["0.1 N/m", "0.5 N/m", "1 N/m"] + + [[sweep]] + key = "time.duration" + values = ["20 us", "40 us"] + +.. code-block:: matlab + + >> summary = ldem.sweep("case.ldem"); % 3 x 2 = 6 runs, one folder each + >> ldem.sweep("case.ldem", DryRun=true); % only validate and list the runs + >> ldem.sweep("case.ldem", Vary={"scenario.force_rate", ["1 kN/s" "2 kN/s"]}); + >> results = ldem.run("case.ldem", Overrides=struct("path", "material.fracture_energy", "value", "2 N/m")); + +Vários blocos dão todas as combinações; ``sweep_mode = "zip"`` (uma chave no +início do arquivo) toma-os um a um. Pode-se variar qualquer chave de valor +único, e as do cenário como ``scenario.``. Os valores são números ou +textos com unidades. Cada execução é validada antes de começar a primeira. As +execuções vão para ``run_001``, ``run_002``, ... (cada uma com o seu +``case.ldem`` resolvido) e a tabela ``sweep_summary.csv`` as lista, com o número +de barras danificadas e rompidas; uma execução que falha fica registrada e a +varredura continua. + +Referência de todas as chaves +----------------------------- + +As tabelas a seguir são geradas a partir de ``ldem.schema.caseSchema``, a mesma +tabela que o leitor usa, portanto sempre coincidem com ele. As descrições estão +em inglês. + +.. include:: ../case-keys.inc + +O seu próprio ensaio: apoios e cargas +-------------------------------------- + +Com ``type = "custom"`` o ensaio é descrito no arquivo de caso com blocos +``[[support]]`` e ``[[load]]``, sem escrever uma classe. Este é o ensaio +uniaxial (``testId = 101``) como blocos: + +.. code-block:: text + + [scenario] + type = "custom" + + [[support]] + name = "left end" + x = 0.5 # the layer of centre nodes at x = 0.5 modules + fix = ["x"] # directions that cannot move + + [[load]] + name = "right end" + x = "max - 0.5" + direction = "x" + type = "displacement" # or "force" + time_function = "linear" + rate = -4 mm/s + reaction = true # its force is the reaction of the test + +Os **nós** são escolhidos com ``nodes`` (``all``, ``grid`` para os cantos dos +módulos ou ``centre`` para os seus centros), ``ids`` (números de nó) e ``x``, +``y``, ``z``. Uma posição é em módulos (os nós centrais ficam em semi-inteiros, +os de canto em inteiros), um intervalo ``[lo, hi]``, ou um texto com as +referências ``min``, ``max`` e ``mid`` e um deslocamento, como ``"max - 0.5"``. +Um nó deve satisfazer todas as condições. As posições referem-se à malha +regular, portanto não mudam quando ``mesh.perturbation`` move os nós. + +Os **apoios** fixam as direções de ``fix``. As **cargas** atuam em uma +``direction`` como ``force`` (newtons em cada nó escolhido) ou como +``displacement`` imposto (metros a partir da posição inicial; o solver fixa essa +direção). O valor segue ``time_function``: ``constant`` (``value``), ``linear`` +(``rate``), ``ramp`` (``rate`` até o tempo ``until``, depois constante) ou +``table`` (``times`` e ``values`` em unidades SI, linear entre pontos e constante +fora). + +Um bloco com ``reaction = true`` soma sua força à reação do ensaio (a soma das +forças de barra nas suas direções fixas); se nenhum a pedir, a reação é NaN. Um +bloco que não escolhe nenhum nó é um erro que o nomeia. Os três ensaios +incorporados escritos assim dão exatamente os mesmos resultados que as suas +classes. Ensaios disponíveis ------------------- diff --git a/src/+ldem/+io/readCase.m b/src/+ldem/+io/readCase.m index 5bab516..2fd02ea 100644 --- a/src/+ldem/+io/readCase.m +++ b/src/+ldem/+io/readCase.m @@ -1,4 +1,4 @@ -function c = readCase(path) +function c = readCase(path, options) %READCASE Read a case file (.ldem or .json) and build the simulation inputs. % % c = ldem.io.readCase(path) reads a case file, checks every key against @@ -24,15 +24,25 @@ % Relative paths (the random-field file and the output folder) are relative % to the folder of the case file. % +% A case file may inherit from others with extends = "base.ldem" (or a list): +% its keys replace the inherited ones, a repeated table ([[support]], [[load]], +% [[monitor.node]], [[sweep]]) replaces the whole inherited list, and when the +% scenario, scatter or damping type changes the keys of the old type are dropped. +% Relative paths are relative to the file that contains them. +% % Input: % path Path of a .ldem file or of a .json file with the same structure. % +% Name-value options: +% Overrides Struct array with the fields path ("section.key") and value that +% replace keys of the file; ldem.sweep uses it to vary a key. +% % Output: % c Struct with the fields % params Validated ldem.Parameters. % scenario Scenario object with the values of the [scenario] section. % options Struct with OutputFolder and Formats, for runSimulation. -% info Struct: source, format, title, authors, controlNodeNames and nodeNotes. +% info Struct: source, format, title, authors, controlNodeNames, nodeNotes, parents, sweep, sweepMode. % % Errors: % ldem:io:fileNotFound The file does not exist. @@ -54,6 +64,7 @@ arguments path (1,1) string + options.Overrides = [] end if ~isfile(path) @@ -63,16 +74,8 @@ [folder, name, ext] = fileparts(absPath); ctx = struct('source', string(name) + string(ext), 'folder', string(folder)); -text = string(fileread(absPath)); -switch lower(string(ext)) - case ".ldem" - entries = ldem.io.parseCaseText(text, ctx.source); - case ".json" - entries = ldem.io.parseCaseJson(text, ctx.source); - otherwise - error('ldem:io:unknownExtension', ... - 'Case files must be .ldem or .json, got "%s".', ext); -end +[entries, parents] = loadEntries(absPath, strings(0, 1)); +entries = applyOverrides(entries, options.Overrides, ctx); schema = ldem.schema.caseSchema(); reg = ldem.scenarios.registry(); @@ -86,8 +89,8 @@ origin = struct(); [values, origin] = readSimpleKeys(values, origin, entries, schema, ctx); [values, origin] = readModules(values, origin, entries, ctx); -readEnum(entries, schema, "material.law", ctx); -readEnum(entries, schema, "damping.type", ctx); +[values, origin] = readEnumKeys(values, origin, entries, schema, ctx); +checkDampingKeys(entries, values, ctx); checkScatter(entries, schema, ctx); % Time step: explicit, or "auto" (also when the key is absent). @@ -144,6 +147,8 @@ error(err.identifier, '%s', char(ctx.source + ": " + string(err.message))); end +[sweepBlocks, sweepMode] = readSweep(entries, schema, ctx); + c = struct(); c.params = p; c.scenario = scenario; @@ -151,7 +156,203 @@ c.info = struct('source', string(absPath), 'format', 1, ... 'title', stringValue(entries, "", "title", ""), ... 'authors', stringValue(entries, "", "authors", strings(1, 0)), ... - 'controlNodeNames', names, 'nodeNotes', nodeNotes); + 'controlNodeNames', names, 'nodeNotes', nodeNotes, ... + 'parents', parents, 'sweep', sweepBlocks, 'sweepMode', sweepMode); +end + +% ------------------------------------------------------------------------ + +function [entries, parents] = loadEntries(absPath, chain) +%LOADENTRIES Entries of a case file with the ones it inherits through "extends". +% Every entry also carries the file it was written in (file) and its folder +% (folder), for the error messages and for relative paths. +[folder, name, ext] = fileparts(absPath); +source = string(name) + string(ext); +text = string(fileread(absPath)); +switch lower(string(ext)) + case ".ldem" + entries = ldem.io.parseCaseText(text, source); + case ".json" + entries = ldem.io.parseCaseJson(text, source); + otherwise + error('ldem:io:unknownExtension', ... + 'Case files must be .ldem or .json, got "%s".', ext); +end +if isempty(entries) + entries = struct('section', {}, 'index', {}, 'key', {}, 'value', {}, 'line', {}, ... + 'file', {}, 'folder', {}); +else + for k = 1:numel(entries) + entries(k).file = source; + entries(k).folder = string(folder); + end +end + +parents = strings(0, 1); +eExtends = findEntry(entries, "", "extends"); +if isempty(eExtends) + return +end +entries(string({entries.section}) == "" & string({entries.key}) == "extends") = []; + +where = source + ":" + string(eExtends.line) + " extends"; +if ~(isstring(eExtends.value) && ~isempty(eExtends.value)) + ldem.schema.raise('ldem:case:badValue', where, ... + 'Expected the path of a case file or a list of them, in quotes.'); +end +chain = [chain; string(absPath)]; +merged = entries([]); +for relative = reshape(eExtends.value, 1, []) + parentPath = relative; + if isempty(regexp(parentPath, '^([A-Za-z]:|[\\/])', 'once')) + parentPath = joinPath(folder, parentPath); + end + if ~isfile(parentPath) + ldem.schema.raise('ldem:io:fileNotFound', where, ... + 'The case file "%s" that this one extends does not exist.', relative); + end + parentPath = absolutePath(parentPath); + if any(lower(chain) == lower(parentPath)) + ldem.schema.raise('ldem:case:extendsLoop', where, ... + 'Case files extend each other in a loop: %s.', strjoin([chain; parentPath], ' -> ')); + end + [parentEntries, grandParents] = loadEntries(parentPath, chain); + merged = mergeEntries(merged, parentEntries); + parents = [parents; grandParents; parentPath]; %#ok +end +entries = mergeEntries(merged, entries); +parents = unique(parents, 'stable'); +end + +function merged = mergeEntries(base, over) +%MERGEENTRIES Entries of "over" replace those of "base" that set the same thing. +% A key replaces the same key; a repeated table ([[support]], [[load]], +% [[monitor.node]], [[sweep]]) replaces the whole list of that table; and when +% the type of the scenario, of the scatter or of the damping model changes, the +% keys of the old type that are not set again are dropped. +if isempty(base) + merged = over; + return +end +baseSections = string({base.section}); +baseKeys = string({base.key}); +baseIndices = [base.index]; +overSections = string({over.section}); +overKeys = string({over.key}); +overIndices = [over.index]; + +drop = false(size(base)); +for k = 1:numel(base) + if baseIndices(k) == 0 + drop(k) = any(overSections == baseSections(k) & overKeys == baseKeys(k) & overIndices == 0); + else + drop(k) = any(overSections == baseSections(k) & overIndices > 0); + end +end +for section = ["scenario" "material.scatter" "damping"] + newType = typeOf(over, section); + oldType = typeOf(base, section); + if newType ~= "" && oldType ~= "" && newType ~= oldType + drop = drop | (baseSections == section & baseKeys ~= "type"); + end +end +merged = [base(~drop), over]; +end + +function word = typeOf(entries, section) +e = findEntry(entries, section, "type"); +if isempty(e) || ~isstring(e.value) || ~isscalar(e.value) + word = ""; +else + word = lower(strtrim(e.value)); +end +end + +function entries = applyOverrides(entries, overrides, ctx) +%APPLYOVERRIDES Set keys from outside the file (a sweep): struct array with path and value. +if isempty(overrides) + return +end +schema = ldem.schema.caseSchema(); +paths = string({schema.path}); +for k = 1:numel(overrides) + target = string(overrides(k).path); + section = sectionOf(target); + key = keyOf(target); + if ~any(paths == target) && section ~= "scenario" + ldem.schema.raise('ldem:sweep:unknownKey', "sweep", ... + 'The key "%s" does not exist.%s', target, ldem.schema.suggest(target, paths)); + end + if any(section == arrayTables()) + ldem.schema.raise('ldem:sweep:unsupportedKey', "sweep", ... + 'The key "%s" belongs to a repeated table and cannot be swept.', target); + end + if ~isempty(entries) + entries(string({entries.section}) == section & string({entries.key}) == key ... + & [entries.index] == 0) = []; + end + entry = struct('section', section, 'index', 0, 'key', key, 'value', {overrides(k).value}, ... + 'line', 0, 'file', "sweep", 'folder', ctx.folder); + if isempty(entries) + entries = entry; + else + entries = [entries, entry]; %#ok + end +end +end + +function tables = arrayTables() +tables = ["monitor.node" "support" "load" "sweep"]; +end + +function [blocks, mode] = readSweep(entries, schema, ctx) +%READSWEEP The [[sweep]] blocks and sweep_mode: what ldem.sweep varies. +blocks = struct('key', {}, 'values', {}); +paths = string({schema.path}); +kinds = string({schema.kind}); +scalarKinds = ["integer" "number" "quantity" "string" "path" "enum" "stepOrAuto" "cadence"]; +sections = string({entries.section}); +indices = [entries.index]; +for k = unique(indices(sections == "sweep")) + block = entries(sections == "sweep" & indices == k); + if k == 0 + ldem.schema.raise('ldem:case:syntax', location(block(1), ctx), ... + 'Write [[sweep]] (double brackets): there can be several.'); + end + eKey = pickKey(block, "key"); + eValues = pickKey(block, "values"); + if isempty(eKey) || isempty(eValues) + ldem.schema.raise('ldem:case:missingKey', location(block(1), ctx), ... + 'A [[sweep]] needs "key" (what to vary) and "values" (a list).'); + end + if ~(isstring(eKey.value) && isscalar(eKey.value)) + ldem.schema.raise('ldem:case:badValue', location(eKey, ctx), ... + 'Expected the name of a key in quotes, such as "material.fracture_energy".'); + end + target = eKey.value; + j = find(paths == target, 1); + isScenarioKey = sectionOf(target) == "scenario" && keyOf(target) ~= "type"; + if isempty(j) && ~isScenarioKey + ldem.schema.raise('ldem:case:badValue', location(eKey, ctx), ... + '"%s" is not a key of the case file.%s', target, ldem.schema.suggest(target, paths)); + end + if ~isScenarioKey && (~any(kinds(j) == scalarKinds) || any(sectionOf(target) == arrayTables())) + ldem.schema.raise('ldem:case:badValue', location(eKey, ctx), ... + '"%s" cannot be swept: only keys with a single value and outside repeated tables.', target); + end + v = eValues.value; + if isempty(v) || ~((isnumeric(v) || isstring(v)) && isvector(v)) + ldem.schema.raise('ldem:case:badValue', location(eValues, ctx), ... + 'Expected a non-empty list of numbers or of quoted texts such as ["0.1 N/m", "0.5 N/m"].'); + end + items = num2cell(reshape(v, 1, [])); + blocks(end+1) = struct('key', target, 'values', {items}); %#ok +end +mode = "product"; +eMode = findEntry(entries, "", "sweep_mode"); +if ~isempty(eMode) + mode = enumWord(eMode, ["product" "zip"], ctx); +end end % ------------------------------------------------------------------------ @@ -207,7 +408,9 @@ function checkFormat(entries, ctx) continue end where = location(e, ctx); - values.(row.prop) = convertValue(e.value, row, where, ctx); + entryCtx = ctx; + entryCtx.folder = e.folder; + values.(row.prop) = convertValue(e.value, row, where, entryCtx); origin.(row.prop) = where; end end @@ -240,7 +443,7 @@ function checkFormat(entries, ctx) 'Expected a path in quotes, found %s.', describe(v)); end if isempty(regexp(v, '^([A-Za-z]:|[\\/])', 'once')) && strlength(v) > 0 - value = string(fullfile(ctx.folder, v)); + value = joinPath(ctx.folder, v); % ctx.folder is the folder of the entry's file else value = v; end @@ -259,6 +462,34 @@ function checkFormat(entries, ctx) origin.nModules = where; end +function [values, origin] = readEnumKeys(values, origin, entries, schema, ctx) +%READENUMKEYS Enum keys that set a Parameters property (the law, the damping model). +for row = schema(string({schema.kind}) == "enum" & string({schema.prop}) ~= "").' + word = readEnum(entries, schema, row.path, ctx); + if word ~= "" + values.(row.prop) = word; + origin.(row.prop) = location(findEntry(entries, sectionOf(row.path), keyOf(row.path)), ctx); + end +end +end + +function checkDampingKeys(entries, values, ctx) +%CHECKDAMPINGKEYS Keys of [damping] that the chosen model does not use are an error. +reg = ldem.solver.dampingRegistry(); +model = "mass_proportional"; +if isfield(values, 'dampingModel') + model = values.dampingModel; +end +spec = reg([reg.name] == model); +for key = ["initial" "final" "switch_time"] + e = findEntry(entries, "damping", key); + if ~isempty(e) && ~any(spec.keys == key) + ldem.schema.raise('ldem:case:inconsistentKey', location(e, ctx), ... + 'The key "%s" does not apply when type = "%s".', key, model); + end +end +end + function word = readEnum(entries, schema, path, ctx) %READENUM Value of an "enum" key, or "" if absent. Throws if not allowed. e = findEntry(entries, sectionOf(path), keyOf(path)); @@ -416,9 +647,183 @@ function checkScatter(entries, schema, ctx) ldem.schema.raise('ldem:case:invalidValue', location(eType, ctx) + " (scenario)", ... '%s', firstLine(err.message)); end +if name == "custom" + scenario = readBlocks(entries, ctx); +else + for e = entries + if any(e.section == ["support" "load"]) + ldem.schema.raise('ldem:case:inconsistentKey', location(e, ctx), ... + '[[%s]] blocks only apply when [scenario] type = "custom".', e.section); + end + end +end testId = spec.testId; end +function scenario = readBlocks(entries, ctx) +%READBLOCKS Build the declarative scenario from the [[support]] and [[load]] blocks. +supports = ldem.scenarios.Declarative.emptySupports(); +loads = ldem.scenarios.Declarative.emptyLoads(); +sections = string({entries.section}); +indices = [entries.index]; +for kind = ["support" "load"] + for k = unique(indices(sections == kind)) + block = entries(sections == kind & indices == k); + if k == 0 + ldem.schema.raise('ldem:case:syntax', location(block(1), ctx), ... + 'Write [[%s]] (double brackets): there can be several.', kind); + end + if kind == "support" + supports(end+1) = readSupport(block, ctx); %#ok + else + loads(end+1) = readLoad(block, ctx); %#ok + end + end +end +try + scenario = ldem.scenarios.Declarative(supports = supports, loads = loads); +catch err + ldem.schema.raise('ldem:case:invalidValue', ctx.source + " [scenario]", '%s', firstLine(err.message)); +end +end + +function block = readSupport(entries, ctx) +selector = readSelector(entries, ctx); +eFix = pickKey(entries, "fix"); +if isempty(eFix) + ldem.schema.raise('ldem:case:missingKey', location(entries(1), ctx), ... + 'A [[support]] needs "fix": the directions to hold, for example ["x", "y"].'); +end +try + block = ldem.scenarios.Declarative.makeSupport(selector, reshape(string(eFix.value), 1, []), ... + name = textOf(entries, "name", ctx), reaction = boolOf(entries, "reaction", ctx)); +catch err + ldem.schema.raise('ldem:case:badValue', location(eFix, ctx), '%s', firstLine(err.message)); +end +end + +function block = readLoad(entries, ctx) +selector = readSelector(entries, ctx); +for key = ["direction" "type" "time_function"] + if isempty(pickKey(entries, key)) + ldem.schema.raise('ldem:case:missingKey', location(entries(1), ctx), ... + 'A [[load]] needs "%s".', key); + end +end +direction = enumWord(pickKey(entries, "direction"), ["x" "y" "z"], ctx); +type = enumWord(pickKey(entries, "type"), ["force" "displacement"], ctx); +kind = enumWord(pickKey(entries, "time_function"), ["constant" "linear" "ramp" "table"], ctx); + +if type == "force" + valueDimension = "force"; + rateDimension = "forcerate"; +else + valueDimension = "length"; + rateDimension = "velocity"; +end +needs = struct('constant', "value", 'linear', "rate", 'ramp', ["rate" "until"], ... + 'table', ["times" "values"]); +needed = needs.(kind); +for key = ["value" "rate" "until" "times" "values"] + e = pickKey(entries, key); + if ~isempty(e) && ~any(needed == key) + ldem.schema.raise('ldem:case:inconsistentKey', location(e, ctx), ... + 'The key "%s" does not apply when time_function = "%s".', key, kind); + end + if isempty(e) && any(needed == key) + ldem.schema.raise('ldem:case:missingKey', location(entries(1), ctx), ... + 'time_function = "%s" needs the key "%s".', kind, key); + end +end +args = struct(); +for key = needed + e = pickKey(entries, key); + where = location(e, ctx); + switch key + case "value" + args.value = ldem.schema.parseQuantity(e.value, valueDimension, where); + case "rate" + args.rate = ldem.schema.parseQuantity(e.value, rateDimension, where); + case "until" + args.until = ldem.schema.parseQuantity(e.value, "time", where); + otherwise + if ~(isnumeric(e.value) && ~isempty(e.value)) + ldem.schema.raise('ldem:case:badValue', where, ... + 'Expected a list of numbers (SI units), found %s.', describe(e.value)); + end + args.(key) = reshape(e.value, 1, []); + end +end +try + argList = namedargs2cell(args); + fn = ldem.scenarios.Declarative.makeFunction(kind, argList{:}); +catch err + ldem.schema.raise('ldem:case:badValue', location(pickKey(entries, "time_function"), ctx), ... + '%s', firstLine(err.message)); +end +block = ldem.scenarios.Declarative.makeLoad(selector, direction, type, fn, ... + name = textOf(entries, "name", ctx), reaction = boolOf(entries, "reaction", ctx)); +end + +function selector = readSelector(entries, ctx) +args = struct(); +e = pickKey(entries, "nodes"); +if ~isempty(e) + args.nodes = enumWord(e, ["all" "centre" "grid"], ctx); +end +e = pickKey(entries, "ids"); +if ~isempty(e) + if ~(isnumeric(e.value) && ~isempty(e.value) && all(e.value >= 1) && all(e.value == fix(e.value))) + ldem.schema.raise('ldem:case:badValue', location(e, ctx), ... + 'Expected node numbers (integers >= 1), found %s.', describe(e.value)); + end + args.ids = reshape(e.value, 1, []); +end +for axis = ["x" "y" "z"] + e = pickKey(entries, axis); + if ~isempty(e) + ldem.scenarios.parseCoordinate(e.value, location(e, ctx)); % checks the form + args.(axis) = e.value; + end +end +argList = namedargs2cell(args); +selector = ldem.scenarios.Declarative.makeSelector(argList{:}); +end + +function e = pickKey(entries, key) +%PICKKEY The entry of a key inside one block, or []. +k = find(string({entries.key}) == key, 1); +if isempty(k) + e = []; +else + e = entries(k); +end +end + +function text = textOf(entries, key, ctx) +e = pickKey(entries, key); +if isempty(e) + text = ""; +elseif isstring(e.value) && isscalar(e.value) + text = e.value; +else + ldem.schema.raise('ldem:case:badValue', location(e, ctx), ... + 'Expected a text in quotes, found %s.', describe(e.value)); +end +end + +function flag = boolOf(entries, key, ctx) +e = pickKey(entries, key); +if isempty(e) + flag = false; +elseif islogical(e.value) && isscalar(e.value) + flag = e.value; +else + ldem.schema.raise('ldem:case:badValue', location(e, ctx), ... + 'Expected true or false, found %s.', describe(e.value)); +end +end + function items = readNodeItems(entries, ctx) %READNODEITEMS The [[monitor.node]] elements, as a struct array. items = struct('id', {}, 'at', {}, 'name', {}, 'line', {}); @@ -494,7 +899,7 @@ function checkScatter(entries, schema, ctx) 'Expected a folder name in quotes, found %s.', describe(folder)); end if strlength(folder) > 0 && isempty(regexp(folder, '^([A-Za-z]:|[\\/])', 'once')) - folder = string(fullfile(ctx.folder, folder)); + folder = joinPath(eFolder.folder, folder); end end formats = strings(1, 0); @@ -589,6 +994,9 @@ function checkScatter(entries, schema, ctx) function w = location(e, ctx) %LOCATION "file:line [section] key" for the error messages. w = ctx.source; +if isfield(e, 'file') && e.file ~= "" + w = e.file; +end if e.line > 0 w = w + ":" + string(e.line); end @@ -633,6 +1041,23 @@ function checkScatter(entries, schema, ctx) line = strtok(string(message), newline); end +function p = joinPath(folder, relative) +%JOINPATH Folder plus a relative path, with the "." and ".." parts removed. +full = strrep(string(fullfile(folder, relative)), '/', filesep); +parts = split(full, filesep).'; +kept = strings(1, 0); +for part = parts + if part == "." + continue + elseif part == ".." && ~isempty(kept) && kept(end) ~= "" && ~endsWith(kept(end), ":") + kept(end) = []; + else + kept(end+1) = part; %#ok + end +end +p = strjoin(kept, filesep); +end + function p = absolutePath(path) if isempty(regexp(path, '^([A-Za-z]:|[\\/])', 'once')) p = string(fullfile(pwd, path)); diff --git a/src/+ldem/+io/writeCase.m b/src/+ldem/+io/writeCase.m index 03fe50d..a4245a7 100644 --- a/src/+ldem/+io/writeCase.m +++ b/src/+ldem/+io/writeCase.m @@ -99,7 +99,7 @@ % [material] rows = { - "law", quote("bilinear"), doc("material.law") + "law", quote(params.constitutiveLaw), doc("material.law") "young_modulus", q(params.youngModulus, "pressure"), doc("material.young_modulus") "poisson_ratio", num(params.poissonRatio), doc("material.poisson_ratio") "density", q(params.density, "density"), doc("material.density") @@ -132,12 +132,19 @@ lines = [lines; section("time", rows, withComments)]; % [damping] -rows = { - "type", quote("mass_proportional"), doc("damping.type") - "initial", q(params.dampingInitial, "rate"), doc("damping.initial") - "final", q(params.dampingFinal, "rate"), doc("damping.final") - "switch_time", q(params.dampingSwitchTime, "time"), doc("damping.switch_time") - "constitutive", q(params.constitutiveDamping, "time"), doc("damping.constitutive")}; +dampingSpec = ldem.solver.dampingRegistry(); +dampingSpec = dampingSpec([dampingSpec.name] == lower(params.dampingModel)); +rows = {"type", quote(params.dampingModel), doc("damping.type")}; +if any(dampingSpec.keys == "initial") + rows(end+1, :) = {"initial", q(params.dampingInitial, "rate"), doc("damping.initial")}; +end +if any(dampingSpec.keys == "final") + rows(end+1, :) = {"final", q(params.dampingFinal, "rate"), doc("damping.final")}; +end +if any(dampingSpec.keys == "switch_time") + rows(end+1, :) = {"switch_time", q(params.dampingSwitchTime, "time"), doc("damping.switch_time")}; +end +rows(end+1, :) = {"constitutive", q(params.constitutiveDamping, "time"), doc("damping.constitutive")}; lines = [lines; section("damping", rows, withComments)]; % [scenario] @@ -153,6 +160,14 @@ rows(end+1, :) = {key, valueText, "Property " + prop + " of " + string(class(scenario)) + "."}; %#ok end lines = [lines; section("scenario", rows, withComments)]; +if isa(scenario, 'ldem.scenarios.Declarative') + for j = 1:numel(scenario.supports) + lines = [lines; supportLines(scenario.supports(j), doc, withComments)]; %#ok + end + for j = 1:numel(scenario.loads) + lines = [lines; loadLines(scenario.loads(j), doc, withComments)]; %#ok + end +end % [[monitor.node]] names = options.ControlNodeNames; @@ -216,6 +231,79 @@ end end +function lines = supportLines(b, doc, withComments) +%SUPPORTLINES The [[support]] block of a declarative scenario. +rows = cell(0, 3); +if b.name ~= "" + rows(end+1, :) = {"name", quote(b.name), doc("support.name")}; +end +rows = [rows; selectorRows(b.selector, "support", doc)]; +rows(end+1, :) = {"fix", directionList(b.fix), doc("support.fix")}; +if b.reaction + rows(end+1, :) = {"reaction", "true", doc("support.reaction")}; +end +lines = ["[[support]]"; block(rows, withComments); ""]; +end + +function lines = loadLines(b, doc, withComments) +%LOADLINES The [[load]] block of a declarative scenario. +q = @ldem.schema.formatQuantity; +if b.type == "force" + valueDimension = "force"; + rateDimension = "forcerate"; +else + valueDimension = "length"; + rateDimension = "velocity"; +end +rows = cell(0, 3); +if b.name ~= "" + rows(end+1, :) = {"name", quote(b.name), doc("load.name")}; +end +rows = [rows; selectorRows(b.selector, "load", doc)]; +axisLetters = 'xyz'; +rows(end+1, :) = {"direction", quote(string(axisLetters(b.direction))), doc("load.direction")}; +rows(end+1, :) = {"type", quote(b.type), doc("load.type")}; +rows(end+1, :) = {"time_function", quote(b.fn.type), doc("load.time_function")}; +switch b.fn.type + case "constant" + rows(end+1, :) = {"value", q(b.fn.value, valueDimension), doc("load.value")}; + case "linear" + rows(end+1, :) = {"rate", q(b.fn.rate, rateDimension), doc("load.rate")}; + case "ramp" + rows(end+1, :) = {"rate", q(b.fn.rate, rateDimension), doc("load.rate")}; + rows(end+1, :) = {"until", q(b.fn.until, "time"), doc("load.until")}; + case "table" + rows(end+1, :) = {"times", listText(b.fn.times), doc("load.times")}; + rows(end+1, :) = {"values", listText(b.fn.values), doc("load.values")}; +end +if b.reaction + rows(end+1, :) = {"reaction", "true", doc("load.reaction")}; +end +lines = ["[[load]]"; block(rows, withComments); ""]; +end + +function rows = selectorRows(selector, kind, doc) +%SELECTORROWS Key/value rows of the selector of a block (only what restricts the nodes). +rows = cell(0, 3); +if selector.nodes ~= "all" + rows(end+1, :) = {"nodes", quote(selector.nodes), doc(kind + ".nodes")}; +end +if ~isempty(selector.ids) + rows(end+1, :) = {"ids", listText(selector.ids), doc(kind + ".ids")}; +end +for axis = ["x" "y" "z"] + if ~isempty(selector.(axis)) + rows(end+1, :) = {axis, ldem.scenarios.coordinateText(selector.(axis)), doc(kind + "." + axis)}; %#ok + end +end +end + +function t = directionList(indices) +axisLetters = 'xyz'; +letters = string(num2cell(axisLetters(indices))); +t = "[" + strjoin('"' + letters + '"', ", ") + "]"; +end + function note = docText(row) %DOCTEXT Comment of a key: its description and the legacy variable it replaces. note = string(row.doc); diff --git a/src/+ldem/+io/writeTemplate.m b/src/+ldem/+io/writeTemplate.m index 6a0700a..cf11e05 100644 --- a/src/+ldem/+io/writeTemplate.m +++ b/src/+ldem/+io/writeTemplate.m @@ -7,8 +7,9 @@ % edit. % % text = ldem.io.writeTemplate(path, scenarioName) uses another scenario: -% "uniaxial_tension", "four_point_bending" or "clamped_beam". The keys of -% the [scenario] section are those of that scenario. +% "uniaxial_tension", "four_point_bending", "clamped_beam" or "custom". The +% keys of the [scenario] section are those of that scenario; "custom" writes +% example [[support]] and [[load]] blocks to edit. % % Inputs: % path Path of the file to create ("" to only return the text). @@ -27,9 +28,24 @@ scenarioName (1,1) string = "uniaxial_tension" end -scenario = ldem.scenarios.fromName(scenarioName); +if lower(scenarioName) == "custom" + scenario = sampleCustomScenario(); +else + scenario = ldem.scenarios.fromName(scenarioName); +end params = ldem.Parameters(testId = scenario.testId); text = ldem.io.writeCase(path, params, scenario, ... Title = "New case (template for " + scenarioName + ")", ... Header = "Edit the values; every key has a comment. Units go after the number."); end + +function scenario = sampleCustomScenario() +%SAMPLECUSTOMSCENARIO Example blocks for the template: a prism pulled along x. +left =ldem.scenarios.Declarative.makeSelector(x = 0.5); +right = ldem.scenarios.Declarative.makeSelector(x = "max - 0.5"); +pull = ldem.scenarios.Declarative.makeFunction("linear", rate = -4e-3); +scenario = ldem.scenarios.Declarative( ... + supports = ldem.scenarios.Declarative.makeSupport(left, "x", name = "left end"), ... + loads = ldem.scenarios.Declarative.makeLoad(right, "x", "displacement", pull, ... + name = "right end", reaction = true)); +end diff --git a/src/+ldem/+material/BilinearBarLaw.m b/src/+ldem/+material/BilinearBarLaw.m new file mode 100644 index 0000000..f13ffc3 --- /dev/null +++ b/src/+ldem/+material/BilinearBarLaw.m @@ -0,0 +1,71 @@ +classdef BilinearBarLaw < ldem.material.MaterialLaw + %BILINEARBARLAW Linear elastic in compression, bilinear with softening in tension. + % + % The law of the legacy code: every bar is linear elastic with stiffness + % E1 up to the critical strain EP, then softens linearly down to zero + % force at the rupture strain ER = KR*EP, after which it is broken and + % carries no load. Unloading follows the secant stiffness. The details + % and the history fields are in ldem.material.bilinearLaw (the function + % this class calls); the case-file name is "bilinear". + % + % See also ldem.material.MaterialLaw, ldem.material.bilinearLaw. + + properties (Constant) + name = "bilinear" + end + + methods + function [force, history] = evaluate(~, strain, strainRate, barProps, history, params) + %EVALUATE See ldem.material.bilinearLaw. + [force, history] = ldem.material.bilinearLaw( ... + strain, strainRate, barProps, history, params.constitutiveDamping); + end + + function energy = energies(~, strain, barProps, history, barLength) + %ENERGIES Elastic, damage and broken-bar energy of the bilinear bars. + % + % For a damaged bar with critical strain EP, largest strain EM and + % stiffnesses E1 (compression) and E2 (tension) the energy + % dissipated is L/2 times E1*EP^2 - E2*EM^2 + (E1*EP + E2*EM)*(EM - EP); + % for a broken bar the fracture energy is L/2 * E1*EP^2*KR. + E1 = barProps.stiffness; + E2 = history.tensionStiffness; + stiffness = E1; + stiffness(strain >= 0.0) = E2(strain >= 0.0); + elastic = sum(stiffness .* (strain .* strain .* barLength ./ 2)); + + EP = barProps.criticalStrain; + EM = history.maxStrain; + damaged = ~history.isUndamaged; + area = E1 .* EP .* EP - E2 .* EM .* EM + (E1 .* EP + E2 .* EM) .* (EM - EP); + damage = sum(barLength(damaged) .* area(damaged) ./ 2); + + broken = damaged & ~history.isUnbroken; + brokenBars = sum(E1(broken) .* EP(broken) .* EP(broken) .* barProps.ruptureRatio(broken) ... + .* barLength(broken) ./ 2); + + energy = struct('elastic', elastic, 'damage', damage, 'brokenBars', brokenBars); + end + + function value = barDamageEnergy(~, bar, barProps, history, barLength) + %BARDAMAGEENERGY Energy dissipated by damage in one bar (zero if undamaged). + if history.isUndamaged(bar) + value = 0.0; + return + end + E1 = barProps.stiffness(bar); + E2 = history.tensionStiffness(bar); + EP = barProps.criticalStrain(bar); + EM = history.maxStrain(bar); + area = E1 * EP * EP - E2 * EM * EM + (E1 * EP + E2 * EM) * (EM - EP); + value = barLength(bar) * area / 2; + end + + function stiffness = viscousStiffness(~, strain, barProps, history) + %VISCOUSSTIFFNESS Compression stiffness for compressed bars, tension stiffness otherwise. + isCompressed = strain < 0.0; + stiffness = history.tensionStiffness; + stiffness(isCompressed) = barProps.stiffness(isCompressed); + end + end +end diff --git a/src/+ldem/+material/LinearElasticBarLaw.m b/src/+ldem/+material/LinearElasticBarLaw.m new file mode 100644 index 0000000..574a80c --- /dev/null +++ b/src/+ldem/+material/LinearElasticBarLaw.m @@ -0,0 +1,44 @@ +classdef LinearElasticBarLaw < ldem.material.MaterialLaw + %LINEARELASTICLAW Linear elastic bars that never damage or break. + % + % The force of a bar is E1*strain in tension and in compression, plus the + % viscous term E1*constitutiveDamping*strainRate. There is no softening + % and no rupture, so the damage energy is zero and every bar stays intact. + % It is useful to verify a model against elastic solutions (waves, + % vibration, static deflection) and to separate geometry and loading + % problems from damage. The case-file name is "linear_elastic". + % + % The fracture parameters (fractureEnergy, criticalDistance, + % failureAreaFactor) and the random scatter are still read and computed + % by ldem.material.buildBarProperties, but this law does not use them. + % + % See also ldem.material.MaterialLaw, ldem.material.BilinearBarLaw. + + properties (Constant) + name = "linear_elastic" + end + + methods + function [force, history] = evaluate(~, strain, strainRate, barProps, history, params) + %EVALUATE E1*(strain + constitutiveDamping*strainRate), history unchanged. + force = barProps.stiffness .* strain ... + + barProps.stiffness .* params.constitutiveDamping .* strainRate; + end + + function energy = energies(~, strain, barProps, ~, barLength) + %ENERGIES Sum of E1*strain^2*L/2; no damage and no broken bars. + elastic = sum(barProps.stiffness .* (strain .* strain .* barLength ./ 2)); + energy = struct('elastic', elastic, 'damage', 0, 'brokenBars', 0); + end + + function value = barDamageEnergy(~, ~, ~, ~, ~) + %BARDAMAGEENERGY Always zero. + value = 0.0; + end + + function stiffness = viscousStiffness(~, ~, barProps, ~) + %VISCOUSSTIFFNESS E1 for every bar. + stiffness = barProps.stiffness; + end + end +end diff --git a/src/+ldem/+material/MaterialLaw.m b/src/+ldem/+material/MaterialLaw.m new file mode 100644 index 0000000..afa1fe4 --- /dev/null +++ b/src/+ldem/+material/MaterialLaw.m @@ -0,0 +1,76 @@ +classdef (Abstract) MaterialLaw + %MATERIALLAW Base class of the constitutive laws of the bars. + % + % A law says how the axial force of a bar depends on its strain, its + % strain rate and its history, and how much energy that state stores or + % dissipates. The solver never names a law: it asks the object chosen by + % params.constitutiveLaw (the key "law" of the [material] section of a + % case file). + % + % To add a law: + % 1. Create a subclass in this folder and set the constant property + % name (snake_case, the word used in the case file). + % 2. Implement evaluate, energies, barDamageEnergy and viscousStiffness. + % 3. Add a line to ldem.material.lawRegistry. + % + % What every law can rely on and must respect: + % + % * barProps is the struct of ldem.material.buildBarProperties (stiffness, + % criticalStrain, ruptureStrain, ruptureRatio, ...); history starts as + % its second output. + % * history must always keep the logical fields isUndamaged and + % isUnbroken: the bar counts, the ANSYS and VTK files and the snapshots + % read them. The other fields are private to the law. + % * evaluate is called once per step, with all the bars at once + % (vectors of nBars-by-1), and returns the history after the step. + % + % See also ldem.material.BilinearBarLaw, ldem.material.LinearElasticBarLaw, + % ldem.material.lawRegistry, ldem.material.lawFromName. + + properties (Abstract, Constant) + % Name used in the case file ("bilinear"). + name + end + + methods (Abstract) + % EVALUATE Axial force of every bar and the history after the step. + % + % [force, history] = law.evaluate(strain, strainRate, barProps, history, params) + % + % Inputs: + % strain nBars-by-1 strain (L - L0)/L0, tension positive. + % strainRate nBars-by-1 strain rate [1/s]. + % barProps Struct from ldem.material.buildBarProperties. + % history Struct with the state of every bar before the step. + % params ldem.Parameters (params.constitutiveDamping is the + % viscous coefficient of the law, in s). + % + % Outputs: + % force nBars-by-1 axial force [N], tension positive. + % history The history after the step. + [force, history] = evaluate(obj, strain, strainRate, barProps, history, params) + + % ENERGIES Energies of all the bars, as scalars [J]. + % + % energy = law.energies(strain, barProps, history, barLength) returns a + % struct with the fields + % elastic Strain energy stored in the bars. + % damage Energy dissipated by softening in the damaged bars. + % brokenBars Total fracture energy of the bars that have broken. + energy = energies(obj, strain, barProps, history, barLength) + + % BARDAMAGEENERGY Energy dissipated by damage in one bar [J]. + % + % value = law.barDamageEnergy(bar, barProps, history, barLength) + % for the bar with that number (zero if it is undamaged). + value = barDamageEnergy(obj, bar, barProps, history, barLength) + + % VISCOUSSTIFFNESS Stiffness of every bar in the viscous term [N]. + % + % stiffness = law.viscousStiffness(strain, barProps, history) is the + % stiffness E that multiplies the strain rate in the force of the law, + % E*constitutiveDamping*strainRate; the solver uses it to account for + % the energy dissipated by that term. + stiffness = viscousStiffness(obj, strain, barProps, history) + end +end diff --git a/src/+ldem/+material/lawFromName.m b/src/+ldem/+material/lawFromName.m new file mode 100644 index 0000000..ab5aa3a --- /dev/null +++ b/src/+ldem/+material/lawFromName.m @@ -0,0 +1,30 @@ +function law = lawFromName(name) +%LAWFROMNAME Create the constitutive-law object with a name used in the case files. +% +% law = ldem.material.lawFromName(name) returns an instance of the class +% registered under name in ldem.material.lawRegistry. +% +% Input: +% name Law name, for example "bilinear" (case is ignored). +% +% Output: +% law Object of a subclass of ldem.material.MaterialLaw. +% +% Errors: +% ldem:material:unknownLaw No law has that name. +% +% See also ldem.material.lawRegistry, ldem.material.MaterialLaw. + +arguments + name (1,1) string +end + +reg = ldem.material.lawRegistry(); +k = find([reg.name] == lower(name), 1); +if isempty(k) + error('ldem:material:unknownLaw', ... + 'There is no constitutive law named "%s".%s Available: %s.', name, ... + ldem.schema.suggest(name, [reg.name]), strjoin([reg.name], ', ')); +end +law = feval(reg(k).className); +end diff --git a/src/+ldem/+material/lawRegistry.m b/src/+ldem/+material/lawRegistry.m new file mode 100644 index 0000000..1ed734e --- /dev/null +++ b/src/+ldem/+material/lawRegistry.m @@ -0,0 +1,31 @@ +function reg = lawRegistry() +%LAWREGISTRY List of the available constitutive laws. +% +% reg = ldem.material.lawRegistry() returns one element per law class. It is +% the only place to edit to register a new law: ldem.material.lawFromName, +% the validation of ldem.Parameters and the case-file reader all read it. +% +% Fields of every element: +% +% name Word used in the case file, "law = ..." (snake_case). +% className Class, a subclass of ldem.material.MaterialLaw. +% description One line for the messages and the documentation. +% +% Output: +% reg Struct array. +% +% Example: +% [ldem.material.lawRegistry().name] % "bilinear" "linear_elastic" +% +% See also ldem.material.MaterialLaw, ldem.material.lawFromName. + +reg = struct('name', {}, 'className', {}, 'description', {}); +reg(end+1) = makeEntry("bilinear", "ldem.material.BilinearBarLaw", ... + "Linear elastic, softening in tension down to rupture (legacy law)"); +reg(end+1) = makeEntry("linear_elastic", "ldem.material.LinearElasticBarLaw", ... + "Linear elastic, no damage and no rupture"); +end + +function entry = makeEntry(name, className, description) +entry = struct('name', name, 'className', className, 'description', description); +end diff --git a/src/+ldem/+mesh/buildMesh.m b/src/+ldem/+mesh/buildMesh.m index 12963c2..f47ef06 100644 --- a/src/+ldem/+mesh/buildMesh.m +++ b/src/+ldem/+mesh/buildMesh.m @@ -22,6 +22,7 @@ % barBoundaryFaces nBars-by-1 prism faces a grid edge lies on (0, 1 or 2) % barLength nBars-by-1 initial lengths [m] % barCentres nBars-by-3 midpoints [m] +% scenarioData (only if the scenario has any) data prepared by scenario.prepare % % Example: % params = ldem.Parameters(testId=101, nModules=[6 3 3]); @@ -48,6 +49,10 @@ mesh.nodes0 = nodes; mesh.nGridNodes = prod(params.nModules); mesh.fixed = scenario.fixedDofs(nodes, params); +scenarioData = scenario.prepare(nodes, mesh.fixed, params); +if ~isempty(fieldnames(scenarioData)) + mesh.scenarioData = scenarioData; +end mesh.mass = ldem.mesh.computeNodalMasses(params.nModules, ... params.moduleLength, params.density); [mesh.bars, mesh.barType, mesh.barBoundaryFaces] = ldem.mesh.buildBars(params.nModules); diff --git a/src/+ldem/+scenarios/Declarative.m b/src/+ldem/+scenarios/Declarative.m new file mode 100644 index 0000000..9d2126b --- /dev/null +++ b/src/+ldem/+scenarios/Declarative.m @@ -0,0 +1,339 @@ +classdef Declarative < ldem.scenarios.Scenario + %DECLARATIVE A test defined by supports and loads instead of by a class (type "custom"). + % + % The built-in scenarios (ldem.scenarios.UniaxialTension, ...) are fixed + % tests. This one is assembled from blocks, which is what the + % [[support]] and [[load]] sections of a case file read, so a new test is + % written as text, without programming: + % + % support Holds some degrees of freedom of the selected nodes at their + % initial position (a clamp, a roller, a symmetry plane). + % load Acts on one direction of the selected nodes, either as a force + % (N) or as a prescribed displacement (m, measured from the + % initial position). The value is a function of time: + % constant, linear, ramp or table (ldem.scenarios.timeFunction). + % + % Nodes are selected by kind ("all", "grid", "centre"), by number, and by + % coordinate ranges in modules, with the references min, max and mid + % (ldem.scenarios.selectNodes). A degree of freedom with a prescribed + % displacement is held by the solver, like the loaded nodes of the other + % tests. A block can ask to be part of the reaction: the reaction of the + % test is then, for each direction, the sum of the bar forces on the + % degrees of freedom of the blocks that asked for it; without any, the + % reaction is NaN. + % + % Build the blocks with the static methods makeSelector, makeSupport, + % makeLoad and makeFunction. For example, a beam clamped at z = 0.5 and + % pushed by a force that grows for 0.35 ms: + % + % import ldem.scenarios.Declarative + % end1 = Declarative.makeSelector(z = 0.5); + % mid = Declarative.makeSelector(y = 0.5, z = "mid - 0.5"); + % ramp = Declarative.makeFunction("ramp", rate = 1000, until = 3.5e-4); + % support = Declarative.makeSupport(end1, "xyz", reaction = true); + % load = Declarative.makeLoad(mid, "y", "force", ramp); + % scenario = Declarative(supports = support, loads = load); + % + % Selections use the regular lattice, so they do not change when the mesh + % is perturbed. A block that selects no node is an error + % (ldem:scenarios:noNodesSelected). + % + % See also ldem.scenarios.Scenario, ldem.scenarios.selectNodes, + % ldem.scenarios.timeFunction, ldem.scenarios.registry. + + properties (Constant) + testId = 900 + end + + properties + % Struct row of the supports, from makeSupport (fields name, selector, fix, reaction). + supports (1,:) struct = ldem.scenarios.Declarative.emptySupports() + + % Struct row of the loads, from makeLoad (fields name, selector, direction, type, fn, reaction). + loads (1,:) struct = ldem.scenarios.Declarative.emptyLoads() + end + + methods + function obj = Declarative(props) + %DECLARATIVE Create the scenario from lists of supports and loads. + arguments + props.?ldem.scenarios.Declarative + end + names = fieldnames(props); + for k = 1:numel(names) + obj.(names{k}) = props.(names{k}); + end + obj.check(); + end + + function check(obj) + %CHECK Verify the structure of the supports and loads. + % + % Throws ldem:scenarios:badDefinition when a block is malformed. + supportFields = ["name" "selector" "fix" "reaction"]; + loadFields = ["name" "selector" "direction" "type" "fn" "reaction"]; + if ~isempty(obj.supports) && ~isequal(sort(string(fieldnames(obj.supports)).'), sort(supportFields)) + error('ldem:scenarios:badDefinition', ... + 'supports must be built with Declarative.makeSupport (fields %s).', strjoin(supportFields, ', ')); + end + if ~isempty(obj.loads) && ~isequal(sort(string(fieldnames(obj.loads)).'), sort(loadFields)) + error('ldem:scenarios:badDefinition', ... + 'loads must be built with Declarative.makeLoad (fields %s).', strjoin(loadFields, ', ')); + end + end + + function fixed = fixedDofs(obj, nodes0, params) + %FIXEDDOFS Degrees of freedom held by the supports and by the displacement loads. + arguments + obj (1,1) ldem.scenarios.Declarative + nodes0 (:,3) double + params (1,1) ldem.Parameters + end + lattice = ldem.mesh.buildNodes(params.nModules, params.moduleLength); + fixed = false(size(nodes0)); + for k = 1:numel(obj.supports) + block = obj.supports(k); + mask = obj.select(block, "support", k, params, lattice); + fixed(mask, block.fix) = true; + end + for k = 1:numel(obj.loads) + block = obj.loads(k); + if block.type == "displacement" + mask = obj.select(block, "load", k, params, lattice); + fixed(mask, block.direction) = true; + end + end + end + + function data = prepare(obj, nodes0, ~, params) + %PREPARE Nodes of every load and of the reaction, found once. + % + % Returns a struct with loadNodes (cell, the node numbers of each + % load), reactionNodes (1-by-3 cell, the nodes whose force is + % summed in each direction) and hasReaction. + lattice = ldem.mesh.buildNodes(params.nModules, params.moduleLength); + loadNodes = cell(1, numel(obj.loads)); + marked = false(size(nodes0)); + for k = 1:numel(obj.supports) + block = obj.supports(k); + if block.reaction + mask = obj.select(block, "support", k, params, lattice); + marked(mask, block.fix) = true; + end + end + for k = 1:numel(obj.loads) + block = obj.loads(k); + mask = obj.select(block, "load", k, params, lattice); + loadNodes{k} = find(mask); + if block.reaction + marked(mask, block.direction) = true; + end + end + data = struct('loadNodes', {loadNodes}, ... + 'reactionNodes', {{find(marked(:, 1)), find(marked(:, 2)), find(marked(:, 3))}}, ... + 'hasReaction', any(marked, 'all')); + end + + function state = applyLoads(obj, state, mesh, params) + %APPLYLOADS Set the forces and the prescribed displacements of the current time. + arguments + obj (1,1) ldem.scenarios.Declarative + state (1,1) struct + mesh (1,1) struct + params (1,1) ldem.Parameters + end + if isempty(obj.loads) + return + end + data = obj.dataOf(mesh, params); + hasForce = false; + for k = 1:numel(obj.loads) + hasForce = hasForce || obj.loads(k).type == "force"; + end + if hasForce + state.appliedForce(:) = 0; + end + for k = 1:numel(obj.loads) + block = obj.loads(k); + nodes = data.loadNodes{k}; + value = ldem.scenarios.timeFunction(block.fn, state.time); + if block.type == "force" + state.appliedForce(nodes, block.direction) = state.appliedForce(nodes, block.direction) + value; + else + state.displacement(nodes, block.direction) = mesh.nodes0(nodes, block.direction) + value; + end + end + end + + function reaction = reactions(obj, state, mesh, params) + %REACTIONS Sum of the bar forces on the degrees of freedom marked with reaction = true. + arguments + obj (1,1) ldem.scenarios.Declarative + state (1,1) struct + mesh (1,1) struct + params (1,1) ldem.Parameters + end + data = obj.dataOf(mesh, params); + if ~data.hasReaction + reaction = NaN(1, 3); + return + end + reaction = zeros(1, 3); + for direction = 1:3 + reaction(direction) = sum(state.force(data.reactionNodes{direction}, direction)); + end + end + end + + methods (Access = private) + function mask = select(~, block, kind, index, params, lattice) + %SELECT Selected nodes of a block; an empty selection is an error. + mask = ldem.scenarios.selectNodes(block.selector, params, lattice); + if ~any(mask) + label = "[[" + kind + "]] number " + string(index); + if block.name ~= "" + label = label + " (""" + block.name + """)"; + end + message = sprintf(['The %s matches no node. The prism has %d x %d x %d modules; ' ... + 'positions are in modules (centre nodes lie at half-integer positions ' ... + 'such as 0.5, grid nodes at integers), and "min", "max" and "mid" refer ' ... + 'to the ends and the middle of the prism.'], label, params.nModules - 1); + error('ldem:scenarios:noNodesSelected', '%s', message); + end + end + + function data = dataOf(obj, mesh, params) + if isfield(mesh, 'scenarioData') && isfield(mesh.scenarioData, 'loadNodes') + data = mesh.scenarioData; + else + data = obj.prepare(mesh.nodes0, mesh.fixed, params); + end + end + end + + methods (Static) + function selector = makeSelector(options) + %MAKESELECTOR Selector of nodes for a support or a load. + % + % selector = Declarative.makeSelector(Name=Value) with + % + % nodes "all" (default), "grid" or "centre". + % ids Node numbers. + % x, y, z Coordinate or range in modules, see + % ldem.scenarios.parseCoordinate: 0.5, "max - 0.5", + % [0 5]. + arguments + options.nodes (1,1) string {mustBeMember(options.nodes, ["all" "grid" "centre"])} = "all" + options.ids (1,:) double {mustBeInteger, mustBePositive} = zeros(1, 0) + options.x = [] + options.y = [] + options.z = [] + end + selector = struct('nodes', options.nodes, 'ids', options.ids, ... + 'x', coordinate(options.x), 'y', coordinate(options.y), 'z', coordinate(options.z)); + end + + function block = makeSupport(selector, fix, options) + %MAKESUPPORT Support block: the directions in fix are held. + % + % support = Declarative.makeSupport(selector, fix, Name=Value). fix + % is the directions to hold, as text ("xyz", "x", "xz") or a + % string array (["x" "z"]). Options: name (label) and reaction + % (true to include the block in the reaction of the test). + arguments + selector (1,1) struct + fix (1,:) string + options.name (1,1) string = "" + options.reaction (1,1) logical = false + end + block = struct('name', options.name, 'selector', selector, ... + 'fix', directions(fix), 'reaction', options.reaction); + end + + function block = makeLoad(selector, direction, type, fn, options) + %MAKELOAD Load block: a force or a displacement along one direction. + % + % load = Declarative.makeLoad(selector, direction, type, fn, Name=Value) + % with direction "x", "y" or "z", type "force" or "displacement", + % fn from Declarative.makeFunction. Options: name and reaction. + arguments + selector (1,1) struct + direction (1,1) string {mustBeMember(direction, ["x" "y" "z"])} + type (1,1) string {mustBeMember(type, ["force" "displacement"])} + fn (1,1) struct + options.name (1,1) string = "" + options.reaction (1,1) logical = false + end + block = struct('name', options.name, 'selector', selector, ... + 'direction', directions(direction), 'type', type, 'fn', fn, ... + 'reaction', options.reaction); + end + + function fn = makeFunction(type, options) + %MAKEFUNCTION Time function of a load, see ldem.scenarios.timeFunction. + % + % fn = Declarative.makeFunction("constant", value=...) + % fn = Declarative.makeFunction("linear", rate=...) + % fn = Declarative.makeFunction("ramp", rate=..., until=...) + % fn = Declarative.makeFunction("table", times=[...], values=[...]) + % + % All in SI units (N or m, N/s or m/s, s). + arguments + type (1,1) string {mustBeMember(type, ["constant" "linear" "ramp" "table"])} + options.value (1,1) double {mustBeFinite} = 0 + options.rate (1,1) double {mustBeFinite} = 0 + options.until (1,1) double {mustBePositive} = Inf + options.times (1,:) double {mustBeFinite} = zeros(1, 0) + options.values (1,:) double {mustBeFinite} = zeros(1, 0) + end + if type == "ramp" && ~isfinite(options.until) + error('ldem:scenarios:badDefinition', 'A ramp needs the time "until" at which it stops growing.'); + end + if type == "table" + if numel(options.times) < 2 || numel(options.times) ~= numel(options.values) ... + || any(diff(options.times) <= 0) + error('ldem:scenarios:badDefinition', ... + ['A table needs at least two strictly increasing times and one value per ' ... + 'time (got %d times and %d values).'], numel(options.times), numel(options.values)); + end + end + fn = struct('type', type, 'value', options.value, 'rate', options.rate, ... + 'until', options.until, 'times', options.times, 'values', options.values); + end + + function s = emptySupports() + %EMPTYSUPPORTS Zero supports. + s = repmat(struct('name', "", 'selector', [], 'fix', [], 'reaction', false), 1, 0); + end + + function s = emptyLoads() + %EMPTYLOADS Zero loads. + s = repmat(struct('name', "", 'selector', [], 'direction', [], 'type', "", 'fn', [], 'reaction', false), 1, 0); + end + end +end + +function range = coordinate(value) +if isempty(value) + range = []; +else + range = ldem.scenarios.parseCoordinate(value); +end +end + +function indices = directions(text) +%DIRECTIONS Direction letters ("xz" or ["x" "z"]) as column indices 1..3. +letters = char(join(text, "")); +indices = zeros(1, 0); +for c = lower(letters) + k = find('xyz' == c, 1); + if isempty(k) + error('ldem:scenarios:badDefinition', 'Directions are x, y and z, got "%s".', c); + end + indices(end+1) = k; %#ok +end +indices = unique(indices); +if isempty(indices) + error('ldem:scenarios:badDefinition', 'At least one direction (x, y or z) is needed.'); +end +end diff --git a/src/+ldem/+scenarios/Scenario.m b/src/+ldem/+scenarios/Scenario.m index 420b893..1fea1dc 100644 --- a/src/+ldem/+scenarios/Scenario.m +++ b/src/+ldem/+scenarios/Scenario.m @@ -55,6 +55,17 @@ end methods + function data = prepare(obj, nodes0, fixed, params) %#ok + %PREPARE Data that depends only on the mesh, computed once. + % + % data = scenario.prepare(nodes0, fixed, params) is called once by + % ldem.mesh.buildMesh; a non-empty struct is stored in + % mesh.scenarioData so that applyLoads and reactions do not have to + % find the loaded nodes again at every step. The default is an empty + % struct (nothing to prepare). + data = struct(); + end + function reaction = reactions(obj, state, mesh, params) %#ok %REACTIONS Reaction force of the test as [Rx Ry Rz] [N]. % diff --git a/src/+ldem/+scenarios/coordinateText.m b/src/+ldem/+scenarios/coordinateText.m new file mode 100644 index 0000000..32cf36b --- /dev/null +++ b/src/+ldem/+scenarios/coordinateText.m @@ -0,0 +1,55 @@ +function text = coordinateText(range) +%COORDINATETEXT Write a coordinate range as it appears in a case file. +% +% text = ldem.scenarios.coordinateText(range) is the inverse of +% ldem.scenarios.parseCoordinate: 0.5, "max - 0.5", [0, 5] or +% ["min + 0.5", "max - 0.5"]. The text can be written after "x = ". +% +% Input: +% range Struct with lo and hi, from ldem.scenarios.parseCoordinate. +% +% Output: +% text String scalar. +% +% Example: +% r = ldem.scenarios.parseCoordinate("mid - 0.5"); +% ldem.scenarios.coordinateText(r) % "mid - 0.5" (with quotes) +% +% See also ldem.scenarios.parseCoordinate. + +arguments + range (1,1) struct +end + +if isequal(range.lo, range.hi) + text = scalarText(range.lo); + return +end +if range.lo.base == "" && range.hi.base == "" + text = "[" + ldem.schema.shortestText(range.lo.offset) + ", " ... + + ldem.schema.shortestText(range.hi.offset) + "]"; +else + text = "[" + quoted(range.lo) + ", " + quoted(range.hi) + "]"; +end +end + +function text = scalarText(spec) +if spec.base == "" + text = ldem.schema.shortestText(spec.offset); +else + text = quoted(spec); +end +end + +function text = quoted(spec) +if spec.base == "" + body = ldem.schema.shortestText(spec.offset); +elseif spec.offset == 0 + body = spec.base; +elseif spec.offset > 0 + body = spec.base + " + " + ldem.schema.shortestText(spec.offset); +else + body = spec.base + " - " + ldem.schema.shortestText(-spec.offset); +end +text = '"' + body + '"'; +end diff --git a/src/+ldem/+scenarios/parseCoordinate.m b/src/+ldem/+scenarios/parseCoordinate.m new file mode 100644 index 0000000..97e1bcb --- /dev/null +++ b/src/+ldem/+scenarios/parseCoordinate.m @@ -0,0 +1,84 @@ +function range = parseCoordinate(value, where) +%PARSECOORDINATE Read a coordinate or a range of coordinates, in modules. +% +% range = ldem.scenarios.parseCoordinate(value) converts what a case file +% gives for the key x, y or z of a [[support]] or [[load]] block into the +% range of positions it selects. The value is +% +% * a number, in modules: 0.5 (a plane of nodes); +% * a text with a number: "0.5" or "0.5 modules"; +% * a text with a reference to the prism, "min", "max" or "mid", and an +% optional offset: "max - 0.5", "mid", "min + 1" (min is 0, max is the +% length of the prism along that axis in modules, mid is half of it); +% * a pair of any of the above, [lo, hi], for the nodes in between (all +% numbers, or all texts). +% +% Inputs: +% value Number, text, or a 2-element numeric or string array. +% where Optional location text for the error messages. +% +% Output: +% range Struct with the fields lo and hi (equal for a single value). Each +% is a struct with base ("", "min", "max" or "mid") and offset +% (modules). +% +% Errors: +% ldem:case:badValue The value is not one of the forms above. +% +% Example: +% r = ldem.scenarios.parseCoordinate("max - 0.5"); +% r.lo.base % "max" +% r.lo.offset % -0.5 +% +% See also ldem.scenarios.coordinateText, ldem.scenarios.selectNodes. + +arguments + value + where (1,1) string = "" +end + +if numel(value) == 1 + range = struct('lo', parseOne(value, where), 'hi', parseOne(value, where)); +elseif numel(value) == 2 && (isnumeric(value) || isstring(value)) + range = struct('lo', parseOne(value(1), where), 'hi', parseOne(value(2), where)); +else + ldem.schema.raise('ldem:case:badValue', where, ... + 'Expected a coordinate or a pair [lo, hi] in modules.'); +end +end + +function spec = parseOne(value, where) +if isnumeric(value) && isscalar(value) && isfinite(value) + spec = struct('base', "", 'offset', double(value)); + return +end +if ~(isstring(value) && isscalar(value)) + ldem.schema.raise('ldem:case:badValue', where, ... + 'Expected a number or a text such as "max - 0.5" (modules).'); +end +text = regexprep(lower(strtrim(value)), '\s*modules?$', ''); +number = '[+-]?(?:\d+\.?\d*|\.\d+)(?:e[+-]?\d+)?'; +reference = regexp(text, '^(min|max|mid)(.*)$', 'tokens', 'once'); +if ~isempty(reference) + base = string(reference{1}); + rest = strtrim(string(reference{2})); + offset = 0; + if rest ~= "" + parts = regexp(rest, ['^([+-])\s*(' number ')$'], 'tokens', 'once'); + if isempty(parts) + ldem.schema.raise('ldem:case:badValue', where, ... + '"%s" is not a coordinate; use "min", "max" or "mid" with an optional offset ("max - 0.5").', value); + end + offset = str2double(parts{2}); + if parts{1} == "-" + offset = -offset; + end + end + spec = struct('base', base, 'offset', offset); +elseif ~isempty(regexp(text, ['^' number '$'], 'once')) + spec = struct('base', "", 'offset', str2double(text)); +else + ldem.schema.raise('ldem:case:badValue', where, ... + '"%s" is not a coordinate; use a number or "min", "max" or "mid" with an optional offset ("max - 0.5").', value); +end +end diff --git a/src/+ldem/+scenarios/registry.m b/src/+ldem/+scenarios/registry.m index 8e548e6..353a375 100644 --- a/src/+ldem/+scenarios/registry.m +++ b/src/+ldem/+scenarios/registry.m @@ -33,6 +33,8 @@ struct('loadingVelocity', "velocity", 'supportPosition', "modules", ... 'loadPosition', "modules"), struct()); +reg(end+1) = makeEntry("custom", "ldem.scenarios.Declarative", 900, struct(), struct()); + reg(end+1) = makeEntry("clamped_beam", "ldem.scenarios.ClampedBeam", 103, ... struct('forceRate', "forcerate", 'rampTime', "time", ... 'loadPosition', "modules", 'loadHeight', "modules"), ... diff --git a/src/+ldem/+scenarios/selectNodes.m b/src/+ldem/+scenarios/selectNodes.m new file mode 100644 index 0000000..5d37af0 --- /dev/null +++ b/src/+ldem/+scenarios/selectNodes.m @@ -0,0 +1,84 @@ +function mask = selectNodes(selector, params, nodes) +%SELECTNODES Nodes picked by the selector of a [[support]] or [[load]] block. +% +% mask = ldem.scenarios.selectNodes(selector, params) returns an nNodes-by-1 +% logical vector. The selector is a struct with the fields nodes, ids, x, y +% and z: +% +% nodes "all", "grid" (corners of the modules) or "centre" (middle of each module). +% ids Row of node numbers; empty for no restriction. +% x A range from ldem.scenarios.parseCoordinate, or [] for no restriction (same for y and z). +% +% Positions are in modules, within 0.01 modules. +% +% A node is selected when it passes every restriction. The positions are +% those of the regular lattice, even when the mesh is perturbed, so a +% selection does not depend on the random displacement of the nodes. In the +% lattice the grid nodes are at integer positions and the centre nodes at +% half-integer ones, for example the first layer of centre nodes along z is +% z = 0.5. +% +% Inputs: +% selector Struct as above. +% params ldem.Parameters (nModules and moduleLength). +% nodes Optional nNodes-by-3 coordinates of the regular lattice [m] (default: ldem.mesh.buildNodes). +% +% Output: +% mask nNodes-by-1 logical. +% +% Example: +% sel = ldem.scenarios.Declarative.makeSelector(nodes="centre", x=0.5); +% mask = ldem.scenarios.selectNodes(sel, ldem.Parameters()); +% +% See also ldem.scenarios.Declarative, ldem.scenarios.parseCoordinate. + +arguments + selector (1,1) struct + params (1,1) ldem.Parameters + nodes = [] +end + +if isempty(nodes) + nodes = ldem.mesh.buildNodes(params.nModules, params.moduleLength); +end +nNodes = size(nodes, 1); +nGrid = prod(params.nModules); + +mask = true(nNodes, 1); +switch selector.nodes + case "grid" + mask(nGrid+1:end) = false; + case "centre" + mask(1:nGrid) = false; +end +if ~isempty(selector.ids) + mask = mask & ismember((1:nNodes).', selector.ids); +end + +extent = params.nModules - 1; % length of the prism in modules +tolerance = 0.01; +axisNames = ["x" "y" "z"]; +for k = 1:3 + range = selector.(axisNames(k)); + if isempty(range) + continue + end + lo = resolve(range.lo, extent(k)); + hi = resolve(range.hi, extent(k)); + position = nodes(:, k) / params.moduleLength; + mask = mask & position >= lo - tolerance & position <= hi + tolerance; +end +end + +function value = resolve(spec, extent) +switch spec.base + case "min" + value = spec.offset; + case "max" + value = extent + spec.offset; + case "mid" + value = extent / 2 + spec.offset; + otherwise + value = spec.offset; +end +end diff --git a/src/+ldem/+scenarios/timeFunction.m b/src/+ldem/+scenarios/timeFunction.m new file mode 100644 index 0000000..e4323f3 --- /dev/null +++ b/src/+ldem/+scenarios/timeFunction.m @@ -0,0 +1,50 @@ +function value = timeFunction(fn, t) +%TIMEFUNCTION Value of a load at time t. +% +% value = ldem.scenarios.timeFunction(fn, t) evaluates the time function of +% a [[load]] block. fn is a struct whose field type selects the function: +% +% constant value +% linear rate*t +% ramp rate*min(t, until): grows at rate until the time "until", then stays constant +% table piecewise-linear interpolation of values at times; the end values are kept outside +% +% The result is in newtons for a force load and in metres (the movement from +% the initial position) for a displacement load. +% +% Inputs: +% fn Struct with the fields type, value, rate, until, times and values. +% t Time [s]. +% +% Output: +% value Scalar. +% +% Errors: +% ldem:scenarios:badTimeFunction The type is not one of the above. +% +% Example: +% fn = ldem.scenarios.Declarative.makeFunction("ramp", rate=1000, until=3.5e-4); +% ldem.scenarios.timeFunction(fn, 1e-3) % 0.35 N +% +% See also ldem.scenarios.Declarative. + +arguments + fn (1,1) struct + t (1,1) double +end + +switch fn.type + case "constant" + value = fn.value; + case "linear" + value = fn.rate * t; + case "ramp" + value = fn.rate * min(t, fn.until); + case "table" + clamped = min(max(t, fn.times(1)), fn.times(end)); + value = interp1(fn.times, fn.values, clamped, 'linear'); + otherwise + error('ldem:scenarios:badTimeFunction', ... + 'Unknown time function "%s"; use constant, linear, ramp or table.', fn.type); +end +end diff --git a/src/+ldem/+schema/caseSchema.m b/src/+ldem/+schema/caseSchema.m index 58e560b..c4cc3a5 100644 --- a/src/+ldem/+schema/caseSchema.m +++ b/src/+ldem/+schema/caseSchema.m @@ -37,6 +37,10 @@ "Free text title of the case.", "" "authors", "stringlist", "number", "", false, "", ... "Names of the authors.", "" + "extends", "stringlist", "number", "", false, "", ... + "Case file(s) to inherit from; the keys of this file replace the inherited ones.", "" + "sweep_mode", "enum", "number", "", false, "", ... + "How several [[sweep]] blocks combine: all combinations (product) or one by one (zip).", "product|zip" "mesh.module_size", "quantity", "length", "moduleLength", false, "LCO", ... "Edge length of each cubic module.", "" @@ -47,8 +51,9 @@ "mesh.seed", "integer", "number", "seed", false, "SEED", ... "Seed of the mesh perturbation (the random field has its own seed).", "" - "material.law", "enum", "number", "", false, "", ... - "Constitutive law of the bars.", "bilinear" + "material.law", "enum", "number", "constitutiveLaw", false, "", ... + "Constitutive law of the bars (see ldem.material.lawRegistry).", ... + strjoin([ldem.material.lawRegistry().name], "|") "material.young_modulus", "quantity", "pressure", "youngModulus", false, "YNG", ... "Young's modulus.", "" "material.poisson_ratio", "number", "number", "poissonRatio", false, "PSN", ... @@ -80,8 +85,9 @@ "time.duration", "quantity", "time", "totalTime", true, "TTOT", ... "Total simulated time.", "" - "damping.type", "enum", "number", "", false, "", ... - "Damping model.", "mass_proportional" + "damping.type", "enum", "number", "dampingModel", false, "", ... + "Damping model of the nodes (see ldem.solver.dampingRegistry).", ... + strjoin([ldem.solver.dampingRegistry().name], "|") "damping.initial", "quantity", "rate", "dampingInitial", false, "DF1", ... "Mass-proportional damping before switch_time.", "" "damping.final", "quantity", "rate", "dampingFinal", false, "DF2", ... @@ -94,6 +100,59 @@ "scenario.type", "enum", "number", "", true, "TEST", ... "Test case (see ldem.scenarios.registry); its other keys follow.", "" + "support.name", "string", "number", "", false, "", ... + "Label of the support.", "" + "support.nodes", "enum", "number", "", false, "", ... + "Kind of nodes: all, grid (module corners) or centre (module centres).", "all|centre|grid" + "support.ids", "intlist", "number", "", false, "", ... + "Node numbers to select.", "" + "support.x", "coordinate", "number", "", false, "", ... + "Positions along x in modules: 0.5, ""max - 0.5"" or a range [lo, hi].", "" + "support.y", "coordinate", "number", "", false, "", ... + "Positions along y in modules (see x).", "" + "support.z", "coordinate", "number", "", false, "", ... + "Positions along z in modules (see x).", "" + "support.fix", "stringlist", "number", "", false, "", ... + "Directions held at their initial position: [""x"", ""y"", ""z""].", "" + "support.reaction", "bool", "number", "", false, "", ... + "Include the force on the held directions in the reaction of the test.", "" + + "load.name", "string", "number", "", false, "", ... + "Label of the load.", "" + "load.nodes", "enum", "number", "", false, "", ... + "Kind of nodes: all, grid (module corners) or centre (module centres).", "all|centre|grid" + "load.ids", "intlist", "number", "", false, "", ... + "Node numbers to select.", "" + "load.x", "coordinate", "number", "", false, "", ... + "Positions along x in modules: 0.5, ""max - 0.5"" or a range [lo, hi].", "" + "load.y", "coordinate", "number", "", false, "", ... + "Positions along y in modules (see x).", "" + "load.z", "coordinate", "number", "", false, "", ... + "Positions along z in modules (see x).", "" + "load.direction", "enum", "number", "", false, "", ... + "Direction of the load.", "x|y|z" + "load.type", "enum", "number", "", false, "", ... + "force (N on each selected node) or displacement (m from the initial position).", "force|displacement" + "load.time_function", "enum", "number", "", false, "", ... + "How the value changes with time.", "constant|linear|ramp|table" + "load.value", "loadQuantity", "number", "", false, "", ... + "constant: the value (N or m).", "" + "load.rate", "loadQuantity", "number", "", false, "", ... + "linear and ramp: change per second (N/s or m/s).", "" + "load.until", "quantity", "time", "", false, "", ... + "ramp: time at which it stops growing.", "" + "load.times", "numberlist", "number", "", false, "", ... + "table: increasing times in seconds.", "" + "load.values", "numberlist", "number", "", false, "", ... + "table: one value per time (N or m).", "" + "load.reaction", "bool", "number", "", false, "", ... + "Include the force on the loaded direction in the reaction of the test.", "" + + "sweep.key", "string", "number", "", false, "", ... + "Key to vary, for example ""material.fracture_energy"" (see ldem.sweep).", "" + "sweep.values", "numberlist", "number", "", false, "", ... + "Values to try: numbers, or texts with units such as [""0.1 N/m"", ""0.5 N/m""].", "" + "monitor.node.id", "integer", "number", "", false, "NCON", ... "Number of a node whose motion is recorded.", "" "monitor.node.at", "numberlist", "number", "", false, "", ... diff --git a/src/+ldem/+schema/unitTable.m b/src/+ldem/+schema/unitTable.m index 7350522..73ea955 100644 --- a/src/+ldem/+schema/unitTable.m +++ b/src/+ldem/+schema/unitTable.m @@ -15,6 +15,7 @@ % toughness N/m, kN/m (fracture energy) % velocity m/s, mm/s % forcerate N/s, kN/s +% force N, kN, MN % modules modules (length in module lengths) % number no unit % @@ -62,6 +63,9 @@ case "forcerate" names = ["N/s" "kN/s"]; exps = [0 3]; + case "force" + names = ["N" "kN" "MN"]; + exps = [0 3 6]; case "modules" names = "modules"; exps = 0; diff --git a/src/+ldem/+schema/writeKeyReference.m b/src/+ldem/+schema/writeKeyReference.m new file mode 100644 index 0000000..50b8d79 --- /dev/null +++ b/src/+ldem/+schema/writeKeyReference.m @@ -0,0 +1,175 @@ +function text = writeKeyReference(path) +%WRITEKEYREFERENCE Write the reference of the case-file keys, generated from the schema. +% +% text = ldem.schema.writeKeyReference(path) builds the tables of keys that the +% user guide includes (docs/source/case-keys.inc): one table per section with +% the key, the kind of value and its units, the default, the variable of the +% legacy DATA0.DAT it replaces and the description. Everything comes from +% ldem.schema.caseSchema and the defaults of ldem.Parameters, so the guide +% cannot disagree with the reader. The text is reStructuredText. +% +% After changing the schema, regenerate the file from the repository root: +% +% ldem.schema.writeKeyReference("docs/source/case-keys.inc"); +% +% A test compares the file with the generated text and fails when they differ. +% +% Input: +% path File to write ("" to only return the text). +% +% Output: +% text The reStructuredText, a string scalar. +% +% See also ldem.schema.caseSchema, ldem.io.writeTemplate. + +arguments + path (1,1) string = "" +end + +schema = ldem.schema.caseSchema(); +defaults = ldem.Parameters(); +arrayTables = ["monitor.node" "support" "load" "sweep"]; + +lines = [ + ".. This file is generated by ldem.schema.writeKeyReference from ldem.schema.caseSchema." + ".. Do not edit it by hand: change the schema and generate it again." + ""]; + +paths = string({schema.path}); +sections = strings(size(paths)); +for k = 1:numel(paths) + dot = find(char(paths(k)) == '.', 1, 'last'); + if isempty(dot) + sections(k) = ""; + else + sections(k) = extractBefore(paths(k), dot); + end +end + +for section = unique(sections, 'stable') + if section == "" + title = "(top level)"; + elseif any(section == arrayTables) + title = "[[" + section + "]]"; + else + title = "[" + section + "]"; + end + lines = [lines; ".. rubric:: ``" + title + "``"; ""; ... + ".. list-table::"; " :header-rows: 1"; " :widths: 18 24 12 8 38"; ""; ... + " * - Key"; " - Value"; " - Default"; " - Legacy"; " - Description"]; %#ok + for k = find(sections == section) + row = schema(k); + key = extractAfter(paths(k), strlength(section) + double(section ~= "")); + legacy = string(row.legacy); + if legacy == "" + legacy = "(none)"; + end + lines = [lines; ... + " * - ``" + key + "``"; ... + " - " + escape(valueText(row)); ... + " - " + escape(defaultText(row, defaults)); ... + " - " + escape(legacy); ... + " - " + escape(string(row.doc))]; %#ok + end + lines = [lines; ""]; %#ok +end + +text = strjoin(lines, newline); +text = regexprep(text, '\n+$', '') + newline; +if strlength(path) > 0 + fid = fopen(path, 'w', 'n', 'UTF-8'); + if fid == -1 + error('ldem:io:cannotOpenFile', 'Cannot create "%s".', path); + end + fprintf(fid, '%s', text); + fclose(fid); +end +end + +function t = valueText(row) +switch string(row.kind) + case "integer" + t = "integer"; + case "number" + t = "number"; + case "quantity" + names = ldem.schema.unitTable(string(row.dimension)); + t = "number + unit (" + strjoin(names, ", ") + ")"; + case "string" + t = "text"; + case "stringlist" + t = "list of texts"; + case "path" + t = "file path"; + case "intlist" + t = "list of integers"; + case "numberlist" + t = "list of numbers"; + case "bool" + t = "true or false"; + case "enum" + t = strjoin(split(string(row.choices), "|").', ", "); + case "stepOrAuto" + t = "time, or auto"; + case "cadence" + t = "steps or time (0 = never)"; + case "coordinate" + t = "modules: number, text or [lo, hi]"; + case "loadQuantity" + t = "N, N/s, m or m/s, by type"; + otherwise + t = string(row.kind); +end +end + +function t = defaultText(row, defaults) +manual = struct( ... + 'material_scatter_type', '"none"', 'support_nodes', '"all"', 'load_nodes', '"all"', ... + 'time_step', '"auto"', 'output_mat', 'true', 'output_ansys', 'false', 'output_vtk', 'false', ... + 'output_folder', 'no files', 'sweep_mode', '"product"', 'support_reaction', 'false', ... + 'load_reaction', 'false', 'monitor_bar_tracked', 'off', 'format', '1'); +name = strrep(string(row.path), ".", "_"); +if row.required + t = "required"; +elseif isfield(manual, name) + t = string(manual.(name)); +elseif string(row.prop) ~= "" && isprop(defaults, row.prop) + if string(row.kind) == "cadence" + value = defaults.output.(row.prop); + else + value = defaults.(row.prop); + end + t = formatDefault(row, value); +else + t = "(none)"; +end +end + +function t = formatDefault(row, value) +switch string(row.kind) + case "quantity" + t = ldem.schema.formatQuantity(value, string(row.dimension)); + case "cadence" + if value == 0 + t = "0"; + else + t = string(value) + " steps"; + end + case {"enum", "string", "path"} + if strlength(string(value)) == 0 + t = "(none)"; + else + t = '"' + string(value) + '"'; + end + case "numberlist" + t = "[" + strjoin(arrayfun(@ldem.schema.shortestText, value), ", ") + "]"; + otherwise + t = ldem.schema.shortestText(double(value)); +end +end + +function t = escape(s) +%ESCAPE Make a text safe inside a reStructuredText table cell. +t = replace(replace(string(s), "\", "\\"), "_", "\_"); +t = replace(replace(t, "*", "\*"), "|", "\|"); +end diff --git a/src/+ldem/+solver/DampingModel.m b/src/+ldem/+solver/DampingModel.m new file mode 100644 index 0000000..6bb9983 --- /dev/null +++ b/src/+ldem/+solver/DampingModel.m @@ -0,0 +1,32 @@ +classdef (Abstract) DampingModel + %DAMPINGMODEL Base class of the damping models of the nodes. + % + % The integrator damps the motion of every node with the term + % c*m*velocity, where c [1/s] may change from step to step. A damping + % model only has to return c for a step. The solver asks the object chosen + % by params.dampingModel (the key "type" of the [damping] section of a case + % file). + % + % To add a model: + % 1. Create a subclass in this folder and set the constant property name + % (snake_case, the word used in the case file). + % 2. Implement coefficient. + % 3. Add a line to ldem.solver.dampingRegistry, with the keys of the + % [damping] section that the model uses. + % + % See also ldem.solver.MassProportionalDamping, ldem.solver.NoDamping, + % ldem.solver.dampingRegistry, ldem.solver.integrateStep. + + properties (Abstract, Constant) + % Name used in the case file ("mass_proportional"). + name + end + + methods (Abstract) + % COEFFICIENT Mass-proportional damping coefficient of a step [1/s]. + % + % c = model.coefficient(step, params), with step = 1, 2, ... and + % params an ldem.Parameters (the model reads the parameters it needs). + c = coefficient(obj, step, params) + end +end diff --git a/src/+ldem/+solver/MassProportionalDamping.m b/src/+ldem/+solver/MassProportionalDamping.m new file mode 100644 index 0000000..436ce30 --- /dev/null +++ b/src/+ldem/+solver/MassProportionalDamping.m @@ -0,0 +1,21 @@ +classdef MassProportionalDamping < ldem.solver.DampingModel + %MASSPROPORTIONALDAMPING Constant coefficient that switches once (legacy damping). + % + % The coefficient is params.dampingInitial before the switch step and + % params.dampingFinal from then on, see ldem.solver.dampingCoefficient. The + % case-file name is "mass_proportional", with the keys initial, final and + % switch_time. + % + % See also ldem.solver.DampingModel, ldem.solver.dampingCoefficient. + + properties (Constant) + name = "mass_proportional" + end + + methods + function c = coefficient(~, step, params) + %COEFFICIENT dampingInitial before the switch, dampingFinal after. + c = ldem.solver.dampingCoefficient(step, params); + end + end +end diff --git a/src/+ldem/+solver/NoDamping.m b/src/+ldem/+solver/NoDamping.m new file mode 100644 index 0000000..54a61cd --- /dev/null +++ b/src/+ldem/+solver/NoDamping.m @@ -0,0 +1,21 @@ +classdef NoDamping < ldem.solver.DampingModel + %NODAMPING No damping of the nodes (c = 0). + % + % For free vibration and wave problems. The viscous term inside the law + % (params.constitutiveDamping) is independent and still applies. The + % case-file name is "none"; the keys initial, final and switch_time of + % [damping] do not apply. + % + % See also ldem.solver.DampingModel. + + properties (Constant) + name = "none" + end + + methods + function c = coefficient(~, ~, ~) + %COEFFICIENT Always zero. + c = 0; + end + end +end diff --git a/src/+ldem/+solver/computeBarForces.m b/src/+ldem/+solver/computeBarForces.m index b4eb311..7ad5156 100644 --- a/src/+ldem/+solver/computeBarForces.m +++ b/src/+ldem/+solver/computeBarForces.m @@ -1,4 +1,4 @@ -function state = computeBarForces(state, mesh, barProps, params) +function state = computeBarForces(state, mesh, barProps, params, law) %COMPUTEBARFORCES Axial force of every bar and resulting nodal forces. % % state = ldem.solver.computeBarForces(state, mesh, barProps, params) @@ -17,6 +17,7 @@ % mesh Struct from ldem.mesh.buildMesh. % barProps Struct from ldem.material.buildBarProperties. % params ldem.Parameters. +% law Optional ldem.material.MaterialLaw (default: the one named by params.constitutiveLaw). % % Output: % state The input state with force, strain, strainRate, axialForce and @@ -28,13 +29,18 @@ % % Legacy: CABAR. % -% See also ldem.material.bilinearLaw, ldem.solver.integrateStep. +% See also ldem.material.MaterialLaw, ldem.material.bilinearLaw, ldem.solver.integrateStep. arguments state (1,1) struct mesh (1,1) struct barProps (1,1) struct params (1,1) ldem.Parameters + law = [] +end + +if isempty(law) + law = ldem.material.lawFromName(params.constitutiveLaw); end first = mesh.bars(:, 1); @@ -61,8 +67,7 @@ oldStrain = (previousLength - initialLength) ./ initialLength; strainRate = (strain - oldStrain) / params.dt; -[axialForce, history] = ldem.material.bilinearLaw( ... - strain, strainRate, barProps, state.history, params.constitutiveDamping); +[axialForce, history] = law.evaluate(strain, strainRate, barProps, state.history, params); % Add the bar forces to the nodes. The contributions are listed bar by bar % (start node +, end node -) so that, for every node, they are summed in the diff --git a/src/+ldem/+solver/computeEnergies.m b/src/+ldem/+solver/computeEnergies.m index 775ce33..c79c933 100644 --- a/src/+ldem/+solver/computeEnergies.m +++ b/src/+ldem/+solver/computeEnergies.m @@ -1,8 +1,10 @@ -function energy = computeEnergies(state, mesh, barProps, params) +function energy = computeEnergies(state, mesh, barProps, params, law) %COMPUTEENERGIES Energies of the system at the current state. % % energy = ldem.solver.computeEnergies(state, mesh, barProps, params) -% returns the energies [J], all of them scalars. +% returns the energies [J], all of them scalars. The elastic, damage and +% broken-bar energies come from the constitutive law (ldem.material.MaterialLaw, +% by default the one named by params.constitutiveLaw; pass another as law). % % Fields of energy: % @@ -65,30 +67,21 @@ mesh (1,1) struct barProps (1,1) struct params (1,1) ldem.Parameters + law = [] +end + +if isempty(law) + law = ldem.material.lawFromName(params.constitutiveLaw); end % Kinetic energy. kinetic = sum(ldem.solver.nodalKineticEnergy(state, mesh)); -% Elastic energy of the bars. -E1 = barProps.stiffness; -E2 = state.history.tensionStiffness; -strain = state.strain; -stiffness = E1; -stiffness(strain >= 0.0) = E2(strain >= 0.0); -elastic = sum(stiffness .* (strain .* strain .* mesh.barLength ./ 2)); - -% Energy dissipated by damage. -EP = barProps.criticalStrain; -EM = state.history.maxStrain; -damaged = ~state.history.isUndamaged; -area = E1 .* EP .* EP - E2 .* EM .* EM + (E1 .* EP + E2 .* EM) .* (EM - EP); -damage = sum(mesh.barLength(damaged) .* area(damaged) ./ 2); - -% Fracture energy of the bars that are completely broken. -broken = damaged & ~state.history.isUnbroken; -brokenBars = sum(E1(broken) .* EP(broken) .* EP(broken) .* barProps.ruptureRatio(broken) ... - .* mesh.barLength(broken) ./ 2); +% Elastic, damage and fracture energy of the bars: they depend on the law. +barEnergy = law.energies(state.strain, barProps, state.history, mesh.barLength); +elastic = barEnergy.elastic; +damage = barEnergy.damage; +brokenBars = barEnergy.brokenBars; energy = struct(); energy.time = state.time; diff --git a/src/+ldem/+solver/dampingFromName.m b/src/+ldem/+solver/dampingFromName.m new file mode 100644 index 0000000..b085eae --- /dev/null +++ b/src/+ldem/+solver/dampingFromName.m @@ -0,0 +1,30 @@ +function model = dampingFromName(name) +%DAMPINGFROMNAME Create the damping-model object with a name used in the case files. +% +% model = ldem.solver.dampingFromName(name) returns an instance of the class +% registered under name in ldem.solver.dampingRegistry. +% +% Input: +% name Model name, for example "mass_proportional" (case is ignored). +% +% Output: +% model Object of a subclass of ldem.solver.DampingModel. +% +% Errors: +% ldem:solver:unknownDamping No model has that name. +% +% See also ldem.solver.dampingRegistry, ldem.solver.DampingModel. + +arguments + name (1,1) string +end + +reg = ldem.solver.dampingRegistry(); +k = find([reg.name] == lower(name), 1); +if isempty(k) + error('ldem:solver:unknownDamping', ... + 'There is no damping model named "%s".%s Available: %s.', name, ... + ldem.schema.suggest(name, [reg.name]), strjoin([reg.name], ', ')); +end +model = feval(reg(k).className); +end diff --git a/src/+ldem/+solver/dampingRegistry.m b/src/+ldem/+solver/dampingRegistry.m new file mode 100644 index 0000000..c9cc498 --- /dev/null +++ b/src/+ldem/+solver/dampingRegistry.m @@ -0,0 +1,33 @@ +function reg = dampingRegistry() +%DAMPINGREGISTRY List of the available damping models. +% +% reg = ldem.solver.dampingRegistry() returns one element per damping class. +% It is the only place to edit to register a new model: ldem.solver.dampingFromName, +% the validation of ldem.Parameters and the case-file reader all read it. +% +% Fields of every element: +% +% name Word used in the case file, "type = ..." in [damping]. +% className Class, a subclass of ldem.solver.DampingModel. +% description One line for the messages and the documentation. +% keys Keys of [damping] the model uses (the others are an error in a case file): initial, final, switch_time. +% +% Output: +% reg Struct array. +% +% Example: +% [ldem.solver.dampingRegistry().name] % "mass_proportional" "none" +% +% See also ldem.solver.DampingModel, ldem.solver.dampingFromName. + +reg = struct('name', {}, 'className', {}, 'description', {}, 'keys', {}); +reg(end+1) = makeEntry("mass_proportional", "ldem.solver.MassProportionalDamping", ... + "Constant coefficient that switches once (legacy damping)", ... + ["initial" "final" "switch_time"]); +reg(end+1) = makeEntry("none", "ldem.solver.NoDamping", ... + "No damping of the nodes", strings(1, 0)); +end + +function entry = makeEntry(name, className, description, keys) +entry = struct('name', name, 'className', className, 'description', description, 'keys', keys); +end diff --git a/src/+ldem/+solver/integrateStep.m b/src/+ldem/+solver/integrateStep.m index e169c28..7464fa0 100644 --- a/src/+ldem/+solver/integrateStep.m +++ b/src/+ldem/+solver/integrateStep.m @@ -1,4 +1,4 @@ -function state = integrateStep(state, mesh, barProps, params) +function state = integrateStep(state, mesh, barProps, params, law, damping) %INTEGRATESTEP Advance the node positions one time step. % % state = ldem.solver.integrateStep(state, mesh, barProps, params) solves @@ -47,6 +47,8 @@ % mesh Struct from ldem.mesh.buildMesh (mass, fixed, barLength). % barProps Struct from ldem.material.buildBarProperties. % params ldem.Parameters. +% law Optional ldem.material.MaterialLaw (default: params.constitutiveLaw). +% damping Optional ldem.solver.DampingModel (default: params.dampingModel). % % Output: % state Updated: displacement, previousDisplacement, velocity, @@ -60,13 +62,22 @@ % used a wrong index (V(2,I) instead of V(2,:)); here it is computed like % the other two components. % -% See also ldem.solver.computeBarForces, ldem.solver.dampingCoefficient. +% See also ldem.solver.computeBarForces, ldem.solver.DampingModel, ldem.material.MaterialLaw. arguments state (1,1) struct mesh (1,1) struct barProps (1,1) struct params (1,1) ldem.Parameters + law = [] + damping = [] +end + +if isempty(law) + law = ldem.material.lawFromName(params.constitutiveLaw); +end +if isempty(damping) + damping = ldem.solver.dampingFromName(params.dampingModel); end if any(mesh.mass == 0) @@ -77,7 +88,7 @@ ddt = 2.0 * dt; sdt = dt * dt; -c = ldem.solver.dampingCoefficient(state.step, params); +c = damping.coefficient(state.step, params); dampingPrevious = 1.0 - c * dt / 2.0; dampingNext = 1.0 + c * dt / 2.0; @@ -97,9 +108,7 @@ dissipated = sum(nodeDamping, 'all'); % Energy dissipated by the viscous term of the constitutive law. -isCompressed = state.strain < 0.0; -stiffness = state.history.tensionStiffness; -stiffness(isCompressed) = barProps.stiffness(isCompressed); +stiffness = law.viscousStiffness(state.strain, barProps, state.history); barViscous = 2.0 * (stiffness .* params.constitutiveDamping .* state.strainRate .* ... state.strainRate .* dt .* mesh.barLength ./ 2.0); dissipated = dissipated + sum(barViscous); diff --git a/src/+ldem/+solver/simulate.m b/src/+ldem/+solver/simulate.m index 1e7e415..2888b84 100644 --- a/src/+ldem/+solver/simulate.m +++ b/src/+ldem/+solver/simulate.m @@ -70,6 +70,8 @@ end ldem.solver.checkStability(mesh.barLength, params); +law = ldem.material.lawFromName(params.constitutiveLaw); +damping = ldem.solver.dampingFromName(params.dampingModel); nSteps = params.nSteps; controlEvery = params.output.controlNodesEvery; @@ -113,8 +115,8 @@ state.time = state.time + params.dt; state = scenario.applyLoads(state, mesh, params); - state = ldem.solver.computeBarForces(state, mesh, barProps, params); - state = ldem.solver.integrateStep(state, mesh, barProps, params); + state = ldem.solver.computeBarForces(state, mesh, barProps, params, law); + state = ldem.solver.integrateStep(state, mesh, barProps, params, law, damping); if ~all(isfinite(state.displacement), 'all') error('ldem:solver:nonFinite', ... @@ -122,7 +124,7 @@ 'step may be unstable or two nodes coincide.'], step, state.time); end - energy = ldem.solver.computeEnergies(state, mesh, barProps, params); + energy = ldem.solver.computeEnergies(state, mesh, barProps, params, law); state.previousDamageEnergy = energy.damage; if controlEvery > 0 && mod(step, controlEvery) == 0 @@ -150,7 +152,7 @@ record.trackedBar.criticalStrain(step) = barProps.criticalStrain(b); record.trackedBar.ruptureStrain(step) = barProps.ruptureStrain(b); record.trackedBar.force(step) = state.axialForce(b); - record.trackedBar.damageEnergy(step) = trackedDamageEnergy(state, mesh, barProps, b); + record.trackedBar.damageEnergy(step) = law.barDamageEnergy(b, barProps, state.history, mesh.barLength); end if snapshotEvery > 0 && mod(step, snapshotEvery) == 0 && ~isempty(options.SnapshotFcn) @@ -162,17 +164,3 @@ end end end - -function value = trackedDamageEnergy(state, mesh, barProps, b) -%TRACKEDDAMAGEENERGY Energy dissipated by damage in one bar (zero if undamaged). -if state.history.isUndamaged(b) - value = 0.0; - return -end -E1 = barProps.stiffness(b); -E2 = state.history.tensionStiffness(b); -EP = barProps.criticalStrain(b); -EM = state.history.maxStrain(b); -area = E1 * EP * EP - E2 * EM * EM + (E1 * EP + E2 * EM) * (EM - EP); -value = mesh.barLength(b) * area / 2; -end diff --git a/src/+ldem/Parameters.m b/src/+ldem/Parameters.m index bf1b55a..6cb20ef 100644 --- a/src/+ldem/Parameters.m +++ b/src/+ldem/Parameters.m @@ -57,6 +57,16 @@ % the stiffness [s]. Legacy: CON. constitutiveDamping (1,1) double {mustBeNonnegative, mustBeFinite} = 0 + % Constitutive law of the bars: a name of ldem.material.lawRegistry + % ("bilinear", the legacy law, or "linear_elastic"). Checked by + % validate(). + constitutiveLaw (1,1) string = "bilinear" + + % Damping model of the nodes: a name of ldem.solver.dampingRegistry + % ("mass_proportional", the legacy damping, or "none"). Checked by + % validate(). + dampingModel (1,1) string = "mass_proportional" + % Integration time step [s]. Legacy: DT. dt (1,1) double {mustBePositive, mustBeFinite} = 2e-7 @@ -180,6 +190,18 @@ function validate(obj) 'poissonRatio must be smaller than 0.5, got %g.', obj.poissonRatio); end + % The law and the damping model must be registered. + if ~any([ldem.material.lawRegistry().name] == lower(obj.constitutiveLaw)) + error('ldem:params:unknownLaw', ... + 'constitutiveLaw "%s" does not exist. Available: %s.', obj.constitutiveLaw, ... + strjoin([ldem.material.lawRegistry().name], ', ')); + end + if ~any([ldem.solver.dampingRegistry().name] == lower(obj.dampingModel)) + error('ldem:params:unknownDampingModel', ... + 'dampingModel "%s" does not exist. Available: %s.', obj.dampingModel, ... + strjoin([ldem.solver.dampingRegistry().name], ', ')); + end + % Control nodes must exist and be few. if numel(obj.controlNodes) > 10 error('ldem:params:tooManyControlNodes', ... diff --git a/src/+ldem/run.m b/src/+ldem/run.m index 087be6f..9f62025 100644 --- a/src/+ldem/run.m +++ b/src/+ldem/run.m @@ -13,6 +13,7 @@ % OutputFolder Other output folder ("" writes nothing). % Formats Other files to write, for example "mat". % Verbose Print the progress (default true). +% Overrides Struct array (fields path = "section.key" and value) that replaces keys of the case. % % To make the run reproducible, results.info.case keeps % @@ -20,6 +21,8 @@ % sha256 SHA-256 hash of the file that was read (text, 64 hex digits). % original Text of that file. % resolved Complete case with every default and the overrides, as ldem.io.writeCase writes it. +% parents Struct array (source, sha256) of the case files inherited through extends. +% overrides Text lines "key = value" of the Overrides option. % % and, when files are written, the resolved case is also saved as % "case.ldem" in the output folder, so a result folder can be run again with @@ -41,9 +44,15 @@ options.OutputFolder = [] options.Formats = [] options.Verbose (1,1) logical = true + options.Overrides = [] end -c = ldem.io.readCase(casePath); +c = ldem.io.readCase(casePath, Overrides = options.Overrides); +if ~isempty(c.info.sweep) && isempty(options.Overrides) + warning('ldem:run:sweepIgnored', ... + '%s defines a sweep of %d key(s); ldem.run runs only the base case. Use ldem.sweep to run them all.', ... + casePath, numel(c.info.sweep)); +end folder = c.options.OutputFolder; formats = c.options.Formats; if ~isempty(options.OutputFolder) @@ -63,8 +72,16 @@ ControlNodeNames = c.info.controlNodeNames, ... Header = "Resolved from " + c.info.source + " by ldem.run.", ... Formats = resolvedFormats); +parents = struct('source', {}, 'sha256', {}); +for parent = c.info.parents.' + parents(end+1) = struct('source', parent, 'sha256', sha256Of(string(fileread(parent)))); %#ok +end +overrideLines = strings(0, 1); +for k = 1:numel(options.Overrides) + overrideLines(end+1, 1) = string(options.Overrides(k).path) + " = " + string(options.Overrides(k).value); %#ok +end caseInfo = struct('source', c.info.source, 'sha256', sha256Of(original), ... - 'original', original, 'resolved', resolved); + 'original', original, 'resolved', resolved, 'parents', parents, 'overrides', overrideLines); results = ldem.runSimulation(c.params, Scenario = c.scenario, ... OutputFolder = folder, Formats = formats, Verbose = options.Verbose, ... diff --git a/src/+ldem/sweep.m b/src/+ldem/sweep.m new file mode 100644 index 0000000..6c7a987 --- /dev/null +++ b/src/+ldem/sweep.m @@ -0,0 +1,195 @@ +function [summary, results] = sweep(casePath, options) +%SWEEP Run a case once for every combination of values of some keys. +% +% summary = ldem.sweep(casePath) runs the case file once for each value of the +% keys listed in its [[sweep]] blocks and returns a table with one row per run: +% +% [[sweep]] +% key = "material.fracture_energy" +% values = ["0.1 N/m", "0.5 N/m", "1 N/m"] +% +% [[sweep]] +% key = "scenario.force_rate" +% values = ["1 kN/s", "2 kN/s"] +% +% Several blocks give every combination (3 x 2 = 6 runs); with sweep_mode = +% "zip" they are taken one by one instead (all lists must have the same +% length). A key can be any single-valued key of the case file, or a key of the +% scenario ("scenario."); values are numbers or texts with units, as in +% the file. Every run is validated before the first one starts, so a bad value +% stops the sweep at once. +% +% Each run writes its files to /run_001, run_002, ... with the +% resolved case as case.ldem, and the table is saved as sweep_summary.csv in +% OutputFolder. A run that fails is recorded in the table (status "failed", +% with the message) and the sweep goes on. +% +% Inputs: +% casePath Path of the case file. +% +% Name-value options: +% Vary Cell {key1, values1, key2, values2, ...} with more keys to vary besides the [[sweep]] blocks. +% Mode "product" or "zip" (default: sweep_mode of the file, product). +% OutputFolder Folder of the runs (default "_sweep" next to the file). +% Formats Files to write in each run, for example "mat" (default: the ones of the case). +% Verbose Print one line per run (default true). +% DryRun Only validate and list the runs, without running them. +% KeepResults Return the results struct of every run as the second output. +% +% Outputs: +% summary Table: run, one column per varied key, folder, status, message, seconds, damagedBars, brokenBars. +% results Cell with the results of each run (empty cells unless KeepResults). +% +% Errors: +% ldem:sweep:noKeys There is nothing to vary. +% ldem:sweep:zipLengths The lists have different lengths in zip mode. +% ldem:sweep:invalidRun A combination makes an invalid case. +% +% Example: +% summary = ldem.sweep("examples/sweeps/fracture_energy.ldem"); +% plot(summary.material_fracture_energy, summary.brokenBars) +% +% See also ldem.run, ldem.io.readCase. + +arguments + casePath (1,1) string + options.Vary = {} + options.Mode (1,1) string {mustBeMember(options.Mode, ["" "product" "zip"])} = "" + options.OutputFolder = [] + options.Formats = [] + options.Verbose (1,1) logical = true + options.DryRun (1,1) logical = false + options.KeepResults (1,1) logical = false +end + +base = ldem.io.readCase(casePath); +blocks = base.info.sweep; +extra = options.Vary; +if ~iscell(extra) || mod(numel(extra), 2) ~= 0 + error('ldem:sweep:invalidRun', 'Vary must be a cell {key1, values1, key2, values2, ...}.'); +end +for k = 1:2:numel(extra) + values = extra{k + 1}; + if isnumeric(values) + items = num2cell(reshape(values, 1, [])); + else + items = num2cell(reshape(string(values), 1, [])); + end + blocks(end+1) = struct('key', string(extra{k}), 'values', {items}); %#ok +end +if isempty(blocks) + error('ldem:sweep:noKeys', ... + 'There is nothing to vary: add [[sweep]] blocks to the case file or use the Vary option.'); +end +mode = base.info.sweepMode; +if options.Mode ~= "" + mode = options.Mode; +end + +combinations = combine(blocks, mode); % nRuns-by-nKeys indices into the lists +nRuns = size(combinations, 1); +keys = string({blocks.key}); + +if isempty(options.OutputFolder) + [folder, name] = fileparts(base.info.source); + outputBase = string(fullfile(folder, name + "_sweep")); +else + outputBase = string(options.OutputFolder); +end + +% Build and validate every run before running any. +overrides = cell(nRuns, 1); +for r = 1:nRuns + list = struct('path', {}, 'value', {}); + for k = 1:numel(keys) + list(end+1) = struct('path', keys(k), 'value', blocks(k).values(combinations(r, k))); %#ok + end + overrides{r} = list; + try + ldem.io.readCase(casePath, Overrides = list); + catch err + error('ldem:sweep:invalidRun', 'Run %d (%s) is not a valid case: %s', ... + r, describe(list), err.message); + end +end + +summary = table((1:nRuns).', 'VariableNames', {'run'}); +for k = 1:numel(keys) + column = strings(nRuns, 1); + for r = 1:nRuns + column(r) = string(overrides{r}(k).value); + end + summary.(matlab.lang.makeValidName(replace(keys(k), ".", "_"))) = column; +end +summary.folder = strings(nRuns, 1); +summary.status = repmat("planned", nRuns, 1); +summary.message = strings(nRuns, 1); +summary.seconds = NaN(nRuns, 1); +summary.damagedBars = NaN(nRuns, 1); +summary.brokenBars = NaN(nRuns, 1); +results = cell(nRuns, 1); + +if options.DryRun + summary.folder = outputBase + filesep + compose("run_%03d", (1:nRuns).'); + return +end + +for r = 1:nRuns + runFolder = outputBase + filesep + compose("run_%03d", r); + summary.folder(r) = runFolder; + if options.Verbose + fprintf('Run %d of %d: %s\n', r, nRuns, describe(overrides{r})); + end + timer = tic; + try + runResults = ldem.run(casePath, Overrides = overrides{r}, OutputFolder = runFolder, ... + Formats = options.Formats, Verbose = false); + summary.status(r) = "done"; + summary.damagedBars(r) = nnz(~runResults.final.damage.isUndamaged); + summary.brokenBars(r) = nnz(~runResults.final.damage.isUnbroken); + if options.KeepResults + results{r} = runResults; + end + catch err + summary.status(r) = "failed"; + summary.message(r) = string(strtok(err.message, newline)); + if options.Verbose + fprintf(' failed: %s\n', summary.message(r)); + end + end + summary.seconds(r) = toc(timer); +end + +if ~isfolder(outputBase) + mkdir(outputBase); +end +writetable(summary, fullfile(outputBase, "sweep_summary.csv")); +end + +function combinations = combine(blocks, mode) +%COMBINE Index of the value of every key in each run. +lengths = arrayfun(@(b) numel(b.values), blocks); +if mode == "zip" + if any(lengths ~= lengths(1)) + error('ldem:sweep:zipLengths', ... + 'In zip mode all the lists must have the same length, got %s.', mat2str(lengths)); + end + combinations = repmat((1:lengths(1)).', 1, numel(blocks)); +else + ranges = arrayfun(@(n) 1:n, lengths, 'UniformOutput', false); + grids = cell(1, numel(blocks)); + [grids{:}] = ndgrid(ranges{:}); + combinations = zeros(numel(grids{1}), numel(blocks)); + for k = 1:numel(blocks) + combinations(:, k) = grids{k}(:); + end +end +end + +function text = describe(list) +parts = strings(1, numel(list)); +for k = 1:numel(list) + parts(k) = string(list(k).path) + " = " + string(list(k).value); +end +text = strjoin(parts, ", "); +end diff --git a/tests/tools/TestHalfStiffnessLaw.m b/tests/tools/TestHalfStiffnessLaw.m new file mode 100644 index 0000000..c24a36f --- /dev/null +++ b/tests/tools/TestHalfStiffnessLaw.m @@ -0,0 +1,32 @@ +classdef TestHalfStiffnessLaw < ldem.material.MaterialLaw + %TESTHALFSTIFFNESSLAW A constitutive law that is not in the registry (for the tests). + % + % The force of a bar is half of the linear elastic one, E1*strain/2. The + % tests pass an object of this class to the solver to check that a new law + % plugs in without touching the solver. + % + % See also ldem.material.MaterialLaw. + + properties (Constant) + name = "half_stiffness" + end + + methods + function [force, history] = evaluate(~, strain, ~, barProps, history, ~) + force = 0.5 * barProps.stiffness .* strain; + end + + function energy = energies(~, strain, barProps, ~, barLength) + elastic = sum(0.5 * barProps.stiffness .* (strain .* strain .* barLength ./ 2)); + energy = struct('elastic', elastic, 'damage', 0, 'brokenBars', 0); + end + + function value = barDamageEnergy(~, ~, ~, ~, ~) + value = 0; + end + + function stiffness = viscousStiffness(~, ~, barProps, ~) + stiffness = 0.5 * barProps.stiffness; + end + end +end diff --git a/tests/unit/TestDeclarative.m b/tests/unit/TestDeclarative.m new file mode 100644 index 0000000..22ac695 --- /dev/null +++ b/tests/unit/TestDeclarative.m @@ -0,0 +1,373 @@ +classdef TestDeclarative < LdemTestCase + %TESTDECLARATIVE Unit tests of the declarative scenario ([[support]] and [[load]] blocks). + + properties (Access = private) + Folder (1,1) string + end + + methods (TestMethodSetup) + function makeFolder(testCase) + testCase.Folder = string(testCase.applyFixture( ... + matlab.unittest.fixtures.TemporaryFolderFixture).Folder); + end + end + + methods (Access = private) + function path = writeCase(testCase, scenarioLines, extra) + % A small case whose [scenario] section is scenarioLines. + if nargin < 3 + extra = strings(0, 1); + end + path = fullfile(testCase.Folder, "custom.ldem"); + writeTextFile(path, [ ... + "format = 1" + "[mesh]" + "module_size = 3 mm" + "modules = [5, 2, 2]" + "[time]" + "step = 0.2 us" + "duration = 20 us" + string(extra(:)) + "[scenario]" + string(scenarioLines(:))]); + end + + function verifyCaseError(testCase, scenarioLines, id, fragment) + path = testCase.writeCase(scenarioLines); + try + ldem.io.readCase(path); + testCase.verifyFail("An error was expected for: " + strjoin(string(scenarioLines), " / ")); + catch err + testCase.verifyEqual(string(err.identifier), string(id)); + testCase.verifySubstring(err.message, fragment); + end + end + end + + methods (Test, TestTags = {'Unit'}) + function coordinatesAreParsedInEveryForm(testCase) + parse = @ldem.scenarios.parseCoordinate; + r = parse(0.5); + testCase.verifyEqual(r.lo, struct('base', "", 'offset', 0.5)); + testCase.verifyEqual(r.hi, r.lo); + r = parse("max - 0.5"); + testCase.verifyEqual(r.lo, struct('base', "max", 'offset', -0.5)); + r = parse(" MID "); + testCase.verifyEqual(r.lo, struct('base', "mid", 'offset', 0)); + r = parse("min + 1.5 modules"); + testCase.verifyEqual(r.lo, struct('base', "min", 'offset', 1.5)); + r = parse("2.5 modules"); + testCase.verifyEqual(r.lo, struct('base', "", 'offset', 2.5)); + r = parse([0 5]); + testCase.verifyEqual([r.lo.offset r.hi.offset], [0 5]); + r = parse(["min + 0.5" "max - 0.5"]); + testCase.verifyEqual([r.lo.base r.hi.base], ["min" "max"]); + end + + function badCoordinatesAreRefused(testCase) + for bad = {"maximum", "max * 2", "max -", "abc", [1 2 3], "", Inf} + testCase.verifyError(@() ldem.scenarios.parseCoordinate(bad{1}), 'ldem:case:badValue'); + end + end + + function coordinateTextRoundTrips(testCase) + for value = {0.5, "max - 0.5", "mid", "min + 1", [0 5], ["min + 0.5" "max - 0.5"], 2.25} + range = ldem.scenarios.parseCoordinate(value{1}); + text = ldem.scenarios.coordinateText(range); + testCase.verifyEqual(ldem.scenarios.parseCoordinate(testCase.evaluate(text)), range); + end + testCase.verifyEqual(ldem.scenarios.coordinateText(ldem.scenarios.parseCoordinate("max - 0.5")), """max - 0.5"""); + testCase.verifyEqual(ldem.scenarios.coordinateText(ldem.scenarios.parseCoordinate(0.5)), "0.5"); + end + + function selectionByKindIdsAndCoordinates(testCase) + p = ldem.Parameters(nModules = [6 3 3]); % 5 x 2 x 2 modules, 54 grid + 20 centre nodes + sel = @(varargin) ldem.scenarios.Declarative.makeSelector(varargin{:}); + select = @(s) ldem.scenarios.selectNodes(s, p); + + testCase.verifyEqual(nnz(select(sel())), 74); + testCase.verifyEqual(nnz(select(sel(nodes = "grid"))), 54); + testCase.verifyEqual(nnz(select(sel(nodes = "centre"))), 20); + testCase.verifyEqual(find(select(sel(ids = [3 60]))).', [3 60]); + % First layer of centre nodes along x: 2 x 2 of them. + testCase.verifyEqual(nnz(select(sel(x = 0.5))), 4); + % Last layer, with the reference max. + testCase.verifyEqual(find(select(sel(x = "max - 0.5"))), find(select(sel(x = 4.5)))); + % Grid nodes at the ends of the prism (x = 0 and x = max): 2 * 3 * 3. + testCase.verifyEqual(nnz(select(sel(x = "min"))) + nnz(select(sel(x = "max"))), 2 * 3 * 3); + % mid is half of the length: x = 2.5 is a layer of centre nodes. + testCase.verifyEqual(nnz(select(sel(x = "mid"))), 4); + % A range includes both ends. + testCase.verifyEqual(nnz(select(sel(nodes = "centre", x = [0.5 1.5]))), 8); + % Combined restrictions intersect. + testCase.verifyEqual(nnz(select(sel(nodes = "centre", x = 0.5, y = 0.5, z = 0.5))), 1); + testCase.verifyEqual(nnz(select(sel(nodes = "grid", x = 0.5))), 0); + end + + function selectionIgnoresThePerturbationOfTheMesh(testCase) + plain = ldem.Parameters(nModules = [6 3 3]); + shaken = ldem.Parameters(nModules = [6 3 3], meshPerturbation = 0.02); + sel = ldem.scenarios.Declarative.makeSelector(x = 2.5); + testCase.verifyEqual(ldem.scenarios.selectNodes(sel, plain), ldem.scenarios.selectNodes(sel, shaken)); + end + + function timeFunctions(testCase) + make = @ldem.scenarios.Declarative.makeFunction; + value = @(fn, t) ldem.scenarios.timeFunction(fn, t); + testCase.verifyEqual(value(make("constant", value = 3), 7), 3); + testCase.verifyEqual(value(make("linear", rate = -2), 5), -10); + ramp = make("ramp", rate = 1000, until = 0.35e-3); + testCase.verifyEqual(value(ramp, 0.1e-3), 0.1); + testCase.verifyEqual(value(ramp, 1), 0.35); + tab = make("table", times = [0 1 3], values = [0 10 0]); + testCase.verifyEqual(value(tab, 0.5), 5); + testCase.verifyEqual(value(tab, 2), 5); + testCase.verifyEqual(value(tab, -1), 0); % before the first time + testCase.verifyEqual(value(tab, 99), 0); % after the last one + bad = make("constant"); + bad.type = "spline"; + testCase.verifyError(@() ldem.scenarios.timeFunction(bad, 0), 'ldem:scenarios:badTimeFunction'); + end + + function malformedBlocksAreRefused(testCase) + make = @ldem.scenarios.Declarative.makeFunction; + testCase.verifyError(@() make("ramp", rate = 1), 'ldem:scenarios:badDefinition'); + testCase.verifyError(@() make("table", times = [0 1], values = 1), 'ldem:scenarios:badDefinition'); + testCase.verifyError(@() make("table", times = [1 0], values = [1 2]), 'ldem:scenarios:badDefinition'); + sel = ldem.scenarios.Declarative.makeSelector(); + testCase.verifyError(@() ldem.scenarios.Declarative.makeSupport(sel, "q"), 'ldem:scenarios:badDefinition'); + testCase.verifyError(@() ldem.scenarios.Declarative.makeSupport(sel, ""), 'ldem:scenarios:badDefinition'); + support = ldem.scenarios.Declarative.makeSupport(sel, "zx"); + testCase.verifyEqual(support.fix, [1 3]); + testCase.verifyError(@() ldem.scenarios.Declarative(supports = struct('a', 1)), 'ldem:scenarios:badDefinition'); + testCase.verifyError(@() ldem.scenarios.Declarative(loads = struct('a', 1)), 'ldem:scenarios:badDefinition'); + end + + function emptySelectionNamesTheBlock(testCase) + sel = ldem.scenarios.Declarative.makeSelector(x = 99); + scenario = ldem.scenarios.Declarative( ... + supports = ldem.scenarios.Declarative.makeSupport(sel, "x", name = "ghost")); + p = ldem.Parameters(testId = 900, nModules = [6 3 3]); + try + ldem.mesh.buildMesh(p, scenario); + testCase.verifyFail('An error was expected.'); + catch err + testCase.verifyEqual(err.identifier, 'ldem:scenarios:noNodesSelected'); + testCase.verifySubstring(err.message, '[[support]] number 1 ("ghost")'); + end + end + + function scenarioDataIsPreparedOnlyWhenNeeded(testCase) + p = ldem.Parameters(testId = 101, nModules = [6 3 3]); + testCase.verifyFalse(isfield(ldem.mesh.buildMesh(p), 'scenarioData')); + + left = ldem.scenarios.Declarative.makeSelector(x = 0.5); + scenario = ldem.scenarios.Declarative( ... + supports = ldem.scenarios.Declarative.makeSupport(left, "x", reaction = true)); + mesh = ldem.mesh.buildMesh(ldem.Parameters(testId = 900, nModules = [6 3 3]), scenario); + testCase.verifyTrue(isfield(mesh, 'scenarioData')); + testCase.verifyTrue(mesh.scenarioData.hasReaction); + testCase.verifyEqual(numel(mesh.scenarioData.reactionNodes{1}), 4); + testCase.verifyEmpty(mesh.scenarioData.reactionNodes{2}); + end + + function reactionIsNaNUnlessMarked(testCase) + sel = ldem.scenarios.Declarative.makeSelector(x = 0.5); + plain = ldem.scenarios.Declarative(supports = ldem.scenarios.Declarative.makeSupport(sel, "x")); + p = ldem.Parameters(testId = 900, nModules = [6 3 3]); + mesh = ldem.mesh.buildMesh(p, plain); + state = struct('force', ones(size(mesh.nodes0))); + testCase.verifyTrue(all(isnan(plain.reactions(state, mesh, p)))); + + marked = ldem.scenarios.Declarative(supports = ldem.scenarios.Declarative.makeSupport(sel, "xy", reaction = true)); + mesh = ldem.mesh.buildMesh(p, marked); + testCase.verifyEqual(marked.reactions(state, mesh, p), [4 4 0]); + end + + function forceLoadsAddUpAndDisplacementLoadsSetThePosition(testCase) + p = ldem.Parameters(testId = 900, nModules = [6 3 3]); + import ldem.scenarios.Declarative + node = Declarative.makeSelector(ids = 60); + half = Declarative.makeFunction("constant", value = 5); + scenario = ldem.scenarios.Declarative(loads = [ ... + Declarative.makeLoad(node, "y", "force", half), ... + Declarative.makeLoad(node, "y", "force", Declarative.makeFunction("linear", rate = 100)), ... + Declarative.makeLoad(Declarative.makeSelector(ids = 61), "z", "displacement", Declarative.makeFunction("linear", rate = -2))]); + mesh = ldem.mesh.buildMesh(p, scenario); + testCase.verifyTrue(mesh.fixed(61, 3)); % a prescribed displacement is held + testCase.verifyFalse(any(mesh.fixed(60, :))); % a force load leaves the node free + + state = ldem.solver.initialState(mesh, struct('tensionStiffness', 1, 'maxStrain', 1, ... + 'isUndamaged', true, 'isUnbroken', true)); + state.time = 0.5; + state.appliedForce(:) = 99; % must be reset + state = scenario.applyLoads(state, mesh, p); + testCase.verifyEqual(state.appliedForce(60, 2), 5 + 50); + testCase.verifyEqual(nnz(state.appliedForce), 1); + testCase.verifyEqual(state.displacement(61, 3), mesh.nodes0(61, 3) - 1); + end + + function reproducesTheBuiltInScenarios(testCase) + import ldem.scenarios.Declarative + + % Uniaxial tension (test 101). + params = {'nModules', [6 3 3], 'totalTime', 2e-5, 'fractureEnergy', 0.1}; + reference = ldem.runSimulation(ldem.Parameters(params{:}, testId = 101)); + scenario = ldem.scenarios.Declarative( ... + supports = Declarative.makeSupport(Declarative.makeSelector(x = 0.5), "x"), ... + loads = Declarative.makeLoad(Declarative.makeSelector(x = "max - 0.5"), "x", "displacement", ... + Declarative.makeFunction("linear", rate = -400e-5))); + result = ldem.runSimulation(ldem.Parameters(params{:}, testId = 900), Scenario = scenario); + testCase.verifyEqual(result.final.displacement, reference.final.displacement); + testCase.verifyEqual(result.energy, reference.energy); + + % Four-point bending (test 102): a short run of the 70-module beam. + params = {'nModules', [70 4 3], 'totalTime', 3e-5, 'fractureEnergy', 0.5}; + reference = ldem.runSimulation(ldem.Parameters(params{:}, testId = 102)); + pull = Declarative.makeFunction("linear", rate = -400e-5); + scenario = ldem.scenarios.Declarative( ... + supports = [Declarative.makeSupport(Declarative.makeSelector(y = 0.5, x = 4.5), "xy"), ... + Declarative.makeSupport(Declarative.makeSelector(y = 0.5, x = "max - 4.5"), "y")], ... + loads = [Declarative.makeLoad(Declarative.makeSelector(y = "max - 0.5", x = 33.5), "y", "displacement", pull, reaction = true), ... + Declarative.makeLoad(Declarative.makeSelector(y = "max - 0.5", x = "max - 33.5"), "y", "displacement", pull, reaction = true)]); + result = ldem.runSimulation(ldem.Parameters(params{:}, testId = 900), Scenario = scenario); + testCase.verifyEqual(result.final.displacement, reference.final.displacement); + testCase.verifyEqual(result.energy, reference.energy); + testCase.verifyEqual(result.reactions.force, reference.reactions.force); + + % Beam clamped at both ends and loaded with a force (test 103). + params = {'nModules', [6 6 21], 'moduleLength', 0.001, 'dt', 3.5e-7, 'totalTime', 4e-5, ... + 'youngModulus', 3.87e9, 'density', 1500, 'fractureEnergy', 0.5, 'criticalDistance', 4.5e-3}; + reference = ldem.runSimulation(ldem.Parameters(params{:}, testId = 103), ... + Scenario = ldem.scenarios.ClampedBeam(forceRate = 1000, rampTime = 0.00035)); + scenario = ldem.scenarios.Declarative( ... + supports = [Declarative.makeSupport(Declarative.makeSelector(z = 0.5), "xyz", reaction = true), ... + Declarative.makeSupport(Declarative.makeSelector(z = "max - 0.5"), "xyz", reaction = true)], ... + loads = Declarative.makeLoad(Declarative.makeSelector(y = 0.5, z = "mid - 0.5"), "y", "force", ... + Declarative.makeFunction("ramp", rate = 1000, until = 0.00035))); + result = ldem.runSimulation(ldem.Parameters(params{:}, testId = 900), Scenario = scenario); + testCase.verifyEqual(result.final.displacement, reference.final.displacement); + testCase.verifyEqual(result.energy, reference.energy); + scale = max(abs(reference.reactions.force(:))); + testCase.verifyEqual(result.reactions.force, reference.reactions.force, ... + 'RelTol', 1e-12, 'AbsTol', 1e-12 * scale); + end + + function caseFileBlocksReproduceTheUniaxialTest(testCase) + path = testCase.writeCase([ ... + "type = ""custom""" + "[[support]]" + "name = ""left end""" + "x = 0.5" + "fix = [""x""]" + "[[load]]" + "x = ""max - 0.5""" + "direction = ""x""" + "type = ""displacement""" + "time_function = ""linear""" + "rate = -4 mm/s"], ["[material]"; "fracture_energy = 0.1 N/m"]); + c = ldem.io.readCase(path); + testCase.verifyClass(c.scenario, 'ldem.scenarios.Declarative'); + testCase.verifyEqual(c.params.testId, 900); + testCase.verifyEqual(c.scenario.supports.name, "left end"); + testCase.verifyEqual(c.scenario.loads.fn.rate, -4e-3); + + viaCase = ldem.runSimulation(c.params, Scenario = c.scenario); + builtin = ldem.runSimulation(ldem.Parameters(testId = 101, nModules = [6 3 3], ... + moduleLength = 0.003, dt = 2e-7, totalTime = 20e-6, fractureEnergy = 0.1)); + testCase.verifyEqual(viaCase.final.displacement, builtin.final.displacement); + end + + function caseFilesRoundTripTheBlocks(testCase) + import ldem.scenarios.Declarative + sel = Declarative.makeSelector(nodes = "centre", ids = [3 5], x = [0.5 "max - 0.5"], z = "mid"); + scenario = ldem.scenarios.Declarative( ... + supports = [Declarative.makeSupport(Declarative.makeSelector(x = 0.5), "xz", name = "wall", reaction = true), ... + Declarative.makeSupport(sel, "y")], ... + loads = [Declarative.makeLoad(Declarative.makeSelector(y = "max - 0.5"), "y", "force", ... + Declarative.makeFunction("ramp", rate = 2500, until = 1e-5), name = "push", reaction = true), ... + Declarative.makeLoad(Declarative.makeSelector(x = [0.5 1.5]), "z", "displacement", ... + Declarative.makeFunction("table", times = [0 1e-5 2e-5], values = [0 1e-4 1e-4])), ... + Declarative.makeLoad(Declarative.makeSelector(nodes = "grid"), "x", "force", Declarative.makeFunction("constant", value = 3))]); + p = ldem.Parameters(testId = 900, nModules = [6 3 3], totalTime = 2e-5); + path = fullfile(testCase.Folder, "blocks.ldem"); + + text = ldem.io.writeCase(path, p, scenario); + testCase.verifySubstring(text, '[[support]]'); + testCase.verifySubstring(text, '[[load]]'); + testCase.verifySubstring(text, '"mid"'); + c = ldem.io.readCase(path); + testCase.verifyEqual(c.scenario.supports, scenario.supports); + testCase.verifyEqual(c.scenario.loads, scenario.loads); + testCase.verifyEqual(c.params.toStruct(), p.toStruct()); + end + + function theCustomTemplateReadsBack(testCase) + path = fullfile(testCase.Folder, "template.ldem"); + text = ldem.io.writeTemplate(path, "custom"); + testCase.verifySubstring(text, '[[support]]'); + c = ldem.io.readCase(path); + testCase.verifyEqual(numel(c.scenario.supports), 1); + testCase.verifyEqual(numel(c.scenario.loads), 1); + report = ldem.check(path); % builds the mesh: the blocks select nodes + testCase.verifyEqual(report.params.testId, 900); + end + + function aCustomCaseWithoutBlocksIsReadable(testCase) + c = ldem.io.readCase(testCase.writeCase("type = ""custom""")); + testCase.verifyEmpty(c.scenario.supports); + testCase.verifyEmpty(c.scenario.loads); + end + + function blockErrorsNameTheirLine(testCase) + testCase.verifyCaseError(["type = ""custom"""; "[[support]]"; "x = 0.5"], ... + 'ldem:case:missingKey', 'needs "fix"'); + testCase.verifyCaseError(["type = ""custom"""; "[[support]]"; "fix = [""x""]"; "flavour = 1"], ... + 'ldem:case:unknownKey', 'flavour'); + testCase.verifyCaseError(["type = ""custom"""; "[[support]]"; "fix = [""q""]"], ... + 'ldem:case:badValue', 'Directions are x, y and z'); + testCase.verifyCaseError(["type = ""custom"""; "[[support]]"; "fix = [""x""]"; "x = ""max *"""], ... + 'ldem:case:badValue', 'not a coordinate'); + testCase.verifyCaseError(["type = ""custom"""; "[[support]]"; "fix = [""x""]"; "ids = [0]"], ... + 'ldem:case:badValue', 'node numbers'); + testCase.verifyCaseError(["type = ""custom"""; "[[support]]"; "fix = [""x""]"; "nodes = ""cntre"""], ... + 'ldem:case:badValue', "Did you mean 'centre'?"); + testCase.verifyCaseError(["type = ""custom"""; "[[support]]"; "fix = [""x""]"; "reaction = 1"], ... + 'ldem:case:badValue', 'true or false'); + testCase.verifyCaseError(["type = ""custom"""; "[[load]]"; "direction = ""x"""], ... + 'ldem:case:missingKey', 'needs "type"'); + end + + function loadFunctionKeysMustMatchTheFunction(testCase) + head = ["type = ""custom"""; "[[load]]"; "direction = ""y"""; "type = ""force"""]; + testCase.verifyCaseError([head; "time_function = ""constant"""], 'ldem:case:missingKey', 'needs the key "value"'); + testCase.verifyCaseError([head; "time_function = ""constant"""; "value = 1 N"; "rate = 2 N/s"], ... + 'ldem:case:inconsistentKey', 'does not apply when time_function = "constant"'); + testCase.verifyCaseError([head; "time_function = ""ramp"""; "rate = 2 N/s"], 'ldem:case:missingKey', '"until"'); + testCase.verifyCaseError([head; "time_function = ""linear"""; "rate = 2 mm/s"], 'ldem:case:badUnit', 'N/s'); + testCase.verifyCaseError([head; "time_function = ""constant"""; "value = 2 mm"], 'ldem:case:badUnit', 'N, kN, MN'); + testCase.verifyCaseError([head; "time_function = ""table"""; "times = [0, 1]"; "values = [1]"], ... + 'ldem:case:badValue', 'table needs'); + testCase.verifyCaseError([head; "time_function = ""spline"""], 'ldem:case:badValue', 'Allowed'); + % The right unit for a displacement load is a length. + c = ldem.io.readCase(testCase.writeCase(["type = ""custom"""; "[[load]]"; "direction = ""y"""; ... + "type = ""displacement"""; "time_function = ""constant"""; "value = 2 mm"])); + testCase.verifyEqual(c.scenario.loads.fn.value, 2e-3); + end + + function blocksNeedTheCustomType(testCase) + testCase.verifyCaseError(["type = ""uniaxial_tension"""; "[[support]]"; "fix = [""x""]"], ... + 'ldem:case:inconsistentKey', 'type = "custom"'); + testCase.verifyCaseError(["type = ""custom"""; "[support]"; "fix = [""x""]"], ... + 'ldem:case:syntax', 'double brackets'); + end + end + + methods (Static, Access = private) + function value = evaluate(text) + % The right-hand side of "key = value" as the parser reads it. + entries = ldem.io.parseCaseText("k = " + text, "t"); + value = entries.value; + end + end +end diff --git a/tests/unit/TestExtendsAndSweep.m b/tests/unit/TestExtendsAndSweep.m new file mode 100644 index 0000000..5d3dd1d --- /dev/null +++ b/tests/unit/TestExtendsAndSweep.m @@ -0,0 +1,329 @@ +classdef TestExtendsAndSweep < LdemTestCase + %TESTEXTENDSANDSWEEP Unit tests of case-file inheritance (extends) and of parameter sweeps. + + properties (Access = private) + Folder (1,1) string + end + + methods (TestMethodSetup) + function makeFolder(testCase) + testCase.Folder = string(testCase.applyFixture( ... + matlab.unittest.fixtures.TemporaryFolderFixture).Folder); + end + end + + methods (Access = private) + function lines = base(~) + lines = [ ... + "format = 1" + "[mesh]" + "module_size = 3 mm" + "modules = [5, 2, 2]" + "[time]" + "step = 0.2 us" + "duration = 20 us" + "[material]" + "fracture_energy = 0.1 N/m" + "[scenario]" + "type = ""uniaxial_tension"""]; + end + + function path = put(testCase, relative, lines) + path = fullfile(testCase.Folder, relative); + writeTextFile(path, string(lines(:))); + end + + function verifyCaseError(testCase, path, id, fragment) + try + ldem.io.readCase(path); + testCase.verifyFail('An error was expected.'); + catch err + testCase.verifyEqual(string(err.identifier), string(id)); + testCase.verifySubstring(err.message, fragment); + end + end + end + + methods (Test, TestTags = {'Unit'}) + function aChildOverridesAndInherits(testCase) + testCase.put("base.ldem", testCase.base()); + child = testCase.put("child.ldem", [ ... + "extends = ""base.ldem""" + "[material]" + "young_modulus = 10 GPa" + "[time]" + "duration = 40 us"]); + c = ldem.io.readCase(child); + testCase.verifyEqual(c.params.youngModulus, 10e9); % set by the child + testCase.verifyEqual(c.params.totalTime, 40e-6); % replaced by the child + testCase.verifyEqual(c.params.fractureEnergy, 0.1); % inherited, same section + testCase.verifyEqual(c.params.dt, 2e-7); % inherited + testCase.verifyEqual(c.params.nModules, [6 3 3]); + testCase.verifyEqual(c.info.parents, string(fullfile(testCase.Folder, "base.ldem"))); + end + + function theChildCanLeaveOutRequiredKeys(testCase) + testCase.put("base.ldem", testCase.base()); + child = testCase.put("child.ldem", ["extends = ""base.ldem"""; "title = ""Only the title"""]); + c = ldem.io.readCase(child); + testCase.verifyEqual(c.info.title, "Only the title"); + testCase.verifyEqual(c.params.totalTime, 20e-6); + end + + function relativePathsFollowTheFileThatWritesThem(testCase) + testCase.put("parent/base.ldem", [testCase.base(); "[material.scatter]"; "type = ""file"""; ... + "file = ""field.txt"""; "[output]"; "folder = ""out"""]); + child = testCase.put("child/child.ldem", ["extends = ""../parent/base.ldem"""; ... + "[material]"; "young_modulus = 10 GPa"]); + c = ldem.io.readCase(child); + testCase.verifyEqual(string(c.params.randomFieldFile), ... + string(fullfile(testCase.Folder, "parent", "field.txt"))); + testCase.verifyEqual(c.options.OutputFolder, string(fullfile(testCase.Folder, "parent", "out"))); + end + + function repeatedTablesAreReplacedAsAWhole(testCase) + testCase.put("base.ldem", [testCase.base(); "[[monitor.node]]"; "id = 2"; "[[monitor.node]]"; "id = 3"]); + keep = testCase.put("keep.ldem", ["extends = ""base.ldem"""; "[material]"; "density = 1500 kg/m3"]); + testCase.verifyEqual(ldem.io.readCase(keep).params.controlNodes, [2 3]); + replace = testCase.put("replace.ldem", ["extends = ""base.ldem"""; "[[monitor.node]]"; "id = 5"]); + testCase.verifyEqual(ldem.io.readCase(replace).params.controlNodes, 5); + end + + function changingTheTypeDropsTheKeysOfTheOldOne(testCase) + lines = testCase.base(); + lines = lines(~startsWith(lines, ["[scenario]" "type"])); + testCase.put("beam.ldem", [lines; "[scenario]"; "type = ""clamped_beam"""; "force_rate = 2 kN/s"; ... + "[damping]"; "type = ""mass_proportional"""; "initial = 100"; "final = 100"; ... + "[material.scatter]"; "type = ""generated"""; "cv = 0.1"]); + child = testCase.put("child.ldem", [ ... + "extends = ""beam.ldem""" + "[scenario]" + "type = ""uniaxial_tension""" + "[damping]" + "type = ""none""" + "[material.scatter]" + "type = ""none"""]); + c = ldem.io.readCase(child); + testCase.verifyClass(c.scenario, 'ldem.scenarios.UniaxialTension'); + testCase.verifyEqual(c.params.dampingModel, "none"); + testCase.verifyEqual(c.params.randomFieldCv, 0); + + % Same type: the inherited keys stay. + same = testCase.put("same.ldem", ["extends = ""beam.ldem"""; "[scenario]"; "type = ""clamped_beam"""]); + testCase.verifyEqual(ldem.io.readCase(same).scenario.forceRate, 2000); + end + + function severalParentsApplyInOrder(testCase) + testCase.put("a.ldem", testCase.base()); + testCase.put("b.ldem", ["[material]"; "young_modulus = 10 GPa"; "density = 1000 kg/m3"]); + testCase.put("c.ldem", ["[material]"; "young_modulus = 20 GPa"]); + child = testCase.put("child.ldem", ["extends = [""a.ldem"", ""b.ldem"", ""c.ldem""]"; ... + "[material]"; "poisson_ratio = 0.2"]); + c = ldem.io.readCase(child); + testCase.verifyEqual(c.params.youngModulus, 20e9); % the last parent wins + testCase.verifyEqual(c.params.density, 1000); + testCase.verifyEqual(c.params.poissonRatio, 0.2); + testCase.verifyEqual(numel(c.info.parents), 3); + end + + function chainsOfParentsWork(testCase) + testCase.put("a.ldem", testCase.base()); + testCase.put("b.ldem", ["extends = ""a.ldem"""; "[material]"; "young_modulus = 10 GPa"]); + child = testCase.put("c.ldem", ["extends = ""b.ldem"""; "[material]"; "density = 1000 kg/m3"]); + c = ldem.io.readCase(child); + testCase.verifyEqual(c.params.youngModulus, 10e9); + testCase.verifyEqual(c.params.density, 1000); + testCase.verifyEqual(c.params.fractureEnergy, 0.1); + testCase.verifyEqual(c.info.parents, string(fullfile(testCase.Folder, ["a.ldem"; "b.ldem"]))); + end + + function loopsAndMissingParentsAreErrors(testCase) + testCase.put("a.ldem", "extends = ""b.ldem"""); + testCase.put("b.ldem", "extends = ""a.ldem"""); + testCase.verifyCaseError(fullfile(testCase.Folder, "a.ldem"), 'ldem:case:extendsLoop', 'in a loop'); + lonely = testCase.put("lonely.ldem", "extends = ""missing.ldem"""); + testCase.verifyCaseError(lonely, 'ldem:io:fileNotFound', 'lonely.ldem:1 extends'); + bad = testCase.put("bad.ldem", "extends = 3"); + testCase.verifyCaseError(bad, 'ldem:case:badValue', 'in quotes'); + end + + function errorsNameTheFileWhereTheyAreWritten(testCase) + lines = testCase.base(); + lines(lines == "step = 0.2 us") = "step = 0.2 kg"; + testCase.put("base.ldem", lines); + child = testCase.put("child.ldem", "extends = ""base.ldem"""); + testCase.verifyCaseError(child, 'ldem:case:badUnit', 'base.ldem:6 [time] step'); + end + + function runKeepsTheParentsAndTheirHashes(testCase) + testCase.put("base.ldem", testCase.base()); + child = testCase.put("child.ldem", "extends = ""base.ldem"""); + results = ldem.run(child, OutputFolder = "", Verbose = false); + info = results.info.case; + testCase.verifyEqual(numel(info.parents), 1); + testCase.verifyEqual(strlength(info.parents.sha256), 64); + testCase.verifyEqual(info.original, string(fileread(child))); + % The resolved case has everything and needs no parent. + path = fullfile(testCase.Folder, "resolved.ldem"); + writeTextFile(path, splitlines(info.resolved)); + testCase.verifyEqual(ldem.io.readCase(path).params.toStruct(), results.params); + end + + function sweepBlocksAreReadAndChecked(testCase) + % sweep_mode is a key at the top of the file, before the first table. + path = fullfile(testCase.Folder, "sweep.ldem"); + writeTextFile(path, ["sweep_mode = ""zip"""; testCase.base(); ... + "[[sweep]]"; "key = ""material.fracture_energy"""; "values = [""0.1 N/m"", ""0.5 N/m""]"; ... + "[[sweep]]"; "key = ""time.duration"""; "values = [2e-5, 4e-5]"]); + c = ldem.io.readCase(path); + testCase.verifyEqual(c.info.sweepMode, "zip"); + testCase.verifyEqual(numel(c.info.sweep), 2); + testCase.verifyEqual(c.info.sweep(1).key, "material.fracture_energy"); + testCase.verifyEqual(c.info.sweep(1).values, {"0.1 N/m", "0.5 N/m"}); + testCase.verifyEqual(c.info.sweep(2).values, {2e-5, 4e-5}); + end + + function badSweepBlocks(testCase) + bad = @(lines) testCase.put("bad.ldem", [testCase.base(); string(lines(:))]); + testCase.verifyCaseError(bad(["[[sweep]]"; "key = ""time.duration"""]), 'ldem:case:missingKey', 'needs "key"'); + testCase.verifyCaseError(bad(["[[sweep]]"; "key = ""time.duraton"""; "values = [1]"]), ... + 'ldem:case:badValue', "Did you mean 'time.duration'?"); + testCase.verifyCaseError(bad(["[[sweep]]"; "key = ""mesh.modules"""; "values = [1]"]), ... + 'ldem:case:badValue', 'cannot be swept'); + testCase.verifyCaseError(bad(["[[sweep]]"; "key = ""load.rate"""; "values = [1]"]), ... + 'ldem:case:badValue', 'cannot be swept'); + testCase.verifyCaseError(bad(["[[sweep]]"; "key = 3"; "values = [1]"]), 'ldem:case:badValue', 'in quotes'); + testCase.verifyCaseError(bad(["[[sweep]]"; "key = ""time.duration"""; "values = []"]), ... + 'ldem:case:badValue', 'non-empty list'); + testCase.verifyCaseError(bad(["[sweep]"; "key = ""time.duration"""; "values = [1]"]), ... + 'ldem:case:syntax', 'double brackets'); + end + + function overridesChangeKeysOfTheCase(testCase) + path = testCase.put("case.ldem", testCase.base()); + overrides = struct('path', {"material.fracture_energy", "time.duration"}, ... + 'value', {"2 N/m", 3e-5}); + c = ldem.io.readCase(path, Overrides = overrides); + testCase.verifyEqual(c.params.fractureEnergy, 2); + testCase.verifyEqual(c.params.totalTime, 3e-5); + + testCase.verifyError(@() ldem.io.readCase(path, Overrides = struct('path', "mesh.nonsense", 'value', 1)), ... + 'ldem:sweep:unknownKey'); + testCase.verifyError(@() ldem.io.readCase(path, Overrides = struct('path', "support.fix", 'value', "x")), ... + 'ldem:sweep:unsupportedKey'); + % A bad value is reported where it is used. + try + ldem.io.readCase(path, Overrides = struct('path', "material.fracture_energy", 'value', "2 kg")); + testCase.verifyFail('An error was expected.'); + catch err + testCase.verifyEqual(err.identifier, 'ldem:case:badUnit'); + testCase.verifySubstring(err.message, 'sweep [material] fracture_energy'); + end + end + + function overridesCanSetScenarioKeys(testCase) + lines = testCase.base(); + lines = lines(~startsWith(lines, ["[scenario]" "type"])); + path = testCase.put("beam.ldem", [lines; "[scenario]"; "type = ""clamped_beam"""]); + c = ldem.io.readCase(path, Overrides = struct('path', "scenario.force_rate", 'value', "3 kN/s")); + testCase.verifyEqual(c.scenario.forceRate, 3000); + end + + function dryRunListsTheCombinations(testCase) + path = testCase.put("sweep.ldem", [testCase.base(); ... + "[[sweep]]"; "key = ""material.fracture_energy"""; "values = [""0.1 N/m"", ""0.5 N/m"", ""1 N/m""]"; ... + "[[sweep]]"; "key = ""time.duration"""; "values = [2e-5, 4e-5]"]); + summary = ldem.sweep(path, DryRun = true, Verbose = false); + testCase.verifySize(summary, [6 9]); + testCase.verifyEqual(summary.status, repmat("planned", 6, 1)); + testCase.verifyEqual(summary.material_fracture_energy, ["0.1 N/m"; "0.5 N/m"; "1 N/m"; "0.1 N/m"; "0.5 N/m"; "1 N/m"]); + testCase.verifyEqual(summary.time_duration, ["2e-05"; "2e-05"; "2e-05"; "4e-05"; "4e-05"; "4e-05"]); + testCase.verifyTrue(all(endsWith(summary.folder, "run_" + compose("%03d", (1:6).')))); + testCase.verifyFalse(isfolder(fullfile(testCase.Folder, "sweep_sweep"))); % nothing was created + + % The mode of the file can be overridden: the lists of 3 and 2 values cannot be zipped. + testCase.verifyError(@() ldem.sweep(path, DryRun = true, Verbose = false, Mode = "zip"), ... + 'ldem:sweep:zipLengths'); + end + + function varyAddsKeysAndZipNeedsEqualLengths(testCase) + path = testCase.put("case.ldem", testCase.base()); + summary = ldem.sweep(path, DryRun = true, Verbose = false, ... + Vary = {"material.fracture_energy", [0.1 0.5], "time.duration", ["20 us", "30 us"]}, Mode = "zip"); + testCase.verifyEqual(height(summary), 2); + testCase.verifyError(@() ldem.sweep(path, DryRun = true, Verbose = false, Mode = "zip", ... + Vary = {"material.fracture_energy", [0.1 0.5], "time.duration", ["20 us", "30 us", "40 us"]}), ... + 'ldem:sweep:zipLengths'); + testCase.verifyError(@() ldem.sweep(path, DryRun = true, Verbose = false), 'ldem:sweep:noKeys'); + testCase.verifyError(@() ldem.sweep(path, DryRun = true, Vary = {"a"}), 'ldem:sweep:invalidRun'); + end + + function invalidRunsStopTheSweepBeforeItStarts(testCase) + path = testCase.put("case.ldem", testCase.base()); + try + ldem.sweep(path, Verbose = false, OutputFolder = fullfile(testCase.Folder, "out"), ... + Vary = {"time.step", ["0.2 us", "50 us"]}); + testCase.verifyFail('An error was expected.'); + catch err + testCase.verifyEqual(err.identifier, 'ldem:sweep:invalidRun'); + testCase.verifySubstring(err.message, 'Run 2'); + testCase.verifySubstring(err.message, 'time.step = 50 us'); + end + testCase.verifyFalse(isfolder(fullfile(testCase.Folder, "out"))); + try + ldem.sweep(path, DryRun = true, Vary = {"mesh.nonsense", [1 2]}); + testCase.verifyFail('An error was expected.'); + catch err + testCase.verifyEqual(err.identifier, 'ldem:sweep:invalidRun'); + testCase.verifySubstring(err.message, 'does not exist'); + end + end + + function aSweepRunsEveryCaseAndSummarisesThem(testCase) + lines = testCase.base(); + lines(lines == "duration = 20 us") = "duration = 200 us"; + path = testCase.put("case.ldem", lines); + out = fullfile(testCase.Folder, "runs"); + [summary, results] = ldem.sweep(path, Verbose = false, OutputFolder = out, Formats = "mat", ... + KeepResults = true, ... + Vary = {"material.fracture_energy", ["0.1 N/m", "50 N/m"]}); + + testCase.verifyEqual(summary.status, ["done"; "done"]); + testCase.verifyEqual(summary.run, [1; 2]); + for r = 1:2 + testCase.verifyTrue(isfile(fullfile(out, sprintf("run_%03d", r), "results.mat"))); + testCase.verifyTrue(isfile(fullfile(out, sprintf("run_%03d", r), "case.ldem"))); + end + testCase.verifyTrue(isfile(fullfile(out, "sweep_summary.csv"))); + testCase.verifyEqual(results{1}.params.fractureEnergy, 0.1); + testCase.verifyEqual(results{2}.params.fractureEnergy, 50); + testCase.verifyEqual(results{1}.info.case.overrides, "material.fracture_energy = 0.1 N/m"); + testCase.verifyGreaterThanOrEqual(summary.damagedBars(1), summary.damagedBars(2)); + testCase.verifyGreaterThan(summary.damagedBars(1), 0); + testCase.verifyTrue(all(summary.seconds > 0)); + + % The resolved case of a run has the varied value in it. + again = ldem.io.readCase(fullfile(out, "run_001", "case.ldem")); + testCase.verifyEqual(again.params.fractureEnergy, 0.1); + + table = readtable(fullfile(out, "sweep_summary.csv"), 'TextType', 'string'); + testCase.verifyEqual(height(table), 2); + testCase.verifyEqual(table.status, ["done"; "done"]); + end + + function resultsAreNotKeptUnlessAsked(testCase) + path = testCase.put("case.ldem", testCase.base()); + [summary, results] = ldem.sweep(path, Verbose = false, ... + OutputFolder = fullfile(testCase.Folder, "runs"), Formats = "mat", ... + Vary = {"time.duration", ["4 us", "6 us"]}); + testCase.verifyEqual(summary.status, ["done"; "done"]); + testCase.verifyEqual(results, cell(2, 1)); + end + + function runWarnsWhenTheCaseDefinesASweep(testCase) + path = testCase.put("sweep.ldem", [testCase.base(); ... + "[[sweep]]"; "key = ""material.fracture_energy"""; "values = [0.1, 0.5]"]); + testCase.verifyWarning(@() ldem.run(path, OutputFolder = "", Verbose = false), 'ldem:run:sweepIgnored'); + end + end +end diff --git a/tests/unit/TestKeyReference.m b/tests/unit/TestKeyReference.m new file mode 100644 index 0000000..5f241e4 --- /dev/null +++ b/tests/unit/TestKeyReference.m @@ -0,0 +1,42 @@ +classdef TestKeyReference < LdemTestCase + %TESTKEYREFERENCE The key reference of the user guide is generated from the schema. + + methods (Test, TestTags = {'Unit'}) + function theGuideAgreesWithTheSchema(testCase) + file = fullfile(testCase.RepoRoot, "docs", "source", "case-keys.inc"); + testCase.assertTrue(isfile(file), ... + 'docs/source/case-keys.inc is missing: run ldem.schema.writeKeyReference("docs/source/case-keys.inc").'); + written = strrep(string(fileread(file)), char(13), ""); + generated = ldem.schema.writeKeyReference(); + testCase.verifyTrue(isequal(written, generated), ... + ['docs/source/case-keys.inc is out of date with ldem.schema.caseSchema: from the repository ' ... + 'root run ldem.schema.writeKeyReference("docs/source/case-keys.inc") and commit it.']); + end + + function everyKeyOfTheSchemaIsListed(testCase) + text = ldem.schema.writeKeyReference(); + schema = ldem.schema.caseSchema(); + for row = schema.' + key = string(regexprep(row.path, '^.*\.', '')); + testCase.verifySubstring(text, "``" + key + "``", row.path); + end + end + + function theTextHasTheExpectedShape(testCase) + text = ldem.schema.writeKeyReference(); + testCase.verifySubstring(text, ".. rubric:: ``[mesh]``"); + testCase.verifySubstring(text, ".. rubric:: ``[[support]]``"); + testCase.verifySubstring(text, "number + unit (m, cm, mm, um, km)"); + testCase.verifySubstring(text, "3 mm"); % default of module_size + testCase.verifySubstring(text, "required"); + testCase.verifyTrue(endsWith(text, newline)); + end + + function writesTheFile(testCase) + folder = testCase.applyFixture(matlab.unittest.fixtures.TemporaryFolderFixture).Folder; + path = fullfile(folder, "keys.inc"); + text = ldem.schema.writeKeyReference(path); + testCase.verifyEqual(strrep(string(fileread(path)), char(13), ""), text); + end + end +end diff --git a/tests/unit/TestLawsAndDamping.m b/tests/unit/TestLawsAndDamping.m new file mode 100644 index 0000000..fe63fe7 --- /dev/null +++ b/tests/unit/TestLawsAndDamping.m @@ -0,0 +1,281 @@ +classdef TestLawsAndDamping < LdemTestCase + %TESTLAWSANDDAMPING Unit tests of the constitutive laws and damping models. + + properties (Constant) + E1 = 1e6 % bar stiffness [N] + L = 0.01 % bar length [m] + Mass = 0.1 % mass of the free node [kg] + end + + properties (Access = private) + Folder (1,1) string + end + + methods (TestMethodSetup) + function makeFolder(testCase) + testCase.Folder = string(testCase.applyFixture( ... + matlab.unittest.fixtures.TemporaryFolderFixture).Folder); + end + end + + methods (Access = private) + function [mesh, barProps, history] = oscillator(testCase) + % One bar: node 1 fixed, node 2 free along x (a spring of constant E1/L). + mesh = struct( ... + 'nodes0', [0 0 0; testCase.L 0 0], ... + 'bars', [1 2], ... + 'barLength', testCase.L, ... + 'mass', [testCase.Mass; testCase.Mass], ... + 'fixed', [true true true; false true true]); + barProps = struct('stiffness', testCase.E1, 'criticalStrain', 1, ... + 'ruptureRatio', 10, 'ruptureStrain', 10); + history = struct('tensionStiffness', testCase.E1, 'maxStrain', 1, ... + 'isUndamaged', true, 'isUnbroken', true); + end + + function [barProps, history, length] = threeBars(testCase) + % Bars 1-3 at strain 0.5e-3 (elastic), 2e-3 (softening) and 5e-3 (broken). + barProps = struct('stiffness', testCase.E1 * [1; 1; 1], ... + 'criticalStrain', 1e-3 * [1; 1; 1], 'ruptureRatio', 5 * [1; 1; 1], ... + 'ruptureStrain', 5e-3 * [1; 1; 1]); + history = struct('tensionStiffness', testCase.E1 * [1; 1; 1], ... + 'maxStrain', 1e-3 * [1; 1; 1], 'isUndamaged', true(3, 1), 'isUnbroken', true(3, 1)); + length = 0.01 * [1; 1; 1]; + end + + function path = writeCase(testCase, extra) + path = fullfile(testCase.Folder, "case.ldem"); + writeTextFile(path, [ ... + "format = 1" + "[mesh]" + "module_size = 3 mm" + "modules = [5, 2, 2]" + "[time]" + "step = 0.2 us" + "duration = 40 us" + "[scenario]" + "type = ""uniaxial_tension""" + string(extra(:))]); + end + end + + methods (Test, TestTags = {'Unit'}) + function registriesAgreeWithTheirClasses(testCase) + laws = ldem.material.lawRegistry(); + testCase.verifyEqual(numel(unique([laws.name])), numel(laws)); + for entry = laws + law = feval(entry.className); + testCase.verifyEqual(law.name, entry.name); + testCase.verifyInstanceOf(law, 'ldem.material.MaterialLaw'); + testCase.verifyClass(ldem.material.lawFromName(entry.name), entry.className); + testCase.verifyClass(ldem.material.lawFromName(upper(entry.name)), entry.className); + end + models = ldem.solver.dampingRegistry(); + testCase.verifyEqual(numel(unique([models.name])), numel(models)); + for entry = models + model = feval(entry.className); + testCase.verifyEqual(model.name, entry.name); + testCase.verifyInstanceOf(model, 'ldem.solver.DampingModel'); + testCase.verifyClass(ldem.solver.dampingFromName(entry.name), entry.className); + testCase.verifyTrue(all(ismember(entry.keys, ["initial" "final" "switch_time"]))); + end + end + + function unknownNamesAreSuggested(testCase) + testCase.verifyError(@() ldem.material.lawFromName("bilinar"), 'ldem:material:unknownLaw'); + try + ldem.material.lawFromName("bilinar"); + catch err + testCase.verifySubstring(err.message, "Did you mean 'bilinear'?"); + end + testCase.verifyError(@() ldem.solver.dampingFromName("mass"), 'ldem:solver:unknownDamping'); + end + + function parametersCheckTheNames(testCase) + p = ldem.Parameters(); + testCase.verifyEqual(p.constitutiveLaw, "bilinear"); + testCase.verifyEqual(p.dampingModel, "mass_proportional"); + testCase.verifyError(@() ldem.Parameters(constitutiveLaw = "plastic"), 'ldem:params:unknownLaw'); + testCase.verifyError(@() ldem.Parameters(dampingModel = "viscous"), 'ldem:params:unknownDampingModel'); + q = ldem.Parameters(constitutiveLaw = "linear_elastic", dampingModel = "none"); + testCase.verifyEqual(q.constitutiveLaw, "linear_elastic"); + end + + function bilinearObjectMatchesTheFunction(testCase) + [barProps, history] = testCase.threeBars(); + strain = [0.5e-3; 2e-3; 5e-3]; + rate = [1; -2; 3]; + params = ldem.Parameters(constitutiveDamping = 1e-6); + [expectedForce, expectedHistory] = ldem.material.bilinearLaw(strain, rate, barProps, history, 1e-6); + [force, after] = ldem.material.BilinearBarLaw().evaluate(strain, rate, barProps, history, params); + testCase.verifyEqual(force, expectedForce); + testCase.verifyEqual(after, expectedHistory); + end + + function bilinearEnergiesOfHandMadeBars(testCase) + [barProps, history, len] = testCase.threeBars(); + law = ldem.material.BilinearBarLaw(); + E = testCase.E1; + + % Elastic bar: only strain energy. + e = law.energies([0.5e-3; 0; 0], barProps, history, len); + testCase.verifyEqual(e.elastic, E * (0.5e-3)^2 * len(1) / 2, 'RelTol', 1e-12); + testCase.verifyEqual(e.damage, 0); + testCase.verifyEqual(e.brokenBars, 0); + + % Evaluate the softening and the broken bar, then read the energies. + params = ldem.Parameters(); + [~, history] = law.evaluate([0.5e-3; 2e-3; 5e-3], zeros(3, 1), barProps, history, params); + e = law.energies([0.5e-3; 2e-3; 5e-3], barProps, history, len); + EP = 1e-3; + EM = 2e-3; + E2 = history.tensionStiffness(2); + area = E * EP^2 - E2 * EM^2 + (E * EP + E2 * EM) * (EM - EP); + damageSoftening = len(2) * area / 2; + fractureEnergy = E * EP^2 * 5 * len(3) / 2; + testCase.verifyEqual(law.barDamageEnergy(2, barProps, history, len), damageSoftening, 'RelTol', 1e-12); + testCase.verifyEqual(law.barDamageEnergy(1, barProps, history, len), 0); + testCase.verifyEqual(e.brokenBars, fractureEnergy, 'RelTol', 1e-12); + testCase.verifyGreaterThan(e.damage, damageSoftening); % the broken bar adds its own + testCase.verifyEqual(law.viscousStiffness([-1; 1; 1], barProps, history), ... + [E; E2; history.tensionStiffness(3)]); + end + + function linearElasticLawHasNoDamage(testCase) + [barProps, history, len] = testCase.threeBars(); + law = ldem.material.LinearElasticBarLaw(); + params = ldem.Parameters(constitutiveDamping = 2e-6); + strain = [-1e-3; 2e-3; 9e-3]; % past the rupture strain of the bilinear law + rate = [3; -1; 2]; + [force, after] = law.evaluate(strain, rate, barProps, history, params); + testCase.verifyEqual(force, testCase.E1 * (strain + 2e-6 * rate), 'RelTol', 1e-12); + testCase.verifyEqual(after, history); + e = law.energies(strain, barProps, after, len); + testCase.verifyEqual(e.elastic, sum(testCase.E1 * strain.^2 .* len / 2), 'RelTol', 1e-12); + testCase.verifyEqual(e.damage, 0); + testCase.verifyEqual(e.brokenBars, 0); + testCase.verifyEqual(law.barDamageEnergy(3, barProps, after, len), 0); + testCase.verifyEqual(law.viscousStiffness(strain, barProps, after), barProps.stiffness); + end + + function aLawOutsideTheRegistryPlugsIntoTheSolver(testCase) + [mesh, barProps, history] = testCase.oscillator(); + params = ldem.Parameters(dt = 2e-7); + state = ldem.solver.initialState(mesh, history); + state.displacement(2, 1) = testCase.L * (1 + 1e-4); + state.previousDisplacement = state.displacement; + + elastic = ldem.solver.computeBarForces(state, mesh, barProps, params, ldem.material.LinearElasticBarLaw()); + half = ldem.solver.computeBarForces(state, mesh, barProps, params, TestHalfStiffnessLaw()); + testCase.verifyEqual(half.axialForce, 0.5 * elastic.axialForce, 'RelTol', 1e-12); + testCase.verifyEqual(half.force, 0.5 * elastic.force, 'RelTol', 1e-12); + + e = ldem.solver.computeEnergies(half, mesh, barProps, params, TestHalfStiffnessLaw()); + testCase.verifyEqual(e.elastic, 0.5 * testCase.E1 * (1e-4)^2 * testCase.L / 2, 'RelTol', 1e-9); + end + + function dampingModels(testCase) + p = ldem.Parameters(dt = 5e-7, dampingInitial = 100, dampingFinal = 40, dampingSwitchTime = 2.5e-6); + mp = ldem.solver.MassProportionalDamping(); + testCase.verifyEqual(mp.coefficient(1, p), ldem.solver.dampingCoefficient(1, p)); + testCase.verifyEqual(mp.coefficient(1, p), 100); + testCase.verifyEqual(mp.coefficient(10, p), 40); + none = ldem.solver.NoDamping(); + testCase.verifyEqual(none.coefficient(1, p), 0); + testCase.verifyEqual(none.coefficient(10, p), 0); + end + + function noDampingKeepsTheOscillatorUndamped(testCase) + [mesh, barProps, history] = testCase.oscillator(); + params = ldem.Parameters(dt = 2e-7, dampingModel = "none", dampingInitial = 5000, dampingFinal = 5000); + law = ldem.material.LinearElasticBarLaw(); + damping = ldem.solver.dampingFromName(params.dampingModel); + state = ldem.solver.initialState(mesh, history); + u0 = 1e-6; + omega = sqrt(testCase.E1 / testCase.L / testCase.Mass); + state.displacement(2, 1) = testCase.L + u0; + state.previousDisplacement(2, 1) = testCase.L + u0 * cos(omega * params.dt); + nSteps = 2000; + x = zeros(nSteps, 1); + for n = 1:nSteps + state.step = n; + state.time = state.time + params.dt; + state = ldem.solver.computeBarForces(state, mesh, barProps, params, law); + state = ldem.solver.integrateStep(state, mesh, barProps, params, law, damping); + x(n) = state.displacement(2, 1) - testCase.L; + end + t = params.dt * (1:nSteps).'; + testCase.verifyEqual(x, u0 * cos(omega * t), 'AbsTol', 2e-3 * u0); + testCase.verifyEqual(state.dampingEnergy, 0); + end + + function simulationsWithTheOtherLawAndDamping(testCase) + damaging = {'testId', 101, 'nModules', [6 3 3], 'totalTime', 2e-4, 'fractureEnergy', 0.1}; + bilinear = ldem.runSimulation(ldem.Parameters(damaging{:})); + elastic = ldem.runSimulation(ldem.Parameters(damaging{:}, constitutiveLaw = "linear_elastic")); + + testCase.verifyGreaterThan(bilinear.energy.damage(end), 0); + testCase.verifyEqual(elastic.energy.damage, zeros(size(elastic.energy.damage))); + testCase.verifyEqual(elastic.energy.brokenBars, zeros(size(elastic.energy.brokenBars))); + testCase.verifyEqual(elastic.final.damage.isUnbroken, true(size(elastic.final.damage.isUnbroken))); + % The elastic model keeps the energy balance closed. + testCase.verifyLessThan(abs(elastic.energy.balance(end)), 0.01 * abs(elastic.energy.external(end))); + + undamped = ldem.runSimulation(ldem.Parameters(damaging{:}, dampingModel = "none")); + damped = ldem.runSimulation(ldem.Parameters(damaging{:})); + testCase.verifyEqual(undamped.energy.damping, zeros(size(undamped.energy.damping))); + testCase.verifyGreaterThan(damped.energy.damping(end), 0); + end + + function caseFilesChooseTheLawAndTheDamping(testCase) + c = ldem.io.readCase(testCase.writeCase(strings(0, 1))); + testCase.verifyEqual(c.params.constitutiveLaw, "bilinear"); + testCase.verifyEqual(c.params.dampingModel, "mass_proportional"); + + c = ldem.io.readCase(testCase.writeCase(["[material]"; "law = ""Linear_Elastic"""; ... + "[damping]"; "type = ""none"""; "constitutive = 1 us"])); + testCase.verifyEqual(c.params.constitutiveLaw, "linear_elastic"); + testCase.verifyEqual(c.params.dampingModel, "none"); + testCase.verifyEqual(c.params.constitutiveDamping, 1e-6); + end + + function caseFileErrorsForLawAndDamping(testCase) + try + ldem.io.readCase(testCase.writeCase(["[material]"; "law = ""bilinar"""])); + testCase.verifyFail('An error was expected.'); + catch err + testCase.verifyEqual(err.identifier, 'ldem:case:badValue'); + testCase.verifySubstring(err.message, "Did you mean 'bilinear'?"); + testCase.verifySubstring(err.message, 'linear_elastic'); + end + try + ldem.io.readCase(testCase.writeCase(["[damping]"; "type = ""none"""; "initial = 100"])); + testCase.verifyFail('An error was expected.'); + catch err + testCase.verifyEqual(err.identifier, 'ldem:case:inconsistentKey'); + testCase.verifySubstring(err.message, 'type = "none"'); + end + % The default model accepts all three keys. + c = ldem.io.readCase(testCase.writeCase(["[damping]"; "initial = 100"; "final = 50"; "switch_time = 10 us"])); + testCase.verifyEqual(c.params.dampingFinal, 50); + end + + function writerKeepsTheLawAndTheDamping(testCase) + p = ldem.Parameters(constitutiveLaw = "linear_elastic", dampingModel = "none", ... + constitutiveDamping = 3e-6); + path = fullfile(testCase.Folder, "w.ldem"); + text = ldem.io.writeCase(path, p); + testCase.verifySubstring(text, '"linear_elastic"'); + testCase.verifyFalse(contains(text, "switch_time")); + c = ldem.io.readCase(path); + testCase.verifyEqual(c.params.constitutiveLaw, "linear_elastic"); + testCase.verifyEqual(c.params.dampingModel, "none"); + testCase.verifyEqual(c.params.constitutiveDamping, 3e-6); + + q = ldem.Parameters(dampingInitial = 1200, dampingFinal = 800, dampingSwitchTime = 2e-5); + ldem.io.writeCase(path, q); + r = ldem.io.readCase(path); + testCase.verifyEqual(r.params.toStruct(), q.toStruct()); + end + end +end diff --git a/tests/unit/TestReadCase.m b/tests/unit/TestReadCase.m index ae81edd..475ca23 100644 --- a/tests/unit/TestReadCase.m +++ b/tests/unit/TestReadCase.m @@ -407,7 +407,7 @@ function everyKeyOfTheSchemaIsConsistent(testCase) schema = ldem.schema.caseSchema(); testCase.verifyEqual(numel(unique(string({schema.path}))), numel(schema)); kinds = ["integer" "number" "quantity" "string" "stringlist" "path" "intlist" ... - "numberlist" "bool" "enum" "stepOrAuto" "cadence"]; + "numberlist" "bool" "enum" "stepOrAuto" "cadence" "coordinate" "loadQuantity"]; props = string(properties('ldem.Parameters')); for row = schema.' testCase.verifyTrue(any(row.kind == kinds), row.path); diff --git a/tests/unit/TestWriteCase.m b/tests/unit/TestWriteCase.m index 3e704e9..d4b78f1 100644 --- a/tests/unit/TestWriteCase.m +++ b/tests/unit/TestWriteCase.m @@ -66,7 +66,7 @@ function randomFieldFileOfAnotherFolderUsesDotDot(testCase) text = ldem.io.writeCase(path, p); testCase.verifySubstring(text, 'file = "../../shared/field.txt"'); testCase.verifyEqual(strrep(string(ldem.io.readCase(path).params.randomFieldFile), '\', '/'), ... - strrep(string(fullfile(testCase.Folder, "a", "b", "../../shared/field.txt")), '\', '/')); + strrep(string(fullfile(testCase.Folder, "shared", "field.txt")), '\', '/')); end function exampleCaseFilesMatchTheirDataFiles(testCase) @@ -157,9 +157,10 @@ function everyKeyOfTheSchemaAppearsInATemplate(testCase) schema = ldem.schema.caseSchema(); onlyWithAnOption = ["material.scatter.file" "material.scatter.cv" ... "material.scatter.correlation_length" "material.scatter.seed" ... - "monitor.bar.tracked" "format" "title" "authors" "scenario.type"]; + "monitor.bar.tracked" "format" "title" "authors" "scenario.type" ... + "extends" "sweep_mode"]; for row = schema.' - if startsWith(row.path, "monitor.node") || any(row.path == onlyWithAnOption) + if startsWith(row.path, ["monitor.node" "support." "load." "sweep."]) || any(row.path == onlyWithAnOption) continue end key = string(regexprep(row.path, '^.*\.', '')); From c13febffe8099d5070426b1ee8691d80152303d8 Mon Sep 17 00:00:00 2001 From: Boris Rojo Tanzi <71112604+borisrojotanzi@users.noreply.github.com> Date: Sun, 8 Nov 2026 22:33:07 -0300 Subject: [PATCH 13/13] feat: pluggable laws, custom tests, inheritance and sweeps; docs in one language with translations --- .github/workflows/docs.yml | 4 +- .gitignore | 1 + CHANGELOG.md | 16 + CONTRIBUTING.md | 2 +- README.md | 6 +- buildfile.m | 6 +- docs/Makefile | 2 +- docs/locale/es/LC_MESSAGES/api/index.po | 55 + docs/locale/es/LC_MESSAGES/authors.po | 59 + docs/locale/es/LC_MESSAGES/contributing.po | 43 + docs/locale/es/LC_MESSAGES/docs.po | 183 +++ docs/locale/es/LC_MESSAGES/examples.po | 587 +++++++ docs/locale/es/LC_MESSAGES/index.po | 34 + docs/locale/es/LC_MESSAGES/installation.po | 70 + docs/locale/es/LC_MESSAGES/introduction.po | 77 + docs/locale/es/LC_MESSAGES/model.po | 240 +++ docs/locale/es/LC_MESSAGES/sphinx.po | 45 + docs/locale/es/LC_MESSAGES/usage.po | 1346 +++++++++++++++++ docs/locale/it/LC_MESSAGES/api/index.po | 54 + docs/locale/it/LC_MESSAGES/authors.po | 59 + docs/locale/it/LC_MESSAGES/contributing.po | 42 + docs/locale/it/LC_MESSAGES/docs.po | 183 +++ docs/locale/it/LC_MESSAGES/examples.po | 587 +++++++ docs/locale/it/LC_MESSAGES/index.po | 34 + docs/locale/it/LC_MESSAGES/installation.po | 70 + docs/locale/it/LC_MESSAGES/introduction.po | 79 + docs/locale/it/LC_MESSAGES/model.po | 240 +++ docs/locale/it/LC_MESSAGES/sphinx.po | 45 + docs/locale/it/LC_MESSAGES/usage.po | 1346 +++++++++++++++++ docs/locale/pt/LC_MESSAGES/api/index.po | 54 + docs/locale/pt/LC_MESSAGES/authors.po | 59 + docs/locale/pt/LC_MESSAGES/contributing.po | 42 + docs/locale/pt/LC_MESSAGES/docs.po | 183 +++ docs/locale/pt/LC_MESSAGES/examples.po | 588 +++++++ docs/locale/pt/LC_MESSAGES/index.po | 34 + docs/locale/pt/LC_MESSAGES/installation.po | 72 + docs/locale/pt/LC_MESSAGES/introduction.po | 74 + docs/locale/pt/LC_MESSAGES/model.po | 237 +++ docs/locale/pt/LC_MESSAGES/sphinx.po | 45 + docs/locale/pt/LC_MESSAGES/usage.po | 1340 ++++++++++++++++ .../examples/clamped_beam_displacement.png | Bin 0 -> 20301 bytes .../_static/examples/clamped_beam_energy.png | Bin 0 -> 28924 bytes .../examples/clamped_beam_reaction.png | Bin 0 -> 18787 bytes .../_static/examples/tension_energy.png | Bin 0 -> 26182 bytes docs/source/_templates/page.html | 65 + docs/source/_templates/sidebar/languages.html | 21 +- docs/source/api/index.rst | 35 +- docs/source/{en => }/authors.rst | 2 +- docs/source/conf.py | 10 +- docs/source/{en => }/contributing.rst | 0 docs/source/docs.rst | 88 ++ docs/source/en/docs.rst | 67 - docs/source/en/index.rst | 13 - docs/source/es/authors.rst | 18 - docs/source/es/contributing.rst | 16 - docs/source/es/docs.rst | 68 - docs/source/es/index.rst | 13 - docs/source/es/installation.rst | 37 - docs/source/es/introduction.rst | 25 - docs/source/es/model.rst | 116 -- docs/source/es/usage.rst | 368 ----- docs/source/examples.rst | 311 ++++ docs/source/index.rst | 36 +- docs/source/{en => }/installation.rst | 0 docs/source/{en => }/introduction.rst | 6 +- docs/source/it/authors.rst | 18 - docs/source/it/contributing.rst | 16 - docs/source/it/docs.rst | 67 - docs/source/it/index.rst | 13 - docs/source/it/installation.rst | 37 - docs/source/it/introduction.rst | 24 - docs/source/it/model.rst | 117 -- docs/source/it/usage.rst | 367 ----- docs/source/{en => }/model.rst | 7 +- docs/source/pt/authors.rst | 17 - docs/source/pt/contributing.rst | 16 - docs/source/pt/docs.rst | 68 - docs/source/pt/index.rst | 13 - docs/source/pt/installation.rst | 37 - docs/source/pt/introduction.rst | 24 - docs/source/pt/model.rst | 116 -- docs/source/pt/usage.rst | 368 ----- docs/source/{en => }/usage.rst | 98 +- docs/tools/build_docs.py | 65 + docs/tools/update_translations.py | 156 ++ examples/README.md | 74 +- src/+ldem/+io/readCase.m | 2 +- 87 files changed, 9052 insertions(+), 2226 deletions(-) create mode 100644 docs/locale/es/LC_MESSAGES/api/index.po create mode 100644 docs/locale/es/LC_MESSAGES/authors.po create mode 100644 docs/locale/es/LC_MESSAGES/contributing.po create mode 100644 docs/locale/es/LC_MESSAGES/docs.po create mode 100644 docs/locale/es/LC_MESSAGES/examples.po create mode 100644 docs/locale/es/LC_MESSAGES/index.po create mode 100644 docs/locale/es/LC_MESSAGES/installation.po create mode 100644 docs/locale/es/LC_MESSAGES/introduction.po create mode 100644 docs/locale/es/LC_MESSAGES/model.po create mode 100644 docs/locale/es/LC_MESSAGES/sphinx.po create mode 100644 docs/locale/es/LC_MESSAGES/usage.po create mode 100644 docs/locale/it/LC_MESSAGES/api/index.po create mode 100644 docs/locale/it/LC_MESSAGES/authors.po create mode 100644 docs/locale/it/LC_MESSAGES/contributing.po create mode 100644 docs/locale/it/LC_MESSAGES/docs.po create mode 100644 docs/locale/it/LC_MESSAGES/examples.po create mode 100644 docs/locale/it/LC_MESSAGES/index.po create mode 100644 docs/locale/it/LC_MESSAGES/installation.po create mode 100644 docs/locale/it/LC_MESSAGES/introduction.po create mode 100644 docs/locale/it/LC_MESSAGES/model.po create mode 100644 docs/locale/it/LC_MESSAGES/sphinx.po create mode 100644 docs/locale/it/LC_MESSAGES/usage.po create mode 100644 docs/locale/pt/LC_MESSAGES/api/index.po create mode 100644 docs/locale/pt/LC_MESSAGES/authors.po create mode 100644 docs/locale/pt/LC_MESSAGES/contributing.po create mode 100644 docs/locale/pt/LC_MESSAGES/docs.po create mode 100644 docs/locale/pt/LC_MESSAGES/examples.po create mode 100644 docs/locale/pt/LC_MESSAGES/index.po create mode 100644 docs/locale/pt/LC_MESSAGES/installation.po create mode 100644 docs/locale/pt/LC_MESSAGES/introduction.po create mode 100644 docs/locale/pt/LC_MESSAGES/model.po create mode 100644 docs/locale/pt/LC_MESSAGES/sphinx.po create mode 100644 docs/locale/pt/LC_MESSAGES/usage.po create mode 100644 docs/source/_static/examples/clamped_beam_displacement.png create mode 100644 docs/source/_static/examples/clamped_beam_energy.png create mode 100644 docs/source/_static/examples/clamped_beam_reaction.png create mode 100644 docs/source/_static/examples/tension_energy.png create mode 100644 docs/source/_templates/page.html rename docs/source/{en => }/authors.rst (92%) rename docs/source/{en => }/contributing.rst (100%) create mode 100644 docs/source/docs.rst delete mode 100644 docs/source/en/docs.rst delete mode 100644 docs/source/en/index.rst delete mode 100644 docs/source/es/authors.rst delete mode 100644 docs/source/es/contributing.rst delete mode 100644 docs/source/es/docs.rst delete mode 100644 docs/source/es/index.rst delete mode 100644 docs/source/es/installation.rst delete mode 100644 docs/source/es/introduction.rst delete mode 100644 docs/source/es/model.rst delete mode 100644 docs/source/es/usage.rst create mode 100644 docs/source/examples.rst rename docs/source/{en => }/installation.rst (100%) rename docs/source/{en => }/introduction.rst (78%) delete mode 100644 docs/source/it/authors.rst delete mode 100644 docs/source/it/contributing.rst delete mode 100644 docs/source/it/docs.rst delete mode 100644 docs/source/it/index.rst delete mode 100644 docs/source/it/installation.rst delete mode 100644 docs/source/it/introduction.rst delete mode 100644 docs/source/it/model.rst delete mode 100644 docs/source/it/usage.rst rename docs/source/{en => }/model.rst (94%) delete mode 100644 docs/source/pt/authors.rst delete mode 100644 docs/source/pt/contributing.rst delete mode 100644 docs/source/pt/docs.rst delete mode 100644 docs/source/pt/index.rst delete mode 100644 docs/source/pt/installation.rst delete mode 100644 docs/source/pt/introduction.rst delete mode 100644 docs/source/pt/model.rst delete mode 100644 docs/source/pt/usage.rst rename docs/source/{en => }/usage.rst (99%) create mode 100644 docs/tools/build_docs.py create mode 100644 docs/tools/update_translations.py diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml index 1e2524c..28ee977 100644 --- a/.github/workflows/docs.yml +++ b/.github/workflows/docs.yml @@ -22,8 +22,8 @@ jobs: - run: pip install -r docs/requirements.txt - # -W turns warnings into errors: the documentation is warning-free. - - run: sphinx-build -W --keep-going -b html docs/source docs/build/html + # Builds English, Spanish, Portuguese and Italian; warnings are errors (-W). + - run: python docs/tools/build_docs.py - uses: peaceiris/actions-gh-pages@v4 if: github.ref == 'refs/heads/main' diff --git a/.gitignore b/.gitignore index 3ad5b82..420c346 100644 --- a/.gitignore +++ b/.gitignore @@ -26,6 +26,7 @@ test-results/ code-coverage/ # Python / Sphinx (docs) +docs/locale/**/*.mo __pycache__/ .venv/ docs/build/ diff --git a/CHANGELOG.md b/CHANGELOG.md index f5c2043..df4d7f4 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -2,6 +2,22 @@ ## [Unreleased] ### Added +- Documentation of the examples (user guide page *Examples*, in the four languages): the model, files, + how to run and what to expect of the bi-clamped beam (`example1_clamped_beam`), the uniaxial prism + (`tension_101`) and the four-point bending beam (`beam_102`), with figures and numbers taken from + running them with the current code; `examples/README.md` brought up to date. The three examples run + from start to finish (about 35 s, 6 s and 30 s for its first 50 steps). +- Documentation in one language and translated: the English pages in `docs/source/` are + the only source, and Spanish, Portuguese and Italian are gettext catalogs + (`docs/locale//LC_MESSAGES/.po`) instead of copies of every page, so a + translation cannot drift from the English text (it had: some Portuguese and Italian + sentences differed from the English ones). `docs/tools/build_docs.py` builds each language + as its own site in `docs/build/html//` with a root page that opens the English + one; every page has a language selector in the sidebar; untranslated text falls back to + English. `docs/tools/update_translations.py` updates the catalogs after the English text + changes (changed sentences are marked fuzzy) and `--status` reports what is left. The tables + of case-file keys are translated too. The "Made with Sphinx and Furo" line of the footer is + removed. `buildtool docs`, the CI workflow and `make html` use the new script. - Case files (`.ldem`): a readable, commented input file that replaces `DATA0.DAT` and describes the whole model (mesh, material, random scatter, time, damping, scenario, control nodes, output). Keys are read by name, numbers diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index ffe07ce..8cf55d1 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -55,7 +55,7 @@ errors with an identifier of the form `ldem::`. | `buildtool check` | Code Analyzer on `src/`, `tests/` and `examples/`; any warning fails | | `buildtool test` | Fast tests; writes `test-results/results.xml` and `code-coverage/coverage.xml` | | `buildtool testAll` | Also the slow tests (complete beam model) | -| `buildtool docs` | Sphinx HTML in `docs/build/html` (needs Python and `docs/requirements.txt`) | +| `buildtool docs` | Sphinx HTML in every language, in `docs/build/html/` (needs Python and `docs/requirements.txt`) | | `buildtool clean` | Delete the generated files | `run_tests` (in `tests/`) is a lighter alternative that only runs the tests. diff --git a/README.md b/README.md index 0a79183..f36eb9b 100644 --- a/README.md +++ b/README.md @@ -44,7 +44,7 @@ The API reference is generated automatically from the comments of the ```bash pip install -r docs/requirements.txt -sphinx-build -b html docs/source docs/build/html +python docs/tools/build_docs.py ``` Comments are written in English (the original code is in the git history under @@ -96,7 +96,7 @@ A referência da API é gerada automaticamente a partir dos comentários dos ```bash pip install -r docs/requirements.txt -sphinx-build -b html docs/source docs/build/html +python docs/tools/build_docs.py ``` Os comentários estão em inglês (o código original está no histórico do git, na @@ -147,7 +147,7 @@ los `.m` con Sphinx y `sphinxcontrib-matlabdomain`: ```bash pip install -r docs/requirements.txt -sphinx-build -b html docs/source docs/build/html +python docs/tools/build_docs.py ``` Los comentarios están en inglés (el código original está en el historial de git, diff --git a/buildfile.m b/buildfile.m index 691d8f0..1eeb030 100644 --- a/buildfile.m +++ b/buildfile.m @@ -19,7 +19,7 @@ % (Cobertura) and prints the coverage of the ldem package. % testAll Same as test but including the slow tests (they build the % complete beam model of the example, about 167,000 nodes). -% docs Builds the HTML documentation in docs/build/html. +% docs Builds the HTML documentation, in every language, in docs/build/html. % clean Deletes test-results/, code-coverage/ and docs/build/. % % See also run_tests, buildplan. @@ -53,9 +53,9 @@ function testAllTask(context) function docsTask(context) % Build the Sphinx documentation. root = context.Plan.RootFolder; -source = fullfile(root, 'docs', 'source'); +script = fullfile(root, 'docs', 'tools', 'build_docs.py'); target = fullfile(root, 'docs', 'build', 'html'); -command = sprintf('python -m sphinx -W --keep-going -b html "%s" "%s"', source, target); +command = sprintf('python "%s"', script); [status, output] = system(command); if status ~= 0 error('build:docs', ['Sphinx failed (is Python with docs/requirements.txt installed?):' newline '%s'], output); diff --git a/docs/Makefile b/docs/Makefile index a8cc387..255f049 100644 --- a/docs/Makefile +++ b/docs/Makefile @@ -3,7 +3,7 @@ SOURCEDIR = source BUILDDIR = build html: - $(SPHINXBUILD) -b html $(SOURCEDIR) $(BUILDDIR)/html + python tools/build_docs.py clean: rm -rf $(BUILDDIR) diff --git a/docs/locale/es/LC_MESSAGES/api/index.po b/docs/locale/es/LC_MESSAGES/api/index.po new file mode 100644 index 0000000..50f4774 --- /dev/null +++ b/docs/locale/es/LC_MESSAGES/api/index.po @@ -0,0 +1,55 @@ +# Translation of the LDEM-MATLAB documentation (es). +# Generated by docs/tools/update_translations.py: edit only the msgstr entries. +msgid "" +msgstr "" +"Project-Id-Version: LDEM-MATLAB\n" +"Report-Msgid-Bugs-To: \n" +"Last-Translator: \n" +"Language: es\n" +"Language-Team: \n" +"Plural-Forms: nplurals=2; plural=(n != 1);\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.18.0\n" + +msgid "API reference" +msgstr "Referencia de la API" + +msgid "Generated automatically from the comments of the ``.m`` files." +msgstr "Generada automáticamente desde los comentarios de los ``.m``." + +msgid "" +"The ``ldem`` package (``src/+ldem``) is the refactored code. It replaces the original" +" routines, which are kept in the git history (tag ``legacy-reference``); the problems" +" found in them are listed in ``docs/known-issues/KNOWN_ISSUES.md``." +msgstr "" +"El paquete ``ldem`` (``src/+ldem``) es el código refactorizado. Reemplaza a las " +"rutinas originales, que se conservan en el historial de git (etiqueta ``legacy-" +"reference``); los problemas encontrados en ellas se listan en ``docs/known-" +"issues/KNOWN_ISSUES.md``." + +msgid "Running a simulation" +msgstr "Ejecutar una simulación" + +msgid "Input and output" +msgstr "Entrada y salida" + +msgid "Mesh" +msgstr "Malla" + +msgid "Material" +msgstr "Material" + +msgid "Scenarios" +msgstr "Escenarios de ensayo" + +msgid "Case-file schema" +msgstr "Esquema de los archivos de caso" + +msgid "Solver" +msgstr "" + +msgid "Post-processing" +msgstr "Postproceso" + diff --git a/docs/locale/es/LC_MESSAGES/authors.po b/docs/locale/es/LC_MESSAGES/authors.po new file mode 100644 index 0000000..fdb6d4f --- /dev/null +++ b/docs/locale/es/LC_MESSAGES/authors.po @@ -0,0 +1,59 @@ +# Translation of the LDEM-MATLAB documentation (es). +# Generated by docs/tools/update_translations.py: edit only the msgstr entries. +msgid "" +msgstr "" +"Project-Id-Version: LDEM-MATLAB\n" +"Report-Msgid-Bugs-To: \n" +"Last-Translator: \n" +"Language: es\n" +"Language-Team: \n" +"Plural-Forms: nplurals=2; plural=(n != 1);\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.18.0\n" + +msgid "Authors" +msgstr "Autores" + +msgid "" +"This list is generated automatically from the commits of the git history (people with" +" the same name or e-mail are merged through ``.mailmap``) and from the authors of " +"``CITATION.cff``. Authors without commits in this repository appear with ``-``. The " +"same list is in ``AUTHORS.md``." +msgstr "" +"Esta lista se genera automáticamente desde los commits del historial de git (las " +"personas con el mismo nombre o correo se unifican con ``.mailmap``) y desde los " +"autores de ``CITATION.cff``. Los autores sin commits en este repositorio aparecen con" +" ``-``. La misma lista está en ``AUTHORS.md``." + +msgid "Name" +msgstr "Nombre" + +msgid "Commits" +msgstr "" + +msgid "Boris Rojo Tanzi" +msgstr "" + +msgid "26" +msgstr "" + +msgid "Rodrigo Cavasotto Oscar Montanha" +msgstr "" + +msgid "7" +msgstr "" + +msgid "Ignacio Iturrioz" +msgstr "" + +msgid "To update it after new commits, build the documentation or run:" +msgstr "Para actualizarla después de nuevos commits, construir la documentación o ejecutar:" + +msgid "python docs/tools/generate_authors.py" +msgstr "" + +msgid "If a person appears twice, add a line to ``.mailmap``." +msgstr "Si una persona aparece dos veces, agregar una línea a ``.mailmap``." + diff --git a/docs/locale/es/LC_MESSAGES/contributing.po b/docs/locale/es/LC_MESSAGES/contributing.po new file mode 100644 index 0000000..7ae6ad0 --- /dev/null +++ b/docs/locale/es/LC_MESSAGES/contributing.po @@ -0,0 +1,43 @@ +# Translation of the LDEM-MATLAB documentation (es). +# Generated by docs/tools/update_translations.py: edit only the msgstr entries. +msgid "" +msgstr "" +"Project-Id-Version: LDEM-MATLAB\n" +"Report-Msgid-Bugs-To: \n" +"Last-Translator: \n" +"Language: es\n" +"Language-Team: \n" +"Plural-Forms: nplurals=2; plural=(n != 1);\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.18.0\n" + +msgid "Contributing" +msgstr "Contribuir" + +msgid "" +"The API documentation is generated from the ``.m`` comments. The docstring must be " +"the comment block placed **immediately after** the ``function`` line (before any " +"``global`` declaration). Source comments are written in English." +msgstr "" +"La documentación de la API se genera desde los comentarios de los ``.m``. El " +"docstring debe ser el bloque de comentarios ubicado **inmediatamente después** de la " +"línea ``function`` (antes de cualquier ``global``). Los comentarios del código se " +"escriben en inglés." + +#, python-format +msgid "" +"function ini = CALOAD()\n" +"% CALOAD One-line summary.\n" +"% Longer description.\n" +"global ..." +msgstr "" +"function ini = CALOAD()\n" +"% CALOAD Resumen en una línea.\n" +"% Descripción más larga.\n" +"global ..." + +msgid "See ``CONTRIBUTING.md`` in the repository root." +msgstr "Ver ``CONTRIBUTING.md`` en la raíz del repositorio." + diff --git a/docs/locale/es/LC_MESSAGES/docs.po b/docs/locale/es/LC_MESSAGES/docs.po new file mode 100644 index 0000000..40e780b --- /dev/null +++ b/docs/locale/es/LC_MESSAGES/docs.po @@ -0,0 +1,183 @@ +# Translation of the LDEM-MATLAB documentation (es). +# Generated by docs/tools/update_translations.py: edit only the msgstr entries. +msgid "" +msgstr "" +"Project-Id-Version: LDEM-MATLAB\n" +"Report-Msgid-Bugs-To: \n" +"Last-Translator: \n" +"Language: es\n" +"Language-Team: \n" +"Plural-Forms: nplurals=2; plural=(n != 1);\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.18.0\n" + +msgid "Building this documentation" +msgstr "Construir esta documentación" + +msgid "" +"The documentation is written in English, which is the only set of source pages, and " +"translated into Spanish, Portuguese and Italian with gettext catalogs (``.po`` files " +"in ``docs/locale/``). Each language is built as its own site and the sidebar has a " +"language selector. A text that is not translated yet is shown in English. The API " +"reference is generated from the comments of the ``.m`` files and is in English only." +msgstr "" +"La documentación está escrita en inglés, que es el único conjunto de páginas fuente, " +"y traducida al español, portugués e italiano con catálogos gettext (archivos ``.po`` " +"en ``docs/locale/``). Cada idioma se construye como un sitio propio y la barra " +"lateral tiene un selector de idioma. Un texto que aún no está traducido se muestra en" +" inglés. La referencia de la API se genera desde los comentarios de los archivos " +"``.m`` y está solo en inglés." + +msgid "Requirements" +msgstr "Requisitos" + +msgid "Python 3.9 or newer." +msgstr "Python 3.9 o superior." + +msgid "" +"``git`` (the list of authors is generated from the commit history; with a shallow " +"clone use ``git fetch --unshallow`` first)." +msgstr "" +"``git`` (la lista de autores se genera desde el historial de commits; con un clon " +"superficial ejecutar antes ``git fetch --unshallow``)." + +msgid "No MATLAB is needed; the API is read from the source text." +msgstr "No se necesita MATLAB; la API se lee del texto de las fuentes." + +msgid "pip install -r docs/requirements.txt" +msgstr "" + +msgid "Build" +msgstr "Construcción" + +msgid "From the repository root, with any of these:" +msgstr "Desde la raíz del repositorio, con cualquiera de estas opciones:" + +msgid "python docs/tools/build_docs.py" +msgstr "" + +msgid "cd docs && make html" +msgstr "" + +msgid ">> buildtool docs" +msgstr "" + +msgid "" +"This builds the four languages into ``docs/build/html/en``, ``es``, ``pt`` and " +"``it``; ``docs/build/html/index.html`` sends the reader to the English site. Open it " +"in a browser. To build only some languages use for example ``python " +"docs/tools/build_docs.py --languages en es``. Warnings are errors: the documentation " +"must build without any. ``buildtool clean`` deletes the result." +msgstr "" +"Esto construye los cuatro idiomas en ``docs/build/html/en``, ``es``, ``pt`` e ``it``;" +" ``docs/build/html/index.html`` lleva al lector al sitio en inglés. Ábralo en un " +"navegador. Para construir solo algunos idiomas use, por ejemplo, ``python " +"docs/tools/build_docs.py --languages en es``. Las advertencias son errores: la " +"documentación debe construirse sin ninguna. ``buildtool clean`` borra el resultado." + +msgid "Where things are" +msgstr "Dónde está cada cosa" + +msgid "``docs/source/``" +msgstr "" + +msgid "The pages, in English." +msgstr "Las páginas, en inglés." + +msgid "``docs/locale/es/``, ``pt/``, ``it/``" +msgstr "" + +msgid "" +"Translations: one ``.po`` file per page in ``LC_MESSAGES/``, with each English text " +"and its translation." +msgstr "" +"Traducciones: un archivo ``.po`` por página en ``LC_MESSAGES/``, con cada texto en " +"inglés y su traducción." + +msgid "``docs/source/api/``" +msgstr "" + +msgid "API reference, generated from the ``.m`` comments." +msgstr "Referencia de la API, generada desde los comentarios de los ``.m``." + +msgid "``docs/tools/build_docs.py``" +msgstr "" + +msgid "Builds every language and the page that sends the reader to the English site." +msgstr "Construye cada idioma y la página que lleva al lector al sitio en inglés." + +msgid "``docs/tools/update_translations.py``" +msgstr "" + +msgid "" +"Updates the ``.po`` files after the English text changes, and reports what is left to" +" translate." +msgstr "" +"Actualiza los archivos ``.po`` cuando cambia el texto en inglés e informa lo que " +"falta traducir." + +msgid "``docs/tools/generate_authors.py``" +msgstr "" + +msgid "Writes the authors page and ``AUTHORS.md`` (run by the build)." +msgstr "Escribe la página de autores y ``AUTHORS.md`` (lo ejecuta la construcción)." + +msgid "``docs/source/case-keys.inc``" +msgstr "" + +msgid "" +"Reference of the case-file keys, generated from the schema. After changing " +"``ldem.schema.caseSchema`` regenerate it from MATLAB with " +"``ldem.schema.writeKeyReference(\"docs/source/case-keys.inc\")``; a test fails if it " +"is out of date." +msgstr "" +"Referencia de las claves del archivo de caso, generada desde el esquema. Tras cambiar" +" ``ldem.schema.caseSchema`` se regenera desde MATLAB con " +"``ldem.schema.writeKeyReference(\"docs/source/case-keys.inc\")``; un test falla si " +"está desactualizada." + +msgid "Write or change a page" +msgstr "Escribir o cambiar una página" + +msgid "" +"Edit the English page in ``docs/source/``. A new page also goes in the list of " +"``index.rst``." +msgstr "" +"Edite la página en inglés en ``docs/source/``. Una página nueva también se agrega a " +"la lista de ``index.rst``." + +msgid "" +"Run ``python docs/tools/update_translations.py``. It extracts the texts and updates " +"the ``.po`` files: new texts appear untranslated and changed texts are marked as " +"fuzzy, both shown in English until they are translated." +msgstr "" +"Ejecute ``python docs/tools/update_translations.py``. Extrae los textos y actualiza " +"los archivos ``.po``: los textos nuevos aparecen sin traducir y los textos cambiados " +"se marcan como fuzzy; ambos se muestran en inglés hasta que se traduzcan." + +msgid "" +"Translate the new entries in ``docs/locale//LC_MESSAGES/.po`` (with " +"any text editor or a tool such as Poedit) and remove the fuzzy marks you have " +"reviewed. ``python docs/tools/update_translations.py --status`` shows how much is " +"left in each language." +msgstr "" +"Traduzca las entradas nuevas en ``docs/locale//LC_MESSAGES/.po`` (con" +" cualquier editor de texto o una herramienta como Poedit) y quite las marcas fuzzy " +"que haya revisado. ``python docs/tools/update_translations.py --status`` muestra " +"cuánto falta en cada idioma." + +msgid "Build with ``python docs/tools/build_docs.py`` and fix any warning." +msgstr "Construya con ``python docs/tools/build_docs.py`` y corrija cualquier advertencia." + +msgid "Publishing" +msgstr "Publicación" + +msgid "" +"The workflow ``.github/workflows/docs.yml`` builds the documentation on every pull " +"request and publishes the four languages to GitHub Pages when ``main`` changes." +msgstr "" +"El workflow ``.github/workflows/docs.yml`` construye la documentación en cada pull " +"request y publica los cuatro idiomas en GitHub Pages cuando cambia ``main``." + diff --git a/docs/locale/es/LC_MESSAGES/examples.po b/docs/locale/es/LC_MESSAGES/examples.po new file mode 100644 index 0000000..a46c964 --- /dev/null +++ b/docs/locale/es/LC_MESSAGES/examples.po @@ -0,0 +1,587 @@ +# Translation of the LDEM-MATLAB documentation (es). +# Generated by docs/tools/update_translations.py: edit only the msgstr entries. +msgid "" +msgstr "" +"Project-Id-Version: LDEM-MATLAB\n" +"Report-Msgid-Bugs-To: \n" +"Last-Translator: \n" +"Language: es\n" +"Language-Team: \n" +"Plural-Forms: nplurals=2; plural=(n != 1);\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.18.0\n" + +msgid "Examples" +msgstr "Ejemplos" + +msgid "" +"The folder ``examples/`` has three models that run from start to finish, each with " +"its inputs and a script that runs it and plots the results. The numbers in this page " +"come from running them with the current code." +msgstr "" +"La carpeta ``examples/`` tiene tres modelos que se ejecutan de principio a fin, cada " +"uno con sus datos de entrada y un script que lo ejecuta y grafica los resultados. Los" +" números de esta página salen de ejecutarlos con el código actual." + +msgid "Folder" +msgstr "Carpeta" + +msgid "What it shows" +msgstr "Qué muestra" + +msgid "Size" +msgstr "Tamaño" + +msgid "Time" +msgstr "Tiempo" + +msgid "``example1_clamped_beam/``" +msgstr "" + +msgid "A beam clamped at both ends and loaded with a force at mid-span" +msgstr "Una viga empotrada en ambos extremos y cargada con una fuerza en el centro del vano" + +msgid "3,086 nodes" +msgstr "3,086 nodos" + +msgid "about 35 s" +msgstr "unos 35 s" + +msgid "``tension_101/``" +msgstr "" + +msgid "A small prism under a uniaxial load, with damage and every output format" +msgstr "Un prisma pequeño bajo carga uniaxial, con daño y todos los formatos de salida" + +msgid "74 nodes" +msgstr "74 nodos" + +msgid "about 6 s" +msgstr "unos 6 s" + +msgid "``beam_102/``" +msgstr "" + +msgid "The four-point bending beam of the paper (a demo of its first 50 steps)" +msgstr "" +"La viga a flexión en cuatro puntos del artículo (una demostración de sus primeros 50 " +"pasos)" + +msgid "166,961 nodes" +msgstr "166,961 nodos" + +msgid "about 30 s for 50 steps" +msgstr "unos 30 s para 50 pasos" + +msgid "" +"Start with ``tension_101`` to learn the interface and with ``example1_clamped_beam`` " +"to see a model loaded with a force, described by a case file and checked against the " +"original code." +msgstr "" +"Comience con ``tension_101`` para aprender la interfaz y con " +"``example1_clamped_beam`` para ver un modelo cargado con una fuerza, descrito con un " +"archivo de caso y verificado contra el código original." + +msgid "Running an example" +msgstr "Ejecutar un ejemplo" + +msgid "From MATLAB, from any folder:" +msgstr "Desde MATLAB, desde cualquier carpeta:" + +#, python-format +msgid "" +">> run('examples/example1_clamped_beam/runClampedBeam.m') % script: run and" +" plot\n" +">> results = ldem.run('examples/example1_clamped_beam/case.ldem'); % from the case " +"file" +msgstr "" +">> run('examples/example1_clamped_beam/runClampedBeam.m') % script: ejecuta" +" y grafica\n" +">> results = ldem.run('examples/example1_clamped_beam/case.ldem'); % desde el " +"archivo de caso" + +msgid "" +"The two beam examples also have a ``case.ldem``: the same model in the readable case-" +"file format (see :doc:`usage`), generated from the ``DATA0.DAT`` of the original " +"program and giving the same parameters. ``ldem.check`` shows what a case file would " +"simulate without running it." +msgstr "" +"Los dos ejemplos de viga también tienen un ``case.ldem``: el mismo modelo en el " +"formato legible de archivo de caso (ver :doc:`usage`), generado a partir del " +"``DATA0.DAT`` del programa original y que da los mismos parámetros. ``ldem.check`` " +"muestra qué simularía un archivo de caso sin ejecutarlo." + +msgid "" +"The scripts write their files to a folder ``output`` next to the script (ignored by " +"git), or to ``outputFolder`` if that variable already exists:" +msgstr "" +"Los scripts escriben sus archivos en una carpeta ``output`` junto al script (ignorada" +" por git), o en ``outputFolder`` si esa variable ya existe:" + +msgid "" +"``results.mat``: one struct, ``results``, with everything that was recorded. Load it " +"with ``data = load('results.mat'); results = data.results;``." +msgstr "" +"``results.mat``: una estructura, ``results``, con todo lo que se registró. Se carga " +"con ``data = load('results.mat'); results = data.results;``." + +msgid "``snapshot_0000.mac``, ...: ANSYS macro files of the deformed lattice." +msgstr "``snapshot_0000.mac``, ...: archivos macro de ANSYS de la malla deformada." + +msgid "" +"``snapshot_0000.vtu``, ... and ``snapshots.pvd``: open ``snapshots.pvd`` in `ParaView" +" `_ to see the damage evolve in time." +msgstr "" +"``snapshot_0000.vtu``, ... y ``snapshots.pvd``: abra ``snapshots.pvd`` en `ParaView " +"`_ para ver cómo evoluciona el daño en el tiempo." + +msgid "Example 1: beam clamped at both ends" +msgstr "Ejemplo 1: viga empotrada en ambos extremos" + +msgid "" +"A small beam of 5 x 5 x 50 modules of 1 mm, clamped at both ends and loaded at mid-" +"span with a force that grows during 0.35 ms and then stays constant. It is the model " +"of Rodrigo (branch ``dev_rodrigo``) and the first test loaded with a force instead of" +" a displacement (``ldem.scenarios.ClampedBeam``, test 103)." +msgstr "" +"Una viga pequeña de 5 x 5 x 50 módulos de 1 mm, empotrada en ambos extremos y cargada" +" en el centro del vano con una fuerza que crece durante 0.35 ms y luego se mantiene " +"constante. Es el modelo de Rodrigo (rama ``dev_rodrigo``) y el primer ensayo cargado " +"con una fuerza en lugar de un desplazamiento (``ldem.scenarios.ClampedBeam``, ensayo " +"103)." + +msgid "The model" +msgstr "El modelo" + +msgid "Part" +msgstr "Parte" + +msgid "Value" +msgstr "Valor" + +msgid "Geometry" +msgstr "Geometría" + +msgid "" +"5 x 5 x 50 modules of 1 mm (a prism of 5 x 5 x 50 mm, axis along z), with 3,086 " +"nodes, 18,085 bars and a mass of 1.875 g" +msgstr "" +"5 x 5 x 50 módulos de 1 mm (un prisma de 5 x 5 x 50 mm, eje a lo largo de z), con " +"3,086 nodos, 18,085 barras y una masa de 1.875 g" + +msgid "Supports" +msgstr "Apoyos" + +msgid "" +"The centre nodes of the first and of the last layer of modules (z = 0.5 and z = 49.5 " +"modules) are clamped: x, y and z held" +msgstr "" +"Los nodos centrales de la primera y de la última capa de módulos (z = 0.5 y z = 49.5 " +"módulos) están empotrados: x, y y z fijos" + +msgid "Load" +msgstr "Carga" + +msgid "" +"The 5 centre nodes of the line at mid-span (z = 24.5 modules, y = 0.5 modules) carry " +"a force in +y of ``1000 N/s * min(t, 0.35 ms)`` each: 0.35 N per node, 1.75 N in " +"total" +msgstr "" +"Los 5 nodos centrales de la línea en el centro del vano (z = 24.5 módulos, y = 0.5 " +"módulos) llevan cada uno una fuerza en +y de ``1000 N/s * min(t, 0.35 ms)``: 0.35 N " +"por nodo, 1.75 N en total" + +msgid "Material" +msgstr "Material" + +msgid "" +"E = 3.87 GPa, Poisson's ratio 0.25, density 1500 kg/m\\ :sup:`3`, fracture energy 0.5" +" N/m, critical distance 4.5 mm; mass-proportional damping of 2500 1/s" +msgstr "" +"E = 3.87 GPa, coeficiente de Poisson 0.25, densidad 1500 kg/m\\ :sup:`3`, energía de " +"fractura 0.5 N/m, distancia crítica 4.5 mm; amortiguamiento proporcional a la masa de" +" 2500 1/s" + +msgid "Scatter" +msgstr "Dispersión" + +msgid "" +"One multiplier of the critical strain per bar, read from a file (shared with " +"``beam_102``)" +msgstr "" +"Un multiplicador de la deformación crítica por barra, leído de un archivo (compartido" +" con ``beam_102``)" + +#, python-format +msgid "2.8 ms in 8000 steps of 0.35 us (65 % of the critical step)" +msgstr "2.8 ms en 8000 pasos de 0.35 us (65 % del paso crítico)" + +msgid "Recorded" +msgstr "Registrado" + +msgid "" +"Control nodes 2441 (a loaded node) and 884 (a grid node at mid-span); tracked bar " +"14398" +msgstr "" +"Nodos de control 2441 (un nodo cargado) y 884 (un nodo de esquina en el centro del " +"vano); barra seguida 14398" + +msgid "" +"The original input file listed five control nodes, but nodes 6870 and 14398 do not " +"exist in this 3,086-node mesh, so the input keeps 2441 and 884. The tracked bar is " +"14398, as in the original." +msgstr "" +"El archivo de entrada original listaba cinco nodos de control, pero los nodos 6870 y " +"14398 no existen en esta malla de 3,086 nodos, así que la entrada conserva 2441 y " +"884. La barra seguida es la 14398, como en el original." + +msgid "Files" +msgstr "Archivos" + +msgid "File" +msgstr "Archivo" + +msgid "Purpose" +msgstr "Propósito" + +msgid "``case.ldem``" +msgstr "" + +msgid "The model as a case file: run it with ``ldem.run``" +msgstr "El modelo como archivo de caso: se ejecuta con ``ldem.run``" + +msgid "``runClampedBeam.m``" +msgstr "" + +msgid "" +"Reads ``DATA0.DAT``, runs the simulation and plots the force on the clamped ends, the" +" vertical displacement of the control nodes and the energies" +msgstr "" +"Lee ``DATA0.DAT``, ejecuta la simulación y grafica la fuerza en los extremos " +"empotrados, el desplazamiento vertical de los nodos de control y las energías" + +msgid "``DATA0.DAT``" +msgstr "" + +msgid "The parameters in the format of the original program (``TEST 103``)" +msgstr "Los parámetros en el formato del programa original (``TEST 103``)" + +msgid "" +"The scenario and the load are the lines of the ``[scenario]`` section of " +"``case.ldem``:" +msgstr "El escenario y la carga son las líneas de la sección ``[scenario]`` de ``case.ldem``:" + +msgid "" +"[scenario]\n" +"type = \"clamped_beam\"\n" +"force_rate = 1000 N/s\n" +"ramp_time = 0.35 ms\n" +"load_position = \"midspan\"\n" +"load_height = 0.5 modules" +msgstr "" + +msgid "" +"The same test can be written without a scenario class, with supports and loads. It " +"gives the same results as ``ldem.scenarios.ClampedBeam`` (the tests check it):" +msgstr "" +"El mismo ensayo se puede escribir sin una clase de escenario, con apoyos y cargas. Da" +" los mismos resultados que ``ldem.scenarios.ClampedBeam`` (los tests lo comprueban):" + +msgid "" +"[scenario]\n" +"type = \"custom\"\n" +"\n" +"[[support]]\n" +"name = \"first end\"\n" +"z = 0.5\n" +"fix = [\"x\", \"y\", \"z\"]\n" +"reaction = true\n" +"\n" +"[[support]]\n" +"name = \"last end\"\n" +"z = \"max - 0.5\"\n" +"fix = [\"x\", \"y\", \"z\"]\n" +"reaction = true\n" +"\n" +"[[load]]\n" +"name = \"line at mid-span\"\n" +"y = 0.5\n" +"z = \"mid - 0.5\"\n" +"direction = \"y\"\n" +"type = \"force\"\n" +"time_function = \"ramp\"\n" +"rate = 1000 N/s\n" +"until = 0.35 ms" +msgstr "" + +msgid "Reading the results" +msgstr "Leer los resultados" + +#, python-format +msgid "" +">> results = ldem.run('examples/example1_clamped_beam/case.ldem', " +"OutputFolder=tempname);\n" +">> y0 = results.mesh.nodes0(results.params.controlNodes, 2).';\n" +">> dy = results.controlNodes.displacement(:, :, 2) - y0; % vertical displacement " +"[m]\n" +">> results.reactions.force(end, :) % force on the clamped " +"ends [N]\n" +">> ldem.post.plotReaction(results);\n" +">> ldem.post.plotEnergy(results);" +msgstr "" +">> results = ldem.run('examples/example1_clamped_beam/case.ldem', " +"OutputFolder=tempname);\n" +">> y0 = results.mesh.nodes0(results.params.controlNodes, 2).';\n" +">> dy = results.controlNodes.displacement(:, :, 2) - y0; % desplazamiento vertical " +"[m]\n" +">> results.reactions.force(end, :) % fuerza en los extremos" +" empotrados [N]\n" +">> ldem.post.plotReaction(results);\n" +">> ldem.post.plotEnergy(results);" + +msgid "What you should see" +msgstr "Qué se debería ver" + +msgid "" +"Force carried by the clamped ends. It rises with the load, overshoots to 1.94 N and " +"settles at the total applied force." +msgstr "" +"Fuerza que soportan los extremos empotrados. Crece con la carga, sobrepasa hasta 1.94" +" N y se estabiliza en la fuerza total aplicada." + +msgid "" +"Vertical displacement of the two control nodes: a peak of 6.7 um at 0.46 ms and about" +" 6.3 um at the end." +msgstr "" +"Desplazamiento vertical de los dos nodos de control: un pico de 6.7 um a los 0.46 ms " +"y unos 6.3 um al final." + +msgid "Energies. The external work equals the sum of the internal energies." +msgstr "Energías. El trabajo externo es igual a la suma de las energías internas." + +msgid "" +"The reaction settles at 1.75 N, the 1.75 N applied in total: the beam is in " +"equilibrium at the end. The overshoot (1.94 N) and the oscillation are the dynamic " +"response, which the damping removes." +msgstr "" +"La reacción se estabiliza en 1.75 N, los 1.75 N aplicados en total: la viga está en " +"equilibrio al final. El sobrepaso (1.94 N) y la oscilación son la respuesta dinámica," +" que el amortiguamiento elimina." + +msgid "" +"With these values the beam stays elastic: at the end 18,085 bars are intact and none " +"is damaged or broken." +msgstr "" +"Con estos valores la viga se mantiene elástica: al final 18,085 barras están intactas" +" y ninguna está dañada ni rota." + +msgid "" +"The energy balance closes: the external work of 5.76 uJ is the elastic energy (5.48 " +"uJ) plus the energy dissipated by damping (0.28 uJ); the kinetic energy is about zero" +" and the balance is below 1e-13 J." +msgstr "" +"El balance de energía cierra: el trabajo externo de 5.76 uJ es la energía elástica " +"(5.48 uJ) más la energía disipada por amortiguamiento (0.28 uJ); la energía cinética " +"es casi cero y el balance es menor que 1e-13 J." + +msgid "Try other values" +msgstr "Probar otros valores" + +msgid "" +"Every key of the case file can be changed, or swept without editing the file (see " +":doc:`usage`):" +msgstr "" +"Cada clave del archivo de caso se puede cambiar, o barrer sin editar el archivo (ver " +":doc:`usage`):" + +#, python-brace-format +msgid "" +">> summary = ldem.sweep('examples/example1_clamped_beam/case.ldem', ...\n" +" Vary = {'scenario.force_rate', [\"10 kN/s\" \"30 kN/s\" \"100 kN/s\"]}, " +"Formats = \"mat\");" +msgstr "" + +msgid "" +"With the original value (1 kN/s) no bar is damaged. Ten times more force already " +"breaks the beam; each run takes about 50 s:" +msgstr "" +"Con el valor original (1 kN/s) ninguna barra se daña. Con diez veces más fuerza la " +"viga ya se rompe; cada corrida tarda unos 50 s:" + +msgid "Force rate" +msgstr "Tasa de fuerza" + +msgid "Damaged bars (including broken)" +msgstr "Barras dañadas (incluidas las rotas)" + +msgid "Broken bars" +msgstr "Barras rotas" + +msgid "10 kN/s" +msgstr "" + +msgid "5,630" +msgstr "" + +msgid "3,584" +msgstr "" + +msgid "30 kN/s" +msgstr "" + +msgid "6,074" +msgstr "" + +msgid "3,579" +msgstr "" + +msgid "100 kN/s" +msgstr "" + +msgid "4,760" +msgstr "" + +msgid "2,783" +msgstr "" + +msgid "" +"After the failure the loaded nodes keep being pushed by the force and move freely, so" +" the displacements of these runs are not meaningful; the damage counts are. Each run " +"has its own folder (``run_001``, ...) with its results and its resolved " +"``case.ldem``, and the table is also saved as ``sweep_summary.csv``." +msgstr "" +"Después de la falla, los nodos cargados siguen siendo empujados por la fuerza y se " +"mueven libremente, así que los desplazamientos de estas corridas no tienen " +"significado; los conteos de daño sí. Cada corrida tiene su propia carpeta " +"(``run_001``, ...) con sus resultados y su ``case.ldem`` resuelto, y la tabla también" +" se guarda como ``sweep_summary.csv``." + +msgid "" +"Other changes to try in ``case.ldem``: ``law = \"linear_elastic\"`` (no damage at " +"all), ``type = \"generated\"`` with a ``cv`` in ``[material.scatter]`` to generate " +"the random field in memory instead of reading it, or ``type = \"none\"`` to remove " +"the scatter." +msgstr "" +"Otros cambios para probar en ``case.ldem``: ``law = \"linear_elastic\"`` (sin ningún " +"daño), ``type = \"generated\"`` con un ``cv`` en ``[material.scatter]`` para generar " +"el campo aleatorio en memoria en lugar de leerlo, o ``type = \"none\"`` para quitar " +"la dispersión." + +msgid "Example: uniaxial prism" +msgstr "Ejemplo: prisma uniaxial" + +msgid "" +"``examples/tension_101/runTension.m`` runs a prism of 5 x 2 x 2 modules of 3 mm (74 " +"nodes, 313 bars) under the uniaxial test (test 101): the centre nodes of the last " +"column move along x with a prescribed velocity of 4 mm/s while those of the first " +"column are held. It is the best place to start: it has no input file, the model is " +"described in the script with ``ldem.Parameters``, and it writes every kind of output." +msgstr "" +"``examples/tension_101/runTension.m`` ejecuta un prisma de 5 x 2 x 2 módulos de 3 mm " +"(74 nodos, 313 barras) bajo el ensayo uniaxial (ensayo 101): los nodos centrales de " +"la última columna se mueven en x con una velocidad impuesta de 4 mm/s mientras que " +"los de la primera columna están fijos. Es el mejor lugar para empezar: no tiene " +"archivo de entrada, el modelo se describe en el script con ``ldem.Parameters`` y " +"escribe todos los tipos de salida." + +msgid "" +"E = 32 GPa, Poisson's ratio 0.25, density 2000 kg/m\\ :sup:`3`; a low fracture energy" +" of 0.1 N/m on purpose, so that bars soften and break" +msgstr "" +"E = 32 GPa, coeficiente de Poisson 0.25, densidad 2000 kg/m\\ :sup:`3`; una energía " +"de fractura baja de 0.1 N/m a propósito, para que las barras se ablanden y se rompan" + +msgid "0.2 ms in 1000 steps of 0.2 us" +msgstr "0.2 ms en 1000 pasos de 0.2 us" + +msgid "Output" +msgstr "Salida" + +msgid "" +"Snapshots (ANSYS and VTK) every 250 steps, control nodes and energies every 10 steps," +" no tracked bar" +msgstr "" +"Instantáneas (ANSYS y VTK) cada 250 pasos, nodos de control y energías cada 10 pasos," +" sin barra seguida" + +#, python-format +msgid "" +"At the end 251 bars are intact, 58 are damaged and 4 are broken. The external work is" +" 24.7 uJ: 22.5 uJ of elastic energy, 2.2 uJ dissipated by damage and 0.03 uJ by " +"damping; the balance is 0.01 % of the external work." +msgstr "" +"Al final 251 barras están intactas, 58 dañadas y 4 rotas. El trabajo externo es de " +"24.7 uJ: 22.5 uJ de energía elástica, 2.2 uJ disipados por el daño y 0.03 uJ por el " +"amortiguamiento; el balance es el 0.01 % del trabajo externo." + +msgid "Energies of the uniaxial prism." +msgstr "Energías del prisma uniaxial." + +msgid "" +"With the sign convention of the original code a positive ``loadingVelocity`` moves " +"the loaded face toward the fixed one, that is, it compresses the prism; use a " +"negative value to pull it (see ``ldem.scenarios.UniaxialTension``)." +msgstr "" +"Con el criterio de signos del código original, un ``loadingVelocity`` positivo mueve " +"la cara cargada hacia la fija, es decir, comprime el prisma; use un valor negativo " +"para traccionarlo (ver ``ldem.scenarios.UniaxialTension``)." + +msgid "Example: four-point bending beam" +msgstr "Ejemplo: viga a flexión en cuatro puntos" + +msgid "" +"``examples/beam_102/runBeam.m`` reads the input of the beam of the paper (test 102, " +"``ldem.scenarios.FourPointBending``): 100 x 40 x 20 modules of 3 mm (300 x 120 x 60 " +"mm), 166,961 nodes and 1,126,960 bars. The beam rests on two supports 4.5 modules " +"from its ends and two load points 33.5 modules from its ends push its top face down " +"with a prescribed velocity of 4 mm/s. The material is E = 32 GPa, density 2000 kg/m\\" +" :sup:`3`, fracture energy 50 N/m, critical distance 28 mm, with a random field of " +"the critical strain read from a file." +msgstr "" +"``examples/beam_102/runBeam.m`` lee la entrada de la viga del artículo (ensayo 102, " +"``ldem.scenarios.FourPointBending``): 100 x 40 x 20 módulos de 3 mm (300 x 120 x 60 " +"mm), 166,961 nodos y 1,126,960 barras. La viga se apoya en dos apoyos a 4.5 módulos " +"de sus extremos y dos puntos de carga a 33.5 módulos de sus extremos empujan su cara " +"superior hacia abajo con una velocidad impuesta de 4 mm/s. El material tiene E = 32 " +"GPa, densidad 2000 kg/m\\ :sup:`3`, energía de fractura 50 N/m, distancia crítica 28 " +"mm, con un campo aleatorio de la deformación crítica leído de un archivo." + +msgid "" +"The real simulation has 150,000 steps (0.03 s in steps of 0.2 us) and needs roughly " +"20 hours on a laptop (about 0.5 s per step). The script therefore runs only the first" +" 50 steps: it builds the complete model (about 20 s) and shows that the input is read" +" and the model runs; the plotted reaction is only that of the start of the test. " +"Change ``nStepsDemo`` at the top of the script, or remove the ``totalTime`` override," +" for the full run." +msgstr "" +"La simulación real tiene 150,000 pasos (0.03 s en pasos de 0.2 us) y necesita unas 20" +" horas en una laptop (unos 0.5 s por paso). Por eso el script ejecuta solo los " +"primeros 50 pasos: construye el modelo completo (unos 20 s) y muestra que la entrada " +"se lee y el modelo corre; la reacción graficada es solo la del comienzo del ensayo. " +"Cambie ``nStepsDemo`` al principio del script, o quite el reemplazo de ``totalTime``," +" para la ejecución completa." + +msgid "The same parameters as a case file (``ldem.io.readCase``, ``ldem.run``)" +msgstr "Los mismos parámetros como archivo de caso (``ldem.io.readCase``, ``ldem.run``)" + +msgid "Parameters in the format of the original program (``ldem.Parameters.fromFile``)" +msgstr "Parámetros en el formato del programa original (``ldem.Parameters.fromFile``)" + +msgid "``arquivo_3lc_rnao_cv05``" +msgstr "" + +msgid "" +"Random field applied to the critical strain of each bar (11 MB); it is also used by " +"``example1_clamped_beam``" +msgstr "" +"Campo aleatorio aplicado a la deformación crítica de cada barra (11 MB); también lo " +"usa ``example1_clamped_beam``" + +msgid "``runBeam.m``" +msgstr "" + +msgid "Reads the input, runs the first 50 steps and plots the reaction force" +msgstr "Lee la entrada, ejecuta los primeros 50 pasos y grafica la fuerza de reacción" + diff --git a/docs/locale/es/LC_MESSAGES/index.po b/docs/locale/es/LC_MESSAGES/index.po new file mode 100644 index 0000000..c183d90 --- /dev/null +++ b/docs/locale/es/LC_MESSAGES/index.po @@ -0,0 +1,34 @@ +# Translation of the LDEM-MATLAB documentation (es). +# Generated by docs/tools/update_translations.py: edit only the msgstr entries. +msgid "" +msgstr "" +"Project-Id-Version: LDEM-MATLAB\n" +"Report-Msgid-Bugs-To: \n" +"Last-Translator: \n" +"Language: es\n" +"Language-Team: \n" +"Plural-Forms: nplurals=2; plural=(n != 1);\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.18.0\n" + +msgid "User guide" +msgstr "Guía de usuario" + +msgid "API" +msgstr "" + +msgid "LDEM-MATLAB" +msgstr "" + +msgid "Lattice Discrete Element Method (LDEM) in MATLAB." +msgstr "Método de Elementos Discretos tipo Lattice (LDEM) en MATLAB." + +msgid "" +"The documentation is written in English and translated into Spanish, Portuguese and " +"Italian. Choose the language in the sidebar of any page." +msgstr "" +"La documentación está escrita en inglés y traducida al español, portugués e italiano." +" Elija el idioma en la barra lateral de cualquier página." + diff --git a/docs/locale/es/LC_MESSAGES/installation.po b/docs/locale/es/LC_MESSAGES/installation.po new file mode 100644 index 0000000..e06642e --- /dev/null +++ b/docs/locale/es/LC_MESSAGES/installation.po @@ -0,0 +1,70 @@ +# Translation of the LDEM-MATLAB documentation (es). +# Generated by docs/tools/update_translations.py: edit only the msgstr entries. +msgid "" +msgstr "" +"Project-Id-Version: LDEM-MATLAB\n" +"Report-Msgid-Bugs-To: \n" +"Last-Translator: \n" +"Language: es\n" +"Language-Team: \n" +"Plural-Forms: nplurals=2; plural=(n != 1);\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.18.0\n" + +msgid "Installation" +msgstr "Instalación" + +msgid "" +"Requirements: MATLAB R2022b or newer (developed and tested on R2023b). The package " +"itself uses the ``arguments`` block and name=value syntax; the test suite and " +"``buildtool`` need R2022b. No toolbox is required." +msgstr "" +"Requisitos: MATLAB R2022b o superior (desarrollado y probado en R2023b). El paquete " +"usa el bloque ``arguments`` y la sintaxis nombre=valor; la suite de tests y " +"``buildtool`` requieren R2022b. No hace falta ningún toolbox." + +msgid "" +"git clone ldem-matlab\n" +"cd ldem-matlab" +msgstr "" +"git clone ldem-matlab\n" +"cd ldem-matlab" + +msgid ">> setup_path" +msgstr "" + +msgid "Check the installation with the fast tests:" +msgstr "Comprobar la instalación con los tests rápidos:" + +msgid ">> buildtool test" +msgstr "" + +msgid "Developer tasks (``buildtool`` is run from the repository root):" +msgstr "Tareas para desarrolladores (``buildtool`` se ejecuta desde la raíz del repositorio):" + +#, python-format +msgid "" +">> buildtool % static analysis + fast tests (the default)\n" +">> buildtool check % Code Analyzer only\n" +">> buildtool testAll % all tests, including the slow ones\n" +">> buildtool docs % build this documentation (needs Python)\n" +">> buildtool clean % delete generated files" +msgstr "" +">> buildtool % análisis estático + tests rápidos (por defecto)\n" +">> buildtool check % solo el analizador de código\n" +">> buildtool testAll % todos los tests, incluidos los lentos\n" +">> buildtool docs % construir esta documentación (requiere Python)\n" +">> buildtool clean % borrar los archivos generados" + +msgid "" +"``buildtool test`` writes ``test-results/results.xml`` (JUnit) and ``code-" +"coverage/coverage.xml`` (Cobertura)." +msgstr "" +"``buildtool test`` escribe ``test-results/results.xml`` (JUnit) y ``code-" +"coverage/coverage.xml`` (Cobertura)." + +msgid "To build this documentation without MATLAB see :doc:`docs`." +msgstr "Para construir esta documentación sin MATLAB ver :doc:`docs`." + diff --git a/docs/locale/es/LC_MESSAGES/introduction.po b/docs/locale/es/LC_MESSAGES/introduction.po new file mode 100644 index 0000000..91a4bbf --- /dev/null +++ b/docs/locale/es/LC_MESSAGES/introduction.po @@ -0,0 +1,77 @@ +# Translation of the LDEM-MATLAB documentation (es). +# Generated by docs/tools/update_translations.py: edit only the msgstr entries. +msgid "" +msgstr "" +"Project-Id-Version: LDEM-MATLAB\n" +"Report-Msgid-Bugs-To: \n" +"Last-Translator: \n" +"Language: es\n" +"Language-Team: \n" +"Plural-Forms: nplurals=2; plural=(n != 1);\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.18.0\n" + +msgid "Introduction" +msgstr "Introducción" + +msgid "" +"The **Lattice Discrete Element Method (LDEM)** models a continuum as a regular " +"lattice of nodes connected by bars arranged in cubic modules (edges plus diagonals). " +"Nodal masses are lumped, bar constitutive laws include damage/fracture, and the " +"equations of motion are integrated with an explicit central-difference scheme. " +"Energies (external, kinetic, elastic, dissipated) are tracked at every step." +msgstr "" +"El **Método de Elementos Discretos tipo Reticulado (LDEM)** modela un continuo como " +"un reticulado regular de nodos conectados por barras dispuestas en módulos cúbicos " +"(aristas más diagonales). Las masas son concentradas en los nodos, las leyes " +"constitutivas de las barras incluyen daño/fractura y las ecuaciones de movimiento se " +"integran con un esquema explícito de diferencias centrales. Las energías (externa, " +"cinética, elástica, disipada) se controlan en cada paso." + +msgid "Main parts of the ``ldem`` package (see :doc:`api/index`):" +msgstr "Partes principales del paquete ``ldem`` (ver :doc:`api/index`):" + +msgid "" +"``ldem.Parameters`` / ``ldem.io.readCase`` / ``ldem.io.readInputFile`` – validated " +"input data (case files and the legacy ``DATA0.DAT``)." +msgstr "" +"``ldem.Parameters`` / ``ldem.io.readCase`` / ``ldem.io.readInputFile`` – datos de " +"entrada validados (archivos de caso y el ``DATA0.DAT`` original)." + +msgid "``ldem.run`` / ``ldem.sweep`` / ``ldem.check`` – run, sweep and check a case file." +msgstr "" +"``ldem.run`` / ``ldem.sweep`` / ``ldem.check`` – ejecutar, barrer y comprobar un " +"archivo de caso." + +msgid "``ldem.mesh`` – nodes, bars, masses and bar geometry." +msgstr "``ldem.mesh`` – nodos, barras, masas y geometría de las barras." + +msgid "``ldem.material`` – bar stiffness, critical strain and the bilinear damage law." +msgstr "``ldem.material`` – rigidez de las barras, deformación crítica y ley bilineal de daño." + +msgid "``ldem.scenarios`` – supports, loads and reactions of each test." +msgstr "``ldem.scenarios`` – apoyos, cargas y reacciones de cada ensayo." + +msgid "``ldem.solver`` – time integration and energy balance." +msgstr "``ldem.solver`` – integración en el tiempo y balance de energía." + +msgid "" +"``ldem.runSimulation`` – the whole simulation, with ``results.mat``, ANSYS and VTK " +"output." +msgstr "" +"``ldem.runSimulation`` – la simulación completa, con salida ``results.mat``, ANSYS y " +"VTK." + +msgid "" +"The routines of the original program (``ini_DEM3``, ``read_dat0``, ``RMEC``, " +"``BOUND``, ``CALOAD``, ``ENERG2``, ...) are kept in the git history under the tag " +"``legacy-reference``; the ``Legacy:`` line of each help text names the routine it " +"replaces." +msgstr "" +"Las rutinas del programa original (``ini_DEM3``, ``read_dat0``, ``RMEC``, ``BOUND``, " +"``CALOAD``, ``ENERG2``, ...) se conservan en el historial de git, con la etiqueta " +"``legacy-reference``; la línea ``Legacy:`` de cada ayuda nombra la rutina que " +"reemplaza." + diff --git a/docs/locale/es/LC_MESSAGES/model.po b/docs/locale/es/LC_MESSAGES/model.po new file mode 100644 index 0000000..1b1705e --- /dev/null +++ b/docs/locale/es/LC_MESSAGES/model.po @@ -0,0 +1,240 @@ +# Translation of the LDEM-MATLAB documentation (es). +# Generated by docs/tools/update_translations.py: edit only the msgstr entries. +msgid "" +msgstr "" +"Project-Id-Version: LDEM-MATLAB\n" +"Report-Msgid-Bugs-To: \n" +"Last-Translator: \n" +"Language: es\n" +"Language-Team: \n" +"Plural-Forms: nplurals=2; plural=(n != 1);\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.18.0\n" + +msgid "Building a different model" +msgstr "Construir un modelo distinto" + +msgid "" +"A model is defined by three things: the **geometry** of the lattice, the **material**" +" and the **test** (supports and loads). The first two are parameters; the third is a " +"*scenario* class. You can change any of them without touching the solver." +msgstr "" +"Un modelo se define con tres cosas: la **geometría** del reticulado, el **material** " +"y el **ensayo** (apoyos y cargas). Las dos primeras son parámetros; la tercera es una" +" clase *escenario*. Se puede cambiar cualquiera sin tocar el solver." + +msgid "1. Change the geometry and the material" +msgstr "1. Cambiar la geometría y el material" + +msgid "Everything is a property of ``ldem.Parameters``:" +msgstr "Todo es una propiedad de ``ldem.Parameters``:" + +#, python-format +msgid "" +">> params = ldem.Parameters(testId=101, ...\n" +" moduleLength=0.002, ... % edge of the cubic module [m]\n" +" nModules=[21 6 6], ... % nodes along x, y and z\n" +" youngModulus=30e9, density=2400, poissonRatio=0.2, ...\n" +" fractureEnergy=80, criticalDistance=0.02, ...\n" +" meshPerturbation=0.02); % optional irregular mesh" +msgstr "" +">> params = ldem.Parameters(testId=101, ...\n" +" moduleLength=0.002, ... % arista del módulo cúbico [m]\n" +" nModules=[21 6 6], ... % nodos en x, y y z\n" +" youngModulus=30e9, density=2400, poissonRatio=0.2, ...\n" +" fractureEnergy=80, criticalDistance=0.02, ...\n" +" meshPerturbation=0.02); % malla irregular (opcional)" + +msgid "" +"``nModules = [M N L]`` is the number of grid nodes along each axis, so the prism has " +"``(M-1)*(N-1)*(L-1)`` modules." +msgstr "" +"``nModules = [M N L]`` es el número de nodos de la grilla en cada eje, de modo que el" +" prisma tiene ``(M-1)*(N-1)*(L-1)`` módulos." + +msgid "" +"``randomFieldFile`` multiplies the critical strain of each bar by a value read from a" +" text file (a random field of the material strength)." +msgstr "" +"``randomFieldFile`` multiplica la deformación crítica de cada barra por un valor " +"leído de un archivo de texto (campo aleatorio de la resistencia)." + +msgid "" +"``randomFieldCv`` generates that random field in memory instead, with no file: " +"Weibull values with mean 1 and that coefficient of variation on a grid of poles " +"spaced ``randomFieldCorrelationLength`` module lengths apart (default 3), " +"interpolated to each bar; ``randomFieldSeed`` fixes the random numbers. The value of " +"each bar is kept in ``results.barProps.randomField``." +msgstr "" +"``randomFieldCv`` genera ese campo aleatorio en memoria, sin archivo: valores Weibull" +" con media 1 y ese coeficiente de variación en una grilla de polos separados " +"``randomFieldCorrelationLength`` longitudes de módulo (3 por defecto), interpolados a" +" cada barra; ``randomFieldSeed`` fija los números aleatorios. El valor de cada barra " +"queda en ``results.barProps.randomField``." + +msgid "" +"``dt`` must be below ``params.criticalTimeStep``; ``Parameters`` rejects an unstable " +"value and says so." +msgstr "" +"``dt`` debe ser menor que ``params.criticalTimeStep``; ``Parameters`` rechaza un " +"valor inestable y lo explica." + +msgid "" +"The same data can come from a case file (``ldem.io.readCase``, see :doc:`usage`) or " +"from an input file in the format of the original program with " +"``ldem.Parameters.fromFile(\"DATA0.DAT\", ...)``; extra name=value pairs override the" +" file. The mesh can be built and inspected before running anything:" +msgstr "" +"Los mismos datos pueden venir de un archivo de caso (``ldem.io.readCase``, ver " +":doc:`usage`) o de un archivo de entrada con el formato del programa original: " +"``ldem.Parameters.fromFile(\"DATA0.DAT\", ...)``; los pares nombre=valor adicionales " +"reemplazan a los del archivo. La malla se puede construir e inspeccionar antes de " +"ejecutar nada:" + +#, python-format +msgid "" +">> mesh = ldem.mesh.buildMesh(params);\n" +">> fprintf(\"%d nodes, %d bars\\n\", size(mesh.nodes0, 1), size(mesh.bars, 1));" +msgstr "" +">> mesh = ldem.mesh.buildMesh(params);\n" +">> fprintf(\"%d nodos, %d barras\\n\", size(mesh.nodes0, 1), size(mesh.bars, 1));" + +msgid "2. Change the test: write a scenario" +msgstr "2. Cambiar el ensayo: escribir un escenario" + +msgid "" +"A *scenario* says which degrees of freedom are fixed, how the load is applied at " +"every time step and which reaction is reported. The solver never checks the test " +"number, it only asks the scenario. To model a new test, create a subclass of " +"``ldem.scenarios.Scenario`` in ``src/+ldem/+scenarios/``." +msgstr "" +"Un *escenario* dice qué grados de libertad están fijos, cómo se aplica la carga en " +"cada paso de tiempo y qué reacción se informa. El solver nunca consulta el número del" +" ensayo; se lo pregunta al escenario. Para modelar un ensayo nuevo se crea una " +"subclase de ``ldem.scenarios.Scenario`` en ``src/+ldem/+scenarios/``." + +msgid "" +"The example below is a cantilever beam along :math:`z`: the first layer of centre " +"nodes is clamped and a force that grows linearly is applied in :math:`y` at the free " +"end." +msgstr "" +"El ejemplo es una viga en voladizo según :math:`z`: la primera capa de nodos " +"centrales está empotrada y en el extremo libre se aplica en :math:`y` una fuerza que " +"crece linealmente." + +#, python-format +msgid "" +"classdef Cantilever < ldem.scenarios.Scenario\n" +" properties (Constant)\n" +" testId = 104 % new number, unique\n" +" end\n" +" properties\n" +" forceRate (1,1) double = 500 % [N/s] on each loaded node\n" +" end\n" +" methods\n" +" function fixed = fixedDofs(~, nodes0, params)\n" +" z = nodes0(:, 3);\n" +" atStart = abs(z - 0.5*params.moduleLength) < 0.01*params.moduleLength;\n" +" fixed = false(size(nodes0));\n" +" fixed(atStart, :) = true; % x, y and z held\n" +" end\n" +" function state = applyLoads(obj, state, mesh, params)\n" +" L1 = params.nModules(3) - 1;\n" +" z = mesh.nodes0(:, 3);\n" +" atEnd = abs(z - (L1 - 0.5)*params.moduleLength) < " +"0.01*params.moduleLength;\n" +" state.appliedForce(:) = 0;\n" +" state.appliedForce(atEnd, 2) = obj.forceRate * state.time;\n" +" end\n" +" end\n" +"end" +msgstr "" +"classdef Cantilever < ldem.scenarios.Scenario\n" +" properties (Constant)\n" +" testId = 104 % número nuevo, único\n" +" end\n" +" properties\n" +" forceRate (1,1) double = 500 % [N/s] en cada nodo cargado\n" +" end\n" +" methods\n" +" function fixed = fixedDofs(~, nodes0, params)\n" +" z = nodes0(:, 3);\n" +" atStart = abs(z - 0.5*params.moduleLength) < 0.01*params.moduleLength;\n" +" fixed = false(size(nodes0));\n" +" fixed(atStart, :) = true; % x, y y z fijos\n" +" end\n" +" function state = applyLoads(obj, state, mesh, params)\n" +" L1 = params.nModules(3) - 1;\n" +" z = mesh.nodes0(:, 3);\n" +" atEnd = abs(z - (L1 - 0.5)*params.moduleLength) < " +"0.01*params.moduleLength;\n" +" state.appliedForce(:) = 0;\n" +" state.appliedForce(atEnd, 2) = obj.forceRate * state.time;\n" +" end\n" +" end\n" +"end" + +msgid "Rules to follow:" +msgstr "Reglas:" + +msgid "" +"``fixedDofs`` returns an ``nNodes``-by-3 logical matrix, true where the node cannot " +"move (``1 = x``, ``2 = y``, ``3 = z``)." +msgstr "" +"``fixedDofs`` devuelve una matriz lógica de ``nNodes`` por 3, verdadera donde el nodo" +" no puede moverse (``1 = x``, ``2 = y``, ``3 = z``)." + +msgid "" +"``applyLoads`` runs once per step. A **displacement-controlled** test sets " +"``state.displacement`` of the loaded nodes (see ``UniaxialTension``); a **force-" +"controlled** test sets ``state.appliedForce`` in newtons (see ``ClampedBeam``) and " +"the solver counts its work in the external energy." +msgstr "" +"``applyLoads`` se ejecuta en cada paso. Un ensayo **controlado por desplazamiento** " +"asigna ``state.displacement`` de los nodos cargados (ver ``UniaxialTension``); uno " +"**controlado por fuerza** asigna ``state.appliedForce`` en newtons (ver " +"``ClampedBeam``) y el solver cuenta su trabajo en la energía externa." + +msgid "Override ``reactions`` if the test reports a reaction force (default: ``NaN``)." +msgstr "" +"Se redefine ``reactions`` si el ensayo informa una fuerza de reacción (por defecto: " +"``NaN``)." + +msgid "" +"The centre nodes of the modules lie at half-integer multiples of ``moduleLength``; " +"select nodes with a small tolerance, never with ``==``." +msgstr "" +"Los nodos centrales de los módulos están en múltiplos semienteros de " +"``moduleLength``; los nodos se seleccionan con una tolerancia pequeña, nunca con " +"``==``." + +msgid "3. Register and run it" +msgstr "3. Registrarlo y ejecutarlo" + +msgid "Either pass the object directly, with no registration:" +msgstr "Se puede pasar el objeto directamente, sin registrar nada:" + +msgid "" +">> scenario = ldem.scenarios.Cantilever(forceRate=1000);\n" +">> results = ldem.runSimulation(params, Scenario=scenario, ...\n" +" OutputFolder=\"output\", Formats=[\"mat\" \"vtk\"]);" +msgstr "" + +msgid "" +"or add one line to ``ldem.scenarios.registry`` so that ``testId = 104`` finds it and " +"a case file can name it with ``type``. Then add a test in ``tests/unit`` and, if it " +"is a reference case, an example in ``examples/`` (see " +"``examples/example1_clamped_beam``)." +msgstr "" +"o agregar una línea a ``ldem.scenarios.registry`` para que ``testId = 104`` lo " +"encuentre y un archivo de caso pueda nombrarlo con ``type``. Después se agrega un " +"test en ``tests/unit`` y, si es un caso de referencia, un ejemplo en ``examples/`` " +"(ver ``examples/example1_clamped_beam``)." + +msgid "The result is the same ``results`` struct as for any other test, see :doc:`usage`." +msgstr "" +"El resultado es la misma estructura ``results`` de cualquier otro ensayo, ver " +":doc:`usage`." + diff --git a/docs/locale/es/LC_MESSAGES/sphinx.po b/docs/locale/es/LC_MESSAGES/sphinx.po new file mode 100644 index 0000000..7a8f7f7 --- /dev/null +++ b/docs/locale/es/LC_MESSAGES/sphinx.po @@ -0,0 +1,45 @@ +# User-interface texts of the theme (Furo) in es: buttons, search and page navigation. +# Kept by hand: docs/tools/update_translations.py does not touch this file. +msgid "" +msgstr "" +"Project-Id-Version: LDEM-MATLAB\n" +"Report-Msgid-Bugs-To: \n" +"Last-Translator: \n" +"Language: es\n" +"Language-Team: \n" +"Plural-Forms: nplurals=2; plural=(n != 1);\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.18.0\n" + +msgid "Skip to content" +msgstr "Saltar al contenido" + +msgid "Back to top" +msgstr "Volver arriba" + +msgid "Next" +msgstr "Siguiente" + +msgid "Previous" +msgstr "Anterior" + +msgid "Home" +msgstr "Inicio" + +msgid "On this page" +msgstr "En esta página" + +msgid "Search" +msgstr "Buscar" + +msgid "Index" +msgstr "Índice" + +msgid "Error" +msgstr "Error" + +msgid "Please activate JavaScript to enable the search functionality." +msgstr "Active JavaScript para habilitar la función de búsqueda." + diff --git a/docs/locale/es/LC_MESSAGES/usage.po b/docs/locale/es/LC_MESSAGES/usage.po new file mode 100644 index 0000000..50d9bc0 --- /dev/null +++ b/docs/locale/es/LC_MESSAGES/usage.po @@ -0,0 +1,1346 @@ +# Translation of the LDEM-MATLAB documentation (es). +# Generated by docs/tools/update_translations.py: edit only the msgstr entries. +msgid "" +msgstr "" +"Project-Id-Version: LDEM-MATLAB\n" +"Report-Msgid-Bugs-To: \n" +"Last-Translator: \n" +"Language: es\n" +"Language-Team: \n" +"Plural-Forms: nplurals=2; plural=(n != 1);\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.18.0\n" + +msgid "Usage" +msgstr "Uso" + +msgid "Run a simulation" +msgstr "Ejecutar una simulación" + +msgid "" +">> setup_path % adds src/ to the MATLAB path\n" +">> params = ldem.Parameters(testId=101, nModules=[6 3 3], totalTime=2e-4, ...\n" +" fractureEnergy=0.1, ...\n" +" output=struct('snapshotEvery', 250, 'controlNodesEvery', 10, ...\n" +" 'energyEvery', 10, 'trackedBarEvery', 0));\n" +">> results = ldem.runSimulation(params, OutputFolder=\"output\", ...\n" +" Formats=[\"mat\" \"ansys\" \"vtk\"]);\n" +">> ldem.post.plotEnergy(results);" +msgstr "" +">> setup_path % agrega src/ al path de MATLAB\n" +">> params = ldem.Parameters(testId=101, nModules=[6 3 3], totalTime=2e-4, ...\n" +" fractureEnergy=0.1, ...\n" +" output=struct('snapshotEvery', 250, 'controlNodesEvery', 10, ...\n" +" 'energyEvery', 10, 'trackedBarEvery', 0));\n" +">> results = ldem.runSimulation(params, OutputFolder=\"output\", ...\n" +" Formats=[\"mat\" \"ansys\" \"vtk\"]);\n" +">> ldem.post.plotEnergy(results);" + +msgid "" +"``ldem.Parameters`` checks every value when it is set and explains what is wrong (for" +" example an unstable time step). The complete, ready-to-run version of this script is" +" ``examples/tension_101/runTension.m``." +msgstr "" +"``ldem.Parameters`` valida cada valor al asignarlo y explica qué está mal (por " +"ejemplo, un paso de tiempo inestable). La versión completa y lista para ejecutar está" +" en ``examples/tension_101/runTension.m``." + +msgid "To use an input file in the format of the original program:" +msgstr "Para usar un archivo de entrada con el formato del programa original:" + +msgid ">> params = ldem.Parameters.fromFile(\"DATA0.DAT\");" +msgstr "" + +msgid "Case files (``.ldem``)" +msgstr "Archivos de caso (``.ldem``)" + +msgid "" +"A *case file* describes the whole model in one readable text file: named keys instead" +" of positions, units next to the numbers, comments, and the test, the random scatter " +"and the output files together. It replaces ``DATA0.DAT``." +msgstr "" +"Un *archivo de caso* describe todo el modelo en un único texto legible: claves con " +"nombre en lugar de posiciones, unidades junto a los números, comentarios, y el " +"ensayo, la dispersión aleatoria y los archivos de salida juntos. Reemplaza al " +"``DATA0.DAT``." + +msgid "" +"format = 1\n" +"title = \"Small tension test\"\n" +"\n" +"[mesh]\n" +"module_size = 3 mm\n" +"modules = [5, 2, 2] # cubic modules along x, y and z\n" +"\n" +"[material]\n" +"young_modulus = 32 GPa\n" +"density = 2000 kg/m3\n" +"\n" +"[time]\n" +"step = auto # 0.9 times the critical step\n" +"duration = 40 us\n" +"\n" +"[scenario]\n" +"type = \"uniaxial_tension\"\n" +"\n" +"[output]\n" +"folder = \"output\"" +msgstr "" +"format = 1\n" +"title = \"Ensayo de tracción pequeño\"\n" +"\n" +"[mesh]\n" +"module_size = 3 mm\n" +"modules = [5, 2, 2] # módulos cúbicos en x, y y z\n" +"\n" +"[material]\n" +"young_modulus = 32 GPa\n" +"density = 2000 kg/m3\n" +"\n" +"[time]\n" +"step = auto # 0.9 veces el paso crítico\n" +"duration = 40 us\n" +"\n" +"[scenario]\n" +"type = \"uniaxial_tension\"\n" +"\n" +"[output]\n" +"folder = \"output\"" + +#, python-format +msgid "" +">> ldem.io.writeTemplate(\"my_test.ldem\", \"clamped_beam\"); % a commented file to " +"edit\n" +">> ldem.check(\"my_test.ldem\") % validate and report, " +"no simulation\n" +">> results = ldem.run(\"my_test.ldem\"); % run it\n" +">> ldem.io.convertLegacyInput(\"DATA0.DAT\", \"case.ldem\"); % convert an old input" +" file" +msgstr "" +">> ldem.io.writeTemplate(\"mi_ensayo.ldem\", \"clamped_beam\"); % archivo comentado " +"para editar\n" +">> ldem.check(\"mi_ensayo.ldem\") % valida e informa, " +"sin simular\n" +">> results = ldem.run(\"mi_ensayo.ldem\"); % lo ejecuta\n" +">> ldem.io.convertLegacyInput(\"DATA0.DAT\", \"caso.ldem\"); % convierte un " +"archivo antiguo" + +msgid "Rules of the format:" +msgstr "Reglas del formato:" + +msgid "" +"Keys are read by **name**; the order of the lines does not matter. Keys that are " +"missing take the default of ``ldem.Parameters``. Only ``scenario.type``, " +"``mesh.modules`` and ``time.duration`` are required." +msgstr "" +"Las claves se leen por **nombre**; el orden de las líneas no importa. Las claves " +"ausentes toman el valor por defecto de ``ldem.Parameters``. Solo son obligatorias " +"``scenario.type``, ``mesh.modules`` y ``time.duration``." + +msgid "" +"A number may carry a **unit**: ``3.87 GPa``, ``0.35 us``, ``1500 kg/m3``, ``2 kN/s``." +" Without a unit the value is in SI. The wrong unit for the key is an error that lists" +" the valid ones." +msgstr "" +"Un número puede llevar **unidad**: ``3.87 GPa``, ``0.35 us``, ``1500 kg/m3``, ``2 " +"kN/s``. Sin unidad el valor está en SI. Una unidad incorrecta para la clave es un " +"error que lista las válidas." + +msgid "" +"``#`` starts a comment, ``[section]`` opens a table, ``[[monitor.node]]`` starts the " +"next element of a repeated table, lists are written ``[5, 5, 50]``." +msgstr "" +"``#`` inicia un comentario, ``[sección]`` abre una tabla, ``[[monitor.node]]`` inicia" +" el siguiente elemento de una tabla repetida y las listas se escriben ``[5, 5, 50]``." + +msgid "" +"``mesh.modules`` counts **modules**: the ``M N L`` of ``DATA0.DAT`` count nodes, one " +"more." +msgstr "" +"``mesh.modules`` cuenta **módulos**: los ``M N L`` del ``DATA0.DAT`` cuentan nodos, " +"uno más." + +msgid "``time.step = auto`` (or no ``step``) takes 0.9 times the critical step." +msgstr "``time.step = auto`` (o sin ``step``) toma 0.9 veces el paso crítico." + +msgid "" +"Every error names the file, the line, the section and the key, and suggests the " +"closest valid name for a mistyped one." +msgstr "" +"Cada error indica el archivo, la línea, la sección y la clave, y sugiere el nombre " +"válido más parecido cuando hay un error de tipeo." + +msgid "" +"Relative paths (the random-field file, the output folder) are relative to the case " +"file." +msgstr "" +"Las rutas relativas (archivo del campo aleatorio, carpeta de salida) son relativas al" +" archivo de caso." + +msgid "A JSON file with the same structure (values with units as strings) is also read." +msgstr "" +"También se lee un archivo JSON con la misma estructura (los valores con unidades, " +"como texto)." + +msgid "Section" +msgstr "Sección" + +msgid "Keys" +msgstr "Claves" + +msgid "(top)" +msgstr "(inicio)" + +msgid "``format`` (1), ``title``, ``authors``" +msgstr "" + +msgid "``[mesh]``" +msgstr "" + +msgid "" +"``module_size``, ``modules``, ``perturbation`` (random displacement of the nodes, " +"fraction of the module), ``seed`` (of the perturbation)" +msgstr "" +"``module_size``, ``modules``, ``perturbation`` (desplazamiento aleatorio de los " +"nodos, fracción del módulo), ``seed`` (de la perturbación)" + +msgid "``[material]``" +msgstr "" + +msgid "" +"``law`` (``bilinear``, the legacy law, or ``linear_elastic``: no damage and no " +"rupture), ``young_modulus``, ``poisson_ratio``, ``density``, ``fracture_energy``, " +"``critical_distance``, ``failure_area_factor``" +msgstr "" +"``law`` (``bilinear``, la ley original, o ``linear_elastic``: sin daño ni rotura), " +"``young_modulus``, ``poisson_ratio``, ``density``, ``fracture_energy``, " +"``critical_distance``, ``failure_area_factor``" + +msgid "``[material.scatter]``" +msgstr "" + +msgid "" +"Scatter of the critical strain of the bars. ``type = \"none\"``; ``\"file\"`` with " +"``file`` (one multiplier per bar); or ``\"generated\"`` with ``cv``, " +"``correlation_length`` (in modules) and ``seed`` (the field is computed in memory)" +msgstr "" +"Dispersión de la deformación crítica de las barras. ``type = \"none\"``; ``\"file\"``" +" con ``file`` (un multiplicador por barra); o ``\"generated\"`` con ``cv``, " +"``correlation_length`` (en módulos) y ``seed`` (el campo se calcula en memoria)" + +msgid "``[time]``" +msgstr "" + +msgid "``step`` (or ``auto``), ``duration``" +msgstr "``step`` (o ``auto``), ``duration``" + +msgid "``[damping]``" +msgstr "" + +msgid "" +"``type`` (``mass_proportional``, the legacy damping, or ``none``), ``initial``, " +"``final``, ``switch_time`` (not allowed with ``none``), ``constitutive``" +msgstr "" +"``type`` (``mass_proportional``, el amortiguamiento original, o ``none``), " +"``initial``, ``final``, ``switch_time`` (no se admiten con ``none``), " +"``constitutive``" + +msgid "``[scenario]``" +msgstr "" + +msgid "" +"``type`` (``uniaxial_tension``, ``four_point_bending``, ``clamped_beam`` or " +"``custom``, see below) and the properties of that scenario in snake_case, for example" +" ``force_rate``, ``ramp_time``, ``load_position`` (``\"midspan\"`` is allowed)" +msgstr "" +"``type`` (``uniaxial_tension``, ``four_point_bending``, ``clamped_beam`` o " +"``custom``, ver más abajo) y las propiedades de ese escenario en snake_case, por " +"ejemplo ``force_rate``, ``ramp_time``, ``load_position`` (se admite ``\"midspan\"``)" + +msgid "``[[monitor.node]]``" +msgstr "" + +msgid "" +"One element per control node: ``id`` (node number) or ``at = [x, y, z]`` (position in" +" modules, the nearest node is used), and ``name``" +msgstr "" +"Un elemento por nodo de control: ``id`` (número de nodo) o ``at = [x, y, z]`` " +"(posición en módulos, se usa el nodo más cercano), y ``name``" + +msgid "``[monitor.bar]``" +msgstr "" + +msgid "``tracked``: bar whose strain history is stored at every step" +msgstr "``tracked``: barra cuya historia de deformación se guarda en cada paso" + +msgid "``[output]``" +msgstr "" + +msgid "``folder``, ``mat``, ``ansys``, ``vtk`` (true or false)" +msgstr "``folder``, ``mat``, ``ansys``, ``vtk`` (true o false)" + +msgid "``[output.snapshots]``, ``[output.control_nodes]``, ``[output.energy]``" +msgstr "" + +msgid "" +"``every``: ``1000 steps`` or a time such as ``0.1 ms`` (converted to steps); ``0`` " +"means never" +msgstr "" +"``every``: ``1000 steps`` o un tiempo como ``0.1 ms`` (se convierte a pasos); ``0`` " +"significa nunca" + +msgid "" +"``ldem.io.readCase`` returns the parameters, the scenario and the output options; " +"``ldem.Parameters.fromFile`` also accepts a case file. The list of keys lives in one " +"table, ``ldem.schema.caseSchema``, which drives the reader, the writer and the " +"template. To add a scenario, add a line to ``ldem.scenarios.registry``. A new " +"constitutive law is a subclass of ``ldem.material.MaterialLaw`` registered in " +"``ldem.material.lawRegistry``; a new damping model is a subclass of " +"``ldem.solver.DampingModel`` registered in ``ldem.solver.dampingRegistry``." +msgstr "" +"``ldem.io.readCase`` devuelve los parámetros, el escenario y las opciones de salida; " +"``ldem.Parameters.fromFile`` también acepta un archivo de caso. La lista de claves " +"está en una sola tabla, ``ldem.schema.caseSchema``, que gobierna el lector, el " +"escritor y la plantilla. Para agregar un escenario, se agrega una línea a " +"``ldem.scenarios.registry``. Una ley constitutiva nueva es una subclase de " +"``ldem.material.MaterialLaw`` registrada en ``ldem.material.lawRegistry``; un modelo " +"de amortiguamiento nuevo, una subclase de ``ldem.solver.DampingModel`` registrada en " +"``ldem.solver.dampingRegistry``." + +msgid "Your own test: supports and loads" +msgstr "Su propio ensayo: apoyos y cargas" + +msgid "" +"With ``type = \"custom\"`` the test is described in the case file by ``[[support]]`` " +"and ``[[load]]`` blocks, without writing a class. This is the uniaxial test (``testId" +" = 101``) as blocks:" +msgstr "" +"Con ``type = \"custom\"`` el ensayo se describe en el archivo de caso con bloques " +"``[[support]]`` y ``[[load]]``, sin escribir una clase. Este es el ensayo uniaxial " +"(``testId = 101``) como bloques:" + +msgid "" +"[scenario]\n" +"type = \"custom\"\n" +"\n" +"[[support]]\n" +"name = \"left end\"\n" +"x = 0.5 # the layer of centre nodes at x = 0.5 modules\n" +"fix = [\"x\"] # directions that cannot move\n" +"\n" +"[[load]]\n" +"name = \"right end\"\n" +"x = \"max - 0.5\"\n" +"direction = \"x\"\n" +"type = \"displacement\" # or \"force\"\n" +"time_function = \"linear\"\n" +"rate = -4 mm/s\n" +"reaction = true # its force is the reaction of the test" +msgstr "" +"[scenario]\n" +"type = \"custom\"\n" +"\n" +"[[support]]\n" +"name = \"left end\"\n" +"x = 0.5 # la capa de nodos centrales en x = 0.5 módulos\n" +"fix = [\"x\"] # direcciones que no se pueden mover\n" +"\n" +"[[load]]\n" +"name = \"right end\"\n" +"x = \"max - 0.5\"\n" +"direction = \"x\"\n" +"type = \"displacement\" # o \"force\"\n" +"time_function = \"linear\"\n" +"rate = -4 mm/s\n" +"reaction = true # su fuerza es la reacción del ensayo" + +msgid "" +"**Nodes** are chosen with ``nodes`` (``all``, ``grid`` for the corners of the modules" +" or ``centre`` for their centres), ``ids`` (node numbers) and ``x``, ``y``, ``z``. A " +"position is in modules (centre nodes lie at half-integers, grid nodes at integers), a" +" range ``[lo, hi]``, or a text with the references ``min``, ``max`` and ``mid`` and " +"an offset, such as ``\"max - 0.5\"``. A node must satisfy every condition. The " +"positions refer to the regular lattice, so they do not change when " +"``mesh.perturbation`` moves the nodes." +msgstr "" +"Los **nodos** se eligen con ``nodes`` (``all``, ``grid`` para las esquinas de los " +"módulos o ``centre`` para sus centros), ``ids`` (números de nodo) y ``x``, ``y``, " +"``z``. Una posición está en módulos (los nodos centrales están en semienteros, los de" +" esquina en enteros), un rango ``[lo, hi]``, o un texto con las referencias ``min``, " +"``max`` y ``mid`` y un desplazamiento, como ``\"max - 0.5\"``. Un nodo debe cumplir " +"todas las condiciones. Las posiciones se refieren a la malla regular, así que no " +"cambian cuando ``mesh.perturbation`` mueve los nodos." + +msgid "" +"**Supports** hold the directions listed in ``fix``. **Loads** act on one " +"``direction`` as a ``force`` (newtons on each selected node) or as a prescribed " +"``displacement`` (metres from the initial position, and the solver holds that " +"direction). The value follows ``time_function``: ``constant`` (``value``), ``linear``" +" (``rate``), ``ramp`` (``rate`` until the time ``until``, then constant) or ``table``" +" (``times`` and ``values`` in SI units, linear between points and constant outside)." +msgstr "" +"Los **apoyos** fijan las direcciones de ``fix``. Las **cargas** actúan en una " +"``direction`` como ``force`` (newtons en cada nodo elegido) o como ``displacement`` " +"impuesto (metros desde la posición inicial; el solver fija esa dirección). El valor " +"sigue ``time_function``: ``constant`` (``value``), ``linear`` (``rate``), ``ramp`` " +"(``rate`` hasta el tiempo ``until`` y luego constante) o ``table`` (``times`` y " +"``values`` en unidades SI, lineal entre puntos y constante fuera)." + +msgid "" +"A block with ``reaction = true`` adds its force to the reaction of the test (the sum " +"of the bar forces on its held directions); with none, the reaction is NaN. A block " +"that selects no node is an error that names it. The three built-in tests written this" +" way give exactly the same results as their classes." +msgstr "" +"Un bloque con ``reaction = true`` suma su fuerza a la reacción del ensayo (la suma de" +" las fuerzas de barra en sus direcciones fijas); si ninguno la pide, la reacción es " +"NaN. Un bloque que no elige ningún nodo es un error que lo nombra. Los tres ensayos " +"incorporados escritos así dan exactamente los mismos resultados que sus clases." + +msgid "Reuse a case: extends" +msgstr "Reutilizar un caso: extends" + +msgid "A case file can start from another one and change only what differs:" +msgstr "Un archivo de caso puede partir de otro y cambiar solo lo que difiere:" + +msgid "" +"extends = \"base.ldem\" # or a list: [\"base.ldem\", \"material.ldem\"]\n" +"\n" +"[material]\n" +"fracture_energy = 1 N/m # only what changes" +msgstr "" +"extends = \"base.ldem\" # o una lista: [\"base.ldem\", " +"\"material.ldem\"]\n" +"\n" +"[material]\n" +"fracture_energy = 1 N/m # solo lo que cambia" + +msgid "" +"The keys of the file replace the inherited ones. A repeated table (``[[support]]``, " +"``[[load]]``, ``[[monitor.node]]``, ``[[sweep]]``) replaces the whole inherited list." +" When the ``type`` of the scenario, of ``[material.scatter]`` or of ``[damping]`` " +"changes, the keys of the old type that are not set again are dropped. With a list, " +"later files win. Relative paths (the random-field file, the output folder) are " +"relative to the file that contains them, and an error names the file and line where " +"the problem is written. ``results.info.case.parents`` keeps the hash of every " +"inherited file." +msgstr "" +"Las claves del archivo reemplazan a las heredadas. Una tabla repetida " +"(``[[support]]``, ``[[load]]``, ``[[monitor.node]]``, ``[[sweep]]``) reemplaza toda " +"la lista heredada. Cuando cambia el ``type`` del escenario, de ``[material.scatter]``" +" o de ``[damping]``, se descartan las claves del tipo anterior que no se vuelven a " +"definir. Con una lista, los últimos archivos ganan. Las rutas relativas (archivo del " +"campo aleatorio, carpeta de salida) son relativas al archivo que las contiene, y un " +"error nombra el archivo y la línea donde está escrito el problema. " +"``results.info.case.parents`` guarda el hash de cada archivo heredado." + +msgid "Parameter sweeps" +msgstr "Barridos de parámetros" + +msgid "" +"To study how the result depends on a value, list the values in ``[[sweep]]`` blocks " +"and run ``ldem.sweep``:" +msgstr "" +"Para estudiar cómo depende el resultado de un valor, se listan los valores en bloques" +" ``[[sweep]]`` y se ejecuta ``ldem.sweep``:" + +msgid "" +"[[sweep]]\n" +"key = \"material.fracture_energy\"\n" +"values = [\"0.1 N/m\", \"0.5 N/m\", \"1 N/m\"]\n" +"\n" +"[[sweep]]\n" +"key = \"time.duration\"\n" +"values = [\"20 us\", \"40 us\"]" +msgstr "" + +#, python-brace-format, python-format +msgid "" +">> summary = ldem.sweep(\"case.ldem\"); % 3 x 2 = 6 runs, one folder " +"each\n" +">> ldem.sweep(\"case.ldem\", DryRun=true); % only validate and list the " +"runs\n" +">> ldem.sweep(\"case.ldem\", Vary={\"scenario.force_rate\", [\"1 kN/s\" \"2 " +"kN/s\"]});\n" +">> results = ldem.run(\"case.ldem\", Overrides=struct(\"path\", " +"\"material.fracture_energy\", \"value\", \"2 N/m\"));" +msgstr "" +">> summary = ldem.sweep(\"case.ldem\"); % 3 x 2 = 6 corridas, una " +"carpeta cada una\n" +">> ldem.sweep(\"case.ldem\", DryRun=true); % solo valida y lista las " +"corridas\n" +">> ldem.sweep(\"case.ldem\", Vary={\"scenario.force_rate\", [\"1 kN/s\" \"2 " +"kN/s\"]});\n" +">> results = ldem.run(\"case.ldem\", Overrides=struct(\"path\", " +"\"material.fracture_energy\", \"value\", \"2 N/m\"));" + +msgid "" +"Several blocks give every combination; ``sweep_mode = \"zip\"`` (a key at the top of " +"the file) takes them one by one. Any key with a single value can be varied, and the " +"keys of the scenario as ``scenario.``. Values are numbers or texts with units. " +"Every run is validated before the first one starts. The runs go to ``run_001``, " +"``run_002``, ... (each with its resolved ``case.ldem``) and the table " +"``sweep_summary.csv`` lists them, with the number of damaged and broken bars; a run " +"that fails is recorded and the sweep goes on." +msgstr "" +"Varios bloques dan todas las combinaciones; ``sweep_mode = \"zip\"`` (una clave al " +"principio del archivo) los toma uno a uno. Se puede variar cualquier clave de un solo" +" valor, y las del escenario como ``scenario.``. Los valores son números o " +"textos con unidades. Cada corrida se valida antes de empezar la primera. Las corridas" +" van a ``run_001``, ``run_002``, ... (cada una con su ``case.ldem`` resuelto) y la " +"tabla ``sweep_summary.csv`` las lista, con el número de barras dañadas y rotas; una " +"corrida que falla queda registrada y el barrido continúa." + +msgid "Reference of every key" +msgstr "Referencia de todas las claves" + +msgid "" +"The tables below are generated from ``ldem.schema.caseSchema``, the same table that " +"the reader uses, so they always agree with it." +msgstr "" +"Las tablas siguientes se generan desde ``ldem.schema.caseSchema``, la misma tabla que" +" usa el lector, así que siempre coinciden con él. Las descripciones están en inglés." + +msgid "``(top level)``" +msgstr "``(nivel superior)``" + +msgid "Key" +msgstr "Clave" + +msgid "Value" +msgstr "Valor" + +msgid "Default" +msgstr "Por defecto" + +msgid "Legacy" +msgstr "Original" + +msgid "Description" +msgstr "Descripción" + +msgid "``format``" +msgstr "" + +msgid "integer" +msgstr "entero" + +msgid "1" +msgstr "" + +msgid "(none)" +msgstr "(ninguno)" + +msgid "Version of the case-file format (currently 1)." +msgstr "Versión del formato del archivo de caso (actualmente 1)." + +msgid "``title``" +msgstr "" + +msgid "text" +msgstr "texto" + +msgid "Free text title of the case." +msgstr "Título del caso, en texto libre." + +msgid "``authors``" +msgstr "" + +msgid "list of texts" +msgstr "lista de textos" + +msgid "Names of the authors." +msgstr "Nombres de los autores." + +msgid "``extends``" +msgstr "" + +msgid "Case file(s) to inherit from; the keys of this file replace the inherited ones." +msgstr "" +"Archivo(s) de caso del que se hereda; las claves de este archivo reemplazan a las " +"heredadas." + +msgid "``sweep_mode``" +msgstr "" + +msgid "product, zip" +msgstr "" + +msgid "\"product\"" +msgstr "" + +msgid "How several [[sweep]] blocks combine: all combinations (product) or one by one (zip)." +msgstr "" +"Cómo se combinan varios bloques [[sweep]]: todas las combinaciones (product) o uno a " +"uno (zip)." + +msgid "``module_size``" +msgstr "" + +msgid "number + unit (m, cm, mm, um, km)" +msgstr "número + unidad (m, cm, mm, um, km)" + +msgid "3 mm" +msgstr "" + +msgid "LCO" +msgstr "" + +msgid "Edge length of each cubic module." +msgstr "Longitud de la arista de cada módulo cúbico." + +msgid "``modules``" +msgstr "" + +msgid "list of integers" +msgstr "lista de enteros" + +msgid "required" +msgstr "obligatorio" + +msgid "M N L" +msgstr "" + +msgid "Cubic modules along x, y and z (M N L of the legacy file count nodes: one more)." +msgstr "Módulos cúbicos en x, y y z (los M N L del archivo original cuentan nodos: uno más)." + +msgid "``perturbation``" +msgstr "" + +msgid "number" +msgstr "número" + +msgid "0" +msgstr "" + +msgid "Random node displacement as a fraction of the module size; 0 = regular lattice." +msgstr "" +"Desplazamiento aleatorio de los nodos como fracción del tamaño del módulo; 0 = malla " +"regular." + +msgid "``seed``" +msgstr "" + +msgid "123" +msgstr "" + +msgid "SEED" +msgstr "" + +msgid "Seed of the mesh perturbation (the random field has its own seed)." +msgstr "Semilla de la perturbación de la malla (el campo aleatorio tiene su propia semilla)." + +msgid "``law``" +msgstr "" + +msgid "bilinear, linear\\_elastic" +msgstr "" + +msgid "\"bilinear\"" +msgstr "" + +msgid "Constitutive law of the bars (see ldem.material.lawRegistry)." +msgstr "Ley constitutiva de las barras (ver ldem.material.lawRegistry)." + +msgid "``young_modulus``" +msgstr "" + +msgid "number + unit (Pa, kPa, MPa, GPa)" +msgstr "número + unidad (Pa, kPa, MPa, GPa)" + +msgid "32 GPa" +msgstr "" + +msgid "YNG" +msgstr "" + +msgid "Young's modulus." +msgstr "Módulo de Young." + +msgid "``poisson_ratio``" +msgstr "" + +msgid "0.25" +msgstr "" + +msgid "PSN" +msgstr "" + +msgid "Poisson's ratio, from 0 up to less than 0.5." +msgstr "Coeficiente de Poisson, de 0 hasta menos de 0.5." + +msgid "``density``" +msgstr "" + +msgid "number + unit (kg/m3, g/cm3)" +msgstr "número + unidad (kg/m3, g/cm3)" + +msgid "2000 kg/m3" +msgstr "" + +msgid "ROH" +msgstr "" + +msgid "Mass density." +msgstr "Densidad de masa." + +msgid "``fracture_energy``" +msgstr "" + +msgid "number + unit (N/m, kN/m)" +msgstr "número + unidad (N/m, kN/m)" + +msgid "50 N/m" +msgstr "" + +msgid "GFR" +msgstr "" + +msgid "Specific fracture energy." +msgstr "Energía específica de fractura." + +msgid "``critical_distance``" +msgstr "" + +msgid "28 mm" +msgstr "" + +msgid "DEQ" +msgstr "" + +msgid "Equivalent (critical) distance." +msgstr "Distancia equivalente (crítica)." + +msgid "``failure_area_factor``" +msgstr "" + +msgid "0.1385" +msgstr "" + +msgid "CAF" +msgstr "" + +msgid "Fraction of the module face that fails per bar." +msgstr "Fracción de la cara del módulo que falla por barra." + +msgid "``type``" +msgstr "" + +msgid "none, file, generated" +msgstr "" + +msgid "\"none\"" +msgstr "" + +msgid "Scatter of the critical strain: none, file (one multiplier per bar) or generated." +msgstr "" +"Dispersión de la deformación crítica: none, file (un multiplicador por barra) o " +"generated." + +msgid "``file``" +msgstr "" + +msgid "file path" +msgstr "ruta de archivo" + +msgid "Text file with one multiplier per bar, relative to this file." +msgstr "Archivo de texto con un multiplicador por barra, relativo a este archivo." + +msgid "``cv``" +msgstr "" + +msgid "Coefficient of variation of the generated field (1e-4 to 3)." +msgstr "Coeficiente de variación del campo generado (1e-4 a 3)." + +msgid "``correlation_length``" +msgstr "" + +msgid "list of numbers" +msgstr "lista de números" + +msgid "[3]" +msgstr "" + +msgid "Correlation length of the generated field in modules: one value or [x, y, z]." +msgstr "Longitud de correlación del campo generado en módulos: un valor o [x, y, z]." + +msgid "515" +msgstr "" + +msgid "Seed of the generated field." +msgstr "Semilla del campo generado." + +msgid "``step``" +msgstr "" + +msgid "time, or auto" +msgstr "tiempo, o auto" + +msgid "\"auto\"" +msgstr "" + +msgid "DT" +msgstr "" + +msgid "Integration time step, or auto (0.9 times the critical step)." +msgstr "Paso de tiempo de integración, o auto (0.9 veces el paso crítico)." + +msgid "``duration``" +msgstr "" + +msgid "number + unit (s, ms, us, ns)" +msgstr "número + unidad (s, ms, us, ns)" + +msgid "TTOT" +msgstr "" + +msgid "Total simulated time." +msgstr "Tiempo total simulado." + +msgid "mass\\_proportional, none" +msgstr "" + +msgid "\"mass\\_proportional\"" +msgstr "" + +msgid "Damping model of the nodes (see ldem.solver.dampingRegistry)." +msgstr "Modelo de amortiguamiento de los nodos (ver ldem.solver.dampingRegistry)." + +msgid "``initial``" +msgstr "" + +msgid "number + unit (1/s, 1/ms)" +msgstr "número + unidad (1/s, 1/ms)" + +msgid "25000 1/s" +msgstr "" + +msgid "DF1" +msgstr "" + +msgid "Mass-proportional damping before switch\\_time." +msgstr "Amortiguamiento proporcional a la masa antes de switch\\_time." + +msgid "``final``" +msgstr "" + +msgid "DF2" +msgstr "" + +msgid "Mass-proportional damping after switch\\_time." +msgstr "Amortiguamiento proporcional a la masa después de switch\\_time." + +msgid "``switch_time``" +msgstr "" + +msgid "15 ms" +msgstr "" + +msgid "TDAF" +msgstr "" + +msgid "Time at which the damping changes from initial to final." +msgstr "Tiempo en que el amortiguamiento pasa de initial a final." + +msgid "``constitutive``" +msgstr "" + +msgid "0 s" +msgstr "" + +msgid "CON" +msgstr "" + +msgid "Stiffness-proportional damping inside the bar law." +msgstr "Amortiguamiento proporcional a la rigidez dentro de la ley de las barras." + +msgid "TEST" +msgstr "" + +msgid "Test case (see ldem.scenarios.registry); its other keys follow." +msgstr "Ensayo (ver ldem.scenarios.registry); sus otras claves siguen." + +msgid "``[[support]]``" +msgstr "" + +msgid "``name``" +msgstr "" + +msgid "Label of the support." +msgstr "Etiqueta del apoyo." + +msgid "``nodes``" +msgstr "" + +msgid "all, centre, grid" +msgstr "" + +msgid "\"all\"" +msgstr "" + +msgid "Kind of nodes: all, grid (module corners) or centre (module centres)." +msgstr "Tipo de nodos: all, grid (esquinas de los módulos) o centre (centros de los módulos)." + +msgid "``ids``" +msgstr "" + +msgid "Node numbers to select." +msgstr "Números de nodo a elegir." + +msgid "``x``" +msgstr "" + +msgid "modules: number, text or [lo, hi]" +msgstr "módulos: número, texto o [lo, hi]" + +msgid "Positions along x in modules: 0.5, \"max - 0.5\" or a range [lo, hi]." +msgstr "Posiciones en x, en módulos: 0.5, \"max - 0.5\" o un rango [lo, hi]." + +msgid "``y``" +msgstr "" + +msgid "Positions along y in modules (see x)." +msgstr "Posiciones en y, en módulos (ver x)." + +msgid "``z``" +msgstr "" + +msgid "Positions along z in modules (see x)." +msgstr "Posiciones en z, en módulos (ver x)." + +msgid "``fix``" +msgstr "" + +msgid "Directions held at their initial position: [\"x\", \"y\", \"z\"]." +msgstr "Direcciones que se mantienen en su posición inicial: [\"x\", \"y\", \"z\"]." + +msgid "``reaction``" +msgstr "" + +msgid "true or false" +msgstr "true o false" + +msgid "false" +msgstr "" + +msgid "Include the force on the held directions in the reaction of the test." +msgstr "Incluye la fuerza en las direcciones fijas en la reacción del ensayo." + +msgid "``[[load]]``" +msgstr "" + +msgid "Label of the load." +msgstr "Etiqueta de la carga." + +msgid "``direction``" +msgstr "" + +msgid "x, y, z" +msgstr "" + +msgid "Direction of the load." +msgstr "Dirección de la carga." + +msgid "force, displacement" +msgstr "" + +msgid "force (N on each selected node) or displacement (m from the initial position)." +msgstr "force (N en cada nodo elegido) o displacement (m desde la posición inicial)." + +msgid "``time_function``" +msgstr "" + +msgid "constant, linear, ramp, table" +msgstr "" + +msgid "How the value changes with time." +msgstr "Cómo cambia el valor con el tiempo." + +msgid "``value``" +msgstr "" + +msgid "N, N/s, m or m/s, by type" +msgstr "N, N/s, m o m/s, según el tipo" + +msgid "constant: the value (N or m)." +msgstr "constant: el valor (N o m)." + +msgid "``rate``" +msgstr "" + +msgid "linear and ramp: change per second (N/s or m/s)." +msgstr "linear y ramp: cambio por segundo (N/s o m/s)." + +msgid "``until``" +msgstr "" + +msgid "ramp: time at which it stops growing." +msgstr "ramp: tiempo en que deja de crecer." + +msgid "``times``" +msgstr "" + +msgid "table: increasing times in seconds." +msgstr "table: tiempos crecientes en segundos." + +msgid "``values``" +msgstr "" + +msgid "table: one value per time (N or m)." +msgstr "table: un valor por tiempo (N o m)." + +msgid "Include the force on the loaded direction in the reaction of the test." +msgstr "Incluye la fuerza en la dirección cargada en la reacción del ensayo." + +msgid "``[[sweep]]``" +msgstr "" + +msgid "``key``" +msgstr "" + +msgid "Key to vary, for example \"material.fracture\\_energy\" (see ldem.sweep)." +msgstr "Clave a variar, por ejemplo \"material.fracture\\_energy\" (ver ldem.sweep)." + +msgid "Values to try: numbers, or texts with units such as [\"0.1 N/m\", \"0.5 N/m\"]." +msgstr "Valores a probar: números, o textos con unidades como [\"0.1 N/m\", \"0.5 N/m\"]." + +msgid "``id``" +msgstr "" + +msgid "NCON" +msgstr "" + +msgid "Number of a node whose motion is recorded." +msgstr "Número de un nodo cuyo movimiento se registra." + +msgid "``at``" +msgstr "" + +msgid "Position [x, y, z] in modules; the nearest node is recorded." +msgstr "Posición [x, y, z] en módulos; se registra el nodo más cercano." + +msgid "Label of the node." +msgstr "Etiqueta del nodo." + +msgid "``tracked``" +msgstr "" + +msgid "off" +msgstr "desactivado" + +msgid "OU9" +msgstr "" + +msgid "Number of the bar whose strain history is stored at every step." +msgstr "Número de la barra cuya historia de deformación se guarda en cada paso." + +msgid "``folder``" +msgstr "" + +msgid "no files" +msgstr "sin archivos" + +msgid "Output folder, relative to the case file." +msgstr "Carpeta de salida, relativa al archivo de caso." + +msgid "``mat``" +msgstr "" + +msgid "true" +msgstr "" + +msgid "Write results.mat." +msgstr "Escribe results.mat." + +msgid "``ansys``" +msgstr "" + +msgid "Write ANSYS macro files (needs snapshots.every > 0)." +msgstr "Escribe archivos macro de ANSYS (requiere snapshots.every > 0)." + +msgid "``vtk``" +msgstr "" + +msgid "Write VTK files for ParaView (needs snapshots.every > 0)." +msgstr "Escribe archivos VTK para ParaView (requiere snapshots.every > 0)." + +msgid "``[output.snapshots]``" +msgstr "" + +msgid "``every``" +msgstr "" + +msgid "steps or time (0 = never)" +msgstr "pasos o tiempo (0 = nunca)" + +msgid "OU3" +msgstr "" + +msgid "Steps or time between full-field snapshots; 0 = never." +msgstr "Pasos o tiempo entre instantáneas del campo completo; 0 = nunca." + +msgid "``[output.control_nodes]``" +msgstr "" + +msgid "OU6" +msgstr "" + +msgid "Steps or time between records of the control nodes and reactions; 0 = never." +msgstr "Pasos o tiempo entre registros de los nodos de control y reacciones; 0 = nunca." + +msgid "``[output.energy]``" +msgstr "" + +msgid "OU8" +msgstr "" + +msgid "Steps or time between records of the energies; 0 = never." +msgstr "Pasos o tiempo entre registros de las energías; 0 = nunca." + +msgid "Tests available" +msgstr "Ensayos disponibles" + +msgid "``testId = 101``" +msgstr "" + +msgid "" +"Uniaxial load: the centre nodes of the last column of modules move along :math:`x` " +"with a prescribed velocity." +msgstr "" +"Carga uniaxial: los nodos centrales de la última columna de módulos se mueven en " +":math:`x` con velocidad impuesta." + +msgid "``testId = 102``" +msgstr "" + +msgid "" +"Beam with two supports and two load points. The positions are parameters of " +"``ldem.scenarios.FourPointBending`` (``supportPosition``, ``loadPosition``, in " +"modules from each end); the defaults need a beam longer than about 70 modules. See " +"``examples/beam_102``." +msgstr "" +"Viga con dos apoyos y dos puntos de carga. Las posiciones son parámetros de " +"``ldem.scenarios.FourPointBending`` (``supportPosition``, ``loadPosition``, en " +"módulos desde cada extremo); los valores por defecto requieren una viga de más de " +"unos 70 módulos. Ver ``examples/beam_102``." + +msgid "``testId = 103``" +msgstr "" + +msgid "" +"Beam clamped at both ends, loaded at mid-span with a force that grows linearly and " +"then stays constant (``ldem.scenarios.ClampedBeam``). It is the only test loaded with" +" a force instead of a displacement. See ``examples/example1_clamped_beam``." +msgstr "" +"Viga empotrada en los dos extremos, cargada a media luz con una fuerza que crece " +"linealmente y luego se mantiene constante (``ldem.scenarios.ClampedBeam``). Es el " +"único ensayo cargado con una fuerza en lugar de un desplazamiento. Ver " +"``examples/example1_clamped_beam``." + +msgid "" +"To add a new test, create a subclass of ``ldem.scenarios.Scenario`` (see " +":doc:`model`)." +msgstr "" +"Para agregar un ensayo nuevo se crea una subclase de ``ldem.scenarios.Scenario`` (ver" +" :doc:`model`)." + +msgid "Mesh perturbation" +msgstr "Perturbación de la malla" + +msgid "" +"The parameter ``meshPerturbation`` randomly displaces the interior nodes. Its value " +"is the standard deviation as a fraction of the module length: ``0`` (the default) " +"keeps the lattice regular and any positive value activates the perturbation with that" +" value. The random numbers follow ``seed``." +msgstr "" +"El parámetro ``meshPerturbation`` desplaza al azar los nodos interiores. Su valor es " +"la desviación estándar como fracción de la longitud del módulo: ``0`` (el valor por " +"defecto) deja el reticulado regular y cualquier valor positivo activa la perturbación" +" con ese valor. Los números aleatorios siguen a ``seed``." + +msgid ">> params = ldem.Parameters(testId=101, nModules=[6 3 3], meshPerturbation=0.02);" +msgstr "" + +msgid "What you get: the ``results`` struct" +msgstr "Qué se obtiene: la estructura ``results``" + +msgid "Field" +msgstr "Campo" + +msgid "Content" +msgstr "Contenido" + +msgid "``info``" +msgstr "" + +msgid "ldem version, date, MATLAB release, run time [s]." +msgstr "Versión de ldem, fecha, versión de MATLAB, tiempo de cálculo [s]." + +msgid "``params``" +msgstr "" + +msgid "The parameters used, as a plain struct (derived values included)." +msgstr "Los parámetros usados, como estructura simple (con valores derivados)." + +msgid "``model``" +msgstr "" + +msgid "" +"Counts and mass of the model: modules, nodes, bars by type, fixed degrees of freedom," +" total mass and volume." +msgstr "" +"Cantidades y masa del modelo: módulos, nodos, barras por tipo, grados de libertad " +"fijos, masa total y volumen." + +msgid "``material``" +msgstr "" + +msgid "" +"Material data (E, Gf, ...), lattice coefficients, critical length and the statistics " +"of the critical strain (mean, coefficient of variation, minimum and maximum)." +msgstr "" +"Datos del material (E, Gf, ...), coeficientes del reticulado, longitud crítica y " +"estadísticas de la deformación crítica (media, coeficiente de variación, mínimo y " +"máximo)." + +msgid "``mesh``" +msgstr "" + +msgid "Initial node positions, supports (``fixed``), masses, bars, bar lengths and bar types." +msgstr "Posiciones iniciales, apoyos (``fixed``), masas, barras, longitudes y tipos de barra." + +msgid "``barProps``" +msgstr "" + +msgid "Stiffness, critical strain and rupture strain of every bar." +msgstr "Rigidez, deformación crítica y deformación de rotura de cada barra." + +msgid "``controlNodes``" +msgstr "" + +msgid "Time and displacement, velocity and acceleration of the control nodes." +msgstr "Tiempo y desplazamiento, velocidad y aceleración de los nodos de control." + +msgid "``reactions``" +msgstr "" + +msgid "" +"Time and reaction force ``[Rx Ry Rz]`` of the test: vertical force at the load points" +" (test 102), force on the clamped ends (test 103); ``NaN`` where the test defines " +"none." +msgstr "" +"Tiempo y fuerza de reacción ``[Rx Ry Rz]`` del ensayo: fuerza vertical en los puntos " +"de carga (ensayo 102), fuerza en los extremos empotrados (ensayo 103); ``NaN`` donde " +"el ensayo no la define." + +msgid "``energy``" +msgstr "" + +msgid "" +"Time, kinetic, elastic, damage and damping energies [J], their sum (``internal``), " +"the energy of the broken bars (``brokenBars``), the external work, the ``balance`` " +"(external minus internal) and the damage rate." +msgstr "" +"Tiempo, energías cinética, elástica, de daño y de amortiguamiento [J], su suma " +"(``internal``), la energía de las barras rotas (``brokenBars``), el trabajo externo, " +"el balance (``balance``, externo menos interno) y la tasa de daño." + +msgid "``trackedBar``" +msgstr "" + +msgid "Strain, force and damage energy of one bar at every step (optional)." +msgstr "Deformación, fuerza y energía de daño de una barra en cada paso (opcional)." + +msgid "``snapshots``" +msgstr "" + +msgid "" +"Step, time, number of intact/damaged/broken bars, and compact copies of the " +"displacements, the damage state and the nodal kinetic energy at the snapshot steps." +msgstr "" +"Paso, tiempo, número de barras intactas/dañadas/rotas y copias compactas de los " +"desplazamientos, del estado de daño y de la energía cinética de cada nodo." + +msgid "" +"Final displacement, velocity, force and damage state, and the kinetic energy of every" +" node." +msgstr "" +"Desplazamiento, velocidad, fuerza y estado de daño finales, y la energía cinética de " +"cada nodo." + +msgid "" +"The energy ``balance`` is a check of the simulation: it should be a small fraction " +"(below 1 %) of the final external work. The total kinetic energy is " +"``energy.kinetic``; the kinetic energy of each node is in ``final.kineticEnergy``." +msgstr "" +"El ``balance`` de energía es una comprobación de la simulación: debe ser una fracción" +" pequeña (menos del 1 %) del trabajo externo final. La energía cinética total es " +"``energy.kinetic``; la de cada nodo está en ``final.kineticEnergy``." + +msgid "``results.mat`` contains this struct and loads without the package:" +msgstr "``results.mat`` contiene esta estructura y se carga sin el paquete:" + +msgid "" +">> data = load(\"output/results.mat\");\n" +">> results = data.results;" +msgstr "" + +msgid "Output files" +msgstr "Archivos de salida" + +msgid "``results.mat``" +msgstr "" + +msgid "The ``results`` struct (format v7.3, readable from Python with ``h5py``)." +msgstr "La estructura ``results`` (formato v7.3, legible desde Python con ``h5py``)." + +msgid "``snapshot_0000.mac``, ``snapshot_0001.mac``, ..." +msgstr "" + +msgid "" +"ANSYS macro files with the deformed lattice. Bars are element types 1 (intact), 2 " +"(damaged) and 5 (broken). The held degrees of freedom are listed as " +"``D,node,direction`` and the displacement imposed on the loaded nodes, measured from " +"their initial position, as ``D,node,direction,value``. In test 103 the applied forces" +" are listed as ``F,node,direction,value``." +msgstr "" +"Macros de ANSYS con el reticulado deformado. Las barras son elementos de tipo 1 " +"(intactas), 2 (dañadas) y 5 (rotas). Los grados de libertad fijos se listan como " +"``D,nodo,dirección`` y el desplazamiento impuesto a los nodos cargados, medido desde " +"su posición inicial, como ``D,nodo,dirección,valor``. En el ensayo 103 las fuerzas " +"aplicadas se listan como ``F,nodo,dirección,valor``." + +msgid "``snapshot_0000.vtu``, ... and ``snapshots.pvd``" +msgstr "``snapshot_0000.vtu``, ... y ``snapshots.pvd``" + +msgid "" +"VTK files. Open ``snapshots.pvd`` in `ParaView `_; colour " +"by ``damageState`` (cell data) to see the cracks and use the time slider to follow " +"them. Displacement and velocity are point data." +msgstr "" +"Archivos VTK. Abrir ``snapshots.pvd`` en `ParaView `_; " +"colorear por ``damageState`` (datos de celda) para ver las fisuras y usar el control " +"de tiempo para seguirlas. Desplazamiento y velocidad son datos de nodo." + +msgid "" +"ANSYS and VTK files are written at time zero and every " +"``params.output.snapshotEvery`` steps." +msgstr "" +"Los archivos ANSYS y VTK se escriben en el tiempo cero y cada " +"``params.output.snapshotEvery`` pasos." + +msgid "Run the tests" +msgstr "Ejecutar los tests" + +#, python-format +msgid "" +">> addpath tests\n" +">> run_tests % fast tests\n" +">> run_tests(IncludeSlow=true) % also the slow tests" +msgstr "" +">> addpath tests\n" +">> run_tests % tests rápidos\n" +">> run_tests(IncludeSlow=true) % también los tests lentos" + diff --git a/docs/locale/it/LC_MESSAGES/api/index.po b/docs/locale/it/LC_MESSAGES/api/index.po new file mode 100644 index 0000000..13b2d13 --- /dev/null +++ b/docs/locale/it/LC_MESSAGES/api/index.po @@ -0,0 +1,54 @@ +# Translation of the LDEM-MATLAB documentation (it). +# Generated by docs/tools/update_translations.py: edit only the msgstr entries. +msgid "" +msgstr "" +"Project-Id-Version: LDEM-MATLAB\n" +"Report-Msgid-Bugs-To: \n" +"Last-Translator: \n" +"Language: it\n" +"Language-Team: \n" +"Plural-Forms: nplurals=2; plural=(n != 1);\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.18.0\n" + +msgid "API reference" +msgstr "Riferimento dell'API" + +msgid "Generated automatically from the comments of the ``.m`` files." +msgstr "Generato automaticamente dai commenti dei ``.m``." + +msgid "" +"The ``ldem`` package (``src/+ldem``) is the refactored code. It replaces the original" +" routines, which are kept in the git history (tag ``legacy-reference``); the problems" +" found in them are listed in ``docs/known-issues/KNOWN_ISSUES.md``." +msgstr "" +"Il pacchetto ``ldem`` (``src/+ldem``) è il codice rifattorizzato. Sostituisce le " +"routine originali, conservate nella cronologia di git (tag ``legacy-reference``); i " +"problemi trovati in esse sono elencati in ``docs/known-issues/KNOWN_ISSUES.md``." + +msgid "Running a simulation" +msgstr "Eseguire una simulazione" + +msgid "Input and output" +msgstr "Ingresso e uscita" + +msgid "Mesh" +msgstr "Mesh" + +msgid "Material" +msgstr "Materiale" + +msgid "Scenarios" +msgstr "Scenari di prova" + +msgid "Case-file schema" +msgstr "Schema dei file di caso" + +msgid "Solver" +msgstr "" + +msgid "Post-processing" +msgstr "Post-elaborazione" + diff --git a/docs/locale/it/LC_MESSAGES/authors.po b/docs/locale/it/LC_MESSAGES/authors.po new file mode 100644 index 0000000..fc1e657 --- /dev/null +++ b/docs/locale/it/LC_MESSAGES/authors.po @@ -0,0 +1,59 @@ +# Translation of the LDEM-MATLAB documentation (it). +# Generated by docs/tools/update_translations.py: edit only the msgstr entries. +msgid "" +msgstr "" +"Project-Id-Version: LDEM-MATLAB\n" +"Report-Msgid-Bugs-To: \n" +"Last-Translator: \n" +"Language: it\n" +"Language-Team: \n" +"Plural-Forms: nplurals=2; plural=(n != 1);\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.18.0\n" + +msgid "Authors" +msgstr "Autori" + +msgid "" +"This list is generated automatically from the commits of the git history (people with" +" the same name or e-mail are merged through ``.mailmap``) and from the authors of " +"``CITATION.cff``. Authors without commits in this repository appear with ``-``. The " +"same list is in ``AUTHORS.md``." +msgstr "" +"Questo elenco è generato automaticamente dai commit della cronologia di git (le " +"persone con lo stesso nome o e-mail sono unificate tramite ``.mailmap``) e dagli " +"autori di ``CITATION.cff``. Gli autori senza commit in questo repository compaiono " +"con ``-``. Lo stesso elenco è in ``AUTHORS.md``." + +msgid "Name" +msgstr "Nome" + +msgid "Commits" +msgstr "" + +msgid "Boris Rojo Tanzi" +msgstr "" + +msgid "26" +msgstr "" + +msgid "Rodrigo Cavasotto Oscar Montanha" +msgstr "" + +msgid "7" +msgstr "" + +msgid "Ignacio Iturrioz" +msgstr "" + +msgid "To update it after new commits, build the documentation or run:" +msgstr "Per aggiornarlo dopo nuovi commit, costruire la documentazione oppure eseguire:" + +msgid "python docs/tools/generate_authors.py" +msgstr "" + +msgid "If a person appears twice, add a line to ``.mailmap``." +msgstr "Se una persona compare due volte, aggiungere una riga a ``.mailmap``." + diff --git a/docs/locale/it/LC_MESSAGES/contributing.po b/docs/locale/it/LC_MESSAGES/contributing.po new file mode 100644 index 0000000..e146b26 --- /dev/null +++ b/docs/locale/it/LC_MESSAGES/contributing.po @@ -0,0 +1,42 @@ +# Translation of the LDEM-MATLAB documentation (it). +# Generated by docs/tools/update_translations.py: edit only the msgstr entries. +msgid "" +msgstr "" +"Project-Id-Version: LDEM-MATLAB\n" +"Report-Msgid-Bugs-To: \n" +"Last-Translator: \n" +"Language: it\n" +"Language-Team: \n" +"Plural-Forms: nplurals=2; plural=(n != 1);\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.18.0\n" + +msgid "Contributing" +msgstr "Contribuire" + +msgid "" +"The API documentation is generated from the ``.m`` comments. The docstring must be " +"the comment block placed **immediately after** the ``function`` line (before any " +"``global`` declaration). Source comments are written in English." +msgstr "" +"La documentazione dell'API è generata dai commenti dei ``.m``. Il docstring deve " +"essere il blocco di commenti posto **subito dopo** la riga ``function`` (prima di " +"qualsiasi ``global``). I commenti del codice sono scritti in inglese." + +#, python-format +msgid "" +"function ini = CALOAD()\n" +"% CALOAD One-line summary.\n" +"% Longer description.\n" +"global ..." +msgstr "" +"function ini = CALOAD()\n" +"% CALOAD Riepilogo in una riga.\n" +"% Descrizione più lunga.\n" +"global ..." + +msgid "See ``CONTRIBUTING.md`` in the repository root." +msgstr "Vedi ``CONTRIBUTING.md`` nella radice del repository." + diff --git a/docs/locale/it/LC_MESSAGES/docs.po b/docs/locale/it/LC_MESSAGES/docs.po new file mode 100644 index 0000000..3b564bf --- /dev/null +++ b/docs/locale/it/LC_MESSAGES/docs.po @@ -0,0 +1,183 @@ +# Translation of the LDEM-MATLAB documentation (it). +# Generated by docs/tools/update_translations.py: edit only the msgstr entries. +msgid "" +msgstr "" +"Project-Id-Version: LDEM-MATLAB\n" +"Report-Msgid-Bugs-To: \n" +"Last-Translator: \n" +"Language: it\n" +"Language-Team: \n" +"Plural-Forms: nplurals=2; plural=(n != 1);\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.18.0\n" + +msgid "Building this documentation" +msgstr "Costruire questa documentazione" + +msgid "" +"The documentation is written in English, which is the only set of source pages, and " +"translated into Spanish, Portuguese and Italian with gettext catalogs (``.po`` files " +"in ``docs/locale/``). Each language is built as its own site and the sidebar has a " +"language selector. A text that is not translated yet is shown in English. The API " +"reference is generated from the comments of the ``.m`` files and is in English only." +msgstr "" +"La documentazione è scritta in inglese, che è l'unico insieme di pagine sorgente, e " +"tradotta in spagnolo, portoghese e italiano con cataloghi gettext (file ``.po`` in " +"``docs/locale/``). Ogni lingua viene costruita come un sito a sé e la barra laterale " +"ha un selettore di lingua. Un testo non ancora tradotto viene mostrato in inglese. Il" +" riferimento dell'API è generato dai commenti dei file ``.m`` ed è solo in inglese." + +msgid "Requirements" +msgstr "Requisiti" + +msgid "Python 3.9 or newer." +msgstr "Python 3.9 o successivo." + +msgid "" +"``git`` (the list of authors is generated from the commit history; with a shallow " +"clone use ``git fetch --unshallow`` first)." +msgstr "" +"``git`` (l'elenco degli autori è generato dalla cronologia dei commit; con un clone " +"superficiale eseguire prima ``git fetch --unshallow``)." + +msgid "No MATLAB is needed; the API is read from the source text." +msgstr "MATLAB non è necessario; l'API viene letta dal testo dei sorgenti." + +msgid "pip install -r docs/requirements.txt" +msgstr "" + +msgid "Build" +msgstr "Costruzione" + +msgid "From the repository root, with any of these:" +msgstr "Dalla radice del repository, con una qualsiasi di queste opzioni:" + +msgid "python docs/tools/build_docs.py" +msgstr "" + +msgid "cd docs && make html" +msgstr "" + +msgid ">> buildtool docs" +msgstr "" + +msgid "" +"This builds the four languages into ``docs/build/html/en``, ``es``, ``pt`` and " +"``it``; ``docs/build/html/index.html`` sends the reader to the English site. Open it " +"in a browser. To build only some languages use for example ``python " +"docs/tools/build_docs.py --languages en es``. Warnings are errors: the documentation " +"must build without any. ``buildtool clean`` deletes the result." +msgstr "" +"Questo costruisce le quattro lingue in ``docs/build/html/en``, ``es``, ``pt`` e " +"``it``; ``docs/build/html/index.html`` porta il lettore al sito in inglese. Aprirlo " +"in un browser. Per costruire solo alcune lingue si usi, per esempio, ``python " +"docs/tools/build_docs.py --languages en es``. Gli avvisi sono errori: la " +"documentazione deve essere costruita senza alcuno. ``buildtool clean`` cancella il " +"risultato." + +msgid "Where things are" +msgstr "Dove si trova ogni cosa" + +msgid "``docs/source/``" +msgstr "" + +msgid "The pages, in English." +msgstr "Le pagine, in inglese." + +msgid "``docs/locale/es/``, ``pt/``, ``it/``" +msgstr "" + +msgid "" +"Translations: one ``.po`` file per page in ``LC_MESSAGES/``, with each English text " +"and its translation." +msgstr "" +"Traduzioni: un file ``.po`` per pagina in ``LC_MESSAGES/``, con ogni testo inglese e " +"la sua traduzione." + +msgid "``docs/source/api/``" +msgstr "" + +msgid "API reference, generated from the ``.m`` comments." +msgstr "Riferimento dell'API, generato dai commenti dei ``.m``." + +msgid "``docs/tools/build_docs.py``" +msgstr "" + +msgid "Builds every language and the page that sends the reader to the English site." +msgstr "Costruisce ogni lingua e la pagina che porta il lettore al sito in inglese." + +msgid "``docs/tools/update_translations.py``" +msgstr "" + +msgid "" +"Updates the ``.po`` files after the English text changes, and reports what is left to" +" translate." +msgstr "" +"Aggiorna i file ``.po`` quando cambia il testo inglese e riferisce cosa resta da " +"tradurre." + +msgid "``docs/tools/generate_authors.py``" +msgstr "" + +msgid "Writes the authors page and ``AUTHORS.md`` (run by the build)." +msgstr "Scrive la pagina degli autori e ``AUTHORS.md`` (eseguito dalla costruzione)." + +msgid "``docs/source/case-keys.inc``" +msgstr "" + +msgid "" +"Reference of the case-file keys, generated from the schema. After changing " +"``ldem.schema.caseSchema`` regenerate it from MATLAB with " +"``ldem.schema.writeKeyReference(\"docs/source/case-keys.inc\")``; a test fails if it " +"is out of date." +msgstr "" +"Riferimento delle chiavi del file di caso, generato dallo schema. Dopo aver cambiato " +"``ldem.schema.caseSchema`` si rigenera da MATLAB con " +"``ldem.schema.writeKeyReference(\"docs/source/case-keys.inc\")``; un test fallisce se" +" è obsoleto." + +msgid "Write or change a page" +msgstr "Scrivere o modificare una pagina" + +msgid "" +"Edit the English page in ``docs/source/``. A new page also goes in the list of " +"``index.rst``." +msgstr "" +"Modificare la pagina inglese in ``docs/source/``. Una pagina nuova va anche " +"nell'elenco di ``index.rst``." + +msgid "" +"Run ``python docs/tools/update_translations.py``. It extracts the texts and updates " +"the ``.po`` files: new texts appear untranslated and changed texts are marked as " +"fuzzy, both shown in English until they are translated." +msgstr "" +"Eseguire ``python docs/tools/update_translations.py``. Estrae i testi e aggiorna i " +"file ``.po``: i testi nuovi compaiono non tradotti e i testi modificati sono marcati " +"come fuzzy; entrambi sono mostrati in inglese finché non vengono tradotti." + +msgid "" +"Translate the new entries in ``docs/locale//LC_MESSAGES/.po`` (with " +"any text editor or a tool such as Poedit) and remove the fuzzy marks you have " +"reviewed. ``python docs/tools/update_translations.py --status`` shows how much is " +"left in each language." +msgstr "" +"Tradurre le voci nuove in ``docs/locale//LC_MESSAGES/.po`` (con un " +"qualsiasi editor di testo o uno strumento come Poedit) e togliere i contrassegni " +"fuzzy che sono stati rivisti. ``python docs/tools/update_translations.py --status`` " +"mostra quanto resta in ogni lingua." + +msgid "Build with ``python docs/tools/build_docs.py`` and fix any warning." +msgstr "Costruire con ``python docs/tools/build_docs.py`` e correggere ogni avviso." + +msgid "Publishing" +msgstr "Pubblicazione" + +msgid "" +"The workflow ``.github/workflows/docs.yml`` builds the documentation on every pull " +"request and publishes the four languages to GitHub Pages when ``main`` changes." +msgstr "" +"Il workflow ``.github/workflows/docs.yml`` costruisce la documentazione a ogni pull " +"request e pubblica le quattro lingue su GitHub Pages quando cambia ``main``." + diff --git a/docs/locale/it/LC_MESSAGES/examples.po b/docs/locale/it/LC_MESSAGES/examples.po new file mode 100644 index 0000000..661788b --- /dev/null +++ b/docs/locale/it/LC_MESSAGES/examples.po @@ -0,0 +1,587 @@ +# Translation of the LDEM-MATLAB documentation (it). +# Generated by docs/tools/update_translations.py: edit only the msgstr entries. +msgid "" +msgstr "" +"Project-Id-Version: LDEM-MATLAB\n" +"Report-Msgid-Bugs-To: \n" +"Last-Translator: \n" +"Language: it\n" +"Language-Team: \n" +"Plural-Forms: nplurals=2; plural=(n != 1);\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.18.0\n" + +msgid "Examples" +msgstr "Esempi" + +msgid "" +"The folder ``examples/`` has three models that run from start to finish, each with " +"its inputs and a script that runs it and plots the results. The numbers in this page " +"come from running them with the current code." +msgstr "" +"La cartella ``examples/`` contiene tre modelli che girano dall'inizio alla fine, " +"ciascuno con i propri dati di ingresso e uno script che lo esegue e traccia i " +"risultati. I numeri di questa pagina provengono dalla loro esecuzione con il codice " +"attuale." + +msgid "Folder" +msgstr "Cartella" + +msgid "What it shows" +msgstr "Cosa mostra" + +msgid "Size" +msgstr "Dimensione" + +msgid "Time" +msgstr "Tempo" + +msgid "``example1_clamped_beam/``" +msgstr "" + +msgid "A beam clamped at both ends and loaded with a force at mid-span" +msgstr "Una trave incastrata a entrambe le estremità e caricata con una forza in mezzeria" + +msgid "3,086 nodes" +msgstr "3,086 nodi" + +msgid "about 35 s" +msgstr "circa 35 s" + +msgid "``tension_101/``" +msgstr "" + +msgid "A small prism under a uniaxial load, with damage and every output format" +msgstr "Un piccolo prisma sotto carico uniassiale, con danno e tutti i formati di uscita" + +msgid "74 nodes" +msgstr "74 nodi" + +msgid "about 6 s" +msgstr "circa 6 s" + +msgid "``beam_102/``" +msgstr "" + +msgid "The four-point bending beam of the paper (a demo of its first 50 steps)" +msgstr "" +"La trave a flessione su quattro punti dell'articolo (una dimostrazione dei suoi primi" +" 50 passi)" + +msgid "166,961 nodes" +msgstr "166,961 nodi" + +msgid "about 30 s for 50 steps" +msgstr "circa 30 s per 50 passi" + +msgid "" +"Start with ``tension_101`` to learn the interface and with ``example1_clamped_beam`` " +"to see a model loaded with a force, described by a case file and checked against the " +"original code." +msgstr "" +"Iniziare con ``tension_101`` per imparare l'interfaccia e con " +"``example1_clamped_beam`` per vedere un modello caricato con una forza, descritto da " +"un file di caso e verificato rispetto al codice originale." + +msgid "Running an example" +msgstr "Eseguire un esempio" + +msgid "From MATLAB, from any folder:" +msgstr "Da MATLAB, da qualsiasi cartella:" + +#, python-format +msgid "" +">> run('examples/example1_clamped_beam/runClampedBeam.m') % script: run and" +" plot\n" +">> results = ldem.run('examples/example1_clamped_beam/case.ldem'); % from the case " +"file" +msgstr "" +">> run('examples/example1_clamped_beam/runClampedBeam.m') % script: esegue " +"e traccia\n" +">> results = ldem.run('examples/example1_clamped_beam/case.ldem'); % dal file di caso" + +msgid "" +"The two beam examples also have a ``case.ldem``: the same model in the readable case-" +"file format (see :doc:`usage`), generated from the ``DATA0.DAT`` of the original " +"program and giving the same parameters. ``ldem.check`` shows what a case file would " +"simulate without running it." +msgstr "" +"I due esempi di trave hanno anche un ``case.ldem``: lo stesso modello nel formato " +"leggibile del file di caso (vedi :doc:`usage`), generato dal ``DATA0.DAT`` del " +"programma originale e che dà gli stessi parametri. ``ldem.check`` mostra cosa " +"simulerebbe un file di caso senza eseguirlo." + +msgid "" +"The scripts write their files to a folder ``output`` next to the script (ignored by " +"git), or to ``outputFolder`` if that variable already exists:" +msgstr "" +"Gli script scrivono i loro file in una cartella ``output`` accanto allo script " +"(ignorata da git), o in ``outputFolder`` se quella variabile esiste già:" + +msgid "" +"``results.mat``: one struct, ``results``, with everything that was recorded. Load it " +"with ``data = load('results.mat'); results = data.results;``." +msgstr "" +"``results.mat``: una struttura, ``results``, con tutto ciò che è stato registrato. Si" +" carica con ``data = load('results.mat'); results = data.results;``." + +msgid "``snapshot_0000.mac``, ...: ANSYS macro files of the deformed lattice." +msgstr "``snapshot_0000.mac``, ...: file macro di ANSYS del reticolo deformato." + +msgid "" +"``snapshot_0000.vtu``, ... and ``snapshots.pvd``: open ``snapshots.pvd`` in `ParaView" +" `_ to see the damage evolve in time." +msgstr "" +"``snapshot_0000.vtu``, ... e ``snapshots.pvd``: aprire ``snapshots.pvd`` in `ParaView" +" `_ per vedere il danno evolvere nel tempo." + +msgid "Example 1: beam clamped at both ends" +msgstr "Esempio 1: trave incastrata a entrambe le estremità" + +msgid "" +"A small beam of 5 x 5 x 50 modules of 1 mm, clamped at both ends and loaded at mid-" +"span with a force that grows during 0.35 ms and then stays constant. It is the model " +"of Rodrigo (branch ``dev_rodrigo``) and the first test loaded with a force instead of" +" a displacement (``ldem.scenarios.ClampedBeam``, test 103)." +msgstr "" +"Una piccola trave di 5 x 5 x 50 moduli da 1 mm, incastrata a entrambe le estremità e " +"caricata in mezzeria con una forza che cresce per 0.35 ms e poi resta costante. È il " +"modello di Rodrigo (ramo ``dev_rodrigo``) e la prima prova caricata con una forza " +"invece che con uno spostamento (``ldem.scenarios.ClampedBeam``, prova 103)." + +msgid "The model" +msgstr "Il modello" + +msgid "Part" +msgstr "Parte" + +msgid "Value" +msgstr "Valore" + +msgid "Geometry" +msgstr "Geometria" + +msgid "" +"5 x 5 x 50 modules of 1 mm (a prism of 5 x 5 x 50 mm, axis along z), with 3,086 " +"nodes, 18,085 bars and a mass of 1.875 g" +msgstr "" +"5 x 5 x 50 moduli da 1 mm (un prisma di 5 x 5 x 50 mm, asse lungo z), con 3,086 nodi," +" 18,085 barre e una massa di 1.875 g" + +msgid "Supports" +msgstr "Appoggi" + +msgid "" +"The centre nodes of the first and of the last layer of modules (z = 0.5 and z = 49.5 " +"modules) are clamped: x, y and z held" +msgstr "" +"I nodi centrali del primo e dell'ultimo strato di moduli (z = 0.5 e z = 49.5 moduli) " +"sono incastrati: x, y e z bloccati" + +msgid "Load" +msgstr "Carico" + +msgid "" +"The 5 centre nodes of the line at mid-span (z = 24.5 modules, y = 0.5 modules) carry " +"a force in +y of ``1000 N/s * min(t, 0.35 ms)`` each: 0.35 N per node, 1.75 N in " +"total" +msgstr "" +"I 5 nodi centrali della linea in mezzeria (z = 24.5 moduli, y = 0.5 moduli) portano " +"ciascuno una forza in +y di ``1000 N/s * min(t, 0.35 ms)``: 0.35 N per nodo, 1.75 N " +"in totale" + +msgid "Material" +msgstr "Materiale" + +msgid "" +"E = 3.87 GPa, Poisson's ratio 0.25, density 1500 kg/m\\ :sup:`3`, fracture energy 0.5" +" N/m, critical distance 4.5 mm; mass-proportional damping of 2500 1/s" +msgstr "" +"E = 3.87 GPa, coefficiente di Poisson 0.25, densità 1500 kg/m\\ :sup:`3`, energia di " +"frattura 0.5 N/m, distanza critica 4.5 mm; smorzamento proporzionale alla massa di " +"2500 1/s" + +msgid "Scatter" +msgstr "Dispersione" + +msgid "" +"One multiplier of the critical strain per bar, read from a file (shared with " +"``beam_102``)" +msgstr "" +"Un moltiplicatore della deformazione critica per barra, letto da un file (condiviso " +"con ``beam_102``)" + +#, python-format +msgid "2.8 ms in 8000 steps of 0.35 us (65 % of the critical step)" +msgstr "2.8 ms in 8000 passi da 0.35 us (65 % del passo critico)" + +msgid "Recorded" +msgstr "Registrato" + +msgid "" +"Control nodes 2441 (a loaded node) and 884 (a grid node at mid-span); tracked bar " +"14398" +msgstr "" +"Nodi di controllo 2441 (un nodo caricato) e 884 (un nodo d'angolo in mezzeria); barra" +" seguita 14398" + +msgid "" +"The original input file listed five control nodes, but nodes 6870 and 14398 do not " +"exist in this 3,086-node mesh, so the input keeps 2441 and 884. The tracked bar is " +"14398, as in the original." +msgstr "" +"Il file di ingresso originale elencava cinque nodi di controllo, ma i nodi 6870 e " +"14398 non esistono in questa mesh di 3,086 nodi, quindi l'ingresso mantiene 2441 e " +"884. La barra seguita è la 14398, come nell'originale." + +msgid "Files" +msgstr "File" + +msgid "File" +msgstr "File" + +msgid "Purpose" +msgstr "Scopo" + +msgid "``case.ldem``" +msgstr "" + +msgid "The model as a case file: run it with ``ldem.run``" +msgstr "Il modello come file di caso: si esegue con ``ldem.run``" + +msgid "``runClampedBeam.m``" +msgstr "" + +msgid "" +"Reads ``DATA0.DAT``, runs the simulation and plots the force on the clamped ends, the" +" vertical displacement of the control nodes and the energies" +msgstr "" +"Legge ``DATA0.DAT``, esegue la simulazione e traccia la forza alle estremità " +"incastrate, lo spostamento verticale dei nodi di controllo e le energie" + +msgid "``DATA0.DAT``" +msgstr "" + +msgid "The parameters in the format of the original program (``TEST 103``)" +msgstr "I parametri nel formato del programma originale (``TEST 103``)" + +msgid "" +"The scenario and the load are the lines of the ``[scenario]`` section of " +"``case.ldem``:" +msgstr "Lo scenario e il carico sono le righe della sezione ``[scenario]`` di ``case.ldem``:" + +msgid "" +"[scenario]\n" +"type = \"clamped_beam\"\n" +"force_rate = 1000 N/s\n" +"ramp_time = 0.35 ms\n" +"load_position = \"midspan\"\n" +"load_height = 0.5 modules" +msgstr "" + +msgid "" +"The same test can be written without a scenario class, with supports and loads. It " +"gives the same results as ``ldem.scenarios.ClampedBeam`` (the tests check it):" +msgstr "" +"La stessa prova si può scrivere senza una classe di scenario, con appoggi e carichi. " +"Dà gli stessi risultati di ``ldem.scenarios.ClampedBeam`` (i test lo verificano):" + +msgid "" +"[scenario]\n" +"type = \"custom\"\n" +"\n" +"[[support]]\n" +"name = \"first end\"\n" +"z = 0.5\n" +"fix = [\"x\", \"y\", \"z\"]\n" +"reaction = true\n" +"\n" +"[[support]]\n" +"name = \"last end\"\n" +"z = \"max - 0.5\"\n" +"fix = [\"x\", \"y\", \"z\"]\n" +"reaction = true\n" +"\n" +"[[load]]\n" +"name = \"line at mid-span\"\n" +"y = 0.5\n" +"z = \"mid - 0.5\"\n" +"direction = \"y\"\n" +"type = \"force\"\n" +"time_function = \"ramp\"\n" +"rate = 1000 N/s\n" +"until = 0.35 ms" +msgstr "" + +msgid "Reading the results" +msgstr "Leggere i risultati" + +#, python-format +msgid "" +">> results = ldem.run('examples/example1_clamped_beam/case.ldem', " +"OutputFolder=tempname);\n" +">> y0 = results.mesh.nodes0(results.params.controlNodes, 2).';\n" +">> dy = results.controlNodes.displacement(:, :, 2) - y0; % vertical displacement " +"[m]\n" +">> results.reactions.force(end, :) % force on the clamped " +"ends [N]\n" +">> ldem.post.plotReaction(results);\n" +">> ldem.post.plotEnergy(results);" +msgstr "" +">> results = ldem.run('examples/example1_clamped_beam/case.ldem', " +"OutputFolder=tempname);\n" +">> y0 = results.mesh.nodes0(results.params.controlNodes, 2).';\n" +">> dy = results.controlNodes.displacement(:, :, 2) - y0; % spostamento verticale " +"[m]\n" +">> results.reactions.force(end, :) % forza alle estremità " +"incastrate [N]\n" +">> ldem.post.plotReaction(results);\n" +">> ldem.post.plotEnergy(results);" + +msgid "What you should see" +msgstr "Cosa si dovrebbe vedere" + +msgid "" +"Force carried by the clamped ends. It rises with the load, overshoots to 1.94 N and " +"settles at the total applied force." +msgstr "" +"Forza sopportata dalle estremità incastrate. Cresce con il carico, supera fino a 1.94" +" N e si stabilizza sulla forza totale applicata." + +msgid "" +"Vertical displacement of the two control nodes: a peak of 6.7 um at 0.46 ms and about" +" 6.3 um at the end." +msgstr "" +"Spostamento verticale dei due nodi di controllo: un picco di 6.7 um a 0.46 ms e circa" +" 6.3 um alla fine." + +msgid "Energies. The external work equals the sum of the internal energies." +msgstr "Energie. Il lavoro esterno è uguale alla somma delle energie interne." + +msgid "" +"The reaction settles at 1.75 N, the 1.75 N applied in total: the beam is in " +"equilibrium at the end. The overshoot (1.94 N) and the oscillation are the dynamic " +"response, which the damping removes." +msgstr "" +"La reazione si stabilizza a 1.75 N, gli 1.75 N applicati in totale: la trave è in " +"equilibrio alla fine. Il superamento (1.94 N) e l'oscillazione sono la risposta " +"dinamica, che lo smorzamento elimina." + +msgid "" +"With these values the beam stays elastic: at the end 18,085 bars are intact and none " +"is damaged or broken." +msgstr "" +"Con questi valori la trave resta elastica: alla fine 18,085 barre sono intatte e " +"nessuna è danneggiata o rotta." + +msgid "" +"The energy balance closes: the external work of 5.76 uJ is the elastic energy (5.48 " +"uJ) plus the energy dissipated by damping (0.28 uJ); the kinetic energy is about zero" +" and the balance is below 1e-13 J." +msgstr "" +"Il bilancio energetico si chiude: il lavoro esterno di 5.76 uJ è l'energia elastica " +"(5.48 uJ) più l'energia dissipata dallo smorzamento (0.28 uJ); l'energia cinetica è " +"quasi zero e il bilancio è inferiore a 1e-13 J." + +msgid "Try other values" +msgstr "Provare altri valori" + +msgid "" +"Every key of the case file can be changed, or swept without editing the file (see " +":doc:`usage`):" +msgstr "" +"Ogni chiave del file di caso si può cambiare, o scansionare senza modificare il file " +"(vedi :doc:`usage`):" + +#, python-brace-format +msgid "" +">> summary = ldem.sweep('examples/example1_clamped_beam/case.ldem', ...\n" +" Vary = {'scenario.force_rate', [\"10 kN/s\" \"30 kN/s\" \"100 kN/s\"]}, " +"Formats = \"mat\");" +msgstr "" + +msgid "" +"With the original value (1 kN/s) no bar is damaged. Ten times more force already " +"breaks the beam; each run takes about 50 s:" +msgstr "" +"Con il valore originale (1 kN/s) nessuna barra si danneggia. Con una forza dieci " +"volte maggiore la trave si rompe già; ogni esecuzione dura circa 50 s:" + +msgid "Force rate" +msgstr "Velocità della forza" + +msgid "Damaged bars (including broken)" +msgstr "Barre danneggiate (comprese le rotte)" + +msgid "Broken bars" +msgstr "Barre rotte" + +msgid "10 kN/s" +msgstr "" + +msgid "5,630" +msgstr "" + +msgid "3,584" +msgstr "" + +msgid "30 kN/s" +msgstr "" + +msgid "6,074" +msgstr "" + +msgid "3,579" +msgstr "" + +msgid "100 kN/s" +msgstr "" + +msgid "4,760" +msgstr "" + +msgid "2,783" +msgstr "" + +msgid "" +"After the failure the loaded nodes keep being pushed by the force and move freely, so" +" the displacements of these runs are not meaningful; the damage counts are. Each run " +"has its own folder (``run_001``, ...) with its results and its resolved " +"``case.ldem``, and the table is also saved as ``sweep_summary.csv``." +msgstr "" +"Dopo la rottura, i nodi caricati continuano a essere spinti dalla forza e si muovono " +"liberamente, quindi gli spostamenti di queste esecuzioni non hanno significato; i " +"conteggi del danno sì. Ogni esecuzione ha la propria cartella (``run_001``, ...) con " +"i suoi risultati e il suo ``case.ldem`` risolto, e la tabella viene salvata anche " +"come ``sweep_summary.csv``." + +msgid "" +"Other changes to try in ``case.ldem``: ``law = \"linear_elastic\"`` (no damage at " +"all), ``type = \"generated\"`` with a ``cv`` in ``[material.scatter]`` to generate " +"the random field in memory instead of reading it, or ``type = \"none\"`` to remove " +"the scatter." +msgstr "" +"Altre modifiche da provare in ``case.ldem``: ``law = \"linear_elastic\"`` (nessun " +"danno), ``type = \"generated\"`` con un ``cv`` in ``[material.scatter]`` per generare" +" il campo casuale in memoria invece di leggerlo, oppure ``type = \"none\"`` per " +"eliminare la dispersione." + +msgid "Example: uniaxial prism" +msgstr "Esempio: prisma uniassiale" + +msgid "" +"``examples/tension_101/runTension.m`` runs a prism of 5 x 2 x 2 modules of 3 mm (74 " +"nodes, 313 bars) under the uniaxial test (test 101): the centre nodes of the last " +"column move along x with a prescribed velocity of 4 mm/s while those of the first " +"column are held. It is the best place to start: it has no input file, the model is " +"described in the script with ``ldem.Parameters``, and it writes every kind of output." +msgstr "" +"``examples/tension_101/runTension.m`` esegue un prisma di 5 x 2 x 2 moduli da 3 mm " +"(74 nodi, 313 barre) sotto la prova uniassiale (prova 101): i nodi centrali " +"dell'ultima colonna si muovono lungo x con una velocità imposta di 4 mm/s mentre " +"quelli della prima colonna sono bloccati. È il posto migliore da cui iniziare: non ha" +" un file di ingresso, il modello è descritto nello script con ``ldem.Parameters`` e " +"scrive ogni tipo di uscita." + +msgid "" +"E = 32 GPa, Poisson's ratio 0.25, density 2000 kg/m\\ :sup:`3`; a low fracture energy" +" of 0.1 N/m on purpose, so that bars soften and break" +msgstr "" +"E = 32 GPa, coefficiente di Poisson 0.25, densità 2000 kg/m\\ :sup:`3`; un'energia di" +" frattura bassa di 0.1 N/m di proposito, perché le barre si ammorbidiscano e si " +"rompano" + +msgid "0.2 ms in 1000 steps of 0.2 us" +msgstr "0.2 ms in 1000 passi da 0.2 us" + +msgid "Output" +msgstr "Uscita" + +msgid "" +"Snapshots (ANSYS and VTK) every 250 steps, control nodes and energies every 10 steps," +" no tracked bar" +msgstr "" +"Istantanee (ANSYS e VTK) ogni 250 passi, nodi di controllo ed energie ogni 10 passi, " +"senza barra seguita" + +#, python-format +msgid "" +"At the end 251 bars are intact, 58 are damaged and 4 are broken. The external work is" +" 24.7 uJ: 22.5 uJ of elastic energy, 2.2 uJ dissipated by damage and 0.03 uJ by " +"damping; the balance is 0.01 % of the external work." +msgstr "" +"Alla fine 251 barre sono intatte, 58 danneggiate e 4 rotte. Il lavoro esterno è di " +"24.7 uJ: 22.5 uJ di energia elastica, 2.2 uJ dissipati dal danno e 0.03 uJ dallo " +"smorzamento; il bilancio è lo 0.01 % del lavoro esterno." + +msgid "Energies of the uniaxial prism." +msgstr "Energie del prisma uniassiale." + +msgid "" +"With the sign convention of the original code a positive ``loadingVelocity`` moves " +"the loaded face toward the fixed one, that is, it compresses the prism; use a " +"negative value to pull it (see ``ldem.scenarios.UniaxialTension``)." +msgstr "" +"Con la convenzione dei segni del codice originale, un ``loadingVelocity`` positivo " +"muove la faccia caricata verso quella fissa, cioè comprime il prisma; usare un valore" +" negativo per tirarlo (vedi ``ldem.scenarios.UniaxialTension``)." + +msgid "Example: four-point bending beam" +msgstr "Esempio: trave a flessione su quattro punti" + +msgid "" +"``examples/beam_102/runBeam.m`` reads the input of the beam of the paper (test 102, " +"``ldem.scenarios.FourPointBending``): 100 x 40 x 20 modules of 3 mm (300 x 120 x 60 " +"mm), 166,961 nodes and 1,126,960 bars. The beam rests on two supports 4.5 modules " +"from its ends and two load points 33.5 modules from its ends push its top face down " +"with a prescribed velocity of 4 mm/s. The material is E = 32 GPa, density 2000 kg/m\\" +" :sup:`3`, fracture energy 50 N/m, critical distance 28 mm, with a random field of " +"the critical strain read from a file." +msgstr "" +"``examples/beam_102/runBeam.m`` legge l'ingresso della trave dell'articolo (prova " +"102, ``ldem.scenarios.FourPointBending``): 100 x 40 x 20 moduli da 3 mm (300 x 120 x " +"60 mm), 166,961 nodi e 1,126,960 barre. La trave poggia su due appoggi a 4.5 moduli " +"dalle sue estremità e due punti di carico a 33.5 moduli dalle sue estremità spingono " +"la faccia superiore verso il basso con una velocità imposta di 4 mm/s. Il materiale " +"ha E = 32 GPa, densità 2000 kg/m\\ :sup:`3`, energia di frattura 50 N/m, distanza " +"critica 28 mm, con un campo casuale della deformazione critica letto da un file." + +msgid "" +"The real simulation has 150,000 steps (0.03 s in steps of 0.2 us) and needs roughly " +"20 hours on a laptop (about 0.5 s per step). The script therefore runs only the first" +" 50 steps: it builds the complete model (about 20 s) and shows that the input is read" +" and the model runs; the plotted reaction is only that of the start of the test. " +"Change ``nStepsDemo`` at the top of the script, or remove the ``totalTime`` override," +" for the full run." +msgstr "" +"La simulazione reale ha 150,000 passi (0.03 s in passi da 0.2 us) e richiede circa 20" +" ore su un portatile (circa 0.5 s per passo). Per questo lo script esegue solo i " +"primi 50 passi: costruisce il modello completo (circa 20 s) e mostra che l'ingresso " +"viene letto e il modello gira; la reazione tracciata è solo quella dell'inizio della " +"prova. Cambiare ``nStepsDemo`` all'inizio dello script, o togliere la sostituzione di" +" ``totalTime``, per l'esecuzione completa." + +msgid "The same parameters as a case file (``ldem.io.readCase``, ``ldem.run``)" +msgstr "Gli stessi parametri come file di caso (``ldem.io.readCase``, ``ldem.run``)" + +msgid "Parameters in the format of the original program (``ldem.Parameters.fromFile``)" +msgstr "Parametri nel formato del programma originale (``ldem.Parameters.fromFile``)" + +msgid "``arquivo_3lc_rnao_cv05``" +msgstr "" + +msgid "" +"Random field applied to the critical strain of each bar (11 MB); it is also used by " +"``example1_clamped_beam``" +msgstr "" +"Campo casuale applicato alla deformazione critica di ogni barra (11 MB); è usato " +"anche da ``example1_clamped_beam``" + +msgid "``runBeam.m``" +msgstr "" + +msgid "Reads the input, runs the first 50 steps and plots the reaction force" +msgstr "Legge l'ingresso, esegue i primi 50 passi e traccia la forza di reazione" + diff --git a/docs/locale/it/LC_MESSAGES/index.po b/docs/locale/it/LC_MESSAGES/index.po new file mode 100644 index 0000000..0180b6a --- /dev/null +++ b/docs/locale/it/LC_MESSAGES/index.po @@ -0,0 +1,34 @@ +# Translation of the LDEM-MATLAB documentation (it). +# Generated by docs/tools/update_translations.py: edit only the msgstr entries. +msgid "" +msgstr "" +"Project-Id-Version: LDEM-MATLAB\n" +"Report-Msgid-Bugs-To: \n" +"Last-Translator: \n" +"Language: it\n" +"Language-Team: \n" +"Plural-Forms: nplurals=2; plural=(n != 1);\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.18.0\n" + +msgid "User guide" +msgstr "Guida per l'utente" + +msgid "API" +msgstr "" + +msgid "LDEM-MATLAB" +msgstr "" + +msgid "Lattice Discrete Element Method (LDEM) in MATLAB." +msgstr "Metodo degli Elementi Discreti tipo Lattice (LDEM) in MATLAB." + +msgid "" +"The documentation is written in English and translated into Spanish, Portuguese and " +"Italian. Choose the language in the sidebar of any page." +msgstr "" +"La documentazione è scritta in inglese e tradotta in spagnolo, portoghese e italiano." +" Scegliere la lingua nella barra laterale di qualsiasi pagina." + diff --git a/docs/locale/it/LC_MESSAGES/installation.po b/docs/locale/it/LC_MESSAGES/installation.po new file mode 100644 index 0000000..4379269 --- /dev/null +++ b/docs/locale/it/LC_MESSAGES/installation.po @@ -0,0 +1,70 @@ +# Translation of the LDEM-MATLAB documentation (it). +# Generated by docs/tools/update_translations.py: edit only the msgstr entries. +msgid "" +msgstr "" +"Project-Id-Version: LDEM-MATLAB\n" +"Report-Msgid-Bugs-To: \n" +"Last-Translator: \n" +"Language: it\n" +"Language-Team: \n" +"Plural-Forms: nplurals=2; plural=(n != 1);\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.18.0\n" + +msgid "Installation" +msgstr "Installazione" + +msgid "" +"Requirements: MATLAB R2022b or newer (developed and tested on R2023b). The package " +"itself uses the ``arguments`` block and name=value syntax; the test suite and " +"``buildtool`` need R2022b. No toolbox is required." +msgstr "" +"Requisiti: MATLAB R2022b o successivo (sviluppato e testato su R2023b). Il pacchetto " +"usa il blocco ``arguments`` e la sintassi nome=valore; la suite di test e " +"``buildtool`` richiedono R2022b. Non serve alcun toolbox." + +msgid "" +"git clone ldem-matlab\n" +"cd ldem-matlab" +msgstr "" +"git clone ldem-matlab\n" +"cd ldem-matlab" + +msgid ">> setup_path" +msgstr "" + +msgid "Check the installation with the fast tests:" +msgstr "Verificare l'installazione con i test rapidi:" + +msgid ">> buildtool test" +msgstr "" + +msgid "Developer tasks (``buildtool`` is run from the repository root):" +msgstr "Attività per sviluppatori (``buildtool`` si esegue dalla radice del repository):" + +#, python-format +msgid "" +">> buildtool % static analysis + fast tests (the default)\n" +">> buildtool check % Code Analyzer only\n" +">> buildtool testAll % all tests, including the slow ones\n" +">> buildtool docs % build this documentation (needs Python)\n" +">> buildtool clean % delete generated files" +msgstr "" +">> buildtool % analisi statica + test rapidi (predefinito)\n" +">> buildtool check % solo l'analizzatore di codice\n" +">> buildtool testAll % tutti i test, compresi quelli lenti\n" +">> buildtool docs % costruire questa documentazione (richiede Python)\n" +">> buildtool clean % eliminare i file generati" + +msgid "" +"``buildtool test`` writes ``test-results/results.xml`` (JUnit) and ``code-" +"coverage/coverage.xml`` (Cobertura)." +msgstr "" +"``buildtool test`` scrive ``test-results/results.xml`` (JUnit) e ``code-" +"coverage/coverage.xml`` (Cobertura)." + +msgid "To build this documentation without MATLAB see :doc:`docs`." +msgstr "Per costruire questa documentazione senza MATLAB vedi :doc:`docs`." + diff --git a/docs/locale/it/LC_MESSAGES/introduction.po b/docs/locale/it/LC_MESSAGES/introduction.po new file mode 100644 index 0000000..40c785e --- /dev/null +++ b/docs/locale/it/LC_MESSAGES/introduction.po @@ -0,0 +1,79 @@ +# Translation of the LDEM-MATLAB documentation (it). +# Generated by docs/tools/update_translations.py: edit only the msgstr entries. +msgid "" +msgstr "" +"Project-Id-Version: LDEM-MATLAB\n" +"Report-Msgid-Bugs-To: \n" +"Last-Translator: \n" +"Language: it\n" +"Language-Team: \n" +"Plural-Forms: nplurals=2; plural=(n != 1);\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.18.0\n" + +msgid "Introduction" +msgstr "Introduzione" + +msgid "" +"The **Lattice Discrete Element Method (LDEM)** models a continuum as a regular " +"lattice of nodes connected by bars arranged in cubic modules (edges plus diagonals). " +"Nodal masses are lumped, bar constitutive laws include damage/fracture, and the " +"equations of motion are integrated with an explicit central-difference scheme. " +"Energies (external, kinetic, elastic, dissipated) are tracked at every step." +msgstr "" +"Il **Metodo degli Elementi Discreti a Reticolo (LDEM)** modella un continuo come un " +"reticolo regolare di nodi collegati da barre disposte in moduli cubici (spigoli più " +"diagonali). Le masse sono concentrate nei nodi, le leggi costitutive delle barre " +"includono danno/frattura e le equazioni del moto sono integrate con uno schema " +"esplicito alle differenze centrali. Le energie (esterna, cinetica, elastica, " +"dissipata) sono monitorate a ogni passo." + +msgid "Main parts of the ``ldem`` package (see :doc:`api/index`):" +msgstr "Parti principali del pacchetto ``ldem`` (vedi :doc:`api/index`):" + +msgid "" +"``ldem.Parameters`` / ``ldem.io.readCase`` / ``ldem.io.readInputFile`` – validated " +"input data (case files and the legacy ``DATA0.DAT``)." +msgstr "" +"``ldem.Parameters`` / ``ldem.io.readCase`` / ``ldem.io.readInputFile`` – dati di " +"ingresso validati (file di caso e il ``DATA0.DAT`` originale)." + +msgid "``ldem.run`` / ``ldem.sweep`` / ``ldem.check`` – run, sweep and check a case file." +msgstr "" +"``ldem.run`` / ``ldem.sweep`` / ``ldem.check`` – eseguire, scansionare e controllare " +"un file di caso." + +msgid "``ldem.mesh`` – nodes, bars, masses and bar geometry." +msgstr "``ldem.mesh`` – nodi, barre, masse e geometria delle barre." + +msgid "``ldem.material`` – bar stiffness, critical strain and the bilinear damage law." +msgstr "" +"``ldem.material`` – rigidezza delle barre, deformazione critica e legge bilineare di " +"danno." + +msgid "``ldem.scenarios`` – supports, loads and reactions of each test." +msgstr "``ldem.scenarios`` – vincoli, carichi e reazioni di ogni prova." + +msgid "``ldem.solver`` – time integration and energy balance." +msgstr "``ldem.solver`` – integrazione nel tempo e bilancio energetico." + +msgid "" +"``ldem.runSimulation`` – the whole simulation, with ``results.mat``, ANSYS and VTK " +"output." +msgstr "" +"``ldem.runSimulation`` – la simulazione completa, con uscita ``results.mat``, ANSYS e" +" VTK." + +msgid "" +"The routines of the original program (``ini_DEM3``, ``read_dat0``, ``RMEC``, " +"``BOUND``, ``CALOAD``, ``ENERG2``, ...) are kept in the git history under the tag " +"``legacy-reference``; the ``Legacy:`` line of each help text names the routine it " +"replaces." +msgstr "" +"Le routine del programma originale (``ini_DEM3``, ``read_dat0``, ``RMEC``, ``BOUND``," +" ``CALOAD``, ``ENERG2``, ...) sono conservate nella cronologia di git, con il tag " +"``legacy-reference``; la riga ``Legacy:`` di ogni guida indica la routine che " +"sostituisce." + diff --git a/docs/locale/it/LC_MESSAGES/model.po b/docs/locale/it/LC_MESSAGES/model.po new file mode 100644 index 0000000..f1418c8 --- /dev/null +++ b/docs/locale/it/LC_MESSAGES/model.po @@ -0,0 +1,240 @@ +# Translation of the LDEM-MATLAB documentation (it). +# Generated by docs/tools/update_translations.py: edit only the msgstr entries. +msgid "" +msgstr "" +"Project-Id-Version: LDEM-MATLAB\n" +"Report-Msgid-Bugs-To: \n" +"Last-Translator: \n" +"Language: it\n" +"Language-Team: \n" +"Plural-Forms: nplurals=2; plural=(n != 1);\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.18.0\n" + +msgid "Building a different model" +msgstr "Costruire un modello diverso" + +msgid "" +"A model is defined by three things: the **geometry** of the lattice, the **material**" +" and the **test** (supports and loads). The first two are parameters; the third is a " +"*scenario* class. You can change any of them without touching the solver." +msgstr "" +"Un modello è definito da tre cose: la **geometria** del reticolo, il **materiale** e " +"la **prova** (vincoli e carichi). Le prime due sono parametri; la terza è una classe " +"*scenario*. Ciascuna si può cambiare senza toccare il solver." + +msgid "1. Change the geometry and the material" +msgstr "1. Cambiare la geometria e il materiale" + +msgid "Everything is a property of ``ldem.Parameters``:" +msgstr "Tutto è una proprietà di ``ldem.Parameters``:" + +#, python-format +msgid "" +">> params = ldem.Parameters(testId=101, ...\n" +" moduleLength=0.002, ... % edge of the cubic module [m]\n" +" nModules=[21 6 6], ... % nodes along x, y and z\n" +" youngModulus=30e9, density=2400, poissonRatio=0.2, ...\n" +" fractureEnergy=80, criticalDistance=0.02, ...\n" +" meshPerturbation=0.02); % optional irregular mesh" +msgstr "" +">> params = ldem.Parameters(testId=101, ...\n" +" moduleLength=0.002, ... % spigolo del modulo cubico [m]\n" +" nModules=[21 6 6], ... % nodi in x, y e z\n" +" youngModulus=30e9, density=2400, poissonRatio=0.2, ...\n" +" fractureEnergy=80, criticalDistance=0.02, ...\n" +" meshPerturbation=0.02); % mesh irregolare (opzionale)" + +msgid "" +"``nModules = [M N L]`` is the number of grid nodes along each axis, so the prism has " +"``(M-1)*(N-1)*(L-1)`` modules." +msgstr "" +"``nModules = [M N L]`` è il numero di nodi della griglia lungo ogni asse, quindi il " +"prisma ha ``(M-1)*(N-1)*(L-1)`` moduli." + +msgid "" +"``randomFieldFile`` multiplies the critical strain of each bar by a value read from a" +" text file (a random field of the material strength)." +msgstr "" +"``randomFieldFile`` moltiplica la deformazione critica di ogni barra per un valore " +"letto da un file di testo (campo casuale della resistenza)." + +msgid "" +"``randomFieldCv`` generates that random field in memory instead, with no file: " +"Weibull values with mean 1 and that coefficient of variation on a grid of poles " +"spaced ``randomFieldCorrelationLength`` module lengths apart (default 3), " +"interpolated to each bar; ``randomFieldSeed`` fixes the random numbers. The value of " +"each bar is kept in ``results.barProps.randomField``." +msgstr "" +"``randomFieldCv`` genera invece quel campo casuale in memoria, senza file: valori di " +"Weibull con media 1 e quel coefficiente di variazione su una griglia di poli " +"distanziati ``randomFieldCorrelationLength`` lunghezze di modulo (3 per default), " +"interpolati su ogni barra; ``randomFieldSeed`` fissa i numeri casuali. Il valore di " +"ogni barra resta in ``results.barProps.randomField``." + +msgid "" +"``dt`` must be below ``params.criticalTimeStep``; ``Parameters`` rejects an unstable " +"value and says so." +msgstr "" +"``dt`` deve essere minore di ``params.criticalTimeStep``; ``Parameters`` rifiuta un " +"valore instabile e ne spiega il motivo." + +msgid "" +"The same data can come from a case file (``ldem.io.readCase``, see :doc:`usage`) or " +"from an input file in the format of the original program with " +"``ldem.Parameters.fromFile(\"DATA0.DAT\", ...)``; extra name=value pairs override the" +" file. The mesh can be built and inspected before running anything:" +msgstr "" +"Gli stessi dati possono provenire da un file di caso (``ldem.io.readCase``, vedi " +":doc:`usage`) o da un file di ingresso nel formato del programma originale: " +"``ldem.Parameters.fromFile(\"DATA0.DAT\", ...)``; le coppie nome=valore aggiuntive " +"sostituiscono quelle del file. La mesh può essere costruita e ispezionata prima di " +"eseguire qualsiasi cosa:" + +#, python-format +msgid "" +">> mesh = ldem.mesh.buildMesh(params);\n" +">> fprintf(\"%d nodes, %d bars\\n\", size(mesh.nodes0, 1), size(mesh.bars, 1));" +msgstr "" +">> mesh = ldem.mesh.buildMesh(params);\n" +">> fprintf(\"%d nodi, %d barre\\n\", size(mesh.nodes0, 1), size(mesh.bars, 1));" + +msgid "2. Change the test: write a scenario" +msgstr "2. Cambiare la prova: scrivere uno scenario" + +msgid "" +"A *scenario* says which degrees of freedom are fixed, how the load is applied at " +"every time step and which reaction is reported. The solver never checks the test " +"number, it only asks the scenario. To model a new test, create a subclass of " +"``ldem.scenarios.Scenario`` in ``src/+ldem/+scenarios/``." +msgstr "" +"Uno *scenario* dice quali gradi di libertà sono bloccati, come viene applicato il " +"carico a ogni passo di tempo e quale reazione viene riportata. Il solver non " +"controlla mai il numero della prova: lo chiede allo scenario. Per modellare una prova" +" nuova si crea una sottoclasse di ``ldem.scenarios.Scenario`` in " +"``src/+ldem/+scenarios/``." + +msgid "" +"The example below is a cantilever beam along :math:`z`: the first layer of centre " +"nodes is clamped and a force that grows linearly is applied in :math:`y` at the free " +"end." +msgstr "" +"L'esempio è una trave a mensola lungo :math:`z`: il primo strato di nodi centrali è " +"incastrato e all'estremità libera si applica in :math:`y` una forza che cresce " +"linearmente." + +#, python-format +msgid "" +"classdef Cantilever < ldem.scenarios.Scenario\n" +" properties (Constant)\n" +" testId = 104 % new number, unique\n" +" end\n" +" properties\n" +" forceRate (1,1) double = 500 % [N/s] on each loaded node\n" +" end\n" +" methods\n" +" function fixed = fixedDofs(~, nodes0, params)\n" +" z = nodes0(:, 3);\n" +" atStart = abs(z - 0.5*params.moduleLength) < 0.01*params.moduleLength;\n" +" fixed = false(size(nodes0));\n" +" fixed(atStart, :) = true; % x, y and z held\n" +" end\n" +" function state = applyLoads(obj, state, mesh, params)\n" +" L1 = params.nModules(3) - 1;\n" +" z = mesh.nodes0(:, 3);\n" +" atEnd = abs(z - (L1 - 0.5)*params.moduleLength) < " +"0.01*params.moduleLength;\n" +" state.appliedForce(:) = 0;\n" +" state.appliedForce(atEnd, 2) = obj.forceRate * state.time;\n" +" end\n" +" end\n" +"end" +msgstr "" +"classdef Cantilever < ldem.scenarios.Scenario\n" +" properties (Constant)\n" +" testId = 104 % numero nuovo, univoco\n" +" end\n" +" properties\n" +" forceRate (1,1) double = 500 % [N/s] su ogni nodo caricato\n" +" end\n" +" methods\n" +" function fixed = fixedDofs(~, nodes0, params)\n" +" z = nodes0(:, 3);\n" +" atStart = abs(z - 0.5*params.moduleLength) < 0.01*params.moduleLength;\n" +" fixed = false(size(nodes0));\n" +" fixed(atStart, :) = true; % x, y e z bloccati\n" +" end\n" +" function state = applyLoads(obj, state, mesh, params)\n" +" L1 = params.nModules(3) - 1;\n" +" z = mesh.nodes0(:, 3);\n" +" atEnd = abs(z - (L1 - 0.5)*params.moduleLength) < " +"0.01*params.moduleLength;\n" +" state.appliedForce(:) = 0;\n" +" state.appliedForce(atEnd, 2) = obj.forceRate * state.time;\n" +" end\n" +" end\n" +"end" + +msgid "Rules to follow:" +msgstr "Regole:" + +msgid "" +"``fixedDofs`` returns an ``nNodes``-by-3 logical matrix, true where the node cannot " +"move (``1 = x``, ``2 = y``, ``3 = z``)." +msgstr "" +"``fixedDofs`` restituisce una matrice logica ``nNodes`` per 3, vera dove il nodo non " +"può muoversi (``1 = x``, ``2 = y``, ``3 = z``)." + +msgid "" +"``applyLoads`` runs once per step. A **displacement-controlled** test sets " +"``state.displacement`` of the loaded nodes (see ``UniaxialTension``); a **force-" +"controlled** test sets ``state.appliedForce`` in newtons (see ``ClampedBeam``) and " +"the solver counts its work in the external energy." +msgstr "" +"``applyLoads`` viene eseguito a ogni passo. Una prova **a spostamento controllato** " +"assegna ``state.displacement`` dei nodi caricati (vedi ``UniaxialTension``); una **a " +"forza controllata** assegna ``state.appliedForce`` in newton (vedi ``ClampedBeam``) e" +" il solver ne conta il lavoro nell'energia esterna." + +msgid "Override ``reactions`` if the test reports a reaction force (default: ``NaN``)." +msgstr "" +"Ridefinire ``reactions`` se la prova riporta una forza di reazione (predefinito: " +"``NaN``)." + +msgid "" +"The centre nodes of the modules lie at half-integer multiples of ``moduleLength``; " +"select nodes with a small tolerance, never with ``==``." +msgstr "" +"I nodi centrali dei moduli si trovano a multipli semi-interi di ``moduleLength``; " +"selezionare i nodi con una piccola tolleranza, mai con ``==``." + +msgid "3. Register and run it" +msgstr "3. Registrarlo ed eseguirlo" + +msgid "Either pass the object directly, with no registration:" +msgstr "L'oggetto si può passare direttamente, senza registrare nulla:" + +msgid "" +">> scenario = ldem.scenarios.Cantilever(forceRate=1000);\n" +">> results = ldem.runSimulation(params, Scenario=scenario, ...\n" +" OutputFolder=\"output\", Formats=[\"mat\" \"vtk\"]);" +msgstr "" + +msgid "" +"or add one line to ``ldem.scenarios.registry`` so that ``testId = 104`` finds it and " +"a case file can name it with ``type``. Then add a test in ``tests/unit`` and, if it " +"is a reference case, an example in ``examples/`` (see " +"``examples/example1_clamped_beam``)." +msgstr "" +"oppure aggiungere una riga a ``ldem.scenarios.registry`` in modo che ``testId = 104``" +" lo trovi e un file di caso possa nominarlo con ``type``. Poi si aggiunge un test in " +"``tests/unit`` e, se è un caso di riferimento, un esempio in ``examples/`` (vedi " +"``examples/example1_clamped_beam``)." + +msgid "The result is the same ``results`` struct as for any other test, see :doc:`usage`." +msgstr "" +"Il risultato è la stessa struttura ``results`` di qualsiasi altra prova, vedi " +":doc:`usage`." + diff --git a/docs/locale/it/LC_MESSAGES/sphinx.po b/docs/locale/it/LC_MESSAGES/sphinx.po new file mode 100644 index 0000000..aa0ebc2 --- /dev/null +++ b/docs/locale/it/LC_MESSAGES/sphinx.po @@ -0,0 +1,45 @@ +# User-interface texts of the theme (Furo) in it: buttons, search and page navigation. +# Kept by hand: docs/tools/update_translations.py does not touch this file. +msgid "" +msgstr "" +"Project-Id-Version: LDEM-MATLAB\n" +"Report-Msgid-Bugs-To: \n" +"Last-Translator: \n" +"Language: it\n" +"Language-Team: \n" +"Plural-Forms: nplurals=2; plural=(n != 1);\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.18.0\n" + +msgid "Skip to content" +msgstr "Vai al contenuto" + +msgid "Back to top" +msgstr "Torna su" + +msgid "Next" +msgstr "Successivo" + +msgid "Previous" +msgstr "Precedente" + +msgid "Home" +msgstr "Home" + +msgid "On this page" +msgstr "In questa pagina" + +msgid "Search" +msgstr "Cerca" + +msgid "Index" +msgstr "Indice" + +msgid "Error" +msgstr "Errore" + +msgid "Please activate JavaScript to enable the search functionality." +msgstr "Attivare JavaScript per abilitare la funzione di ricerca." + diff --git a/docs/locale/it/LC_MESSAGES/usage.po b/docs/locale/it/LC_MESSAGES/usage.po new file mode 100644 index 0000000..cd599c5 --- /dev/null +++ b/docs/locale/it/LC_MESSAGES/usage.po @@ -0,0 +1,1346 @@ +# Translation of the LDEM-MATLAB documentation (it). +# Generated by docs/tools/update_translations.py: edit only the msgstr entries. +msgid "" +msgstr "" +"Project-Id-Version: LDEM-MATLAB\n" +"Report-Msgid-Bugs-To: \n" +"Last-Translator: \n" +"Language: it\n" +"Language-Team: \n" +"Plural-Forms: nplurals=2; plural=(n != 1);\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.18.0\n" + +msgid "Usage" +msgstr "Uso" + +msgid "Run a simulation" +msgstr "Eseguire una simulazione" + +msgid "" +">> setup_path % adds src/ to the MATLAB path\n" +">> params = ldem.Parameters(testId=101, nModules=[6 3 3], totalTime=2e-4, ...\n" +" fractureEnergy=0.1, ...\n" +" output=struct('snapshotEvery', 250, 'controlNodesEvery', 10, ...\n" +" 'energyEvery', 10, 'trackedBarEvery', 0));\n" +">> results = ldem.runSimulation(params, OutputFolder=\"output\", ...\n" +" Formats=[\"mat\" \"ansys\" \"vtk\"]);\n" +">> ldem.post.plotEnergy(results);" +msgstr "" +">> setup_path % aggiunge src/ al path di MATLAB\n" +">> params = ldem.Parameters(testId=101, nModules=[6 3 3], totalTime=2e-4, ...\n" +" fractureEnergy=0.1, ...\n" +" output=struct('snapshotEvery', 250, 'controlNodesEvery', 10, ...\n" +" 'energyEvery', 10, 'trackedBarEvery', 0));\n" +">> results = ldem.runSimulation(params, OutputFolder=\"output\", ...\n" +" Formats=[\"mat\" \"ansys\" \"vtk\"]);\n" +">> ldem.post.plotEnergy(results);" + +msgid "" +"``ldem.Parameters`` checks every value when it is set and explains what is wrong (for" +" example an unstable time step). The complete, ready-to-run version of this script is" +" ``examples/tension_101/runTension.m``." +msgstr "" +"``ldem.Parameters`` valida ogni valore quando viene assegnato e spiega cosa non va " +"(per esempio un passo di tempo instabile). La versione completa e pronta all'uso è in" +" ``examples/tension_101/runTension.m``." + +msgid "To use an input file in the format of the original program:" +msgstr "Per usare un file di ingresso nel formato del programma originale:" + +msgid ">> params = ldem.Parameters.fromFile(\"DATA0.DAT\");" +msgstr "" + +msgid "Case files (``.ldem``)" +msgstr "File di caso (``.ldem``)" + +msgid "" +"A *case file* describes the whole model in one readable text file: named keys instead" +" of positions, units next to the numbers, comments, and the test, the random scatter " +"and the output files together. It replaces ``DATA0.DAT``." +msgstr "" +"Un *file di caso* descrive l'intero modello in un unico testo leggibile: chiavi con " +"nome invece di posizioni, unità accanto ai numeri, commenti, e la prova, la " +"dispersione casuale e i file di uscita insieme. Sostituisce ``DATA0.DAT``." + +msgid "" +"format = 1\n" +"title = \"Small tension test\"\n" +"\n" +"[mesh]\n" +"module_size = 3 mm\n" +"modules = [5, 2, 2] # cubic modules along x, y and z\n" +"\n" +"[material]\n" +"young_modulus = 32 GPa\n" +"density = 2000 kg/m3\n" +"\n" +"[time]\n" +"step = auto # 0.9 times the critical step\n" +"duration = 40 us\n" +"\n" +"[scenario]\n" +"type = \"uniaxial_tension\"\n" +"\n" +"[output]\n" +"folder = \"output\"" +msgstr "" +"format = 1\n" +"title = \"Piccola prova di trazione\"\n" +"\n" +"[mesh]\n" +"module_size = 3 mm\n" +"modules = [5, 2, 2] # moduli cubici lungo x, y e z\n" +"\n" +"[material]\n" +"young_modulus = 32 GPa\n" +"density = 2000 kg/m3\n" +"\n" +"[time]\n" +"step = auto # 0.9 volte il passo critico\n" +"duration = 40 us\n" +"\n" +"[scenario]\n" +"type = \"uniaxial_tension\"\n" +"\n" +"[output]\n" +"folder = \"output\"" + +#, python-format +msgid "" +">> ldem.io.writeTemplate(\"my_test.ldem\", \"clamped_beam\"); % a commented file to " +"edit\n" +">> ldem.check(\"my_test.ldem\") % validate and report, " +"no simulation\n" +">> results = ldem.run(\"my_test.ldem\"); % run it\n" +">> ldem.io.convertLegacyInput(\"DATA0.DAT\", \"case.ldem\"); % convert an old input" +" file" +msgstr "" +">> ldem.io.writeTemplate(\"mia_prova.ldem\", \"clamped_beam\"); % file commentato da" +" modificare\n" +">> ldem.check(\"mia_prova.ldem\") % valida e riferisce, " +"senza simulare\n" +">> results = ldem.run(\"mia_prova.ldem\"); % la esegue\n" +">> ldem.io.convertLegacyInput(\"DATA0.DAT\", \"caso.ldem\"); % converte un " +"vecchio file" + +msgid "Rules of the format:" +msgstr "Regole del formato:" + +msgid "" +"Keys are read by **name**; the order of the lines does not matter. Keys that are " +"missing take the default of ``ldem.Parameters``. Only ``scenario.type``, " +"``mesh.modules`` and ``time.duration`` are required." +msgstr "" +"Le chiavi si leggono per **nome**; l'ordine delle righe non conta. Le chiavi assenti " +"prendono il valore predefinito di ``ldem.Parameters``. Sono obbligatorie solo " +"``scenario.type``, ``mesh.modules`` e ``time.duration``." + +msgid "" +"A number may carry a **unit**: ``3.87 GPa``, ``0.35 us``, ``1500 kg/m3``, ``2 kN/s``." +" Without a unit the value is in SI. The wrong unit for the key is an error that lists" +" the valid ones." +msgstr "" +"Un numero può avere un'**unità**: ``3.87 GPa``, ``0.35 us``, ``1500 kg/m3``, ``2 " +"kN/s``. Senza unità il valore è in SI. Un'unità sbagliata per la chiave è un errore " +"che elenca quelle valide." + +msgid "" +"``#`` starts a comment, ``[section]`` opens a table, ``[[monitor.node]]`` starts the " +"next element of a repeated table, lists are written ``[5, 5, 50]``." +msgstr "" +"``#`` inizia un commento, ``[sezione]`` apre una tabella, ``[[monitor.node]]`` inizia" +" l'elemento successivo di una tabella ripetuta e le liste si scrivono ``[5, 5, 50]``." + +msgid "" +"``mesh.modules`` counts **modules**: the ``M N L`` of ``DATA0.DAT`` count nodes, one " +"more." +msgstr "" +"``mesh.modules`` conta **moduli**: gli ``M N L`` di ``DATA0.DAT`` contano nodi, uno " +"in più." + +msgid "``time.step = auto`` (or no ``step``) takes 0.9 times the critical step." +msgstr "``time.step = auto`` (o senza ``step``) prende 0.9 volte il passo critico." + +msgid "" +"Every error names the file, the line, the section and the key, and suggests the " +"closest valid name for a mistyped one." +msgstr "" +"Ogni errore indica il file, la riga, la sezione e la chiave, e suggerisce il nome " +"valido più vicino se c'è un errore di battitura." + +msgid "" +"Relative paths (the random-field file, the output folder) are relative to the case " +"file." +msgstr "" +"I percorsi relativi (file del campo casuale, cartella di uscita) sono relativi al " +"file di caso." + +msgid "A JSON file with the same structure (values with units as strings) is also read." +msgstr "Si legge anche un file JSON con la stessa struttura (i valori con unità come testo)." + +msgid "Section" +msgstr "Sezione" + +msgid "Keys" +msgstr "Chiavi" + +msgid "(top)" +msgstr "(inizio)" + +msgid "``format`` (1), ``title``, ``authors``" +msgstr "" + +msgid "``[mesh]``" +msgstr "" + +msgid "" +"``module_size``, ``modules``, ``perturbation`` (random displacement of the nodes, " +"fraction of the module), ``seed`` (of the perturbation)" +msgstr "" +"``module_size``, ``modules``, ``perturbation`` (spostamento casuale dei nodi, " +"frazione del modulo), ``seed`` (della perturbazione)" + +msgid "``[material]``" +msgstr "" + +msgid "" +"``law`` (``bilinear``, the legacy law, or ``linear_elastic``: no damage and no " +"rupture), ``young_modulus``, ``poisson_ratio``, ``density``, ``fracture_energy``, " +"``critical_distance``, ``failure_area_factor``" +msgstr "" +"``law`` (``bilinear``, la legge originale, o ``linear_elastic``: senza danno né " +"rottura), ``young_modulus``, ``poisson_ratio``, ``density``, ``fracture_energy``, " +"``critical_distance``, ``failure_area_factor``" + +msgid "``[material.scatter]``" +msgstr "" + +msgid "" +"Scatter of the critical strain of the bars. ``type = \"none\"``; ``\"file\"`` with " +"``file`` (one multiplier per bar); or ``\"generated\"`` with ``cv``, " +"``correlation_length`` (in modules) and ``seed`` (the field is computed in memory)" +msgstr "" +"Dispersione della deformazione critica delle barre. ``type = \"none\"``; ``\"file\"``" +" con ``file`` (un moltiplicatore per barra); oppure ``\"generated\"`` con ``cv``, " +"``correlation_length`` (in moduli) e ``seed`` (il campo è calcolato in memoria)" + +msgid "``[time]``" +msgstr "" + +msgid "``step`` (or ``auto``), ``duration``" +msgstr "``step`` (o ``auto``), ``duration``" + +msgid "``[damping]``" +msgstr "" + +msgid "" +"``type`` (``mass_proportional``, the legacy damping, or ``none``), ``initial``, " +"``final``, ``switch_time`` (not allowed with ``none``), ``constitutive``" +msgstr "" +"``type`` (``mass_proportional``, lo smorzamento originale, o ``none``), ``initial``, " +"``final``, ``switch_time`` (non ammessi con ``none``), ``constitutive``" + +msgid "``[scenario]``" +msgstr "" + +msgid "" +"``type`` (``uniaxial_tension``, ``four_point_bending``, ``clamped_beam`` or " +"``custom``, see below) and the properties of that scenario in snake_case, for example" +" ``force_rate``, ``ramp_time``, ``load_position`` (``\"midspan\"`` is allowed)" +msgstr "" +"``type`` (``uniaxial_tension``, ``four_point_bending``, ``clamped_beam`` o " +"``custom``, vedi sotto) e le proprietà di quello scenario in snake_case, per esempio " +"``force_rate``, ``ramp_time``, ``load_position`` (è ammesso ``\"midspan\"``)" + +msgid "``[[monitor.node]]``" +msgstr "" + +msgid "" +"One element per control node: ``id`` (node number) or ``at = [x, y, z]`` (position in" +" modules, the nearest node is used), and ``name``" +msgstr "" +"Un elemento per nodo di controllo: ``id`` (numero del nodo) oppure ``at = [x, y, z]``" +" (posizione in moduli, si usa il nodo più vicino), e ``name``" + +msgid "``[monitor.bar]``" +msgstr "" + +msgid "``tracked``: bar whose strain history is stored at every step" +msgstr "``tracked``: barra la cui storia di deformazione è salvata a ogni passo" + +msgid "``[output]``" +msgstr "" + +msgid "``folder``, ``mat``, ``ansys``, ``vtk`` (true or false)" +msgstr "``folder``, ``mat``, ``ansys``, ``vtk`` (true o false)" + +msgid "``[output.snapshots]``, ``[output.control_nodes]``, ``[output.energy]``" +msgstr "" + +msgid "" +"``every``: ``1000 steps`` or a time such as ``0.1 ms`` (converted to steps); ``0`` " +"means never" +msgstr "" +"``every``: ``1000 steps`` o un tempo come ``0.1 ms`` (convertito in passi); ``0`` " +"significa mai" + +msgid "" +"``ldem.io.readCase`` returns the parameters, the scenario and the output options; " +"``ldem.Parameters.fromFile`` also accepts a case file. The list of keys lives in one " +"table, ``ldem.schema.caseSchema``, which drives the reader, the writer and the " +"template. To add a scenario, add a line to ``ldem.scenarios.registry``. A new " +"constitutive law is a subclass of ``ldem.material.MaterialLaw`` registered in " +"``ldem.material.lawRegistry``; a new damping model is a subclass of " +"``ldem.solver.DampingModel`` registered in ``ldem.solver.dampingRegistry``." +msgstr "" +"``ldem.io.readCase`` restituisce i parametri, lo scenario e le opzioni di uscita; " +"``ldem.Parameters.fromFile`` accetta anche un file di caso. L'elenco delle chiavi è " +"in un'unica tabella, ``ldem.schema.caseSchema``, che governa il lettore, lo scrittore" +" e il modello. Per aggiungere uno scenario si aggiunge una riga a " +"``ldem.scenarios.registry``. Una nuova legge costitutiva è una sottoclasse di " +"``ldem.material.MaterialLaw`` registrata in ``ldem.material.lawRegistry``; un nuovo " +"modello di smorzamento, una sottoclasse di ``ldem.solver.DampingModel`` registrata in" +" ``ldem.solver.dampingRegistry``." + +msgid "Your own test: supports and loads" +msgstr "La propria prova: appoggi e carichi" + +msgid "" +"With ``type = \"custom\"`` the test is described in the case file by ``[[support]]`` " +"and ``[[load]]`` blocks, without writing a class. This is the uniaxial test (``testId" +" = 101``) as blocks:" +msgstr "" +"Con ``type = \"custom\"`` la prova si descrive nel file di caso con blocchi " +"``[[support]]`` e ``[[load]]``, senza scrivere una classe. Questa è la prova " +"uniassiale (``testId = 101``) come blocchi:" + +msgid "" +"[scenario]\n" +"type = \"custom\"\n" +"\n" +"[[support]]\n" +"name = \"left end\"\n" +"x = 0.5 # the layer of centre nodes at x = 0.5 modules\n" +"fix = [\"x\"] # directions that cannot move\n" +"\n" +"[[load]]\n" +"name = \"right end\"\n" +"x = \"max - 0.5\"\n" +"direction = \"x\"\n" +"type = \"displacement\" # or \"force\"\n" +"time_function = \"linear\"\n" +"rate = -4 mm/s\n" +"reaction = true # its force is the reaction of the test" +msgstr "" +"[scenario]\n" +"type = \"custom\"\n" +"\n" +"[[support]]\n" +"name = \"left end\"\n" +"x = 0.5 # lo strato di nodi centrali a x = 0.5 moduli\n" +"fix = [\"x\"] # direzioni che non si possono muovere\n" +"\n" +"[[load]]\n" +"name = \"right end\"\n" +"x = \"max - 0.5\"\n" +"direction = \"x\"\n" +"type = \"displacement\" # oppure \"force\"\n" +"time_function = \"linear\"\n" +"rate = -4 mm/s\n" +"reaction = true # la sua forza è la reazione della prova" + +msgid "" +"**Nodes** are chosen with ``nodes`` (``all``, ``grid`` for the corners of the modules" +" or ``centre`` for their centres), ``ids`` (node numbers) and ``x``, ``y``, ``z``. A " +"position is in modules (centre nodes lie at half-integers, grid nodes at integers), a" +" range ``[lo, hi]``, or a text with the references ``min``, ``max`` and ``mid`` and " +"an offset, such as ``\"max - 0.5\"``. A node must satisfy every condition. The " +"positions refer to the regular lattice, so they do not change when " +"``mesh.perturbation`` moves the nodes." +msgstr "" +"I **nodi** si scelgono con ``nodes`` (``all``, ``grid`` per gli angoli dei moduli o " +"``centre`` per i loro centri), ``ids`` (numeri di nodo) e ``x``, ``y``, ``z``. Una " +"posizione è in moduli (i nodi centrali sono a semi-interi, quelli d'angolo a interi)," +" un intervallo ``[lo, hi]``, o un testo con i riferimenti ``min``, ``max`` e ``mid`` " +"e uno scostamento, come ``\"max - 0.5\"``. Un nodo deve soddisfare tutte le " +"condizioni. Le posizioni si riferiscono al reticolo regolare, quindi non cambiano " +"quando ``mesh.perturbation`` sposta i nodi." + +msgid "" +"**Supports** hold the directions listed in ``fix``. **Loads** act on one " +"``direction`` as a ``force`` (newtons on each selected node) or as a prescribed " +"``displacement`` (metres from the initial position, and the solver holds that " +"direction). The value follows ``time_function``: ``constant`` (``value``), ``linear``" +" (``rate``), ``ramp`` (``rate`` until the time ``until``, then constant) or ``table``" +" (``times`` and ``values`` in SI units, linear between points and constant outside)." +msgstr "" +"Gli **appoggi** bloccano le direzioni di ``fix``. I **carichi** agiscono su una " +"``direction`` come ``force`` (newton su ogni nodo scelto) o come ``displacement`` " +"imposto (metri dalla posizione iniziale; il solver blocca quella direzione). Il " +"valore segue ``time_function``: ``constant`` (``value``), ``linear`` (``rate``), " +"``ramp`` (``rate`` fino al tempo ``until``, poi costante) o ``table`` (``times`` e " +"``values`` in unità SI, lineare tra i punti e costante fuori)." + +msgid "" +"A block with ``reaction = true`` adds its force to the reaction of the test (the sum " +"of the bar forces on its held directions); with none, the reaction is NaN. A block " +"that selects no node is an error that names it. The three built-in tests written this" +" way give exactly the same results as their classes." +msgstr "" +"Un blocco con ``reaction = true`` aggiunge la sua forza alla reazione della prova (la" +" somma delle forze di barra nelle sue direzioni bloccate); se nessuno la richiede, la" +" reazione è NaN. Un blocco che non sceglie alcun nodo è un errore che lo nomina. Le " +"tre prove incorporate scritte così danno esattamente gli stessi risultati delle loro " +"classi." + +msgid "Reuse a case: extends" +msgstr "Riutilizzare un caso: extends" + +msgid "A case file can start from another one and change only what differs:" +msgstr "Un file di caso può partire da un altro e cambiare solo ciò che differisce:" + +msgid "" +"extends = \"base.ldem\" # or a list: [\"base.ldem\", \"material.ldem\"]\n" +"\n" +"[material]\n" +"fracture_energy = 1 N/m # only what changes" +msgstr "" +"extends = \"base.ldem\" # oppure un elenco: [\"base.ldem\", " +"\"material.ldem\"]\n" +"\n" +"[material]\n" +"fracture_energy = 1 N/m # solo ciò che cambia" + +msgid "" +"The keys of the file replace the inherited ones. A repeated table (``[[support]]``, " +"``[[load]]``, ``[[monitor.node]]``, ``[[sweep]]``) replaces the whole inherited list." +" When the ``type`` of the scenario, of ``[material.scatter]`` or of ``[damping]`` " +"changes, the keys of the old type that are not set again are dropped. With a list, " +"later files win. Relative paths (the random-field file, the output folder) are " +"relative to the file that contains them, and an error names the file and line where " +"the problem is written. ``results.info.case.parents`` keeps the hash of every " +"inherited file." +msgstr "" +"Le chiavi del file sostituiscono quelle ereditate. Una tabella ripetuta " +"(``[[support]]``, ``[[load]]``, ``[[monitor.node]]``, ``[[sweep]]``) sostituisce " +"l'intero elenco ereditato. Quando cambia il ``type`` dello scenario, di " +"``[material.scatter]`` o di ``[damping]``, le chiavi del tipo precedente non " +"ridefinite vengono scartate. Con un elenco, i file successivi prevalgono. I percorsi " +"relativi (file del campo casuale, cartella di uscita) sono relativi al file che li " +"contiene, e un errore indica il file e la riga in cui il problema è scritto. " +"``results.info.case.parents`` conserva l'hash di ogni file ereditato." + +msgid "Parameter sweeps" +msgstr "Scansioni di parametri" + +msgid "" +"To study how the result depends on a value, list the values in ``[[sweep]]`` blocks " +"and run ``ldem.sweep``:" +msgstr "" +"Per studiare come il risultato dipende da un valore, si elencano i valori in blocchi " +"``[[sweep]]`` e si esegue ``ldem.sweep``:" + +msgid "" +"[[sweep]]\n" +"key = \"material.fracture_energy\"\n" +"values = [\"0.1 N/m\", \"0.5 N/m\", \"1 N/m\"]\n" +"\n" +"[[sweep]]\n" +"key = \"time.duration\"\n" +"values = [\"20 us\", \"40 us\"]" +msgstr "" + +#, python-brace-format, python-format +msgid "" +">> summary = ldem.sweep(\"case.ldem\"); % 3 x 2 = 6 runs, one folder " +"each\n" +">> ldem.sweep(\"case.ldem\", DryRun=true); % only validate and list the " +"runs\n" +">> ldem.sweep(\"case.ldem\", Vary={\"scenario.force_rate\", [\"1 kN/s\" \"2 " +"kN/s\"]});\n" +">> results = ldem.run(\"case.ldem\", Overrides=struct(\"path\", " +"\"material.fracture_energy\", \"value\", \"2 N/m\"));" +msgstr "" +">> summary = ldem.sweep(\"case.ldem\"); % 3 x 2 = 6 esecuzioni, una " +"cartella ciascuna\n" +">> ldem.sweep(\"case.ldem\", DryRun=true); % valida ed elenca soltanto " +"le esecuzioni\n" +">> ldem.sweep(\"case.ldem\", Vary={\"scenario.force_rate\", [\"1 kN/s\" \"2 " +"kN/s\"]});\n" +">> results = ldem.run(\"case.ldem\", Overrides=struct(\"path\", " +"\"material.fracture_energy\", \"value\", \"2 N/m\"));" + +msgid "" +"Several blocks give every combination; ``sweep_mode = \"zip\"`` (a key at the top of " +"the file) takes them one by one. Any key with a single value can be varied, and the " +"keys of the scenario as ``scenario.``. Values are numbers or texts with units. " +"Every run is validated before the first one starts. The runs go to ``run_001``, " +"``run_002``, ... (each with its resolved ``case.ldem``) and the table " +"``sweep_summary.csv`` lists them, with the number of damaged and broken bars; a run " +"that fails is recorded and the sweep goes on." +msgstr "" +"Più blocchi danno tutte le combinazioni; ``sweep_mode = \"zip\"`` (una chiave " +"all'inizio del file) li prende uno a uno. Si può variare qualsiasi chiave a valore " +"singolo, e quelle dello scenario come ``scenario.``. I valori sono numeri o " +"testi con unità. Ogni esecuzione viene validata prima di iniziare la prima. Le " +"esecuzioni vanno in ``run_001``, ``run_002``, ... (ciascuna con il proprio " +"``case.ldem`` risolto) e la tabella ``sweep_summary.csv`` le elenca, con il numero di" +" barre danneggiate e rotte; un'esecuzione che fallisce viene registrata e la " +"scansione prosegue." + +msgid "Reference of every key" +msgstr "Riferimento di tutte le chiavi" + +msgid "" +"The tables below are generated from ``ldem.schema.caseSchema``, the same table that " +"the reader uses, so they always agree with it." +msgstr "" +"Le tabelle seguenti sono generate da ``ldem.schema.caseSchema``, la stessa tabella " +"usata dal lettore, quindi concordano sempre con esso. Le descrizioni sono in inglese." + +msgid "``(top level)``" +msgstr "``(livello superiore)``" + +msgid "Key" +msgstr "Chiave" + +msgid "Value" +msgstr "Valore" + +msgid "Default" +msgstr "Predefinito" + +msgid "Legacy" +msgstr "Originale" + +msgid "Description" +msgstr "Descrizione" + +msgid "``format``" +msgstr "" + +msgid "integer" +msgstr "intero" + +msgid "1" +msgstr "" + +msgid "(none)" +msgstr "(nessuno)" + +msgid "Version of the case-file format (currently 1)." +msgstr "Versione del formato del file di caso (attualmente 1)." + +msgid "``title``" +msgstr "" + +msgid "text" +msgstr "testo" + +msgid "Free text title of the case." +msgstr "Titolo del caso, in testo libero." + +msgid "``authors``" +msgstr "" + +msgid "list of texts" +msgstr "elenco di testi" + +msgid "Names of the authors." +msgstr "Nomi degli autori." + +msgid "``extends``" +msgstr "" + +msgid "Case file(s) to inherit from; the keys of this file replace the inherited ones." +msgstr "" +"File di caso da cui si eredita; le chiavi di questo file sostituiscono quelle " +"ereditate." + +msgid "``sweep_mode``" +msgstr "" + +msgid "product, zip" +msgstr "" + +msgid "\"product\"" +msgstr "" + +msgid "How several [[sweep]] blocks combine: all combinations (product) or one by one (zip)." +msgstr "" +"Come si combinano più blocchi [[sweep]]: tutte le combinazioni (product) o uno a uno " +"(zip)." + +msgid "``module_size``" +msgstr "" + +msgid "number + unit (m, cm, mm, um, km)" +msgstr "numero + unità (m, cm, mm, um, km)" + +msgid "3 mm" +msgstr "" + +msgid "LCO" +msgstr "" + +msgid "Edge length of each cubic module." +msgstr "Lunghezza dello spigolo di ogni modulo cubico." + +msgid "``modules``" +msgstr "" + +msgid "list of integers" +msgstr "elenco di interi" + +msgid "required" +msgstr "obbligatorio" + +msgid "M N L" +msgstr "" + +msgid "Cubic modules along x, y and z (M N L of the legacy file count nodes: one more)." +msgstr "Moduli cubici lungo x, y e z (gli M N L del file originale contano nodi: uno in più)." + +msgid "``perturbation``" +msgstr "" + +msgid "number" +msgstr "numero" + +msgid "0" +msgstr "" + +msgid "Random node displacement as a fraction of the module size; 0 = regular lattice." +msgstr "" +"Spostamento casuale dei nodi come frazione della dimensione del modulo; 0 = reticolo " +"regolare." + +msgid "``seed``" +msgstr "" + +msgid "123" +msgstr "" + +msgid "SEED" +msgstr "" + +msgid "Seed of the mesh perturbation (the random field has its own seed)." +msgstr "Seme della perturbazione della mesh (il campo casuale ha il proprio seme)." + +msgid "``law``" +msgstr "" + +msgid "bilinear, linear\\_elastic" +msgstr "" + +msgid "\"bilinear\"" +msgstr "" + +msgid "Constitutive law of the bars (see ldem.material.lawRegistry)." +msgstr "Legge costitutiva delle barre (vedi ldem.material.lawRegistry)." + +msgid "``young_modulus``" +msgstr "" + +msgid "number + unit (Pa, kPa, MPa, GPa)" +msgstr "numero + unità (Pa, kPa, MPa, GPa)" + +msgid "32 GPa" +msgstr "" + +msgid "YNG" +msgstr "" + +msgid "Young's modulus." +msgstr "Modulo di Young." + +msgid "``poisson_ratio``" +msgstr "" + +msgid "0.25" +msgstr "" + +msgid "PSN" +msgstr "" + +msgid "Poisson's ratio, from 0 up to less than 0.5." +msgstr "Coefficiente di Poisson, da 0 fino a meno di 0.5." + +msgid "``density``" +msgstr "" + +msgid "number + unit (kg/m3, g/cm3)" +msgstr "numero + unità (kg/m3, g/cm3)" + +msgid "2000 kg/m3" +msgstr "" + +msgid "ROH" +msgstr "" + +msgid "Mass density." +msgstr "Densità di massa." + +msgid "``fracture_energy``" +msgstr "" + +msgid "number + unit (N/m, kN/m)" +msgstr "numero + unità (N/m, kN/m)" + +msgid "50 N/m" +msgstr "" + +msgid "GFR" +msgstr "" + +msgid "Specific fracture energy." +msgstr "Energia di frattura specifica." + +msgid "``critical_distance``" +msgstr "" + +msgid "28 mm" +msgstr "" + +msgid "DEQ" +msgstr "" + +msgid "Equivalent (critical) distance." +msgstr "Distanza equivalente (critica)." + +msgid "``failure_area_factor``" +msgstr "" + +msgid "0.1385" +msgstr "" + +msgid "CAF" +msgstr "" + +msgid "Fraction of the module face that fails per bar." +msgstr "Frazione della faccia del modulo che si rompe per ogni barra." + +msgid "``type``" +msgstr "" + +msgid "none, file, generated" +msgstr "" + +msgid "\"none\"" +msgstr "" + +msgid "Scatter of the critical strain: none, file (one multiplier per bar) or generated." +msgstr "" +"Dispersione della deformazione critica: none, file (un moltiplicatore per barra) o " +"generated." + +msgid "``file``" +msgstr "" + +msgid "file path" +msgstr "percorso del file" + +msgid "Text file with one multiplier per bar, relative to this file." +msgstr "File di testo con un moltiplicatore per barra, relativo a questo file." + +msgid "``cv``" +msgstr "" + +msgid "Coefficient of variation of the generated field (1e-4 to 3)." +msgstr "Coefficiente di variazione del campo generato (da 1e-4 a 3)." + +msgid "``correlation_length``" +msgstr "" + +msgid "list of numbers" +msgstr "elenco di numeri" + +msgid "[3]" +msgstr "" + +msgid "Correlation length of the generated field in modules: one value or [x, y, z]." +msgstr "Lunghezza di correlazione del campo generato in moduli: un valore o [x, y, z]." + +msgid "515" +msgstr "" + +msgid "Seed of the generated field." +msgstr "Seme del campo generato." + +msgid "``step``" +msgstr "" + +msgid "time, or auto" +msgstr "tempo, oppure auto" + +msgid "\"auto\"" +msgstr "" + +msgid "DT" +msgstr "" + +msgid "Integration time step, or auto (0.9 times the critical step)." +msgstr "Passo di integrazione nel tempo, oppure auto (0.9 volte il passo critico)." + +msgid "``duration``" +msgstr "" + +msgid "number + unit (s, ms, us, ns)" +msgstr "numero + unità (s, ms, us, ns)" + +msgid "TTOT" +msgstr "" + +msgid "Total simulated time." +msgstr "Tempo totale simulato." + +msgid "mass\\_proportional, none" +msgstr "" + +msgid "\"mass\\_proportional\"" +msgstr "" + +msgid "Damping model of the nodes (see ldem.solver.dampingRegistry)." +msgstr "Modello di smorzamento dei nodi (vedi ldem.solver.dampingRegistry)." + +msgid "``initial``" +msgstr "" + +msgid "number + unit (1/s, 1/ms)" +msgstr "numero + unità (1/s, 1/ms)" + +msgid "25000 1/s" +msgstr "" + +msgid "DF1" +msgstr "" + +msgid "Mass-proportional damping before switch\\_time." +msgstr "Smorzamento proporzionale alla massa prima di switch\\_time." + +msgid "``final``" +msgstr "" + +msgid "DF2" +msgstr "" + +msgid "Mass-proportional damping after switch\\_time." +msgstr "Smorzamento proporzionale alla massa dopo switch\\_time." + +msgid "``switch_time``" +msgstr "" + +msgid "15 ms" +msgstr "" + +msgid "TDAF" +msgstr "" + +msgid "Time at which the damping changes from initial to final." +msgstr "Tempo in cui lo smorzamento passa da initial a final." + +msgid "``constitutive``" +msgstr "" + +msgid "0 s" +msgstr "" + +msgid "CON" +msgstr "" + +msgid "Stiffness-proportional damping inside the bar law." +msgstr "Smorzamento proporzionale alla rigidezza all'interno della legge delle barre." + +msgid "TEST" +msgstr "" + +msgid "Test case (see ldem.scenarios.registry); its other keys follow." +msgstr "Prova (vedi ldem.scenarios.registry); le sue altre chiavi seguono." + +msgid "``[[support]]``" +msgstr "" + +msgid "``name``" +msgstr "" + +msgid "Label of the support." +msgstr "Etichetta dell'appoggio." + +msgid "``nodes``" +msgstr "" + +msgid "all, centre, grid" +msgstr "" + +msgid "\"all\"" +msgstr "" + +msgid "Kind of nodes: all, grid (module corners) or centre (module centres)." +msgstr "Tipo di nodi: all, grid (angoli dei moduli) o centre (centri dei moduli)." + +msgid "``ids``" +msgstr "" + +msgid "Node numbers to select." +msgstr "Numeri di nodo da scegliere." + +msgid "``x``" +msgstr "" + +msgid "modules: number, text or [lo, hi]" +msgstr "moduli: numero, testo o [lo, hi]" + +msgid "Positions along x in modules: 0.5, \"max - 0.5\" or a range [lo, hi]." +msgstr "Posizioni lungo x, in moduli: 0.5, \"max - 0.5\" o un intervallo [lo, hi]." + +msgid "``y``" +msgstr "" + +msgid "Positions along y in modules (see x)." +msgstr "Posizioni lungo y, in moduli (vedi x)." + +msgid "``z``" +msgstr "" + +msgid "Positions along z in modules (see x)." +msgstr "Posizioni lungo z, in moduli (vedi x)." + +msgid "``fix``" +msgstr "" + +msgid "Directions held at their initial position: [\"x\", \"y\", \"z\"]." +msgstr "Direzioni mantenute nella posizione iniziale: [\"x\", \"y\", \"z\"]." + +msgid "``reaction``" +msgstr "" + +msgid "true or false" +msgstr "true o false" + +msgid "false" +msgstr "" + +msgid "Include the force on the held directions in the reaction of the test." +msgstr "Include la forza nelle direzioni bloccate nella reazione della prova." + +msgid "``[[load]]``" +msgstr "" + +msgid "Label of the load." +msgstr "Etichetta del carico." + +msgid "``direction``" +msgstr "" + +msgid "x, y, z" +msgstr "" + +msgid "Direction of the load." +msgstr "Direzione del carico." + +msgid "force, displacement" +msgstr "" + +msgid "force (N on each selected node) or displacement (m from the initial position)." +msgstr "force (N su ogni nodo scelto) o displacement (m dalla posizione iniziale)." + +msgid "``time_function``" +msgstr "" + +msgid "constant, linear, ramp, table" +msgstr "" + +msgid "How the value changes with time." +msgstr "Come cambia il valore nel tempo." + +msgid "``value``" +msgstr "" + +msgid "N, N/s, m or m/s, by type" +msgstr "N, N/s, m o m/s, secondo il tipo" + +msgid "constant: the value (N or m)." +msgstr "constant: il valore (N o m)." + +msgid "``rate``" +msgstr "" + +msgid "linear and ramp: change per second (N/s or m/s)." +msgstr "linear e ramp: variazione al secondo (N/s o m/s)." + +msgid "``until``" +msgstr "" + +msgid "ramp: time at which it stops growing." +msgstr "ramp: tempo in cui smette di crescere." + +msgid "``times``" +msgstr "" + +msgid "table: increasing times in seconds." +msgstr "table: tempi crescenti in secondi." + +msgid "``values``" +msgstr "" + +msgid "table: one value per time (N or m)." +msgstr "table: un valore per ogni tempo (N o m)." + +msgid "Include the force on the loaded direction in the reaction of the test." +msgstr "Include la forza nella direzione caricata nella reazione della prova." + +msgid "``[[sweep]]``" +msgstr "" + +msgid "``key``" +msgstr "" + +msgid "Key to vary, for example \"material.fracture\\_energy\" (see ldem.sweep)." +msgstr "Chiave da variare, per esempio \"material.fracture\\_energy\" (vedi ldem.sweep)." + +msgid "Values to try: numbers, or texts with units such as [\"0.1 N/m\", \"0.5 N/m\"]." +msgstr "Valori da provare: numeri, o testi con unità come [\"0.1 N/m\", \"0.5 N/m\"]." + +msgid "``id``" +msgstr "" + +msgid "NCON" +msgstr "" + +msgid "Number of a node whose motion is recorded." +msgstr "Numero di un nodo il cui movimento viene registrato." + +msgid "``at``" +msgstr "" + +msgid "Position [x, y, z] in modules; the nearest node is recorded." +msgstr "Posizione [x, y, z] in moduli; viene registrato il nodo più vicino." + +msgid "Label of the node." +msgstr "Etichetta del nodo." + +msgid "``tracked``" +msgstr "" + +msgid "off" +msgstr "disattivato" + +msgid "OU9" +msgstr "" + +msgid "Number of the bar whose strain history is stored at every step." +msgstr "Numero della barra la cui storia di deformazione è salvata a ogni passo." + +msgid "``folder``" +msgstr "" + +msgid "no files" +msgstr "nessun file" + +msgid "Output folder, relative to the case file." +msgstr "Cartella di uscita, relativa al file di caso." + +msgid "``mat``" +msgstr "" + +msgid "true" +msgstr "" + +msgid "Write results.mat." +msgstr "Scrive results.mat." + +msgid "``ansys``" +msgstr "" + +msgid "Write ANSYS macro files (needs snapshots.every > 0)." +msgstr "Scrive file macro di ANSYS (richiede snapshots.every > 0)." + +msgid "``vtk``" +msgstr "" + +msgid "Write VTK files for ParaView (needs snapshots.every > 0)." +msgstr "Scrive file VTK per ParaView (richiede snapshots.every > 0)." + +msgid "``[output.snapshots]``" +msgstr "" + +msgid "``every``" +msgstr "" + +msgid "steps or time (0 = never)" +msgstr "passi o tempo (0 = mai)" + +msgid "OU3" +msgstr "" + +msgid "Steps or time between full-field snapshots; 0 = never." +msgstr "Passi o tempo tra istantanee del campo completo; 0 = mai." + +msgid "``[output.control_nodes]``" +msgstr "" + +msgid "OU6" +msgstr "" + +msgid "Steps or time between records of the control nodes and reactions; 0 = never." +msgstr "Passi o tempo tra registrazioni dei nodi di controllo e delle reazioni; 0 = mai." + +msgid "``[output.energy]``" +msgstr "" + +msgid "OU8" +msgstr "" + +msgid "Steps or time between records of the energies; 0 = never." +msgstr "Passi o tempo tra registrazioni delle energie; 0 = mai." + +msgid "Tests available" +msgstr "Prove disponibili" + +msgid "``testId = 101``" +msgstr "" + +msgid "" +"Uniaxial load: the centre nodes of the last column of modules move along :math:`x` " +"with a prescribed velocity." +msgstr "" +"Carico uniassiale: i nodi centrali dell'ultima colonna di moduli si muovono in " +":math:`x` con velocità imposta." + +msgid "``testId = 102``" +msgstr "" + +msgid "" +"Beam with two supports and two load points. The positions are parameters of " +"``ldem.scenarios.FourPointBending`` (``supportPosition``, ``loadPosition``, in " +"modules from each end); the defaults need a beam longer than about 70 modules. See " +"``examples/beam_102``." +msgstr "" +"Trave con due appoggi e due punti di carico. Le posizioni sono parametri di " +"``ldem.scenarios.FourPointBending`` (``supportPosition``, ``loadPosition``, in moduli" +" da ciascuna estremità); i valori predefiniti richiedono una trave di oltre 70 moduli" +" circa. Vedi ``examples/beam_102``." + +msgid "``testId = 103``" +msgstr "" + +msgid "" +"Beam clamped at both ends, loaded at mid-span with a force that grows linearly and " +"then stays constant (``ldem.scenarios.ClampedBeam``). It is the only test loaded with" +" a force instead of a displacement. See ``examples/example1_clamped_beam``." +msgstr "" +"Trave incastrata alle due estremità, caricata in mezzeria con una forza che cresce " +"linearmente e poi resta costante (``ldem.scenarios.ClampedBeam``). È l'unica prova " +"caricata con una forza invece che con uno spostamento. Vedi " +"``examples/example1_clamped_beam``." + +msgid "" +"To add a new test, create a subclass of ``ldem.scenarios.Scenario`` (see " +":doc:`model`)." +msgstr "" +"Per aggiungere una prova nuova si crea una sottoclasse di ``ldem.scenarios.Scenario``" +" (vedi :doc:`model`)." + +msgid "Mesh perturbation" +msgstr "Perturbazione della mesh" + +msgid "" +"The parameter ``meshPerturbation`` randomly displaces the interior nodes. Its value " +"is the standard deviation as a fraction of the module length: ``0`` (the default) " +"keeps the lattice regular and any positive value activates the perturbation with that" +" value. The random numbers follow ``seed``." +msgstr "" +"Il parametro ``meshPerturbation`` sposta in modo casuale i nodi interni. Il suo " +"valore è la deviazione standard come frazione della lunghezza del modulo: ``0`` (il " +"predefinito) mantiene il reticolo regolare e qualsiasi valore positivo attiva la " +"perturbazione con quel valore. I numeri casuali seguono ``seed``." + +msgid ">> params = ldem.Parameters(testId=101, nModules=[6 3 3], meshPerturbation=0.02);" +msgstr "" + +msgid "What you get: the ``results`` struct" +msgstr "Cosa si ottiene: la struttura ``results``" + +msgid "Field" +msgstr "Campo" + +msgid "Content" +msgstr "Contenuto" + +msgid "``info``" +msgstr "" + +msgid "ldem version, date, MATLAB release, run time [s]." +msgstr "Versione di ldem, data, versione di MATLAB, tempo di esecuzione [s]." + +msgid "``params``" +msgstr "" + +msgid "The parameters used, as a plain struct (derived values included)." +msgstr "I parametri usati, come struttura semplice (con i valori derivati)." + +msgid "``model``" +msgstr "" + +msgid "" +"Counts and mass of the model: modules, nodes, bars by type, fixed degrees of freedom," +" total mass and volume." +msgstr "" +"Conteggi e massa del modello: moduli, nodi, barre per tipo, gradi di libertà " +"bloccati, massa totale e volume." + +msgid "``material``" +msgstr "" + +msgid "" +"Material data (E, Gf, ...), lattice coefficients, critical length and the statistics " +"of the critical strain (mean, coefficient of variation, minimum and maximum)." +msgstr "" +"Dati del materiale (E, Gf, ...), coefficienti del reticolo, lunghezza critica e " +"statistiche della deformazione critica (media, coefficiente di variazione, minimo e " +"massimo)." + +msgid "``mesh``" +msgstr "" + +msgid "Initial node positions, supports (``fixed``), masses, bars, bar lengths and bar types." +msgstr "" +"Posizioni iniziali dei nodi, vincoli (``fixed``), masse, barre, lunghezze e tipi di " +"barra." + +msgid "``barProps``" +msgstr "" + +msgid "Stiffness, critical strain and rupture strain of every bar." +msgstr "Rigidezza, deformazione critica e deformazione di rottura di ogni barra." + +msgid "``controlNodes``" +msgstr "" + +msgid "Time and displacement, velocity and acceleration of the control nodes." +msgstr "Tempo e spostamento, velocità e accelerazione dei nodi di controllo." + +msgid "``reactions``" +msgstr "" + +msgid "" +"Time and reaction force ``[Rx Ry Rz]`` of the test: vertical force at the load points" +" (test 102), force on the clamped ends (test 103); ``NaN`` where the test defines " +"none." +msgstr "" +"Tempo e forza di reazione ``[Rx Ry Rz]`` della prova: forza verticale nei punti di " +"carico (prova 102), forza alle estremità incastrate (prova 103); ``NaN`` dove la " +"prova non la definisce." + +msgid "``energy``" +msgstr "" + +msgid "" +"Time, kinetic, elastic, damage and damping energies [J], their sum (``internal``), " +"the energy of the broken bars (``brokenBars``), the external work, the ``balance`` " +"(external minus internal) and the damage rate." +msgstr "" +"Tempo, energie cinetica, elastica, di danno e di smorzamento [J], la loro somma " +"(``internal``), l'energia delle barre rotte (``brokenBars``), il lavoro esterno, il " +"bilancio (``balance``, esterno meno interno) e la velocità di danno." + +msgid "``trackedBar``" +msgstr "" + +msgid "Strain, force and damage energy of one bar at every step (optional)." +msgstr "Deformazione, forza ed energia di danno di una barra a ogni passo (opzionale)." + +msgid "``snapshots``" +msgstr "" + +msgid "" +"Step, time, number of intact/damaged/broken bars, and compact copies of the " +"displacements, the damage state and the nodal kinetic energy at the snapshot steps." +msgstr "" +"Passo, tempo, numero di barre intatte/danneggiate/rotte e copie compatte degli " +"spostamenti, dello stato di danno e dell'energia cinetica nodale nei passi salvati." + +msgid "" +"Final displacement, velocity, force and damage state, and the kinetic energy of every" +" node." +msgstr "" +"Spostamento, velocità, forza e stato di danno finali, e l'energia cinetica di ogni " +"nodo." + +msgid "" +"The energy ``balance`` is a check of the simulation: it should be a small fraction " +"(below 1 %) of the final external work. The total kinetic energy is " +"``energy.kinetic``; the kinetic energy of each node is in ``final.kineticEnergy``." +msgstr "" +"Il ``balance`` energetico è un controllo della simulazione: deve essere una piccola " +"frazione (meno dell'1 %) del lavoro esterno finale. L'energia cinetica totale è " +"``energy.kinetic``; quella di ogni nodo è in ``final.kineticEnergy``." + +msgid "``results.mat`` contains this struct and loads without the package:" +msgstr "``results.mat`` contiene questa struttura e si carica senza il pacchetto:" + +msgid "" +">> data = load(\"output/results.mat\");\n" +">> results = data.results;" +msgstr "" + +msgid "Output files" +msgstr "File di uscita" + +msgid "``results.mat``" +msgstr "" + +msgid "The ``results`` struct (format v7.3, readable from Python with ``h5py``)." +msgstr "La struttura ``results`` (formato v7.3, leggibile da Python con ``h5py``)." + +msgid "``snapshot_0000.mac``, ``snapshot_0001.mac``, ..." +msgstr "" + +msgid "" +"ANSYS macro files with the deformed lattice. Bars are element types 1 (intact), 2 " +"(damaged) and 5 (broken). The held degrees of freedom are listed as " +"``D,node,direction`` and the displacement imposed on the loaded nodes, measured from " +"their initial position, as ``D,node,direction,value``. In test 103 the applied forces" +" are listed as ``F,node,direction,value``." +msgstr "" +"Macro ANSYS con il reticolo deformato. Le barre sono elementi di tipo 1 (intatte), 2 " +"(danneggiate) e 5 (rotte). I gradi di libertà bloccati sono elencati come " +"``D,nodo,direzione`` e lo spostamento imposto ai nodi caricati, misurato dalla " +"posizione iniziale, come ``D,nodo,direzione,valore``. Nella prova 103 le forze " +"applicate sono elencate come ``F,nodo,direzione,valore``." + +msgid "``snapshot_0000.vtu``, ... and ``snapshots.pvd``" +msgstr "``snapshot_0000.vtu``, ... e ``snapshots.pvd``" + +msgid "" +"VTK files. Open ``snapshots.pvd`` in `ParaView `_; colour " +"by ``damageState`` (cell data) to see the cracks and use the time slider to follow " +"them. Displacement and velocity are point data." +msgstr "" +"File VTK. Aprire ``snapshots.pvd`` in `ParaView `_; " +"colorare per ``damageState`` (dati di cella) per vedere le fessure e usare il cursore" +" del tempo per seguirle. Spostamento e velocità sono dati di punto." + +msgid "" +"ANSYS and VTK files are written at time zero and every " +"``params.output.snapshotEvery`` steps." +msgstr "" +"I file ANSYS e VTK vengono scritti al tempo zero e ogni " +"``params.output.snapshotEvery`` passi." + +msgid "Run the tests" +msgstr "Eseguire i test" + +#, python-format +msgid "" +">> addpath tests\n" +">> run_tests % fast tests\n" +">> run_tests(IncludeSlow=true) % also the slow tests" +msgstr "" +">> addpath tests\n" +">> run_tests % test rapidi\n" +">> run_tests(IncludeSlow=true) % anche i test lenti" + diff --git a/docs/locale/pt/LC_MESSAGES/api/index.po b/docs/locale/pt/LC_MESSAGES/api/index.po new file mode 100644 index 0000000..9b5c255 --- /dev/null +++ b/docs/locale/pt/LC_MESSAGES/api/index.po @@ -0,0 +1,54 @@ +# Translation of the LDEM-MATLAB documentation (pt). +# Generated by docs/tools/update_translations.py: edit only the msgstr entries. +msgid "" +msgstr "" +"Project-Id-Version: LDEM-MATLAB\n" +"Report-Msgid-Bugs-To: \n" +"Last-Translator: \n" +"Language: pt\n" +"Language-Team: \n" +"Plural-Forms: nplurals=2; plural=(n != 1);\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.18.0\n" + +msgid "API reference" +msgstr "Referência da API" + +msgid "Generated automatically from the comments of the ``.m`` files." +msgstr "Gerada automaticamente a partir dos comentários dos ``.m``." + +msgid "" +"The ``ldem`` package (``src/+ldem``) is the refactored code. It replaces the original" +" routines, which are kept in the git history (tag ``legacy-reference``); the problems" +" found in them are listed in ``docs/known-issues/KNOWN_ISSUES.md``." +msgstr "" +"O pacote ``ldem`` (``src/+ldem``) é o código refatorado. Substitui as rotinas " +"originais, que são mantidas no histórico do git (tag ``legacy-reference``); os " +"problemas encontrados nelas estão listados em ``docs/known-issues/KNOWN_ISSUES.md``." + +msgid "Running a simulation" +msgstr "Executar uma simulação" + +msgid "Input and output" +msgstr "Entrada e saída" + +msgid "Mesh" +msgstr "Malha" + +msgid "Material" +msgstr "Material" + +msgid "Scenarios" +msgstr "Cenários de ensaio" + +msgid "Case-file schema" +msgstr "Esquema dos arquivos de caso" + +msgid "Solver" +msgstr "" + +msgid "Post-processing" +msgstr "Pós-processamento" + diff --git a/docs/locale/pt/LC_MESSAGES/authors.po b/docs/locale/pt/LC_MESSAGES/authors.po new file mode 100644 index 0000000..fb16b6e --- /dev/null +++ b/docs/locale/pt/LC_MESSAGES/authors.po @@ -0,0 +1,59 @@ +# Translation of the LDEM-MATLAB documentation (pt). +# Generated by docs/tools/update_translations.py: edit only the msgstr entries. +msgid "" +msgstr "" +"Project-Id-Version: LDEM-MATLAB\n" +"Report-Msgid-Bugs-To: \n" +"Last-Translator: \n" +"Language: pt\n" +"Language-Team: \n" +"Plural-Forms: nplurals=2; plural=(n != 1);\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.18.0\n" + +msgid "Authors" +msgstr "Autores" + +msgid "" +"This list is generated automatically from the commits of the git history (people with" +" the same name or e-mail are merged through ``.mailmap``) and from the authors of " +"``CITATION.cff``. Authors without commits in this repository appear with ``-``. The " +"same list is in ``AUTHORS.md``." +msgstr "" +"Esta lista é gerada automaticamente a partir dos commits do histórico do git (pessoas" +" com o mesmo nome ou e-mail são unificadas com ``.mailmap``) e dos autores de " +"``CITATION.cff``. Autores sem commits neste repositório aparecem com ``-``. A mesma " +"lista está em ``AUTHORS.md``." + +msgid "Name" +msgstr "Nome" + +msgid "Commits" +msgstr "" + +msgid "Boris Rojo Tanzi" +msgstr "" + +msgid "26" +msgstr "" + +msgid "Rodrigo Cavasotto Oscar Montanha" +msgstr "" + +msgid "7" +msgstr "" + +msgid "Ignacio Iturrioz" +msgstr "" + +msgid "To update it after new commits, build the documentation or run:" +msgstr "Para atualizá-la depois de novos commits, construa a documentação ou execute:" + +msgid "python docs/tools/generate_authors.py" +msgstr "" + +msgid "If a person appears twice, add a line to ``.mailmap``." +msgstr "Se uma pessoa aparecer duas vezes, adicione uma linha ao ``.mailmap``." + diff --git a/docs/locale/pt/LC_MESSAGES/contributing.po b/docs/locale/pt/LC_MESSAGES/contributing.po new file mode 100644 index 0000000..eb72049 --- /dev/null +++ b/docs/locale/pt/LC_MESSAGES/contributing.po @@ -0,0 +1,42 @@ +# Translation of the LDEM-MATLAB documentation (pt). +# Generated by docs/tools/update_translations.py: edit only the msgstr entries. +msgid "" +msgstr "" +"Project-Id-Version: LDEM-MATLAB\n" +"Report-Msgid-Bugs-To: \n" +"Last-Translator: \n" +"Language: pt\n" +"Language-Team: \n" +"Plural-Forms: nplurals=2; plural=(n != 1);\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.18.0\n" + +msgid "Contributing" +msgstr "Contribuir" + +msgid "" +"The API documentation is generated from the ``.m`` comments. The docstring must be " +"the comment block placed **immediately after** the ``function`` line (before any " +"``global`` declaration). Source comments are written in English." +msgstr "" +"A documentação da API é gerada a partir dos comentários dos ``.m``. O docstring deve " +"ser o bloco de comentários colocado **imediatamente depois** da linha ``function`` " +"(antes de qualquer ``global``). Os comentários do código são escritos em inglês." + +#, python-format +msgid "" +"function ini = CALOAD()\n" +"% CALOAD One-line summary.\n" +"% Longer description.\n" +"global ..." +msgstr "" +"function ini = CALOAD()\n" +"% CALOAD Resumo em uma linha.\n" +"% Descrição mais longa.\n" +"global ..." + +msgid "See ``CONTRIBUTING.md`` in the repository root." +msgstr "Veja ``CONTRIBUTING.md`` na raiz do repositório." + diff --git a/docs/locale/pt/LC_MESSAGES/docs.po b/docs/locale/pt/LC_MESSAGES/docs.po new file mode 100644 index 0000000..c09eba7 --- /dev/null +++ b/docs/locale/pt/LC_MESSAGES/docs.po @@ -0,0 +1,183 @@ +# Translation of the LDEM-MATLAB documentation (pt). +# Generated by docs/tools/update_translations.py: edit only the msgstr entries. +msgid "" +msgstr "" +"Project-Id-Version: LDEM-MATLAB\n" +"Report-Msgid-Bugs-To: \n" +"Last-Translator: \n" +"Language: pt\n" +"Language-Team: \n" +"Plural-Forms: nplurals=2; plural=(n != 1);\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.18.0\n" + +msgid "Building this documentation" +msgstr "Construir esta documentação" + +msgid "" +"The documentation is written in English, which is the only set of source pages, and " +"translated into Spanish, Portuguese and Italian with gettext catalogs (``.po`` files " +"in ``docs/locale/``). Each language is built as its own site and the sidebar has a " +"language selector. A text that is not translated yet is shown in English. The API " +"reference is generated from the comments of the ``.m`` files and is in English only." +msgstr "" +"A documentação está escrita em inglês, que é o único conjunto de páginas-fonte, e " +"traduzida para espanhol, português e italiano com catálogos gettext (arquivos ``.po``" +" em ``docs/locale/``). Cada idioma é construído como um site próprio e a barra " +"lateral tem um seletor de idioma. Um texto que ainda não foi traduzido é mostrado em " +"inglês. A referência da API é gerada a partir dos comentários dos arquivos ``.m`` e " +"está apenas em inglês." + +msgid "Requirements" +msgstr "Requisitos" + +msgid "Python 3.9 or newer." +msgstr "Python 3.9 ou superior." + +msgid "" +"``git`` (the list of authors is generated from the commit history; with a shallow " +"clone use ``git fetch --unshallow`` first)." +msgstr "" +"``git`` (a lista de autores é gerada a partir do histórico de commits; com um clone " +"superficial execute antes ``git fetch --unshallow``)." + +msgid "No MATLAB is needed; the API is read from the source text." +msgstr "Não é necessário MATLAB; a API é lida do texto das fontes." + +msgid "pip install -r docs/requirements.txt" +msgstr "" + +msgid "Build" +msgstr "Construção" + +msgid "From the repository root, with any of these:" +msgstr "A partir da raiz do repositório, com qualquer uma destas opções:" + +msgid "python docs/tools/build_docs.py" +msgstr "" + +msgid "cd docs && make html" +msgstr "" + +msgid ">> buildtool docs" +msgstr "" + +msgid "" +"This builds the four languages into ``docs/build/html/en``, ``es``, ``pt`` and " +"``it``; ``docs/build/html/index.html`` sends the reader to the English site. Open it " +"in a browser. To build only some languages use for example ``python " +"docs/tools/build_docs.py --languages en es``. Warnings are errors: the documentation " +"must build without any. ``buildtool clean`` deletes the result." +msgstr "" +"Isto constrói os quatro idiomas em ``docs/build/html/en``, ``es``, ``pt`` e ``it``; " +"``docs/build/html/index.html`` leva o leitor ao site em inglês. Abra-o em um " +"navegador. Para construir apenas alguns idiomas use, por exemplo, ``python " +"docs/tools/build_docs.py --languages en es``. Os avisos são erros: a documentação " +"deve ser construída sem nenhum. ``buildtool clean`` apaga o resultado." + +msgid "Where things are" +msgstr "Onde fica cada coisa" + +msgid "``docs/source/``" +msgstr "" + +msgid "The pages, in English." +msgstr "As páginas, em inglês." + +msgid "``docs/locale/es/``, ``pt/``, ``it/``" +msgstr "" + +msgid "" +"Translations: one ``.po`` file per page in ``LC_MESSAGES/``, with each English text " +"and its translation." +msgstr "" +"Traduções: um arquivo ``.po`` por página em ``LC_MESSAGES/``, com cada texto em " +"inglês e a sua tradução." + +msgid "``docs/source/api/``" +msgstr "" + +msgid "API reference, generated from the ``.m`` comments." +msgstr "Referência da API, gerada a partir dos comentários dos ``.m``." + +msgid "``docs/tools/build_docs.py``" +msgstr "" + +msgid "Builds every language and the page that sends the reader to the English site." +msgstr "Constrói cada idioma e a página que leva o leitor ao site em inglês." + +msgid "``docs/tools/update_translations.py``" +msgstr "" + +msgid "" +"Updates the ``.po`` files after the English text changes, and reports what is left to" +" translate." +msgstr "" +"Atualiza os arquivos ``.po`` quando o texto em inglês muda e informa o que falta " +"traduzir." + +msgid "``docs/tools/generate_authors.py``" +msgstr "" + +msgid "Writes the authors page and ``AUTHORS.md`` (run by the build)." +msgstr "Escreve a página de autores e ``AUTHORS.md`` (executado pela construção)." + +msgid "``docs/source/case-keys.inc``" +msgstr "" + +msgid "" +"Reference of the case-file keys, generated from the schema. After changing " +"``ldem.schema.caseSchema`` regenerate it from MATLAB with " +"``ldem.schema.writeKeyReference(\"docs/source/case-keys.inc\")``; a test fails if it " +"is out of date." +msgstr "" +"Referência das chaves do arquivo de caso, gerada a partir do esquema. Depois de mudar" +" ``ldem.schema.caseSchema`` regenera-se a partir do MATLAB com " +"``ldem.schema.writeKeyReference(\"docs/source/case-keys.inc\")``; um teste falha se " +"estiver desatualizada." + +msgid "Write or change a page" +msgstr "Escrever ou alterar uma página" + +msgid "" +"Edit the English page in ``docs/source/``. A new page also goes in the list of " +"``index.rst``." +msgstr "" +"Edite a página em inglês em ``docs/source/``. Uma página nova também entra na lista " +"de ``index.rst``." + +msgid "" +"Run ``python docs/tools/update_translations.py``. It extracts the texts and updates " +"the ``.po`` files: new texts appear untranslated and changed texts are marked as " +"fuzzy, both shown in English until they are translated." +msgstr "" +"Execute ``python docs/tools/update_translations.py``. Ele extrai os textos e atualiza" +" os arquivos ``.po``: os textos novos aparecem sem tradução e os textos alterados são" +" marcados como fuzzy; ambos são mostrados em inglês até serem traduzidos." + +msgid "" +"Translate the new entries in ``docs/locale//LC_MESSAGES/.po`` (with " +"any text editor or a tool such as Poedit) and remove the fuzzy marks you have " +"reviewed. ``python docs/tools/update_translations.py --status`` shows how much is " +"left in each language." +msgstr "" +"Traduza as entradas novas em ``docs/locale//LC_MESSAGES/.po`` (com " +"qualquer editor de texto ou uma ferramenta como o Poedit) e remova as marcas fuzzy " +"que revisou. ``python docs/tools/update_translations.py --status`` mostra quanto " +"falta em cada idioma." + +msgid "Build with ``python docs/tools/build_docs.py`` and fix any warning." +msgstr "Construa com ``python docs/tools/build_docs.py`` e corrija qualquer aviso." + +msgid "Publishing" +msgstr "Publicação" + +msgid "" +"The workflow ``.github/workflows/docs.yml`` builds the documentation on every pull " +"request and publishes the four languages to GitHub Pages when ``main`` changes." +msgstr "" +"O workflow ``.github/workflows/docs.yml`` constrói a documentação a cada pull request" +" e publica os quatro idiomas no GitHub Pages quando ``main`` muda." + diff --git a/docs/locale/pt/LC_MESSAGES/examples.po b/docs/locale/pt/LC_MESSAGES/examples.po new file mode 100644 index 0000000..56a34cb --- /dev/null +++ b/docs/locale/pt/LC_MESSAGES/examples.po @@ -0,0 +1,588 @@ +# Translation of the LDEM-MATLAB documentation (pt). +# Generated by docs/tools/update_translations.py: edit only the msgstr entries. +msgid "" +msgstr "" +"Project-Id-Version: LDEM-MATLAB\n" +"Report-Msgid-Bugs-To: \n" +"Last-Translator: \n" +"Language: pt\n" +"Language-Team: \n" +"Plural-Forms: nplurals=2; plural=(n != 1);\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.18.0\n" + +msgid "Examples" +msgstr "Exemplos" + +msgid "" +"The folder ``examples/`` has three models that run from start to finish, each with " +"its inputs and a script that runs it and plots the results. The numbers in this page " +"come from running them with the current code." +msgstr "" +"A pasta ``examples/`` tem três modelos que são executados do início ao fim, cada um " +"com seus dados de entrada e um script que o executa e plota os resultados. Os números" +" desta página saem de executá-los com o código atual." + +msgid "Folder" +msgstr "Pasta" + +msgid "What it shows" +msgstr "O que mostra" + +msgid "Size" +msgstr "Tamanho" + +msgid "Time" +msgstr "Tempo" + +msgid "``example1_clamped_beam/``" +msgstr "" + +msgid "A beam clamped at both ends and loaded with a force at mid-span" +msgstr "Uma viga engastada nas duas extremidades e carregada com uma força no meio do vão" + +msgid "3,086 nodes" +msgstr "3,086 nós" + +msgid "about 35 s" +msgstr "cerca de 35 s" + +msgid "``tension_101/``" +msgstr "" + +msgid "A small prism under a uniaxial load, with damage and every output format" +msgstr "Um prisma pequeno sob carga uniaxial, com dano e todos os formatos de saída" + +msgid "74 nodes" +msgstr "74 nós" + +msgid "about 6 s" +msgstr "cerca de 6 s" + +msgid "``beam_102/``" +msgstr "" + +msgid "The four-point bending beam of the paper (a demo of its first 50 steps)" +msgstr "" +"A viga em flexão de quatro pontos do artigo (uma demonstração dos seus primeiros 50 " +"passos)" + +msgid "166,961 nodes" +msgstr "166,961 nós" + +msgid "about 30 s for 50 steps" +msgstr "cerca de 30 s para 50 passos" + +msgid "" +"Start with ``tension_101`` to learn the interface and with ``example1_clamped_beam`` " +"to see a model loaded with a force, described by a case file and checked against the " +"original code." +msgstr "" +"Comece com ``tension_101`` para aprender a interface e com ``example1_clamped_beam`` " +"para ver um modelo carregado com uma força, descrito por um arquivo de caso e " +"verificado contra o código original." + +msgid "Running an example" +msgstr "Executar um exemplo" + +msgid "From MATLAB, from any folder:" +msgstr "No MATLAB, a partir de qualquer pasta:" + +#, python-format +msgid "" +">> run('examples/example1_clamped_beam/runClampedBeam.m') % script: run and" +" plot\n" +">> results = ldem.run('examples/example1_clamped_beam/case.ldem'); % from the case " +"file" +msgstr "" +">> run('examples/example1_clamped_beam/runClampedBeam.m') % script: executa" +" e plota\n" +">> results = ldem.run('examples/example1_clamped_beam/case.ldem'); % a partir do " +"arquivo de caso" + +msgid "" +"The two beam examples also have a ``case.ldem``: the same model in the readable case-" +"file format (see :doc:`usage`), generated from the ``DATA0.DAT`` of the original " +"program and giving the same parameters. ``ldem.check`` shows what a case file would " +"simulate without running it." +msgstr "" +"Os dois exemplos de viga também têm um ``case.ldem``: o mesmo modelo no formato " +"legível de arquivo de caso (ver :doc:`usage`), gerado a partir do ``DATA0.DAT`` do " +"programa original e que dá os mesmos parâmetros. ``ldem.check`` mostra o que um " +"arquivo de caso simularia sem executá-lo." + +msgid "" +"The scripts write their files to a folder ``output`` next to the script (ignored by " +"git), or to ``outputFolder`` if that variable already exists:" +msgstr "" +"Os scripts escrevem seus arquivos em uma pasta ``output`` junto ao script (ignorada " +"pelo git), ou em ``outputFolder`` se essa variável já existir:" + +msgid "" +"``results.mat``: one struct, ``results``, with everything that was recorded. Load it " +"with ``data = load('results.mat'); results = data.results;``." +msgstr "" +"``results.mat``: uma estrutura, ``results``, com tudo o que foi registrado. Carrega-" +"se com ``data = load('results.mat'); results = data.results;``." + +msgid "``snapshot_0000.mac``, ...: ANSYS macro files of the deformed lattice." +msgstr "``snapshot_0000.mac``, ...: arquivos macro do ANSYS da malha deformada." + +msgid "" +"``snapshot_0000.vtu``, ... and ``snapshots.pvd``: open ``snapshots.pvd`` in `ParaView" +" `_ to see the damage evolve in time." +msgstr "" +"``snapshot_0000.vtu``, ... e ``snapshots.pvd``: abra ``snapshots.pvd`` no `ParaView " +"`_ para ver o dano evoluir no tempo." + +msgid "Example 1: beam clamped at both ends" +msgstr "Exemplo 1: viga engastada nas duas extremidades" + +msgid "" +"A small beam of 5 x 5 x 50 modules of 1 mm, clamped at both ends and loaded at mid-" +"span with a force that grows during 0.35 ms and then stays constant. It is the model " +"of Rodrigo (branch ``dev_rodrigo``) and the first test loaded with a force instead of" +" a displacement (``ldem.scenarios.ClampedBeam``, test 103)." +msgstr "" +"Uma viga pequena de 5 x 5 x 50 módulos de 1 mm, engastada nas duas extremidades e " +"carregada no meio do vão com uma força que cresce durante 0.35 ms e depois permanece " +"constante. É o modelo de Rodrigo (ramo ``dev_rodrigo``) e o primeiro ensaio carregado" +" com uma força em vez de um deslocamento (``ldem.scenarios.ClampedBeam``, ensaio " +"103)." + +msgid "The model" +msgstr "O modelo" + +msgid "Part" +msgstr "Parte" + +msgid "Value" +msgstr "Valor" + +msgid "Geometry" +msgstr "Geometria" + +msgid "" +"5 x 5 x 50 modules of 1 mm (a prism of 5 x 5 x 50 mm, axis along z), with 3,086 " +"nodes, 18,085 bars and a mass of 1.875 g" +msgstr "" +"5 x 5 x 50 módulos de 1 mm (um prisma de 5 x 5 x 50 mm, eixo ao longo de z), com " +"3,086 nós, 18,085 barras e uma massa de 1.875 g" + +msgid "Supports" +msgstr "Apoios" + +msgid "" +"The centre nodes of the first and of the last layer of modules (z = 0.5 and z = 49.5 " +"modules) are clamped: x, y and z held" +msgstr "" +"Os nós centrais da primeira e da última camada de módulos (z = 0.5 e z = 49.5 " +"módulos) são engastados: x, y e z fixos" + +msgid "Load" +msgstr "Carga" + +msgid "" +"The 5 centre nodes of the line at mid-span (z = 24.5 modules, y = 0.5 modules) carry " +"a force in +y of ``1000 N/s * min(t, 0.35 ms)`` each: 0.35 N per node, 1.75 N in " +"total" +msgstr "" +"Os 5 nós centrais da linha no meio do vão (z = 24.5 módulos, y = 0.5 módulos) levam " +"cada um uma força em +y de ``1000 N/s * min(t, 0.35 ms)``: 0.35 N por nó, 1.75 N no " +"total" + +msgid "Material" +msgstr "Material" + +msgid "" +"E = 3.87 GPa, Poisson's ratio 0.25, density 1500 kg/m\\ :sup:`3`, fracture energy 0.5" +" N/m, critical distance 4.5 mm; mass-proportional damping of 2500 1/s" +msgstr "" +"E = 3.87 GPa, coeficiente de Poisson 0.25, densidade 1500 kg/m\\ :sup:`3`, energia de" +" fratura 0.5 N/m, distância crítica 4.5 mm; amortecimento proporcional à massa de " +"2500 1/s" + +msgid "Scatter" +msgstr "Dispersão" + +msgid "" +"One multiplier of the critical strain per bar, read from a file (shared with " +"``beam_102``)" +msgstr "" +"Um multiplicador da deformação crítica por barra, lido de um arquivo (compartilhado " +"com ``beam_102``)" + +#, python-format +msgid "2.8 ms in 8000 steps of 0.35 us (65 % of the critical step)" +msgstr "2.8 ms em 8000 passos de 0.35 us (65 % do passo crítico)" + +msgid "Recorded" +msgstr "Registrado" + +msgid "" +"Control nodes 2441 (a loaded node) and 884 (a grid node at mid-span); tracked bar " +"14398" +msgstr "" +"Nós de controle 2441 (um nó carregado) e 884 (um nó de canto no meio do vão); barra " +"acompanhada 14398" + +msgid "" +"The original input file listed five control nodes, but nodes 6870 and 14398 do not " +"exist in this 3,086-node mesh, so the input keeps 2441 and 884. The tracked bar is " +"14398, as in the original." +msgstr "" +"O arquivo de entrada original listava cinco nós de controle, mas os nós 6870 e 14398 " +"não existem nesta malha de 3,086 nós, então a entrada mantém 2441 e 884. A barra " +"acompanhada é a 14398, como no original." + +msgid "Files" +msgstr "Arquivos" + +msgid "File" +msgstr "Arquivo" + +msgid "Purpose" +msgstr "Propósito" + +msgid "``case.ldem``" +msgstr "" + +msgid "The model as a case file: run it with ``ldem.run``" +msgstr "O modelo como arquivo de caso: é executado com ``ldem.run``" + +msgid "``runClampedBeam.m``" +msgstr "" + +msgid "" +"Reads ``DATA0.DAT``, runs the simulation and plots the force on the clamped ends, the" +" vertical displacement of the control nodes and the energies" +msgstr "" +"Lê o ``DATA0.DAT``, executa a simulação e plota a força nas extremidades engastadas, " +"o deslocamento vertical dos nós de controle e as energias" + +msgid "``DATA0.DAT``" +msgstr "" + +msgid "The parameters in the format of the original program (``TEST 103``)" +msgstr "Os parâmetros no formato do programa original (``TEST 103``)" + +msgid "" +"The scenario and the load are the lines of the ``[scenario]`` section of " +"``case.ldem``:" +msgstr "O cenário e a carga são as linhas da seção ``[scenario]`` de ``case.ldem``:" + +msgid "" +"[scenario]\n" +"type = \"clamped_beam\"\n" +"force_rate = 1000 N/s\n" +"ramp_time = 0.35 ms\n" +"load_position = \"midspan\"\n" +"load_height = 0.5 modules" +msgstr "" + +msgid "" +"The same test can be written without a scenario class, with supports and loads. It " +"gives the same results as ``ldem.scenarios.ClampedBeam`` (the tests check it):" +msgstr "" +"O mesmo ensaio pode ser escrito sem uma classe de cenário, com apoios e cargas. Dá os" +" mesmos resultados que ``ldem.scenarios.ClampedBeam`` (os testes o verificam):" + +msgid "" +"[scenario]\n" +"type = \"custom\"\n" +"\n" +"[[support]]\n" +"name = \"first end\"\n" +"z = 0.5\n" +"fix = [\"x\", \"y\", \"z\"]\n" +"reaction = true\n" +"\n" +"[[support]]\n" +"name = \"last end\"\n" +"z = \"max - 0.5\"\n" +"fix = [\"x\", \"y\", \"z\"]\n" +"reaction = true\n" +"\n" +"[[load]]\n" +"name = \"line at mid-span\"\n" +"y = 0.5\n" +"z = \"mid - 0.5\"\n" +"direction = \"y\"\n" +"type = \"force\"\n" +"time_function = \"ramp\"\n" +"rate = 1000 N/s\n" +"until = 0.35 ms" +msgstr "" + +msgid "Reading the results" +msgstr "Ler os resultados" + +#, python-format +msgid "" +">> results = ldem.run('examples/example1_clamped_beam/case.ldem', " +"OutputFolder=tempname);\n" +">> y0 = results.mesh.nodes0(results.params.controlNodes, 2).';\n" +">> dy = results.controlNodes.displacement(:, :, 2) - y0; % vertical displacement " +"[m]\n" +">> results.reactions.force(end, :) % force on the clamped " +"ends [N]\n" +">> ldem.post.plotReaction(results);\n" +">> ldem.post.plotEnergy(results);" +msgstr "" +">> results = ldem.run('examples/example1_clamped_beam/case.ldem', " +"OutputFolder=tempname);\n" +">> y0 = results.mesh.nodes0(results.params.controlNodes, 2).';\n" +">> dy = results.controlNodes.displacement(:, :, 2) - y0; % deslocamento vertical " +"[m]\n" +">> results.reactions.force(end, :) % força nas extremidades" +" engastadas [N]\n" +">> ldem.post.plotReaction(results);\n" +">> ldem.post.plotEnergy(results);" + +msgid "What you should see" +msgstr "O que se deve ver" + +msgid "" +"Force carried by the clamped ends. It rises with the load, overshoots to 1.94 N and " +"settles at the total applied force." +msgstr "" +"Força suportada pelas extremidades engastadas. Cresce com a carga, ultrapassa até " +"1.94 N e se estabiliza na força total aplicada." + +msgid "" +"Vertical displacement of the two control nodes: a peak of 6.7 um at 0.46 ms and about" +" 6.3 um at the end." +msgstr "" +"Deslocamento vertical dos dois nós de controle: um pico de 6.7 um aos 0.46 ms e cerca" +" de 6.3 um no final." + +msgid "Energies. The external work equals the sum of the internal energies." +msgstr "Energias. O trabalho externo é igual à soma das energias internas." + +msgid "" +"The reaction settles at 1.75 N, the 1.75 N applied in total: the beam is in " +"equilibrium at the end. The overshoot (1.94 N) and the oscillation are the dynamic " +"response, which the damping removes." +msgstr "" +"A reação se estabiliza em 1.75 N, os 1.75 N aplicados no total: a viga está em " +"equilíbrio no final. A ultrapassagem (1.94 N) e a oscilação são a resposta dinâmica, " +"que o amortecimento elimina." + +msgid "" +"With these values the beam stays elastic: at the end 18,085 bars are intact and none " +"is damaged or broken." +msgstr "" +"Com estes valores a viga permanece elástica: no final 18,085 barras estão intactas e " +"nenhuma está danificada nem rompida." + +msgid "" +"The energy balance closes: the external work of 5.76 uJ is the elastic energy (5.48 " +"uJ) plus the energy dissipated by damping (0.28 uJ); the kinetic energy is about zero" +" and the balance is below 1e-13 J." +msgstr "" +"O balanço de energia fecha: o trabalho externo de 5.76 uJ é a energia elástica (5.48 " +"uJ) mais a energia dissipada pelo amortecimento (0.28 uJ); a energia cinética é quase" +" zero e o balanço é menor que 1e-13 J." + +msgid "Try other values" +msgstr "Experimentar outros valores" + +msgid "" +"Every key of the case file can be changed, or swept without editing the file (see " +":doc:`usage`):" +msgstr "" +"Cada chave do arquivo de caso pode ser mudada, ou varrida sem editar o arquivo (ver " +":doc:`usage`):" + +#, python-brace-format +msgid "" +">> summary = ldem.sweep('examples/example1_clamped_beam/case.ldem', ...\n" +" Vary = {'scenario.force_rate', [\"10 kN/s\" \"30 kN/s\" \"100 kN/s\"]}, " +"Formats = \"mat\");" +msgstr "" + +msgid "" +"With the original value (1 kN/s) no bar is damaged. Ten times more force already " +"breaks the beam; each run takes about 50 s:" +msgstr "" +"Com o valor original (1 kN/s) nenhuma barra é danificada. Com dez vezes mais força a " +"viga já se rompe; cada execução leva cerca de 50 s:" + +msgid "Force rate" +msgstr "Taxa de força" + +msgid "Damaged bars (including broken)" +msgstr "Barras danificadas (incluídas as rompidas)" + +msgid "Broken bars" +msgstr "Barras rompidas" + +msgid "10 kN/s" +msgstr "" + +msgid "5,630" +msgstr "" + +msgid "3,584" +msgstr "" + +msgid "30 kN/s" +msgstr "" + +msgid "6,074" +msgstr "" + +msgid "3,579" +msgstr "" + +msgid "100 kN/s" +msgstr "" + +msgid "4,760" +msgstr "" + +msgid "2,783" +msgstr "" + +msgid "" +"After the failure the loaded nodes keep being pushed by the force and move freely, so" +" the displacements of these runs are not meaningful; the damage counts are. Each run " +"has its own folder (``run_001``, ...) with its results and its resolved " +"``case.ldem``, and the table is also saved as ``sweep_summary.csv``." +msgstr "" +"Depois da falha, os nós carregados continuam sendo empurrados pela força e se movem " +"livremente, então os deslocamentos dessas execuções não têm significado; as contagens" +" de dano têm. Cada execução tem sua própria pasta (``run_001``, ...) com seus " +"resultados e seu ``case.ldem`` resolvido, e a tabela também é salva como " +"``sweep_summary.csv``." + +msgid "" +"Other changes to try in ``case.ldem``: ``law = \"linear_elastic\"`` (no damage at " +"all), ``type = \"generated\"`` with a ``cv`` in ``[material.scatter]`` to generate " +"the random field in memory instead of reading it, or ``type = \"none\"`` to remove " +"the scatter." +msgstr "" +"Outras mudanças para experimentar em ``case.ldem``: ``law = \"linear_elastic\"`` " +"(nenhum dano), ``type = \"generated\"`` com um ``cv`` em ``[material.scatter]`` para " +"gerar o campo aleatório na memória em vez de lê-lo, ou ``type = \"none\"`` para " +"remover a dispersão." + +msgid "Example: uniaxial prism" +msgstr "Exemplo: prisma uniaxial" + +msgid "" +"``examples/tension_101/runTension.m`` runs a prism of 5 x 2 x 2 modules of 3 mm (74 " +"nodes, 313 bars) under the uniaxial test (test 101): the centre nodes of the last " +"column move along x with a prescribed velocity of 4 mm/s while those of the first " +"column are held. It is the best place to start: it has no input file, the model is " +"described in the script with ``ldem.Parameters``, and it writes every kind of output." +msgstr "" +"``examples/tension_101/runTension.m`` executa um prisma de 5 x 2 x 2 módulos de 3 mm " +"(74 nós, 313 barras) sob o ensaio uniaxial (ensaio 101): os nós centrais da última " +"coluna se movem em x com uma velocidade imposta de 4 mm/s enquanto os da primeira " +"coluna ficam fixos. É o melhor lugar para começar: não tem arquivo de entrada, o " +"modelo é descrito no script com ``ldem.Parameters`` e escreve todos os tipos de " +"saída." + +msgid "" +"E = 32 GPa, Poisson's ratio 0.25, density 2000 kg/m\\ :sup:`3`; a low fracture energy" +" of 0.1 N/m on purpose, so that bars soften and break" +msgstr "" +"E = 32 GPa, coeficiente de Poisson 0.25, densidade 2000 kg/m\\ :sup:`3`; uma energia " +"de fratura baixa de 0.1 N/m de propósito, para que as barras amoleçam e rompam" + +msgid "0.2 ms in 1000 steps of 0.2 us" +msgstr "0.2 ms em 1000 passos de 0.2 us" + +msgid "Output" +msgstr "Saída" + +msgid "" +"Snapshots (ANSYS and VTK) every 250 steps, control nodes and energies every 10 steps," +" no tracked bar" +msgstr "" +"Instantâneos (ANSYS e VTK) a cada 250 passos, nós de controle e energias a cada 10 " +"passos, sem barra acompanhada" + +#, python-format +msgid "" +"At the end 251 bars are intact, 58 are damaged and 4 are broken. The external work is" +" 24.7 uJ: 22.5 uJ of elastic energy, 2.2 uJ dissipated by damage and 0.03 uJ by " +"damping; the balance is 0.01 % of the external work." +msgstr "" +"No final 251 barras estão intactas, 58 danificadas e 4 rompidas. O trabalho externo é" +" de 24.7 uJ: 22.5 uJ de energia elástica, 2.2 uJ dissipados pelo dano e 0.03 uJ pelo " +"amortecimento; o balanço é 0.01 % do trabalho externo." + +msgid "Energies of the uniaxial prism." +msgstr "Energias do prisma uniaxial." + +msgid "" +"With the sign convention of the original code a positive ``loadingVelocity`` moves " +"the loaded face toward the fixed one, that is, it compresses the prism; use a " +"negative value to pull it (see ``ldem.scenarios.UniaxialTension``)." +msgstr "" +"Com a convenção de sinais do código original, um ``loadingVelocity`` positivo move a " +"face carregada em direção à fixa, isto é, comprime o prisma; use um valor negativo " +"para tracioná-lo (ver ``ldem.scenarios.UniaxialTension``)." + +msgid "Example: four-point bending beam" +msgstr "Exemplo: viga em flexão de quatro pontos" + +msgid "" +"``examples/beam_102/runBeam.m`` reads the input of the beam of the paper (test 102, " +"``ldem.scenarios.FourPointBending``): 100 x 40 x 20 modules of 3 mm (300 x 120 x 60 " +"mm), 166,961 nodes and 1,126,960 bars. The beam rests on two supports 4.5 modules " +"from its ends and two load points 33.5 modules from its ends push its top face down " +"with a prescribed velocity of 4 mm/s. The material is E = 32 GPa, density 2000 kg/m\\" +" :sup:`3`, fracture energy 50 N/m, critical distance 28 mm, with a random field of " +"the critical strain read from a file." +msgstr "" +"``examples/beam_102/runBeam.m`` lê a entrada da viga do artigo (ensaio 102, " +"``ldem.scenarios.FourPointBending``): 100 x 40 x 20 módulos de 3 mm (300 x 120 x 60 " +"mm), 166,961 nós e 1,126,960 barras. A viga se apoia em dois apoios a 4.5 módulos das" +" suas extremidades e dois pontos de carga a 33.5 módulos das suas extremidades " +"empurram sua face superior para baixo com uma velocidade imposta de 4 mm/s. O " +"material tem E = 32 GPa, densidade 2000 kg/m\\ :sup:`3`, energia de fratura 50 N/m, " +"distância crítica 28 mm, com um campo aleatório da deformação crítica lido de um " +"arquivo." + +msgid "" +"The real simulation has 150,000 steps (0.03 s in steps of 0.2 us) and needs roughly " +"20 hours on a laptop (about 0.5 s per step). The script therefore runs only the first" +" 50 steps: it builds the complete model (about 20 s) and shows that the input is read" +" and the model runs; the plotted reaction is only that of the start of the test. " +"Change ``nStepsDemo`` at the top of the script, or remove the ``totalTime`` override," +" for the full run." +msgstr "" +"A simulação real tem 150,000 passos (0.03 s em passos de 0.2 us) e precisa de cerca " +"de 20 horas em um laptop (cerca de 0.5 s por passo). Por isso o script executa apenas" +" os primeiros 50 passos: constrói o modelo completo (cerca de 20 s) e mostra que a " +"entrada é lida e o modelo roda; a reação plotada é apenas a do início do ensaio. Mude" +" ``nStepsDemo`` no início do script, ou remova a substituição de ``totalTime``, para " +"a execução completa." + +msgid "The same parameters as a case file (``ldem.io.readCase``, ``ldem.run``)" +msgstr "Os mesmos parâmetros como arquivo de caso (``ldem.io.readCase``, ``ldem.run``)" + +msgid "Parameters in the format of the original program (``ldem.Parameters.fromFile``)" +msgstr "Parâmetros no formato do programa original (``ldem.Parameters.fromFile``)" + +msgid "``arquivo_3lc_rnao_cv05``" +msgstr "" + +msgid "" +"Random field applied to the critical strain of each bar (11 MB); it is also used by " +"``example1_clamped_beam``" +msgstr "" +"Campo aleatório aplicado à deformação crítica de cada barra (11 MB); também é usado " +"por ``example1_clamped_beam``" + +msgid "``runBeam.m``" +msgstr "" + +msgid "Reads the input, runs the first 50 steps and plots the reaction force" +msgstr "Lê a entrada, executa os primeiros 50 passos e plota a força de reação" + diff --git a/docs/locale/pt/LC_MESSAGES/index.po b/docs/locale/pt/LC_MESSAGES/index.po new file mode 100644 index 0000000..b53fad8 --- /dev/null +++ b/docs/locale/pt/LC_MESSAGES/index.po @@ -0,0 +1,34 @@ +# Translation of the LDEM-MATLAB documentation (pt). +# Generated by docs/tools/update_translations.py: edit only the msgstr entries. +msgid "" +msgstr "" +"Project-Id-Version: LDEM-MATLAB\n" +"Report-Msgid-Bugs-To: \n" +"Last-Translator: \n" +"Language: pt\n" +"Language-Team: \n" +"Plural-Forms: nplurals=2; plural=(n != 1);\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.18.0\n" + +msgid "User guide" +msgstr "Guia do usuário" + +msgid "API" +msgstr "" + +msgid "LDEM-MATLAB" +msgstr "" + +msgid "Lattice Discrete Element Method (LDEM) in MATLAB." +msgstr "Método dos Elementos Discretos tipo Lattice (LDEM) em MATLAB." + +msgid "" +"The documentation is written in English and translated into Spanish, Portuguese and " +"Italian. Choose the language in the sidebar of any page." +msgstr "" +"A documentação está escrita em inglês e traduzida para espanhol, português e " +"italiano. Escolha o idioma na barra lateral de qualquer página." + diff --git a/docs/locale/pt/LC_MESSAGES/installation.po b/docs/locale/pt/LC_MESSAGES/installation.po new file mode 100644 index 0000000..61f8aa8 --- /dev/null +++ b/docs/locale/pt/LC_MESSAGES/installation.po @@ -0,0 +1,72 @@ +# Translation of the LDEM-MATLAB documentation (pt). +# Generated by docs/tools/update_translations.py: edit only the msgstr entries. +msgid "" +msgstr "" +"Project-Id-Version: LDEM-MATLAB\n" +"Report-Msgid-Bugs-To: \n" +"Last-Translator: \n" +"Language: pt\n" +"Language-Team: \n" +"Plural-Forms: nplurals=2; plural=(n != 1);\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.18.0\n" + +msgid "Installation" +msgstr "Instalação" + +msgid "" +"Requirements: MATLAB R2022b or newer (developed and tested on R2023b). The package " +"itself uses the ``arguments`` block and name=value syntax; the test suite and " +"``buildtool`` need R2022b. No toolbox is required." +msgstr "" +"Requisitos: MATLAB R2022b ou superior (desenvolvido e testado na R2023b). O pacote " +"usa o bloco ``arguments`` e a sintaxe nome=valor; a suíte de testes e o ``buildtool``" +" exigem a R2022b. Nenhum toolbox é necessário." + +msgid "" +"git clone ldem-matlab\n" +"cd ldem-matlab" +msgstr "" +"git clone ldem-matlab\n" +"cd ldem-matlab" + +msgid ">> setup_path" +msgstr "" + +msgid "Check the installation with the fast tests:" +msgstr "Verifique a instalação com os testes rápidos:" + +msgid ">> buildtool test" +msgstr "" + +msgid "Developer tasks (``buildtool`` is run from the repository root):" +msgstr "" +"Tarefas para desenvolvedores (``buildtool`` é executado a partir da raiz do " +"repositório):" + +#, python-format +msgid "" +">> buildtool % static analysis + fast tests (the default)\n" +">> buildtool check % Code Analyzer only\n" +">> buildtool testAll % all tests, including the slow ones\n" +">> buildtool docs % build this documentation (needs Python)\n" +">> buildtool clean % delete generated files" +msgstr "" +">> buildtool % análise estática + testes rápidos (padrão)\n" +">> buildtool check % somente o analisador de código\n" +">> buildtool testAll % todos os testes, inclusive os lentos\n" +">> buildtool docs % construir esta documentação (requer Python)\n" +">> buildtool clean % apagar os arquivos gerados" + +msgid "" +"``buildtool test`` writes ``test-results/results.xml`` (JUnit) and ``code-" +"coverage/coverage.xml`` (Cobertura)." +msgstr "" +"``buildtool test`` escreve ``test-results/results.xml`` (JUnit) e ``code-" +"coverage/coverage.xml`` (Cobertura)." + +msgid "To build this documentation without MATLAB see :doc:`docs`." +msgstr "Para construir esta documentação sem MATLAB, veja :doc:`docs`." + diff --git a/docs/locale/pt/LC_MESSAGES/introduction.po b/docs/locale/pt/LC_MESSAGES/introduction.po new file mode 100644 index 0000000..f1f2872 --- /dev/null +++ b/docs/locale/pt/LC_MESSAGES/introduction.po @@ -0,0 +1,74 @@ +# Translation of the LDEM-MATLAB documentation (pt). +# Generated by docs/tools/update_translations.py: edit only the msgstr entries. +msgid "" +msgstr "" +"Project-Id-Version: LDEM-MATLAB\n" +"Report-Msgid-Bugs-To: \n" +"Last-Translator: \n" +"Language: pt\n" +"Language-Team: \n" +"Plural-Forms: nplurals=2; plural=(n != 1);\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.18.0\n" + +msgid "Introduction" +msgstr "Introdução" + +msgid "" +"The **Lattice Discrete Element Method (LDEM)** models a continuum as a regular " +"lattice of nodes connected by bars arranged in cubic modules (edges plus diagonals). " +"Nodal masses are lumped, bar constitutive laws include damage/fracture, and the " +"equations of motion are integrated with an explicit central-difference scheme. " +"Energies (external, kinetic, elastic, dissipated) are tracked at every step." +msgstr "" +"O **Método dos Elementos Discretos tipo Treliça (LDEM)** modela um contínuo como um " +"reticulado regular de nós ligados por barras dispostas em módulos cúbicos (arestas " +"mais diagonais). As massas são concentradas nos nós, as leis constitutivas das barras" +" incluem dano/fratura e as equações de movimento são integradas com um esquema " +"explícito de diferenças centrais. As energias (externa, cinética, elástica, " +"dissipada) são acompanhadas a cada passo." + +msgid "Main parts of the ``ldem`` package (see :doc:`api/index`):" +msgstr "Principais partes do pacote ``ldem`` (ver :doc:`api/index`):" + +msgid "" +"``ldem.Parameters`` / ``ldem.io.readCase`` / ``ldem.io.readInputFile`` – validated " +"input data (case files and the legacy ``DATA0.DAT``)." +msgstr "" +"``ldem.Parameters`` / ``ldem.io.readCase`` / ``ldem.io.readInputFile`` – dados de " +"entrada validados (arquivos de caso e o ``DATA0.DAT`` original)." + +msgid "``ldem.run`` / ``ldem.sweep`` / ``ldem.check`` – run, sweep and check a case file." +msgstr "" +"``ldem.run`` / ``ldem.sweep`` / ``ldem.check`` – executar, varrer e verificar um " +"arquivo de caso." + +msgid "``ldem.mesh`` – nodes, bars, masses and bar geometry." +msgstr "``ldem.mesh`` – nós, barras, massas e geometria das barras." + +msgid "``ldem.material`` – bar stiffness, critical strain and the bilinear damage law." +msgstr "``ldem.material`` – rigidez das barras, deformação crítica e lei bilinear de dano." + +msgid "``ldem.scenarios`` – supports, loads and reactions of each test." +msgstr "``ldem.scenarios`` – apoios, cargas e reações de cada ensaio." + +msgid "``ldem.solver`` – time integration and energy balance." +msgstr "``ldem.solver`` – integração no tempo e balanço de energia." + +msgid "" +"``ldem.runSimulation`` – the whole simulation, with ``results.mat``, ANSYS and VTK " +"output." +msgstr "``ldem.runSimulation`` – a simulação completa, com saída ``results.mat``, ANSYS e VTK." + +msgid "" +"The routines of the original program (``ini_DEM3``, ``read_dat0``, ``RMEC``, " +"``BOUND``, ``CALOAD``, ``ENERG2``, ...) are kept in the git history under the tag " +"``legacy-reference``; the ``Legacy:`` line of each help text names the routine it " +"replaces." +msgstr "" +"As rotinas do programa original (``ini_DEM3``, ``read_dat0``, ``RMEC``, ``BOUND``, " +"``CALOAD``, ``ENERG2``, ...) são mantidas no histórico do git, com a tag ``legacy-" +"reference``; a linha ``Legacy:`` de cada ajuda indica a rotina que ela substitui." + diff --git a/docs/locale/pt/LC_MESSAGES/model.po b/docs/locale/pt/LC_MESSAGES/model.po new file mode 100644 index 0000000..a60e193 --- /dev/null +++ b/docs/locale/pt/LC_MESSAGES/model.po @@ -0,0 +1,237 @@ +# Translation of the LDEM-MATLAB documentation (pt). +# Generated by docs/tools/update_translations.py: edit only the msgstr entries. +msgid "" +msgstr "" +"Project-Id-Version: LDEM-MATLAB\n" +"Report-Msgid-Bugs-To: \n" +"Last-Translator: \n" +"Language: pt\n" +"Language-Team: \n" +"Plural-Forms: nplurals=2; plural=(n != 1);\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.18.0\n" + +msgid "Building a different model" +msgstr "Construir um modelo diferente" + +msgid "" +"A model is defined by three things: the **geometry** of the lattice, the **material**" +" and the **test** (supports and loads). The first two are parameters; the third is a " +"*scenario* class. You can change any of them without touching the solver." +msgstr "" +"Um modelo é definido por três coisas: a **geometria** do reticulado, o **material** e" +" o **ensaio** (apoios e cargas). As duas primeiras são parâmetros; a terceira é uma " +"classe *cenário*. Qualquer uma pode ser alterada sem tocar no solver." + +msgid "1. Change the geometry and the material" +msgstr "1. Alterar a geometria e o material" + +msgid "Everything is a property of ``ldem.Parameters``:" +msgstr "Tudo é uma propriedade de ``ldem.Parameters``:" + +#, python-format +msgid "" +">> params = ldem.Parameters(testId=101, ...\n" +" moduleLength=0.002, ... % edge of the cubic module [m]\n" +" nModules=[21 6 6], ... % nodes along x, y and z\n" +" youngModulus=30e9, density=2400, poissonRatio=0.2, ...\n" +" fractureEnergy=80, criticalDistance=0.02, ...\n" +" meshPerturbation=0.02); % optional irregular mesh" +msgstr "" +">> params = ldem.Parameters(testId=101, ...\n" +" moduleLength=0.002, ... % aresta do módulo cúbico [m]\n" +" nModules=[21 6 6], ... % nós em x, y e z\n" +" youngModulus=30e9, density=2400, poissonRatio=0.2, ...\n" +" fractureEnergy=80, criticalDistance=0.02, ...\n" +" meshPerturbation=0.02); % malha irregular (opcional)" + +msgid "" +"``nModules = [M N L]`` is the number of grid nodes along each axis, so the prism has " +"``(M-1)*(N-1)*(L-1)`` modules." +msgstr "" +"``nModules = [M N L]`` é o número de nós da grade em cada eixo, de modo que o prisma " +"tem ``(M-1)*(N-1)*(L-1)`` módulos." + +msgid "" +"``randomFieldFile`` multiplies the critical strain of each bar by a value read from a" +" text file (a random field of the material strength)." +msgstr "" +"``randomFieldFile`` multiplica a deformação crítica de cada barra por um valor lido " +"de um arquivo de texto (campo aleatório da resistência)." + +msgid "" +"``randomFieldCv`` generates that random field in memory instead, with no file: " +"Weibull values with mean 1 and that coefficient of variation on a grid of poles " +"spaced ``randomFieldCorrelationLength`` module lengths apart (default 3), " +"interpolated to each bar; ``randomFieldSeed`` fixes the random numbers. The value of " +"each bar is kept in ``results.barProps.randomField``." +msgstr "" +"``randomFieldCv`` gera esse campo aleatório na memória, sem arquivo: valores Weibull " +"com média 1 e esse coeficiente de variação numa grade de polos espaçados " +"``randomFieldCorrelationLength`` comprimentos de módulo (3 por padrão), interpolados " +"para cada barra; ``randomFieldSeed`` fixa os números aleatórios. O valor de cada " +"barra fica em ``results.barProps.randomField``." + +msgid "" +"``dt`` must be below ``params.criticalTimeStep``; ``Parameters`` rejects an unstable " +"value and says so." +msgstr "" +"``dt`` deve ser menor que ``params.criticalTimeStep``; ``Parameters`` rejeita um " +"valor instável e explica o motivo." + +msgid "" +"The same data can come from a case file (``ldem.io.readCase``, see :doc:`usage`) or " +"from an input file in the format of the original program with " +"``ldem.Parameters.fromFile(\"DATA0.DAT\", ...)``; extra name=value pairs override the" +" file. The mesh can be built and inspected before running anything:" +msgstr "" +"Os mesmos dados podem vir de um arquivo de caso (``ldem.io.readCase``, ver " +":doc:`usage`) ou de um arquivo de entrada no formato do programa original: " +"``ldem.Parameters.fromFile(\"DATA0.DAT\", ...)``; os pares nome=valor adicionais " +"substituem os do arquivo. A malha pode ser construída e inspecionada antes de " +"executar qualquer coisa:" + +#, python-format +msgid "" +">> mesh = ldem.mesh.buildMesh(params);\n" +">> fprintf(\"%d nodes, %d bars\\n\", size(mesh.nodes0, 1), size(mesh.bars, 1));" +msgstr "" +">> mesh = ldem.mesh.buildMesh(params);\n" +">> fprintf(\"%d nós, %d barras\\n\", size(mesh.nodes0, 1), size(mesh.bars, 1));" + +msgid "2. Change the test: write a scenario" +msgstr "2. Alterar o ensaio: escrever um cenário" + +msgid "" +"A *scenario* says which degrees of freedom are fixed, how the load is applied at " +"every time step and which reaction is reported. The solver never checks the test " +"number, it only asks the scenario. To model a new test, create a subclass of " +"``ldem.scenarios.Scenario`` in ``src/+ldem/+scenarios/``." +msgstr "" +"Um *cenário* diz quais graus de liberdade estão fixos, como a carga é aplicada a cada" +" passo de tempo e qual reação é informada. O solver nunca consulta o número do " +"ensaio; ele pergunta ao cenário. Para modelar um ensaio novo, crie uma subclasse de " +"``ldem.scenarios.Scenario`` em ``src/+ldem/+scenarios/``." + +msgid "" +"The example below is a cantilever beam along :math:`z`: the first layer of centre " +"nodes is clamped and a force that grows linearly is applied in :math:`y` at the free " +"end." +msgstr "" +"O exemplo é uma viga em balanço segundo :math:`z`: a primeira camada de nós centrais " +"é engastada e, na extremidade livre, aplica-se em :math:`y` uma força que cresce " +"linearmente." + +#, python-format +msgid "" +"classdef Cantilever < ldem.scenarios.Scenario\n" +" properties (Constant)\n" +" testId = 104 % new number, unique\n" +" end\n" +" properties\n" +" forceRate (1,1) double = 500 % [N/s] on each loaded node\n" +" end\n" +" methods\n" +" function fixed = fixedDofs(~, nodes0, params)\n" +" z = nodes0(:, 3);\n" +" atStart = abs(z - 0.5*params.moduleLength) < 0.01*params.moduleLength;\n" +" fixed = false(size(nodes0));\n" +" fixed(atStart, :) = true; % x, y and z held\n" +" end\n" +" function state = applyLoads(obj, state, mesh, params)\n" +" L1 = params.nModules(3) - 1;\n" +" z = mesh.nodes0(:, 3);\n" +" atEnd = abs(z - (L1 - 0.5)*params.moduleLength) < " +"0.01*params.moduleLength;\n" +" state.appliedForce(:) = 0;\n" +" state.appliedForce(atEnd, 2) = obj.forceRate * state.time;\n" +" end\n" +" end\n" +"end" +msgstr "" +"classdef Cantilever < ldem.scenarios.Scenario\n" +" properties (Constant)\n" +" testId = 104 % número novo, único\n" +" end\n" +" properties\n" +" forceRate (1,1) double = 500 % [N/s] em cada nó carregado\n" +" end\n" +" methods\n" +" function fixed = fixedDofs(~, nodes0, params)\n" +" z = nodes0(:, 3);\n" +" atStart = abs(z - 0.5*params.moduleLength) < 0.01*params.moduleLength;\n" +" fixed = false(size(nodes0));\n" +" fixed(atStart, :) = true; % x, y e z fixos\n" +" end\n" +" function state = applyLoads(obj, state, mesh, params)\n" +" L1 = params.nModules(3) - 1;\n" +" z = mesh.nodes0(:, 3);\n" +" atEnd = abs(z - (L1 - 0.5)*params.moduleLength) < " +"0.01*params.moduleLength;\n" +" state.appliedForce(:) = 0;\n" +" state.appliedForce(atEnd, 2) = obj.forceRate * state.time;\n" +" end\n" +" end\n" +"end" + +msgid "Rules to follow:" +msgstr "Regras:" + +msgid "" +"``fixedDofs`` returns an ``nNodes``-by-3 logical matrix, true where the node cannot " +"move (``1 = x``, ``2 = y``, ``3 = z``)." +msgstr "" +"``fixedDofs`` devolve uma matriz lógica de ``nNodes`` por 3, verdadeira onde o nó não" +" pode se mover (``1 = x``, ``2 = y``, ``3 = z``)." + +msgid "" +"``applyLoads`` runs once per step. A **displacement-controlled** test sets " +"``state.displacement`` of the loaded nodes (see ``UniaxialTension``); a **force-" +"controlled** test sets ``state.appliedForce`` in newtons (see ``ClampedBeam``) and " +"the solver counts its work in the external energy." +msgstr "" +"``applyLoads`` é executado a cada passo. Um ensaio **controlado por deslocamento** " +"atribui ``state.displacement`` dos nós carregados (ver ``UniaxialTension``); um " +"**controlado por força** atribui ``state.appliedForce`` em newtons (ver " +"``ClampedBeam``) e o solver conta seu trabalho na energia externa." + +msgid "Override ``reactions`` if the test reports a reaction force (default: ``NaN``)." +msgstr "Redefina ``reactions`` se o ensaio informar uma força de reação (padrão: ``NaN``)." + +msgid "" +"The centre nodes of the modules lie at half-integer multiples of ``moduleLength``; " +"select nodes with a small tolerance, never with ``==``." +msgstr "" +"Os nós centrais dos módulos estão em múltiplos semi-inteiros de ``moduleLength``; " +"selecione os nós com uma tolerância pequena, nunca com ``==``." + +msgid "3. Register and run it" +msgstr "3. Registrar e executar" + +msgid "Either pass the object directly, with no registration:" +msgstr "O objeto pode ser passado diretamente, sem registrar nada:" + +msgid "" +">> scenario = ldem.scenarios.Cantilever(forceRate=1000);\n" +">> results = ldem.runSimulation(params, Scenario=scenario, ...\n" +" OutputFolder=\"output\", Formats=[\"mat\" \"vtk\"]);" +msgstr "" + +msgid "" +"or add one line to ``ldem.scenarios.registry`` so that ``testId = 104`` finds it and " +"a case file can name it with ``type``. Then add a test in ``tests/unit`` and, if it " +"is a reference case, an example in ``examples/`` (see " +"``examples/example1_clamped_beam``)." +msgstr "" +"ou adicionar uma linha a ``ldem.scenarios.registry`` para que ``testId = 104`` o " +"encontre e um arquivo de caso possa nomeá-lo com ``type``. Depois, adicione um teste " +"em ``tests/unit`` e, se for um caso de referência, um exemplo em ``examples/`` (ver " +"``examples/example1_clamped_beam``)." + +msgid "The result is the same ``results`` struct as for any other test, see :doc:`usage`." +msgstr "" +"O resultado é a mesma estrutura ``results`` de qualquer outro ensaio, ver " +":doc:`usage`." + diff --git a/docs/locale/pt/LC_MESSAGES/sphinx.po b/docs/locale/pt/LC_MESSAGES/sphinx.po new file mode 100644 index 0000000..5def05e --- /dev/null +++ b/docs/locale/pt/LC_MESSAGES/sphinx.po @@ -0,0 +1,45 @@ +# User-interface texts of the theme (Furo) in pt: buttons, search and page navigation. +# Kept by hand: docs/tools/update_translations.py does not touch this file. +msgid "" +msgstr "" +"Project-Id-Version: LDEM-MATLAB\n" +"Report-Msgid-Bugs-To: \n" +"Last-Translator: \n" +"Language: pt\n" +"Language-Team: \n" +"Plural-Forms: nplurals=2; plural=(n != 1);\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.18.0\n" + +msgid "Skip to content" +msgstr "Pular para o conteúdo" + +msgid "Back to top" +msgstr "Voltar ao topo" + +msgid "Next" +msgstr "Próximo" + +msgid "Previous" +msgstr "Anterior" + +msgid "Home" +msgstr "Início" + +msgid "On this page" +msgstr "Nesta página" + +msgid "Search" +msgstr "Pesquisar" + +msgid "Index" +msgstr "Índice" + +msgid "Error" +msgstr "Erro" + +msgid "Please activate JavaScript to enable the search functionality." +msgstr "Ative o JavaScript para habilitar a função de pesquisa." + diff --git a/docs/locale/pt/LC_MESSAGES/usage.po b/docs/locale/pt/LC_MESSAGES/usage.po new file mode 100644 index 0000000..79baf20 --- /dev/null +++ b/docs/locale/pt/LC_MESSAGES/usage.po @@ -0,0 +1,1340 @@ +# Translation of the LDEM-MATLAB documentation (pt). +# Generated by docs/tools/update_translations.py: edit only the msgstr entries. +msgid "" +msgstr "" +"Project-Id-Version: LDEM-MATLAB\n" +"Report-Msgid-Bugs-To: \n" +"Last-Translator: \n" +"Language: pt\n" +"Language-Team: \n" +"Plural-Forms: nplurals=2; plural=(n != 1);\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.18.0\n" + +msgid "Usage" +msgstr "Uso" + +msgid "Run a simulation" +msgstr "Executar uma simulação" + +msgid "" +">> setup_path % adds src/ to the MATLAB path\n" +">> params = ldem.Parameters(testId=101, nModules=[6 3 3], totalTime=2e-4, ...\n" +" fractureEnergy=0.1, ...\n" +" output=struct('snapshotEvery', 250, 'controlNodesEvery', 10, ...\n" +" 'energyEvery', 10, 'trackedBarEvery', 0));\n" +">> results = ldem.runSimulation(params, OutputFolder=\"output\", ...\n" +" Formats=[\"mat\" \"ansys\" \"vtk\"]);\n" +">> ldem.post.plotEnergy(results);" +msgstr "" +">> setup_path % adiciona src/ ao path do MATLAB\n" +">> params = ldem.Parameters(testId=101, nModules=[6 3 3], totalTime=2e-4, ...\n" +" fractureEnergy=0.1, ...\n" +" output=struct('snapshotEvery', 250, 'controlNodesEvery', 10, ...\n" +" 'energyEvery', 10, 'trackedBarEvery', 0));\n" +">> results = ldem.runSimulation(params, OutputFolder=\"output\", ...\n" +" Formats=[\"mat\" \"ansys\" \"vtk\"]);\n" +">> ldem.post.plotEnergy(results);" + +msgid "" +"``ldem.Parameters`` checks every value when it is set and explains what is wrong (for" +" example an unstable time step). The complete, ready-to-run version of this script is" +" ``examples/tension_101/runTension.m``." +msgstr "" +"``ldem.Parameters`` valida cada valor ao atribuí-lo e explica o que está errado (por " +"exemplo, um passo de tempo instável). A versão completa e pronta para executar está " +"em ``examples/tension_101/runTension.m``." + +msgid "To use an input file in the format of the original program:" +msgstr "Para usar um arquivo de entrada no formato do programa original:" + +msgid ">> params = ldem.Parameters.fromFile(\"DATA0.DAT\");" +msgstr "" + +msgid "Case files (``.ldem``)" +msgstr "Arquivos de caso (``.ldem``)" + +msgid "" +"A *case file* describes the whole model in one readable text file: named keys instead" +" of positions, units next to the numbers, comments, and the test, the random scatter " +"and the output files together. It replaces ``DATA0.DAT``." +msgstr "" +"Um *arquivo de caso* descreve todo o modelo em um único texto legível: chaves com " +"nome em vez de posições, unidades junto aos números, comentários, e o ensaio, a " +"dispersão aleatória e os arquivos de saída juntos. Ele substitui o ``DATA0.DAT``." + +msgid "" +"format = 1\n" +"title = \"Small tension test\"\n" +"\n" +"[mesh]\n" +"module_size = 3 mm\n" +"modules = [5, 2, 2] # cubic modules along x, y and z\n" +"\n" +"[material]\n" +"young_modulus = 32 GPa\n" +"density = 2000 kg/m3\n" +"\n" +"[time]\n" +"step = auto # 0.9 times the critical step\n" +"duration = 40 us\n" +"\n" +"[scenario]\n" +"type = \"uniaxial_tension\"\n" +"\n" +"[output]\n" +"folder = \"output\"" +msgstr "" +"format = 1\n" +"title = \"Pequeno ensaio de tração\"\n" +"\n" +"[mesh]\n" +"module_size = 3 mm\n" +"modules = [5, 2, 2] # módulos cúbicos em x, y e z\n" +"\n" +"[material]\n" +"young_modulus = 32 GPa\n" +"density = 2000 kg/m3\n" +"\n" +"[time]\n" +"step = auto # 0.9 vezes o passo crítico\n" +"duration = 40 us\n" +"\n" +"[scenario]\n" +"type = \"uniaxial_tension\"\n" +"\n" +"[output]\n" +"folder = \"output\"" + +#, python-format +msgid "" +">> ldem.io.writeTemplate(\"my_test.ldem\", \"clamped_beam\"); % a commented file to " +"edit\n" +">> ldem.check(\"my_test.ldem\") % validate and report, " +"no simulation\n" +">> results = ldem.run(\"my_test.ldem\"); % run it\n" +">> ldem.io.convertLegacyInput(\"DATA0.DAT\", \"case.ldem\"); % convert an old input" +" file" +msgstr "" +">> ldem.io.writeTemplate(\"meu_ensaio.ldem\", \"clamped_beam\"); % arquivo comentado" +" para editar\n" +">> ldem.check(\"meu_ensaio.ldem\") % valida e informa, " +"sem simular\n" +">> results = ldem.run(\"meu_ensaio.ldem\"); % executa\n" +">> ldem.io.convertLegacyInput(\"DATA0.DAT\", \"caso.ldem\"); % converte um " +"arquivo antigo" + +msgid "Rules of the format:" +msgstr "Regras do formato:" + +msgid "" +"Keys are read by **name**; the order of the lines does not matter. Keys that are " +"missing take the default of ``ldem.Parameters``. Only ``scenario.type``, " +"``mesh.modules`` and ``time.duration`` are required." +msgstr "" +"As chaves são lidas por **nome**; a ordem das linhas não importa. As chaves ausentes " +"assumem o valor padrão de ``ldem.Parameters``. Só são obrigatórias ``scenario.type``," +" ``mesh.modules`` e ``time.duration``." + +msgid "" +"A number may carry a **unit**: ``3.87 GPa``, ``0.35 us``, ``1500 kg/m3``, ``2 kN/s``." +" Without a unit the value is in SI. The wrong unit for the key is an error that lists" +" the valid ones." +msgstr "" +"Um número pode ter **unidade**: ``3.87 GPa``, ``0.35 us``, ``1500 kg/m3``, ``2 " +"kN/s``. Sem unidade o valor está em SI. Uma unidade incorreta para a chave é um erro " +"que lista as válidas." + +msgid "" +"``#`` starts a comment, ``[section]`` opens a table, ``[[monitor.node]]`` starts the " +"next element of a repeated table, lists are written ``[5, 5, 50]``." +msgstr "" +"``#`` inicia um comentário, ``[seção]`` abre uma tabela, ``[[monitor.node]]`` inicia " +"o próximo elemento de uma tabela repetida e as listas são escritas ``[5, 5, 50]``." + +msgid "" +"``mesh.modules`` counts **modules**: the ``M N L`` of ``DATA0.DAT`` count nodes, one " +"more." +msgstr "" +"``mesh.modules`` conta **módulos**: os ``M N L`` do ``DATA0.DAT`` contam nós, um a " +"mais." + +msgid "``time.step = auto`` (or no ``step``) takes 0.9 times the critical step." +msgstr "``time.step = auto`` (ou sem ``step``) assume 0.9 vez o passo crítico." + +msgid "" +"Every error names the file, the line, the section and the key, and suggests the " +"closest valid name for a mistyped one." +msgstr "" +"Cada erro indica o arquivo, a linha, a seção e a chave, e sugere o nome válido mais " +"parecido quando há erro de digitação." + +msgid "" +"Relative paths (the random-field file, the output folder) are relative to the case " +"file." +msgstr "" +"Os caminhos relativos (arquivo do campo aleatório, pasta de saída) são relativos ao " +"arquivo de caso." + +msgid "A JSON file with the same structure (values with units as strings) is also read." +msgstr "" +"Também é lido um arquivo JSON com a mesma estrutura (os valores com unidades, como " +"texto)." + +msgid "Section" +msgstr "Seção" + +msgid "Keys" +msgstr "Chaves" + +msgid "(top)" +msgstr "(início)" + +msgid "``format`` (1), ``title``, ``authors``" +msgstr "" + +msgid "``[mesh]``" +msgstr "" + +msgid "" +"``module_size``, ``modules``, ``perturbation`` (random displacement of the nodes, " +"fraction of the module), ``seed`` (of the perturbation)" +msgstr "" +"``module_size``, ``modules``, ``perturbation`` (deslocamento aleatório dos nós, " +"fração do módulo), ``seed`` (da perturbação)" + +msgid "``[material]``" +msgstr "" + +msgid "" +"``law`` (``bilinear``, the legacy law, or ``linear_elastic``: no damage and no " +"rupture), ``young_modulus``, ``poisson_ratio``, ``density``, ``fracture_energy``, " +"``critical_distance``, ``failure_area_factor``" +msgstr "" +"``law`` (``bilinear``, a lei original, ou ``linear_elastic``: sem dano nem ruptura), " +"``young_modulus``, ``poisson_ratio``, ``density``, ``fracture_energy``, " +"``critical_distance``, ``failure_area_factor``" + +msgid "``[material.scatter]``" +msgstr "" + +msgid "" +"Scatter of the critical strain of the bars. ``type = \"none\"``; ``\"file\"`` with " +"``file`` (one multiplier per bar); or ``\"generated\"`` with ``cv``, " +"``correlation_length`` (in modules) and ``seed`` (the field is computed in memory)" +msgstr "" +"Dispersão da deformação crítica das barras. ``type = \"none\"``; ``\"file\"`` com " +"``file`` (um multiplicador por barra); ou ``\"generated\"`` com ``cv``, " +"``correlation_length`` (em módulos) e ``seed`` (o campo é calculado na memória)" + +msgid "``[time]``" +msgstr "" + +msgid "``step`` (or ``auto``), ``duration``" +msgstr "``step`` (ou ``auto``), ``duration``" + +msgid "``[damping]``" +msgstr "" + +msgid "" +"``type`` (``mass_proportional``, the legacy damping, or ``none``), ``initial``, " +"``final``, ``switch_time`` (not allowed with ``none``), ``constitutive``" +msgstr "" +"``type`` (``mass_proportional``, o amortecimento original, ou ``none``), ``initial``," +" ``final``, ``switch_time`` (não aceitos com ``none``), ``constitutive``" + +msgid "``[scenario]``" +msgstr "" + +msgid "" +"``type`` (``uniaxial_tension``, ``four_point_bending``, ``clamped_beam`` or " +"``custom``, see below) and the properties of that scenario in snake_case, for example" +" ``force_rate``, ``ramp_time``, ``load_position`` (``\"midspan\"`` is allowed)" +msgstr "" +"``type`` (``uniaxial_tension``, ``four_point_bending``, ``clamped_beam`` ou " +"``custom``, veja abaixo) e as propriedades desse cenário em snake_case, por exemplo " +"``force_rate``, ``ramp_time``, ``load_position`` (é aceito ``\"midspan\"``)" + +msgid "``[[monitor.node]]``" +msgstr "" + +msgid "" +"One element per control node: ``id`` (node number) or ``at = [x, y, z]`` (position in" +" modules, the nearest node is used), and ``name``" +msgstr "" +"Um elemento por nó de controle: ``id`` (número do nó) ou ``at = [x, y, z]`` (posição " +"em módulos, usa-se o nó mais próximo), e ``name``" + +msgid "``[monitor.bar]``" +msgstr "" + +msgid "``tracked``: bar whose strain history is stored at every step" +msgstr "``tracked``: barra cuja história de deformação é guardada a cada passo" + +msgid "``[output]``" +msgstr "" + +msgid "``folder``, ``mat``, ``ansys``, ``vtk`` (true or false)" +msgstr "``folder``, ``mat``, ``ansys``, ``vtk`` (true ou false)" + +msgid "``[output.snapshots]``, ``[output.control_nodes]``, ``[output.energy]``" +msgstr "" + +msgid "" +"``every``: ``1000 steps`` or a time such as ``0.1 ms`` (converted to steps); ``0`` " +"means never" +msgstr "" +"``every``: ``1000 steps`` ou um tempo como ``0.1 ms`` (convertido em passos); ``0`` " +"significa nunca" + +msgid "" +"``ldem.io.readCase`` returns the parameters, the scenario and the output options; " +"``ldem.Parameters.fromFile`` also accepts a case file. The list of keys lives in one " +"table, ``ldem.schema.caseSchema``, which drives the reader, the writer and the " +"template. To add a scenario, add a line to ``ldem.scenarios.registry``. A new " +"constitutive law is a subclass of ``ldem.material.MaterialLaw`` registered in " +"``ldem.material.lawRegistry``; a new damping model is a subclass of " +"``ldem.solver.DampingModel`` registered in ``ldem.solver.dampingRegistry``." +msgstr "" +"``ldem.io.readCase`` devolve os parâmetros, o cenário e as opções de saída; " +"``ldem.Parameters.fromFile`` também aceita um arquivo de caso. A lista de chaves está" +" em uma única tabela, ``ldem.schema.caseSchema``, que governa o leitor, o escritor e " +"o modelo. Para adicionar um cenário, adiciona-se uma linha a " +"``ldem.scenarios.registry``. Uma nova lei constitutiva é uma subclasse de " +"``ldem.material.MaterialLaw`` registrada em ``ldem.material.lawRegistry``; um novo " +"modelo de amortecimento, uma subclasse de ``ldem.solver.DampingModel`` registrada em " +"``ldem.solver.dampingRegistry``." + +msgid "Your own test: supports and loads" +msgstr "O seu próprio ensaio: apoios e cargas" + +msgid "" +"With ``type = \"custom\"`` the test is described in the case file by ``[[support]]`` " +"and ``[[load]]`` blocks, without writing a class. This is the uniaxial test (``testId" +" = 101``) as blocks:" +msgstr "" +"Com ``type = \"custom\"`` o ensaio é descrito no arquivo de caso com blocos " +"``[[support]]`` e ``[[load]]``, sem escrever uma classe. Este é o ensaio uniaxial " +"(``testId = 101``) como blocos:" + +msgid "" +"[scenario]\n" +"type = \"custom\"\n" +"\n" +"[[support]]\n" +"name = \"left end\"\n" +"x = 0.5 # the layer of centre nodes at x = 0.5 modules\n" +"fix = [\"x\"] # directions that cannot move\n" +"\n" +"[[load]]\n" +"name = \"right end\"\n" +"x = \"max - 0.5\"\n" +"direction = \"x\"\n" +"type = \"displacement\" # or \"force\"\n" +"time_function = \"linear\"\n" +"rate = -4 mm/s\n" +"reaction = true # its force is the reaction of the test" +msgstr "" +"[scenario]\n" +"type = \"custom\"\n" +"\n" +"[[support]]\n" +"name = \"left end\"\n" +"x = 0.5 # a camada de nós centrais em x = 0.5 módulos\n" +"fix = [\"x\"] # direções que não podem se mover\n" +"\n" +"[[load]]\n" +"name = \"right end\"\n" +"x = \"max - 0.5\"\n" +"direction = \"x\"\n" +"type = \"displacement\" # ou \"force\"\n" +"time_function = \"linear\"\n" +"rate = -4 mm/s\n" +"reaction = true # a sua força é a reação do ensaio" + +msgid "" +"**Nodes** are chosen with ``nodes`` (``all``, ``grid`` for the corners of the modules" +" or ``centre`` for their centres), ``ids`` (node numbers) and ``x``, ``y``, ``z``. A " +"position is in modules (centre nodes lie at half-integers, grid nodes at integers), a" +" range ``[lo, hi]``, or a text with the references ``min``, ``max`` and ``mid`` and " +"an offset, such as ``\"max - 0.5\"``. A node must satisfy every condition. The " +"positions refer to the regular lattice, so they do not change when " +"``mesh.perturbation`` moves the nodes." +msgstr "" +"Os **nós** são escolhidos com ``nodes`` (``all``, ``grid`` para os cantos dos módulos" +" ou ``centre`` para os seus centros), ``ids`` (números de nó) e ``x``, ``y``, ``z``. " +"Uma posição é em módulos (os nós centrais ficam em semi-inteiros, os de canto em " +"inteiros), um intervalo ``[lo, hi]``, ou um texto com as referências ``min``, ``max``" +" e ``mid`` e um deslocamento, como ``\"max - 0.5\"``. Um nó deve satisfazer todas as " +"condições. As posições referem-se à malha regular, portanto não mudam quando " +"``mesh.perturbation`` move os nós." + +msgid "" +"**Supports** hold the directions listed in ``fix``. **Loads** act on one " +"``direction`` as a ``force`` (newtons on each selected node) or as a prescribed " +"``displacement`` (metres from the initial position, and the solver holds that " +"direction). The value follows ``time_function``: ``constant`` (``value``), ``linear``" +" (``rate``), ``ramp`` (``rate`` until the time ``until``, then constant) or ``table``" +" (``times`` and ``values`` in SI units, linear between points and constant outside)." +msgstr "" +"Os **apoios** fixam as direções de ``fix``. As **cargas** atuam em uma ``direction`` " +"como ``force`` (newtons em cada nó escolhido) ou como ``displacement`` imposto " +"(metros a partir da posição inicial; o solver fixa essa direção). O valor segue " +"``time_function``: ``constant`` (``value``), ``linear`` (``rate``), ``ramp`` " +"(``rate`` até o tempo ``until``, depois constante) ou ``table`` (``times`` e " +"``values`` em unidades SI, linear entre pontos e constante fora)." + +msgid "" +"A block with ``reaction = true`` adds its force to the reaction of the test (the sum " +"of the bar forces on its held directions); with none, the reaction is NaN. A block " +"that selects no node is an error that names it. The three built-in tests written this" +" way give exactly the same results as their classes." +msgstr "" +"Um bloco com ``reaction = true`` soma sua força à reação do ensaio (a soma das forças" +" de barra nas suas direções fixas); se nenhum a pedir, a reação é NaN. Um bloco que " +"não escolhe nenhum nó é um erro que o nomeia. Os três ensaios incorporados escritos " +"assim dão exatamente os mesmos resultados que as suas classes." + +msgid "Reuse a case: extends" +msgstr "Reutilizar um caso: extends" + +msgid "A case file can start from another one and change only what differs:" +msgstr "Um arquivo de caso pode partir de outro e mudar só o que difere:" + +msgid "" +"extends = \"base.ldem\" # or a list: [\"base.ldem\", \"material.ldem\"]\n" +"\n" +"[material]\n" +"fracture_energy = 1 N/m # only what changes" +msgstr "" +"extends = \"base.ldem\" # ou uma lista: [\"base.ldem\", " +"\"material.ldem\"]\n" +"\n" +"[material]\n" +"fracture_energy = 1 N/m # apenas o que muda" + +msgid "" +"The keys of the file replace the inherited ones. A repeated table (``[[support]]``, " +"``[[load]]``, ``[[monitor.node]]``, ``[[sweep]]``) replaces the whole inherited list." +" When the ``type`` of the scenario, of ``[material.scatter]`` or of ``[damping]`` " +"changes, the keys of the old type that are not set again are dropped. With a list, " +"later files win. Relative paths (the random-field file, the output folder) are " +"relative to the file that contains them, and an error names the file and line where " +"the problem is written. ``results.info.case.parents`` keeps the hash of every " +"inherited file." +msgstr "" +"As chaves do arquivo substituem as herdadas. Uma tabela repetida (``[[support]]``, " +"``[[load]]``, ``[[monitor.node]]``, ``[[sweep]]``) substitui toda a lista herdada. " +"Quando muda o ``type`` do cenário, de ``[material.scatter]`` ou de ``[damping]``, as " +"chaves do tipo anterior que não são definidas de novo são descartadas. Com uma lista," +" os últimos arquivos vencem. Os caminhos relativos (arquivo do campo aleatório, pasta" +" de saída) são relativos ao arquivo que os contém, e um erro indica o arquivo e a " +"linha onde o problema está escrito. ``results.info.case.parents`` guarda o hash de " +"cada arquivo herdado." + +msgid "Parameter sweeps" +msgstr "Varreduras de parâmetros" + +msgid "" +"To study how the result depends on a value, list the values in ``[[sweep]]`` blocks " +"and run ``ldem.sweep``:" +msgstr "" +"Para estudar como o resultado depende de um valor, listam-se os valores em blocos " +"``[[sweep]]`` e executa-se ``ldem.sweep``:" + +msgid "" +"[[sweep]]\n" +"key = \"material.fracture_energy\"\n" +"values = [\"0.1 N/m\", \"0.5 N/m\", \"1 N/m\"]\n" +"\n" +"[[sweep]]\n" +"key = \"time.duration\"\n" +"values = [\"20 us\", \"40 us\"]" +msgstr "" + +#, python-brace-format, python-format +msgid "" +">> summary = ldem.sweep(\"case.ldem\"); % 3 x 2 = 6 runs, one folder " +"each\n" +">> ldem.sweep(\"case.ldem\", DryRun=true); % only validate and list the " +"runs\n" +">> ldem.sweep(\"case.ldem\", Vary={\"scenario.force_rate\", [\"1 kN/s\" \"2 " +"kN/s\"]});\n" +">> results = ldem.run(\"case.ldem\", Overrides=struct(\"path\", " +"\"material.fracture_energy\", \"value\", \"2 N/m\"));" +msgstr "" +">> summary = ldem.sweep(\"case.ldem\"); % 3 x 2 = 6 execuções, uma " +"pasta cada\n" +">> ldem.sweep(\"case.ldem\", DryRun=true); % apenas valida e lista as " +"execuções\n" +">> ldem.sweep(\"case.ldem\", Vary={\"scenario.force_rate\", [\"1 kN/s\" \"2 " +"kN/s\"]});\n" +">> results = ldem.run(\"case.ldem\", Overrides=struct(\"path\", " +"\"material.fracture_energy\", \"value\", \"2 N/m\"));" + +msgid "" +"Several blocks give every combination; ``sweep_mode = \"zip\"`` (a key at the top of " +"the file) takes them one by one. Any key with a single value can be varied, and the " +"keys of the scenario as ``scenario.``. Values are numbers or texts with units. " +"Every run is validated before the first one starts. The runs go to ``run_001``, " +"``run_002``, ... (each with its resolved ``case.ldem``) and the table " +"``sweep_summary.csv`` lists them, with the number of damaged and broken bars; a run " +"that fails is recorded and the sweep goes on." +msgstr "" +"Vários blocos dão todas as combinações; ``sweep_mode = \"zip\"`` (uma chave no início" +" do arquivo) toma-os um a um. Pode-se variar qualquer chave de valor único, e as do " +"cenário como ``scenario.``. Os valores são números ou textos com unidades. " +"Cada execução é validada antes de começar a primeira. As execuções vão para " +"``run_001``, ``run_002``, ... (cada uma com o seu ``case.ldem`` resolvido) e a tabela" +" ``sweep_summary.csv`` as lista, com o número de barras danificadas e rompidas; uma " +"execução que falha fica registrada e a varredura continua." + +msgid "Reference of every key" +msgstr "Referência de todas as chaves" + +msgid "" +"The tables below are generated from ``ldem.schema.caseSchema``, the same table that " +"the reader uses, so they always agree with it." +msgstr "" +"As tabelas a seguir são geradas a partir de ``ldem.schema.caseSchema``, a mesma " +"tabela que o leitor usa, portanto sempre coincidem com ele. As descrições estão em " +"inglês." + +msgid "``(top level)``" +msgstr "``(nível superior)``" + +msgid "Key" +msgstr "Chave" + +msgid "Value" +msgstr "Valor" + +msgid "Default" +msgstr "Padrão" + +msgid "Legacy" +msgstr "Original" + +msgid "Description" +msgstr "Descrição" + +msgid "``format``" +msgstr "" + +msgid "integer" +msgstr "inteiro" + +msgid "1" +msgstr "" + +msgid "(none)" +msgstr "(nenhum)" + +msgid "Version of the case-file format (currently 1)." +msgstr "Versão do formato do arquivo de caso (atualmente 1)." + +msgid "``title``" +msgstr "" + +msgid "text" +msgstr "texto" + +msgid "Free text title of the case." +msgstr "Título do caso, em texto livre." + +msgid "``authors``" +msgstr "" + +msgid "list of texts" +msgstr "lista de textos" + +msgid "Names of the authors." +msgstr "Nomes dos autores." + +msgid "``extends``" +msgstr "" + +msgid "Case file(s) to inherit from; the keys of this file replace the inherited ones." +msgstr "Arquivo(s) de caso do qual se herda; as chaves deste arquivo substituem as herdadas." + +msgid "``sweep_mode``" +msgstr "" + +msgid "product, zip" +msgstr "" + +msgid "\"product\"" +msgstr "" + +msgid "How several [[sweep]] blocks combine: all combinations (product) or one by one (zip)." +msgstr "" +"Como vários blocos [[sweep]] se combinam: todas as combinações (product) ou um a um " +"(zip)." + +msgid "``module_size``" +msgstr "" + +msgid "number + unit (m, cm, mm, um, km)" +msgstr "número + unidade (m, cm, mm, um, km)" + +msgid "3 mm" +msgstr "" + +msgid "LCO" +msgstr "" + +msgid "Edge length of each cubic module." +msgstr "Comprimento da aresta de cada módulo cúbico." + +msgid "``modules``" +msgstr "" + +msgid "list of integers" +msgstr "lista de inteiros" + +msgid "required" +msgstr "obrigatório" + +msgid "M N L" +msgstr "" + +msgid "Cubic modules along x, y and z (M N L of the legacy file count nodes: one more)." +msgstr "Módulos cúbicos em x, y e z (os M N L do arquivo original contam nós: um a mais)." + +msgid "``perturbation``" +msgstr "" + +msgid "number" +msgstr "número" + +msgid "0" +msgstr "" + +msgid "Random node displacement as a fraction of the module size; 0 = regular lattice." +msgstr "Deslocamento aleatório dos nós como fração do tamanho do módulo; 0 = malha regular." + +msgid "``seed``" +msgstr "" + +msgid "123" +msgstr "" + +msgid "SEED" +msgstr "" + +msgid "Seed of the mesh perturbation (the random field has its own seed)." +msgstr "Semente da perturbação da malha (o campo aleatório tem a sua própria semente)." + +msgid "``law``" +msgstr "" + +msgid "bilinear, linear\\_elastic" +msgstr "" + +msgid "\"bilinear\"" +msgstr "" + +msgid "Constitutive law of the bars (see ldem.material.lawRegistry)." +msgstr "Lei constitutiva das barras (ver ldem.material.lawRegistry)." + +msgid "``young_modulus``" +msgstr "" + +msgid "number + unit (Pa, kPa, MPa, GPa)" +msgstr "número + unidade (Pa, kPa, MPa, GPa)" + +msgid "32 GPa" +msgstr "" + +msgid "YNG" +msgstr "" + +msgid "Young's modulus." +msgstr "Módulo de Young." + +msgid "``poisson_ratio``" +msgstr "" + +msgid "0.25" +msgstr "" + +msgid "PSN" +msgstr "" + +msgid "Poisson's ratio, from 0 up to less than 0.5." +msgstr "Coeficiente de Poisson, de 0 até menos de 0.5." + +msgid "``density``" +msgstr "" + +msgid "number + unit (kg/m3, g/cm3)" +msgstr "número + unidade (kg/m3, g/cm3)" + +msgid "2000 kg/m3" +msgstr "" + +msgid "ROH" +msgstr "" + +msgid "Mass density." +msgstr "Densidade de massa." + +msgid "``fracture_energy``" +msgstr "" + +msgid "number + unit (N/m, kN/m)" +msgstr "número + unidade (N/m, kN/m)" + +msgid "50 N/m" +msgstr "" + +msgid "GFR" +msgstr "" + +msgid "Specific fracture energy." +msgstr "Energia específica de fratura." + +msgid "``critical_distance``" +msgstr "" + +msgid "28 mm" +msgstr "" + +msgid "DEQ" +msgstr "" + +msgid "Equivalent (critical) distance." +msgstr "Distância equivalente (crítica)." + +msgid "``failure_area_factor``" +msgstr "" + +msgid "0.1385" +msgstr "" + +msgid "CAF" +msgstr "" + +msgid "Fraction of the module face that fails per bar." +msgstr "Fração da face do módulo que falha por barra." + +msgid "``type``" +msgstr "" + +msgid "none, file, generated" +msgstr "" + +msgid "\"none\"" +msgstr "" + +msgid "Scatter of the critical strain: none, file (one multiplier per bar) or generated." +msgstr "Dispersão da deformação crítica: none, file (um multiplicador por barra) ou generated." + +msgid "``file``" +msgstr "" + +msgid "file path" +msgstr "caminho de arquivo" + +msgid "Text file with one multiplier per bar, relative to this file." +msgstr "Arquivo de texto com um multiplicador por barra, relativo a este arquivo." + +msgid "``cv``" +msgstr "" + +msgid "Coefficient of variation of the generated field (1e-4 to 3)." +msgstr "Coeficiente de variação do campo gerado (1e-4 a 3)." + +msgid "``correlation_length``" +msgstr "" + +msgid "list of numbers" +msgstr "lista de números" + +msgid "[3]" +msgstr "" + +msgid "Correlation length of the generated field in modules: one value or [x, y, z]." +msgstr "Comprimento de correlação do campo gerado em módulos: um valor ou [x, y, z]." + +msgid "515" +msgstr "" + +msgid "Seed of the generated field." +msgstr "Semente do campo gerado." + +msgid "``step``" +msgstr "" + +msgid "time, or auto" +msgstr "tempo, ou auto" + +msgid "\"auto\"" +msgstr "" + +msgid "DT" +msgstr "" + +msgid "Integration time step, or auto (0.9 times the critical step)." +msgstr "Passo de tempo de integração, ou auto (0.9 vez o passo crítico)." + +msgid "``duration``" +msgstr "" + +msgid "number + unit (s, ms, us, ns)" +msgstr "número + unidade (s, ms, us, ns)" + +msgid "TTOT" +msgstr "" + +msgid "Total simulated time." +msgstr "Tempo total simulado." + +msgid "mass\\_proportional, none" +msgstr "" + +msgid "\"mass\\_proportional\"" +msgstr "" + +msgid "Damping model of the nodes (see ldem.solver.dampingRegistry)." +msgstr "Modelo de amortecimento dos nós (ver ldem.solver.dampingRegistry)." + +msgid "``initial``" +msgstr "" + +msgid "number + unit (1/s, 1/ms)" +msgstr "número + unidade (1/s, 1/ms)" + +msgid "25000 1/s" +msgstr "" + +msgid "DF1" +msgstr "" + +msgid "Mass-proportional damping before switch\\_time." +msgstr "Amortecimento proporcional à massa antes de switch\\_time." + +msgid "``final``" +msgstr "" + +msgid "DF2" +msgstr "" + +msgid "Mass-proportional damping after switch\\_time." +msgstr "Amortecimento proporcional à massa depois de switch\\_time." + +msgid "``switch_time``" +msgstr "" + +msgid "15 ms" +msgstr "" + +msgid "TDAF" +msgstr "" + +msgid "Time at which the damping changes from initial to final." +msgstr "Tempo em que o amortecimento passa de initial para final." + +msgid "``constitutive``" +msgstr "" + +msgid "0 s" +msgstr "" + +msgid "CON" +msgstr "" + +msgid "Stiffness-proportional damping inside the bar law." +msgstr "Amortecimento proporcional à rigidez dentro da lei das barras." + +msgid "TEST" +msgstr "" + +msgid "Test case (see ldem.scenarios.registry); its other keys follow." +msgstr "Ensaio (ver ldem.scenarios.registry); as suas outras chaves seguem." + +msgid "``[[support]]``" +msgstr "" + +msgid "``name``" +msgstr "" + +msgid "Label of the support." +msgstr "Rótulo do apoio." + +msgid "``nodes``" +msgstr "" + +msgid "all, centre, grid" +msgstr "" + +msgid "\"all\"" +msgstr "" + +msgid "Kind of nodes: all, grid (module corners) or centre (module centres)." +msgstr "Tipo de nós: all, grid (cantos dos módulos) ou centre (centros dos módulos)." + +msgid "``ids``" +msgstr "" + +msgid "Node numbers to select." +msgstr "Números de nó a escolher." + +msgid "``x``" +msgstr "" + +msgid "modules: number, text or [lo, hi]" +msgstr "módulos: número, texto ou [lo, hi]" + +msgid "Positions along x in modules: 0.5, \"max - 0.5\" or a range [lo, hi]." +msgstr "Posições em x, em módulos: 0.5, \"max - 0.5\" ou um intervalo [lo, hi]." + +msgid "``y``" +msgstr "" + +msgid "Positions along y in modules (see x)." +msgstr "Posições em y, em módulos (ver x)." + +msgid "``z``" +msgstr "" + +msgid "Positions along z in modules (see x)." +msgstr "Posições em z, em módulos (ver x)." + +msgid "``fix``" +msgstr "" + +msgid "Directions held at their initial position: [\"x\", \"y\", \"z\"]." +msgstr "Direções mantidas na posição inicial: [\"x\", \"y\", \"z\"]." + +msgid "``reaction``" +msgstr "" + +msgid "true or false" +msgstr "true ou false" + +msgid "false" +msgstr "" + +msgid "Include the force on the held directions in the reaction of the test." +msgstr "Inclui a força nas direções fixas na reação do ensaio." + +msgid "``[[load]]``" +msgstr "" + +msgid "Label of the load." +msgstr "Rótulo da carga." + +msgid "``direction``" +msgstr "" + +msgid "x, y, z" +msgstr "" + +msgid "Direction of the load." +msgstr "Direção da carga." + +msgid "force, displacement" +msgstr "" + +msgid "force (N on each selected node) or displacement (m from the initial position)." +msgstr "force (N em cada nó escolhido) ou displacement (m a partir da posição inicial)." + +msgid "``time_function``" +msgstr "" + +msgid "constant, linear, ramp, table" +msgstr "" + +msgid "How the value changes with time." +msgstr "Como o valor muda com o tempo." + +msgid "``value``" +msgstr "" + +msgid "N, N/s, m or m/s, by type" +msgstr "N, N/s, m ou m/s, conforme o tipo" + +msgid "constant: the value (N or m)." +msgstr "constant: o valor (N ou m)." + +msgid "``rate``" +msgstr "" + +msgid "linear and ramp: change per second (N/s or m/s)." +msgstr "linear e ramp: variação por segundo (N/s ou m/s)." + +msgid "``until``" +msgstr "" + +msgid "ramp: time at which it stops growing." +msgstr "ramp: tempo em que deixa de crescer." + +msgid "``times``" +msgstr "" + +msgid "table: increasing times in seconds." +msgstr "table: tempos crescentes em segundos." + +msgid "``values``" +msgstr "" + +msgid "table: one value per time (N or m)." +msgstr "table: um valor por tempo (N ou m)." + +msgid "Include the force on the loaded direction in the reaction of the test." +msgstr "Inclui a força na direção carregada na reação do ensaio." + +msgid "``[[sweep]]``" +msgstr "" + +msgid "``key``" +msgstr "" + +msgid "Key to vary, for example \"material.fracture\\_energy\" (see ldem.sweep)." +msgstr "Chave a variar, por exemplo \"material.fracture\\_energy\" (ver ldem.sweep)." + +msgid "Values to try: numbers, or texts with units such as [\"0.1 N/m\", \"0.5 N/m\"]." +msgstr "Valores a testar: números, ou textos com unidades como [\"0.1 N/m\", \"0.5 N/m\"]." + +msgid "``id``" +msgstr "" + +msgid "NCON" +msgstr "" + +msgid "Number of a node whose motion is recorded." +msgstr "Número de um nó cujo movimento é registrado." + +msgid "``at``" +msgstr "" + +msgid "Position [x, y, z] in modules; the nearest node is recorded." +msgstr "Posição [x, y, z] em módulos; é registrado o nó mais próximo." + +msgid "Label of the node." +msgstr "Rótulo do nó." + +msgid "``tracked``" +msgstr "" + +msgid "off" +msgstr "desativado" + +msgid "OU9" +msgstr "" + +msgid "Number of the bar whose strain history is stored at every step." +msgstr "Número da barra cuja história de deformação é guardada a cada passo." + +msgid "``folder``" +msgstr "" + +msgid "no files" +msgstr "sem arquivos" + +msgid "Output folder, relative to the case file." +msgstr "Pasta de saída, relativa ao arquivo de caso." + +msgid "``mat``" +msgstr "" + +msgid "true" +msgstr "" + +msgid "Write results.mat." +msgstr "Escreve results.mat." + +msgid "``ansys``" +msgstr "" + +msgid "Write ANSYS macro files (needs snapshots.every > 0)." +msgstr "Escreve arquivos macro do ANSYS (requer snapshots.every > 0)." + +msgid "``vtk``" +msgstr "" + +msgid "Write VTK files for ParaView (needs snapshots.every > 0)." +msgstr "Escreve arquivos VTK para o ParaView (requer snapshots.every > 0)." + +msgid "``[output.snapshots]``" +msgstr "" + +msgid "``every``" +msgstr "" + +msgid "steps or time (0 = never)" +msgstr "passos ou tempo (0 = nunca)" + +msgid "OU3" +msgstr "" + +msgid "Steps or time between full-field snapshots; 0 = never." +msgstr "Passos ou tempo entre instantâneos do campo completo; 0 = nunca." + +msgid "``[output.control_nodes]``" +msgstr "" + +msgid "OU6" +msgstr "" + +msgid "Steps or time between records of the control nodes and reactions; 0 = never." +msgstr "Passos ou tempo entre registros dos nós de controle e reações; 0 = nunca." + +msgid "``[output.energy]``" +msgstr "" + +msgid "OU8" +msgstr "" + +msgid "Steps or time between records of the energies; 0 = never." +msgstr "Passos ou tempo entre registros das energias; 0 = nunca." + +msgid "Tests available" +msgstr "Ensaios disponíveis" + +msgid "``testId = 101``" +msgstr "" + +msgid "" +"Uniaxial load: the centre nodes of the last column of modules move along :math:`x` " +"with a prescribed velocity." +msgstr "" +"Carga uniaxial: os nós centrais da última coluna de módulos se movem em :math:`x` com" +" velocidade imposta." + +msgid "``testId = 102``" +msgstr "" + +msgid "" +"Beam with two supports and two load points. The positions are parameters of " +"``ldem.scenarios.FourPointBending`` (``supportPosition``, ``loadPosition``, in " +"modules from each end); the defaults need a beam longer than about 70 modules. See " +"``examples/beam_102``." +msgstr "" +"Viga com dois apoios e dois pontos de carga. As posições são parâmetros de " +"``ldem.scenarios.FourPointBending`` (``supportPosition``, ``loadPosition``, em " +"módulos a partir de cada extremidade); os valores padrão exigem uma viga com mais de " +"uns 70 módulos. Ver ``examples/beam_102``." + +msgid "``testId = 103``" +msgstr "" + +msgid "" +"Beam clamped at both ends, loaded at mid-span with a force that grows linearly and " +"then stays constant (``ldem.scenarios.ClampedBeam``). It is the only test loaded with" +" a force instead of a displacement. See ``examples/example1_clamped_beam``." +msgstr "" +"Viga engastada nas duas extremidades, carregada no meio do vão com uma força que " +"cresce linearmente e depois se mantém constante (``ldem.scenarios.ClampedBeam``). É o" +" único ensaio carregado com força em vez de deslocamento. Ver " +"``examples/example1_clamped_beam``." + +msgid "" +"To add a new test, create a subclass of ``ldem.scenarios.Scenario`` (see " +":doc:`model`)." +msgstr "" +"Para adicionar um ensaio novo, crie uma subclasse de ``ldem.scenarios.Scenario`` (ver" +" :doc:`model`)." + +msgid "Mesh perturbation" +msgstr "Perturbação da malha" + +msgid "" +"The parameter ``meshPerturbation`` randomly displaces the interior nodes. Its value " +"is the standard deviation as a fraction of the module length: ``0`` (the default) " +"keeps the lattice regular and any positive value activates the perturbation with that" +" value. The random numbers follow ``seed``." +msgstr "" +"O parâmetro ``meshPerturbation`` desloca aleatoriamente os nós interiores. Seu valor " +"é o desvio padrão como fração do comprimento do módulo: ``0`` (o padrão) mantém o " +"reticulado regular e qualquer valor positivo ativa a perturbação com esse valor. Os " +"números aleatórios seguem ``seed``." + +msgid ">> params = ldem.Parameters(testId=101, nModules=[6 3 3], meshPerturbation=0.02);" +msgstr "" + +msgid "What you get: the ``results`` struct" +msgstr "O que se obtém: a estrutura ``results``" + +msgid "Field" +msgstr "Campo" + +msgid "Content" +msgstr "Conteúdo" + +msgid "``info``" +msgstr "" + +msgid "ldem version, date, MATLAB release, run time [s]." +msgstr "Versão do ldem, data, versão do MATLAB, tempo de execução [s]." + +msgid "``params``" +msgstr "" + +msgid "The parameters used, as a plain struct (derived values included)." +msgstr "Os parâmetros usados, como estrutura simples (com valores derivados)." + +msgid "``model``" +msgstr "" + +msgid "" +"Counts and mass of the model: modules, nodes, bars by type, fixed degrees of freedom," +" total mass and volume." +msgstr "" +"Contagens e massa do modelo: módulos, nós, barras por tipo, graus de liberdade fixos," +" massa total e volume." + +msgid "``material``" +msgstr "" + +msgid "" +"Material data (E, Gf, ...), lattice coefficients, critical length and the statistics " +"of the critical strain (mean, coefficient of variation, minimum and maximum)." +msgstr "" +"Dados do material (E, Gf, ...), coeficientes do reticulado, comprimento crítico e " +"estatísticas da deformação crítica (média, coeficiente de variação, mínimo e máximo)." + +msgid "``mesh``" +msgstr "" + +msgid "Initial node positions, supports (``fixed``), masses, bars, bar lengths and bar types." +msgstr "" +"Posições iniciais dos nós, apoios (``fixed``), massas, barras, comprimentos e tipos " +"de barra." + +msgid "``barProps``" +msgstr "" + +msgid "Stiffness, critical strain and rupture strain of every bar." +msgstr "Rigidez, deformação crítica e deformação de ruptura de cada barra." + +msgid "``controlNodes``" +msgstr "" + +msgid "Time and displacement, velocity and acceleration of the control nodes." +msgstr "Tempo e deslocamento, velocidade e aceleração dos nós de controle." + +msgid "``reactions``" +msgstr "" + +msgid "" +"Time and reaction force ``[Rx Ry Rz]`` of the test: vertical force at the load points" +" (test 102), force on the clamped ends (test 103); ``NaN`` where the test defines " +"none." +msgstr "" +"Tempo e força de reação ``[Rx Ry Rz]`` do ensaio: força vertical nos pontos de carga " +"(ensaio 102), força nas extremidades engastadas (ensaio 103); ``NaN`` onde o ensaio " +"não a define." + +msgid "``energy``" +msgstr "" + +msgid "" +"Time, kinetic, elastic, damage and damping energies [J], their sum (``internal``), " +"the energy of the broken bars (``brokenBars``), the external work, the ``balance`` " +"(external minus internal) and the damage rate." +msgstr "" +"Tempo, energias cinética, elástica, de dano e de amortecimento [J], sua soma " +"(``internal``), a energia das barras rompidas (``brokenBars``), o trabalho externo, o" +" balanço (``balance``, externo menos interno) e a taxa de dano." + +msgid "``trackedBar``" +msgstr "" + +msgid "Strain, force and damage energy of one bar at every step (optional)." +msgstr "Deformação, força e energia de dano de uma barra a cada passo (opcional)." + +msgid "``snapshots``" +msgstr "" + +msgid "" +"Step, time, number of intact/damaged/broken bars, and compact copies of the " +"displacements, the damage state and the nodal kinetic energy at the snapshot steps." +msgstr "" +"Passo, tempo, número de barras intactas/danificadas/rompidas e cópias compactas dos " +"deslocamentos, do estado de dano e da energia cinética nodal nos passos salvos." + +msgid "" +"Final displacement, velocity, force and damage state, and the kinetic energy of every" +" node." +msgstr "" +"Deslocamento, velocidade, força e estado de dano finais, e a energia cinética de cada" +" nó." + +msgid "" +"The energy ``balance`` is a check of the simulation: it should be a small fraction " +"(below 1 %) of the final external work. The total kinetic energy is " +"``energy.kinetic``; the kinetic energy of each node is in ``final.kineticEnergy``." +msgstr "" +"O ``balance`` de energia é uma verificação da simulação: deve ser uma fração pequena " +"(menos de 1 %) do trabalho externo final. A energia cinética total é " +"``energy.kinetic``; a de cada nó está em ``final.kineticEnergy``." + +msgid "``results.mat`` contains this struct and loads without the package:" +msgstr "``results.mat`` contém esta estrutura e carrega-se sem o pacote:" + +msgid "" +">> data = load(\"output/results.mat\");\n" +">> results = data.results;" +msgstr "" + +msgid "Output files" +msgstr "Arquivos de saída" + +msgid "``results.mat``" +msgstr "" + +msgid "The ``results`` struct (format v7.3, readable from Python with ``h5py``)." +msgstr "A estrutura ``results`` (formato v7.3, legível em Python com ``h5py``)." + +msgid "``snapshot_0000.mac``, ``snapshot_0001.mac``, ..." +msgstr "" + +msgid "" +"ANSYS macro files with the deformed lattice. Bars are element types 1 (intact), 2 " +"(damaged) and 5 (broken). The held degrees of freedom are listed as " +"``D,node,direction`` and the displacement imposed on the loaded nodes, measured from " +"their initial position, as ``D,node,direction,value``. In test 103 the applied forces" +" are listed as ``F,node,direction,value``." +msgstr "" +"Macros do ANSYS com o reticulado deformado. As barras são elementos do tipo 1 " +"(intactas), 2 (danificadas) e 5 (rompidas). Os graus de liberdade fixos são listados " +"como ``D,nó,direção`` e o deslocamento imposto aos nós carregados, medido a partir da" +" posição inicial, como ``D,nó,direção,valor``. No ensaio 103 as forças aplicadas são " +"listadas como ``F,nó,direção,valor``." + +msgid "``snapshot_0000.vtu``, ... and ``snapshots.pvd``" +msgstr "``snapshot_0000.vtu``, ... e ``snapshots.pvd``" + +msgid "" +"VTK files. Open ``snapshots.pvd`` in `ParaView `_; colour " +"by ``damageState`` (cell data) to see the cracks and use the time slider to follow " +"them. Displacement and velocity are point data." +msgstr "" +"Arquivos VTK. Abra ``snapshots.pvd`` no `ParaView `_; " +"colora por ``damageState`` (dados de célula) para ver as fissuras e use o controle de" +" tempo para acompanhá-las. Deslocamento e velocidade são dados de ponto." + +msgid "" +"ANSYS and VTK files are written at time zero and every " +"``params.output.snapshotEvery`` steps." +msgstr "" +"Os arquivos ANSYS e VTK são escritos no tempo zero e a cada " +"``params.output.snapshotEvery`` passos." + +msgid "Run the tests" +msgstr "Executar os testes" + +#, python-format +msgid "" +">> addpath tests\n" +">> run_tests % fast tests\n" +">> run_tests(IncludeSlow=true) % also the slow tests" +msgstr "" +">> addpath tests\n" +">> run_tests % testes rápidos\n" +">> run_tests(IncludeSlow=true) % também os testes lentos" + diff --git a/docs/source/_static/examples/clamped_beam_displacement.png b/docs/source/_static/examples/clamped_beam_displacement.png new file mode 100644 index 0000000000000000000000000000000000000000..5517bc92f99e51a508b2c8d64f18f2babb7a625f GIT binary patch literal 20301 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 MSyh?WD6>cZ7gPe!_W%F@ literal 0 HcmV?d00001 diff --git a/docs/source/_static/examples/clamped_beam_energy.png b/docs/source/_static/examples/clamped_beam_energy.png new file mode 100644 index 0000000000000000000000000000000000000000..7ec3fefe1c00e928e0b124ec59ec8c5d02840466 GIT binary patch literal 28924 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 F{{fMJauxsp literal 0 HcmV?d00001 diff --git a/docs/source/_templates/page.html b/docs/source/_templates/page.html new file mode 100644 index 0000000..38be7e2 --- /dev/null +++ b/docs/source/_templates/page.html @@ -0,0 +1,65 @@ +{#- Furo page with its footer block rewritten without "Made with Sphinx and Furo". + The rest of the page is Furo's (extends "!page.html"). The block below is Furo's own + footer minus that line; the Read the Docs and GitHub icons of Furo are left out because + the documentation is published on GitHub Pages. If Furo changes its footer, compare with + furo/theme/furo/page.html. -#} +{% extends "!page.html" %} +{% block footer %} + +
    +
    + {%- if show_copyright %} + + {%- endif %} + {%- if last_updated -%} +
    + {% trans last_updated=last_updated|e -%} + Last updated on {{ last_updated }} + {%- endtrans -%} +
    + {%- endif %} +
    +
    + {% if theme_footer_icons -%} +
    + {% for icon_dict in theme_footer_icons -%} + + {{- icon_dict.html -}} + + {% endfor %} +
    + {%- endif %} +
    +
    +{% endblock footer %} diff --git a/docs/source/_templates/sidebar/languages.html b/docs/source/_templates/sidebar/languages.html index ce41a8f..ae47f86 100644 --- a/docs/source/_templates/sidebar/languages.html +++ b/docs/source/_templates/sidebar/languages.html @@ -1,17 +1,12 @@ -{#- Language switcher: the same page in the other languages. -#} -{%- set langs = [('en', 'English'), ('es', 'Español'), ('pt', 'Português'), ('it', 'Italiano')] -%} -{%- set parts = pagename.split('/') -%} -{%- if parts|length > 1 and parts[0] in ['en', 'es', 'pt', 'it'] %} +{#- Language selector. Every language is a separate site (docs/build/html//), so the + other languages are reached by a relative link to the same page in the sibling folder. -#} +{%- set depth = pagename.count('/') -%} -{%- endif %} diff --git a/docs/source/api/index.rst b/docs/source/api/index.rst index 59fb6cb..5353012 100644 --- a/docs/source/api/index.rst +++ b/docs/source/api/index.rst @@ -1,18 +1,15 @@ -API reference / Referencia de la API -==================================== +API reference +============= -Generated automatically from the comments of the ``.m`` files / -Generada automáticamente desde los comentarios de los ``.m``. +Generated automatically from the comments of the ``.m`` files. The ``ldem`` package (``src/+ldem``) is the refactored code. It replaces the original routines, which are kept in the git history (tag ``legacy-reference``); the problems found in them are listed in -``docs/known-issues/KNOWN_ISSUES.md`` / El paquete ``ldem`` (``src/+ldem``) es -el código refactorizado. Reemplaza a las rutinas originales, que se conservan -en el historial de git (etiqueta ``legacy-reference``). +``docs/known-issues/KNOWN_ISSUES.md``. -Running a simulation / Ejecutar una simulación ----------------------------------------------- +Running a simulation +-------------------- .. mat:module:: ldem @@ -24,8 +21,8 @@ Running a simulation / Ejecutar una simulación .. mat:autofunction:: ldem.sweep .. mat:autofunction:: ldem.version -Input and output / Entrada y salida ------------------------------------ +Input and output +---------------- .. mat:module:: ldem.io @@ -44,8 +41,8 @@ Input and output / Entrada y salida .. mat:autoclass:: ldem.io.SnapshotWriter :members: -Mesh / Malla ------------- +Mesh +---- .. mat:module:: ldem.mesh @@ -74,8 +71,8 @@ Material .. mat:autofunction:: ldem.material.lawFromName .. mat:autofunction:: ldem.material.summarizeMaterial -Scenarios / Escenarios de ensayo --------------------------------- +Scenarios +--------- .. mat:module:: ldem.scenarios @@ -92,8 +89,8 @@ Scenarios / Escenarios de ensayo .. mat:autofunction:: ldem.scenarios.timeFunction .. mat:autofunction:: ldem.scenarios.registry -Case-file schema / Esquema de los archivos de caso --------------------------------------------------- +Case-file schema +---------------- .. mat:module:: ldem.schema @@ -125,8 +122,8 @@ Solver .. mat:autofunction:: ldem.solver.nodalKineticEnergy .. mat:autofunction:: ldem.solver.checkStability -Post-processing / Postproceso ------------------------------ +Post-processing +--------------- .. mat:module:: ldem.post diff --git a/docs/source/en/authors.rst b/docs/source/authors.rst similarity index 92% rename from docs/source/en/authors.rst rename to docs/source/authors.rst index 3b38b7e..90d37be 100644 --- a/docs/source/en/authors.rst +++ b/docs/source/authors.rst @@ -6,7 +6,7 @@ This list is generated automatically from the commits of the git history from the authors of ``CITATION.cff``. Authors without commits in this repository appear with ``-``. The same list is in ``AUTHORS.md``. -.. include:: ../_generated/authors.rst +.. include:: _generated/authors.rst To update it after new commits, build the documentation or run: diff --git a/docs/source/conf.py b/docs/source/conf.py index 1537657..e23a72c 100644 --- a/docs/source/conf.py +++ b/docs/source/conf.py @@ -24,7 +24,15 @@ # --- General ---------------------------------------------------------------- source_suffix = {".rst": "restructuredtext", ".md": "markdown"} exclude_patterns = ["_build", "_generated/*"] -language = "en" +language = "en" # the other languages are built with -D language=es|pt|it (docs/tools/build_docs.py) + +# --- Translations: English source pages, one .po catalog per page and language ---- +locale_dirs = ["../locale/"] # docs/locale//LC_MESSAGES/.po +gettext_compact = False # one catalog per page, easier to review +gettext_additional_targets = ["literal-block"] # the comments of the code examples are translated too +html_context = { + "languages": [("en", "English"), ("es", "Español"), ("pt", "Português"), ("it", "Italiano")], +} # --- Authors: generated from the git history on every build ----------------- _tools = os.path.abspath(os.path.join(os.path.dirname(__file__), "..", "tools")) diff --git a/docs/source/en/contributing.rst b/docs/source/contributing.rst similarity index 100% rename from docs/source/en/contributing.rst rename to docs/source/contributing.rst diff --git a/docs/source/docs.rst b/docs/source/docs.rst new file mode 100644 index 0000000..f04e41c --- /dev/null +++ b/docs/source/docs.rst @@ -0,0 +1,88 @@ +Building this documentation +=========================== + +The documentation is written in English, which is the only set of source pages, +and translated into Spanish, Portuguese and Italian with gettext catalogs +(``.po`` files in ``docs/locale/``). Each language is built as its own site and +the sidebar has a language selector. A text that is not translated yet is shown +in English. The API reference is generated from the comments of the ``.m`` +files and is in English only. + +Requirements +------------ + +* Python 3.9 or newer. +* ``git`` (the list of authors is generated from the commit history; with a + shallow clone use ``git fetch --unshallow`` first). +* No MATLAB is needed; the API is read from the source text. + +.. code-block:: bash + + pip install -r docs/requirements.txt + +Build +----- + +From the repository root, with any of these: + +.. code-block:: bash + + python docs/tools/build_docs.py + +.. code-block:: bash + + cd docs && make html + +.. code-block:: matlab + + >> buildtool docs + +This builds the four languages into ``docs/build/html/en``, ``es``, ``pt`` and +``it``; ``docs/build/html/index.html`` sends the reader to the English site. Open +it in a browser. To build only some languages use for example +``python docs/tools/build_docs.py --languages en es``. Warnings are errors: the +documentation must build without any. ``buildtool clean`` deletes the result. + +Where things are +---------------- + +``docs/source/`` + The pages, in English. +``docs/locale/es/``, ``pt/``, ``it/`` + Translations: one ``.po`` file per page in ``LC_MESSAGES/``, with each English + text and its translation. +``docs/source/api/`` + API reference, generated from the ``.m`` comments. +``docs/tools/build_docs.py`` + Builds every language and the page that sends the reader to the English site. +``docs/tools/update_translations.py`` + Updates the ``.po`` files after the English text changes, and reports what is + left to translate. +``docs/tools/generate_authors.py`` + Writes the authors page and ``AUTHORS.md`` (run by the build). +``docs/source/case-keys.inc`` + Reference of the case-file keys, generated from the schema. After changing + ``ldem.schema.caseSchema`` regenerate it from MATLAB with + ``ldem.schema.writeKeyReference("docs/source/case-keys.inc")``; a test fails + if it is out of date. + +Write or change a page +---------------------- + +1. Edit the English page in ``docs/source/``. A new page also goes in the list of + ``index.rst``. +2. Run ``python docs/tools/update_translations.py``. It extracts the texts and + updates the ``.po`` files: new texts appear untranslated and changed texts are + marked as fuzzy, both shown in English until they are translated. +3. Translate the new entries in ``docs/locale//LC_MESSAGES/.po`` + (with any text editor or a tool such as Poedit) and remove the fuzzy marks you + have reviewed. ``python docs/tools/update_translations.py --status`` shows how + much is left in each language. +4. Build with ``python docs/tools/build_docs.py`` and fix any warning. + +Publishing +---------- + +The workflow ``.github/workflows/docs.yml`` builds the documentation on every +pull request and publishes the four languages to GitHub Pages when ``main`` +changes. diff --git a/docs/source/en/docs.rst b/docs/source/en/docs.rst deleted file mode 100644 index f773731..0000000 --- a/docs/source/en/docs.rst +++ /dev/null @@ -1,67 +0,0 @@ -Building this documentation -=========================== - -The documentation is written in English and translated into Spanish, -Portuguese and Italian; the four versions are in one site and the sidebar -lets the reader switch language. The API reference is generated from the -comments of the ``.m`` files. - -Requirements ------------- - -* Python 3.9 or newer. -* ``git`` (the list of authors is generated from the commit history; with a - shallow clone use ``git fetch --unshallow`` first). -* No MATLAB is needed; the API is read from the source text. - -.. code-block:: bash - - pip install -r docs/requirements.txt - -Build ------ - -From the repository root, with any of these: - -.. code-block:: bash - - sphinx-build -W --keep-going -b html docs/source docs/build/html - -.. code-block:: bash - - cd docs && make html - -.. code-block:: matlab - - >> buildtool docs - -Open ``docs/build/html/index.html`` in a browser. ``-W`` turns warnings into -errors: the documentation must build without any. ``buildtool clean`` deletes -the result. - -Where things are ----------------- - -``docs/source/en/`` - The reference text, in English. -``docs/source/es/``, ``pt/``, ``it/`` - Translations. Each page has the same file name as in ``en/`` so that the - language list in the sidebar links to the same page. -``docs/source/api/`` - API reference, generated from the ``.m`` comments. -``docs/tools/generate_authors.py`` - Writes the authors page and ``AUTHORS.md`` (run by the build). - -Write or change a page ----------------------- - -1. Edit the English page in ``docs/source/en/``. -2. Apply the same change to the translations. A new page needs a file with - the same name in each language and an entry in each ``index.rst``. -3. Build with ``-W`` and fix any warning. - -Publishing ----------- - -The workflow ``.github/workflows/docs.yml`` builds the documentation on every -pull request and publishes it to GitHub Pages when ``main`` changes. diff --git a/docs/source/en/index.rst b/docs/source/en/index.rst deleted file mode 100644 index b2e7764..0000000 --- a/docs/source/en/index.rst +++ /dev/null @@ -1,13 +0,0 @@ -User guide -========== - -.. toctree:: - :maxdepth: 1 - - introduction - installation - usage - model - contributing - docs - authors diff --git a/docs/source/es/authors.rst b/docs/source/es/authors.rst deleted file mode 100644 index d1a9473..0000000 --- a/docs/source/es/authors.rst +++ /dev/null @@ -1,18 +0,0 @@ -Autores -======= - -Esta lista se genera automáticamente desde los commits del historial de git -(las personas con el mismo nombre o correo se unifican con ``.mailmap``) y -desde los autores de ``CITATION.cff``. Los autores sin commits en este -repositorio aparecen con ``-``. La misma lista está en ``AUTHORS.md``. - -.. include:: ../_generated/authors.rst - -Para actualizarla después de nuevos commits, construir la documentación o -ejecutar: - -.. code-block:: bash - - python docs/tools/generate_authors.py - -Si una persona aparece dos veces, agregar una línea a ``.mailmap``. diff --git a/docs/source/es/contributing.rst b/docs/source/es/contributing.rst deleted file mode 100644 index 2869ebb..0000000 --- a/docs/source/es/contributing.rst +++ /dev/null @@ -1,16 +0,0 @@ -Contribuir -========== - -La documentación de la API se genera desde los comentarios de los ``.m``. El -docstring debe ser el bloque de comentarios ubicado **inmediatamente después** -de la línea ``function`` (antes de cualquier ``global``). Los comentarios del -código se escriben en inglés. - -.. code-block:: matlab - - function ini = CALOAD() - % CALOAD Resumen en una línea. - % Descripción más larga. - global ... - -Ver ``CONTRIBUTING.md`` en la raíz del repositorio. diff --git a/docs/source/es/docs.rst b/docs/source/es/docs.rst deleted file mode 100644 index ee63154..0000000 --- a/docs/source/es/docs.rst +++ /dev/null @@ -1,68 +0,0 @@ -Construir esta documentación -============================ - -La documentación está escrita en inglés y traducida al español, portugués e -italiano; las cuatro versiones forman un solo sitio y la barra lateral permite -cambiar de idioma. La referencia de la API se genera desde los comentarios de -los ``.m``. - -Requisitos ----------- - -* Python 3.9 o superior. -* ``git`` (la lista de autores se genera desde el historial de commits; con un - clon superficial ejecutar antes ``git fetch --unshallow``). -* No se necesita MATLAB; la API se lee del texto de las fuentes. - -.. code-block:: bash - - pip install -r docs/requirements.txt - -Construcción ------------- - -Desde la raíz del repositorio, con cualquiera de estas opciones: - -.. code-block:: bash - - sphinx-build -W --keep-going -b html docs/source docs/build/html - -.. code-block:: bash - - cd docs && make html - -.. code-block:: matlab - - >> buildtool docs - -Abrir ``docs/build/html/index.html`` en un navegador. ``-W`` convierte las -advertencias en errores: la documentación debe construirse sin ninguna. -``buildtool clean`` borra el resultado. - -Dónde está cada cosa --------------------- - -``docs/source/en/`` - El texto de referencia, en inglés. -``docs/source/es/``, ``pt/``, ``it/`` - Traducciones. Cada página tiene el mismo nombre de archivo que en ``en/`` - para que la lista de idiomas de la barra lateral enlace a la misma página. -``docs/source/api/`` - Referencia de la API, generada desde los comentarios de los ``.m``. -``docs/tools/generate_authors.py`` - Escribe la página de autores y ``AUTHORS.md`` (lo ejecuta la construcción). - -Escribir o cambiar una página ------------------------------ - -1. Editar la página en inglés en ``docs/source/en/``. -2. Aplicar el mismo cambio a las traducciones. Una página nueva necesita un - archivo con el mismo nombre en cada idioma y una entrada en cada - ``index.rst``. -3. Construir con ``-W`` y corregir cualquier advertencia. - -Publicación ------------ - -El workflow ``.github/workflows/docs.yml`` construye la documentación en cada -pull request y la publica en GitHub Pages cuando cambia ``main``. diff --git a/docs/source/es/index.rst b/docs/source/es/index.rst deleted file mode 100644 index b9dacc8..0000000 --- a/docs/source/es/index.rst +++ /dev/null @@ -1,13 +0,0 @@ -Guía de usuario -=============== - -.. toctree:: - :maxdepth: 1 - - introduction - installation - usage - model - contributing - docs - authors diff --git a/docs/source/es/installation.rst b/docs/source/es/installation.rst deleted file mode 100644 index 507aba6..0000000 --- a/docs/source/es/installation.rst +++ /dev/null @@ -1,37 +0,0 @@ -Instalación -=========== - -Requisitos: MATLAB R2022b o superior (desarrollado y probado en R2023b). El -paquete usa el bloque ``arguments`` y la sintaxis nombre=valor; la suite de -tests y ``buildtool`` requieren R2022b. No hace falta ningún toolbox. - -.. code-block:: bash - - git clone ldem-matlab - cd ldem-matlab - -.. code-block:: matlab - - >> setup_path - -Comprobar la instalación con los tests rápidos: - -.. code-block:: matlab - - >> buildtool test - -Tareas para desarrolladores (``buildtool`` se ejecuta desde la raíz del -repositorio): - -.. code-block:: matlab - - >> buildtool % análisis estático + tests rápidos (por defecto) - >> buildtool check % solo el analizador de código - >> buildtool testAll % todos los tests, incluidos los lentos - >> buildtool docs % construir esta documentación (requiere Python) - >> buildtool clean % borrar los archivos generados - -``buildtool test`` escribe ``test-results/results.xml`` (JUnit) y -``code-coverage/coverage.xml`` (Cobertura). - -Para construir esta documentación sin MATLAB ver :doc:`docs`. diff --git a/docs/source/es/introduction.rst b/docs/source/es/introduction.rst deleted file mode 100644 index eb779a4..0000000 --- a/docs/source/es/introduction.rst +++ /dev/null @@ -1,25 +0,0 @@ -Introducción -============ - -El **Método de Elementos Discretos tipo Reticulado (LDEM)** modela un -continuo como un reticulado regular de nodos conectados por barras -dispuestas en módulos cúbicos (aristas más diagonales). Las masas son -concentradas en los nodos, las leyes constitutivas de las barras incluyen -daño/fractura y las ecuaciones de movimiento se integran con un esquema -explícito de diferencias centrales. Las energías (externa, cinética, -elástica, disipada) se controlan en cada paso. - -Partes principales del paquete ``ldem`` (ver :doc:`../api/index`): - -* ``ldem.Parameters`` / ``ldem.io.readInputFile`` – datos de entrada validados. -* ``ldem.mesh`` – nodos, barras, masas y geometría de las barras. -* ``ldem.material`` – rigidez de las barras, deformación crítica y ley bilineal de daño. -* ``ldem.scenarios`` – apoyos, cargas y reacciones de cada ensayo. -* ``ldem.solver`` – integración en el tiempo y balance de energía. -* ``ldem.runSimulation`` – la simulación completa, con salida ``results.mat``, - ANSYS y VTK. - -Las rutinas del programa original (``ini_DEM3``, ``read_dat0``, ``RMEC``, -``BOUND``, ``CALOAD``, ``ENERG2``, ...) se conservan en el historial de git, con -la etiqueta ``legacy-reference``; la línea ``Legacy:`` de cada ayuda nombra la -rutina que reemplaza. diff --git a/docs/source/es/model.rst b/docs/source/es/model.rst deleted file mode 100644 index 1bfa52d..0000000 --- a/docs/source/es/model.rst +++ /dev/null @@ -1,116 +0,0 @@ -Construir un modelo distinto -============================ - -Un modelo se define con tres cosas: la **geometría** del reticulado, el -**material** y el **ensayo** (apoyos y cargas). Las dos primeras son -parámetros; la tercera es una clase *escenario*. Se puede cambiar cualquiera -sin tocar el solver. - -1. Cambiar la geometría y el material -------------------------------------- - -Todo es una propiedad de ``ldem.Parameters``: - -.. code-block:: matlab - - >> params = ldem.Parameters(testId=101, ... - moduleLength=0.002, ... % arista del módulo cúbico [m] - nModules=[21 6 6], ... % nodos en x, y y z - youngModulus=30e9, density=2400, poissonRatio=0.2, ... - fractureEnergy=80, criticalDistance=0.02, ... - meshPerturbation=0.02); % malla irregular (opcional) - -* ``nModules = [M N L]`` es el número de nodos de la grilla en cada eje, de - modo que el prisma tiene ``(M-1)*(N-1)*(L-1)`` módulos. -* ``randomFieldFile`` multiplica la deformación crítica de cada barra por un - valor leído de un archivo de texto (campo aleatorio de la resistencia). -* ``randomFieldCv`` genera ese campo aleatorio en memoria, sin archivo: valores - Weibull con media 1 y ese coeficiente de variación en una grilla de polos - separados ``randomFieldCorrelationLength`` longitudes de módulo (3 por - defecto), interpolados a cada barra; ``randomFieldSeed`` fija los números - aleatorios. El valor de cada barra queda en ``results.barProps.randomField``. -* ``dt`` debe ser menor que ``params.criticalTimeStep``; ``Parameters`` - rechaza un valor inestable y lo explica. - -Los mismos datos pueden venir de un archivo de entrada con el formato del -programa original: ``ldem.Parameters.fromFile("DATA0.DAT", ...)``; los pares -nombre=valor adicionales reemplazan a los del archivo. La malla se puede -construir e inspeccionar antes de ejecutar nada: - -.. code-block:: matlab - - >> mesh = ldem.mesh.buildMesh(params); - >> fprintf("%d nodos, %d barras\n", size(mesh.nodes0, 1), size(mesh.bars, 1)); - -2. Cambiar el ensayo: escribir un escenario -------------------------------------------- - -Un *escenario* dice qué grados de libertad están fijos, cómo se aplica la -carga en cada paso de tiempo y qué reacción se informa. El solver nunca -consulta el número del ensayo; se lo pregunta al escenario. Para modelar un -ensayo nuevo se crea una subclase de ``ldem.scenarios.Scenario`` en -``src/+ldem/+scenarios/``. - -El ejemplo es una viga en voladizo según :math:`z`: la primera capa de nodos -centrales está empotrada y en el extremo libre se aplica en :math:`y` una -fuerza que crece linealmente. - -.. code-block:: matlab - - classdef Cantilever < ldem.scenarios.Scenario - properties (Constant) - testId = 104 % número nuevo, único - end - properties - forceRate (1,1) double = 500 % [N/s] en cada nodo cargado - end - methods - function fixed = fixedDofs(~, nodes0, params) - z = nodes0(:, 3); - atStart = abs(z - 0.5*params.moduleLength) < 0.01*params.moduleLength; - fixed = false(size(nodes0)); - fixed(atStart, :) = true; % x, y y z fijos - end - function state = applyLoads(obj, state, mesh, params) - L1 = params.nModules(3) - 1; - z = mesh.nodes0(:, 3); - atEnd = abs(z - (L1 - 0.5)*params.moduleLength) < 0.01*params.moduleLength; - state.appliedForce(:) = 0; - state.appliedForce(atEnd, 2) = obj.forceRate * state.time; - end - end - end - -Reglas: - -* ``fixedDofs`` devuelve una matriz lógica de ``nNodes`` por 3, verdadera donde - el nodo no puede moverse (``1 = x``, ``2 = y``, ``3 = z``). -* ``applyLoads`` se ejecuta en cada paso. Un ensayo **controlado por - desplazamiento** asigna ``state.displacement`` de los nodos cargados (ver - ``UniaxialTension``); uno **controlado por fuerza** asigna - ``state.appliedForce`` en newtons (ver ``ClampedBeam``) y el solver cuenta su - trabajo en la energía externa. -* Se redefine ``reactions`` si el ensayo informa una fuerza de reacción (por - defecto: ``NaN``). -* Los nodos centrales de los módulos están en múltiplos semienteros de - ``moduleLength``; los nodos se seleccionan con una tolerancia pequeña, nunca - con ``==``. - -3. Registrarlo y ejecutarlo ---------------------------- - -Se puede pasar el objeto directamente, sin registrar nada: - -.. code-block:: matlab - - >> scenario = ldem.scenarios.Cantilever(forceRate=1000); - >> results = ldem.runSimulation(params, Scenario=scenario, ... - OutputFolder="output", Formats=["mat" "vtk"]); - -o agregarlo a la lista de ``ldem.scenarios.fromTestId`` para que -``testId = 104`` lo encuentre, que es lo que hace un archivo de entrada. -Después se agrega un test en ``tests/unit`` y, si es un caso de referencia, un -ejemplo en ``examples/`` (ver ``examples/example1_clamped_beam``). - -El resultado es la misma estructura ``results`` de cualquier otro ensayo, ver -:doc:`usage`. diff --git a/docs/source/es/usage.rst b/docs/source/es/usage.rst deleted file mode 100644 index 53c4993..0000000 --- a/docs/source/es/usage.rst +++ /dev/null @@ -1,368 +0,0 @@ -Uso -=== - -Ejecutar una simulación ------------------------ - -.. code-block:: matlab - - >> setup_path % agrega src/ al path de MATLAB - >> params = ldem.Parameters(testId=101, nModules=[6 3 3], totalTime=2e-4, ... - fractureEnergy=0.1, ... - output=struct('snapshotEvery', 250, 'controlNodesEvery', 10, ... - 'energyEvery', 10, 'trackedBarEvery', 0)); - >> results = ldem.runSimulation(params, OutputFolder="output", ... - Formats=["mat" "ansys" "vtk"]); - >> ldem.post.plotEnergy(results); - -``ldem.Parameters`` valida cada valor al asignarlo y explica qué está mal -(por ejemplo, un paso de tiempo inestable). La versión completa y lista para -ejecutar está en ``examples/tension_101/runTension.m``. - -Para usar un archivo de entrada con el formato del programa original: - -.. code-block:: matlab - - >> params = ldem.Parameters.fromFile("DATA0.DAT"); - -Archivos de caso (``.ldem``) ----------------------------- - -Un *archivo de caso* describe todo el modelo en un único texto legible: claves -con nombre en lugar de posiciones, unidades junto a los números, comentarios, y -el ensayo, la dispersión aleatoria y los archivos de salida juntos. Reemplaza al -``DATA0.DAT``. - -.. code-block:: text - - format = 1 - title = "Ensayo de tracción pequeño" - - [mesh] - module_size = 3 mm - modules = [5, 2, 2] # módulos cúbicos en x, y y z - - [material] - young_modulus = 32 GPa - density = 2000 kg/m3 - - [time] - step = auto # 0.9 veces el paso crítico - duration = 40 us - - [scenario] - type = "uniaxial_tension" - - [output] - folder = "output" - -.. code-block:: matlab - - >> ldem.io.writeTemplate("mi_ensayo.ldem", "clamped_beam"); % archivo comentado para editar - >> ldem.check("mi_ensayo.ldem") % valida e informa, sin simular - >> results = ldem.run("mi_ensayo.ldem"); % lo ejecuta - >> ldem.io.convertLegacyInput("DATA0.DAT", "caso.ldem"); % convierte un archivo antiguo - -Reglas del formato: - -* Las claves se leen por **nombre**; el orden de las líneas no importa. Las - claves ausentes toman el valor por defecto de ``ldem.Parameters``. Solo son - obligatorias ``scenario.type``, ``mesh.modules`` y ``time.duration``. -* Un número puede llevar **unidad**: ``3.87 GPa``, ``0.35 us``, ``1500 kg/m3``, - ``2 kN/s``. Sin unidad el valor está en SI. Una unidad incorrecta para la - clave es un error que lista las válidas. -* ``#`` inicia un comentario, ``[sección]`` abre una tabla, ``[[monitor.node]]`` - inicia el siguiente elemento de una tabla repetida y las listas se escriben - ``[5, 5, 50]``. -* ``mesh.modules`` cuenta **módulos**: los ``M N L`` del ``DATA0.DAT`` cuentan - nodos, uno más. -* ``time.step = auto`` (o sin ``step``) toma 0.9 veces el paso crítico. -* Cada error indica el archivo, la línea, la sección y la clave, y sugiere el - nombre válido más parecido cuando hay un error de tipeo. -* Las rutas relativas (archivo del campo aleatorio, carpeta de salida) son - relativas al archivo de caso. -* También se lee un archivo JSON con la misma estructura (los valores con - unidades, como texto). - -.. list-table:: - :header-rows: 1 - :widths: 25 75 - - * - Sección - - Claves - * - (inicio) - - ``format`` (1), ``title``, ``authors`` - * - ``[mesh]`` - - ``module_size``, ``modules``, ``perturbation`` (desplazamiento aleatorio - de los nodos, fracción del módulo), ``seed`` (de la perturbación) - * - ``[material]`` - - ``law`` (``bilinear``, la ley original, o ``linear_elastic``: sin daño ni - rotura), ``young_modulus``, ``poisson_ratio``, ``density``, - ``fracture_energy``, ``critical_distance``, ``failure_area_factor`` - * - ``[material.scatter]`` - - Dispersión de la deformación crítica de las barras. ``type = "none"``; - ``"file"`` con ``file`` (un multiplicador por barra); o ``"generated"`` - con ``cv``, ``correlation_length`` (en módulos) y ``seed`` (el campo se - calcula en memoria) - * - ``[time]`` - - ``step`` (o ``auto``), ``duration`` - * - ``[damping]`` - - ``type`` (``mass_proportional``, el amortiguamiento original, o ``none``), - ``initial``, ``final``, ``switch_time`` (no se admiten con ``none``), - ``constitutive`` - * - ``[scenario]`` - - ``type`` (``uniaxial_tension``, ``four_point_bending``, - ``clamped_beam`` o ``custom``, ver más abajo) y las propiedades de ese escenario en snake_case, por - ejemplo ``force_rate``, ``ramp_time``, ``load_position`` (se admite - ``"midspan"``) - * - ``[[monitor.node]]`` - - Un elemento por nodo de control: ``id`` (número de nodo) o - ``at = [x, y, z]`` (posición en módulos, se usa el nodo más cercano), y - ``name`` - * - ``[monitor.bar]`` - - ``tracked``: barra cuya historia de deformación se guarda en cada paso - * - ``[output]`` - - ``folder``, ``mat``, ``ansys``, ``vtk`` (true o false) - * - ``[output.snapshots]``, ``[output.control_nodes]``, ``[output.energy]`` - - ``every``: ``1000 steps`` o un tiempo como ``0.1 ms`` (se convierte a - pasos); ``0`` significa nunca - -``ldem.io.readCase`` devuelve los parámetros, el escenario y las opciones de -salida; ``ldem.Parameters.fromFile`` también acepta un archivo de caso. La lista -de claves está en una sola tabla, ``ldem.schema.caseSchema``, que gobierna el -lector, el escritor y la plantilla. Para agregar un escenario, se agrega una -línea a ``ldem.scenarios.registry``. Una ley constitutiva nueva es una subclase -de ``ldem.material.MaterialLaw`` registrada en ``ldem.material.lawRegistry``; un -modelo de amortiguamiento nuevo, una subclase de ``ldem.solver.DampingModel`` -registrada en ``ldem.solver.dampingRegistry``. - -Reutilizar un caso: extends ---------------------------- - -Un archivo de caso puede partir de otro y cambiar solo lo que difiere: - -.. code-block:: text - - extends = "base.ldem" # or a list: ["base.ldem", "material.ldem"] - - [material] - fracture_energy = 1 N/m # only what changes - -Las claves del archivo reemplazan a las heredadas. Una tabla repetida -(``[[support]]``, ``[[load]]``, ``[[monitor.node]]``, ``[[sweep]]``) reemplaza -toda la lista heredada. Cuando cambia el ``type`` del escenario, de -``[material.scatter]`` o de ``[damping]``, se descartan las claves del tipo -anterior que no se vuelven a definir. Con una lista, los últimos archivos -ganan. Las rutas relativas (archivo del campo aleatorio, carpeta de salida) son -relativas al archivo que las contiene, y un error nombra el archivo y la línea -donde está escrito el problema. ``results.info.case.parents`` guarda el hash de -cada archivo heredado. - -Barridos de parámetros ----------------------- - -Para estudiar cómo depende el resultado de un valor, se listan los valores en -bloques ``[[sweep]]`` y se ejecuta ``ldem.sweep``: - -.. code-block:: text - - [[sweep]] - key = "material.fracture_energy" - values = ["0.1 N/m", "0.5 N/m", "1 N/m"] - - [[sweep]] - key = "time.duration" - values = ["20 us", "40 us"] - -.. code-block:: matlab - - >> summary = ldem.sweep("case.ldem"); % 3 x 2 = 6 runs, one folder each - >> ldem.sweep("case.ldem", DryRun=true); % only validate and list the runs - >> ldem.sweep("case.ldem", Vary={"scenario.force_rate", ["1 kN/s" "2 kN/s"]}); - >> results = ldem.run("case.ldem", Overrides=struct("path", "material.fracture_energy", "value", "2 N/m")); - -Varios bloques dan todas las combinaciones; ``sweep_mode = "zip"`` (una clave al -principio del archivo) los toma uno a uno. Se puede variar cualquier clave de un -solo valor, y las del escenario como ``scenario.``. Los valores son -números o textos con unidades. Cada corrida se valida antes de empezar la -primera. Las corridas van a ``run_001``, ``run_002``, ... (cada una con su -``case.ldem`` resuelto) y la tabla ``sweep_summary.csv`` las lista, con el -número de barras dañadas y rotas; una corrida que falla queda registrada y el -barrido continúa. - -Referencia de todas las claves ------------------------------- - -Las tablas siguientes se generan desde ``ldem.schema.caseSchema``, la misma tabla -que usa el lector, así que siempre coinciden con él. Las descripciones están en -inglés. - -.. include:: ../case-keys.inc - -Su propio ensayo: apoyos y cargas ---------------------------------- - -Con ``type = "custom"`` el ensayo se describe en el archivo de caso con bloques -``[[support]]`` y ``[[load]]``, sin escribir una clase. Este es el ensayo -uniaxial (``testId = 101``) como bloques: - -.. code-block:: text - - [scenario] - type = "custom" - - [[support]] - name = "left end" - x = 0.5 # the layer of centre nodes at x = 0.5 modules - fix = ["x"] # directions that cannot move - - [[load]] - name = "right end" - x = "max - 0.5" - direction = "x" - type = "displacement" # or "force" - time_function = "linear" - rate = -4 mm/s - reaction = true # its force is the reaction of the test - -Los **nodos** se eligen con ``nodes`` (``all``, ``grid`` para las esquinas de -los módulos o ``centre`` para sus centros), ``ids`` (números de nodo) y ``x``, -``y``, ``z``. Una posición está en módulos (los nodos centrales están en -semienteros, los de esquina en enteros), un rango ``[lo, hi]``, o un texto con -las referencias ``min``, ``max`` y ``mid`` y un desplazamiento, como -``"max - 0.5"``. Un nodo debe cumplir todas las condiciones. Las posiciones se -refieren a la malla regular, así que no cambian cuando ``mesh.perturbation`` -mueve los nodos. - -Los **apoyos** fijan las direcciones de ``fix``. Las **cargas** actúan en una -``direction`` como ``force`` (newtons en cada nodo elegido) o como -``displacement`` impuesto (metros desde la posición inicial; el solver fija esa -dirección). El valor sigue ``time_function``: ``constant`` (``value``), -``linear`` (``rate``), ``ramp`` (``rate`` hasta el tiempo ``until`` y luego -constante) o ``table`` (``times`` y ``values`` en unidades SI, lineal entre -puntos y constante fuera). - -Un bloque con ``reaction = true`` suma su fuerza a la reacción del ensayo (la -suma de las fuerzas de barra en sus direcciones fijas); si ninguno la pide, la -reacción es NaN. Un bloque que no elige ningún nodo es un error que lo nombra. -Los tres ensayos incorporados escritos así dan exactamente los mismos -resultados que sus clases. - -Ensayos disponibles -------------------- - -``testId = 101`` - Carga uniaxial: los nodos centrales de la última columna de módulos se - mueven en :math:`x` con velocidad impuesta. -``testId = 102`` - Viga con dos apoyos y dos puntos de carga. Las posiciones son parámetros de - ``ldem.scenarios.FourPointBending`` (``supportPosition``, ``loadPosition``, - en módulos desde cada extremo); los valores por defecto requieren una viga de - más de unos 70 módulos. Ver ``examples/beam_102``. -``testId = 103`` - Viga empotrada en los dos extremos, cargada a media luz con una fuerza que - crece linealmente y luego se mantiene constante - (``ldem.scenarios.ClampedBeam``). Es el único ensayo cargado con una fuerza - en lugar de un desplazamiento. Ver ``examples/example1_clamped_beam``. - -Para agregar un ensayo nuevo se crea una subclase de -``ldem.scenarios.Scenario``. - -Perturbación de la malla ------------------------- - -El parámetro ``meshPerturbation`` desplaza al azar los nodos interiores. Su -valor es la desviación estándar como fracción de la longitud del módulo: ``0`` -(el valor por defecto) deja el reticulado regular y cualquier valor positivo -activa la perturbación con ese valor. Los números aleatorios siguen a ``seed``. - -.. code-block:: matlab - - >> params = ldem.Parameters(testId=101, nModules=[6 3 3], meshPerturbation=0.02); - -Qué se obtiene: la estructura ``results`` ------------------------------------------ - -.. list-table:: - :header-rows: 1 - :widths: 22 78 - - * - Campo - - Contenido - * - ``info`` - - Versión de ldem, fecha, versión de MATLAB, tiempo de cálculo [s]. - * - ``params`` - - Los parámetros usados, como estructura simple (con valores derivados). - * - ``model`` - - Cantidades y masa del modelo: módulos, nodos, barras por tipo, grados de - libertad fijos, masa total y volumen. - * - ``material`` - - Datos del material (E, Gf, ...), coeficientes del reticulado, longitud - crítica y estadísticas de la deformación crítica (media, coeficiente de - variación, mínimo y máximo). - * - ``mesh`` - - Posiciones iniciales, apoyos (``fixed``), masas, barras, longitudes y - tipos de barra. - * - ``barProps`` - - Rigidez, deformación crítica y deformación de rotura de cada barra. - * - ``controlNodes`` - - Tiempo y desplazamiento, velocidad y aceleración de los nodos de control. - * - ``reactions`` - - Tiempo y fuerza de reacción ``[Rx Ry Rz]`` del ensayo: fuerza vertical en los puntos - de carga (ensayo 102), fuerza en los extremos empotrados (ensayo 103); ``NaN`` - donde el ensayo no la define. - * - ``energy`` - - Tiempo, energías cinética, elástica, de daño y de amortiguamiento [J], - su suma (``internal``), la energía de las barras rotas (``brokenBars``), el trabajo - externo, el balance (``balance``, externo menos interno) y la tasa de daño. - * - ``trackedBar`` - - Deformación, fuerza y energía de daño de una barra en cada paso - (opcional). - * - ``snapshots`` - - Paso, tiempo, número de barras intactas/dañadas/rotas y copias - compactas de los desplazamientos, del estado de daño y de la energía - cinética de cada nodo. - * - ``final`` - - Desplazamiento, velocidad, fuerza y estado de daño finales, y la energía - cinética de cada nodo. - -El ``balance`` de energía es una comprobación de la simulación: debe ser una -fracción pequeña (menos del 1 %) del trabajo externo final. La energía cinética -total es ``energy.kinetic``; la de cada nodo está en ``final.kineticEnergy``. - -``results.mat`` contiene esta estructura y se carga sin el paquete: - -.. code-block:: matlab - - >> data = load("output/results.mat"); - >> results = data.results; - -Archivos de salida ------------------- - -``results.mat`` - La estructura ``results`` (formato v7.3, legible desde Python con ``h5py``). -``snapshot_0000.mac``, ``snapshot_0001.mac``, ... - Macros de ANSYS con el reticulado deformado. Las barras son elementos de - tipo 1 (intactas), 2 (dañadas) y 5 (rotas). Los grados de libertad fijos - se listan como ``D,nodo,dirección`` y el desplazamiento impuesto a los - nodos cargados, medido desde su posición inicial, como - ``D,nodo,dirección,valor``. En el ensayo 103 las fuerzas aplicadas se listan como - ``F,nodo,dirección,valor``. -``snapshot_0000.vtu``, ... y ``snapshots.pvd`` - Archivos VTK. Abrir ``snapshots.pvd`` en `ParaView `_; - colorear por ``damageState`` (datos de celda) para ver las fisuras y usar - el control de tiempo para seguirlas. Desplazamiento y velocidad son datos - de nodo. - -Los archivos ANSYS y VTK se escriben en el tiempo cero y cada -``params.output.snapshotEvery`` pasos. - -Ejecutar los tests ------------------- - -.. code-block:: matlab - - >> addpath tests - >> run_tests % tests rápidos - >> run_tests(IncludeSlow=true) % también los tests lentos diff --git a/docs/source/examples.rst b/docs/source/examples.rst new file mode 100644 index 0000000..fc477e9 --- /dev/null +++ b/docs/source/examples.rst @@ -0,0 +1,311 @@ +Examples +======== + +The folder ``examples/`` has three models that run from start to finish, each +with its inputs and a script that runs it and plots the results. The numbers in +this page come from running them with the current code. + +.. list-table:: + :header-rows: 1 + :widths: 30 40 15 15 + + * - Folder + - What it shows + - Size + - Time + * - ``example1_clamped_beam/`` + - A beam clamped at both ends and loaded with a force at mid-span + - 3,086 nodes + - about 35 s + * - ``tension_101/`` + - A small prism under a uniaxial load, with damage and every output format + - 74 nodes + - about 6 s + * - ``beam_102/`` + - The four-point bending beam of the paper (a demo of its first 50 steps) + - 166,961 nodes + - about 30 s for 50 steps + +Start with ``tension_101`` to learn the interface and with +``example1_clamped_beam`` to see a model loaded with a force, described by a +case file and checked against the original code. + +Running an example +------------------ + +From MATLAB, from any folder: + +.. code-block:: matlab + + >> run('examples/example1_clamped_beam/runClampedBeam.m') % script: run and plot + >> results = ldem.run('examples/example1_clamped_beam/case.ldem'); % from the case file + +The two beam examples also have a ``case.ldem``: the same model in the readable +case-file format (see :doc:`usage`), generated from the ``DATA0.DAT`` of the +original program and giving the same parameters. ``ldem.check`` shows what a +case file would simulate without running it. + +The scripts write their files to a folder ``output`` next to the script (ignored +by git), or to ``outputFolder`` if that variable already exists: + +* ``results.mat``: one struct, ``results``, with everything that was recorded. + Load it with ``data = load('results.mat'); results = data.results;``. +* ``snapshot_0000.mac``, ...: ANSYS macro files of the deformed lattice. +* ``snapshot_0000.vtu``, ... and ``snapshots.pvd``: open ``snapshots.pvd`` in + `ParaView `_ to see the damage evolve in time. + +Example 1: beam clamped at both ends +------------------------------------ + +A small beam of 5 x 5 x 50 modules of 1 mm, clamped at both ends and loaded at +mid-span with a force that grows during 0.35 ms and then stays constant. It is +the model of Rodrigo (branch ``dev_rodrigo``) and the first test loaded with a +force instead of a displacement (``ldem.scenarios.ClampedBeam``, test 103). + +The model +~~~~~~~~~ + +.. list-table:: + :header-rows: 1 + :widths: 25 75 + + * - Part + - Value + * - Geometry + - 5 x 5 x 50 modules of 1 mm (a prism of 5 x 5 x 50 mm, axis along z), with + 3,086 nodes, 18,085 bars and a mass of 1.875 g + * - Supports + - The centre nodes of the first and of the last layer of modules (z = 0.5 and + z = 49.5 modules) are clamped: x, y and z held + * - Load + - The 5 centre nodes of the line at mid-span (z = 24.5 modules, y = 0.5 modules) + carry a force in +y of ``1000 N/s * min(t, 0.35 ms)`` each: 0.35 N per node, + 1.75 N in total + * - Material + - E = 3.87 GPa, Poisson's ratio 0.25, density 1500 kg/m\ :sup:`3`, fracture + energy 0.5 N/m, critical distance 4.5 mm; mass-proportional damping of + 2500 1/s + * - Scatter + - One multiplier of the critical strain per bar, read from a file (shared with + ``beam_102``) + * - Time + - 2.8 ms in 8000 steps of 0.35 us (65 % of the critical step) + * - Recorded + - Control nodes 2441 (a loaded node) and 884 (a grid node at mid-span); tracked + bar 14398 + +The original input file listed five control nodes, but nodes 6870 and 14398 do +not exist in this 3,086-node mesh, so the input keeps 2441 and 884. The tracked bar +is 14398, as in the original. + +Files +~~~~~ + +.. list-table:: + :header-rows: 1 + :widths: 30 70 + + * - File + - Purpose + * - ``case.ldem`` + - The model as a case file: run it with ``ldem.run`` + * - ``runClampedBeam.m`` + - Reads ``DATA0.DAT``, runs the simulation and plots the force on the clamped + ends, the vertical displacement of the control nodes and the energies + * - ``DATA0.DAT`` + - The parameters in the format of the original program (``TEST 103``) + +The scenario and the load are the lines of the ``[scenario]`` section of +``case.ldem``: + +.. code-block:: text + + [scenario] + type = "clamped_beam" + force_rate = 1000 N/s + ramp_time = 0.35 ms + load_position = "midspan" + load_height = 0.5 modules + +The same test can be written without a scenario class, with supports and loads. +It gives the same results as ``ldem.scenarios.ClampedBeam`` (the tests check it): + +.. code-block:: text + + [scenario] + type = "custom" + + [[support]] + name = "first end" + z = 0.5 + fix = ["x", "y", "z"] + reaction = true + + [[support]] + name = "last end" + z = "max - 0.5" + fix = ["x", "y", "z"] + reaction = true + + [[load]] + name = "line at mid-span" + y = 0.5 + z = "mid - 0.5" + direction = "y" + type = "force" + time_function = "ramp" + rate = 1000 N/s + until = 0.35 ms + +Reading the results +~~~~~~~~~~~~~~~~~~~ + +.. code-block:: matlab + + >> results = ldem.run('examples/example1_clamped_beam/case.ldem', OutputFolder=tempname); + >> y0 = results.mesh.nodes0(results.params.controlNodes, 2).'; + >> dy = results.controlNodes.displacement(:, :, 2) - y0; % vertical displacement [m] + >> results.reactions.force(end, :) % force on the clamped ends [N] + >> ldem.post.plotReaction(results); + >> ldem.post.plotEnergy(results); + +What you should see +~~~~~~~~~~~~~~~~~~~ + +.. figure:: _static/examples/clamped_beam_reaction.png + :width: 90% + + Force carried by the clamped ends. It rises with the load, overshoots to 1.94 N + and settles at the total applied force. + +.. figure:: _static/examples/clamped_beam_displacement.png + :width: 90% + + Vertical displacement of the two control nodes: a peak of 6.7 um at 0.46 ms and + about 6.3 um at the end. + +.. figure:: _static/examples/clamped_beam_energy.png + :width: 90% + + Energies. The external work equals the sum of the internal energies. + +* The reaction settles at 1.75 N, the 1.75 N applied in total: the beam is in + equilibrium at the end. The overshoot (1.94 N) and the oscillation are the + dynamic response, which the damping removes. +* With these values the beam stays elastic: at the end 18,085 bars are intact and + none is damaged or broken. +* The energy balance closes: the external work of 5.76 uJ is the elastic energy + (5.48 uJ) plus the energy dissipated by damping (0.28 uJ); the kinetic energy is + about zero and the balance is below 1e-13 J. + +Try other values +~~~~~~~~~~~~~~~~ + +Every key of the case file can be changed, or swept without editing the file +(see :doc:`usage`): + +.. code-block:: matlab + + >> summary = ldem.sweep('examples/example1_clamped_beam/case.ldem', ... + Vary = {'scenario.force_rate', ["10 kN/s" "30 kN/s" "100 kN/s"]}, Formats = "mat"); + +With the original value (1 kN/s) no bar is damaged. Ten times more force already +breaks the beam; each run takes about 50 s: + +.. list-table:: + :header-rows: 1 + :widths: 30 40 30 + + * - Force rate + - Damaged bars (including broken) + - Broken bars + * - 10 kN/s + - 5,630 + - 3,584 + * - 30 kN/s + - 6,074 + - 3,579 + * - 100 kN/s + - 4,760 + - 2,783 + +After the failure the loaded nodes keep being pushed by the force and move freely, +so the displacements of these runs are not meaningful; the damage counts are. Each run +has its own folder (``run_001``, ...) with its results and its resolved ``case.ldem``, +and the table is also saved as ``sweep_summary.csv``. + +Other changes to try in ``case.ldem``: ``law = "linear_elastic"`` (no damage at all), +``type = "generated"`` with a ``cv`` in ``[material.scatter]`` to generate the random +field in memory instead of reading it, or ``type = "none"`` to remove the scatter. + +Example: uniaxial prism +----------------------- + +``examples/tension_101/runTension.m`` runs a prism of 5 x 2 x 2 modules of 3 mm +(74 nodes, 313 bars) under the uniaxial test (test 101): the centre nodes of the +last column move along x with a prescribed velocity of 4 mm/s while those of the +first column are held. It is the best place to start: it has no input file, the +model is described in the script with ``ldem.Parameters``, and it writes every kind +of output. + +.. list-table:: + :header-rows: 1 + :widths: 25 75 + + * - Part + - Value + * - Material + - E = 32 GPa, Poisson's ratio 0.25, density 2000 kg/m\ :sup:`3`; a low fracture + energy of 0.1 N/m on purpose, so that bars soften and break + * - Time + - 0.2 ms in 1000 steps of 0.2 us + * - Output + - Snapshots (ANSYS and VTK) every 250 steps, control nodes and energies every 10 + steps, no tracked bar + +At the end 251 bars are intact, 58 are damaged and 4 are broken. The external work +is 24.7 uJ: 22.5 uJ of elastic energy, 2.2 uJ dissipated by damage and 0.03 uJ by +damping; the balance is 0.01 % of the external work. + +.. figure:: _static/examples/tension_energy.png + :width: 90% + + Energies of the uniaxial prism. + +With the sign convention of the original code a positive ``loadingVelocity`` moves +the loaded face toward the fixed one, that is, it compresses the prism; use a +negative value to pull it (see ``ldem.scenarios.UniaxialTension``). + +Example: four-point bending beam +-------------------------------- + +``examples/beam_102/runBeam.m`` reads the input of the beam of the paper (test 102, +``ldem.scenarios.FourPointBending``): 100 x 40 x 20 modules of 3 mm (300 x 120 x 60 +mm), 166,961 nodes and 1,126,960 bars. The beam rests on two supports 4.5 modules +from its ends and two load points 33.5 modules from its ends push its top face down +with a prescribed velocity of 4 mm/s. The material is E = 32 GPa, density 2000 +kg/m\ :sup:`3`, fracture energy 50 N/m, critical distance 28 mm, with a random field +of the critical strain read from a file. + +The real simulation has 150,000 steps (0.03 s in steps of 0.2 us) and needs roughly +20 hours on a laptop (about 0.5 s per step). The script therefore runs only the first +50 steps: it builds the complete model (about 20 s) and shows that the input is read +and the model runs; the plotted reaction is only that of the start of the test. Change +``nStepsDemo`` at the top of the script, or remove the ``totalTime`` override, for +the full run. + +.. list-table:: + :header-rows: 1 + :widths: 35 65 + + * - File + - Purpose + * - ``case.ldem`` + - The same parameters as a case file (``ldem.io.readCase``, ``ldem.run``) + * - ``DATA0.DAT`` + - Parameters in the format of the original program (``ldem.Parameters.fromFile``) + * - ``arquivo_3lc_rnao_cv05`` + - Random field applied to the critical strain of each bar (11 MB); it is also used + by ``example1_clamped_beam`` + * - ``runBeam.m`` + - Reads the input, runs the first 50 steps and plots the reaction force diff --git a/docs/source/index.rst b/docs/source/index.rst index c4544f1..b2ccc86 100644 --- a/docs/source/index.rst +++ b/docs/source/index.rst @@ -3,33 +3,21 @@ LDEM-MATLAB Lattice Discrete Element Method (LDEM) in MATLAB. -The documentation is written in English and translated into Spanish, -Portuguese and Italian. Use the language list in the sidebar of any page to -switch language; the same page is shown in the chosen language. +The documentation is written in English and translated into Spanish, Portuguese +and Italian. Choose the language in the sidebar of any page. .. toctree:: :maxdepth: 2 - :caption: English - - en/index - -.. toctree:: - :maxdepth: 2 - :caption: Español - - es/index - -.. toctree:: - :maxdepth: 2 - :caption: Português - - pt/index - -.. toctree:: - :maxdepth: 2 - :caption: Italiano - - it/index + :caption: User guide + + introduction + installation + usage + examples + model + contributing + docs + authors .. toctree:: :maxdepth: 2 diff --git a/docs/source/en/installation.rst b/docs/source/installation.rst similarity index 100% rename from docs/source/en/installation.rst rename to docs/source/installation.rst diff --git a/docs/source/en/introduction.rst b/docs/source/introduction.rst similarity index 78% rename from docs/source/en/introduction.rst rename to docs/source/introduction.rst index 11e2459..9d774ee 100644 --- a/docs/source/en/introduction.rst +++ b/docs/source/introduction.rst @@ -8,9 +8,11 @@ include damage/fracture, and the equations of motion are integrated with an explicit central-difference scheme. Energies (external, kinetic, elastic, dissipated) are tracked at every step. -Main parts of the ``ldem`` package (see :doc:`../api/index`): +Main parts of the ``ldem`` package (see :doc:`api/index`): -* ``ldem.Parameters`` / ``ldem.io.readInputFile`` – validated input data. +* ``ldem.Parameters`` / ``ldem.io.readCase`` / ``ldem.io.readInputFile`` – validated input data + (case files and the legacy ``DATA0.DAT``). +* ``ldem.run`` / ``ldem.sweep`` / ``ldem.check`` – run, sweep and check a case file. * ``ldem.mesh`` – nodes, bars, masses and bar geometry. * ``ldem.material`` – bar stiffness, critical strain and the bilinear damage law. * ``ldem.scenarios`` – supports, loads and reactions of each test. diff --git a/docs/source/it/authors.rst b/docs/source/it/authors.rst deleted file mode 100644 index 4d0bed5..0000000 --- a/docs/source/it/authors.rst +++ /dev/null @@ -1,18 +0,0 @@ -Autori -====== - -Questo elenco è generato automaticamente dai commit della cronologia di git -(le persone con lo stesso nome o e-mail sono unificate tramite ``.mailmap``) e -dagli autori di ``CITATION.cff``. Gli autori senza commit in questo repository -compaiono con ``-``. Lo stesso elenco è in ``AUTHORS.md``. - -.. include:: ../_generated/authors.rst - -Per aggiornarlo dopo nuovi commit, costruire la documentazione oppure -eseguire: - -.. code-block:: bash - - python docs/tools/generate_authors.py - -Se una persona compare due volte, aggiungere una riga a ``.mailmap``. diff --git a/docs/source/it/contributing.rst b/docs/source/it/contributing.rst deleted file mode 100644 index 6d591b1..0000000 --- a/docs/source/it/contributing.rst +++ /dev/null @@ -1,16 +0,0 @@ -Contribuire -=========== - -La documentazione dell'API è generata dai commenti dei ``.m``. Il docstring -deve essere il blocco di commenti posto **subito dopo** la riga ``function`` -(prima di qualsiasi ``global``). I commenti del codice sono scritti in -inglese. - -.. code-block:: matlab - - function ini = CALOAD() - % CALOAD Riepilogo in una riga. - % Descrizione più lunga. - global ... - -Vedi ``CONTRIBUTING.md`` nella radice del repository. diff --git a/docs/source/it/docs.rst b/docs/source/it/docs.rst deleted file mode 100644 index 7bba5c9..0000000 --- a/docs/source/it/docs.rst +++ /dev/null @@ -1,67 +0,0 @@ -Costruire questa documentazione -=============================== - -La documentazione è scritta in inglese e tradotta in spagnolo, portoghese e -italiano; le quattro versioni formano un unico sito e la barra laterale -permette di cambiare lingua. Il riferimento dell'API è generato dai commenti -dei ``.m``. - -Requisiti ---------- - -* Python 3.9 o successivo. -* ``git`` (l'elenco degli autori è generato dalla cronologia dei commit; con - un clone superficiale eseguire prima ``git fetch --unshallow``). -* MATLAB non è necessario; l'API viene letta dal testo dei sorgenti. - -.. code-block:: bash - - pip install -r docs/requirements.txt - -Costruzione ------------ - -Dalla radice del repository, con una qualsiasi di queste opzioni: - -.. code-block:: bash - - sphinx-build -W --keep-going -b html docs/source docs/build/html - -.. code-block:: bash - - cd docs && make html - -.. code-block:: matlab - - >> buildtool docs - -Aprire ``docs/build/html/index.html`` in un browser. ``-W`` trasforma gli -avvisi in errori: la documentazione deve essere costruita senza alcun avviso. -``buildtool clean`` elimina il risultato. - -Dove si trova ogni cosa ------------------------ - -``docs/source/en/`` - Il testo di riferimento, in inglese. -``docs/source/es/``, ``pt/``, ``it/`` - Traduzioni. Ogni pagina ha lo stesso nome di file che in ``en/``, così - l'elenco delle lingue nella barra laterale porta alla stessa pagina. -``docs/source/api/`` - Riferimento dell'API, generato dai commenti dei ``.m``. -``docs/tools/generate_authors.py`` - Scrive la pagina degli autori e ``AUTHORS.md`` (eseguito dalla costruzione). - -Scrivere o modificare una pagina --------------------------------- - -1. Modificare la pagina in inglese in ``docs/source/en/``. -2. Applicare la stessa modifica alle traduzioni. Una pagina nuova richiede un - file con lo stesso nome in ogni lingua e una voce in ogni ``index.rst``. -3. Costruire con ``-W`` e correggere ogni avviso. - -Pubblicazione -------------- - -Il workflow ``.github/workflows/docs.yml`` costruisce la documentazione a ogni -pull request e la pubblica su GitHub Pages quando cambia ``main``. diff --git a/docs/source/it/index.rst b/docs/source/it/index.rst deleted file mode 100644 index 722920e..0000000 --- a/docs/source/it/index.rst +++ /dev/null @@ -1,13 +0,0 @@ -Guida per l'utente -================== - -.. toctree:: - :maxdepth: 1 - - introduction - installation - usage - model - contributing - docs - authors diff --git a/docs/source/it/installation.rst b/docs/source/it/installation.rst deleted file mode 100644 index 1ca8b8d..0000000 --- a/docs/source/it/installation.rst +++ /dev/null @@ -1,37 +0,0 @@ -Installazione -============= - -Requisiti: MATLAB R2022b o successivo (sviluppato e testato su R2023b). Il -pacchetto usa il blocco ``arguments`` e la sintassi nome=valore; la suite di -test e ``buildtool`` richiedono R2022b. Non serve alcun toolbox. - -.. code-block:: bash - - git clone ldem-matlab - cd ldem-matlab - -.. code-block:: matlab - - >> setup_path - -Verificare l'installazione con i test rapidi: - -.. code-block:: matlab - - >> buildtool test - -Attività per sviluppatori (``buildtool`` si esegue dalla radice del -repository): - -.. code-block:: matlab - - >> buildtool % analisi statica + test rapidi (predefinito) - >> buildtool check % solo l'analizzatore di codice - >> buildtool testAll % tutti i test, compresi quelli lenti - >> buildtool docs % costruire questa documentazione (richiede Python) - >> buildtool clean % eliminare i file generati - -``buildtool test`` scrive ``test-results/results.xml`` (JUnit) e -``code-coverage/coverage.xml`` (Cobertura). - -Per costruire questa documentazione senza MATLAB vedi :doc:`docs`. diff --git a/docs/source/it/introduction.rst b/docs/source/it/introduction.rst deleted file mode 100644 index 5211352..0000000 --- a/docs/source/it/introduction.rst +++ /dev/null @@ -1,24 +0,0 @@ -Introduzione -============ - -Il **Metodo degli Elementi Discreti a Reticolo (LDEM)** modella un continuo -come un reticolo regolare di nodi collegati da barre disposte in moduli cubici -(spigoli più diagonali). Le masse sono concentrate nei nodi, le leggi -costitutive delle barre includono danno/frattura e le equazioni del moto sono -integrate con uno schema esplicito alle differenze centrali. Le energie -(esterna, cinetica, elastica, dissipata) sono monitorate a ogni passo. - -Parti principali del pacchetto ``ldem`` (vedi :doc:`../api/index`): - -* ``ldem.Parameters`` / ``ldem.io.readInputFile`` – dati di ingresso validati. -* ``ldem.mesh`` – nodi, barre, masse e geometria delle barre. -* ``ldem.material`` – rigidezza delle barre, deformazione critica e legge bilineare di danno. -* ``ldem.scenarios`` – vincoli, carichi e reazioni di ogni prova. -* ``ldem.solver`` – integrazione nel tempo e bilancio energetico. -* ``ldem.runSimulation`` – la simulazione completa, con uscita ``results.mat``, - ANSYS e VTK. - -Le routine del programma originale (``ini_DEM3``, ``read_dat0``, ``RMEC``, -``BOUND``, ``CALOAD``, ``ENERG2``, ...) sono conservate nella cronologia di -git, con il tag ``legacy-reference``; la riga ``Legacy:`` di ogni guida indica -la routine che sostituisce. diff --git a/docs/source/it/model.rst b/docs/source/it/model.rst deleted file mode 100644 index 31a5024..0000000 --- a/docs/source/it/model.rst +++ /dev/null @@ -1,117 +0,0 @@ -Costruire un modello diverso -============================ - -Un modello è definito da tre cose: la **geometria** del reticolo, il -**materiale** e la **prova** (vincoli e carichi). Le prime due sono parametri; -la terza è una classe *scenario*. Ciascuna si può cambiare senza toccare il -solver. - -1. Cambiare la geometria e il materiale ---------------------------------------- - -Tutto è una proprietà di ``ldem.Parameters``: - -.. code-block:: matlab - - >> params = ldem.Parameters(testId=101, ... - moduleLength=0.002, ... % spigolo del modulo cubico [m] - nModules=[21 6 6], ... % nodi in x, y e z - youngModulus=30e9, density=2400, poissonRatio=0.2, ... - fractureEnergy=80, criticalDistance=0.02, ... - meshPerturbation=0.02); % mesh irregolare (opzionale) - -* ``nModules = [M N L]`` è il numero di nodi della griglia lungo ogni asse, - quindi il prisma ha ``(M-1)*(N-1)*(L-1)`` moduli. -* ``randomFieldFile`` moltiplica la deformazione critica di ogni barra per un - valore letto da un file di testo (campo casuale della resistenza). -* ``randomFieldCv`` genera invece quel campo casuale in memoria, senza file: - valori di Weibull con media 1 e quel coefficiente di variazione su una - griglia di poli distanziati ``randomFieldCorrelationLength`` lunghezze di - modulo (3 per default), interpolati su ogni barra; ``randomFieldSeed`` fissa - i numeri casuali. Il valore di ogni barra resta in - ``results.barProps.randomField``. -* ``dt`` deve essere minore di ``params.criticalTimeStep``; ``Parameters`` - rifiuta un valore instabile e ne spiega il motivo. - -Gli stessi dati possono provenire da un file di ingresso nel formato del -programma originale: ``ldem.Parameters.fromFile("DATA0.DAT", ...)``; le -coppie nome=valore aggiuntive sostituiscono quelle del file. La mesh può -essere costruita e ispezionata prima di eseguire qualsiasi cosa: - -.. code-block:: matlab - - >> mesh = ldem.mesh.buildMesh(params); - >> fprintf("%d nodi, %d barre\n", size(mesh.nodes0, 1), size(mesh.bars, 1)); - -2. Cambiare la prova: scrivere uno scenario -------------------------------------------- - -Uno *scenario* dice quali gradi di libertà sono bloccati, come viene applicato -il carico a ogni passo di tempo e quale reazione viene riportata. Il solver -non controlla mai il numero della prova: lo chiede allo scenario. Per -modellare una prova nuova si crea una sottoclasse di -``ldem.scenarios.Scenario`` in ``src/+ldem/+scenarios/``. - -L'esempio è una trave a mensola lungo :math:`z`: il primo strato di nodi -centrali è incastrato e all'estremità libera si applica in :math:`y` una forza -che cresce linearmente. - -.. code-block:: matlab - - classdef Cantilever < ldem.scenarios.Scenario - properties (Constant) - testId = 104 % numero nuovo, univoco - end - properties - forceRate (1,1) double = 500 % [N/s] su ogni nodo caricato - end - methods - function fixed = fixedDofs(~, nodes0, params) - z = nodes0(:, 3); - atStart = abs(z - 0.5*params.moduleLength) < 0.01*params.moduleLength; - fixed = false(size(nodes0)); - fixed(atStart, :) = true; % x, y e z bloccati - end - function state = applyLoads(obj, state, mesh, params) - L1 = params.nModules(3) - 1; - z = mesh.nodes0(:, 3); - atEnd = abs(z - (L1 - 0.5)*params.moduleLength) < 0.01*params.moduleLength; - state.appliedForce(:) = 0; - state.appliedForce(atEnd, 2) = obj.forceRate * state.time; - end - end - end - -Regole: - -* ``fixedDofs`` restituisce una matrice logica ``nNodes`` per 3, vera dove il - nodo non può muoversi (``1 = x``, ``2 = y``, ``3 = z``). -* ``applyLoads`` viene eseguito a ogni passo. Una prova **a spostamento - controllato** assegna ``state.displacement`` dei nodi caricati (vedi - ``UniaxialTension``); una **a forza controllata** assegna - ``state.appliedForce`` in newton (vedi ``ClampedBeam``) e il solver ne conta - il lavoro nell'energia esterna. -* Ridefinire ``reactions`` se la prova riporta una forza di reazione - (predefinito: ``NaN``). -* I nodi centrali dei moduli si trovano a multipli semi-interi di - ``moduleLength``; selezionare i nodi con una piccola tolleranza, mai con - ``==``. - -3. Registrarlo ed eseguirlo ---------------------------- - -L'oggetto si può passare direttamente, senza registrare nulla: - -.. code-block:: matlab - - >> scenario = ldem.scenarios.Cantilever(forceRate=1000); - >> results = ldem.runSimulation(params, Scenario=scenario, ... - OutputFolder="output", Formats=["mat" "vtk"]); - -oppure aggiungerlo all'elenco di ``ldem.scenarios.fromTestId`` in modo che -``testId = 104`` lo trovi, come fa un file di ingresso. Poi si aggiunge un -test in ``tests/unit`` e, se è un caso di riferimento, un esempio in -``examples/`` (vedi ``examples/example1_clamped_beam``). - -Il risultato è la stessa struttura ``results`` di qualsiasi altra prova, vedi -:doc:`usage`. diff --git a/docs/source/it/usage.rst b/docs/source/it/usage.rst deleted file mode 100644 index 4f1e82f..0000000 --- a/docs/source/it/usage.rst +++ /dev/null @@ -1,367 +0,0 @@ -Uso -=== - -Eseguire una simulazione ------------------------- - -.. code-block:: matlab - - >> setup_path % aggiunge src/ al path di MATLAB - >> params = ldem.Parameters(testId=101, nModules=[6 3 3], totalTime=2e-4, ... - fractureEnergy=0.1, ... - output=struct('snapshotEvery', 250, 'controlNodesEvery', 10, ... - 'energyEvery', 10, 'trackedBarEvery', 0)); - >> results = ldem.runSimulation(params, OutputFolder="output", ... - Formats=["mat" "ansys" "vtk"]); - >> ldem.post.plotEnergy(results); - -``ldem.Parameters`` valida ogni valore quando viene assegnato e spiega cosa -non va (per esempio un passo di tempo instabile). La versione completa e -pronta all'uso è in ``examples/tension_101/runTension.m``. - -Per usare un file di ingresso nel formato del programma originale: - -.. code-block:: matlab - - >> params = ldem.Parameters.fromFile("DATA0.DAT"); - -File di caso (``.ldem``) ------------------------- - -Un *file di caso* descrive l'intero modello in un unico testo leggibile: chiavi -con nome invece di posizioni, unità accanto ai numeri, commenti, e la prova, la -dispersione casuale e i file di uscita insieme. Sostituisce ``DATA0.DAT``. - -.. code-block:: text - - format = 1 - title = "Piccola prova di trazione" - - [mesh] - module_size = 3 mm - modules = [5, 2, 2] # moduli cubici lungo x, y e z - - [material] - young_modulus = 32 GPa - density = 2000 kg/m3 - - [time] - step = auto # 0.9 volte il passo critico - duration = 40 us - - [scenario] - type = "uniaxial_tension" - - [output] - folder = "output" - -.. code-block:: matlab - - >> ldem.io.writeTemplate("mia_prova.ldem", "clamped_beam"); % file commentato da modificare - >> ldem.check("mia_prova.ldem") % valida e riferisce, senza simulare - >> results = ldem.run("mia_prova.ldem"); % la esegue - >> ldem.io.convertLegacyInput("DATA0.DAT", "caso.ldem"); % converte un vecchio file - -Regole del formato: - -* Le chiavi si leggono per **nome**; l'ordine delle righe non conta. Le chiavi - assenti prendono il valore predefinito di ``ldem.Parameters``. Sono - obbligatorie solo ``scenario.type``, ``mesh.modules`` e ``time.duration``. -* Un numero può avere un'**unità**: ``3.87 GPa``, ``0.35 us``, ``1500 kg/m3``, - ``2 kN/s``. Senza unità il valore è in SI. Un'unità sbagliata per la chiave è - un errore che elenca quelle valide. -* ``#`` inizia un commento, ``[sezione]`` apre una tabella, ``[[monitor.node]]`` - inizia l'elemento successivo di una tabella ripetuta e le liste si scrivono - ``[5, 5, 50]``. -* ``mesh.modules`` conta **moduli**: gli ``M N L`` di ``DATA0.DAT`` contano nodi, - uno in più. -* ``time.step = auto`` (o senza ``step``) prende 0.9 volte il passo critico. -* Ogni errore indica il file, la riga, la sezione e la chiave, e suggerisce il - nome valido più vicino se c'è un errore di battitura. -* I percorsi relativi (file del campo casuale, cartella di uscita) sono - relativi al file di caso. -* Si legge anche un file JSON con la stessa struttura (i valori con unità come - testo). - -.. list-table:: - :header-rows: 1 - :widths: 25 75 - - * - Sezione - - Chiavi - * - (inizio) - - ``format`` (1), ``title``, ``authors`` - * - ``[mesh]`` - - ``module_size``, ``modules``, ``perturbation`` (spostamento casuale dei - nodi, frazione del modulo), ``seed`` (della perturbazione) - * - ``[material]`` - - ``law`` (``bilinear``, la legge originale, o ``linear_elastic``: senza danno né - rottura), ``young_modulus``, ``poisson_ratio``, ``density``, - ``fracture_energy``, ``critical_distance``, ``failure_area_factor`` - * - ``[material.scatter]`` - - Dispersione della deformazione critica delle barre. ``type = "none"``; - ``"file"`` con ``file`` (un moltiplicatore per barra); oppure - ``"generated"`` con ``cv``, ``correlation_length`` (in moduli) e ``seed`` - (il campo è calcolato in memoria) - * - ``[time]`` - - ``step`` (o ``auto``), ``duration`` - * - ``[damping]`` - - ``type`` (``mass_proportional``, lo smorzamento originale, o ``none``), - ``initial``, ``final``, ``switch_time`` (non ammessi con ``none``), - ``constitutive`` - * - ``[scenario]`` - - ``type`` (``uniaxial_tension``, ``four_point_bending``, - ``clamped_beam`` o ``custom``, vedi sotto) e le proprietà di quello scenario in snake_case, per - esempio ``force_rate``, ``ramp_time``, ``load_position`` (è ammesso - ``"midspan"``) - * - ``[[monitor.node]]`` - - Un elemento per nodo di controllo: ``id`` (numero del nodo) oppure - ``at = [x, y, z]`` (posizione in moduli, si usa il nodo più vicino), e - ``name`` - * - ``[monitor.bar]`` - - ``tracked``: barra la cui storia di deformazione è salvata a ogni passo - * - ``[output]`` - - ``folder``, ``mat``, ``ansys``, ``vtk`` (true o false) - * - ``[output.snapshots]``, ``[output.control_nodes]``, ``[output.energy]`` - - ``every``: ``1000 steps`` o un tempo come ``0.1 ms`` (convertito in - passi); ``0`` significa mai - -``ldem.io.readCase`` restituisce i parametri, lo scenario e le opzioni di -uscita; ``ldem.Parameters.fromFile`` accetta anche un file di caso. L'elenco -delle chiavi è in un'unica tabella, ``ldem.schema.caseSchema``, che governa il -lettore, lo scrittore e il modello. Per aggiungere uno scenario si aggiunge una -riga a ``ldem.scenarios.registry``. Una nuova legge costitutiva è una sottoclasse -di ``ldem.material.MaterialLaw`` registrata in ``ldem.material.lawRegistry``; un -nuovo modello di smorzamento, una sottoclasse di ``ldem.solver.DampingModel`` -registrata in ``ldem.solver.dampingRegistry``. - -Riutilizzare un caso: extends ------------------------------ - -Un file di caso può partire da un altro e cambiare solo ciò che differisce: - -.. code-block:: text - - extends = "base.ldem" # or a list: ["base.ldem", "material.ldem"] - - [material] - fracture_energy = 1 N/m # only what changes - -Le chiavi del file sostituiscono quelle ereditate. Una tabella ripetuta -(``[[support]]``, ``[[load]]``, ``[[monitor.node]]``, ``[[sweep]]``) sostituisce -l'intero elenco ereditato. Quando cambia il ``type`` dello scenario, di -``[material.scatter]`` o di ``[damping]``, le chiavi del tipo precedente non -ridefinite vengono scartate. Con un elenco, i file successivi prevalgono. I -percorsi relativi (file del campo casuale, cartella di uscita) sono relativi al -file che li contiene, e un errore indica il file e la riga in cui il problema è -scritto. ``results.info.case.parents`` conserva l'hash di ogni file ereditato. - -Scansioni di parametri ----------------------- - -Per studiare come il risultato dipende da un valore, si elencano i valori in -blocchi ``[[sweep]]`` e si esegue ``ldem.sweep``: - -.. code-block:: text - - [[sweep]] - key = "material.fracture_energy" - values = ["0.1 N/m", "0.5 N/m", "1 N/m"] - - [[sweep]] - key = "time.duration" - values = ["20 us", "40 us"] - -.. code-block:: matlab - - >> summary = ldem.sweep("case.ldem"); % 3 x 2 = 6 runs, one folder each - >> ldem.sweep("case.ldem", DryRun=true); % only validate and list the runs - >> ldem.sweep("case.ldem", Vary={"scenario.force_rate", ["1 kN/s" "2 kN/s"]}); - >> results = ldem.run("case.ldem", Overrides=struct("path", "material.fracture_energy", "value", "2 N/m")); - -Più blocchi danno tutte le combinazioni; ``sweep_mode = "zip"`` (una chiave -all'inizio del file) li prende uno a uno. Si può variare qualsiasi chiave a -valore singolo, e quelle dello scenario come ``scenario.``. I valori -sono numeri o testi con unità. Ogni esecuzione viene validata prima di iniziare -la prima. Le esecuzioni vanno in ``run_001``, ``run_002``, ... (ciascuna con il -proprio ``case.ldem`` risolto) e la tabella ``sweep_summary.csv`` le elenca, con -il numero di barre danneggiate e rotte; un'esecuzione che fallisce viene -registrata e la scansione prosegue. - -Riferimento di tutte le chiavi ------------------------------- - -Le tabelle seguenti sono generate da ``ldem.schema.caseSchema``, la stessa -tabella usata dal lettore, quindi concordano sempre con esso. Le descrizioni -sono in inglese. - -.. include:: ../case-keys.inc - -La propria prova: appoggi e carichi ------------------------------------ - -Con ``type = "custom"`` la prova si descrive nel file di caso con blocchi -``[[support]]`` e ``[[load]]``, senza scrivere una classe. Questa è la prova -uniassiale (``testId = 101``) come blocchi: - -.. code-block:: text - - [scenario] - type = "custom" - - [[support]] - name = "left end" - x = 0.5 # the layer of centre nodes at x = 0.5 modules - fix = ["x"] # directions that cannot move - - [[load]] - name = "right end" - x = "max - 0.5" - direction = "x" - type = "displacement" # or "force" - time_function = "linear" - rate = -4 mm/s - reaction = true # its force is the reaction of the test - -I **nodi** si scelgono con ``nodes`` (``all``, ``grid`` per gli angoli dei -moduli o ``centre`` per i loro centri), ``ids`` (numeri di nodo) e ``x``, ``y``, -``z``. Una posizione è in moduli (i nodi centrali sono a semi-interi, quelli -d'angolo a interi), un intervallo ``[lo, hi]``, o un testo con i riferimenti -``min``, ``max`` e ``mid`` e uno scostamento, come ``"max - 0.5"``. Un nodo deve -soddisfare tutte le condizioni. Le posizioni si riferiscono al reticolo -regolare, quindi non cambiano quando ``mesh.perturbation`` sposta i nodi. - -Gli **appoggi** bloccano le direzioni di ``fix``. I **carichi** agiscono su una -``direction`` come ``force`` (newton su ogni nodo scelto) o come -``displacement`` imposto (metri dalla posizione iniziale; il solver blocca quella -direzione). Il valore segue ``time_function``: ``constant`` (``value``), -``linear`` (``rate``), ``ramp`` (``rate`` fino al tempo ``until``, poi costante) -o ``table`` (``times`` e ``values`` in unità SI, lineare tra i punti e costante -fuori). - -Un blocco con ``reaction = true`` aggiunge la sua forza alla reazione della prova -(la somma delle forze di barra nelle sue direzioni bloccate); se nessuno la -richiede, la reazione è NaN. Un blocco che non sceglie alcun nodo è un errore che -lo nomina. Le tre prove incorporate scritte così danno esattamente gli stessi -risultati delle loro classi. - -Prove disponibili ------------------ - -``testId = 101`` - Carico uniassiale: i nodi centrali dell'ultima colonna di moduli si - muovono in :math:`x` con velocità imposta. -``testId = 102`` - Trave con due appoggi e due punti di carico. Le posizioni sono parametri di - ``ldem.scenarios.FourPointBending`` (``supportPosition``, ``loadPosition``, - in moduli da ciascuna estremità); i valori predefiniti richiedono una trave - di oltre 70 moduli circa. Vedi ``examples/beam_102``. -``testId = 103`` - Trave incastrata alle due estremità, caricata in mezzeria con una forza che - cresce linearmente e poi resta costante (``ldem.scenarios.ClampedBeam``). È - l'unica prova caricata con una forza invece che con uno spostamento. Vedi - ``examples/example1_clamped_beam``. - -Per aggiungere una prova nuova si crea una sottoclasse di -``ldem.scenarios.Scenario`` (vedi :doc:`model`). - -Perturbazione della mesh ------------------------- - -Il parametro ``meshPerturbation`` sposta in modo casuale i nodi interni. Il -suo valore è la deviazione standard come frazione della lunghezza del modulo: -``0`` (il predefinito) mantiene il reticolo regolare e qualsiasi valore -positivo attiva la perturbazione con quel valore. I numeri casuali seguono -``seed``. - -.. code-block:: matlab - - >> params = ldem.Parameters(testId=101, nModules=[6 3 3], meshPerturbation=0.02); - -Cosa si ottiene: la struttura ``results`` ------------------------------------------ - -.. list-table:: - :header-rows: 1 - :widths: 22 78 - - * - Campo - - Contenuto - * - ``info`` - - Versione di ldem, data, versione di MATLAB, tempo di esecuzione [s]. - * - ``params`` - - I parametri usati, come struttura semplice (con i valori derivati). - * - ``model`` - - Conteggi e massa del modello: moduli, nodi, barre per tipo, gradi di - libertà bloccati, massa totale e volume. - * - ``material`` - - Dati del materiale (E, Gf, ...), coefficienti del reticolo, lunghezza - critica e statistiche della deformazione critica (media, coefficiente - di variazione, minimo e massimo). - * - ``mesh`` - - Posizioni iniziali dei nodi, vincoli (``fixed``), masse, barre, - lunghezze e tipi di barra. - * - ``barProps`` - - Rigidezza, deformazione critica e deformazione di rottura di ogni barra. - * - ``controlNodes`` - - Tempo e spostamento, velocità e accelerazione dei nodi di controllo. - * - ``reactions`` - - Tempo e forza di reazione ``[Rx Ry Rz]`` della prova: forza verticale - nei punti di carico (prova 102), forza alle estremità incastrate - (prova 103); ``NaN`` dove la prova non la definisce. - * - ``energy`` - - Tempo, energie cinetica, elastica, di danno e di smorzamento [J], la - loro somma (``internal``), l'energia delle barre rotte - (``brokenBars``), il lavoro esterno, il bilancio (``balance``, esterno - meno interno) e la velocità di danno. - * - ``trackedBar`` - - Deformazione, forza ed energia di danno di una barra a ogni passo - (opzionale). - * - ``snapshots`` - - Passo, tempo, numero di barre intatte/danneggiate/rotte e copie - compatte degli spostamenti, dello stato di danno e dell'energia - cinetica nodale nei passi salvati. - * - ``final`` - - Spostamento, velocità, forza e stato di danno finali, e l'energia - cinetica di ogni nodo. - -Il ``balance`` energetico è un controllo della simulazione: deve essere una -piccola frazione (meno dell'1 %) del lavoro esterno finale. L'energia cinetica -totale è ``energy.kinetic``; quella di ogni nodo è in ``final.kineticEnergy``. - -``results.mat`` contiene questa struttura e si carica senza il pacchetto: - -.. code-block:: matlab - - >> data = load("output/results.mat"); - >> results = data.results; - -File di uscita --------------- - -``results.mat`` - La struttura ``results`` (formato v7.3, leggibile da Python con ``h5py``). -``snapshot_0000.mac``, ``snapshot_0001.mac``, ... - Macro ANSYS con il reticolo deformato. Le barre sono elementi di tipo 1 - (intatte), 2 (danneggiate) e 5 (rotte). I gradi di libertà bloccati sono - elencati come ``D,nodo,direzione`` e lo spostamento imposto ai nodi - caricati, misurato dalla posizione iniziale, come - ``D,nodo,direzione,valore``. Nella prova 103 le forze applicate sono - elencate come ``F,nodo,direzione,valore``. -``snapshot_0000.vtu``, ... e ``snapshots.pvd`` - File VTK. Aprire ``snapshots.pvd`` in `ParaView `_; - colorare per ``damageState`` (dati di cella) per vedere le fessure e usare - il cursore del tempo per seguirle. Spostamento e velocità sono dati di - punto. - -I file ANSYS e VTK vengono scritti al tempo zero e ogni -``params.output.snapshotEvery`` passi. - -Eseguire i test ---------------- - -.. code-block:: matlab - - >> addpath tests - >> run_tests % test rapidi - >> run_tests(IncludeSlow=true) % anche i test lenti diff --git a/docs/source/en/model.rst b/docs/source/model.rst similarity index 94% rename from docs/source/en/model.rst rename to docs/source/model.rst index f69811e..4c44964 100644 --- a/docs/source/en/model.rst +++ b/docs/source/model.rst @@ -32,7 +32,8 @@ Everything is a property of ``ldem.Parameters``: * ``dt`` must be below ``params.criticalTimeStep``; ``Parameters`` rejects an unstable value and says so. -The same data can come from an input file in the format of the original +The same data can come from a case file (``ldem.io.readCase``, see +:doc:`usage`) or from an input file in the format of the original program with ``ldem.Parameters.fromFile("DATA0.DAT", ...)``; extra name=value pairs override the file. The mesh can be built and inspected before running anything: @@ -104,8 +105,8 @@ Either pass the object directly, with no registration: >> results = ldem.runSimulation(params, Scenario=scenario, ... OutputFolder="output", Formats=["mat" "vtk"]); -or add it to the list in ``ldem.scenarios.fromTestId`` so that -``testId = 104`` finds it, which is also what an input file does. Then add a +or add one line to ``ldem.scenarios.registry`` so that +``testId = 104`` finds it and a case file can name it with ``type``. Then add a test in ``tests/unit`` and, if it is a reference case, an example in ``examples/`` (see ``examples/example1_clamped_beam``). diff --git a/docs/source/pt/authors.rst b/docs/source/pt/authors.rst deleted file mode 100644 index f3fc683..0000000 --- a/docs/source/pt/authors.rst +++ /dev/null @@ -1,17 +0,0 @@ -Autores -======= - -Esta lista é gerada automaticamente a partir dos commits do histórico do git -(pessoas com o mesmo nome ou e-mail são unificadas com ``.mailmap``) e dos -autores de ``CITATION.cff``. Autores sem commits neste repositório aparecem -com ``-``. A mesma lista está em ``AUTHORS.md``. - -.. include:: ../_generated/authors.rst - -Para atualizá-la depois de novos commits, construa a documentação ou execute: - -.. code-block:: bash - - python docs/tools/generate_authors.py - -Se uma pessoa aparecer duas vezes, adicione uma linha ao ``.mailmap``. diff --git a/docs/source/pt/contributing.rst b/docs/source/pt/contributing.rst deleted file mode 100644 index 4576e89..0000000 --- a/docs/source/pt/contributing.rst +++ /dev/null @@ -1,16 +0,0 @@ -Contribuir -========== - -A documentação da API é gerada a partir dos comentários dos ``.m``. O -docstring deve ser o bloco de comentários colocado **imediatamente depois** da -linha ``function`` (antes de qualquer ``global``). Os comentários do código -são escritos em inglês. - -.. code-block:: matlab - - function ini = CALOAD() - % CALOAD Resumo em uma linha. - % Descrição mais longa. - global ... - -Veja ``CONTRIBUTING.md`` na raiz do repositório. diff --git a/docs/source/pt/docs.rst b/docs/source/pt/docs.rst deleted file mode 100644 index 86545fd..0000000 --- a/docs/source/pt/docs.rst +++ /dev/null @@ -1,68 +0,0 @@ -Construir esta documentação -=========================== - -A documentação é escrita em inglês e traduzida para espanhol, português e -italiano; as quatro versões formam um único site e a barra lateral permite -trocar de idioma. A referência da API é gerada a partir dos comentários dos -``.m``. - -Requisitos ----------- - -* Python 3.9 ou superior. -* ``git`` (a lista de autores é gerada a partir do histórico de commits; com um - clone superficial execute antes ``git fetch --unshallow``). -* Não é necessário MATLAB; a API é lida do texto das fontes. - -.. code-block:: bash - - pip install -r docs/requirements.txt - -Construção ----------- - -A partir da raiz do repositório, com qualquer uma destas opções: - -.. code-block:: bash - - sphinx-build -W --keep-going -b html docs/source docs/build/html - -.. code-block:: bash - - cd docs && make html - -.. code-block:: matlab - - >> buildtool docs - -Abra ``docs/build/html/index.html`` em um navegador. ``-W`` transforma os -avisos em erros: a documentação deve ser construída sem nenhum. -``buildtool clean`` apaga o resultado. - -Onde fica cada coisa --------------------- - -``docs/source/en/`` - O texto de referência, em inglês. -``docs/source/es/``, ``pt/``, ``it/`` - Traduções. Cada página tem o mesmo nome de arquivo que em ``en/`` para que - a lista de idiomas da barra lateral leve à mesma página. -``docs/source/api/`` - Referência da API, gerada a partir dos comentários dos ``.m``. -``docs/tools/generate_authors.py`` - Escreve a página de autores e ``AUTHORS.md`` (executado pela construção). - -Escrever ou alterar uma página ------------------------------- - -1. Edite a página em inglês em ``docs/source/en/``. -2. Aplique a mesma alteração às traduções. Uma página nova precisa de um - arquivo com o mesmo nome em cada idioma e de uma entrada em cada - ``index.rst``. -3. Construa com ``-W`` e corrija qualquer aviso. - -Publicação ----------- - -O workflow ``.github/workflows/docs.yml`` constrói a documentação a cada pull -request e a publica no GitHub Pages quando ``main`` muda. diff --git a/docs/source/pt/index.rst b/docs/source/pt/index.rst deleted file mode 100644 index 926cd52..0000000 --- a/docs/source/pt/index.rst +++ /dev/null @@ -1,13 +0,0 @@ -Guia do usuário -=============== - -.. toctree:: - :maxdepth: 1 - - introduction - installation - usage - model - contributing - docs - authors diff --git a/docs/source/pt/installation.rst b/docs/source/pt/installation.rst deleted file mode 100644 index 83da9d4..0000000 --- a/docs/source/pt/installation.rst +++ /dev/null @@ -1,37 +0,0 @@ -Instalação -========== - -Requisitos: MATLAB R2022b ou superior (desenvolvido e testado na R2023b). O -pacote usa o bloco ``arguments`` e a sintaxe nome=valor; a suíte de testes e o -``buildtool`` exigem a R2022b. Nenhum toolbox é necessário. - -.. code-block:: bash - - git clone ldem-matlab - cd ldem-matlab - -.. code-block:: matlab - - >> setup_path - -Verifique a instalação com os testes rápidos: - -.. code-block:: matlab - - >> buildtool test - -Tarefas para desenvolvedores (``buildtool`` é executado a partir da raiz do -repositório): - -.. code-block:: matlab - - >> buildtool % análise estática + testes rápidos (padrão) - >> buildtool check % somente o analisador de código - >> buildtool testAll % todos os testes, inclusive os lentos - >> buildtool docs % construir esta documentação (requer Python) - >> buildtool clean % apagar os arquivos gerados - -``buildtool test`` escreve ``test-results/results.xml`` (JUnit) e -``code-coverage/coverage.xml`` (Cobertura). - -Para construir esta documentação sem MATLAB, veja :doc:`docs`. diff --git a/docs/source/pt/introduction.rst b/docs/source/pt/introduction.rst deleted file mode 100644 index e3605b7..0000000 --- a/docs/source/pt/introduction.rst +++ /dev/null @@ -1,24 +0,0 @@ -Introdução -========== - -O **Método dos Elementos Discretos tipo Treliça (LDEM)** modela um contínuo -como um reticulado regular de nós ligados por barras dispostas em módulos -cúbicos (arestas mais diagonais). As massas são concentradas nos nós, as leis -constitutivas das barras incluem dano/fratura e as equações de movimento são -integradas com um esquema explícito de diferenças centrais. As energias -(externa, cinética, elástica, dissipada) são acompanhadas a cada passo. - -Principais partes do pacote ``ldem`` (ver :doc:`../api/index`): - -* ``ldem.Parameters`` / ``ldem.io.readInputFile`` – dados de entrada validados. -* ``ldem.mesh`` – nós, barras, massas e geometria das barras. -* ``ldem.material`` – rigidez das barras, deformação crítica e lei bilinear de dano. -* ``ldem.scenarios`` – apoios, cargas e reações de cada ensaio. -* ``ldem.solver`` – integração no tempo e balanço de energia. -* ``ldem.runSimulation`` – a simulação completa, com saída ``results.mat``, - ANSYS e VTK. - -As rotinas do programa original (``ini_DEM3``, ``read_dat0``, ``RMEC``, -``BOUND``, ``CALOAD``, ``ENERG2``, ...) são mantidas no histórico do git, com -a tag ``legacy-reference``; a linha ``Legacy:`` de cada ajuda indica a rotina -que ela substitui. diff --git a/docs/source/pt/model.rst b/docs/source/pt/model.rst deleted file mode 100644 index 378fadb..0000000 --- a/docs/source/pt/model.rst +++ /dev/null @@ -1,116 +0,0 @@ -Construir um modelo diferente -============================= - -Um modelo é definido por três coisas: a **geometria** do reticulado, o -**material** e o **ensaio** (apoios e cargas). As duas primeiras são -parâmetros; a terceira é uma classe *cenário*. Qualquer uma pode ser alterada -sem tocar no solver. - -1. Alterar a geometria e o material ------------------------------------ - -Tudo é uma propriedade de ``ldem.Parameters``: - -.. code-block:: matlab - - >> params = ldem.Parameters(testId=101, ... - moduleLength=0.002, ... % aresta do módulo cúbico [m] - nModules=[21 6 6], ... % nós em x, y e z - youngModulus=30e9, density=2400, poissonRatio=0.2, ... - fractureEnergy=80, criticalDistance=0.02, ... - meshPerturbation=0.02); % malha irregular (opcional) - -* ``nModules = [M N L]`` é o número de nós da grade em cada eixo, de modo que - o prisma tem ``(M-1)*(N-1)*(L-1)`` módulos. -* ``randomFieldFile`` multiplica a deformação crítica de cada barra por um - valor lido de um arquivo de texto (campo aleatório da resistência). -* ``randomFieldCv`` gera esse campo aleatório na memória, sem arquivo: valores - Weibull com média 1 e esse coeficiente de variação numa grade de polos - espaçados ``randomFieldCorrelationLength`` comprimentos de módulo (3 por - padrão), interpolados para cada barra; ``randomFieldSeed`` fixa os números - aleatórios. O valor de cada barra fica em ``results.barProps.randomField``. -* ``dt`` deve ser menor que ``params.criticalTimeStep``; ``Parameters`` - rejeita um valor instável e explica o motivo. - -Os mesmos dados podem vir de um arquivo de entrada no formato do programa -original: ``ldem.Parameters.fromFile("DATA0.DAT", ...)``; os pares -nome=valor adicionais substituem os do arquivo. A malha pode ser construída e -inspecionada antes de executar qualquer coisa: - -.. code-block:: matlab - - >> mesh = ldem.mesh.buildMesh(params); - >> fprintf("%d nós, %d barras\n", size(mesh.nodes0, 1), size(mesh.bars, 1)); - -2. Alterar o ensaio: escrever um cenário ----------------------------------------- - -Um *cenário* diz quais graus de liberdade estão fixos, como a carga é -aplicada a cada passo de tempo e qual reação é informada. O solver nunca -consulta o número do ensaio; ele pergunta ao cenário. Para modelar um ensaio -novo, crie uma subclasse de ``ldem.scenarios.Scenario`` em -``src/+ldem/+scenarios/``. - -O exemplo é uma viga em balanço segundo :math:`z`: a primeira camada de nós -centrais é engastada e, na extremidade livre, aplica-se em :math:`y` uma força -que cresce linearmente. - -.. code-block:: matlab - - classdef Cantilever < ldem.scenarios.Scenario - properties (Constant) - testId = 104 % número novo, único - end - properties - forceRate (1,1) double = 500 % [N/s] em cada nó carregado - end - methods - function fixed = fixedDofs(~, nodes0, params) - z = nodes0(:, 3); - atStart = abs(z - 0.5*params.moduleLength) < 0.01*params.moduleLength; - fixed = false(size(nodes0)); - fixed(atStart, :) = true; % x, y e z fixos - end - function state = applyLoads(obj, state, mesh, params) - L1 = params.nModules(3) - 1; - z = mesh.nodes0(:, 3); - atEnd = abs(z - (L1 - 0.5)*params.moduleLength) < 0.01*params.moduleLength; - state.appliedForce(:) = 0; - state.appliedForce(atEnd, 2) = obj.forceRate * state.time; - end - end - end - -Regras: - -* ``fixedDofs`` devolve uma matriz lógica de ``nNodes`` por 3, verdadeira onde - o nó não pode se mover (``1 = x``, ``2 = y``, ``3 = z``). -* ``applyLoads`` é executado a cada passo. Um ensaio **controlado por - deslocamento** atribui ``state.displacement`` dos nós carregados (ver - ``UniaxialTension``); um **controlado por força** atribui - ``state.appliedForce`` em newtons (ver ``ClampedBeam``) e o solver conta seu - trabalho na energia externa. -* Redefina ``reactions`` se o ensaio informar uma força de reação (padrão: - ``NaN``). -* Os nós centrais dos módulos estão em múltiplos semi-inteiros de - ``moduleLength``; selecione os nós com uma tolerância pequena, nunca com - ``==``. - -3. Registrar e executar ------------------------ - -O objeto pode ser passado diretamente, sem registrar nada: - -.. code-block:: matlab - - >> scenario = ldem.scenarios.Cantilever(forceRate=1000); - >> results = ldem.runSimulation(params, Scenario=scenario, ... - OutputFolder="output", Formats=["mat" "vtk"]); - -ou adicioná-lo à lista de ``ldem.scenarios.fromTestId`` para que -``testId = 104`` o encontre, que é o que faz um arquivo de entrada. Depois, -adicione um teste em ``tests/unit`` e, se for um caso de referência, um -exemplo em ``examples/`` (ver ``examples/example1_clamped_beam``). - -O resultado é a mesma estrutura ``results`` de qualquer outro ensaio, ver -:doc:`usage`. diff --git a/docs/source/pt/usage.rst b/docs/source/pt/usage.rst deleted file mode 100644 index 7ff4f0a..0000000 --- a/docs/source/pt/usage.rst +++ /dev/null @@ -1,368 +0,0 @@ -Uso -=== - -Executar uma simulação ----------------------- - -.. code-block:: matlab - - >> setup_path % adiciona src/ ao path do MATLAB - >> params = ldem.Parameters(testId=101, nModules=[6 3 3], totalTime=2e-4, ... - fractureEnergy=0.1, ... - output=struct('snapshotEvery', 250, 'controlNodesEvery', 10, ... - 'energyEvery', 10, 'trackedBarEvery', 0)); - >> results = ldem.runSimulation(params, OutputFolder="output", ... - Formats=["mat" "ansys" "vtk"]); - >> ldem.post.plotEnergy(results); - -``ldem.Parameters`` valida cada valor ao atribuí-lo e explica o que está -errado (por exemplo, um passo de tempo instável). A versão completa e pronta -para executar está em ``examples/tension_101/runTension.m``. - -Para usar um arquivo de entrada no formato do programa original: - -.. code-block:: matlab - - >> params = ldem.Parameters.fromFile("DATA0.DAT"); - -Arquivos de caso (``.ldem``) ----------------------------- - -Um *arquivo de caso* descreve todo o modelo em um único texto legível: chaves -com nome em vez de posições, unidades junto aos números, comentários, e o -ensaio, a dispersão aleatória e os arquivos de saída juntos. Ele substitui o -``DATA0.DAT``. - -.. code-block:: text - - format = 1 - title = "Pequeno ensaio de tração" - - [mesh] - module_size = 3 mm - modules = [5, 2, 2] # módulos cúbicos em x, y e z - - [material] - young_modulus = 32 GPa - density = 2000 kg/m3 - - [time] - step = auto # 0.9 vezes o passo crítico - duration = 40 us - - [scenario] - type = "uniaxial_tension" - - [output] - folder = "output" - -.. code-block:: matlab - - >> ldem.io.writeTemplate("meu_ensaio.ldem", "clamped_beam"); % arquivo comentado para editar - >> ldem.check("meu_ensaio.ldem") % valida e informa, sem simular - >> results = ldem.run("meu_ensaio.ldem"); % executa - >> ldem.io.convertLegacyInput("DATA0.DAT", "caso.ldem"); % converte um arquivo antigo - -Regras do formato: - -* As chaves são lidas por **nome**; a ordem das linhas não importa. As chaves - ausentes assumem o valor padrão de ``ldem.Parameters``. Só são obrigatórias - ``scenario.type``, ``mesh.modules`` e ``time.duration``. -* Um número pode ter **unidade**: ``3.87 GPa``, ``0.35 us``, ``1500 kg/m3``, - ``2 kN/s``. Sem unidade o valor está em SI. Uma unidade incorreta para a - chave é um erro que lista as válidas. -* ``#`` inicia um comentário, ``[seção]`` abre uma tabela, ``[[monitor.node]]`` - inicia o próximo elemento de uma tabela repetida e as listas são escritas - ``[5, 5, 50]``. -* ``mesh.modules`` conta **módulos**: os ``M N L`` do ``DATA0.DAT`` contam nós, - um a mais. -* ``time.step = auto`` (ou sem ``step``) assume 0.9 vez o passo crítico. -* Cada erro indica o arquivo, a linha, a seção e a chave, e sugere o nome - válido mais parecido quando há erro de digitação. -* Os caminhos relativos (arquivo do campo aleatório, pasta de saída) são - relativos ao arquivo de caso. -* Também é lido um arquivo JSON com a mesma estrutura (os valores com unidades, - como texto). - -.. list-table:: - :header-rows: 1 - :widths: 25 75 - - * - Seção - - Chaves - * - (início) - - ``format`` (1), ``title``, ``authors`` - * - ``[mesh]`` - - ``module_size``, ``modules``, ``perturbation`` (deslocamento aleatório - dos nós, fração do módulo), ``seed`` (da perturbação) - * - ``[material]`` - - ``law`` (``bilinear``, a lei original, ou ``linear_elastic``: sem dano nem - ruptura), ``young_modulus``, ``poisson_ratio``, ``density``, - ``fracture_energy``, ``critical_distance``, ``failure_area_factor`` - * - ``[material.scatter]`` - - Dispersão da deformação crítica das barras. ``type = "none"``; - ``"file"`` com ``file`` (um multiplicador por barra); ou ``"generated"`` - com ``cv``, ``correlation_length`` (em módulos) e ``seed`` (o campo é - calculado na memória) - * - ``[time]`` - - ``step`` (ou ``auto``), ``duration`` - * - ``[damping]`` - - ``type`` (``mass_proportional``, o amortecimento original, ou ``none``), - ``initial``, ``final``, ``switch_time`` (não aceitos com ``none``), - ``constitutive`` - * - ``[scenario]`` - - ``type`` (``uniaxial_tension``, ``four_point_bending``, - ``clamped_beam`` ou ``custom``, veja abaixo) e as propriedades desse cenário em snake_case, por - exemplo ``force_rate``, ``ramp_time``, ``load_position`` (é aceito - ``"midspan"``) - * - ``[[monitor.node]]`` - - Um elemento por nó de controle: ``id`` (número do nó) ou - ``at = [x, y, z]`` (posição em módulos, usa-se o nó mais próximo), e - ``name`` - * - ``[monitor.bar]`` - - ``tracked``: barra cuja história de deformação é guardada a cada passo - * - ``[output]`` - - ``folder``, ``mat``, ``ansys``, ``vtk`` (true ou false) - * - ``[output.snapshots]``, ``[output.control_nodes]``, ``[output.energy]`` - - ``every``: ``1000 steps`` ou um tempo como ``0.1 ms`` (convertido em - passos); ``0`` significa nunca - -``ldem.io.readCase`` devolve os parâmetros, o cenário e as opções de saída; -``ldem.Parameters.fromFile`` também aceita um arquivo de caso. A lista de chaves -está em uma única tabela, ``ldem.schema.caseSchema``, que governa o leitor, o -escritor e o modelo. Para adicionar um cenário, adiciona-se uma linha a -``ldem.scenarios.registry``. Uma nova lei constitutiva é uma subclasse de -``ldem.material.MaterialLaw`` registrada em ``ldem.material.lawRegistry``; um novo -modelo de amortecimento, uma subclasse de ``ldem.solver.DampingModel`` registrada -em ``ldem.solver.dampingRegistry``. - -Reutilizar um caso: extends ---------------------------- - -Um arquivo de caso pode partir de outro e mudar só o que difere: - -.. code-block:: text - - extends = "base.ldem" # or a list: ["base.ldem", "material.ldem"] - - [material] - fracture_energy = 1 N/m # only what changes - -As chaves do arquivo substituem as herdadas. Uma tabela repetida -(``[[support]]``, ``[[load]]``, ``[[monitor.node]]``, ``[[sweep]]``) substitui -toda a lista herdada. Quando muda o ``type`` do cenário, de -``[material.scatter]`` ou de ``[damping]``, as chaves do tipo anterior que não -são definidas de novo são descartadas. Com uma lista, os últimos arquivos -vencem. Os caminhos relativos (arquivo do campo aleatório, pasta de saída) são -relativos ao arquivo que os contém, e um erro indica o arquivo e a linha onde o -problema está escrito. ``results.info.case.parents`` guarda o hash de cada -arquivo herdado. - -Varreduras de parâmetros ------------------------- - -Para estudar como o resultado depende de um valor, listam-se os valores em -blocos ``[[sweep]]`` e executa-se ``ldem.sweep``: - -.. code-block:: text - - [[sweep]] - key = "material.fracture_energy" - values = ["0.1 N/m", "0.5 N/m", "1 N/m"] - - [[sweep]] - key = "time.duration" - values = ["20 us", "40 us"] - -.. code-block:: matlab - - >> summary = ldem.sweep("case.ldem"); % 3 x 2 = 6 runs, one folder each - >> ldem.sweep("case.ldem", DryRun=true); % only validate and list the runs - >> ldem.sweep("case.ldem", Vary={"scenario.force_rate", ["1 kN/s" "2 kN/s"]}); - >> results = ldem.run("case.ldem", Overrides=struct("path", "material.fracture_energy", "value", "2 N/m")); - -Vários blocos dão todas as combinações; ``sweep_mode = "zip"`` (uma chave no -início do arquivo) toma-os um a um. Pode-se variar qualquer chave de valor -único, e as do cenário como ``scenario.``. Os valores são números ou -textos com unidades. Cada execução é validada antes de começar a primeira. As -execuções vão para ``run_001``, ``run_002``, ... (cada uma com o seu -``case.ldem`` resolvido) e a tabela ``sweep_summary.csv`` as lista, com o número -de barras danificadas e rompidas; uma execução que falha fica registrada e a -varredura continua. - -Referência de todas as chaves ------------------------------ - -As tabelas a seguir são geradas a partir de ``ldem.schema.caseSchema``, a mesma -tabela que o leitor usa, portanto sempre coincidem com ele. As descrições estão -em inglês. - -.. include:: ../case-keys.inc - -O seu próprio ensaio: apoios e cargas --------------------------------------- - -Com ``type = "custom"`` o ensaio é descrito no arquivo de caso com blocos -``[[support]]`` e ``[[load]]``, sem escrever uma classe. Este é o ensaio -uniaxial (``testId = 101``) como blocos: - -.. code-block:: text - - [scenario] - type = "custom" - - [[support]] - name = "left end" - x = 0.5 # the layer of centre nodes at x = 0.5 modules - fix = ["x"] # directions that cannot move - - [[load]] - name = "right end" - x = "max - 0.5" - direction = "x" - type = "displacement" # or "force" - time_function = "linear" - rate = -4 mm/s - reaction = true # its force is the reaction of the test - -Os **nós** são escolhidos com ``nodes`` (``all``, ``grid`` para os cantos dos -módulos ou ``centre`` para os seus centros), ``ids`` (números de nó) e ``x``, -``y``, ``z``. Uma posição é em módulos (os nós centrais ficam em semi-inteiros, -os de canto em inteiros), um intervalo ``[lo, hi]``, ou um texto com as -referências ``min``, ``max`` e ``mid`` e um deslocamento, como ``"max - 0.5"``. -Um nó deve satisfazer todas as condições. As posições referem-se à malha -regular, portanto não mudam quando ``mesh.perturbation`` move os nós. - -Os **apoios** fixam as direções de ``fix``. As **cargas** atuam em uma -``direction`` como ``force`` (newtons em cada nó escolhido) ou como -``displacement`` imposto (metros a partir da posição inicial; o solver fixa essa -direção). O valor segue ``time_function``: ``constant`` (``value``), ``linear`` -(``rate``), ``ramp`` (``rate`` até o tempo ``until``, depois constante) ou -``table`` (``times`` e ``values`` em unidades SI, linear entre pontos e constante -fora). - -Um bloco com ``reaction = true`` soma sua força à reação do ensaio (a soma das -forças de barra nas suas direções fixas); se nenhum a pedir, a reação é NaN. Um -bloco que não escolhe nenhum nó é um erro que o nomeia. Os três ensaios -incorporados escritos assim dão exatamente os mesmos resultados que as suas -classes. - -Ensaios disponíveis -------------------- - -``testId = 101`` - Carga uniaxial: os nós centrais da última coluna de módulos se movem em - :math:`x` com velocidade imposta. -``testId = 102`` - Viga com dois apoios e dois pontos de carga. As posições são parâmetros de - ``ldem.scenarios.FourPointBending`` (``supportPosition``, ``loadPosition``, - em módulos a partir de cada extremidade); os valores padrão exigem uma viga - com mais de uns 70 módulos. Ver ``examples/beam_102``. -``testId = 103`` - Viga engastada nas duas extremidades, carregada no meio do vão com uma - força que cresce linearmente e depois se mantém constante - (``ldem.scenarios.ClampedBeam``). É o único ensaio carregado com força em - vez de deslocamento. Ver ``examples/example1_clamped_beam``. - -Para adicionar um ensaio novo, crie uma subclasse de -``ldem.scenarios.Scenario`` (ver :doc:`model`). - -Perturbação da malha --------------------- - -O parâmetro ``meshPerturbation`` desloca aleatoriamente os nós interiores. Seu -valor é o desvio padrão como fração do comprimento do módulo: ``0`` (o padrão) -mantém o reticulado regular e qualquer valor positivo ativa a perturbação com -esse valor. Os números aleatórios seguem ``seed``. - -.. code-block:: matlab - - >> params = ldem.Parameters(testId=101, nModules=[6 3 3], meshPerturbation=0.02); - -O que se obtém: a estrutura ``results`` ---------------------------------------- - -.. list-table:: - :header-rows: 1 - :widths: 22 78 - - * - Campo - - Conteúdo - * - ``info`` - - Versão do ldem, data, versão do MATLAB, tempo de execução [s]. - * - ``params`` - - Os parâmetros usados, como estrutura simples (com valores derivados). - * - ``model`` - - Contagens e massa do modelo: módulos, nós, barras por tipo, graus de - liberdade fixos, massa total e volume. - * - ``material`` - - Dados do material (E, Gf, ...), coeficientes do reticulado, comprimento - crítico e estatísticas da deformação crítica (média, coeficiente de - variação, mínimo e máximo). - * - ``mesh`` - - Posições iniciais dos nós, apoios (``fixed``), massas, barras, - comprimentos e tipos de barra. - * - ``barProps`` - - Rigidez, deformação crítica e deformação de ruptura de cada barra. - * - ``controlNodes`` - - Tempo e deslocamento, velocidade e aceleração dos nós de controle. - * - ``reactions`` - - Tempo e força de reação ``[Rx Ry Rz]`` do ensaio: força vertical nos - pontos de carga (ensaio 102), força nas extremidades engastadas - (ensaio 103); ``NaN`` onde o ensaio não a define. - * - ``energy`` - - Tempo, energias cinética, elástica, de dano e de amortecimento [J], sua - soma (``internal``), a energia das barras rompidas (``brokenBars``), o - trabalho externo, o balanço (``balance``, externo menos interno) e a - taxa de dano. - * - ``trackedBar`` - - Deformação, força e energia de dano de uma barra a cada passo - (opcional). - * - ``snapshots`` - - Passo, tempo, número de barras intactas/danificadas/rompidas e cópias - compactas dos deslocamentos, do estado de dano e da energia cinética - nodal nos passos salvos. - * - ``final`` - - Deslocamento, velocidade, força e estado de dano finais, e a energia - cinética de cada nó. - -O ``balance`` de energia é uma verificação da simulação: deve ser uma fração -pequena (menos de 1 %) do trabalho externo final. A energia cinética total é -``energy.kinetic``; a de cada nó está em ``final.kineticEnergy``. - -``results.mat`` contém esta estrutura e carrega-se sem o pacote: - -.. code-block:: matlab - - >> data = load("output/results.mat"); - >> results = data.results; - -Arquivos de saída ------------------ - -``results.mat`` - A estrutura ``results`` (formato v7.3, legível em Python com ``h5py``). -``snapshot_0000.mac``, ``snapshot_0001.mac``, ... - Macros do ANSYS com o reticulado deformado. As barras são elementos do tipo - 1 (intactas), 2 (danificadas) e 5 (rompidas). Os graus de liberdade fixos - são listados como ``D,nó,direção`` e o deslocamento imposto aos nós - carregados, medido a partir da posição inicial, como - ``D,nó,direção,valor``. No ensaio 103 as forças aplicadas são listadas como - ``F,nó,direção,valor``. -``snapshot_0000.vtu``, ... e ``snapshots.pvd`` - Arquivos VTK. Abra ``snapshots.pvd`` no `ParaView `_; - colora por ``damageState`` (dados de célula) para ver as fissuras e use o - controle de tempo para acompanhá-las. Deslocamento e velocidade são dados - de ponto. - -Os arquivos ANSYS e VTK são escritos no tempo zero e a cada -``params.output.snapshotEvery`` passos. - -Executar os testes ------------------- - -.. code-block:: matlab - - >> addpath tests - >> run_tests % testes rápidos - >> run_tests(IncludeSlow=true) % também os testes lentos diff --git a/docs/source/en/usage.rst b/docs/source/usage.rst similarity index 99% rename from docs/source/en/usage.rst rename to docs/source/usage.rst index 2591ee0..b8e9e01 100644 --- a/docs/source/en/usage.rst +++ b/docs/source/usage.rst @@ -133,6 +133,53 @@ the writer and the template. To add a scenario, add a line to damping model is a subclass of ``ldem.solver.DampingModel`` registered in ``ldem.solver.dampingRegistry``. +Your own test: supports and loads +--------------------------------- + +With ``type = "custom"`` the test is described in the case file by +``[[support]]`` and ``[[load]]`` blocks, without writing a class. This is the +uniaxial test (``testId = 101``) as blocks: + +.. code-block:: text + + [scenario] + type = "custom" + + [[support]] + name = "left end" + x = 0.5 # the layer of centre nodes at x = 0.5 modules + fix = ["x"] # directions that cannot move + + [[load]] + name = "right end" + x = "max - 0.5" + direction = "x" + type = "displacement" # or "force" + time_function = "linear" + rate = -4 mm/s + reaction = true # its force is the reaction of the test + +**Nodes** are chosen with ``nodes`` (``all``, ``grid`` for the corners of the +modules or ``centre`` for their centres), ``ids`` (node numbers) and ``x``, +``y``, ``z``. A position is in modules (centre nodes lie at half-integers, grid +nodes at integers), a range ``[lo, hi]``, or a text with the references +``min``, ``max`` and ``mid`` and an offset, such as ``"max - 0.5"``. A node must +satisfy every condition. The positions refer to the regular lattice, so they do +not change when ``mesh.perturbation`` moves the nodes. + +**Supports** hold the directions listed in ``fix``. **Loads** act on one +``direction`` as a ``force`` (newtons on each selected node) or as a prescribed +``displacement`` (metres from the initial position, and the solver holds that +direction). The value follows ``time_function``: ``constant`` (``value``), +``linear`` (``rate``), ``ramp`` (``rate`` until the time ``until``, then +constant) or ``table`` (``times`` and ``values`` in SI units, linear between +points and constant outside). + +A block with ``reaction = true`` adds its force to the reaction of the test +(the sum of the bar forces on its held directions); with none, the reaction is +NaN. A block that selects no node is an error that names it. The three built-in +tests written this way give exactly the same results as their classes. + Reuse a case: extends --------------------- @@ -191,54 +238,7 @@ Reference of every key The tables below are generated from ``ldem.schema.caseSchema``, the same table that the reader uses, so they always agree with it. -.. include:: ../case-keys.inc - -Your own test: supports and loads ---------------------------------- - -With ``type = "custom"`` the test is described in the case file by -``[[support]]`` and ``[[load]]`` blocks, without writing a class. This is the -uniaxial test (``testId = 101``) as blocks: - -.. code-block:: text - - [scenario] - type = "custom" - - [[support]] - name = "left end" - x = 0.5 # the layer of centre nodes at x = 0.5 modules - fix = ["x"] # directions that cannot move - - [[load]] - name = "right end" - x = "max - 0.5" - direction = "x" - type = "displacement" # or "force" - time_function = "linear" - rate = -4 mm/s - reaction = true # its force is the reaction of the test - -**Nodes** are chosen with ``nodes`` (``all``, ``grid`` for the corners of the -modules or ``centre`` for their centres), ``ids`` (node numbers) and ``x``, -``y``, ``z``. A position is in modules (centre nodes lie at half-integers, grid -nodes at integers), a range ``[lo, hi]``, or a text with the references -``min``, ``max`` and ``mid`` and an offset, such as ``"max - 0.5"``. A node must -satisfy every condition. The positions refer to the regular lattice, so they do -not change when ``mesh.perturbation`` moves the nodes. - -**Supports** hold the directions listed in ``fix``. **Loads** act on one -``direction`` as a ``force`` (newtons on each selected node) or as a prescribed -``displacement`` (metres from the initial position, and the solver holds that -direction). The value follows ``time_function``: ``constant`` (``value``), -``linear`` (``rate``), ``ramp`` (``rate`` until the time ``until``, then -constant) or ``table`` (``times`` and ``values`` in SI units, linear between -points and constant outside). - -A block with ``reaction = true`` adds its force to the reaction of the test -(the sum of the bar forces on its held directions); with none, the reaction is -NaN. A block that selects no node is an error that names it. The three built-in -tests written this way give exactly the same results as their classes. +.. include:: case-keys.inc Tests available --------------- @@ -257,7 +257,7 @@ Tests available only test loaded with a force instead of a displacement. See ``examples/example1_clamped_beam``. -To add a new test, create a subclass of ``ldem.scenarios.Scenario``. +To add a new test, create a subclass of ``ldem.scenarios.Scenario`` (see :doc:`model`). Mesh perturbation ----------------- diff --git a/docs/tools/build_docs.py b/docs/tools/build_docs.py new file mode 100644 index 0000000..63b3cc0 --- /dev/null +++ b/docs/tools/build_docs.py @@ -0,0 +1,65 @@ +#!/usr/bin/env python +"""Build the documentation in every language. + +The pages are written in English (``docs/source/``); the other languages are +built from the same pages with the translation catalogs of ``docs/locale/``. +Each language is its own site, in ``docs/build/html//``, and +``docs/build/html/index.html`` sends the reader to the English one. Warnings are +errors (``-W``), so the documentation must build without any. + +Usage: + python docs/tools/build_docs.py all languages + python docs/tools/build_docs.py --languages en es only some + python docs/tools/build_docs.py --output some/folder +""" +import argparse +import subprocess +import sys +from pathlib import Path + +ROOT = Path(__file__).resolve().parents[2] +SOURCE = ROOT / "docs" / "source" +LANGUAGES = [("en", "English"), ("es", "Español"), ("pt", "Português"), ("it", "Italiano")] + + +def build(language, output): + """Run Sphinx for one language; return True when it built without warnings.""" + print("== Building the documentation in %s" % language, flush=True) + result = subprocess.run( + [sys.executable, "-m", "sphinx", "-W", "--keep-going", "-q", "-b", "html", + "-D", "language=%s" % language, str(SOURCE), str(output / language)], + ) + return result.returncode == 0 + + +def write_redirect(output, languages): + links = " · ".join('%s' % (code, name) + for code, name in LANGUAGES if code in languages) + (output / "index.html").write_text( + '\n\nLDEM-MATLAB\n' + '\n' + '

    LDEM-MATLAB documentation: %s

    \n' % links, + encoding="utf-8", + ) + + +def main(): + codes = [code for code, _ in LANGUAGES] + parser = argparse.ArgumentParser(description=__doc__.split("\n\n")[0]) + parser.add_argument("--languages", nargs="+", default=codes, choices=codes) + parser.add_argument("--output", default=str(ROOT / "docs" / "build" / "html")) + args = parser.parse_args() + output = Path(args.output) + output.mkdir(parents=True, exist_ok=True) + + failed = [language for language in args.languages if not build(language, output)] + write_redirect(output, args.languages) + if failed: + print("The documentation did not build without warnings in: %s" % ", ".join(failed)) + return 1 + print("Documentation written to %s (open %s)" % (output, output / "index.html")) + return 0 + + +if __name__ == "__main__": + sys.exit(main()) diff --git a/docs/tools/update_translations.py b/docs/tools/update_translations.py new file mode 100644 index 0000000..46869d5 --- /dev/null +++ b/docs/tools/update_translations.py @@ -0,0 +1,156 @@ +#!/usr/bin/env python +"""Update the translation catalogs (.po) after the English pages change. + +The English pages in ``docs/source/`` are the only source text. Their +translations live in ``docs/locale//LC_MESSAGES/.po``, one file +per page, each entry holding an English text (``msgid``) and its translation +(``msgstr``). This script + +1. asks Sphinx to extract the texts of every page (the gettext builder), +2. merges them into the catalog of each language: translations of unchanged + texts are kept, new texts appear untranslated and texts that changed a + little are marked ``fuzzy`` so the translator reviews them, +3. writes the catalogs without source locations, so a change in the English + text produces a small diff. + +A text that is untranslated or fuzzy is shown in English in the translated site. +The API page is generated from the ``.m`` comments and stays in English: only +its own headings and sentences are translated. + +Usage: + python docs/tools/update_translations.py update the catalogs + python docs/tools/update_translations.py --status only report what is left + python docs/tools/update_translations.py --languages es pt +""" +import argparse +import io +import re +import subprocess +import sys +import tempfile +from pathlib import Path + +from babel.messages.catalog import Catalog +from babel.messages.pofile import read_po, write_po + +ROOT = Path(__file__).resolve().parents[2] +SOURCE = ROOT / "docs" / "source" +LOCALE = ROOT / "docs" / "locale" +LANGUAGES = ["es", "pt", "it"] +NAMES = {"es": "Spanish", "pt": "Portuguese", "it": "Italian"} + + +def extract(target): + """Run the gettext builder; return {page: Catalog} for every page.""" + subprocess.run( + [sys.executable, "-m", "sphinx", "-q", "-b", "gettext", + "-D", "gettext_compact=0", "-D", "gettext_location=1", str(SOURCE), str(target)], + check=True, + ) + catalogs = {} + for pot in sorted(Path(target).rglob("*.pot")): + page = pot.relative_to(target).with_suffix("").as_posix() + if page == "sphinx": # texts of the theme and of Sphinx itself + continue + with open(pot, "rb") as handle: + catalogs[page] = read_po(handle) + return catalogs + + +def own_texts_only(page, catalog): + """The API page is mostly generated docstrings: keep only the texts written in its .rst.""" + if page != "api/index": + return catalog + kept = Catalog(project=catalog.project, version=catalog.version, charset="utf-8") + for message in catalog: + if message.id and any(str(loc[0]).replace("\\", "/").endswith("api/index.rst") + for loc in message.locations): + kept.add(message.id, locations=message.locations) + return kept + + +def merge(language, page, template): + """Return the catalog of one page and language, merged with its template.""" + path = LOCALE / language / "LC_MESSAGES" / (page + ".po") + if path.is_file(): + with open(path, "rb") as handle: + catalog = read_po(handle, locale=language) + else: + catalog = Catalog(locale=language, project="LDEM-MATLAB", charset="utf-8") + catalog.update(template, no_fuzzy_matching=False) + for message in catalog: + message.locations = [] + catalog.fuzzy = False # the header of the catalog is not a translation to review + catalog.project = "LDEM-MATLAB" + catalog.version = "" + catalog.msgid_bugs_address = "" + catalog.last_translator = "" + catalog.language_team = "" + catalog.header_comment = ( + "# Translation of the LDEM-MATLAB documentation (%s).\n" + "# Generated by docs/tools/update_translations.py: edit only the msgstr entries." % language + ) + return path, catalog + + +def save(path, catalog): + """Write a catalog without the dates and the version, so an update only changes real text.""" + path.parent.mkdir(parents=True, exist_ok=True) + buffer = io.BytesIO() + write_po(buffer, catalog, width=88, ignore_obsolete=True, include_previous=False) + text = buffer.getvalue().decode("utf-8") + text = re.sub(r'"(POT-Creation-Date|PO-Revision-Date): [^\n]*\\n"\n', "", text) + text = text.replace('"Project-Id-Version: LDEM-MATLAB \\n"', '"Project-Id-Version: LDEM-MATLAB\\n"') + path.write_bytes(text.encode("utf-8")) + + +def count(catalog): + translated = fuzzy = missing = 0 + for message in catalog: + if not message.id: + continue + if not message.string or (isinstance(message.string, (list, tuple)) and not any(message.string)): + missing += 1 + elif message.fuzzy: + fuzzy += 1 + else: + translated += 1 + return translated, fuzzy, missing + + +def status(languages): + print("%-10s %12s %8s %12s" % ("language", "translated", "fuzzy", "untranslated")) + for language in languages: + total = [0, 0, 0] + worst = [] + for path in sorted((LOCALE / language / "LC_MESSAGES").rglob("*.po")): + with open(path, "rb") as handle: + numbers = count(read_po(handle, locale=language)) + total = [a + b for a, b in zip(total, numbers)] + if numbers[1] or numbers[2]: + worst.append((path.relative_to(LOCALE / language / "LC_MESSAGES").as_posix(), numbers)) + print("%-10s %12d %8d %12d" % (NAMES.get(language, language), *total)) + for name, numbers in worst: + print(" %-24s fuzzy %d, untranslated %d" % (name, numbers[1], numbers[2])) + print("\nSome untranslated entries are intentional: code lines, names and tables that read " + "the same in every language are left empty and shown as they are.") + + +def main(): + parser = argparse.ArgumentParser(description=__doc__.split("\n\n")[0]) + parser.add_argument("--languages", nargs="+", default=LANGUAGES, choices=LANGUAGES) + parser.add_argument("--status", action="store_true", help="only report what is left to translate") + args = parser.parse_args() + if not args.status: + with tempfile.TemporaryDirectory() as tmp: + catalogs = extract(tmp) + for language in args.languages: + for page, template in catalogs.items(): + path, catalog = merge(language, page, own_texts_only(page, template)) + save(path, catalog) + print("Catalogs updated in", LOCALE) + status(args.languages) + + +if __name__ == "__main__": + main() diff --git a/examples/README.md b/examples/README.md index bf39e74..683cbef 100644 --- a/examples/README.md +++ b/examples/README.md @@ -1,15 +1,20 @@ # Examples -| Folder | What it shows | Time | -|--------|---------------|------| -| `tension_101/` | Small prism under uniaxial load, all output formats, energy plot | seconds | -| `beam_102/` | The 101x41x21-module beam read from `DATA0.DAT` | ~20 s for 50 steps; ~20 h for the full run | -| `example1_clamped_beam/` | Beam clamped at both ends and loaded with a force at mid-span (model by Rodrigo) | see below | +Three models that run from start to finish. Each has its inputs and a script that runs +it and plots the results. The full description, with the model, the files and the +results to expect, is in the user guide: *Examples* (`docs/source/examples.rst`). + +| Folder | What it shows | Size | Time | +|--------|---------------|------|------| +| `example1_clamped_beam/` | Beam clamped at both ends and loaded with a force at mid-span (model by Rodrigo) | 3,086 nodes | about 35 s | +| `tension_101/` | Small prism under a uniaxial load, with damage and every output format | 74 nodes | about 6 s | +| `beam_102/` | The 101x41x21-node four-point bending beam of the paper (demo of the first 50 steps) | 166,961 nodes | about 30 s for 50 steps; about 20 h for the full run | Run an example from MATLAB, from any folder: ```matlab ->> run('examples/tension_101/runTension.m') +>> run('examples/example1_clamped_beam/runClampedBeam.m') +>> results = ldem.run('examples/example1_clamped_beam/case.ldem'); % from the case file ``` Outputs are written to an `output/` folder next to the script (ignored by git): @@ -22,47 +27,28 @@ Outputs are written to an `output/` folder next to the script (ignored by git): ## Case files -Each beam example has a `case.ldem` next to its `DATA0.DAT`: the same model in -the readable case-file format (named keys, units, comments, the scenario and -the output files in one place; see the user guide). It is generated from the -`DATA0.DAT` and gives the same parameters. +The two beam examples have a `case.ldem` next to their `DATA0.DAT`: the same model in +the readable case-file format (named keys, units, comments, the scenario and the output +files in one place). It is generated from the `DATA0.DAT` and gives the same parameters. ```matlab >> ldem.check('examples/example1_clamped_beam/case.ldem') % what would be simulated >> results = ldem.run('examples/example1_clamped_beam/case.ldem'); ``` -## beam_102 input files - -| File | Purpose | -|------|---------| -| `case.ldem` | The same parameters as a case file (`ldem.io.readCase`, `ldem.run`) | -| `DATA0.DAT` | Simulation parameters (format of the original program, read by `ldem.Parameters.fromFile`) | -| `arquivo_3lc_rnao_cv05` | Random field applied to the critical strain of each bar (11 MB) | - -## example1_clamped_beam - -A beam of 5 x 5 x 50 modules (1 mm each) clamped at both ends and loaded at -mid-span with a force, by Rodrigo (branch `dev_rodrigo`). It runs the 8000 steps -(2.8 ms) of the original model in about one minute. - -| File | Purpose | -|------|---------| -| `case.ldem` | The same model as a case file (run it with `ldem.run`) | -| `runClampedBeam.m` | Reads `DATA0.DAT`, runs the simulation, plots the force on the clamped ends, the vertical displacement of the control nodes and the energies | -| `DATA0.DAT` | Parameters of the model (`TEST 103`, see `ldem.scenarios.ClampedBeam`) | - -The random field of the critical strain is shared with `beam_102`. - -How the model maps to the input file and the scenario: - -- The centre nodes of the first and of the last layer of modules are clamped. -- A line of centre nodes at mid-span (z = 24.5 modules, y = 0.5 modules) carries a - force in +y that grows as `forceRate * t` (1000 N/s per node) up to `rampTime` - (0.35 ms) and then stays constant. Change them with - `ldem.scenarios.ClampedBeam(forceRate=..., rampTime=...)`. -- Control nodes: the original file listed five, but nodes 6870 and 14398 do not - exist in this 3086-node mesh, so `DATA0.DAT` keeps nodes 2441 (a loaded node) - and 884 (a grid node at mid-span). The tracked bar is 14398, as in the original. -- With these values the beam stays elastic (no bar softens). Raise `forceRate` or - lower the fracture energy (`GFR` in `DATA0.DAT`) to see damage. +## Files + +| Folder | File | Purpose | +|--------|------|---------| +| `example1_clamped_beam/` | `case.ldem` | The model as a case file | +| | `runClampedBeam.m` | Reads `DATA0.DAT`, runs, and plots the force on the clamped ends, the vertical displacement of the control nodes and the energies | +| | `DATA0.DAT` | Parameters in the format of the original program (`TEST 103`) | +| `tension_101/` | `runTension.m` | Describes the model with `ldem.Parameters`, runs it and plots the energies | +| `beam_102/` | `case.ldem` | The model as a case file | +| | `runBeam.m` | Reads the input, runs the first 50 steps and plots the reaction | +| | `DATA0.DAT` | Parameters in the format of the original program (`TEST 102`) | +| | `arquivo_3lc_rnao_cv05` | Random field of the critical strain of each bar (11 MB); `example1_clamped_beam` uses it too | + +With the default values the clamped beam stays elastic (no bar softens). Raise the +force (`force_rate` in `case.ldem`, `forceRate` in the scenario) or lower the fracture +energy to see damage. diff --git a/src/+ldem/+io/readCase.m b/src/+ldem/+io/readCase.m index 2fd02ea..d442cbf 100644 --- a/src/+ldem/+io/readCase.m +++ b/src/+ldem/+io/readCase.m @@ -4,7 +4,7 @@ % c = ldem.io.readCase(path) reads a case file, checks every key against % ldem.schema.caseSchema, converts the units to SI and returns the objects % that ldem.runSimulation needs. The format is described in -% docs/source/en/usage.rst and in the template written by +% docs/source/usage.rst and in the template written by % ldem.io.writeTemplate. A short example: % % format = 1
  • cb%bZA(ho#^oB5-_@c7jk3 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 literal 0 HcmV?d00001 diff --git a/tests/fixtures/tension101_damage.mat b/tests/fixtures/tension101_damage.mat new file mode 100644 index 0000000000000000000000000000000000000000..75cbda28358ad354a48a5877388baa9b40cbd23e GIT binary patch literal 167063 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 Y{BVh~bH6gBU)iN!*%iu?@Da=Y4`33%bN~PV literal 0 HcmV?d00001 diff --git a/tests/fixtures/tension101_elastic.mat b/tests/fixtures/tension101_elastic.mat new file mode 100644 index 0000000000000000000000000000000000000000..7ee8f42d1ef25005df72fa743bc43c803afb944d GIT binary patch literal 160198 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 z z)9t_>5cIhr*aLzcAU8YUgB>8b&h2dLTI%kE3#euVOVji3kEUVYH}EKjA!4M7i( zn;!5%FB_!`G&cl2KyG@#2R%UGb3?k`=XTbYZr4`&9o2{Q{`vBBAsbYGcG;FY-rQa?l4o zZgy?SAsw&>1U?|}0f7$)d_dp>0v{0k!VSTW8-g9k=``>mKW=mYE&hN8yY~7I(gy^4 zZU}nZkeeOwp}v6J(g8l$0YbgN9uV~DH1NS5&pwA7#9uVvRx!D09 z>;TE>p|f2dFzeb&bp+_Ql^(2De)c*Z@@+0B8IPDSod!KX zx|~ka^*+l}>2gE5JvTkzgMKzj7iew>dVt*YfDd|rz~_c^z0d8eFWs)K^gF5#>HYKN zfpsLrJG~$LEIH)U*$~G2A4U3n(oq`nFY9}!LGgjgY*Hx zo*RN5H{@mqe5fxVw{(CHc7RYXum=QvIt_fV2RZl)Lum=P?KyG%x z2RlG=zGv38&Chdqr&jfQrpd+!>vc=I8^XdvpAGSf5@6vxUG{dl(8$6ic>P63a=CSaR z5=E=uZ)D-~!X*PPJBs0F4}1voFcrlgMjSK_KFY$M4xJybmBGT(Hhvm|^=IRM>BO*( z+Kb_ZBZnCW<%{BCdhY}G8i?X6f1gqJiO8pCYRXvC*=#&y+$xPb@@)J?ulcFj>TKL( zqW-}!RTkbaEOVK+ycq5~!!vJUk_cX`Ih;>ES_GfJEPCSN^CGyfhCkoM)8csgEgfx5 zbqV}6HtUYYT?u?q!-&9-EOC58;ja1eeBwAReP4Ee29f^bE<=wMi{nyj#p^$GlfXT! zH{RMVB!SP*nLq3CBR0;feOTb>Og4V?R%z;Af3Wb91x_V%uCs8foqsB@x3h82s;*lF z4aD&=dvy06xg?I)YJBP*cSIb|xKlPYX^S|X-QW1ZE@yFEC?bExdsA^-ZP&;OOHFZn zk6`p@%^~7=!R1jVsWEK4OL@=zOHA2#hT8b0nWZdzx73TvI%X`~Yx}?N-cO4#o?#m4^>kEwT9$Hx619lIlI$i|o1{l2583>#0~_o!gdFg7kXVMV6t zCl>Ce>VNlKHVdCPr_M0ZpM_uPb!?^MBNl#4DEj0XD;B#bcggzp?Sh zN>aPCbl7+zOGW2TFE$>wCT!xcdKNx?ch3VsTUhuzp;!Hf4r1Yhx}f%AS-eZs=cFOJ#1l+DKPKCUZu z@?+xzLRHM)=ZWFA8T+kN34aIfcQiY&R1^;kjEK+?VdDzne`R5cY<%=oyIv8C+4x(< zU2A5XA>wo1m_EURY}|KYm;`Rxt*g$yBsQLs8mGL?jcAusZqvQSv+=%VITlBzi{pZr z#2mE^;&}f78$~J~h~op3gtayWvhn`9H?kgzv+-P~0^>pVS@_^xQ$9Q7vG7IDE}zJB zVBu6OOniQ~5Of-Idf*?7d!1!WEaY<$xEb?-J?5_)kvU9T9h@htYK z`a+_=yA8T%Jx_y;ALqlb<`VU6G*<5Gx{QtI9}h`$pT)*EN|z1#K#VJ87FRTuyRq;Q zvmfa^AlffmH&%E=Z#I6|?tGc;ZZQ}5arTZmT0=?DjS#Gxo=JWOExaDxm)lcA}$B3 z40-k&FB`|YPVO#e!ou|*@fPJh5yOWZKjYkYkrBZ}|Qw*Twc6;WL1{@%A! zh;i<5gjBc0zGC>sO?D&vG{x{KDvF{TgT?Sc&H)PU@5J!_r>s87JFsv=HCfY);cVQ+ z>u{VM(H`QN7o4*j*tqv$(T6i**?79F2G4ePHtx&A)d;B+OT zy$&o%A4RmAzpAaDV;Kw2_`R#lEutTb^?TrSW-~EfN8U~r)MVjCb6@*zAI-v7xcJF- zc`t^CT?jw2kmwiozo*B_N3ijOgZAH@+*=&)65BU${vo1$N&=h~bTy@5PQ1^UaPKk!I(J@|~-id+@{@ zHojYV#e+jmY+PR_Nn{_7INr~pbi>XpHZEz!^LEE2HohO*I(#hAkDr{>6e;T=h6~Ic zD1G&v2tL`d_ns(yalGV1=K13TB=Ffdu zKJ*I0*tnWdRM*YAY+T*cqtWp!8=vfPTTOot8-H#c@LF;Z(SG`d-o1(O2Om7P&l)`z zuCwvkVOMQpoZ8T5yyJWpUX5S-L(zwY@4TKaR7}kGb&uC=39x13W%W}QjMzqukAH2j z-=WRM1I|6!jtybs3BxKKx=&@}>*v??JVlHbhxN;^C=VCMrPm22TV7}5!jAGby?3$j zuFF<+yJ8`Ri#++*B|t?C-+m$6GH5yxH=k!DpO{4W?c6x&aALfxiwX{jy1~Y`OYNO- z`x#Mg(Z?Zm-fUdMLqTKd9bz0bn)N1*pM|r|2PWP+CWeceX_v1E5W{~H>N#kDml%F| z+^Y#k28iK@2OACL*A~Tnx@Yuq^b^5*z1de{6(fRoRU8wZpDl_fi%Z#YLiJF~XB z5##9EtrK}B=(F+IisJRDM0?_f>GOLKeqVk%+d1(#QQ!A34{g$7sn@Ai(!@yuI9E@7}g7$Om6>TJQzPFK>Smirmdi>hG7E; zUN;V(lwz2;vx}Jvp^ssLN({um;gLZ+zU>=QROfUkofG%*7bytIAToedcGhI zhm-H;+u6Cl@_CNu@@IOxWDS)E%tUk!4M7gb=zZR;r1!s{ zC5L=E8?Je{xj;8-r2LQKYMOmVX~@@=mQF`$NatrG)EAJRKkxzRa(X>Mz83kTEjj3e z9yhzT70|Flq_<+C%1U?|}0f7$)e&L2-#|^;_;R!&U=IlTbQ<_z4|4Dq$RS-iO}7JkK+xxgU=Ij(fZXhW z4|ag$8kgDkZr=Cq>}!6ee2fPe4{-OuqKD#Ub833t;HL3!%em#t@PDoc1p35G=yHuIR2X$Px2j#z;-jx4dBf1arXIt{lSEHX> zBJdByADyQAlTQEK(ssVwf>8hM+0OoZ5a}Bn`is-w$r>^1T4r6_`68Ps5#xc5d%%rv zCGq}qp?GeV|F)c4z6}58dca{hU!{@Sp!j#16UN$=ty zz5kd8o`2@0o*Razho#X8o#rE+e z^Z?<{ABi7+!j5Vi46}7uZew9)OFZW;PjE?of8tyK(@@Y=S5P#uv3D`Cw6bup6DHN0(t-3k`n)_m&&|Z!55~aHG$Y#ke#I|IeRYbjphWQ%lqkM}62(_tNbyw{Qhe2gh)=OGRf>(NQf%V-Qiqd|h7N^F znj8`{P^54%!X*gx6crYd5`Bb=5US6m^i?DgPC=-RP=mtx9BT|i*(}84C+l6qFRS3=l3xxCB$t)=(f5CXi#Op`ySsRMJx6gb-Z!Sd*FjiwEoj z{EF)`^F!0RnHvfy04_(g2@OFG$mo6Tw~qP+^cnoV9~r-V?U!Y={z&hCKT8hzbT)+d zSN|x|-;do<8uI1#UhnqGLGNcH)EAJRKkxzRa(cZ%4(}0fOAh*=$IY%SIiv&jfWQX? zJ|OS`fe#3LK;Q#{U$`OIaYL{JIh_VR;XZaP6Hq8K@R=`IiyRc>2_cb2>RR*>;b_JkeeOw!48mIo_4nDvR}Eb zzY)H719Ct{kNoazv)?-E7tm*r@IZ_BWBl=bf57*ipg+?4-_Mdm zKAjCYaU)bM|D(vcHQU0zqcr5p@k@(zI!Z%2KO3RGfb{%<4@j5O>k0Bk^84IFs^!~~ zgFfhSvujHZ>3}^T@Bx7j2z)@`0|Flq_<-OSZU}bV5bQusr-2XoaihuoW2{B|0S$KT z^&g}U2=?3%^td56JK#fo0lB3Ee6RzAdVxJ4=+kN7gFVQ>Um%Bc=``IA>;XZa8-hI` z*a33013uURl6+=e+x#32=?|-iBRTu;3^IOT;(_T8%s9Y|1I#$Uj04O#@ZTB-n04*f z>skz(D^HGN3^IOT;(+M~%s9Y|1I#$Uj04O#@ZTB-n00OQy4FL}J+Cfn56&Rt2PO`f ze!z?a%s9Y|1I#$Uj069zae%xEW7f6J>)O=GQrez1Y@9*H4@?{|{eT$_xqL&jiu69ZY=Z;zS06mMpF>w5A?PdlS^J#Qp_alCcC znMiD)*}9%LDzfnUZ_D12Q`F^}wq=vwEd??vz{IZSGxLubpxorGIW|J6~=`i)1+di;bZC2ecdVC(zvF zov%hew?yC{h(B&L-Jd}J+|qWw-10lve_tYf@ug~<{!Z4Yv+jEfpk+7xJ=U-q=Y}1B zkF_ADVfl!+UVpI8_q|-#1^?gl3;KQm@p5m@??W+RPQAZGebH4 z>Gz3J`wv~PAe6zoXvm2y?YGBHB+j_nx*pYQFwAt;w`sKG2qWSwdjDlh*?;N$@Atco zes7?8oaXpxr?WhXoh`n8xnD3L#xF!%2ynjCgJI;nP8|Y_Ul_l%@;#I0@ul8t1@Rq2 z>;KVp;E#{HY8PS;en{WO**9Xw-R5{f0}KZ`t6#J^FKHpyRg*d8M4v0e=ApvF>V{5t zd>v@Oxf8>OX`?$bExp5>GamSR9_Xz7>&LG@e|$Wa8`3@h%#qj3cua)Ux9dGB&N^GX z!2R#HXuzGE03$D#egUKC!`AiQA+hhh*7aT>vEbd-_3DuL*!|Y^1W@^e9<{D#ip1V- zt?O~|!Z+++f1TAiq#K7w^HkR z8Ax1ryLCNc;mSEC^R%HyZ}^`?Gx7EP_+tF>eZRmuAOeN6_x0A}`YaL)$F{C_42cC| zTGtas{r&7;t?NxjdIG7f>q#Iz;k4HECL{6LnXT)!x7#xD_5Ju_{KEL9<$W}9XBRUU zE3#L0KED)bi}cAJc9C;Otg~IO{mOpSpM4@VA(h4KLlaT^U%9^Thx%92Olk&uD??!~ z>;>ns3m&Wwp&>+kCsJ2kLD6KHjg_sXGodn+_)qrC0mOfDX5>NZT-c8VBxOm|7A`gr z=>k27Mh_-va#{xY5E?B+qscOm+r*$hj7ATq(IaT|NE$tgMvtb^!ZdmejUG#*$IKlx}wOL{gzx2&HmLAOkg+?Z@hlLJ{x zeR&$KK%*6Dv=TwL%wL%%SE13W1Wi7R1pX(#c-pc&YBZYsATe&}exOBF>SNPkI!?(C~<* ztsp&yVLLg0F-+|VCFeMv;Q5MCv@c>`eL$U<0v(Fv$o}kZ>f{)r)pk)Qb%=iPg*u5x z_VFpy30#-VjH75_q#tBMoshmF57Q(HGbmvGcF+SnSP!ack^kxUBm0e`5=3H*PV*77 zBq<~3N-A>5Gcs-kIDB3{UXE!`OqfH%b`iCX$y+60E zN6u~JAvloo5=DLccP3&D5NloUTg%SH>4nL23dBP^5!Q=nRkXe$9zQj)w6bupv_i!d zBpgk)4~7YI{(={w_U(R7b(xK=6|rz5$2%UPwOfvLhVG&!Aj#v!F| zO6BJ-=|wj6R`srpwRs7_0Vz3E`E{SCT>s)K^ElXe&Y|?8lDa~#RNlHXj@4dS{&?St z;F^Mz{Y4cg`qu0W+VY{uK<>!>GxI;Xu!7wzlCw(eC3oixw75CDB2lPu&G0g>&%?ti zmUSzCv-pdo=lYm>$NCcMwd-!wuRRugW_@gw?2dibpT^eZxCjM5>7VXq5&qdFNRw~v z49_6B-luQ)PcJQV{M<0J{^YcG72^3RId#f%l2VN?R|n0ldNiwGTAWly%1X&TemzQy zroDS4cWJ?U(T%a%so@1^t{_V!?!us?`5`BH<-K0 z9O@GoTbyxg;{DeL-^))p<7$6+`7xKYmD71uj;6}xT;2UXLU+r&=OLcAqV|?d=(%Ne zU-fVcdn1$Lb8FLI%qkD+b-seN;9j)*%l?6l=k$&KNIQCEvu63M(MC04#y4tGC&=_G zKJfC(AkUqy+GQbfLepi`O5dgp$;78Vwd@&JQ^Tr~d1ZS%UDCQ|+zz5xemcV(Hu|`p zEY>bbjaHSN8hKtR%tCL={pw3KYhU*_c=wW3SQ9yY0ehL=cGY0ETebC&+wOmEx021e z`{$@QzbP^oU+_vlkGy>4)`Ac7h9urDNy?54owPs4X?#gWRLv{p3l=X1FR?Sozgw^4 zXZ+E9&4ZfAfW}AFxPRc5Ls^Hnohk`Uzm&gD^KR~-g6Gz!Lq^n1 zU-9Yw28R=)w58wK*;n&b3697v=FckB$Dd4(s^4%WI<@b`haZ;_)V0LS4}5mcA)~Di z88*m2C$ww_OiQdhJ45baV0J}*UyEObk3X!=6n8fIAhUk;jK)T}^J8`G zVxliv=xsdU74*K&&HturvR{zrb^l-s{gkbiku7}R{mU(n@aL7IRn&bhut%oEX zU2pDoYvhXb#_|`dXUx1O=V2&#X+XH+{_9$+qKB|0cjxYpFEq}$W8^;GQ|DtTOF7wi zoy&4t0)i5QKE?Pvj(fLNvR3U~^bk48qocaZ)!v$vkTUM&4UhMxe$jI_u1y;dDd#af za+_(OU{bE?oe}pBR@f;gAAgtm+*hbD`l`o`9ljfG?S6VP>Zw`bXW@0`J4VjGGh&lg za^#$a{`2G{6XgyrICKB1w{(r#3Y&Yg3p2(IoilBB&GfOqM~j);JB%|Q)gw60-*>H` zRyT`=nKwWCNc2r`A7A%cPWF`-A-y`MuO$gM2X?%=_af}^EYrrx$x?YWL!~Sx&2*NQ zavnIdEKcLnz&e+;I+f3SB6~>5f8bY*X%zahNA_LO2eCm^wDQ%6{mG`}`pM3v0_Q2|?M@?*VZ-!1gYU1ZFq~KIIBxYN2pIY2b4mp0uokKt@p1K@_9Z@!sBetn(J{_hNpWc zxR-V@ns%qxA8xnj6@Mz|v!twWZ`bfH{&hkM4l}~L`hSeSc0cgI`1GL>;ciy!b6N9l ze3H9vb#|%3+o-$}Gn1`eAuRWpey(CGlZtvNkKE2W{Fi+1!{^=3E5zma-rAuZ+2B5| zhlk?b8nwLSR{ zoUY|h_8;8cWc7+JvY}ZIi~3a^Suw-%pjWRT!^^{`XawBNKA*GG#{H4?jE6&v_aDn~ z=`C$Fwp2eb$1bL5n3G7?6FNppnjyz#=*LLMZOk<&E1cFde2kHUW)#U9lTt;vDa6gW zzH8-XRsJ)kf{PQg64l10nrq$^URYKz&`;=0!tB>WE4J%JZ;6YFD2~!h6zKNM!K~uC zNg6x)uOqu}PCgx(@Y_&j5kt*;!V9CF=5^ckK&MaCbzeOP#}%qohS6DBTddaFF{-KVkq)jQ+XL6h&T+mk6Im>!`R0YtpGOmg z4qv-I`!R2titA+TENo{)Ra`GO1I4 z^31pCnYL@)ctS&x)0QV|b{}I>y*Kl>F`+7ZCC~T>o?9?*@!hhDt$GQE`}A)RvC!ln zb49M-3zwbo=ksQc+>~)YC`ExcQ>KAfYdgSod+jOhVRxwRoU01T()jxS#lvAOrp!u{{@q4b+haHxV ziOjoy;L`AjK&dl6tL&>k4yYZdY8oh2J3^H($=)Lrda}9~|6sQTy8{o%iRZfr)`Scd zXt*|cuI0SGlT0lVzN7yr+j-cA)a+L-g68`VM^~$c)?Z6k*q7RO-J?vq#SK`=tMQS=%Z>RL z>*Iv4{Fm$AKcJ&{HmWGPZ@sId)7l-pp@t53&R5Ko-83vhU;gdt`Qm9KWh3n4Sfavp z7cV`($jj?Ce|6|#X_ZaRDVL^Hm6TqY?ZKONcdmKr>cebBs|dn3?*&2=MxNQ;MZY0g z_Kkw=LnX~2W3D(A?%fr?Le4Eqji~*Z9bNP*BX#DSJ)JiD^|M{^#n)C93q)S-?^LX2 zD%#i6Yn=Y$#r=Hhs|OoY^Ve3*F-;wPSWz+bsG<3dw~v;mrSA0Tv1x^?|2fSuW3K22 zXpZS_E7D!)f=A<#H&OQwq^M;$JXC7DCuq8#@P5A#S8or+P3JuelFyCbkm~wUx4-#H z+1I+e<3*NhP9TfrvOB)m-FaU3NTOJKyXdDM(wVpBuLUJzIK)n!dA_Oc0`F6gZ0UdK z(@4`C_x#F{_l8CozByif!1Bz#Rk8KzJoROjhNjMOJSAz*FOK59lDGfe__>vWjb((V z1Er#JeZvk%JKM?)*t1qZGB?vdW2r;DOw9WOy$h0yCcIV%zAb+vWB(oTpm(a<5sm3jYf?UWNPE{i zHr~xnsk)F^ypBJ?B)75aX!%19CzjU;1g|;rJl|jBy<0$VVbq2A`*nIbTVASs{J7=m zEY+HsU*rND_--CDs51%OXf?d*^Xw(B;zXo#*KK*w|I3sFpQyv{qSjZBdRGxsbYsj! zRSh1jJLiUjDcVz}-&7e&yQxB_|HYdso()u)$Slb-&c60PbyKCYZTcIwvFU%A|Lbji zdOLhA{ZC!bGKFP4z<7Z10OJA11B?e44=^71jt4lK{=2gi`rTQ3LoxP(`lIAWB`$A6JXWi!&c`0ph{8-XZ%Nf@$<)#Y79vXFKe^FG?=#)1_ zwM8XWx2tA<`SQGKYQvNUnJ=F%0k6P z>{;W9r@c!oSy7vxC*(Op$_cM%3@G|klG-=LBth-nt&reu^=s=tJ6*V_adRzI41x@y>)m(yN-@Ol&VIGa`R*j3Tk^~lOz={GAX4T>%n3(RzFCrc0kuS%0D#rLyzsVm$KNO_}`fWKW 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