The ADAO module provides data assimilation and optimization features in Python or SALOME context (see http://www.salome-platform.org/). Briefly stated, Data Assimilation is a methodological framework to compute the optimal estimate of the inaccessible true value of a system state, eventually over time. It uses information coming from experimental measurements or observations, and from numerical a priori models, including information about their errors. Parts of the framework are also known under the names of calibration, adjustment, state estimation, parameter estimation, parameter adjustment, inverse problems, Bayesian estimation, optimal interpolation, mathematical regularization, meta-heuristics for optimization, model reduction, data smoothing, etc. More details can be found in the full ADAO documentation (see https://www.salome-platform.org/ User Documentation dedicated section).
Only the use of ADAO text programming interface (API/TUI) is introduced here. This interface gives ability to create a calculation object in a similar way than the case building obtained through the graphical interface (GUI). When one wants to elaborate directly the TUI calculation case, it is recommended to extensively use all the ADAO module documentation, and to go back if necessary to the graphical interface (GUI), to get all the elements allowing to correctly set the commands.
To introduce the TUI interface, lets begin by a simple but complete example of ADAO calculation case. All the data are explicitly defined inside the script in order to make the reading easier. The whole set of commands is the following one::
from numpy import array, matrix
from adao import adaoBuilder
case = adaoBuilder.New()
case.set( 'AlgorithmParameters', Algorithm = '3DVAR' )
case.set( 'Background', Vector = [0, 1, 2] )
case.set( 'BackgroundError', ScalarSparseMatrix = 1.0 )
case.set( 'Observation', Vector = array([0.5, 1.5, 2.5]) )
case.set( 'ObservationError', DiagonalSparseMatrix = '1 1 1' )
case.set( 'ObservationOperator', Matrix = '1 0 0;0 2 0;0 0 3' )
case.set( 'Observer', Variable = "Analysis", Template = "ValuePrinter" )
case.execute()
The result of running these commands in SALOME (either as a SALOME "shell" command, in the Python command window of the interface, or by the script execution entry of the menu) is the following::
Analysis [ 0.25000264 0.79999797 0.94999939]
Real cases involve observations loaded from files, operators explicitly defined as generic functions including physical simulators, time dependant information in order to deal with forecast analysis in addition to calibration or re-analysis. More details can be found in the full ADAO documentation (see documentation on the reference site https://www.salome-platform.org/, with https://docs.salome-platform.org/latest/gui/ADAO/en/index.html for english or https://docs.salome-platform.org/latest/gui/ADAO/fr/index.html for french, both being equivalents).
The license for this module is the GNU Lesser General Public License (Lesser GPL), as stated here and in the source files::
<ADAO, a module for Data Assimilation and Optimization>
Copyright (C) 2008-2024 EDF R&D
This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public
License as published by the Free Software Foundation; either
version 2.1 of the License, or (at your option) any later version.
This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public
License along with this library; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
See http://www.salome-platform.org/
In addition, it is requested that any publication or presentation, describing work using this module, or any commercial or non-commercial product using it, cite at least one of the references below with the current year added:
* *ADAO, a module for Data Assimilation and Optimization*,
http://www.salome-platform.org/
* *ADAO, un module pour l'Assimilation de Données et l'Aide à
l'Optimisation*, http://www.salome-platform.org/
* *SALOME The Open Source Integration Platform for Numerical Simulation*,
http://www.salome-platform.org/
The documentation of the module is also covered by the license and the requirement of quoting.
FAQs
ADAO: A module for Data Assimilation and Optimization
We found that adao demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
PyPI confirms no security flaws were exploited in the Ultralytics supply chain attack and highlights improvements for safer package publishing.
Security News
Research
The Socket Research Team breaks down a malicious wrapper package that uses obfuscation to harvest credentials and exfiltrate sensitive data.
Research
Security News
Attackers used a malicious npm package typosquatting a popular ESLint plugin to steal sensitive data, execute commands, and exploit developer systems.