Scriptage STC

Comment améliorer l’édition et la présentation des scripts MAAT Hydro ?

Les scripts MAAT Hydro peuvent être édités par défaut avec des éditeurs de base de type Wordpad, Notepad etc…, mais des éditeurs plus évolués, tels que Notepad ++ sont disponibles gratuitement en ligne, permettant une indentation automatique des scripts ainsi que leur mise en couleur symbolique !

Comment développer ses propres critères de stabilité ?
Développer un nouveau critère ne se fait généralement pas ex nihilo.

Un ensemble de critères de base étant fourni dans le répertoire “/ProgData/StabCriteria”, le bon sens conduit en effet à identifier avant tout le critère le plus proche de celui projeté afin de le dupliquer et de le renommer avant de procéder à sa modification, au moyen d’un éditeur de texte de type Bloc Note, Wordpad ou autre.

Simultanémént, il est vivement conseillé de calculer sur MAAT Hydro une stabilité du navire concerné par le nouveau critère afin de pouvoir tester quasiment en temps réel l’incidence des modifications du script sur les résultats affichés. Il suffit en effet de stocker le script modifié (avec l’extension ‘STC’ et non pas ‘TXT’) et de resélectionner le critère dans la boîte de dialogue de présentation des résultats pour le rééxécuter et constater immédiatement l’effet produit.

Pour plus de détails sur le STC, un guide de référence sur les différentes commandes et mnémoniques disponibles peut être téléchargé sur la page « Ressources » de MAAT Hydro sur ce site.

Comment utiliser les nouvelles options de calcul d’une intersection ?
Jusqu’à la version 7.0g, l’angle d’équilibre était calculé au moyen de l’instruction :

Heelpoint heq(« Ship Balance », INTERSECTION, gz, ox, h0)

Cette instruction permet de définir l’angle heq comme étant l’intersection des courbes gz et ox la plus proche de l’angle h0.

Afin de permettre une distinction plus fine des intersections obtenues, 2 nouveaux mnémoniques ont été ajoutés, permettant de distinguer les intersections où la pente est croissante de celles où elle est décroissante.

Ces nouvelles options permettent ainsi de faciliter la détermination de l’angle d’équilibre, en ne retenant que les intersections où la courbe des GZ est croissante :

 

Heelpoint heq(« Ship Balance », INTERSECTION+, ox, gz, h0)

Noter également que la courbe dont la croissance sert de critère de sélection doit être identifiée en seconde position, d’où la modification du ‘INTERSECTION, gz, ox’ initial en ‘INTERSECTION+, ox, gz’.

 

De plus, le calcul de l’angle d’équilibre étant dorénavant totalement personnalisable par script, ce dernier peut maintenant informer MAAT Hydro de la valeur à prendre en compte (initialisation de l’aire des GZ, des MS, etc…) si elle diffère de la valeur par défaut, au moyen de la commande ‘SetBalanceHeel’ afin qu’il puisse être correctement pris en compte dans la suite des calculs :

SetBalanceHeel(heq)

De manière analogue, le mnémonique « INTERSECTION-‘ permet de sélectionner les seules intersections où la pente est négative, ce qui peut faciliter le calcul de l’angle de chavirage :

Heelpoint cpsz(« Capsizing », INTERSECTION-, 0x, gz, h0)

En résumé, il est donc conseillé de remplacer maintenant l’ancien calcul de l’angle d’équilibre:

Heelpoint heq(« Balance Heel », INTERSECTION, gz, ox, h0)

Par les 2 instructions suivantes:

Heelpoint heq(« Balance Heel », INTERSECTION+, ox, gz, h0)

SetBalanceHeel(heq)

Cette approche permet à chacun de développer si nécessaire tout algorithme de détermination de l’angle d’équilibre jugé plus opportun.

 

Comment calculer un angle de gîte en fonction d’une contrainte d’aire ?

Il est fréquent qu’un angle de gîte doive être déterminé en fonction d’une aire de la courbe des GZ. Les exemples qui suivent devraient permettre de scripter la plupart des problèmes de ce type :

  1. Bien que l’angle limite de stabilité dynamique soit déterminé automatiquement par MAAT Hydro, il est intéressant de montrer comment quelques lignes de script permettraient de le calculer :

    Curve ox(« Heel Axis », CONSTANT, 0.0) // Crée un axe des X

    Heelpoint heq(« Ship Balance », INTERSECTION+, ox, gz, h0) // Calcule l’angle d’équilibre

    SetBalanceHeel(heq) // Déclare l’angle d’équilibre pour que MH l’enregistre comme tel

    Heelpoint hx(« Limite Statique », MAX, gz) // Calcule la gîte associée au GZmax

    Curve gzarea(« GZ Area », GZAREA, gz, heq) // Crée la courbe des aires des GZ

    Heelpoint heel(« heel », CONSTANT, 0.0) // Crée un buffer d’’abscisse pour définir gzrectarea

    Curve gzrectarea(« Rectangular GZ area », heel, {(heel-heq)*0.01745329252*gz(heel)}) // Crée la courbe des aires rectangulaires associées aux GZ (la constante convertit les degrés en radians)

    Heelpoint thetadyn2(« Limite Dynamique 2 », INTERSECTION, gzarea, gzrectarea, heq, 1) // Calcule le 2° angle de chavirement dynamique en tant qu’angle où l’aire des GZ égale l’aire rectangulaire des GZ).

    Data gzdyn(« GZ Dyn », gz, hdyn2) // Détermine le GZ dynamique associé
    Curve gzdyncurve(« GZdyn », heel, {gzdyn})// Crée la courbe de levier constant associée

    Heelpoint thetadyncalc(« Limite Dynamique calculée par script », INTERSECTION, gzdyncurve, gz, heq, 1) // Calcule l’angle de chavirement dynamique en tant que 1° intersection dz / gzdyn après l’angle d’équilibre

    Heelpoint thetadynref(« Limite Dynamique calculée automatiquement », DYNCAPSZ, heq) // Crée l’angle thetadynref determiné automatiquement pour comparaison avec la valeur calculée thetadyncalc

  2. On peut également avoir à déterminer l’angle auquel une aire égale une autre aire afin de déterminer la gîte atteinte dynamiquement sous l’action d’un moment inclinant donné.

En admettant comme précédemment que la courbe gz représente les bras de redressement et que la courbe cargolever représente les bras inclinants, il suffit alors de créer une courbe auxiliaire gzcargolever représentant leur différence pour qu’on puisse créer directement sa courbe d’aire afin d’en déterminer l’intersection définissant l’angle où les aires s’égalent. L’exemple qui suit illustrera l’approche proposée:

  • Curve cargolever(« Cargo Lever », heel, {b*cos(heel)}) // Crée explicitement la courbe des moments inclinants
  • Curve gzcargolever(« GZ-Cargo Lever », heel, {gz(heel)-cargolever(heel)}) // Crée une courbe représentant la différence GZ(heel) – cargolever(heel)
  • Curve gzcargoarea(« GZ-Cargo Area », gzcargolever, theta1, 0.0) // Crée la courbe gzcargoarea en tant qu’intégrale de la courbe précédente et fixe la constante d’intégration afin que gzcargoarea(theta1) = 0
  • Heelpoint theta3(« Theta3 », INTERSECTION, gzcargoarea, ox, thetac, 1) // Calcule l’angle theta3 d’égalité des aires en tant que 1° intersection gzcargoarea / ox trouvée après thetac