{"id":28174185,"url":"https://github.com/blakeaw/objectivelearner","last_synced_at":"2026-04-29T09:34:56.680Z","repository":{"id":161734764,"uuid":"199732945","full_name":"blakeaw/ObjectiveLearner","owner":"blakeaw","description":"Get more out of objective function evaluations made during model calibrations.","archived":false,"fork":false,"pushed_at":"2019-09-17T15:06:58.000Z","size":14,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2026-04-13T13:44:00.848Z","etag":null,"topics":["linear-regression","machine-learning","model-calibrations","python","python-decorators","sensitivity-analysis"],"latest_commit_sha":null,"homepage":"","language":"Jupyter Notebook","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/blakeaw.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2019-07-30T21:54:33.000Z","updated_at":"2019-09-17T15:07:00.000Z","dependencies_parsed_at":null,"dependency_job_id":"d51ccd6e-ded5-433f-aabb-95139e0e7454","html_url":"https://github.com/blakeaw/ObjectiveLearner","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/blakeaw/ObjectiveLearner","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blakeaw%2FObjectiveLearner","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blakeaw%2FObjectiveLearner/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blakeaw%2FObjectiveLearner/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blakeaw%2FObjectiveLearner/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/blakeaw","download_url":"https://codeload.github.com/blakeaw/ObjectiveLearner/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blakeaw%2FObjectiveLearner/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32420347,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-29T06:29:02.080Z","status":"ssl_error","status_checked_at":"2026-04-29T06:29:00.631Z","response_time":110,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["linear-regression","machine-learning","model-calibrations","python","python-decorators","sensitivity-analysis"],"created_at":"2025-05-15T22:15:22.732Z","updated_at":"2026-04-29T09:34:56.675Z","avatar_url":"https://github.com/blakeaw.png","language":"Jupyter Notebook","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ObjectiveLearner\n#### Get more out of objective function evaluations.\n\n![Python version badge](https://img.shields.io/badge/python-\u003e=3.6-blue.svg)\n[![license](https://img.shields.io/github/license/blakeaw/ObjectiveLearner.svg)](LICENSE)\n![version](https://img.shields.io/badge/version-0.1.0-orange.svg)\n[![release](https://img.shields.io/github/release-pre/blakeaw/ObjectiveLearner.svg)](https://github.com/blakeaw/ObjectiveLearner/releases/tag/v0.1.0)\n[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.3408007.svg)](https://doi.org/10.5281/zenodo.3408007)\n\n**ObjectiveLearner** is a python module that provides functionality to run [Supervised Machine Learning](https://en.wikipedia.org/wiki/Machine_learning#Supervised_learning) (linear regression) and [Sensitivity Analysis](https://en.wikipedia.org/wiki/Sensitivity_analysis#Regression_analysis) on the objective function versus parameter relationship using the thousands (to millions) of (sometimes expensive) objective function evaluations performed during model calibration with packages like [PyDREAM](https://github.com/LoLab-VU/PyDREAM), [simplePSO](https://github.com/LoLab-VU/ParticleSwarmOptimization), [Gleipnir](https://github.com/LoLab-VU/Gleipnir), and [GAlibrate](https://github.com/blakeaw/GAlibrate).\n\nObjectiveLearner provides easy to use objective function decorators which allow users to save data from the objective function evaluations performed during model calibration, and thereby provides them a way to utilize what would typically be lost data (i.e., not saved by the calibrator) and learn even more about the objective function and its relationship to model parameters, as well as learn more about the underlying model and assumptions the objective function represents.\n\n------\n\n# Install\n\n| **! Warning** |\n| :--- |\n|  ObjectiveLearner is still under heavy development and may rapidly change. |\n\n**ObjectiveLearner** installs as the `objlearner` package. It is compatible (i.e., tested) with Python \u003e= 3.6.\n\nNote that `objlearner` has the following core dependencies:\n   * [NumPy](http://www.numpy.org/)\n   * [pandas](https://pandas.pydata.org/)\n   * [scikit-learn](https://scikit-learn.org/stable/)\n   * [SALib](https://salib.readthedocs.io/en/latest/)\n\n### pip install\nYou can install the latest release of the `objlearner` package using `pip` sourced from the GitHub repo:\n```\npip install -e git+https://github.com/blakeaw/ObjectiveLearner@v0.1.0#egg=objlearner\n```\nHowever, this will not automatically install the core dependencies. You will have to do that separately:\n```\npip install numpy pandas scikit-learn SALib\n```\n\n### Recommended additional software\n\nThe following software is not required for the basic operation of ObjectiveLearner, but provides extra capabilities and features when installed.\n\n#### PySB\n[PySB](http://pysb.org/) is needed to run PySB models.\n\n\n#### Jupyter\nIf you want to run the Jupyter IPython notebooks that come with ObjectiveLearner then you need to install [Jupyter](https://jupyter.org/).\n\n------\n\n# License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details\n\n------\n\n# Documentation and Usage\n\n### Quick Overview\nPrincipally, **ObjectiveLearner** defines the **ObjectiveLearner** class,\n```python\nfrom objlearner import ObjectiveLearner\n```\nwhich defines an object that can be used to decorate a objective function:\n```python\n@ObjectiveLearner\ndef objective(theta):\n    ...\n    ...\n    return objective_value\n```\nThe ObjectiveLearner decorator saves the input parameter vectors and the corresponding objective values generated when the objective function is called during model calibrations and provides functions to post-analyze the values with linear regression (using tools from scikit-learn) and sensitivity analysis (using tools from SALib).\n\nAdditionally, **ObjectiveLearner** provides two other decorator classes:\n  * ObjectiveCounter - simply keeps count of the number of calls to the objective function.\n  * ObjectiveSaver - In addition to keeping count of the number of calls to the objective function, it stores the parameter vectors and corresponding objective function values and provides functions to write the data to a file.\n\n### Jupyter Notebooks\nCheckout the Jupyter IPython Notebook:\n 1. [Basics of ObjectiveLearner](./jupyter_notebooks/Basics_of_ObjectiveLearner.ipynb)\n\n------\n\n# Contact\n\nTo report problems or bugs, make comments, suggestions, or feature requests please open a [GitHub Issue](https://github.com/blakeaw/ObjectiveLearner/issues).\n\n------\n\n# Citing\n\nIf you use the **ObjectiveLearner** software in your research, please cite it. You can export the reference in your preferred format from its [Zenodo DOI](https://doi.org/10.5281/zenodo.3408006) entry.\n\nAlso, please cite the following references as appropriate for software used with/via **ObjectiveLearner**:\n\n#### Packages from the SciPy ecosystem\nThese include NumPy and pandas for which references can be obtained from:\nhttps://www.scipy.org/citing.html\n\n#### scikit-learn\n  1. Scikit-learn: Machine Learning in Python, Pedregosa et al., JMLR 12, pp. 2825-2830, 2011.\n\n#### SALib\n  1. Herman, J. and Usher, W. (2017) SALib: An open-source Python library for sensitivity analysis. Journal of Open Source Software, 2(9). doi:10.21105/joss.00097\n\n#### PySB\n  1. Lopez, C. F., Muhlich, J. L., Bachman, J. A. \u0026 Sorger, P. K. Programming biological models in Python using PySB. Mol Syst Biol 9, (2013). doi:[10.1038/msb.2013.1](dx.doi.org/10.1038/msb.2013.1)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblakeaw%2Fobjectivelearner","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fblakeaw%2Fobjectivelearner","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblakeaw%2Fobjectivelearner/lists"}