Salome HOME
Documentation update and method improvement
[modules/adao.git] / src / daComposant / daAlgorithms / MeasurementsOptimalPositioningTask.py
1 # -*- coding: utf-8 -*-
2 #
3 # Copyright (C) 2008-2023 EDF R&D
4 #
5 # This library is free software; you can redistribute it and/or
6 # modify it under the terms of the GNU Lesser General Public
7 # License as published by the Free Software Foundation; either
8 # version 2.1 of the License.
9 #
10 # This library is distributed in the hope that it will be useful,
11 # but WITHOUT ANY WARRANTY; without even the implied warranty of
12 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
13 # Lesser General Public License for more details.
14 #
15 # You should have received a copy of the GNU Lesser General Public
16 # License along with this library; if not, write to the Free Software
17 # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA
18 #
19 # See http://www.salome-platform.org/ or email : webmaster.salome@opencascade.com
20 #
21 # Author: Jean-Philippe Argaud, jean-philippe.argaud@edf.fr, EDF R&D
22
23 import numpy
24 from daCore import BasicObjects
25 from daAlgorithms.Atoms import ecweim, ecwdeim, eosg
26
27 # ==============================================================================
28 class ElementaryAlgorithm(BasicObjects.Algorithm):
29     def __init__(self):
30         BasicObjects.Algorithm.__init__(self, "MEASUREMENTSOPTIMALPOSITIONING")
31         self.defineRequiredParameter(
32             name     = "Variant",
33             default  = "lcEIM",
34             typecast = str,
35             message  = "Variant ou formulation de la méthode",
36             listval  = [
37                 "EIM",    "PositioningByEIM",
38                 "lcEIM",  "PositioningBylcEIM",
39                 "DEIM",   "PositioningByDEIM",
40                 "lcDEIM", "PositioningBylcDEIM",
41                 ],
42             )
43         self.defineRequiredParameter(
44             name     = "EnsembleOfSnapshots",
45             default  = [],
46             typecast = numpy.array,
47             message  = "Ensemble de vecteurs d'état physique (snapshots), 1 état par colonne (Training Set)",
48             )
49         self.defineRequiredParameter(
50             name     = "MaximumNumberOfLocations",
51             default  = 1,
52             typecast = int,
53             message  = "Nombre maximal de positions",
54             minval   = 0,
55             )
56         self.defineRequiredParameter(
57             name     = "ExcludeLocations",
58             default  = [],
59             typecast = tuple,
60             message  = "Liste des indices ou noms de positions exclues selon l'ordre interne d'un snapshot",
61             )
62         self.defineRequiredParameter(
63             name     = "NameOfLocations",
64             default  = [],
65             typecast = tuple,
66             message  = "Liste des noms de positions selon l'ordre interne d'un snapshot",
67             )
68         self.defineRequiredParameter(
69             name     = "ErrorNorm",
70             default  = "L2",
71             typecast = str,
72             message  = "Norme d'erreur utilisée pour le critère d'optimalité des positions",
73             listval  = ["L2", "Linf"]
74             )
75         self.defineRequiredParameter(
76             name     = "ErrorNormTolerance",
77             default  = 1.e-7,
78             typecast = float,
79             message  = "Valeur limite inférieure du critère d'optimalité forçant l'arrêt",
80             minval   = 0.,
81             )
82         self.defineRequiredParameter(
83             name     = "SampleAsnUplet",
84             default  = [],
85             typecast = tuple,
86             message  = "Points de calcul définis par une liste de n-uplet",
87             )
88         self.defineRequiredParameter(
89             name     = "SampleAsExplicitHyperCube",
90             default  = [],
91             typecast = tuple,
92             message  = "Points de calcul définis par un hyper-cube dont on donne la liste des échantillonnages de chaque variable comme une liste",
93             )
94         self.defineRequiredParameter(
95             name     = "SampleAsMinMaxStepHyperCube",
96             default  = [],
97             typecast = tuple,
98             message  = "Points de calcul définis par un hyper-cube dont on donne la liste des échantillonnages de chaque variable par un triplet [min,max,step]",
99             )
100         self.defineRequiredParameter(
101             name     = "SampleAsIndependantRandomVariables",
102             default  = [],
103             typecast = tuple,
104             message  = "Points de calcul définis par un hyper-cube dont les points sur chaque axe proviennent de l'échantillonnage indépendant de la variable selon la spécification ['distribution',[parametres],nombre]",
105             )
106         self.defineRequiredParameter(
107             name     = "SetDebug",
108             default  = False,
109             typecast = bool,
110             message  = "Activation du mode debug lors de l'exécution",
111             )
112         self.defineRequiredParameter(
113             name     = "StoreSupplementaryCalculations",
114             default  = [],
115             typecast = tuple,
116             message  = "Liste de calculs supplémentaires à stocker et/ou effectuer",
117             listval  = [
118                 "EnsembleOfSimulations",
119                 "EnsembleOfStates",
120                 "ExcludedPoints",
121                 "OptimalPoints",
122                 "ReducedBasis",
123                 "Residus",
124                 "SingularValues",
125                 ]
126             )
127         self.defineRequiredParameter(
128             name     = "SetSeed",
129             typecast = numpy.random.seed,
130             message  = "Graine fixée pour le générateur aléatoire",
131             )
132         self.requireInputArguments(
133             mandatory= (),
134             optional = ("Xb", "HO"),
135             )
136         self.setAttributes(tags=(
137             "Reduction",
138             "Checking",
139             ))
140
141     def run(self, Xb=None, Y=None, U=None, HO=None, EM=None, CM=None, R=None, B=None, Q=None, Parameters=None):
142         self._pre_run(Parameters, Xb, Y, U, HO, EM, CM, R, B, Q)
143         #
144         #--------------------------
145         if   self._parameters["Variant"] in ["lcEIM", "PositioningBylcEIM"]:
146             if len(self._parameters["EnsembleOfSnapshots"]) > 0:
147                 if self._toStore("EnsembleOfSimulations"):
148                     self.StoredVariables["EnsembleOfSimulations"].store( self._parameters["EnsembleOfSnapshots"] )
149                 ecweim.EIM_offline(self, self._parameters["EnsembleOfSnapshots"])
150             elif isinstance(HO, dict):
151                 ecweim.EIM_offline(self, eosg.eosg(self, Xb, HO))
152             else:
153                 raise ValueError("Snapshots or Operator have to be given in order to launch the analysis")
154         #
155         elif self._parameters["Variant"] in ["EIM", "PositioningByEIM"]:
156             if len(self._parameters["EnsembleOfSnapshots"]) > 0:
157                 if self._toStore("EnsembleOfSimulations"):
158                     self.StoredVariables["EnsembleOfSimulations"].store( self._parameters["EnsembleOfSnapshots"] )
159                 ecweim.EIM_offline(self, self._parameters["EnsembleOfSnapshots"])
160             elif isinstance(HO, dict):
161                 ecweim.EIM_offline(self, eosg.eosg(self, Xb, HO))
162             else:
163                 raise ValueError("Snapshots or Operator have to be given in order to launch the analysis")
164         #
165         #--------------------------
166         elif self._parameters["Variant"] in ["lcDEIM", "PositioningBylcDEIM"]:
167             if len(self._parameters["EnsembleOfSnapshots"]) > 0:
168                 if self._toStore("EnsembleOfSimulations"):
169                     self.StoredVariables["EnsembleOfSimulations"].store( self._parameters["EnsembleOfSnapshots"] )
170                 ecwdeim.DEIM_offline(self, self._parameters["EnsembleOfSnapshots"])
171             elif isinstance(HO, dict):
172                 ecwdeim.DEIM_offline(self, eosg.eosg(self, Xb, HO))
173             else:
174                 raise ValueError("Snapshots or Operator have to be given in order to launch the analysis")
175         #
176         elif self._parameters["Variant"] in ["DEIM", "PositioningByDEIM"]:
177             if len(self._parameters["EnsembleOfSnapshots"]) > 0:
178                 if self._toStore("EnsembleOfSimulations"):
179                     self.StoredVariables["EnsembleOfSimulations"].store( self._parameters["EnsembleOfSnapshots"] )
180                 ecwdeim.DEIM_offline(self, self._parameters["EnsembleOfSnapshots"])
181             elif isinstance(HO, dict):
182                 ecwdeim.DEIM_offline(self, eosg.eosg(self, Xb, HO))
183             else:
184                 raise ValueError("Snapshots or Operator have to be given in order to launch the analysis")
185         #
186         #--------------------------
187         else:
188             raise ValueError("Error in Variant name: %s"%self._parameters["Variant"])
189         #
190         self._post_run(HO)
191         return 0
192
193 # ==============================================================================
194 if __name__ == "__main__":
195     print('\n AUTODIAGNOSTIC\n')