hgdl


Namehgdl JSON
Version 2.1.8 PyPI version JSON
download
home_pageNone
SummaryHGDL Optimization
upload_time2024-06-12 23:51:12
maintainerNone
docs_urlNone
authorNone
requires_python>=3.9
license*** License Agreement *** HGDL Copyright (c) 2020, The Regents of the University of California, through Lawrence Berkeley National Laboratory (subject to receipt of any required approvals from the U.S. Dept. of Energy). All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: (1) Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. (2) 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. (3) Neither the name of the University of California, Lawrence Berkeley National Laboratory, U.S. Dept. of Energy 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 OWNER 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. You are under no obligation whatsoever to provide any bug fixes, patches, or upgrades to the features, functionality or performance of the source code ("Enhancements") to anyone; however, if you choose to make your Enhancements available either publicly, or directly to Lawrence Berkeley National Laboratory, without imposing a separate written license agreement for such Enhancements, then you hereby grant the following license: a non-exclusive, royalty-free perpetual license to install, use, modify, prepare derivative works, incorporate into other computer software, distribute, and sublicense such enhancements or derivative works thereof, in binary and source code form.
keywords adaptive autonomous gui qt self driving
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # HGDL

[![PyPI](https://img.shields.io/pypi/v/HGDL)](https://pypi.org/project/hgdl/)
[![Documentation Status](https://readthedocs.org/projects/gpcam/badge/?version=latest)](https://gpcam.readthedocs.io/en/latest/?badge=latest)
[![HGDL CI](https://github.com/lbl-camera/HGDL/actions/workflows/HGDL-CI.yml/badge.svg)](https://github.com/lbl-camera/fvGP/actions/workflows/HGDL-CI.yml)
[![Codecov](https://img.shields.io/codecov/c/github/lbl-camera/HGDL)](https://app.codecov.io/gh/lbl-camera/HGDL)
[![PyPI - License](https://img.shields.io/pypi/l/HGDL)](https://pypi.org/project/hgdl/)
[<img src="https://img.shields.io/badge/slack-@gpCAM-purple.svg?logo=slack">](https://gpCAM.slack.com/)
[![DOI](https://zenodo.org/badge/434769975.svg)](https://zenodo.org/badge/latestdoi/434769975)


HGDL is an API for HPC distributed constrained function optimization.
At the core, the algorithm uses local and global optimization
and bump-function-based deflation to provide a growing list of unique optima of a differentiable function.
This tackles the common problem of non-uniquness of optimization problems, especially in machine learning.

## Usage

The following demonstrates a simple usage of the HGDL API.

```python
import numpy as np
from hgdl.hgdl import HGDL as hgdl
from hgdl.support_functions import *
import dask.distributed as distributed

bounds = np.array([[-500,500],[-500,500]])
#dask_client = distributed.Client("10.0.0.184:8786")
a = hgdl(schwefel, schwefel_gradient, bounds,
        global_optimizer = "genetic",
        local_optimizer = "dNewton", #put in local optimzers from scipy.optimize.minimize
        number_of_optima = 30000,
        num_epochs = 100)

x0 = np.random.uniform(low = bounds[:, 0], high = bounds[:,1],size = (20,2))
a.optimize(x0 = x0)

###the thread is now released, but the work continues in the background

a.get_latest() ##prints the current result whenever queried

a.kill_client() ##stops the execution and returns the result
```


## Credits

Main Developers: Marcus Noack ([MarcusNoack@lbl.gov](mailto:MarcusNoack@lbl.gov)) and David Perryman.
Several people from across the DOE national labs have given insights
that led to the code in its current form.
See [AUTHORS](AUTHORS.rst) for more details on that.
HGDL is based on the [HGDN](https://www.sciencedirect.com/science/article/pii/S037704271730225X) algorithm by Noack and Funke.


            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "hgdl",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.9",
    "maintainer_email": "Marcus Michael Noack <MarcusNoack@lbl.gov>, \"Ronald J. Pandolfi\" <ronpandolfi@lbl.gov>",
    "keywords": "adaptive, autonomous, gui, qt, self driving",
    "author": null,
    "author_email": "Marcus Michael Noack <MarcusNoack@lbl.gov>, \"Ronald J. Pandolfi\" <ronpandolfi@lbl.gov>",
    "download_url": "https://files.pythonhosted.org/packages/c8/9c/d574c29478450f4c51a622c6145412ddb280733f4bd0ac9c92c16c24fc38/hgdl-2.1.8.tar.gz",
    "platform": null,
    "description": "# HGDL\n\n[![PyPI](https://img.shields.io/pypi/v/HGDL)](https://pypi.org/project/hgdl/)\n[![Documentation Status](https://readthedocs.org/projects/gpcam/badge/?version=latest)](https://gpcam.readthedocs.io/en/latest/?badge=latest)\n[![HGDL CI](https://github.com/lbl-camera/HGDL/actions/workflows/HGDL-CI.yml/badge.svg)](https://github.com/lbl-camera/fvGP/actions/workflows/HGDL-CI.yml)\n[![Codecov](https://img.shields.io/codecov/c/github/lbl-camera/HGDL)](https://app.codecov.io/gh/lbl-camera/HGDL)\n[![PyPI - License](https://img.shields.io/pypi/l/HGDL)](https://pypi.org/project/hgdl/)\n[<img src=\"https://img.shields.io/badge/slack-@gpCAM-purple.svg?logo=slack\">](https://gpCAM.slack.com/)\n[![DOI](https://zenodo.org/badge/434769975.svg)](https://zenodo.org/badge/latestdoi/434769975)\n\n\nHGDL is an API for HPC distributed constrained function optimization.\nAt the core, the algorithm uses local and global optimization\nand bump-function-based deflation to provide a growing list of unique optima of a differentiable function.\nThis tackles the common problem of non-uniquness of optimization problems, especially in machine learning.\n\n## Usage\n\nThe following demonstrates a simple usage of the HGDL API.\n\n```python\nimport numpy as np\nfrom hgdl.hgdl import HGDL as hgdl\nfrom hgdl.support_functions import *\nimport dask.distributed as distributed\n\nbounds = np.array([[-500,500],[-500,500]])\n#dask_client = distributed.Client(\"10.0.0.184:8786\")\na = hgdl(schwefel, schwefel_gradient, bounds,\n        global_optimizer = \"genetic\",\n        local_optimizer = \"dNewton\", #put in local optimzers from scipy.optimize.minimize\n        number_of_optima = 30000,\n        num_epochs = 100)\n\nx0 = np.random.uniform(low = bounds[:, 0], high = bounds[:,1],size = (20,2))\na.optimize(x0 = x0)\n\n###the thread is now released, but the work continues in the background\n\na.get_latest() ##prints the current result whenever queried\n\na.kill_client() ##stops the execution and returns the result\n```\n\n\n## Credits\n\nMain Developers: Marcus Noack ([MarcusNoack@lbl.gov](mailto:MarcusNoack@lbl.gov)) and David Perryman.\nSeveral people from across the DOE national labs have given insights\nthat led to the code in its current form.\nSee [AUTHORS](AUTHORS.rst) for more details on that.\nHGDL is based on the [HGDN](https://www.sciencedirect.com/science/article/pii/S037704271730225X) algorithm by Noack and Funke.\n\n",
    "bugtrack_url": null,
    "license": "*** License Agreement *** HGDL Copyright (c) 2020, The Regents of the University of California, through Lawrence Berkeley National Laboratory (subject to receipt of any required approvals from the U.S. Dept. of Energy). All rights reserved.  Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:  (1) Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.  (2) 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.  (3) Neither the name of the University of California, Lawrence Berkeley National Laboratory, U.S. Dept. of Energy 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 OWNER 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.  You are under no obligation whatsoever to provide any bug fixes, patches, or upgrades to the features, functionality or performance of the source code (\"Enhancements\") to anyone; however, if you choose to make your Enhancements available either publicly, or directly to Lawrence Berkeley National Laboratory, without imposing a separate written license agreement for such Enhancements, then you hereby grant the following license: a non-exclusive, royalty-free perpetual license to install, use, modify, prepare derivative works, incorporate into other computer software, distribute, and sublicense such enhancements or derivative works thereof, in binary and source code form.",
    "summary": "HGDL Optimization",
    "version": "2.1.8",
    "project_urls": {
        "Bug Tracker": "https://github.com/lbl-camera/hgdl/issues",
        "Changelog": "https://github.com/lbl-camera/hgdl/commits/master/",
        "Documentation": "https://hgdl.readthedocs.io/",
        "Homepage": "https://github.com/lbl-camera/hgdl",
        "Repository": "https://github.com/lbl-camera/hgdl.git"
    },
    "split_keywords": [
        "adaptive",
        " autonomous",
        " gui",
        " qt",
        " self driving"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "2a40e4ba11c1ccdd0d969ec29ccf92835341a1b453c3cb4dc8f0b0473ba34560",
                "md5": "8fe969005f68e1bbfe8f3b7988bfa81b",
                "sha256": "e75c8269baff45f744b2b1d2190e198ecdb045def60a7cca09e7b39ec22b59c5"
            },
            "downloads": -1,
            "filename": "hgdl-2.1.8-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "8fe969005f68e1bbfe8f3b7988bfa81b",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.9",
            "size": 18106,
            "upload_time": "2024-06-12T23:51:10",
            "upload_time_iso_8601": "2024-06-12T23:51:10.686594Z",
            "url": "https://files.pythonhosted.org/packages/2a/40/e4ba11c1ccdd0d969ec29ccf92835341a1b453c3cb4dc8f0b0473ba34560/hgdl-2.1.8-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "c89cd574c29478450f4c51a622c6145412ddb280733f4bd0ac9c92c16c24fc38",
                "md5": "65e5b5fb7b9bcc8b55368f700be03a42",
                "sha256": "6adf644e0545054d9590a2fefa0fb510cc397851ca558c0c89ec9ec602167ecf"
            },
            "downloads": -1,
            "filename": "hgdl-2.1.8.tar.gz",
            "has_sig": false,
            "md5_digest": "65e5b5fb7b9bcc8b55368f700be03a42",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.9",
            "size": 15158,
            "upload_time": "2024-06-12T23:51:12",
            "upload_time_iso_8601": "2024-06-12T23:51:12.662741Z",
            "url": "https://files.pythonhosted.org/packages/c8/9c/d574c29478450f4c51a622c6145412ddb280733f4bd0ac9c92c16c24fc38/hgdl-2.1.8.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-06-12 23:51:12",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "lbl-camera",
    "github_project": "hgdl",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "hgdl"
}
        
Elapsed time: 0.60078s