Module validation

Module de validation et vérifications selon EurOtop (2018)

Vérifie les domaines de validité, signale les warnings et propose des recommandations

class openeurotop.validation.ValidationResult

Bases: object

Classe pour stocker les résultats de validation

__init__()

add_warning(message)

Ajoute un avertissement

add_error(message)

Ajoute une erreur (invalidité)

add_recommendation(message)

Ajoute une recommandation

__str__()

Affichage formaté des résultats

openeurotop.validation.validate_slope_structure(Hm0, Tm_10, h, Rc, alpha_deg, gamma_f=1.0, gamma_beta=1.0)

Valide les paramètres pour une structure à talus

Vérifie les domaines de validité selon EurOtop 2018

Parameters:

• Hm0 (float) – Paramètres de la structure

• Tm_10 (float) – Paramètres de la structure

• h (float) – Paramètres de la structure

• Rc (float) – Paramètres de la structure

• alpha_deg (float) – Paramètres de la structure

• gamma_f (float) – Facteurs de réduction

• gamma_beta (float) – Facteurs de réduction

Returns:

Objet contenant les résultats de validation

Return type:

ValidationResult

Examples

>>> result = validate_slope_structure(2.5, 6.0, 10.0, 3.0, 35.0)
>>> print(result)
>>> if result.is_valid:
...     print("OK pour calcul")

openeurotop.validation.validate_vertical_wall(Hm0, Tm_10, h, Rc)

Valide les paramètres pour un mur vertical

Parameters:

• Hm0 (float) – Paramètres de la structure

• Tm_10 (float) – Paramètres de la structure

• h (float) – Paramètres de la structure

• Rc (float) – Paramètres de la structure

Returns:

Résultats de validation

Return type:

ValidationResult

openeurotop.validation.validate_composite_structure(Hm0, Tm_10, h, Rc, alpha_lower_deg, h_transition)

Valide les paramètres pour une structure composite

Parameters:

• Hm0 (float) – Paramètres de vague

• Tm_10 (float) – Paramètres de vague

• h (float) – Paramètres de vague

• Rc (float) – Paramètres de vague

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

• h_transition (float) – Hauteur de transition

Returns:

Résultats de validation

Return type:

ValidationResult

openeurotop.validation.check_design_requirements(q, q_limit, safety_factor=1.0)

Vérifie si le débit respecte les critères de conception

Parameters:

• q (float) – Débit calculé (m³/s/m)

• q_limit (float) – Débit limite acceptable (m³/s/m)

• safety_factor (float, optional) – Facteur de sécurité à appliquer

Returns:

Résultats de vérification

Return type:

dict

Examples

>>> # Vérifier si q < 1 l/s/m avec facteur de sécurité 1.5
>>> check = check_design_requirements(0.0008, 0.001, safety_factor=1.5)
>>> if check['acceptable']:
...     print("Conception acceptable")

openeurotop.validation.validate_all_parameters(structure_type, **params)

Validation globale pour tous types de structures

Parameters:

• structure_type (str) – Type de structure : “slope”, “vertical_wall”, “composite”

• **params (dict) – Paramètres de la structure

Returns:

Résultats complets de validation

Return type:

ValidationResult

Examples

>>> result = validate_all_parameters(
...     "slope",
...     Hm0=2.5, Tm_10=6.0, h=10.0, Rc=3.0, alpha_deg=35.0
... )
>>> print(result)

openeurotop.validation.generate_validation_report(structure_type, calculation_results, **params)

Génère un rapport de validation complet

Parameters:

• structure_type (str) – Type de structure

• calculation_results (dict) – Résultats de calcul (débit, etc.)

• **params (dict) – Paramètres de la structure

Returns:

Rapport formaté

Return type:

str

Examples

>>> from openeurotop import overtopping
>>> q = overtopping.digue_talus(2.5, 6.0, 10.0, 3.0, 35.0)
>>> report = generate_validation_report(
...     "slope",
...     {'q': q},
...     Hm0=2.5, Tm_10=6.0, h=10.0, Rc=3.0, alpha_deg=35.0
... )
>>> print(report)

Validation de structures

validate_slope_structure

openeurotop.validation.validate_slope_structure(Hm0, Tm_10, h, Rc, alpha_deg, gamma_f=1.0, gamma_beta=1.0)

Valide les paramètres pour une structure à talus

Vérifie les domaines de validité selon EurOtop 2018

Parameters:

• Hm0 (float) – Paramètres de la structure

• Tm_10 (float) – Paramètres de la structure

• h (float) – Paramètres de la structure

• Rc (float) – Paramètres de la structure

• alpha_deg (float) – Paramètres de la structure

• gamma_f (float) – Facteurs de réduction

• gamma_beta (float) – Facteurs de réduction

Returns:

Objet contenant les résultats de validation

Return type:

ValidationResult

Examples

>>> result = validate_slope_structure(2.5, 6.0, 10.0, 3.0, 35.0)
>>> print(result)
>>> if result.is_valid:
...     print("OK pour calcul")

validate_vertical_wall

openeurotop.validation.validate_vertical_wall(Hm0, Tm_10, h, Rc)

Valide les paramètres pour un mur vertical

Parameters:

• Hm0 (float) – Paramètres de la structure

• Tm_10 (float) – Paramètres de la structure

• h (float) – Paramètres de la structure

• Rc (float) – Paramètres de la structure

Returns:

Résultats de validation

Return type:

ValidationResult

Rapports

validation_report

Vérifications

check_domain_validity

check_design_criteria