CoMSES Net is an open, international community of researchers, educators and professionals with the common goal of improving the way we develop, document, share, and (re)use computational models in the social and ecological sciences. This repository contains the codebase for the comses.net CMS and Model Library, built with Wagtail, Django Rest Framework, and VueJS.
The Computational Model Library maintains distinct submission information packages (SIPs) and archival information packages (AIPs) using bagit, and emits structured, standardized metadata on every model landing page. All computational models offer citations that adhere to the guidelines and practices set forth by the Force 11 Software Citation Working Group. Models can also undergo peer review to receive a DOI and open code badge. Updates to these processes are anticipated in 2021 - stay tuned!
Members who participate in this project agree to abide by the CoMSES Net Code of Conduct. By participating, you are expected to uphold this code. Please report unacceptable behavior to [email protected].
Members are encouraged to participate and we welcome contributions of all kinds to our collective effort. Here's how you can contribute:
We develop and maintain the CoMSES Model Library, a digital repository to archive model code that supports discovery and the FAIR Data Principles for software citation, reproducibility and reuse.
Archive your model here: https://www.comses.net/codebases/
The CoMSES Net Peer Review Process helps to verify that a computational model's source code and documentation meets baseline community standards from the software engineering and scientific communities that we serve.
Peer reviewers follow a 3 item checklist and inspect model code and documentation for completeness, cleanliness, and the ability to run the computational model without errors.
We're always looking for new members willing to review computational models. Feel free to submit your own computational models for peer review as well - after they pass peer review they will be eligible to be issued a DOI.
Members of our community also use the CoMSES Net Discourse Forums to discuss models, events, jobs, ask questions, and more. If you'd like to lead a journal club or model club or coordinate any other activities on these forums, please contact us.
All registered CoMSES Net members can post information about upcoming conferences, workshops and job openings on our events and jobs boards. If you would like to spread the word for new job opportunities or events, please feel free to register on our site and post it on our site!
Events board: https://www.comses.net/events/
Jobs board: https://www.comses.net/jobs/
CoMSES Net is actively working with the Science Gateways Community Institute to improve the usability of our services. Please let us know if you'd like to participate in upcoming usability studies or help us conduct usability studies in your institution or area.
Our technology stack includes:
Javascript: VueJS, webpack, typescript
Python: Django Rest Framework, Wagtail
PostgreSQL / MySQL
Linux
Docker
We accept contributions of all kinds! Pull requests, issues to request new features, enhancements, or bug reports are all welcome. Please make sure to review the CONTRIBUTING.md guidelines.
Create a pull request from a fork
Run ./build.sh to build the Docker image and generate secrets and a symlinked docker-compose.yml file. Run docker-compose up -d to start all containers.
The build.sh script relies on
envsubst and to install this on macOS you may need to install macports or use homebrew and brew install gettext.
Enabling debugging is still a bit of a pain and requires custom workarounds to the Docker environment. @cpritcha should document these at some point.
Other Repositories
- Catalog provides web services for annotating and managing publications that reference computational research objects. Developed by CoMSES Net to assess the state of open and reusable scientific computation in agent based modeling, it depends on the citation Django app for bibliometric metadata management. Our instance of catalog runs at https://catalog.comses.net
- The Open Modeling Foundation (OMF) is an alliance of modeling organizations that coordinates and administers a common, community developed body of standards and best practices among diverse communities of modeling scientists. This repository hosts a hugo site and is used to collaboratively draft computational modeling standards for the OMF.
This project follows the all-contributors specification. Contributions of all kinds are welcome!
Contributors (emoji key):
 cpritcha 💻 📖 🐛 🚧 |
 Christine Nguyễn 🐛 💻 📖 🎨 |
 Katrin Leinweber 💻 |
 A Lee 🐛 💻 📖 🔍 🤔 🚇 🚧 📆 👀 🛡️ |