App Url: https://app-ecosystem-simulation.streamlit.app/
Username : admin
Password : 1234
This interactive web application, developed using Streamlit, provides a unique educational experience through ecosystem simulations. It includes three distinct simulations, each depicting various species and ecosystems. Users engage with the app by matching animals and plants to their appropriate ecosystems, enhancing their understanding of ecological relationships.
- Interactive Simulations: Three simulations featuring different ecosystems and species.
- Dynamic User Interface: Each simulation presents a sidebar with animal and plant cards, a main screen divided into ecosystem parts, and a column displaying selected species and ecosystem characteristics.
- Custom Styling and Interactive Elements: Custom styles for Streamlit components and interactive elements like buttons and sidebars.
- Authentication System: Secure login functionality with password hashing for user access, utilizing the
config.yaml
file for configuration management. - Educational and Engaging: Designed to teach ecological principles in an engaging manner.
- Error Handling and Feedback: Mechanisms for handling errors and providing user feedback.
To run this application, you'll need Python installed on your system. Follow these steps:
-
Clone the repository:
git clone https://github.com/TovTechDataCourse/streamlit-ecosystem-simulation
-
Navigate to the project directory:
cd streamlit-ecosystem-simulation
-
Install the required dependencies:
pip install -r requirements.txt
To start the application locally, run:
streamlit run simulation1.py
To start the application through streamlit cloud:
https://ecosystem-sim.streamlit.app/
Navigate through the application using the sidebar to select simulations and make your ecosystem choices.
ורור
username: admin
password: 1234
The main directory contains:
pages
folder with subfolders for each simulation (simulation_1
,simulation_2
,simulation_3
).- Within each simulation folder, there are
animals
,plants
, andsplit_photo
folders containing respective photos. - A
for_reference.xlsx
file in each simulation folder, detailing data about the ecosystem squares.
The application requires several Python packages, listed in requirements.txt
. Key dependencies include Streamlit, Pandas, Pillow, and various Streamlit plugins for enhanced functionality.
Contributions to this project are welcome. Please follow these steps:
- Fork the repository.
- Create a new branch (
git checkout -b feature-branch
). - Make your changes and commit them (
git commit -am 'Add some feature'
). - Push to the branch (
git push origin feature-branch
). - Create a new Pull Request.
- The application uses a password hasher script for creating secure hashed passwords, enhancing the security of the authentication system.
- Configuration settings, including authentication credentials, are managed securely using a
config.yaml
file.
This project is licensed under the Apache License. For more information, see the LICENSE file in the repository.
cludes mechanisms for handling errors and providing user feedback, ensuring a smooth user experience.
- Authentication System Enhancements: The application uses
password hasher.py
for hashing passwords andconfig.yaml
for managing configuration settings, particularly for the login page.
To run this application, you'll need Python installed on your system. Follow these steps:
-
Clone the repository:
git clone https://github.com/TovTechDataCourse/streamlit-ecosystem-simulation
-
Navigate to the project directory:
cd streamlit-ecosystem-simulation
-
Install the required dependencies:
pip install -r requirements.txt
To start the application, run:
streamlit run run.py
Navigate through the application using the sidebar to select simulations and make your ecosystem choices.
The main directory contains:
pages
folder with subfolders for each simulation (simulation_1
,simulation_2
,simulation_3
).- Within each simulation folder, there are
animals
,plants
, andsplit_photo
folders containing respective photos. - A
for_reference.xlsx
file in each simulation folder, detailing data about the ecosystem squares.
The application requires several Python packages, listed in requirements.txt
. Key dependencies include Streamlit, Pandas, Pillow, and various Streamlit plugins for enhanced functionality.
Contributions to this project are welcome. Please follow these steps:
- Fork the repository.
- Create a new branch (
git checkout -b feature-branch
). - Make your changes and commit them (
git commit -am 'Add some feature'
). - Push to the branch (
git push origin feature-branch
). - Create a new Pull Request.
This project is licensed under the Apache License. For more information, see the LICENSE file in the repository.