Skip to content

Ruminant Farm Systems (RuFaS) is an open-source, next-generation, whole-farm modeling environment that simulates dairy farm production and environmental impact.

License

Notifications You must be signed in to change notification settings

DeeeeeLLLL/RuFaS

 
 

Repository files navigation

Flake8 Pytest Coverage Mypy

RuFaS: Ruminant Farm Systems

RuFaS is an open-source, next-generation, whole-farm modeling environment that simulates dairy farm production and environmental impact. It is designed to support research, innovation, and sustainable decision-making in ruminant animal agriculture.


🌍 Vision

To support research and sustainable decision-making in ruminant animal production through a state-of-the-art, open-source modeling environment that evolves with scientific and technological advances.


🎯 Mission

To build an integrated, whole-farm modeling platform that simulates:

  • Milk, meat, and crop production
  • Greenhouse gas emissions
  • Water quality impacts
  • Soil health
  • Other sustainability outcomes

We aim for the highest standards in:

  • Prediction accuracy
  • Code structure and clarity
  • Documentation and accessibility

🧪 Scientific Foundation

RuFaS is grounded in peer-reviewed science and collaborative development. It is maintained by a diverse community of researchers, developers, and stakeholders committed to transparency, reproducibility, and continuous improvement.


🚀 Getting Started

  1. Fork the repository and create a feature branch following the branching strategy in RuFaS and RuFaS GitHub Actions
  2. Open an issue to discuss your idea or bug report.
  3. Submit a pull request with a clear description of your changes.
  4. Tag relevant maintainers for review.

Please follow the guidance in CONTRIBUTING.md

For prerequisites and testing read the PREREQUISITES and End-to-End Testing files.


🤝 How to Contribute

RuFaS welcomes coding and noncoding contributions from individuals demonstrating interest and commitment to our program standards. You can:

  • 🧪 Test features and report bugs
  • 💡 Suggest new features or improvements
  • 🗣️ Engage in scientific discussions and peer reviews
  • 💻 Submit code, documentation, or scientific literature
  • 🧰 Help with user support and onboarding
  • 🎨 Design user interfaces or visual assets
  • 📣 Promote RuFaS within your networks

Please see the Contributor Covenant code of conduct and CONTRIBUTING.md for full details.


📜 License

RuFaS is licensed under GPLv3. See the COPYING.md and COPYING.LESSER.md files for details.


📬 Contact

For questions, sponsorship inquiries, or collaboration proposals, please email contact@rufas.org.


🧑‍🔬 Acknowledgements

Thanks to all the individuals and organizations that contributed to RuFaS development and maintenance in the past and continue to contribute today. Contributions to the RuFaS GitHub repository are recorded here.

About

Ruminant Farm Systems (RuFaS) is an open-source, next-generation, whole-farm modeling environment that simulates dairy farm production and environmental impact.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 90.3%
  • JavaScript 9.6%
  • Other 0.1%