Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Updated the Prerequisites Section, Environment Setup Instructions, database and contribute steps #53

Open
wants to merge 1 commit into
base: main
Choose a base branch
from
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
87 changes: 76 additions & 11 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -75,44 +75,71 @@

## 📊 Dataset

The project utilizes a synthetic dataset representing various celestial bodies and their potential mining sites. Key features include:
The project utilizes a synthetic dataset representing various celestial bodies and their potential mining sites. It is synthetic and simulates real-world space mining scenarios. Here's a breakdown of the dataset structure:

| Column | Description |
|--------------------|--------------------------------------------------|
| Celestial Body | Name of the celestial object (e.g., Moon, Mars) |
| Mineral Composition | Percentage of minerals such as Iron, Nickel, etc.|
| Estimated Value | Economic value of the mining site (in billions) |
| Sustainability Index| Measures the sustainability of mining operations|
| Efficiency Index | Overall mining efficiency at the site |
| Distance from Earth | Distance of the celestial body from Earth (in km)|

- Celestial Body
- Mineral Composition (Iron %, Nickel %, Water/Ice %)
- Estimated Value (Billions USD)
- Sustainability Index
- Efficiency Index
- Distance from Earth (Million km)

## 💻 Installation & Usage

Prerequisites
- Python 3.x
- Streamlit installed

Setup
1. Clone the repository:

```bash
git clone https://github.com/Devanik21/ISRO_Mining_Site_FINAL_APP.git
```

2. Set up a virtual environment :

```bash
python3 -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
```

3. Activate the Virtual Environment :

On Windows:
```bash
.\env\Scripts\activate
```

2. Install dependencies:
On Mac/Linux:
```bash
source env/bin/activate
```

4. Install dependencies:

```bash
pip install -r requirements.txt
```

3. Run the Streamlit app:
5. Run the Streamlit app:

```bash
streamlit run app.py
```

4. Navigate through the sidebar to explore different models and features:
6. Navigate through the sidebar to explore different models and features:

- Prediction
- Recommendation
- Analysis
- Visualization
- Insights

5. Interact with the application by adjusting parameters and exploring the outputs to inform your space mining decisions.
7. Interact with the application by adjusting parameters and exploring the outputs to inform your space mining decisions.

## 📚 Project Documentation

Expand All @@ -123,6 +150,44 @@ The project utilizes a synthetic dataset representing various celestial bodies a
| [LICENSE](LICENSE) | Full text of the MIT License |
| [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md) | Code of Conduct for contributors |


## 🤝 How to Contribute

We welcome contributions from the community! Here's how you can get involved:

1. Fork the Repository: Click on the "Fork" button at the top of this page to copy the repository to your account.

2. Clone the Repository: Use the following command to clone the repository to your local machine:

```bash
git clone https://github.com/your-username/ISRO_Mining_Site_FINAL_APP.git
```

3. Create a Branch:

```bash
git checkout -b feature-name
```

4. Make Changes: Implement your changes to the code or documentation.

5. Commit Changes:

```bash
git add .
git commit -m "Description of changes"
```

6. Push the Changes:

```bash
git push origin feature-name
```

7. Create a Pull Request: Go to the original repository on GitHub and create a pull request, explaining your changes.



## 📄 License & Contributing

| [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE) | [![Contributor Covenant](https://img.shields.io/badge/Contributor%20Covenant-2.1-4baaaa.svg)](CODE_OF_CONDUCT.md) |
Expand Down
Loading