{"id":16877409,"url":"https://github.com/juntyr/sosaa-gui","last_synced_at":"2025-10-07T06:51:34.493Z","repository":{"id":156483066,"uuid":"607139104","full_name":"juntyr/sosaa-gui","owner":"juntyr","description":"GUI for configuring the SOSAA model","archived":false,"fork":false,"pushed_at":"2023-04-26T17:46:26.000Z","size":591,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-09-29T16:02:01.187Z","etag":null,"topics":["config","gui","sosaa"],"latest_commit_sha":null,"homepage":"https://www.helsinki.fi/en/researchgroups/multi-scale-modelling/sosaa","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/juntyr.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":"CITATION.cff","codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2023-02-27T11:53:47.000Z","updated_at":"2023-04-26T17:01:28.000Z","dependencies_parsed_at":null,"dependency_job_id":"6b9dc475-0043-4b66-a506-230855ae3ce9","html_url":"https://github.com/juntyr/sosaa-gui","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/juntyr/sosaa-gui","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/juntyr%2Fsosaa-gui","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/juntyr%2Fsosaa-gui/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/juntyr%2Fsosaa-gui/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/juntyr%2Fsosaa-gui/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/juntyr","download_url":"https://codeload.github.com/juntyr/sosaa-gui/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/juntyr%2Fsosaa-gui/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278734407,"owners_count":26036404,"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","status":"online","status_checked_at":"2025-10-07T02:00:06.786Z","response_time":59,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["config","gui","sosaa"],"created_at":"2024-10-13T15:43:27.942Z","updated_at":"2025-10-07T06:51:34.484Z","avatar_url":"https://github.com/juntyr.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# SOSAA GUI \u0026emsp; [![DOI]][doi-url] [![PyPi]][pypi-url] [![License]][gpl-3.0] [![CI Status]][ci-status]\n\n[DOI]: https://zenodo.org/badge/607139104.svg\n[doi-url]: https://doi.org/10.5281/zenodo.7868439\n\n[PyPI]: https://img.shields.io/pypi/v/sosaa-gui\n[pypi-url]: https://pypi.org/project/sosaa-gui\n\n[License]: https://img.shields.io/badge/License-GPL--3.0-blue.svg\n[gpl-3.0]: https://www.gnu.org/licenses/gpl-3.0.html\n\n[CI Status]: https://img.shields.io/github/actions/workflow/status/juntyr/sosaa-gui/ci.yml?branch=main\u0026label=CI\n[ci-status]: https://github.com/juntyr/sosaa-gui/actions/workflows/ci.yml?query=branch%3Amain\n\nThe [SOSAA model](https://www.helsinki.fi/en/researchgroups/multi-scale-modelling/sosaa) is a chemistry transport model that has been actively developed in the Multi-Scale Modelling Group at the University of Helsinki since 2011 [^1].\n\nThe SOSAA GUI provides a graphical user interface to configure, compile, run, and explore the SOSAA model. In particular, it allows the user to load, edit, and save INITFILEs for the model. The GUI is fully independent of SOSAA and can thus be run on a separate machine if needed. However, if SOSAA is installed on the same machine, the GUI can also be used to compile and run the model.\n\nThe GUI also provides access to the SOSAA Response Surface Model (RSM), which can be used to approximate the SOSAA model using machine learning. Note, however, that the SOSAA RSM, which is evaluated in [Juniper Tyree](https://github.com/juntyr)'s Masters Thesis on [\"Prudent Response Surface Models\"](https://github.com/juntyr/prudent-response-surface-models), should currently *only* be used to experiment with and improve the RSM itself.\n\n## Installation\n\n### pip\n\nThe SOSAA GUI is available on the Python Package Index (PyPI) and can be installed using\n```bash\npip install sosaa-gui\n```\nThis command can also be run inside a conda environment to install the SOSAA GUI with conda.\n\n### From Source\n\nFirst, clone the git repository using\n```bash\ngit clone https://github.com/juntyr/sosaa-gui.git\n```\nor\n```bash\ngit clone git@github.com:juntyr/sosaa-gui.git\n```\n\nNext, enter the repository folder and use `pip` to install the program:\n```bash\ncd sosaa-gui \u0026\u0026 pip install .\n```\n\nFinally, you can launch the GUI using\n```bash\nsosaa-gui\n```\n\n## SOSAA Model Availability\n\nUnfortunately, the SOSAA model is not yet publicly available. However, access to the complete SOSAA source code is provided upon request -- please contact Michael Boy (michael.boy@helsinki.fi), Putian Zhou (putian.zhou@helsinki.fi), or Petri Clusius (petri.clusius@helsinki.fi) for more information.\n\n## Usage Notes\n\nIf you experience problems with the UI scaling, try launching the GUI as follows:\n```bash\nQT_SCREEN_SCALE_FACTORS=\"1.17;1.17\" sosaa-gui\n```\n\nNote that you will need `xterm`, `uxterm`, `rxvt`, or `urxvt` installed on your system and in your path if you want to compile or run SOSAA *from within* the SOSAA GUI.\n\n## License\n\nLicensed under the GPL-3.0 license ([LICENSE-GPL](LICENSE-GPL) or https://www.gnu.org/licenses/gpl-3.0.html).\n\n## Citation\n\nPlease refer to the [CITATION.cff](CITATION.cff) file and refer to https://citation-file-format.github.io to extract the citation in a format of your choice.\n\nThe SOSAA GUI was created as part of [Juniper Tyree](https://github.com/juntyr)'s Masters Thesis [\"Prudent Response Surface Models\"](https://github.com/juntyr/prudent-response-surface-models) for the M.Sc. Theoretical and Computational Methods programme at the University of Helsinki.\n\n[^1]: M. Boy *et al*. SOSA \u0026ndash; a new model to simulate the concentrations of organic vapours and sulphuric acid inside the ABL \u0026ndash; Part 1: Model description and initial evaluation. *Atmospheric Chemistry and Physics*. 2011;11 (1): 43\u0026ndash;51. Available from: [doi:10.5194/acp-11-43-2011](https://doi.org/10.5194/acp-11-43-2011).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjuntyr%2Fsosaa-gui","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjuntyr%2Fsosaa-gui","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjuntyr%2Fsosaa-gui/lists"}