|
|
# راهنمای استفاده
|
|
|
|
|
|
این راهنما مثالها و جریانهای کاری رایج برای استفاده از برنامه درسی «علم داده برای مبتدیان» را ارائه میدهد.
|
|
|
|
|
|
## فهرست مطالب
|
|
|
|
|
|
- [چگونه از این برنامه درسی استفاده کنیم](../..)
|
|
|
- [کار با درسها](../..)
|
|
|
- [کار با دفترچههای Jupyter](../..)
|
|
|
- [استفاده از برنامه آزمون](../..)
|
|
|
- [جریانهای کاری رایج](../..)
|
|
|
- [نکات برای یادگیرندگان مستقل](../..)
|
|
|
- [نکات برای معلمان](../..)
|
|
|
|
|
|
## چگونه از این برنامه درسی استفاده کنیم
|
|
|
|
|
|
این برنامه درسی به گونهای طراحی شده است که انعطافپذیر باشد و میتوان از آن به روشهای مختلف استفاده کرد:
|
|
|
|
|
|
- **یادگیری خودمحور**: درسها را به صورت مستقل و با سرعت خودتان پیش ببرید
|
|
|
- **آموزش در کلاس درس**: استفاده به عنوان یک دوره ساختاریافته با آموزش هدایتشده
|
|
|
- **گروههای مطالعه**: یادگیری به صورت گروهی با همتایان
|
|
|
- **فرمت کارگاه**: جلسات یادگیری کوتاهمدت و فشرده
|
|
|
|
|
|
## کار با درسها
|
|
|
|
|
|
هر درس دارای ساختاری ثابت است تا یادگیری را به حداکثر برساند:
|
|
|
|
|
|
### ساختار درس
|
|
|
|
|
|
1. **آزمون پیش از درس**: دانش موجود خود را آزمایش کنید
|
|
|
2. **Sketchnote** (اختیاری): خلاصه تصویری از مفاهیم کلیدی
|
|
|
3. **ویدیو** (اختیاری): محتوای ویدیویی مکمل
|
|
|
4. **درس نوشتاری**: مفاهیم اصلی و توضیحات
|
|
|
5. **دفترچه Jupyter**: تمرینهای کدنویسی عملی
|
|
|
6. **تکلیف**: تمرین آنچه آموختهاید
|
|
|
7. **آزمون پس از درس**: درک خود را تقویت کنید
|
|
|
|
|
|
### جریان کاری نمونه برای یک درس
|
|
|
|
|
|
```bash
|
|
|
# 1. Navigate to the lesson directory
|
|
|
cd 1-Introduction/01-defining-data-science
|
|
|
|
|
|
# 2. Read the README.md
|
|
|
# Open README.md in your browser or editor
|
|
|
|
|
|
# 3. Take the pre-lesson quiz
|
|
|
# Click the quiz link in the README
|
|
|
|
|
|
# 4. Open the Jupyter notebook (if available)
|
|
|
jupyter notebook
|
|
|
|
|
|
# 5. Complete the exercises in the notebook
|
|
|
|
|
|
# 6. Work on the assignment
|
|
|
|
|
|
# 7. Take the post-lesson quiz
|
|
|
```
|
|
|
|
|
|
## کار با دفترچههای Jupyter
|
|
|
|
|
|
### شروع Jupyter
|
|
|
|
|
|
```bash
|
|
|
# Activate your virtual environment
|
|
|
source venv/bin/activate # On macOS/Linux
|
|
|
# OR
|
|
|
venv\Scripts\activate # On Windows
|
|
|
|
|
|
# Start Jupyter from the repository root
|
|
|
jupyter notebook
|
|
|
```
|
|
|
|
|
|
### اجرای سلولهای دفترچه
|
|
|
|
|
|
1. **اجرای یک سلول**: کلیدهای `Shift + Enter` را فشار دهید یا روی دکمه "Run" کلیک کنید
|
|
|
2. **اجرای همه سلولها**: از منو گزینه "Cell" → "Run All" را انتخاب کنید
|
|
|
3. **راهاندازی مجدد کرنل**: اگر با مشکلی مواجه شدید، گزینه "Kernel" → "Restart" را انتخاب کنید
|
|
|
|
|
|
### مثال: کار با دادهها در یک دفترچه
|
|
|
|
|
|
```python
|
|
|
# Import required libraries
|
|
|
import pandas as pd
|
|
|
import numpy as np
|
|
|
import matplotlib.pyplot as plt
|
|
|
|
|
|
# Load a dataset
|
|
|
df = pd.read_csv('data/sample.csv')
|
|
|
|
|
|
# Explore the data
|
|
|
df.head()
|
|
|
df.info()
|
|
|
df.describe()
|
|
|
|
|
|
# Create a visualization
|
|
|
plt.figure(figsize=(10, 6))
|
|
|
plt.plot(df['column_name'])
|
|
|
plt.title('Sample Visualization')
|
|
|
plt.xlabel('X-axis Label')
|
|
|
plt.ylabel('Y-axis Label')
|
|
|
plt.show()
|
|
|
```
|
|
|
|
|
|
### ذخیره کار شما
|
|
|
|
|
|
- Jupyter به صورت دورهای به طور خودکار ذخیره میکند
|
|
|
- ذخیره دستی: کلیدهای `Ctrl + S` (یا `Cmd + S` در macOS) را فشار دهید
|
|
|
- پیشرفت شما در فایل `.ipynb` ذخیره میشود
|
|
|
|
|
|
## استفاده از برنامه آزمون
|
|
|
|
|
|
### اجرای برنامه آزمون به صورت محلی
|
|
|
|
|
|
```bash
|
|
|
# Navigate to quiz app directory
|
|
|
cd quiz-app
|
|
|
|
|
|
# Start the development server
|
|
|
npm run serve
|
|
|
|
|
|
# Access at http://localhost:8080
|
|
|
```
|
|
|
|
|
|
### انجام آزمونها
|
|
|
|
|
|
1. آزمونهای پیش از درس در بالای هر درس لینک شدهاند
|
|
|
2. آزمونهای پس از درس در پایین هر درس لینک شدهاند
|
|
|
3. هر آزمون شامل 3 سؤال است
|
|
|
4. آزمونها برای تقویت یادگیری طراحی شدهاند، نه برای ارزیابی جامع
|
|
|
|
|
|
### شمارهگذاری آزمونها
|
|
|
|
|
|
- آزمونها از 0 تا 39 شمارهگذاری شدهاند (در مجموع 40 آزمون)
|
|
|
- هر درس معمولاً یک آزمون پیش و پس دارد
|
|
|
- URLهای آزمون شامل شماره آزمون هستند: `https://ff-quizzes.netlify.app/en/ds/quiz/0`
|
|
|
|
|
|
## جریانهای کاری رایج
|
|
|
|
|
|
### جریان کاری 1: مسیر مبتدی کامل
|
|
|
|
|
|
```bash
|
|
|
# 1. Set up your environment (see INSTALLATION.md)
|
|
|
|
|
|
# 2. Start with Lesson 1
|
|
|
cd 1-Introduction/01-defining-data-science
|
|
|
|
|
|
# 3. For each lesson:
|
|
|
# - Take pre-lesson quiz
|
|
|
# - Read the lesson content
|
|
|
# - Work through the notebook
|
|
|
# - Complete the assignment
|
|
|
# - Take post-lesson quiz
|
|
|
|
|
|
# 4. Progress through all 20 lessons sequentially
|
|
|
```
|
|
|
|
|
|
### جریان کاری 2: یادگیری موضوعی
|
|
|
|
|
|
اگر به یک موضوع خاص علاقهمند هستید:
|
|
|
|
|
|
```bash
|
|
|
# Example: Focus on Data Visualization
|
|
|
cd 3-Data-Visualization
|
|
|
|
|
|
# Explore lessons 9-13:
|
|
|
# - Lesson 9: Visualizing Quantities
|
|
|
# - Lesson 10: Visualizing Distributions
|
|
|
# - Lesson 11: Visualizing Proportions
|
|
|
# - Lesson 12: Visualizing Relationships
|
|
|
# - Lesson 13: Meaningful Visualizations
|
|
|
```
|
|
|
|
|
|
### جریان کاری 3: یادگیری مبتنی بر پروژه
|
|
|
|
|
|
```bash
|
|
|
# 1. Review the Data Science Lifecycle lessons (14-16)
|
|
|
cd 4-Data-Science-Lifecycle
|
|
|
|
|
|
# 2. Work through a real-world example (Lesson 20)
|
|
|
cd ../6-Data-Science-In-Wild/20-Real-World-Examples
|
|
|
|
|
|
# 3. Apply concepts to your own project
|
|
|
```
|
|
|
|
|
|
### جریان کاری 4: علم داده مبتنی بر ابر
|
|
|
|
|
|
```bash
|
|
|
# Learn about cloud data science (Lessons 17-19)
|
|
|
cd 5-Data-Science-In-Cloud
|
|
|
|
|
|
# 17: Introduction to Cloud Data Science
|
|
|
# 18: Low-Code ML Tools
|
|
|
# 19: Azure Machine Learning Studio
|
|
|
```
|
|
|
|
|
|
## نکات برای یادگیرندگان مستقل
|
|
|
|
|
|
### سازماندهی بمانید
|
|
|
|
|
|
```bash
|
|
|
# Create a learning journal
|
|
|
mkdir my-learning-journal
|
|
|
|
|
|
# For each lesson, create notes
|
|
|
echo "# Lesson 1 Notes" > my-learning-journal/lesson-01-notes.md
|
|
|
```
|
|
|
|
|
|
### تمرین منظم
|
|
|
|
|
|
- هر روز یا هفته زمان مشخصی را اختصاص دهید
|
|
|
- حداقل یک درس در هفته را کامل کنید
|
|
|
- درسهای قبلی را به صورت دورهای مرور کنید
|
|
|
|
|
|
### تعامل با جامعه
|
|
|
|
|
|
- به [جامعه Discord](https://aka.ms/ds4beginners/discord) بپیوندید
|
|
|
- در کانال #Data-Science-for-Beginners در Discord شرکت کنید [بحثهای Discord](https://aka.ms/ds4beginners/discord)
|
|
|
- پیشرفت خود را به اشتراک بگذارید و سوالات خود را مطرح کنید
|
|
|
|
|
|
### پروژههای خود را بسازید
|
|
|
|
|
|
پس از تکمیل درسها، مفاهیم را در پروژههای شخصی اعمال کنید:
|
|
|
|
|
|
```python
|
|
|
# Example: Analyze your own dataset
|
|
|
import pandas as pd
|
|
|
|
|
|
# Load your own data
|
|
|
my_data = pd.read_csv('my-project/data.csv')
|
|
|
|
|
|
# Apply techniques learned
|
|
|
# - Data cleaning (Lesson 8)
|
|
|
# - Exploratory data analysis (Lesson 7)
|
|
|
# - Visualization (Lessons 9-13)
|
|
|
# - Analysis (Lesson 15)
|
|
|
```
|
|
|
|
|
|
## نکات برای معلمان
|
|
|
|
|
|
### تنظیم کلاس درس
|
|
|
|
|
|
1. [for-teachers.md](for-teachers.md) را برای راهنمایی دقیق مرور کنید
|
|
|
2. یک محیط مشترک (GitHub Classroom یا Codespaces) راهاندازی کنید
|
|
|
3. یک کانال ارتباطی (Discord، Slack یا Teams) ایجاد کنید
|
|
|
|
|
|
### برنامهریزی درسها
|
|
|
|
|
|
**برنامه پیشنهادی 10 هفتهای:**
|
|
|
|
|
|
- **هفته 1-2**: مقدمه (درسهای 1-4)
|
|
|
- **هفته 3-4**: کار با دادهها (درسهای 5-8)
|
|
|
- **هفته 5-6**: مصورسازی دادهها (درسهای 9-13)
|
|
|
- **هفته 7-8**: چرخه عمر علم داده (درسهای 14-16)
|
|
|
- **هفته 9**: علم داده ابری (درسهای 17-19)
|
|
|
- **هفته 10**: کاربردهای واقعی و پروژههای نهایی (درس 20)
|
|
|
|
|
|
### اجرای Docsify برای دسترسی آفلاین
|
|
|
|
|
|
```bash
|
|
|
# Serve documentation locally for classroom use
|
|
|
docsify serve
|
|
|
|
|
|
# Students can access at localhost:3000
|
|
|
# No internet required after initial setup
|
|
|
```
|
|
|
|
|
|
### ارزیابی تکالیف
|
|
|
|
|
|
- دفترچههای دانشآموزان را برای تمرینهای کامل شده مرور کنید
|
|
|
- درک را از طریق نمرات آزمون بررسی کنید
|
|
|
- پروژههای نهایی را با استفاده از اصول چرخه عمر علم داده ارزیابی کنید
|
|
|
|
|
|
### ایجاد تکالیف
|
|
|
|
|
|
```python
|
|
|
# Example custom assignment template
|
|
|
"""
|
|
|
Assignment: [Topic]
|
|
|
|
|
|
Objective: [Learning goal]
|
|
|
|
|
|
Dataset: [Provide or have students find one]
|
|
|
|
|
|
Tasks:
|
|
|
1. Load and explore the dataset
|
|
|
2. Clean and prepare the data
|
|
|
3. Create at least 3 visualizations
|
|
|
4. Perform analysis
|
|
|
5. Communicate findings
|
|
|
|
|
|
Deliverables:
|
|
|
- Jupyter notebook with code and explanations
|
|
|
- Written summary of findings
|
|
|
"""
|
|
|
```
|
|
|
|
|
|
## کار به صورت آفلاین
|
|
|
|
|
|
### دانلود منابع
|
|
|
|
|
|
```bash
|
|
|
# Clone the entire repository
|
|
|
git clone https://github.com/microsoft/Data-Science-For-Beginners.git
|
|
|
|
|
|
# Download datasets in advance
|
|
|
# Most datasets are included in the repository
|
|
|
```
|
|
|
|
|
|
### اجرای مستندات به صورت محلی
|
|
|
|
|
|
```bash
|
|
|
# Serve with Docsify
|
|
|
docsify serve
|
|
|
|
|
|
# Access at localhost:3000
|
|
|
```
|
|
|
|
|
|
### اجرای برنامه آزمون به صورت محلی
|
|
|
|
|
|
```bash
|
|
|
cd quiz-app
|
|
|
npm run serve
|
|
|
```
|
|
|
|
|
|
## دسترسی به محتوای ترجمه شده
|
|
|
|
|
|
ترجمهها در بیش از 40 زبان موجود هستند:
|
|
|
|
|
|
```bash
|
|
|
# Access translated lessons
|
|
|
cd translations/fr # French
|
|
|
cd translations/es # Spanish
|
|
|
cd translations/de # German
|
|
|
# ... and many more
|
|
|
```
|
|
|
|
|
|
هر ترجمه همان ساختار نسخه انگلیسی را حفظ میکند.
|
|
|
|
|
|
## منابع اضافی
|
|
|
|
|
|
### ادامه یادگیری
|
|
|
|
|
|
- [Microsoft Learn](https://docs.microsoft.com/learn/) - مسیرهای یادگیری اضافی
|
|
|
- [Student Hub](https://docs.microsoft.com/learn/student-hub) - منابع برای دانشآموزان
|
|
|
- [Azure AI Foundry](https://aka.ms/foundry/forum) - انجمن جامعه
|
|
|
|
|
|
### برنامههای درسی مرتبط
|
|
|
|
|
|
- [AI برای مبتدیان](https://aka.ms/ai-beginners)
|
|
|
- [ML برای مبتدیان](https://aka.ms/ml-beginners)
|
|
|
- [توسعه وب برای مبتدیان](https://aka.ms/webdev-beginners)
|
|
|
- [هوش مصنوعی مولد برای مبتدیان](https://aka.ms/genai-beginners)
|
|
|
|
|
|
## دریافت کمک
|
|
|
|
|
|
- [TROUBLESHOOTING.md](TROUBLESHOOTING.md) را برای مشکلات رایج بررسی کنید
|
|
|
- [GitHub Issues](https://github.com/microsoft/Data-Science-For-Beginners/issues) را جستجو کنید
|
|
|
- به [Discord](https://aka.ms/ds4beginners/discord) ما بپیوندید
|
|
|
- [CONTRIBUTING.md](CONTRIBUTING.md) را مرور کنید تا مشکلات را گزارش دهید یا مشارکت کنید
|
|
|
|
|
|
---
|
|
|
|
|
|
**سلب مسئولیت**:
|
|
|
این سند با استفاده از سرویس ترجمه هوش مصنوعی [Co-op Translator](https://github.com/Azure/co-op-translator) ترجمه شده است. در حالی که ما تلاش میکنیم دقت را حفظ کنیم، لطفاً توجه داشته باشید که ترجمههای خودکار ممکن است شامل خطاها یا نادرستیها باشند. سند اصلی به زبان اصلی آن باید به عنوان منبع معتبر در نظر گرفته شود. برای اطلاعات حساس، توصیه میشود از ترجمه انسانی حرفهای استفاده کنید. ما مسئولیتی در قبال سوء تفاهمها یا تفسیرهای نادرست ناشی از استفاده از این ترجمه نداریم. |
