=====================================================
ADAO: A module for Data Assimilation and Optimization
=====================================================
About
-----
**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.
A simple setup example of an ADAO TUI calculation case
------------------------------------------------------
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]
More advanced examples of ADAO TUI calculation case
---------------------------------------------------
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).
License and requirements
------------------------
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-2023 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.
Raw data
{
"_id": null,
"home_page": "http://www.salome-platform.org/",
"name": "adao",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": "",
"keywords": "optimization,data assimilation,calibration,interpolation,reduction,inverse problem,tunning,sampling,minimization,black-box,checking,3D-Var,4D-Var,Filtering,Kalman,Ensemble,Regression,Quantile,V&V,Tabu Search,BLUE,EnKF,Ensemble Kalman Filter,PSO,Particle Swarm Optimization,UKF,Unscented Kalman Filter,Least Squares,Unscented,EIM,DFO,Derivative Free Optimization,Swarm,Optimal Positioning,Gradient Test,Adjoint Test,Sensitivity,Quantile Regression",
"author": "Jean-Philippe Argaud",
"author_email": "jean-philippe.argaud@edf.fr",
"download_url": "https://files.pythonhosted.org/packages/46/b9/eed9ec12a64950a3c3efd7b577e5a99ee88c29f993dd1bd23772fa456d50/adao-9.12.0.3.tar.gz",
"platform": null,
"description": "=====================================================\nADAO: A module for Data Assimilation and Optimization\n=====================================================\n\nAbout\n-----\n\n**The ADAO module provides data assimilation and optimization** features in\nPython or SALOME context (see http://www.salome-platform.org/). Briefly stated,\nData Assimilation is a methodological framework to compute the optimal estimate\nof the inaccessible true value of a system state, eventually over time. It uses\ninformation coming from experimental measurements or observations, and from\nnumerical *a priori* models, including information about their errors. Parts of\nthe framework are also known under the names of *calibration*, *adjustment*,\n*state estimation*, *parameter estimation*, *parameter adjustment*, *inverse\nproblems*, *Bayesian estimation*, *optimal interpolation*, *mathematical\nregularization*, *meta-heuristics for optimization*, *model reduction*, *data\nsmoothing*, etc. More details can be found in the full ADAO documentation (see\nhttps://www.salome-platform.org/ User Documentation dedicated section).\n\nOnly the use of ADAO text programming interface (API/TUI) is introduced\nhere. This interface gives ability to create a calculation object in a\nsimilar way than the case building obtained through the graphical\ninterface (GUI). When one wants to elaborate directly the TUI\ncalculation case, it is recommended to extensively use all the ADAO\nmodule documentation, and to go back if necessary to the graphical\ninterface (GUI), to get all the elements allowing to correctly set the\ncommands.\n\nA simple setup example of an ADAO TUI calculation case\n------------------------------------------------------\n\nTo introduce the TUI interface, lets begin by a simple but complete\nexample of ADAO calculation case. All the data are explicitly defined\ninside the script in order to make the reading easier. The whole set of\ncommands is the following one::\n\n from numpy import array, matrix\n from adao import adaoBuilder\n case = adaoBuilder.New()\n case.set( 'AlgorithmParameters', Algorithm = '3DVAR' )\n case.set( 'Background', Vector = [0, 1, 2] )\n case.set( 'BackgroundError', ScalarSparseMatrix = 1.0 )\n case.set( 'Observation', Vector = array([0.5, 1.5, 2.5]) )\n case.set( 'ObservationError', DiagonalSparseMatrix = '1 1 1' )\n case.set( 'ObservationOperator', Matrix = '1 0 0;0 2 0;0 0 3' )\n case.set( 'Observer', Variable = \"Analysis\", Template = \"ValuePrinter\" )\n case.execute()\n\nThe result of running these commands in SALOME (either as a SALOME\n\"*shell*\" command, in the Python command window of the interface, or by\nthe script execution entry of the menu) is the following::\n\n Analysis [ 0.25000264 0.79999797 0.94999939]\n\nMore advanced examples of ADAO TUI calculation case\n---------------------------------------------------\n\nReal cases involve observations loaded from files, operators explicitly\ndefined as generic functions including physical simulators, time dependant\ninformation in order to deal with forecast analysis in addition to calibration\nor re-analysis. More details can be found in the full ADAO documentation (see\ndocumentation on the reference site https://www.salome-platform.org/, with\nhttps://docs.salome-platform.org/latest/gui/ADAO/en/index.html for english or\nhttps://docs.salome-platform.org/latest/gui/ADAO/fr/index.html for french, both\nbeing equivalents).\n\nLicense and requirements\n------------------------\n\nThe license for this module is the GNU Lesser General Public License\n(Lesser GPL), as stated here and in the source files::\n\n <ADAO, a module for Data Assimilation and Optimization>\n\n Copyright (C) 2008-2023 EDF R&D\n\n This library is free software; you can redistribute it and/or\n modify it under the terms of the GNU Lesser General Public\n License as published by the Free Software Foundation; either\n version 2.1 of the License, or (at your option) any later version.\n\n This library is distributed in the hope that it will be useful,\n but WITHOUT ANY WARRANTY; without even the implied warranty of\n MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU\n Lesser General Public License for more details.\n\n You should have received a copy of the GNU Lesser General Public\n License along with this library; if not, write to the Free Software\n Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA\n\n See http://www.salome-platform.org/\n\nIn addition, it is requested that any publication or presentation, describing\nwork using this module, or any commercial or non-commercial product using it,\ncite at least one of the references below with the current year added:\n\n * *ADAO, a module for Data Assimilation and Optimization*,\n http://www.salome-platform.org/\n\n * *ADAO, un module pour l'Assimilation de Donn\u00e9es et l'Aide \u00e0\n l'Optimisation*, http://www.salome-platform.org/\n\n * *SALOME The Open Source Integration Platform for Numerical Simulation*,\n http://www.salome-platform.org/\n\nThe documentation of the module is also covered by the license and the\nrequirement of quoting.\n",
"bugtrack_url": null,
"license": "GNU Library or Lesser General Public License (LGPL)",
"summary": "A module for Data Assimilation and Optimization",
"version": "9.12.0.3",
"project_urls": {
"Homepage": "http://www.salome-platform.org/"
},
"split_keywords": [
"optimization",
"data assimilation",
"calibration",
"interpolation",
"reduction",
"inverse problem",
"tunning",
"sampling",
"minimization",
"black-box",
"checking",
"3d-var",
"4d-var",
"filtering",
"kalman",
"ensemble",
"regression",
"quantile",
"v&v",
"tabu search",
"blue",
"enkf",
"ensemble kalman filter",
"pso",
"particle swarm optimization",
"ukf",
"unscented kalman filter",
"least squares",
"unscented",
"eim",
"dfo",
"derivative free optimization",
"swarm",
"optimal positioning",
"gradient test",
"adjoint test",
"sensitivity",
"quantile regression"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "46b9eed9ec12a64950a3c3efd7b577e5a99ee88c29f993dd1bd23772fa456d50",
"md5": "7561b52c2b84b4f20a40ee0a1be490fb",
"sha256": "28cf6fdfbe8f8c7bcdb5168f514939b9ad2e7649df09a6f1084325b4aa3ed08d"
},
"downloads": -1,
"filename": "adao-9.12.0.3.tar.gz",
"has_sig": false,
"md5_digest": "7561b52c2b84b4f20a40ee0a1be490fb",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 303018,
"upload_time": "2024-01-28T07:01:19",
"upload_time_iso_8601": "2024-01-28T07:01:19.595410Z",
"url": "https://files.pythonhosted.org/packages/46/b9/eed9ec12a64950a3c3efd7b577e5a99ee88c29f993dd1bd23772fa456d50/adao-9.12.0.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-01-28 07:01:19",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "adao"
}
JSON