You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Data-Science-For-Beginners/examples/README.md

136 lines
4.4 KiB

# Beginner-Friendly Data Science Examples
Welcome to the examples directory! This collection of simple, well-commented examples is designed to help you get started with data science, even if you're a complete beginner.
## 📚 What You'll Find Here
Each example is self-contained and includes:
- **Clear comments** explaining every step
- **Simple, readable code** that demonstrates one concept at a time
- **Real-world context** to help you understand when and why to use these techniques
- **Expected output** so you know what to look for
## 🚀 Getting Started
### Prerequisites
Before running these examples, make sure you have:
- Python 3.7 or higher installed
- Basic understanding of how to run Python scripts
### Installing Required Libraries
```bash
pip install pandas numpy matplotlib
```
## 📖 Examples Overview
### 1. Hello World - Data Science Style
**File:** `01_hello_world_data_science.py`
Your first data science program! Learn how to:
- Load a simple dataset
- Display basic information about your data
- Print your first data science output
Perfect for absolute beginners who want to see their first data science program in action.
---
### 2. Loading and Exploring Data
**File:** `02_loading_data.py`
Learn the fundamentals of working with data:
- Read data from CSV files
- View the first few rows of your dataset
- Get basic statistics about your data
- Understand data types
This is often the first step in any data science project!
---
### 3. Simple Data Analysis
**File:** `03_simple_analysis.py`
Perform your first data analysis:
- Calculate basic statistics (mean, median, mode)
- Find maximum and minimum values
- Count occurrences of values
- Filter data based on conditions
See how to answer simple questions about your data.
---
### 4. Data Visualization Basics
**File:** `04_basic_visualization.py`
Create your first visualizations:
- Make a simple bar chart
- Create a line plot
- Generate a pie chart
- Save your visualizations as images
Learn to communicate your findings visually!
---
### 5. Working with Real Data
**File:** `05_real_world_example.py`
Put it all together with a complete example:
- Load real data from the repository
- Clean and prepare the data
- Perform analysis
- Create meaningful visualizations
- Draw conclusions
This example shows you a complete workflow from start to finish.
---
## 🎯 How to Use These Examples
1. **Start from the beginning**: The examples are numbered in order of difficulty. Begin with `01_hello_world_data_science.py` and work your way through.
2. **Read the comments**: Each file has detailed comments explaining what the code does and why. Read them carefully!
3. **Experiment**: Try modifying the code. What happens if you change a value? Break things and fix them - that's how you learn!
4. **Run the code**: Execute each example and observe the output. Compare it with what you expected.
5. **Build on it**: Once you understand an example, try extending it with your own ideas.
## 💡 Tips for Beginners
- **Don't rush**: Take time to understand each example before moving to the next one
- **Type the code yourself**: Don't just copy-paste. Typing helps you learn and remember
- **Look up unfamiliar concepts**: If you see something you don't understand, search for it online or in the main lessons
- **Ask questions**: Join the [discussion forum](https://github.com/microsoft/Data-Science-For-Beginners/discussions) if you need help
- **Practice regularly**: Try to code a little bit every day rather than long sessions once a week
## 🔗 Next Steps
After completing these examples, you're ready to:
- Work through the main curriculum lessons
- Try the assignments in each lesson folder
- Explore the Jupyter notebooks for more in-depth learning
- Create your own data science projects
## 📚 Additional Resources
- [Main Curriculum](../README.md) - The complete 20-lesson course
- [For Teachers](../for-teachers.md) - Using this curriculum in your classroom
- [Microsoft Learn](https://docs.microsoft.com/learn/) - Free online learning resources
- [Python Documentation](https://docs.python.org/3/) - Official Python reference
## 🤝 Contributing
Found a bug or have an idea for a new example? We welcome contributions! Please see our [Contributing Guide](../CONTRIBUTING.md).
---
**Happy Learning! 🎉**
Remember: Every expert was once a beginner. Take it one step at a time, and don't be afraid to make mistakes - they're part of the learning process!