Module run_up

Calcul du run-up selon EurOtop (2018) - Chapitre 6

Le run-up est la montée maximale de l’eau sur une structure lors du passage d’une vague. Ru2% représente le run-up dépassé par 2% des vagues (valeur caractéristique).

openeurotop.run_up.run_up_2percent_smooth_slope(Hm0, Tm_10, alpha_deg, h=None, g=9.81)[source]

Calcul du run-up Ru2% pour une pente lisse

EurOtop 2018 - Équations 6.1 et 6.2

Pour ξm-1,0 < 1.8 (déferlant) : Ru2% / Hm0 = 1.5 · γf · γβ · ξm-1,0 Pour ξm-1,0 ≥ 1.8 (non-déferlant) : Ru2% / Hm0 = γf · γβ · (4.0 - 1.5/ξm-1,0)

avec maximum Ru2% / Hm0 ≤ γf · γβ · 4.0

Parameters:

  • Hm0 (float) – Hauteur significative spectrale (m)

  • Tm_10 (float) – Période spectrale Tm-1,0 (s)

  • alpha_deg (float) – Angle de pente (degrés)

  • h (float, optional) – Profondeur d’eau (m) - pour correction shallow water si besoin

  • g (float, optional) – Accélération de la pesanteur (m/s²)

Returns:

Run-up Ru2% (m)

Return type:

float

References

EurOtop (2018) - Section 6.2, Équations 6.1 et 6.2

openeurotop.run_up.run_up_2percent_rough_slope(Hm0, Tm_10, alpha_deg, gamma_f, gamma_beta=1.0, h=None, g=9.81)[source]

Calcul du run-up Ru2% pour une pente rugueuse

EurOtop 2018 - Équations 6.1 et 6.2 avec facteurs de réduction

Parameters:

  • Hm0 (float) – Hauteur significative spectrale (m)

  • Tm_10 (float) – Période spectrale Tm-1,0 (s)

  • alpha_deg (float) – Angle de pente (degrés)

  • gamma_f (float) – Facteur de rugosité (voir reduction_factors.gamma_f_roughness)

  • gamma_beta (float, optional) – Facteur d’obliquité (défaut: 1.0)

  • h (float, optional) – Profondeur d’eau (m)

  • g (float, optional) – Accélération de la pesanteur (m/s²)

Returns:

Run-up Ru2% (m)

Return type:

float

References

EurOtop (2018) - Section 6.2

openeurotop.run_up.run_up_distribution_parameters(Hm0, Tm_10, alpha_deg, gamma_f=1.0, gamma_beta=1.0, g=9.81)[source]

Calcule les paramètres de la distribution du run-up

Le run-up suit une distribution de Rayleigh : P(Ru > z) = exp(-(z / a)²)

où a est le paramètre d’échelle

Parameters:

  • Hm0 (float) – Hauteur significative spectrale (m)

  • Tm_10 (float) – Période spectrale (s)

  • alpha_deg (float) – Angle de pente (degrés)

  • gamma_f (float, optional) – Facteur de rugosité

  • gamma_beta (float, optional) – Facteur d’obliquité

  • g (float, optional) – Accélération de la pesanteur (m/s²)

Returns:

Dictionnaire avec : - ‘Ru2’ : Run-up 2% - ‘a’ : Paramètre d’échelle de Rayleigh - ‘Ru_mean’ : Run-up moyen - ‘Ru_max’ : Run-up maximum (théorique)

Return type:

dict

References

EurOtop (2018) - Section 6.3

openeurotop.run_up.run_up_exceedance_probability(z, Hm0, Tm_10, alpha_deg, gamma_f=1.0, gamma_beta=1.0, g=9.81)[source]

Calcule la probabilité de dépassement d’un niveau de run-up donné

P(Ru > z) = exp(-(z/a)²)

Parameters:

  • z (float or array_like) – Niveau de run-up à évaluer (m)

  • Hm0 (float) – Hauteur significative spectrale (m)

  • Tm_10 (float) – Période spectrale (s)

  • alpha_deg (float) – Angle de pente (degrés)

  • gamma_f (float, optional) – Facteur de rugosité

  • gamma_beta (float, optional) – Facteur d’obliquité

  • g (float, optional) – Accélération de la pesanteur (m/s²)

Returns:

Probabilité de dépassement P(Ru > z)

Return type:

float or array_like

Examples

>>> # Probabilité que le run-up dépasse 3m
>>> P = run_up_exceedance_probability(3.0, Hm0=2.5, Tm_10=6.0, alpha_deg=35.0)
openeurotop.run_up.run_up_with_berm(Hm0, Tm_10, alpha_lower_deg, alpha_upper_deg, h_berm, B_berm, gamma_f=1.0, gamma_beta=1.0, g=9.81)[source]

Calcul du run-up pour une structure avec berme

La berme réduit le run-up selon sa largeur et sa hauteur.

Parameters:

  • Hm0 (float) – Hauteur significative spectrale (m)

  • Tm_10 (float) – Période spectrale (s)

  • alpha_lower_deg (float) – Angle de pente inférieure (degrés)

  • alpha_upper_deg (float) – Angle de pente supérieure (degrés)

  • h_berm (float) – Hauteur de la berme au-dessus du SWL (m)

  • B_berm (float) – Largeur de la berme (m)

  • gamma_f (float, optional) – Facteur de rugosité

  • gamma_beta (float, optional) – Facteur d’obliquité

  • g (float, optional) – Accélération de la pesanteur (m/s²)

Returns:

Run-up Ru2% (m)

Return type:

float

References

EurOtop (2018) - Section 6.4

openeurotop.run_up.run_up_vertical_wall(Hm0, Tm_10, h, h_wall, g=9.81)[source]

Calcul du run-up pour un mur vertical

EurOtop 2018 - Section 6.5

Parameters:

  • Hm0 (float) – Hauteur significative spectrale (m)

  • Tm_10 (float) – Période spectrale (s)

  • h (float) – Profondeur d’eau au pied du mur (m)

  • h_wall (float) – Hauteur du mur (m)

  • g (float, optional) – Accélération de la pesanteur (m/s²)

Returns:

Run-up Ru2% (m)

Return type:

float

References

EurOtop (2018) - Section 6.5

openeurotop.run_up.run_up_composite_structure(Hm0, Tm_10, alpha_lower_deg, h_transition, h_wall, gamma_f_lower=1.0, gamma_beta=1.0, g=9.81)[source]

Calcul du run-up pour une structure composite (talus + mur)

Parameters:

  • Hm0 (float) – Hauteur significative spectrale (m)

  • Tm_10 (float) – Période spectrale (s)

  • alpha_lower_deg (float) – Angle de pente inférieure (degrés)

  • h_transition (float) – Hauteur de la transition (m au-dessus SWL)

  • h_wall (float) – Hauteur totale de la structure (m)

  • gamma_f_lower (float, optional) – Facteur de rugosité de la pente inférieure

  • gamma_beta (float, optional) – Facteur d’obliquité

  • g (float, optional) – Accélération de la pesanteur (m/s²)

Returns:

Run-up Ru2% (m)

Return type:

float

References

EurOtop (2018) - Section 6.6

openeurotop.run_up.run_down_2percent(Hm0, Tm_10, alpha_deg, gamma_f=1.0, g=9.81)[source]

Calcul du run-down Rd2% (descente d’eau)

Le run-down est généralement moins critique que le run-up mais peut être important pour la stabilité des blocs ou l’érosion.

Formule empirique : Rd2% ≈ 0.33 · Ru2%

Parameters:

  • Hm0 (float) – Hauteur significative spectrale (m)

  • Tm_10 (float) – Période spectrale (s)

  • alpha_deg (float) – Angle de pente (degrés)

  • gamma_f (float, optional) – Facteur de rugosité

  • g (float, optional) – Accélération de la pesanteur (m/s²)

Returns:

Run-down Rd2% (m, valeur négative)

Return type:

float

References

EurOtop (2018) - Section 6.7

openeurotop.run_up.run_up_detailed(Hm0, Tm_10, alpha_deg, type_revetement='lisse', beta_deg=0.0, h_berm=None, B_berm=None, g=9.81)[source]

Calcul détaillé du run-up avec calcul automatique des facteurs

Parameters:

  • Hm0 (float) – Hauteur significative spectrale (m)

  • Tm_10 (float) – Période spectrale (s)

  • alpha_deg (float) – Angle de pente (degrés)

  • type_revetement (str, optional) – Type de revêtement (voir reduction_factors.gamma_f_roughness)

  • beta_deg (float, optional) – Angle d’obliquité des vagues (degrés)

  • h_berm (float, optional) – Hauteur de berme (m)

  • B_berm (float, optional) – Largeur de berme (m)

  • g (float, optional) – Accélération de la pesanteur (m/s²)

Returns:

Dictionnaire avec tous les résultats

Return type:

dict

Examples

>>> result = run_up_detailed(Hm0=2.5, Tm_10=6.0, alpha_deg=35.0,
...                          type_revetement="enrochement_2couches")
>>> print(f"Ru2% = {result['Ru2']:.2f} m")

Fonctions principales

run_up_2percent_smooth_slope

openeurotop.run_up.run_up_2percent_smooth_slope(Hm0, Tm_10, alpha_deg, h=None, g=9.81)[source]

Calcul du run-up Ru2% pour une pente lisse

EurOtop 2018 - Équations 6.1 et 6.2

Pour ξm-1,0 < 1.8 (déferlant) : Ru2% / Hm0 = 1.5 · γf · γβ · ξm-1,0 Pour ξm-1,0 ≥ 1.8 (non-déferlant) : Ru2% / Hm0 = γf · γβ · (4.0 - 1.5/ξm-1,0)

avec maximum Ru2% / Hm0 ≤ γf · γβ · 4.0

Parameters:

  • Hm0 (float) – Hauteur significative spectrale (m)

  • Tm_10 (float) – Période spectrale Tm-1,0 (s)

  • alpha_deg (float) – Angle de pente (degrés)

  • h (float, optional) – Profondeur d’eau (m) - pour correction shallow water si besoin

  • g (float, optional) – Accélération de la pesanteur (m/s²)

Returns:

Run-up Ru2% (m)

Return type:

float

References

EurOtop (2018) - Section 6.2, Équations 6.1 et 6.2

run_up_2percent_rough_slope

openeurotop.run_up.run_up_2percent_rough_slope(Hm0, Tm_10, alpha_deg, gamma_f, gamma_beta=1.0, h=None, g=9.81)[source]

Calcul du run-up Ru2% pour une pente rugueuse

EurOtop 2018 - Équations 6.1 et 6.2 avec facteurs de réduction

Parameters:

  • Hm0 (float) – Hauteur significative spectrale (m)

  • Tm_10 (float) – Période spectrale Tm-1,0 (s)

  • alpha_deg (float) – Angle de pente (degrés)

  • gamma_f (float) – Facteur de rugosité (voir reduction_factors.gamma_f_roughness)

  • gamma_beta (float, optional) – Facteur d’obliquité (défaut: 1.0)

  • h (float, optional) – Profondeur d’eau (m)

  • g (float, optional) – Accélération de la pesanteur (m/s²)

Returns:

Run-up Ru2% (m)

Return type:

float

References

EurOtop (2018) - Section 6.2

run_down_2percent

openeurotop.run_up.run_down_2percent(Hm0, Tm_10, alpha_deg, gamma_f=1.0, g=9.81)[source]

Calcul du run-down Rd2% (descente d’eau)

Le run-down est généralement moins critique que le run-up mais peut être important pour la stabilité des blocs ou l’érosion.

Formule empirique : Rd2% ≈ 0.33 · Ru2%

Parameters:

  • Hm0 (float) – Hauteur significative spectrale (m)

  • Tm_10 (float) – Période spectrale (s)

  • alpha_deg (float) – Angle de pente (degrés)

  • gamma_f (float, optional) – Facteur de rugosité

  • g (float, optional) – Accélération de la pesanteur (m/s²)

Returns:

Run-down Rd2% (m, valeur négative)

Return type:

float

References

EurOtop (2018) - Section 6.7

Fonctions avancées

run_up_detailed

openeurotop.run_up.run_up_detailed(Hm0, Tm_10, alpha_deg, type_revetement='lisse', beta_deg=0.0, h_berm=None, B_berm=None, g=9.81)[source]

Calcul détaillé du run-up avec calcul automatique des facteurs

Parameters:

  • Hm0 (float) – Hauteur significative spectrale (m)

  • Tm_10 (float) – Période spectrale (s)

  • alpha_deg (float) – Angle de pente (degrés)

  • type_revetement (str, optional) – Type de revêtement (voir reduction_factors.gamma_f_roughness)

  • beta_deg (float, optional) – Angle d’obliquité des vagues (degrés)

  • h_berm (float, optional) – Hauteur de berme (m)

  • B_berm (float, optional) – Largeur de berme (m)

  • g (float, optional) – Accélération de la pesanteur (m/s²)

Returns:

Dictionnaire avec tous les résultats

Return type:

dict

Examples

>>> result = run_up_detailed(Hm0=2.5, Tm_10=6.0, alpha_deg=35.0,
...                          type_revetement="enrochement_2couches")
>>> print(f"Ru2% = {result['Ru2']:.2f} m")

run_up_bermed_slope

run_up_composite_slope

run_up_vertical_wall

openeurotop.run_up.run_up_vertical_wall(Hm0, Tm_10, h, h_wall, g=9.81)[source]

Calcul du run-up pour un mur vertical

EurOtop 2018 - Section 6.5

Parameters:

  • Hm0 (float) – Hauteur significative spectrale (m)

  • Tm_10 (float) – Période spectrale (s)

  • h (float) – Profondeur d’eau au pied du mur (m)

  • h_wall (float) – Hauteur du mur (m)

  • g (float, optional) – Accélération de la pesanteur (m/s²)

Returns:

Run-up Ru2% (m)

Return type:

float

References

EurOtop (2018) - Section 6.5