Skip to content

README.md

Latest commit

 

History

History
127 lines (89 loc) · 2.91 KB

README.md

File metadata and controls

127 lines (89 loc) · 2.91 KB
Raw

🎓 NumPy Projects Collection

Welcome to the NumPy Projects Collection repository!

This repository contains several educational projects built after learning the NumPy library. These mini-projects apply various NumPy concepts such as random generation, basic statistics, array manipulation, and simple image processing.

📁 Project Overview

🎲 1. Dice Simulation

  • Purpose: Simulate rolling a six-sided die 1000 times and analyze the results.
  • Features:
    • Counts of each number rolled (1 through 6)
    • Percentage calculation for each outcome
    • Identifies the most and least frequently rolled numbers
  • Libraries: NumPy

📊 2. Statistical Calculator

  • Purpose: A command-line tool to compute common statistical metrics.
  • Available Calculations:
    • Mean
    • Median
    • Mode
    • Standard Deviation
    • Variance
    • Maximum and Minimum values
  • How It Works: The user inputs numbers via the terminal and selects the desired operation.
  • Libraries: NumPy

🧑‍🎓 3. Student Grade Analysis

  • Purpose: Collect and analyze grades of students across multiple subjects.
  • Features:
    • Input multiple students and class names
    • Calculate average grade per student
    • Identify the best-performing student
    • Determine the hardest and easiest subject based on average scores
  • Libraries: NumPy

🖼️ 4. Image Processor

  • Purpose: Perform basic operations on a grayscale image using NumPy.
  • Image Manipulations:
    • Invert image colors
    • Brighten image
    • Darken image
    • Resize image
    • Crop image (zero out part of it)
  • Display: All modified images are visualized using matplotlib.
  • Libraries: NumPy, Matplotlib

🛠️ Requirements

Make sure you have the following Python libraries installed:

pip install numpy matplotlib

🚀 Getting Started

  1. Clone this repository:

    git clone https://github.com/engHasan1/NumPy-Projects.git
cd NumPy-Projects

  2. Run any project:

    python project_filename.py

    Example:

    python DiceSimulation.py

🎯 Purpose of These Projects

These projects are part of my learning journey in data science and artificial intelligence. They helped me:

  • Apply NumPy concepts in practical scenarios.
  • Understand statistical operations in-depth.
  • Explore image array manipulation using NumPy.
  • Strengthen my Python programming skills.

🚧 Next Steps

I'm planning to continue learning:

  • Pandas and Matplotlib
  • Data Analysis Techniques
  • Machine Learning Fundamentals

👤 Author

Hasan Elreceb
Computer Engineering Student & AI/DS Enthusiast

📬 Contact

📄 License

This repository is open-source and free for educational use.