Skip to content

USAGE.md

Latest commit

 

History

History
374 lines (265 loc) · 12.3 KB

USAGE.md

File metadata and controls

374 lines (265 loc) · 12.3 KB

راهنمای استفاده

این راهنما مثال‌ها و جریان‌های کاری رایج برای استفاده از برنامه درسی «علم داده برای مبتدیان» را ارائه می‌دهد.

فهرست مطالب

چگونه از این برنامه درسی استفاده کنیم

این برنامه درسی به گونه‌ای طراحی شده است که انعطاف‌پذیر باشد و می‌توان از آن به روش‌های مختلف استفاده کرد:

  • یادگیری خودمحور: درس‌ها را به صورت مستقل و با سرعت خودتان پیش ببرید
  • آموزش در کلاس درس: استفاده به عنوان یک دوره ساختاریافته با آموزش هدایت‌شده
  • گروه‌های مطالعه: یادگیری به صورت گروهی با همتایان
  • فرمت کارگاه: جلسات یادگیری کوتاه‌مدت و فشرده

کار با درس‌ها

هر درس دارای ساختاری ثابت است تا یادگیری را به حداکثر برساند:

ساختار درس

  1. آزمون پیش از درس: دانش موجود خود را آزمایش کنید
  2. Sketchnote (اختیاری): خلاصه تصویری از مفاهیم کلیدی
  3. ویدیو (اختیاری): محتوای ویدیویی مکمل
  4. درس نوشتاری: مفاهیم اصلی و توضیحات
  5. دفترچه Jupyter: تمرین‌های کدنویسی عملی
  6. تکلیف: تمرین آنچه آموخته‌اید
  7. آزمون پس از درس: درک خود را تقویت کنید

جریان کاری نمونه برای یک درس

# 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

# 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" را انتخاب کنید

مثال: کار با داده‌ها در یک دفترچه

# 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 ذخیره می‌شود

استفاده از برنامه آزمون

اجرای برنامه آزمون به صورت محلی

# 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: مسیر مبتدی کامل

# 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: یادگیری موضوعی

اگر به یک موضوع خاص علاقه‌مند هستید:

# 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: یادگیری مبتنی بر پروژه

# 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: علم داده مبتنی بر ابر

# 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

نکات برای یادگیرندگان مستقل

سازماندهی بمانید

# 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 بپیوندید
  • در کانال #Data-Science-for-Beginners در Discord شرکت کنید بحث‌های Discord
  • پیشرفت خود را به اشتراک بگذارید و سوالات خود را مطرح کنید

پروژه‌های خود را بسازید

پس از تکمیل درس‌ها، مفاهیم را در پروژه‌های شخصی اعمال کنید:

# 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 را برای راهنمایی دقیق مرور کنید
  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 برای دسترسی آفلاین

# Serve documentation locally for classroom use
docsify serve

# Students can access at localhost:3000
# No internet required after initial setup

ارزیابی تکالیف

  • دفترچه‌های دانش‌آموزان را برای تمرین‌های کامل شده مرور کنید
  • درک را از طریق نمرات آزمون بررسی کنید
  • پروژه‌های نهایی را با استفاده از اصول چرخه عمر علم داده ارزیابی کنید

ایجاد تکالیف

# 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
"""

کار به صورت آفلاین

دانلود منابع

# 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

اجرای مستندات به صورت محلی

# Serve with Docsify
docsify serve

# Access at localhost:3000

اجرای برنامه آزمون به صورت محلی

cd quiz-app
npm run serve

دسترسی به محتوای ترجمه شده

ترجمه‌ها در بیش از 40 زبان موجود هستند:

# Access translated lessons
cd translations/fr  # French
cd translations/es  # Spanish
cd translations/de  # German
# ... and many more

هر ترجمه همان ساختار نسخه انگلیسی را حفظ می‌کند.

منابع اضافی

ادامه یادگیری

برنامه‌های درسی مرتبط

دریافت کمک

سلب مسئولیت:
این سند با استفاده از سرویس ترجمه هوش مصنوعی Co-op Translator ترجمه شده است. در حالی که ما تلاش می‌کنیم دقت را حفظ کنیم، لطفاً توجه داشته باشید که ترجمه‌های خودکار ممکن است شامل خطاها یا نادرستی‌ها باشند. سند اصلی به زبان اصلی آن باید به عنوان منبع معتبر در نظر گرفته شود. برای اطلاعات حساس، توصیه می‌شود از ترجمه انسانی حرفه‌ای استفاده کنید. ما مسئولیتی در قبال سوء تفاهم‌ها یا تفسیرهای نادرست ناشی از استفاده از این ترجمه نداریم.