{"id":19313515,"url":"https://github.com/duncanwp/esem","last_synced_at":"2025-04-09T21:19:02.933Z","repository":{"id":46678546,"uuid":"216659677","full_name":"duncanwp/ESEm","owner":"duncanwp","description":"Easy emulating of geophysical models including (but not limited to!) Earth System Models.","archived":false,"fork":false,"pushed_at":"2025-03-10T17:14:08.000Z","size":17919,"stargazers_count":56,"open_issues_count":6,"forks_count":12,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-04-09T21:18:57.673Z","etag":null,"topics":["climate","emulation","machine-learning"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/duncanwp.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","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}},"created_at":"2019-10-21T20:30:09.000Z","updated_at":"2025-03-10T17:14:12.000Z","dependencies_parsed_at":"2025-03-26T14:10:30.245Z","dependency_job_id":"3509ced6-e319-4f07-9125-1932fde4a0b4","html_url":"https://github.com/duncanwp/ESEm","commit_stats":{"total_commits":163,"total_committers":6,"mean_commits":"27.166666666666668","dds":0.09815950920245398,"last_synced_commit":"83fcb6add326c1c2f613e8abb8f505dbf9236d6a"},"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/duncanwp%2FESEm","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/duncanwp%2FESEm/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/duncanwp%2FESEm/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/duncanwp%2FESEm/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/duncanwp","download_url":"https://codeload.github.com/duncanwp/ESEm/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248111973,"owners_count":21049578,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["climate","emulation","machine-learning"],"created_at":"2024-11-10T00:39:55.686Z","updated_at":"2025-04-09T21:19:02.903Z","avatar_url":"https://github.com/duncanwp.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"Earth System Emulator (ESEm)\n============================\n\n[![CircleCI](https://circleci.com/gh/duncanwp/ESEm.svg?style=svg)](https://circleci.com/gh/duncanwp/ESEm)\n[![codecov](https://codecov.io/gh/duncanwp/ESEm/branch/master/graph/badge.svg?token=4QI2G22Q3M)](https://codecov.io/gh/duncanwp/ESEm)\n[![readthedocs](https://readthedocs.org/projects/pip/badge/?version=latest\u0026style=plastic)](https://esem.readthedocs.io/en/latest/)\n[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.5196631.svg)](https://doi.org/10.5281/zenodo.5196631)\n[![PyPI version](https://badge.fury.io/py/ESEm.svg)](https://pypi.org/project/ESEm/)\n\nA tool for emulating geophysical datasets including (but not limited to!) Earth System Models.\n\nWhy ESEm?\n---------\n\nWhile excellent tools exist for regression and emulation, and similarly for efficient calibration, there isn't a single package that makes it easy for Earth scientists to emulate and calibrate their models. ESEm provides a simple interface to do so, with a thin wrapper around familiar emulation engines and efficient sampling tools. \n\nESEm can use [Iris](https://scitools-iris.readthedocs.io/en/stable/) Cubes or [xarray](http://xarray.pydata.org/en/stable/) DataArrays to retain useful geophysical information about the data being emulated and also streamlines the typical task of co-locating models and observations for comparison using e.g. [CIS](https://cis.readthedocs.io/).\n\nThese tasks aren't just restricted to emulating and calibrating models though and can be used in any situation where regression of Earth system data is needed.\n\nDocumentation\n-------------\n\nDetailed instructions and example notebooks can be found in our official documentation at https://esem.readthedocs.io/en/latest/\n\nInstallation\n------------\n\nESEm can be easily installed using pip, including tensorflow (with GPU support):\n\n    $ pip install esem\n\nOptionally also install GPFlow, keras or scikit-learn e.g.,:\n\n    $ pip install esem[gpflow]\n\nFor more detailed instructions, including using conda to install alongside iris or xarray see https://esem.readthedocs.io/en/latest/installation.html\n\nCitation\n--------\n\nIf you use ESEm in your research please be sure to cite our [paper](https://gmd.copernicus.org/preprints/gmd-2021-267/):\n\n    @Article{gmd-2021-267,\n    AUTHOR = {Watson-Parris, D. and Williams, A. and Deaconu, L. and Stier, P.},\n    TITLE = {Model calibration using ESEm v1.0.0 -- an open, scalable Earth System Emulator},\n    JOURNAL = {Geoscientific Model Development Discussions},\n    VOLUME = {2021},\n    YEAR = {2021},\n    PAGES = {1--24},\n    URL = {https://gmd.copernicus.org/preprints/gmd-2021-267/},\n    DOI = {10.5194/gmd-2021-267}\n    }\n\nContributing\n------------\n\nContributions to ESEm of any size are very welcome, please see our [Contributing](https://github.com/duncanwp/ESEm/blob/master/CONTRIBUTING.md) page for more details.\n\n\nGet in touch\n------------\n - Ask general installation and usage questions (\"How do I?\") in our [Discussions](https://github.com/duncanwp/ESEm/discussions) tab.\n - Report bugs and suggest features in the [Issues](https://github.com/duncanwp/ESEm/issues) tab\n\n\nLicense\n-------\n\n   Copyright 2019-2021 Duncan Watson-Parris\n\n   Licensed under the Apache License, Version 2.0 (the \"License\");\n   you may not use this file except in compliance with the License.\n   You may obtain a copy of the License at\n\n       http://www.apache.org/licenses/LICENSE-2.0\n\n   Unless required by applicable law or agreed to in writing, software\n   distributed under the License is distributed on an \"AS IS\" BASIS,\n   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n   See the License for the specific language governing permissions and\n   limitations under the License.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fduncanwp%2Fesem","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fduncanwp%2Fesem","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fduncanwp%2Fesem/lists"}