Salome HOME
Improvement of algorithms arguments validation and tests
[modules/adao.git] / src / daComposant / daAlgorithms / SamplingTest.py
1 # -*- coding: utf-8 -*-
2 #
3 # Copyright (C) 2008-2020 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 logging
24 from daCore import BasicObjects
25 import numpy, copy, itertools
26
27 # ==============================================================================
28 class ElementaryAlgorithm(BasicObjects.Algorithm):
29     def __init__(self):
30         BasicObjects.Algorithm.__init__(self, "SAMPLINGTEST")
31         self.defineRequiredParameter(
32             name     = "SampleAsnUplet",
33             default  = [],
34             typecast = tuple,
35             message  = "Points de calcul définis par une liste de n-uplet",
36             )
37         self.defineRequiredParameter(
38             name     = "SampleAsExplicitHyperCube",
39             default  = [],
40             typecast = tuple,
41             message  = "Points de calcul définis par un hyper-cube dont on donne la liste des échantillonages de chaque variable comme une liste",
42             )
43         self.defineRequiredParameter(
44             name     = "SampleAsMinMaxStepHyperCube",
45             default  = [],
46             typecast = tuple,
47             message  = "Points de calcul définis par un hyper-cube dont on donne la liste des échantillonages de chaque variable par un triplet [min,max,step]",
48             )
49         self.defineRequiredParameter(
50             name     = "SampleAsIndependantRandomVariables",
51             default  = [],
52             typecast = tuple,
53             message  = "Points de calcul définis par un hyper-cube dont les points sur chaque axe proviennent de l'échantillonage indépendant de la variable selon la spécification ['distribution',[parametres],nombre]",
54             )
55         self.defineRequiredParameter(
56             name     = "QualityCriterion",
57             default  = "AugmentedWeightedLeastSquares",
58             typecast = str,
59             message  = "Critère de qualité utilisé",
60             listval  = ["AugmentedWeightedLeastSquares","AWLS","AugmentedPonderatedLeastSquares","APLS","DA",
61                         "WeightedLeastSquares","WLS","PonderatedLeastSquares","PLS",
62                         "LeastSquares","LS","L2",
63                         "AbsoluteValue","L1",
64                         "MaximumError","ME"],
65             )
66         self.defineRequiredParameter(
67             name     = "SetDebug",
68             default  = False,
69             typecast = bool,
70             message  = "Activation du mode debug lors de l'exécution",
71             )
72         self.defineRequiredParameter(
73             name     = "StoreSupplementaryCalculations",
74             default  = [],
75             typecast = tuple,
76             message  = "Liste de calculs supplémentaires à stocker et/ou effectuer",
77             listval  = [
78                 "CostFunctionJ",
79                 "CostFunctionJb",
80                 "CostFunctionJo",
81                 "CurrentState",
82                 "InnovationAtCurrentState",
83                 "SimulatedObservationAtCurrentState",
84                 ]
85             )
86         self.defineRequiredParameter(
87             name     = "SetSeed",
88             typecast = numpy.random.seed,
89             message  = "Graine fixée pour le générateur aléatoire",
90             )
91         self.requireInputArguments(
92             mandatory= ("Xb", "HO"),
93             )
94         self.setAttributes(tags=(
95             "Checking",
96             ))
97
98     def run(self, Xb=None, Y=None, U=None, HO=None, EM=None, CM=None, R=None, B=None, Q=None, Parameters=None):
99         self._pre_run(Parameters, Xb, Y, U, HO, EM, CM, R, B, Q)
100         #
101         Hm = HO["Direct"].appliedTo
102         #
103         Xn = copy.copy( Xb )
104         #
105         # ---------------------------
106         if len(self._parameters["SampleAsnUplet"]) > 0:
107             sampleList = self._parameters["SampleAsnUplet"]
108             for i,Xx in enumerate(sampleList):
109                 if numpy.ravel(Xx).size != Xn.size:
110                     raise ValueError("The size %i of the %ith state X in the sample and %i of the checking point Xb are different, they have to be identical."%(numpy.ravel(Xx).size,i+1,Xn.size))
111         elif len(self._parameters["SampleAsExplicitHyperCube"]) > 0:
112             sampleList = itertools.product(*list(self._parameters["SampleAsExplicitHyperCube"]))
113         elif len(self._parameters["SampleAsMinMaxStepHyperCube"]) > 0:
114             coordinatesList = []
115             for i,dim in enumerate(self._parameters["SampleAsMinMaxStepHyperCube"]):
116                 if len(dim) != 3:
117                     raise ValueError("For dimension %i, the variable definition \"%s\" is incorrect, it should be [min,max,step]."%(i,dim))
118                 else:
119                     coordinatesList.append(numpy.linspace(dim[0],dim[1],1+int((float(dim[1])-float(dim[0]))/float(dim[2]))))
120             sampleList = itertools.product(*coordinatesList)
121         elif len(self._parameters["SampleAsIndependantRandomVariables"]) > 0:
122             coordinatesList = []
123             for i,dim in enumerate(self._parameters["SampleAsIndependantRandomVariables"]):
124                 if len(dim) != 3:
125                     raise ValueError("For dimension %i, the variable definition \"%s\" is incorrect, it should be ('distribution',(parameters),length) with distribution in ['normal'(mean,std),'lognormal'(mean,sigma),'uniform'(low,high),'weibull'(shape)]."%(i,dim))
126                 elif not( str(dim[0]) in ['normal','lognormal','uniform','weibull'] and hasattr(numpy.random,dim[0]) ):
127                     raise ValueError("For dimension %i, the distribution name \"%s\" is not allowed, please choose in ['normal'(mean,std),'lognormal'(mean,sigma),'uniform'(low,high),'weibull'(shape)]"%(i,dim[0]))
128                 else:
129                     distribution = getattr(numpy.random,str(dim[0]),'normal')
130                     parameters   = dim[1]
131                     coordinatesList.append(distribution(*dim[1], size=max(1,int(dim[2]))))
132             sampleList = itertools.product(*coordinatesList)
133         else:
134             sampleList = iter([Xn,])
135         # ----------
136         BI = B.getI()
137         RI = R.getI()
138         def CostFunction(x, HmX, QualityMeasure="AugmentedWeightedLeastSquares"):
139             if numpy.any(numpy.isnan(HmX)):
140                 _X  = numpy.nan
141                 _HX = numpy.nan
142                 Jb, Jo, J = numpy.nan, numpy.nan, numpy.nan
143             else:
144                 _X  = numpy.asmatrix(numpy.ravel( x )).T
145                 _HX = numpy.asmatrix(numpy.ravel( HmX )).T
146                 if QualityMeasure in ["AugmentedWeightedLeastSquares","AWLS","AugmentedPonderatedLeastSquares","APLS","DA"]:
147                     if BI is None or RI is None:
148                         raise ValueError("Background and Observation error covariance matrix has to be properly defined!")
149                     Jb  = 0.5 * (_X - Xb).T * BI * (_X - Xb)
150                     Jo  = 0.5 * (Y - _HX).T * RI * (Y - _HX)
151                 elif QualityMeasure in ["WeightedLeastSquares","WLS","PonderatedLeastSquares","PLS"]:
152                     if RI is None:
153                         raise ValueError("Observation error covariance matrix has to be properly defined!")
154                     Jb  = 0.
155                     Jo  = 0.5 * (Y - _HX).T * RI * (Y - _HX)
156                 elif QualityMeasure in ["LeastSquares","LS","L2"]:
157                     Jb  = 0.
158                     Jo  = 0.5 * (Y - _HX).T * (Y - _HX)
159                 elif QualityMeasure in ["AbsoluteValue","L1"]:
160                     Jb  = 0.
161                     Jo  = numpy.sum( numpy.abs(Y - _HX) )
162                 elif QualityMeasure in ["MaximumError","ME"]:
163                     Jb  = 0.
164                     Jo  = numpy.max( numpy.abs(Y - _HX) )
165                 #
166                 J   = float( Jb ) + float( Jo )
167             if self._toStore("CurrentState"):
168                 self.StoredVariables["CurrentState"].store( _X )
169             if self._toStore("InnovationAtCurrentState"):
170                 self.StoredVariables["InnovationAtCurrentState"].store( Y - _HX )
171             if self._toStore("SimulatedObservationAtCurrentState"):
172                 self.StoredVariables["SimulatedObservationAtCurrentState"].store( _HX )
173             self.StoredVariables["CostFunctionJb"].store( Jb )
174             self.StoredVariables["CostFunctionJo"].store( Jo )
175             self.StoredVariables["CostFunctionJ" ].store( J )
176             return J, Jb, Jo
177         # ----------
178         if self._parameters["SetDebug"]:
179             CUR_LEVEL = logging.getLogger().getEffectiveLevel()
180             logging.getLogger().setLevel(logging.DEBUG)
181             print("===> Beginning of evaluation, activating debug\n")
182             print("     %s\n"%("-"*75,))
183         #
184         # ----------
185         for i,Xx in enumerate(sampleList):
186             if self._parameters["SetDebug"]:
187                 print("===> Launching evaluation for state %i"%i)
188             __Xn = numpy.asmatrix(numpy.ravel( Xx )).T
189             try:
190                 Yn = Hm( __Xn )
191             except:
192                 Yn = numpy.nan
193             #
194             J, Jb, Jo = CostFunction(__Xn,Yn,self._parameters["QualityCriterion"])
195         # ----------
196         #
197         if self._parameters["SetDebug"]:
198             print("\n     %s\n"%("-"*75,))
199             print("===> End evaluation, deactivating debug if necessary\n")
200             logging.getLogger().setLevel(CUR_LEVEL)
201         #
202         self._post_run(HO)
203         return 0
204
205 # ==============================================================================
206 if __name__ == "__main__":
207     print('\n AUTODIAGNOSTIC\n')