ventpy 0.2.0__tar.gz → 0.3.0__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- {ventpy-0.2.0 → ventpy-0.3.0}/.github/workflows/tests.yml +1 -1
- ventpy-0.3.0/CHANGELOG.md +483 -0
- {ventpy-0.2.0 → ventpy-0.3.0}/CMakeLists.txt +2 -1
- {ventpy-0.2.0 → ventpy-0.3.0}/CONTRIBUTING.md +7 -6
- ventpy-0.3.0/PKG-INFO +245 -0
- ventpy-0.3.0/README.es.md +213 -0
- ventpy-0.3.0/README.md +213 -0
- ventpy-0.3.0/ROADMAP.md +102 -0
- {ventpy-0.2.0 → ventpy-0.3.0}/bindings/bindings.cpp +150 -41
- ventpy-0.3.0/examples/01-demanda-peru/README.md +113 -0
- {ventpy-0.2.0 → ventpy-0.3.0}/examples/01-demanda-peru/input.json +1 -8
- {ventpy-0.2.0 → ventpy-0.3.0}/examples/01-demanda-peru/run.py +27 -32
- {ventpy-0.2.0 → ventpy-0.3.0}/examples/02-preset-chile/README.md +28 -12
- {ventpy-0.2.0 → ventpy-0.3.0}/examples/02-preset-chile/run.py +15 -8
- {ventpy-0.2.0 → ventpy-0.3.0}/examples/03-cobertura-levantamiento/README.md +17 -7
- {ventpy-0.2.0 → ventpy-0.3.0}/examples/03-cobertura-levantamiento/input.json +2 -2
- {ventpy-0.2.0 → ventpy-0.3.0}/examples/03-cobertura-levantamiento/run.py +10 -8
- {ventpy-0.2.0 → ventpy-0.3.0}/include/ventpy/atkinson.hpp +8 -7
- {ventpy-0.2.0 → ventpy-0.3.0}/include/ventpy/atmosphere.hpp +3 -3
- {ventpy-0.2.0 → ventpy-0.3.0}/include/ventpy/caudal_equipo.hpp +37 -19
- {ventpy-0.2.0 → ventpy-0.3.0}/include/ventpy/caudal_explosivos.hpp +136 -71
- {ventpy-0.2.0 → ventpy-0.3.0}/include/ventpy/caudal_fugas.hpp +6 -3
- {ventpy-0.2.0 → ventpy-0.3.0}/include/ventpy/caudal_personal.hpp +60 -33
- ventpy-0.3.0/include/ventpy/caudal_polvo.hpp +160 -0
- {ventpy-0.2.0 → ventpy-0.3.0}/include/ventpy/caudal_termico.hpp +28 -26
- {ventpy-0.2.0 → ventpy-0.3.0}/include/ventpy/cobertura.hpp +101 -32
- {ventpy-0.2.0 → ventpy-0.3.0}/include/ventpy/governor.hpp +206 -23
- ventpy-0.3.0/include/ventpy/limites_gases.hpp +275 -0
- ventpy-0.3.0/include/ventpy/normativa.hpp +787 -0
- {ventpy-0.2.0 → ventpy-0.3.0}/include/ventpy/types.hpp +66 -44
- {ventpy-0.2.0 → ventpy-0.3.0}/pyproject.toml +8 -2
- {ventpy-0.2.0 → ventpy-0.3.0}/python/ventpy/__init__.py +9 -1
- {ventpy-0.2.0 → ventpy-0.3.0}/python/ventpy/cli.py +9 -3
- {ventpy-0.2.0 → ventpy-0.3.0}/tests/cpp/test_atkinson.cpp +4 -3
- {ventpy-0.2.0 → ventpy-0.3.0}/tests/cpp/test_caudal_equipo.cpp +38 -1
- ventpy-0.3.0/tests/cpp/test_caudal_explosivos.cpp +276 -0
- ventpy-0.3.0/tests/cpp/test_caudal_personal.cpp +209 -0
- ventpy-0.3.0/tests/cpp/test_caudal_polvo.cpp +247 -0
- ventpy-0.3.0/tests/cpp/test_citas_normativas.cpp +701 -0
- {ventpy-0.2.0 → ventpy-0.3.0}/tests/cpp/test_cobertura.cpp +132 -26
- ventpy-0.3.0/tests/cpp/test_governor.cpp +773 -0
- ventpy-0.3.0/tests/cpp/test_limites_gases.cpp +324 -0
- ventpy-0.3.0/tests/cpp/test_normativa.cpp +357 -0
- ventpy-0.3.0/tests/python/test_citas_normativas.py +366 -0
- {ventpy-0.2.0 → ventpy-0.3.0}/tests/python/test_cli.py +74 -12
- {ventpy-0.2.0 → ventpy-0.3.0}/tests/python/test_cobertura.py +12 -10
- {ventpy-0.2.0 → ventpy-0.3.0}/tests/python/test_examples.py +3 -3
- ventpy-0.3.0/tests/python/test_multinorma.py +254 -0
- {ventpy-0.2.0 → ventpy-0.3.0}/tests/python/test_red_ventilacion.py +12 -0
- {ventpy-0.2.0 → ventpy-0.3.0}/tests/python/test_ventpy.py +59 -12
- ventpy-0.2.0/CHANGELOG.md +0 -77
- ventpy-0.2.0/PKG-INFO +0 -288
- ventpy-0.2.0/README.es.md +0 -262
- ventpy-0.2.0/README.md +0 -262
- ventpy-0.2.0/ROADMAP.md +0 -65
- ventpy-0.2.0/examples/01-demanda-peru/README.md +0 -91
- ventpy-0.2.0/include/ventpy/caudal_polvo.hpp +0 -94
- ventpy-0.2.0/include/ventpy/limites_gases.hpp +0 -130
- ventpy-0.2.0/include/ventpy/normativa.hpp +0 -225
- ventpy-0.2.0/tests/cpp/test_caudal_explosivos.cpp +0 -123
- ventpy-0.2.0/tests/cpp/test_caudal_personal.cpp +0 -120
- ventpy-0.2.0/tests/cpp/test_caudal_polvo.cpp +0 -120
- ventpy-0.2.0/tests/cpp/test_governor.cpp +0 -379
- ventpy-0.2.0/tests/cpp/test_limites_gases.cpp +0 -151
- ventpy-0.2.0/tests/cpp/test_normativa.cpp +0 -161
- ventpy-0.2.0/tests/python/test_multinorma.py +0 -42
- {ventpy-0.2.0 → ventpy-0.3.0}/.github/ISSUE_TEMPLATE/norma-pais.md +0 -0
- {ventpy-0.2.0 → ventpy-0.3.0}/.github/ISSUE_TEMPLATE/numero-incorrecto.md +0 -0
- {ventpy-0.2.0 → ventpy-0.3.0}/.github/workflows/release.yml +0 -0
- {ventpy-0.2.0 → ventpy-0.3.0}/.gitignore +0 -0
- {ventpy-0.2.0 → ventpy-0.3.0}/LICENSE +0 -0
- {ventpy-0.2.0 → ventpy-0.3.0}/examples/02-preset-chile/input.json +0 -0
- {ventpy-0.2.0 → ventpy-0.3.0}/examples/04-red-ventilador/README.md +0 -0
- {ventpy-0.2.0 → ventpy-0.3.0}/examples/04-red-ventilador/input.json +0 -0
- {ventpy-0.2.0 → ventpy-0.3.0}/examples/04-red-ventilador/run.py +0 -0
- {ventpy-0.2.0 → ventpy-0.3.0}/examples/05-ducto-seleccion/README.md +0 -0
- {ventpy-0.2.0 → ventpy-0.3.0}/examples/05-ducto-seleccion/run.py +0 -0
- {ventpy-0.2.0 → ventpy-0.3.0}/include/ventpy/ducto.hpp +0 -0
- {ventpy-0.2.0 → ventpy-0.3.0}/include/ventpy/red.hpp +0 -0
- {ventpy-0.2.0 → ventpy-0.3.0}/include/ventpy/validation.hpp +0 -0
- {ventpy-0.2.0 → ventpy-0.3.0}/include/ventpy/ventilador.hpp +0 -0
- {ventpy-0.2.0 → ventpy-0.3.0}/python/ventpy/visualization.py +0 -0
- {ventpy-0.2.0 → ventpy-0.3.0}/tests/cpp/test_caudal_fugas.cpp +0 -0
- {ventpy-0.2.0 → ventpy-0.3.0}/tests/cpp/test_caudal_termico.cpp +0 -0
- {ventpy-0.2.0 → ventpy-0.3.0}/tests/cpp/test_ducto.cpp +0 -0
- {ventpy-0.2.0 → ventpy-0.3.0}/tests/cpp/test_red.cpp +0 -0
- {ventpy-0.2.0 → ventpy-0.3.0}/tests/cpp/test_validation.cpp +0 -0
- {ventpy-0.2.0 → ventpy-0.3.0}/tests/cpp/test_ventilador.cpp +0 -0
- {ventpy-0.2.0 → ventpy-0.3.0}/tests/python/test_escala.py +0 -0
- {ventpy-0.2.0 → ventpy-0.3.0}/tests/python/test_polvo_termico.py +0 -0
- {ventpy-0.2.0 → ventpy-0.3.0}/tests/python/test_properties.py +0 -0
|
@@ -81,7 +81,7 @@ jobs:
|
|
|
81
81
|
- name: Medir y comprobar umbral
|
|
82
82
|
run: |
|
|
83
83
|
lcov --capture --directory build-cov --output-file cov.info \
|
|
84
|
-
--rc branch_coverage=1 --ignore-errors mismatch,gcov,source
|
|
84
|
+
--rc branch_coverage=1 --ignore-errors mismatch,gcov,source,inconsistent
|
|
85
85
|
lcov --extract cov.info "*/include/ventpy/*" --output-file cov-core.info \
|
|
86
86
|
--rc branch_coverage=1 --ignore-errors unused
|
|
87
87
|
lcov --list cov-core.info --rc branch_coverage=1
|
|
@@ -0,0 +1,483 @@
|
|
|
1
|
+
# Registro de cambios
|
|
2
|
+
|
|
3
|
+
Todas las versiones publicadas de VentPy. El formato sigue
|
|
4
|
+
[Keep a Changelog](https://keepachangelog.com/es-ES/1.1.0/) y el versionado es
|
|
5
|
+
[semántico](https://semver.org/lang/es/).
|
|
6
|
+
|
|
7
|
+
## [0.3.0] — 2026-11-15
|
|
8
|
+
|
|
9
|
+
### El caudal de voladura cambia
|
|
10
|
+
|
|
11
|
+
Hasta la 0.2.1, declarar `gas_volume_per_kg` en `BlastingParams` desviaba el
|
|
12
|
+
cálculo a una fórmula que dividía el volumen total de gases entre el tiempo de
|
|
13
|
+
dilución. Ese cociente es el ritmo al que se generan los gases, no el caudal
|
|
14
|
+
que los diluye hasta un límite de exposición. Con 50 kg de explosivo,
|
|
15
|
+
0,04 m³/kg y 30 min daba 0,067 m³/min, que el redondeo de seguridad subía a 1.
|
|
16
|
+
El defecto alcanzaba a `calculate_blasting_flow` y también a
|
|
17
|
+
`VentilationGovernor`, y estaba presente desde la 0.1.0.
|
|
18
|
+
|
|
19
|
+
Desde la 0.3.0 hay un solo modelo: dilución de CO y de NOx según el tipo de
|
|
20
|
+
explosivo, recambio volumétrico y velocidad mínima de barrido.
|
|
21
|
+
`gas_volume_per_kg` ya no cambia el caudal; solo fija el volumen total de
|
|
22
|
+
gases que se reporta en `total_gas_volume_m3`.
|
|
23
|
+
|
|
24
|
+
**A quién afecta:** a quien haya calculado una demanda con voladura declarando
|
|
25
|
+
`gas_volume_per_kg`. Conviene recalcular: el caudal de voladura sube varios
|
|
26
|
+
órdenes de magnitud y puede pasar a ser el criterio gobernante.
|
|
27
|
+
|
|
28
|
+
| Caso (50 kg de ANFO, 30 min, frente de 12 m²) | 0.2.1 | 0.3.0 |
|
|
29
|
+
|---|---|---|
|
|
30
|
+
| `calculate_blasting_flow`, nivel del mar | 1 m³/min | 6.667 m³/min (dilución de NOx a 3 ppm) |
|
|
31
|
+
| `VentilationGovernor`, 4.200 msnm, con un scoop de 150 HP | `Q_Exp` = 1; gobierna el diésel; total 981 | `Q_Exp` = 11.251; gobierna la voladura; total 12.939 |
|
|
32
|
+
|
|
33
|
+
Quien no declaraba `gas_volume_per_kg` ya obtenía en el Governor el modelo por
|
|
34
|
+
contaminante: sus resultados no cambian.
|
|
35
|
+
|
|
36
|
+
- `VentilationGovernor` exige ahora sección y longitud del frente para toda
|
|
37
|
+
voladura (las toma de `VentilationInput` si la voladura no las trae). Antes,
|
|
38
|
+
con `gas_volume_per_kg`, no las necesitaba.
|
|
39
|
+
- `calculate_blasting_flow` usa el mismo modelo sin corrección por altitud,
|
|
40
|
+
porque no recibe atmósfera, y omite los dos criterios de sección si no se
|
|
41
|
+
dan `face_area_m2` y `face_length_m`. Sin `gas_volume_per_kg` también
|
|
42
|
+
devolvía 1 m³/min.
|
|
43
|
+
- El ejemplo `01-demanda-peru` ya no incluye voladura, para seguir mostrando
|
|
44
|
+
el caso gobernado por el diésel. Su README explica el cambio.
|
|
45
|
+
- El modelo por contaminante es conservador: diluye todo el CO y todo el NOx
|
|
46
|
+
(como NO2) a su límite de 8 h en la norma configurada dentro del tiempo
|
|
47
|
+
declarado, con 20 % de margen (ver «Objetivo de dilución» más abajo). Con el
|
|
48
|
+
DS 024 es criterio de ingeniería para el frente, y la cita lo declara: el
|
|
49
|
+
reglamento fija el caudal de voladura solo en el total de mina.
|
|
50
|
+
|
|
51
|
+
### Total de mina con el DS 024: voladura según el Anexo 38
|
|
52
|
+
|
|
53
|
+
Con el preajuste peruano, `ZoneType.GeneralMine` sigue el Anexo 38 del
|
|
54
|
+
DS 024-2016-EM (texto del DS 023-2017-EM):
|
|
55
|
+
|
|
56
|
+
- Con equipos diésel (num. 1), la voladura no entra en el total. El resultado
|
|
57
|
+
lo advierte y `q_blasting_m3min` queda en 0.
|
|
58
|
+
- Sin equipos diésel (num. 2 lit. e), rige el mayor entre el total con fugas y
|
|
59
|
+
`Q_Ex = A × V × N`: área promedio de labores, velocidad mínima del Art. 248
|
|
60
|
+
(25 m/min con ANFO u otros agentes de voladura, 20 m/min con dinamita) y
|
|
61
|
+
niveles en voladura, el campo nuevo `BlastingParams.blasting_levels`
|
|
62
|
+
(por defecto 1). `Q_Ex` no lleva fugas.
|
|
63
|
+
|
|
64
|
+
**A quién afecta:** a quien calcule el total de mina con voladura bajo el
|
|
65
|
+
DS 024. Hasta ahora se sumaba el caudal por dilución de contaminantes; con
|
|
66
|
+
50 kg de ANFO a 2.500 msnm, sin diésel, eso agregaba 5.428 m³/min y ahora
|
|
67
|
+
agrega 300 (12 m² × 25 m/min × 1 nivel). Chile, Colombia y México no tienen
|
|
68
|
+
un equivalente al Anexo 38 y siguen sumando la dilución.
|
|
69
|
+
|
|
70
|
+
### Advertencia de velocidad máxima
|
|
71
|
+
|
|
72
|
+
`VentilationGovernor` advierte cuando la velocidad en el frente, la rampa o el
|
|
73
|
+
tajeo supera la máxima de la norma: 250 m/min en Perú (DS 024, Art. 248),
|
|
74
|
+
150 m/min en Chile (DS 132, Art. 138 inc. 3) y 6 m/s (360 m/min) en Colombia
|
|
75
|
+
(Decreto 1886, Art. 56 par. 1). México no fija máxima y no se advierte. Solo
|
|
76
|
+
es un aviso: el caudal requerido no cambia. La función `max_air_velocity_mpm`
|
|
77
|
+
devuelve esos topes.
|
|
78
|
+
|
|
79
|
+
### Valores y citas revisados contra el texto oficial de cada norma
|
|
80
|
+
|
|
81
|
+
Cada valor que la librería atribuye a una norma se volvió a cotejar con el
|
|
82
|
+
texto vigente (DS 024-2016-EM consolidado y DS 023-2017-EM; DS 132 y DS 594;
|
|
83
|
+
Decreto 1886 de 2015 con el 944 de 2022; NOM-023-STPS-2012 y
|
|
84
|
+
NOM-010-STPS-2014). Varios valores compartidos entre normas seguían con
|
|
85
|
+
defaults peruanos, y algunos defaults peruanos no eran los de la norma. Los
|
|
86
|
+
cambios de resultados van primero, cada uno con a quién afecta.
|
|
87
|
+
|
|
88
|
+
#### El caudal por persona nunca baja del mínimo de la norma
|
|
89
|
+
|
|
90
|
+
`PersonnelFlowCalculator.calculate_full` multiplicaba el caudal por persona
|
|
91
|
+
por un factor de actividad (0,6 en reposo, 0,8 ligera). Ninguna norma
|
|
92
|
+
implementada reduce el mínimo por persona según la actividad: ahora la
|
|
93
|
+
actividad y la densidad pueden subirlo, nunca bajarlo.
|
|
94
|
+
|
|
95
|
+
**A quién afecta:** a quien calcule con `ActivityLevel.Rest` o `Light` en
|
|
96
|
+
`VentilationGovernor`. 20 trabajadores en reposo a 0 msnm daban 36 m³/min
|
|
97
|
+
(20 × 3 × 0,6); ahora dan 60 (DS 024, Art. 247). Con México, 100
|
|
98
|
+
trabajadores en reposo daban 90; ahora 150 (8.4.4 a) 1).
|
|
99
|
+
|
|
100
|
+
#### Bordes de altitud: rige la banda alta
|
|
101
|
+
|
|
102
|
+
El Art. 247 del DS 024 pone 1.500 y 3.000 msnm en dos bandas a la vez, y el
|
|
103
|
+
Art. 54 del Decreto 1886 hace lo mismo con 1.500. En el umbral exacto ahora
|
|
104
|
+
rige la banda de mayor caudal (antes la menor). La cita dice `(>=1500 msnm)`.
|
|
105
|
+
|
|
106
|
+
**A quién afecta:** a quien calcule exactamente a 1.500, 3.000 o 4.000 msnm
|
|
107
|
+
con Perú (3 → 4, 4 → 5 y 5 → 6 m³/min por persona) o a 1.500 msnm con
|
|
108
|
+
Colombia (3 → 6).
|
|
109
|
+
|
|
110
|
+
#### Velocidades mínimas según la norma
|
|
111
|
+
|
|
112
|
+
`get_min_velocity` tomaba 15 m/min en el frente, 18 en la rampa y 12 en el
|
|
113
|
+
tajeo para toda norma, por debajo de los 20 m/min del DS 024, Art. 248.
|
|
114
|
+
Ahora devuelve el mayor entre ese valor por tipo de labor (que queda como
|
|
115
|
+
criterio de ingeniería) y la mínima de la norma: Perú 20 m/min, 25 con ANFO
|
|
116
|
+
u otros agentes de voladura (Art. 248); Chile 15 (DS 132, Art. 138 inc. 3);
|
|
117
|
+
México 15,24 donde opere maquinaria diésel (8.4.4 b); Colombia no fija mínima
|
|
118
|
+
fuera del carbón y conserva los valores por labor. El barrido de la voladura
|
|
119
|
+
(`BlastingParams.min_velocity_mps`) tampoco baja de la mínima de la norma.
|
|
120
|
+
|
|
121
|
+
**A quién afecta:**
|
|
122
|
+
- Perú: el piso de velocidad de `Q_Per` en un frente de 12 m² sube de 180 a
|
|
123
|
+
240 m³/min (12 × 20), y con voladura de ANFO a 300 (12 × 25). El barrido de
|
|
124
|
+
la voladura sube de 18 a 25 m/min con ANFO y a 20 con dinamita. Un frente
|
|
125
|
+
con 10 trabajadores sin flota pasa de 207 a 276 m³/min en el ventilador.
|
|
126
|
+
- Chile: el tajeo sube de 12 a 15 m/min.
|
|
127
|
+
- México con diésel: frente y tajeo suben a 15,24 m/min.
|
|
128
|
+
|
|
129
|
+
#### Cobertura: límites de velocidad de la norma configurada
|
|
130
|
+
|
|
131
|
+
`CoverageParams` traía 20 y 250 m/min (Perú) para todas las normas, y el
|
|
132
|
+
piso de 25 m/min con ANFO se aplicaba en cualquier país. Ahora
|
|
133
|
+
`min_velocity_mpm` y `max_velocity_mpm` valen 0 por defecto, que significa
|
|
134
|
+
«los de la norma», y un valor propio solo puede endurecerlos. Los límites
|
|
135
|
+
efectivos los da `CoverageCalculator.velocity_limits(params, config)`:
|
|
136
|
+
|
|
137
|
+
| Norma | Mínimo | Máximo |
|
|
138
|
+
|---|---|---|
|
|
139
|
+
| Perú (DS 024, Art. 248) | 20 m/min; 25 con ANFO | 250 m/min |
|
|
140
|
+
| Chile (DS 132, Art. 138 inc. 3) | 15 m/min | 150 m/min |
|
|
141
|
+
| Colombia (Decreto 1886, Art. 56 par. 1) | 15 m/min, criterio de ingeniería | 360 m/min |
|
|
142
|
+
| México (NOM-023, 8.4.4 b) | 15,24 m/min | sin máximo |
|
|
143
|
+
|
|
144
|
+
**A quién afecta:** a quien evalúe estaciones de aforo con Chile (una
|
|
145
|
+
estación a 160 m/min ahora no cumple), Colombia (300 m/min ahora cumple;
|
|
146
|
+
el ANFO ya no sube el mínimo) o México (la máxima ya no se aplica). Con
|
|
147
|
+
Perú no cambia nada. Quien leía `CoverageParams().min_velocity_mpm` esperando
|
|
148
|
+
20 ahora lee 0.
|
|
149
|
+
|
|
150
|
+
#### Velocidad máxima de Chile
|
|
151
|
+
|
|
152
|
+
`max_air_velocity_mpm(DS132_Chile)` devuelve 150 m/min (Art. 138 inc. 3: «Las
|
|
153
|
+
velocidades, como promedio, no podrán ser mayores de ciento cincuenta metros
|
|
154
|
+
por minuto»). Antes no había máxima chilena.
|
|
155
|
+
|
|
156
|
+
**A quién afecta:** a quien calcule con Chile: el Governor advierte sobre
|
|
157
|
+
150 m/min y la cobertura marca las estaciones por encima.
|
|
158
|
+
|
|
159
|
+
#### Objetivo de dilución: el límite de 8 h de la norma
|
|
160
|
+
|
|
161
|
+
La dilución de gases de voladura (`BlastingParams.target_co_ppm` y
|
|
162
|
+
`target_nox_ppm`) y de escape diésel usaba CO 25 ppm y NOx 5 ppm en toda
|
|
163
|
+
norma. Los 5 ppm son el STEL de NO2 del Anexo 15; su TWA es 3 ppm. Ahora el
|
|
164
|
+
objetivo es el TWA de la tabla de gases de la norma configurada
|
|
165
|
+
(`dilution_target_ppm`); si una norma no fija TWA para un gas, el más
|
|
166
|
+
estricto entre su STEL y su techo. El NOx se diluye como NO2. Los objetivos
|
|
167
|
+
de `BlastingParams` valen 0 por defecto («el de la norma») y el usuario
|
|
168
|
+
puede fijar el suyo; los resultados de voladura y de diésel muestran el
|
|
169
|
+
objetivo usado (`target_co_ppm`, `target_nox_ppm`). Las constantes de
|
|
170
|
+
referencia `TLV_NO2_PPM` y `TLV_SO2_PPM` pasan a 3 y 2 ppm (Anexo 15, TWA).
|
|
171
|
+
|
|
172
|
+
| Norma | CO | NO2 | Caudal por NOx frente a la 0.2.1 |
|
|
173
|
+
|---|---|---|---|
|
|
174
|
+
| Perú (Anexo 15) | 25 ppm | 3 ppm | × 5/3 (+67 %) |
|
|
175
|
+
| Chile (DS 594, Art. 66) | 44 ppm | 2,6 ppm | × 5/2,6 |
|
|
176
|
+
| Colombia (Art. 39) | 25 ppm | 0,2 ppm | × 25 |
|
|
177
|
+
| México (NOM-010, fila 320) | 25 ppm | 0,2 ppm | × 25 |
|
|
178
|
+
|
|
179
|
+
**A quién afecta:** a todo cálculo con voladura o con la dilución por
|
|
180
|
+
contaminante del diésel. Con Colombia y México los caudales por NOx suben
|
|
181
|
+
25 veces y pasan a gobernar con frecuencia: es lo que exige su límite de
|
|
182
|
+
0,2 ppm. Quien quiera conservar el criterio anterior debe fijar
|
|
183
|
+
`target_nox_ppm = 5.0` y asumirlo como criterio propio.
|
|
184
|
+
|
|
185
|
+
#### Simultaneidad del diésel: 1,0 por defecto
|
|
186
|
+
|
|
187
|
+
`VentilationInput.simultaneity_factor` valía 0,85. Ninguna norma prevé
|
|
188
|
+
simultaneidad; con el DS 024, `Q_Eq = 3 × HP × Dm × Fu` (Anexo 38) ya la
|
|
189
|
+
incluye en Dm × Fu. Ahora vale 1,0, y con un valor menor el resultado
|
|
190
|
+
advierte que `Q_Eq` queda bajo la norma. El factor por HP tampoco baja ya del
|
|
191
|
+
valor de la norma por la corrección volumétrica del nivel del mar (0,99999).
|
|
192
|
+
|
|
193
|
+
**A quién afecta:** a quien no fijaba la simultaneidad: `Q_Eq` por factor HP
|
|
194
|
+
sube 1/0,85 (+17,6 %). Con 100 HP a 0 msnm el Governor daba 255 m³/min;
|
|
195
|
+
ahora 300, el mínimo del Anexo 38.
|
|
196
|
+
|
|
197
|
+
#### Total de mina peruano: madera y temperatura del Anexo 38
|
|
198
|
+
|
|
199
|
+
El total de mina con el DS 024 (`ZoneType.GeneralMine`) suma ahora los dos
|
|
200
|
+
términos del Anexo 38 que faltaban, con entradas opcionales nuevas de
|
|
201
|
+
`VentilationInput`:
|
|
202
|
+
|
|
203
|
+
- `Q_Ma = T × u` (lit. b): `production_t_per_shift` (T, t métricas húmedas
|
|
204
|
+
por guardia) y `timber_consumption_pct`. u = 0 bajo 20 %; 0,60 de 20 a
|
|
205
|
+
40 %; 1,00 de 41 a 70 %; 1,25 sobre 70 % (`timber_production_factor`). El
|
|
206
|
+
num. 2 del anexo escribe «> 71» en la última fila; el num. 1 y el Art. 252
|
|
207
|
+
dicen «> 70», que es lo que se usa. Entre 40 y 41 % rige 1,00.
|
|
208
|
+
- `Q_Te = Vm × A × N` (lit. c): `hot_levels` (N, niveles con temperatura
|
|
209
|
+
mayor a 23 °C), A = `face_area_m2` y Vm = 30 m/min.
|
|
210
|
+
|
|
211
|
+
Entran en `Q_T1 = Q_Tr + Q_Ma + Q_Te + Q_Eq`, con fugas del 15 % de `Q_T1`.
|
|
212
|
+
`Q_Te` y el balance térmico (`q_thermal`) responden al mismo concepto, el
|
|
213
|
+
aire para la temperatura de confort del Art. 252 lit. d: rige el mayor de
|
|
214
|
+
los dos, sin sumarlos. El polvo sigue sumando como criterio de ingeniería.
|
|
215
|
+
Sin sus datos cada término vale 0 y el resultado advierte que el total no lo
|
|
216
|
+
incluye. El resultado expone `q_timber_m3min` y `q_temperature_m3min`, y la
|
|
217
|
+
CLI acepta las tres entradas.
|
|
218
|
+
|
|
219
|
+
**A quién afecta:** a quien calcule el total de mina peruano. Sin las
|
|
220
|
+
entradas nuevas el número no cambia, pero aparecen dos advertencias. Con
|
|
221
|
+
ellas el total sube: 100 t por guardia con 30 % de madera agregan 60 m³/min;
|
|
222
|
+
dos niveles calientes con 12 m² agregan 720, o nada si el balance térmico ya
|
|
223
|
+
pedía más.
|
|
224
|
+
|
|
225
|
+
#### Polvo: límite de la norma y corrección Fa de Chile
|
|
226
|
+
|
|
227
|
+
`DustParams.target_concentration_mg_m3` vale 0 por defecto, que significa
|
|
228
|
+
«el límite de la norma»: Perú 3 mg/m³ (Art. 111); Chile 2,4 mg/m³ de polvos
|
|
229
|
+
no especificados, fracción respirable (DS 594, Art. 66), multiplicado sobre
|
|
230
|
+
1.000 msnm por Fa = P/760 con dos decimales (Art. 63); México 3 mg/m³
|
|
231
|
+
(NOM-010, fila 609); Colombia 3 mg/m³ como criterio de ingeniería (el Art. 74
|
|
232
|
+
remite a la ACGIH). La advertencia de objetivo alto compara con ese límite y
|
|
233
|
+
no con 3 fijo. `calculate_dust_flow` acepta la atmósfera (`atm`) para la
|
|
234
|
+
corrección por altitud.
|
|
235
|
+
|
|
236
|
+
**A quién afecta:** a quien calcule polvo con Chile usando el objetivo por
|
|
237
|
+
defecto: el caudal sube 25 % al nivel del mar (3 → 2,4 mg/m³) y 81 % a
|
|
238
|
+
3.000 msnm (2,4 × 0,69 = 1,656 mg/m³).
|
|
239
|
+
|
|
240
|
+
#### Chile: óxido nítrico en la tabla de gases
|
|
241
|
+
|
|
242
|
+
La tabla chilena incluye el NO con LPP de 22 ppm (DS 594, Art. 66).
|
|
243
|
+
`lmp_for(DS132_Chile, NO)` ya no lanza error.
|
|
244
|
+
|
|
245
|
+
**A quién afecta:** a quien consulte el NO con Chile (`ventpy lmp --norma
|
|
246
|
+
chile --gas NO` ahora responde) o cuente las filas de la tabla chilena (7 → 8).
|
|
247
|
+
|
|
248
|
+
#### Citas corregidas (sin cambio de números)
|
|
249
|
+
|
|
250
|
+
- Perú: el caudal por persona cita el Art. 247 (el Art. 236 vigente trata de
|
|
251
|
+
vibraciones por voladura); el factor diésel, el Art. 252 lit. e y el
|
|
252
|
+
Anexo 38 num. 1 lit. d (no el Art. 246); el reingreso tras la voladura, el
|
|
253
|
+
Art. 240 (no los Arts. 243-244); el O2 de 19,5 %, el Art. 246 lit. b; las
|
|
254
|
+
mangas a 15 m, el Art. 246 lit. f; el circuito de ventilación, el Art. 246
|
|
255
|
+
lit. c; los límites de gases, el Art. 110 y el Anexo 15 (no el Art. 108).
|
|
256
|
+
El tope de 30 min de dilución deja de llamarse «max normativo»: es criterio
|
|
257
|
+
de ingeniería, como el volumen de 0,04 m³/kg.
|
|
258
|
+
- Chile: polvo y sílice citan el DS 594, Art. 66 (cuarzo 0,08 mg/m³;
|
|
259
|
+
cristobalita y tridimita 0,04); la carga térmica, el Art. 143 que remite al
|
|
260
|
+
DS 594, Arts. 96 a 98 (TGBH); la cobertura de mina, el Art. 139; la
|
|
261
|
+
velocidad, el Art. 138 inc. 3. El metano del Art. 274 se aclara como del
|
|
262
|
+
Título V (carbón). El factor diésel declara que la pequeña minería
|
|
263
|
+
(Título XV, Art. 627: 3 m³/min por HP) no está cubierta por el preajuste.
|
|
264
|
+
- Colombia: la advertencia de velocidad máxima cita el Art. 56 par. 1 y
|
|
265
|
+
menciona los 4,5 m/s de los tajos de carbón (par. 2); ya no remite a
|
|
266
|
+
«límites configurados en CoverageParams».
|
|
267
|
+
- México: la corrección por altitud del factor diésel se declara criterio de
|
|
268
|
+
ingeniería; el objetivo térmico no alcanzable también (igual en las otras
|
|
269
|
+
tres normas).
|
|
270
|
+
|
|
271
|
+
#### API
|
|
272
|
+
|
|
273
|
+
- Nuevas en C++ y Python: `min_air_velocity_mpm`, `max_air_velocity_mpm`
|
|
274
|
+
(ahora también en Python), `dilution_target_ppm`,
|
|
275
|
+
`timber_production_factor` y `CoverageCalculator.velocity_limits`.
|
|
276
|
+
- `get_min_velocity(zone_type, standard=DS024_Peru, diesel=False,
|
|
277
|
+
blasting_agents=False)` depende de la norma; con un solo argumento devuelve
|
|
278
|
+
el valor peruano.
|
|
279
|
+
- Campos nuevos: `VentilationInput.production_t_per_shift`,
|
|
280
|
+
`timber_consumption_pct` y `hot_levels`;
|
|
281
|
+
`VentilationDemandResult.q_timber_m3min` y `q_temperature_m3min`;
|
|
282
|
+
`target_co_ppm` y `target_nox_ppm` en los resultados de voladura y diésel.
|
|
283
|
+
|
|
284
|
+
#### Ejemplos
|
|
285
|
+
|
|
286
|
+
`01-demanda-peru` pasa de 981 a 1.923 m³/min, `02-preset-chile` de 981 a
|
|
287
|
+
2.219 y en `03-cobertura-levantamiento` cada zona requiere 276 m³/min en vez
|
|
288
|
+
de 207 (los aforos del ejemplo se ajustaron para conservar el caso). Cada
|
|
289
|
+
README explica la derivación.
|
|
290
|
+
|
|
291
|
+
### Pequeña minería chilena, sílice y tajos de carbón
|
|
292
|
+
|
|
293
|
+
- **`RegulatoryConfig.chile_small_mining()`**: preajuste para faenas de hasta
|
|
294
|
+
5.000 t/mes (DS 132, Título XV, ámbito del Art. 594). Igual a `chile()` salvo
|
|
295
|
+
3 m³/min por HP (Art. 627); las citas de caudal por persona y por HP nombran
|
|
296
|
+
el Art. 627.
|
|
297
|
+
- **Sílice respirable**: con `DustParams.silica_content_percent` > 0, el
|
|
298
|
+
objetivo de polvo por defecto es el menor entre el límite respirable y el
|
|
299
|
+
límite de sílice dividido entre la fracción de sílice. Perú 0,05 mg/m³
|
|
300
|
+
(Anexo 15), Chile cuarzo 0,08 o, con `silica_cristobalite_or_tridymite`,
|
|
301
|
+
0,04 mg/m³ (DS 594, Art. 66, con Fa), México 0,025 mg/m³ (NOM-010, fila 668).
|
|
302
|
+
Colombia remite a la ACGIH sin fijar el valor: solo se advierte.
|
|
303
|
+
- **`VentilationInput.coal_mine`**: con Colombia, el máximo en tajos baja a
|
|
304
|
+
4,5 m/s = 270 m/min (Decreto 1886, Art. 56 par. 2). El resultado advierte que
|
|
305
|
+
las demás reglas de carbón no están implementadas.
|
|
306
|
+
|
|
307
|
+
**A quién afecta:** a quien declare contenido de sílice sin fijar un objetivo
|
|
308
|
+
propio: con 10 % de sílice en Perú el objetivo baja de 3 a 0,5 mg/m³ y el
|
|
309
|
+
caudal por polvo sube seis veces. Los otros dos cambios solo actúan si se
|
|
310
|
+
eligen.
|
|
311
|
+
|
|
312
|
+
### Metadatos del paquete
|
|
313
|
+
|
|
314
|
+
- `pyproject.toml` declara los clasificadores de Python 3.9, 3.10, 3.11, 3.12 y 3.13, las
|
|
315
|
+
mismas versiones para las que `cibuildwheel` ya compila ruedas. Así PyPI las muestra en la
|
|
316
|
+
ficha del paquete. No cambia el código.
|
|
317
|
+
- Ya no se publican ruedas para Linux de 32 bits (`manylinux_i686`): su contenedor de
|
|
318
|
+
compilación no logra instalar `scikit-build-core`. En esa plataforma `pip` compila desde
|
|
319
|
+
el código fuente publicado.
|
|
320
|
+
|
|
321
|
+
### Normas de Colombia y México
|
|
322
|
+
|
|
323
|
+
Dos preajustes nuevos, con el mismo patrón que el chileno: cada valor cita el
|
|
324
|
+
artículo o numeral leído en el texto vigente, y donde la norma no regula un
|
|
325
|
+
concepto la cita lo declara en vez de tomar prestado el artículo de otro país.
|
|
326
|
+
|
|
327
|
+
| Concepto | Colombia (Decreto 1886 de 2015) | México (NOM-023-STPS-2012) |
|
|
328
|
+
|---|---|---|
|
|
329
|
+
| Caudal por persona | 3 m³/min hasta 1.500 msnm y 6 de 1.500 en adelante (Art. 54, nums. 1 y 2) | 1,50 m³/min, sin escala por altitud (numeral 8.4.4 a) 1) |
|
|
330
|
+
| Caudal por HP diésel | 6 m³/min con CO en el escape ≤ 0,12 % (Art. 54, par. 2, num. 1) | 2,13 m³/min (numeral 8.4.4 a) 2) |
|
|
331
|
+
| Voladura | Sin tiempo de dilución; reingreso no antes de 15 min (Art. 157) | Sin tiempo de dilución; reconocimiento a los 30 min y sin humo (numeral 8.6.9 g) |
|
|
332
|
+
| Gases | Tabla del Art. 39; oxígeno en el Art. 38 y metano en el Art. 53 | NOM-010-STPS-2014, Tabla I.1, por remisión de la NOM-023 |
|
|
333
|
+
| Polvo | Remite a los VLP de la ACGIH (Art. 74) | NOM-010-STPS-2014, Tabla I.1 |
|
|
334
|
+
| Carga térmica | Temperatura efectiva (Arts. 217 y 218): el piso de 30 m/min queda como criterio de ingeniería | Índice TGBH de la NOM-015-STPS-2001: el piso de 30 m/min queda como criterio de ingeniería |
|
|
335
|
+
|
|
336
|
+
- `RegulatoryConfig.colombia()` y `RegulatoryConfig.mexico()`, los miembros
|
|
337
|
+
`RegulatoryStandard.D1886_Colombia` y `RegulatoryStandard.NOM023_Mexico`, y
|
|
338
|
+
`--norma colombia|mexico` en `ventpy demanda`, `ventpy lmp` y
|
|
339
|
+
`ventpy cobertura`.
|
|
340
|
+
- **Colombia, borde de 1.500 msnm.** Las dos bandas del Art. 54 incluyen el
|
|
341
|
+
1.500 en su texto. Rige la regla común de la librería: a 1.500 msnm exactos
|
|
342
|
+
aplica la banda alta (6 m³/min).
|
|
343
|
+
- **Colombia, factor diésel.** El preajuste usa 6 m³/min por HP. Quien acredite
|
|
344
|
+
CO en el escape ≤ 0,08 % puede construir su configuración con 4 (Art. 54,
|
|
345
|
+
par. 2, num. 2). Con CO sobre 0,12 % el decreto no da valor.
|
|
346
|
+
- **México, oxígeno.** La NOM-023 no fija el mínimo de oxígeno en labores. La
|
|
347
|
+
tabla trae 19,5 % como criterio de ingeniería y la cita lo dice.
|
|
348
|
+
- **México, carbón.** La NOM-023 exceptúa las minas de carbón, que se rigen por
|
|
349
|
+
la NOM-032-STPS-2008. Este preajuste no las cubre.
|
|
350
|
+
- En las dos tablas de gases el SO2 solo tiene límite de corto tiempo: su
|
|
351
|
+
`twa_8h` es `None`, no cero.
|
|
352
|
+
- Colombia se verificó contra el texto consolidado con el Decreto 944 de 2022
|
|
353
|
+
y México contra el DOF del 11-oct-2012 y del 28-abr-2014.
|
|
354
|
+
|
|
355
|
+
### Correcciones
|
|
356
|
+
|
|
357
|
+
- `shock_factors()` listaba `x = 0.0` en expansión, contracción, codos y unión,
|
|
358
|
+
donde el factor sale por fórmula o es manual. Un cero se lee como «sin
|
|
359
|
+
pérdida»: ahora `x` es `None` en esas filas.
|
|
360
|
+
|
|
361
|
+
### Documentación de la API
|
|
362
|
+
|
|
363
|
+
- Los campos de `GasLimit` que la norma no fija valen `None`, y la ayuda lo
|
|
364
|
+
dice.
|
|
365
|
+
- `calculate_diesel_flow` aclara que solo aplica el factor por HP de la norma;
|
|
366
|
+
la dilución de CO y NOx por contaminante la calcula `VentilationGovernor`.
|
|
367
|
+
|
|
368
|
+
## [0.2.1] — 2026-08-20
|
|
369
|
+
|
|
370
|
+
### La cita normativa sigue a la norma configurada
|
|
371
|
+
|
|
372
|
+
Hasta 0.2.0 la referencia legal de cada resultado estaba escrita como literal
|
|
373
|
+
peruano dentro de cada calculador y no consultaba la norma de la
|
|
374
|
+
configuración. Con `RegulatoryConfig.chile()` los caudales eran correctos,
|
|
375
|
+
pero la cita que los acompañaba era el DS 024-2016-EM peruano.
|
|
376
|
+
|
|
377
|
+
**A quién afecta:** a quien haya emitido informes con el preajuste chileno. Los
|
|
378
|
+
números no cambian —ni uno solo—; lo que cambia es el respaldo legal impreso
|
|
379
|
+
junto a ellos. Conviene reemitir esos informes: citaban el reglamento peruano
|
|
380
|
+
en una faena chilena.
|
|
381
|
+
|
|
382
|
+
| Resultado | Perú (DS 024) | Chile (DS 132) |
|
|
383
|
+
|---|---|---|
|
|
384
|
+
| Caudal por persona | Art. 236, con la escala por altitud del Art. 247 | **Art. 138**, sin escala por altitud |
|
|
385
|
+
| Caudal por HP diésel | Art. 246 | **Art. 132** |
|
|
386
|
+
| Dilución tras voladura | Art. 243-244 | **Arts. 156, 571 y 585** (reingreso). El DS 132 no fija tiempo de dilución ni volumen de gases por kg: son criterio de ingeniería, y la cita lo dice |
|
|
387
|
+
| Polvo respirable | Art. 111 | Sin límite verificado: la cita declara el vacío y atribuye la concentración objetivo a criterio de ingeniería |
|
|
388
|
+
| Carga térmica | Art. 252 lit. d | Sin criterio verificado: el piso de 30 m/min se mantiene —el caudal es el mismo— pero la cita lo declara criterio de ingeniería |
|
|
389
|
+
| Cobertura y velocidad del aire | Art. 252 lit. f/g y Art. 248 | Sin régimen ni límites verificados: la cita declara el vacío y remite a los umbrales configurados |
|
|
390
|
+
|
|
391
|
+
Donde el DS 132 no regula un concepto, la cita lo dice explícitamente en vez de
|
|
392
|
+
trasladar el artículo peruano. Ningún artículo chileno se cita sin verificar
|
|
393
|
+
contra el texto vigente (LeyChile idNorma=221064, versión 09-abr-2024).
|
|
394
|
+
|
|
395
|
+
### Cambios
|
|
396
|
+
|
|
397
|
+
- Nueva función `regulation_reference(topic, config)` en `normativa.hpp`: único
|
|
398
|
+
lugar del núcleo donde vive el texto de una cita. Cada calculador la consulta
|
|
399
|
+
en lugar de llevar su propio literal.
|
|
400
|
+
- `CoverageCalculator.compare_zone` acepta un cuarto argumento `config` que fija
|
|
401
|
+
la norma de la cita. Su valor por defecto es el preajuste peruano, igual que
|
|
402
|
+
el constructor por defecto de `RegulatoryConfig`; el código existente no
|
|
403
|
+
cambia de comportamiento. `analyze_survey` propaga la configuración que ya
|
|
404
|
+
recibía.
|
|
405
|
+
- Las advertencias de sílice, de concentración de polvo sobre el umbral, de
|
|
406
|
+
estrés térmico y de velocidad fuera de rango también siguen la norma activa.
|
|
407
|
+
|
|
408
|
+
### Versiones
|
|
409
|
+
|
|
410
|
+
- `CMakeLists.txt` declaraba 0.1.0 mientras `pyproject.toml` y el paquete
|
|
411
|
+
Python declaraban 0.2.0. Las tres quedan en 0.2.1.
|
|
412
|
+
|
|
413
|
+
## [0.2.0] — 2026-08-20
|
|
414
|
+
|
|
415
|
+
### ⚠️ Los resultados cambian respecto de 0.1.0
|
|
416
|
+
|
|
417
|
+
Esta versión corrige tres citas normativas del núcleo. **Un cálculo hecho con
|
|
418
|
+
0.1.0 puede quedar por debajo del mínimo legal**, así que conviene rehacer los
|
|
419
|
+
que se hayan emitido con esa versión.
|
|
420
|
+
|
|
421
|
+
| Corrección | 0.1.0 | 0.2.0 |
|
|
422
|
+
|---|---|---|
|
|
423
|
+
| Escala de caudal por persona (DS 024-2016-EM, **Art. 247**) | 3/4/5 m³/min con umbrales de 3.000 y 4.000 msnm | **3/4/5/6** m³/min con umbrales de **1.500, 3.000 y 4.000** msnm, que es el texto vigente del artículo |
|
|
424
|
+
| Polvo respirable | citado como "Art. 103-107" | **Art. 111**: límite de 3 mg/m³ para jornada de 8 h, con paralización de la labor si se supera |
|
|
425
|
+
| Temperatura efectiva máxima | citada como "Art. 240: 30 °C" | No existe en la norma vigente (proviene del derogado DS 055-2010-EM). El criterio normativo real es el **Art. 252 lit. d** (velocidad mínima de 30 m/min con temperatura seca entre 24 y 29 °C) y la remisión del **Art. 104 / Anexo 13** para estrés térmico |
|
|
426
|
+
|
|
427
|
+
El efecto práctico de la primera corrección: toda mina por encima de 1.500 msnm
|
|
428
|
+
exige más aire por persona del que 0.1.0 calculaba.
|
|
429
|
+
|
|
430
|
+
### Cambio incompatible
|
|
431
|
+
|
|
432
|
+
- El constructor de `RegulatoryConfig` pasa de 10 a 12 parámetros por el tercer
|
|
433
|
+
umbral de altitud del Art. 247. Quien use los preajustes
|
|
434
|
+
(`RegulatoryConfig.peru()`, `.chile()`, `.for_standard()`) no necesita
|
|
435
|
+
cambiar nada; solo afecta a quien construya la configuración parámetro a
|
|
436
|
+
parámetro.
|
|
437
|
+
|
|
438
|
+
### Nuevas capacidades
|
|
439
|
+
|
|
440
|
+
- **Multi-norma.** Preajustes por país mediante `peru()`, `chile()` y
|
|
441
|
+
`for_standard()`. El preajuste chileno implementa el DS 132 (Art. 138:
|
|
442
|
+
3 m³/min por persona sin escalón por altitud; Art. 132: 2,83 m³/min por HP
|
|
443
|
+
efectivo al freno).
|
|
444
|
+
- **Límites máximos permisibles de gases** consultables por norma
|
|
445
|
+
(`gas_limits`, `lmp_for`): Perú (DS 024, Anexo 15) y Chile (DS 594 / DS 132),
|
|
446
|
+
con la cita de cada valor. Un gas no regulado por la norma lanza una
|
|
447
|
+
excepción en vez de devolver un valor por omisión.
|
|
448
|
+
- **Cobertura y déficit de ventilación** (Art. 252, literales f y g): compara
|
|
449
|
+
el caudal medido en campo, directo o por estaciones de aforo, contra el
|
|
450
|
+
requerido, por labor y para la mina completa, con verificación de la
|
|
451
|
+
velocidad del aire del Art. 248.
|
|
452
|
+
- **Red de ventilación**: resistencias de Atkinson con corrección por densidad
|
|
453
|
+
y pérdidas por choque, dimensionamiento de ducto con criterio técnico y
|
|
454
|
+
económico, balance de red por el método de Hardy Cross con detección
|
|
455
|
+
automática de mallas, y curva de ventilador con punto de operación y margen
|
|
456
|
+
de entrada en pérdida.
|
|
457
|
+
- **Polvo respirable y carga térmica** integrados al cálculo consolidado.
|
|
458
|
+
- **Interfaz de línea de comandos** `ventpy` con cinco subcomandos sobre
|
|
459
|
+
archivos JSON y códigos de salida pensados para automatización: 0 correcto,
|
|
460
|
+
1 error de entrada y 2 resultado no confiable.
|
|
461
|
+
- **Ejemplos resueltos** en `examples/`, cada uno con su comando, la salida
|
|
462
|
+
esperada y el artículo que lo sustenta.
|
|
463
|
+
|
|
464
|
+
### Correcciones
|
|
465
|
+
|
|
466
|
+
- El solver de red rechaza resistencias no finitas. Un valor infinito se
|
|
467
|
+
aceptaba y el balance devolvía caudales inválidos marcados como convergidos.
|
|
468
|
+
- Las funciones de validación rechazan NaN e infinito en todos sus parámetros.
|
|
469
|
+
- El cálculo simplificado de gases de voladura recupera la advertencia por
|
|
470
|
+
exceder el tiempo máximo de dilución del Art. 243.
|
|
471
|
+
|
|
472
|
+
### Interno
|
|
473
|
+
|
|
474
|
+
- La suite pasó de 55 a 197 pruebas en C++ y 151 en Python, incluidas pruebas
|
|
475
|
+
basadas en propiedades y de escala hasta 500 ramales.
|
|
476
|
+
- Integración continua en Linux, macOS y Windows, con analizadores dinámicos
|
|
477
|
+
de memoria y comportamiento indefinido, y medición de cobertura.
|
|
478
|
+
|
|
479
|
+
## [0.1.0] — 2026-08-16
|
|
480
|
+
|
|
481
|
+
- Primera versión publicada: cálculo de demanda de ventilación según
|
|
482
|
+
DS 024-2016-EM (personal, equipos diésel, explosivos y fugas), correcciones
|
|
483
|
+
atmosféricas por altitud y visualización opcional.
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
cmake_minimum_required(VERSION 3.20)
|
|
2
2
|
project(ventpy
|
|
3
|
-
VERSION 0.
|
|
3
|
+
VERSION 0.3.0
|
|
4
4
|
DESCRIPTION "High-performance mine ventilation calculation library"
|
|
5
5
|
LANGUAGES CXX
|
|
6
6
|
)
|
|
@@ -98,6 +98,7 @@ if(VENTPY_BUILD_TESTS)
|
|
|
98
98
|
tests/cpp/test_caudal_termico.cpp
|
|
99
99
|
tests/cpp/test_governor.cpp
|
|
100
100
|
tests/cpp/test_normativa.cpp
|
|
101
|
+
tests/cpp/test_citas_normativas.cpp
|
|
101
102
|
tests/cpp/test_limites_gases.cpp
|
|
102
103
|
tests/cpp/test_cobertura.cpp
|
|
103
104
|
tests/cpp/test_atkinson.cpp
|
|
@@ -1,8 +1,9 @@
|
|
|
1
1
|
# Contributing to VentPy · Cómo contribuir a VentPy
|
|
2
2
|
|
|
3
3
|
VentPy is an open-source library for **mine ventilation calculations**. It started with the
|
|
4
|
-
Peruvian standard (DS 024-2016-EM)
|
|
5
|
-
|
|
4
|
+
Peruvian standard (DS 024-2016-EM), now also covers Chile (DS 132), Colombia (Decreto 1886)
|
|
5
|
+
and Mexico (NOM-023-STPS-2012), and is growing toward **multi-standard support across Latin
|
|
6
|
+
America**.
|
|
6
7
|
|
|
7
8
|
> 🇪🇸 **Este documento está en inglés y español.** Baja para la versión en español.
|
|
8
9
|
> **No necesitas ser programador experto.** Si eres ingeniero de minas y conoces la norma de tu
|
|
@@ -38,7 +39,7 @@ pip install -e ".[test,viz]"
|
|
|
38
39
|
pytest tests/python -q
|
|
39
40
|
|
|
40
41
|
# 4. Create a branch, make your change, run tests again
|
|
41
|
-
git checkout -b add-
|
|
42
|
+
git checkout -b add-bolivia-standard
|
|
42
43
|
pytest tests/python -q
|
|
43
44
|
|
|
44
45
|
# 5. Commit and open a Pull Request
|
|
@@ -65,8 +66,8 @@ clear to you, it wasn't clear enough.
|
|
|
65
66
|
|
|
66
67
|
**No necesitas escribir C++.** En orden de lo que más falta:
|
|
67
68
|
|
|
68
|
-
1. **Agregar la norma de tu país.** ¿Conoces el reglamento de ventilación de
|
|
69
|
-
|
|
69
|
+
1. **Agregar la norma de tu país.** ¿Conoces el reglamento de ventilación de Bolivia, Ecuador,
|
|
70
|
+
Argentina u otro país? Esa es la contribución que más necesitamos. Mira `ROADMAP.md`.
|
|
70
71
|
2. **Casos resueltos.** Un caso real de ventilación (anonimizado) con sus números, como test.
|
|
71
72
|
3. **Documentación.** Corregir un párrafo confuso, traducir, agregar un diagrama.
|
|
72
73
|
4. **Reportar un número equivocado.** Si un resultado no calza con tu experiencia en campo,
|
|
@@ -87,7 +88,7 @@ pip install -e ".[test,viz]"
|
|
|
87
88
|
pytest tests/python -q
|
|
88
89
|
|
|
89
90
|
# 4. Crea una rama, haz tu cambio, corre los tests otra vez
|
|
90
|
-
git checkout -b agregar-norma-
|
|
91
|
+
git checkout -b agregar-norma-bolivia
|
|
91
92
|
pytest tests/python -q
|
|
92
93
|
|
|
93
94
|
# 5. Commitea y abre un Pull Request
|