Date            18 déc. 2025
Responsable     fd218221
Developpement 
Composant       Procedure
Nom             TOPOPTIM
             
--------------------------
                          
Evolution de TOPOPTIM vers sa version 4.0
=========================================


Principales nouvelles fonctionalites/ameliorations
--------------------------------------------------

* Formalisme a 3 variables de densite : - variable de conception ("mathematique")
                                        - variable filtree ("intermediaire")
                                        - variable seuillee ("physique")
* Nouvel optimiseur MMA (Method of Moving Asymptotes)
  permettant d'ajouter plusieurs contraintes d'optimisation non lineaires
* Choix parmi plusieurs fonctions objectifs :
  - minimiser la compliance
  - minimiser la fraction volumique
  - maximiser le(s) deplacement(s) (mecanisme compliant)
* Choix parmi plusieurs fonctions contraintes :
  - fraction volumique
  - max. von Mises
* Possibilite de filtrer la densite
* Nouveau filtre spatial par EDP de Helmholtz
* Possibilite de seuiller (projeter) la densite par des fonctions sigmoide
  afin d'obtenir des champ plus binaires
* Penalisation RAMP
* Fonctions d'agregation regularisees pour apporcher la fonction max.
* Gestion des chargements dependant des variables de conception (forces volumiques, ...)

En outre, les procedures ont fait l'objet d'une reecriture complete apportant :
* Une meilleure modularite des etapes de l'optimisation
* Un suivi des variables internes au cours des cycles et un affichage dynamique
* Une description des variables internes dans les commentaires du code
  pour aider l'utilisateur/developpeur a adapter le code a ses besoins


Architecture
------------

 Debut ---->---- TOPOPTIM
                 |-- TOPOBOOT
                 |   |-- TOPOEVOL
                 v   |-- TOPORSTR
                 |   +-- TOPOPHYS
                 |       +-- TOPOPROJ
                 |-- (TOPOPERS)
           +-->--|-- TOPOEVOL
           |     |-- TOPOPENA
           |     |-- TOPOACTI
           |  B  |   +-- TOPOMATE
           |  o  |-- (TOPOUPDT)
           |  u  |-- TOPOCHAR
           |  c  |-- TOPOINFO              Autres procedures
           |  l  |-- TOPORESO              appelees ca et la :
           |  e  |-- TOPOOBJE
           |     |   |-- TOPOCMPL          TOPOFILT
           |  d  |   |-- TOPORSTR          TOPOCHAN
           |  '  |   +-- TOPODYDX          TOPOFONC
           |  o  |-- TOPOCONT              TOPOMODI
           ^  p  v   |-- TOPOAGRE
           |  t  |   |-- TOPODVSA
           |  i  |   |-- TOPOADJO
           |  m  |   |   +-- TOPOMATE
           |  i  |   +-- TOPODYDX
           |  s  |-- TOPOLOGY
           |  a  |   +-- TOPOPHYS
           |  t  |       +-- TOPOPROJ
           |  i  +-- TOPOCONV
           |  o  +-- TOPOSAUV
           |  n  +-- (TOPOPERS)
           |     +-- TOPOVISU
           |     |   +-- TOPOTEMP
           +--<--+
                 |
                 +---->---- Fin si convergence
                                ou dernier cycle

Date            18 déc 2025           Fermeture : 18 déc 2025 
Responsable     fd218221              par       : fd218221  
Developpement 
Composant       Procedure
Nom             TOPOPTIM
             
--------------------------
 evolution demandee le 18 déc. 2025 par fd218221
Liste des sous-programmes concernés et commentaires associés
 
Procedures
==========
topoptim.procedur      : GROSSE mise a jour !
                         nouvelles sous procedures pour cloisonner les etapes
                         2 branchements pour de sprocedures personnelles :
                         TOPOPERS et TOPOUPDT (a definir par l'utilisateur)
topoboot.procedur      : grosse maj suite aux nouvelles fonctionalites
                         initialise les donnees/champs utiles
                         description des variables pour aider l'utilisateur/developpeur
toporstr.procedur        maj suite au changement des variables
                         applique les restrictions a la topologie
topophys.procedur (new): calcule les densites filtree ou projetee a partir des
                         variables de conception
topofilt.procedur      : grosse evolutions et maj
                         filtrage sensibilite ou densite
                         filtre chapeau avec MFIL/NFIL et selon quantite intensive/extensive
                         nouveau filtre par EDP de Helmholtz
topoproj.procedur (new): calcule les densites projetees
topoevol.procedur (new): met a jour les parametres d'optimisation a chaque cycle
topopena.procedur (new): calcule le champ de densite penalise et le champ des derivees
                         partielles associe
topoacti.procedur      : maj suite au changement des variables
                         met a jour les donnees (maillage/modeles, densites physiques
                         penalisees et leur champ de sensibilite, champs materiau penalise)
topomate.procedur      : maj suite au changement des variables
                         met a jour le champ materiau avec les caracteristiques penalisees
                         utilise un LISTMOTS reglabe pour mettre a jour les composantes
topochar.procedur (new): met a jour les chargements et conditions aux limites
topoinfo.procedur      : donne des infos au debut de la boucle d'optimisation
toporeso.procedur      : maj suite au changement des variables
                         resout le probleme EF physique (meca/therm)
topoobje.procedur (new): calcule la fonction objectif ainsi que son champ de sensibilite
topochan.procedur      : maj, utilisation de EXTR au lieu de PROI
                         sert a changer le modele associe a un champ par element exprime
                         aux centres de gravite
topocmpl.procedur (new): calcule la compliance (meca/ther) et son champ de sensibilite
topodydx.procedur (new): multiplie un champ de sensibilite par la derivee partielle de
                         la densite physique par rapport a la variable de conception
topocont.procedur (new): calcule les fonctions contraintes (normalisees) ainsi que leurs
                         champs de sensibilite
topoagre.procedur (new): calcule une fonction d'agregation (ainsi que son champ de derivees
                         partielles) sur un champ (fonction contrainte par ex.)
topodvsa.procedur (new): calcule un terme utile si contrainte sur max.(von Mises)
topoadjo.procedur (new): calcule le champ des derivees des fonctions contraintes par rapport
                         aux variables de conception via une methode adjointe
topology.procedur      : grosse maj et nouvel optimiseur MMA
                         calcule une nouvelle topologie par 2 algos d'optimisation :
                         - Optimality Crtiteria (qqs ameliorations)
                         - Method of Moving Asymptotes (nouveau)
                         les contraintes sont normalisees sous la forme g(x) < 0
topoconv.procedur (new): verifie la convergence de la boucle d'optimisation
toposauv.procedur      : maj suite au changement des variables
                         meilleure gestion des reprises
topovisu.procedur (new): affiche/trace les resultats intermediaires
topotemp.procedur (new): converti les temps en ms au format hh.mm.ss.ms
topofonc.procedur (new): calcule de nombreuses fonctions (penalisation, projection,...)
                         et leur champs de sensibilite
topomodi.procedur (new): verifie le besoin de mettre a jour certaines variables
                         afin d'ameliorer les performances
Anciennes procedures supprimees
===============================
topofctr.procedur      : tache deplacee dans topoevol
topodens.procedur      : tache deplacee dans topopena
toposens.procedur      : tache deplacee dans topoobje/topocmpl
Notices
=======
topoacti.notice  : mise a jour
topoadjo.notice  : idem
topoagre.notice  : idem
topoboot.notice  : idem
topochan.notice  : idem
topochar.notice  : idem
topocmpl.notice  : idem
topocont.notice  : idem
topoconv.notice  : idem
topodvsa.notice  : idem
topodydx.notice  : idem
topoevol.notice  : idem
topofilt.notice  : idem
topofonc.notice  : idem
topoinfo.notice  : idem
topology.notice  : idem
topomate.notice  : idem
topomodi.notice  : idem
topoobje.notice  : idem
topopena.notice  : idem
topophys.notice  : idem
topoproj.notice  : idem
topoptim.notice  : idem
toporeso.notice  : idem
toporstr.notice  : idem
toposauv.notice  : idem
topotemp.notice  : idem
topovisu.notice  : idem
Cas tests
=========
topoptim_01_MBB_beam.dgibi        : poutre en flexion simple
topoptim_02_Binarization.dgibi    : idem mais avec seuillage
topoptim_03_Thermal.dgibi         : cas thermique
topoptim_04_Multicase.dgibi       : avec multi-chargement
topoptim_05_Frozen_area.dgibi     : avec zone figee
topoptim_06_Symmetry.dgibi        : avec restriction (symetrie plane)
topoptim_07_Circular_period.dgibi : avec restriction (symetrie 
topoptim_08_Axial_period.dgibi    :
topoptim_09_Remeshing.dgibi       : avec remaillage successifs
topoptim_10_Non-linear.dgibi      : cas avec mecanique non lineaire (contact)
topoptim_11_Mechanism.dgibi       : mecanisme souple (maximise le deplacement)
topoptim_12_Von_Mises.dgibi       : contraint mecaniquement
topoptim_13_Turbine_disk.dgibi    : chargement dependant du design 2d-axis