diff --git a/bazaar/plugin/sundials/Copying b/bazaar/plugin/sundials/Copying new file mode 100644 index 000000000..2966cbb27 --- /dev/null +++ b/bazaar/plugin/sundials/Copying @@ -0,0 +1,29 @@ +BSD 3-Clause License + +Copyright (c) 2002-2019, Lawrence Livermore National Security and Southern Methodist University. +All rights reserved. + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions are met: + +* Redistributions of source code must retain the above copyright notice, this + list of conditions and the following disclaimer. + +* Redistributions in binary form must reproduce the above copyright notice, + this list of conditions and the following disclaimer in the documentation + and/or other materials provided with the distribution. + +* Neither the name of the copyright holder nor the names of its + contributors may be used to endorse or promote products derived from + this software without specific prior written permission. + +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" +AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE +DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE +FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR +SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER +CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, +OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. diff --git a/bazaar/plugin/sundials/NOTICE b/bazaar/plugin/sundials/NOTICE new file mode 100644 index 000000000..329b142ee --- /dev/null +++ b/bazaar/plugin/sundials/NOTICE @@ -0,0 +1,21 @@ +This work was produced under the auspices of the U.S. Department of +Energy by Lawrence Livermore National Laboratory under Contract +DE-AC52-07NA27344. + +This work was prepared as an account of work sponsored by an agency of +the United States Government. Neither the United States Government nor +Lawrence Livermore National Security, LLC, nor any of their employees +makes any warranty, expressed or implied, or assumes any legal liability +or responsibility for the accuracy, completeness, or usefulness of any +information, apparatus, product, or process disclosed, or represents that +its use would not infringe privately owned rights. + +Reference herein to any specific commercial product, process, or service +by trade name, trademark, manufacturer, or otherwise does not necessarily +constitute or imply its endorsement, recommendation, or favoring by the +United States Government or Lawrence Livermore National Security, LLC. + +The views and opinions of authors expressed herein do not necessarily +state or reflect those of the United States Government or Lawrence +Livermore National Security, LLC, and shall not be used for advertising +or product endorsement purposes. \ No newline at end of file diff --git a/bazaar/plugin/sundials/README.md b/bazaar/plugin/sundials/README.md new file mode 100644 index 000000000..18aa60f26 --- /dev/null +++ b/bazaar/plugin/sundials/README.md @@ -0,0 +1,122 @@ +# SUNDIALS: SUite of Nonlinear and DIfferential/ALgebraic equation Solvers # +### Version 5.3.0 (May 2020) ### + +**Center for Applied Scientific Computing, Lawrence Livermore National Laboratory** + +SUNDIALS is a family of software packages implemented with the goal of +providing robust time integrators and nonlinear solvers that can easily be +incorporated into existing simulation codes. The primary design goals are to +require minimal information from the user, allow users to easily supply their +own data structures underneath the packages, and allow for easy incorporation +of user-supplied linear solvers and preconditioners. The various packages share +many subordinate modules and are organized as a family with a directory +structure that exploits sharing common functionality. + +The SUNDIALS suite consists of the following packages: + +* ARKODE - for integration of stiff, nonstiff, and multirate ordinary +differential equation systems (ODEs) of the form + + ``` M y' = f1(t,y) + f2(t,y), y(t0) = y0 ``` + +* CVODE - for integration of stiff and nonstiff ordinary differential equation +systems (ODEs) of the form + + ``` y' = f(t,y), y(t0) = y0 ``` + +* CVODES - for integration and sensitivity analysis (forward and adjoint) of +ordinary differential equation systems (ODEs) of the form + + ``` y' = f(t,y,p), y(t0) = y0(p) ``` + +* IDA - for integration of differential-algebraic equation systems (DAEs) of +the form + + ``` F(t,y,y') = 0, y(t0) = y0, y'(t0) = y0' ``` + +* IDAS - for integration and sensitivity analysis (forward and adjoint) of +differential-algebraic equation systems (DAEs) of the form + + ``` F(t,y,y',p) = 0, y(t0) = y0(p), y'(t0) = y0'(p) ``` + +* KINSOL - for solution of nonlinear algebraic systems of the form + + ``` F(u) = 0 ``` + +## Installation ## + +For installation directions see the [INSTALL_GUIDE](./INSTALL_GUIDE.pdf) or +the installation chapter in any of the package user guides. + +Warning to users who receive more than one of the individual packages at +different times: Mixing old and new versions of SUNDIALS may fail. To avoid +such failures, obtain all desired package at the same time. + +## Support ## + +Full user guides for SUNDIALS packages are provided in the [doc](./doc) +directory along with documentation for example programs. + +A list of Frequently Asked Questions on build and installation procedures as +well as common usage issues is available on the SUNDIALS [FAQ](https://computing.llnl.gov/projects/sundials/faq). +For dealing with systems with unphysical solutions or discontinuities see the +SUNDIALS [usage notes](https://computing.llnl.gov/projects/sundials/usage-notes). + +If you have a question not covered in the FAQ or usage notes, please submit +your question to the SUNDIALS [mailing list](https://computing.llnl.gov/projects/sundials/mailing-list). + +## Contributing ## + +Bug fixes or minor changes are preferred via a pull request to the +[SUNDIALS GitHub repository](https://github.com/LLNL/sundials). For more +information on contributing see the [CONTRIBUTING](./CONTRIBUTING.md) file. + +## Release History ## + +Information on recent changes to SUNDIALS can be found in the "Introduction" +chapter of each package's user guide and a complete release history is available +in the "SUNDIALS Release History" appendix of each user guide. + +## Authors ## + +The SUNDIALS Team: Carol S. Woodward, Daniel R. Reynolds, Alan C. Hindmarsh, +David J. Gardner, and Cody J. Balos. We thank Radu Serban for significant +and critical past contributions. + +We also acknowledge past contributions of Scott D. Cohen, Peter N. Brown, +George Byrne, Allan G. Taylor, Steven L. Lee, Keith E. Grant, Aaron Collier, +Lawrence E. Banks, Steve Smith, Cosmin Petra, Slaven Peles, John Loffeld, Dan Shumaker, +Ulrike Yang, James Almgren-Bell, Shelby L. Lockhart, Hilari C. Tiedeman, Ting Yan, +Jean M. Sexton, and Chris White. + +### Citing SUNDIALS ### + +We ask users of SUNDIALS to cite the following paper in any publications +reporting work done with SUNDIALS: + +* Alan C. Hindmarsh, Peter N. Brown, Keith E. Grant, Steven L. Lee, Radu +Serban, Dan E. Shumaker, and Carol S. Woodward. 2005. SUNDIALS: Suite of +nonlinear and differential/algebraic equation solvers. ACM Trans. Math. Softw. +31, 3 (September 2005), 363-396. DOI=http://dx.doi.org/10.1145/1089014.1089020 + +## License ## + +SUNDIALS is released under the BSD 3-clause license. See the [LICENSE](./LICENSE) +and [NOTICE](./NOTICE) files for details. All new contributions must be made +under the BSD 3-clause license. + +**Please Note** If you are using SUNDIALS with any third party libraries linked +in (e.g., LAPACK, KLU, SuperLU_MT, PETSc, or *hypre*), be sure to review the +respective license of the package as that license may have more restrictive +terms than the SUNDIALS license. + +``` +SPDX-License-Identifier: BSD-3-Clause + +LLNL-CODE-667205 (ARKODE) +UCRL-CODE-155951 (CVODE) +UCRL-CODE-155950 (CVODES) +UCRL-CODE-155952 (IDA) +UCRL-CODE-237203 (IDAS) +LLNL-CODE-665877 (KINSOL) +``` diff --git a/bazaar/plugin/sundials/sundials.upp b/bazaar/plugin/sundials/sundials.upp index 5a8b1a43d..1ceeb9c25 100644 --- a/bazaar/plugin/sundials/sundials.upp +++ b/bazaar/plugin/sundials/sundials.upp @@ -1,5 +1,7 @@ description "SUNDIALS: SUite of Nonlinear and DIfferential/ALgebraic Equation Solvers\377"; +options(BUILDER_OPTION) NOWARNINGS; + uses Core;