Skip to content

Commit 8d2b1af

Browse files
Merge pull request #2 from Bempong-Sylvester-Obese/viabilitycheckerprofile
Viabilitycheckerprofile
2 parents 61acc43 + b69e8d2 commit 8d2b1af

File tree

4 files changed

+152
-95
lines changed

4 files changed

+152
-95
lines changed

.gitignore

+32-33
Original file line numberDiff line numberDiff line change
@@ -1,37 +1,36 @@
1-
# Compiled source #
2-
###################
3-
*.com
4-
*.class
5-
*.dll
6-
*.exe
7-
*.o
8-
*.so
9-
10-
# Packages #
11-
############
12-
# it's better to unpack these files and commit the raw source
13-
# git has its own built in compression methods
14-
*.7z
15-
*.dmg
16-
*.gz
17-
*.iso
18-
*.jar
19-
*.rar
20-
*.tar
21-
*.zip
22-
23-
# Logs and databases #
24-
######################
1+
# Ignore Python bytecode files
2+
__pycache__/
3+
*.py[cod]
4+
5+
# Ignore environment files
6+
venv/
7+
env/
8+
*.env
9+
10+
# Ignore log files
2511
*.log
26-
*.sql
27-
*.sqlite
12+
logs/
13+
14+
# Ignore data files
15+
*.csv
16+
*.json
17+
*.xlsx
18+
19+
# Ignore IDE/editor settings
20+
.vscode/
21+
.idea/
22+
*.swp
2823

29-
# OS generated files #
30-
######################
24+
# Ignore compiled machine learning models
25+
models/
26+
*.h5
27+
*.pkl
28+
29+
# Ignore dependencies
30+
*.egg-info/
31+
*.dist-info/
32+
33+
# Ignore OS-generated files
3134
.DS_Store
32-
.DS_Store?
33-
._*
34-
.Spotlight-V100
35-
.Trashes
36-
ehthumbs.db
3735
Thumbs.db
36+

LICENSE

+24-4
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,27 @@
1-
Copyright (c) GitHub, Inc.
1+
Obese Land Viability License (Based on MIT License)
22

3-
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
3+
Copyright (c) 2025 Bempong Sylvester Obese
4+
5+
Permission is hereby granted, free of charge, to any person obtaining a copy
6+
of this software and associated documentation files (the Obese Land Viability Checker), to deal
7+
in the Software restriction, including without limitation the rights
8+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9+
copies of the Software, and to permit persons to whom the Software is
10+
furnished to do so, subject to the following conditions:
11+
12+
1. The above copyright notice and this permission notice shall be included in all
13+
copies or substantial portions of the Software.
14+
2. This software is intended for **agricultural and environmental applications**. Any use
15+
for unethical, exploitative, or harmful purposes is strictly prohibited.
16+
3. Proper attribution to the original author Bempong Sylvester Obese is required in any modified
17+
or redistributed versions of this software.
18+
19+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
20+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
21+
FITNESS FOR A PARTICULAR PURPOSE, AND NONINFRINGEMENT. IN NO EVENT SHALL THE
22+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES, OR OTHER
23+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
24+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
25+
SOFTWARE.
426

5-
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
627

7-
THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

PROFILE.md

+55-1
Original file line numberDiff line numberDiff line change
@@ -1 +1,55 @@
1-
Welcome to my First Githyb Project
1+
### Obese Farms Viability Checker 🌱
2+
3+
🚜 **A Smart Tool for Evaluating Land Viability**
4+
Obese Farms Viability Checker is a Python-based tool designed to assess the suitability of land for farming. It leverages data analysis, machine learning, and environmental parameters to provide insights into land productivity.
5+
6+
---
7+
8+
### 🌟 Features:
9+
- **Soil Analysis**: Evaluates soil quality based on key agricultural parameters.
10+
- **Climate Suitability**: Analyzes weather conditions to determine optimal crop growth.
11+
- **Water Availability**: Assesses proximity to water sources and irrigation feasibility.
12+
- **Machine Learning Predictions**: Uses AI to predict crop yield based on historical data.
13+
14+
---
15+
16+
### 🔧 Tech Stack:
17+
- **Languages**: Python
18+
- **Libraries**: Pandas, NumPy, Scikit-learn, TensorFlow
19+
- **Data Sources**: OpenWeather API, Satellite Data
20+
21+
---
22+
23+
### 🚀 Roadmap:
24+
- [ ] Implement an interactive UI for ease of use
25+
- [ ] Expand dataset for higher accuracy
26+
- [ ] Integrate mobile app support
27+
28+
---
29+
30+
### 📌 How to Use:
31+
1. Clone the repository:
32+
```sh
33+
git clone https://github.com/your-username/obese-viability-checker.git
34+
```
35+
2. Install dependencies:
36+
```sh
37+
pip install -r requirements.txt
38+
```
39+
3. Run the script:
40+
```sh
41+
python main.py
42+
```
43+
44+
---
45+
46+
### 🤝 Contributing:
47+
Contributions are welcome! Feel free to fork this repository and submit a pull request with improvements.
48+
49+
---
50+
51+
### 📫 Contact:
52+
For inquiries, reach out via [email protected] or open an issue on GitHub.
53+
54+
💡 *"Empowering farmers with data-driven insights."* 🚜
55+

README.md

+41-57
Original file line numberDiff line numberDiff line change
@@ -1,73 +1,57 @@
1-
<header>
1+
# Obese Land Viability Checker 🌾
22

3-
<!--
4-
<<< Author notes: Course header >>>
5-
Include a 1280×640 image, course title in sentence case, and a concise description in emphasis.
6-
In your repository settings: enable template repository, add your 1280×640 social image, auto delete head branches.
7-
Add your open source license, GitHub uses MIT license.
8-
-->
3+
## 📌 Overview
4+
The **Obese Land Viability Checker** is an AI-powered tool designed to assess land suitability for agricultural use. By analyzing soil quality, climate conditions, and water availability, it provides valuable insights to help farmers and agribusinesses make informed decisions.
95

10-
# Introduction to GitHub
6+
## 🚀 Features
7+
- **Soil Quality Analysis**: Evaluates key soil nutrients and fertility levels.
8+
- **Climate Suitability**: Assesses temperature, rainfall, and humidity for optimal crop growth.
9+
- **Water Resource Mapping**: Identifies proximity to irrigation sources and water bodies.
10+
- **Machine Learning Predictions**: Uses AI to predict crop yields based on historical data.
11+
- **User-Friendly Interface**: Simple and intuitive for seamless use.
1112

12-
_Get started using GitHub in less than an hour._
13-
14-
</header>
15-
16-
<!--
17-
<<< Author notes: Step 2 >>>
18-
Start this step by acknowledging the previous step.
19-
Define terms and link to docs.github.com.
20-
-->
21-
22-
## Step 2: Commit a file
23-
24-
_You created a branch! :tada:_
25-
26-
Creating a branch allows you to edit your project without changing the `main` branch. Now that you have a branch, it’s time to create a file and make your first commit!
27-
28-
**What is a commit?**: A _[commit](https://docs.github.com/pull-requests/committing-changes-to-your-project/creating-and-editing-commits/about-commits)_ is a set of changes to the files and folders in your project. A commit exists in a branch. For more information, see "[About commits](https://docs.github.com/en/pull-requests/committing-changes-to-your-project/creating-and-editing-commits/about-commits)".
29-
30-
### :keyboard: Activity: Your first commit
31-
32-
The following steps will guide you through the process of committing a change on GitHub. A commit records changes in renaming, changing content within, creating a new file, and any other changes made to your project. For this exercise, committing a change requires first adding a new file to your new branch.
33-
34-
> [!NOTE]
35-
> `.md` is a file extension that creates a Markdown file. You can learn more about Markdown by visiting "[Basic writing and formatting syntax](https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax)" in our docs or by taking the "[Communicating using Markdown](https://github.com/skills/communicate-using-markdown)" Skills course.
36-
37-
1. On the **< > Code** tab in the header menu of your repository, make sure you're on your new branch `my-first-branch`.
38-
39-
2. Select the **Add file** drop-down and click **Create new file**.
40-
41-
![create new file option](/images/create-new-file.png)
13+
---
4214

43-
3. In the **Name your file...** field, enter `PROFILE.md`.
15+
## 🛠️ Technologies Used
16+
- **Programming Language**: Python 🐍
17+
- **Libraries**: Pandas, NumPy, Scikit-learn, TensorFlow
18+
- **Data Sources**: OpenWeather API, Satellite Imagery, Soil Databases
4419

45-
4. In the **Enter file contents here** area, copy the following content to your file:
20+
---
4621

22+
## 📖 Installation & Usage
23+
1. Clone the repository:
24+
```sh
25+
git clone https://github.com/your-username/obese-land-viability-checker.git
4726
```
48-
Welcome to my GitHub profile!
27+
2. Navigate to the project folder:
28+
```sh
29+
cd obese-land-viability-checker
30+
```
31+
3. Install dependencies:
32+
```sh
33+
pip install -r requirements.txt
34+
```
35+
4. Run the script:
36+
```sh
37+
python main.py
4938
```
5039

51-
![profile.md file screenshot](/images/my-profile-file.png)
52-
53-
5. Click **Commit changes...** in the upper right corner above the contents box. For commits, you can enter a short commit message that describes what changes you made. This message helps others know what's included in your commit. GitHub offers a simple default message, but let's change it slightly for practice. First, enter `Add PROFILE.md` in the first text-entry field titled "Commit message".
54-
55-
![screenshot of adding a new file with a commit message](/images/commit-full-screen.png)
56-
57-
6. In this lesson, we'll ignore the other fields and click **Commit changes**.
58-
7. Wait about 20 seconds then refresh this page (the one you're following instructions from). [GitHub Actions](https://docs.github.com/en/actions) will automatically update to the next step.
40+
---
5941

60-
<footer>
42+
## 🔮 Future Enhancements
43+
- [ ] Develop a web-based dashboard for visualization.
44+
- [ ] Mobile app integration for on-the-go analysis.
45+
- [ ] Expand dataset for increased accuracy.
6146

62-
<!--
63-
<<< Author notes: Footer >>>
64-
Add a link to get support, GitHub status page, code of conduct, license link.
65-
-->
47+
## 🤝 Contributing
48+
Contributions are welcome! Feel free to fork the repository and submit a pull request.
6649

6750
---
6851

69-
Get help: [Post in our discussion board](https://github.com/orgs/skills/discussions/categories/introduction-to-github) &bull; [Review the GitHub status page](https://www.githubstatus.com/)
52+
## 📫 Contact
53+
For inquiries, reach out via [[email protected] or open an issue on GitHub.
54+
Mobile: +233(0) 540456262
7055

71-
&copy; 2024 GitHub &bull; [Code of Conduct](https://www.contributor-covenant.org/version/2/1/code_of_conduct/code_of_conduct.md) &bull; [MIT License](https://gh.io/mit)
56+
💡 *"Empowering farmers with AI-driven insights for smarter agriculture."* 🌱
7257

73-
</footer>

0 commit comments

Comments
 (0)