Skip to content

TROUBLESHOOTING.md

Latest commit

 

History

History
620 lines (430 loc) · 26.6 KB

TROUBLESHOOTING.md

File metadata and controls

620 lines (430 loc) · 26.6 KB

సమస్య పరిష్కరణ గైడ్

ఈ గైడ్ Data Science for Beginners పాఠ్యాంశంతో పని చేస్తూ మీరు ఎదుర్కొనే సాధారణ సమస్యలకు పరిష్కారాలను అందిస్తుంది.

విషయ సూచిక

Python మరియు Jupyter సమస్యలు

Python కనుగొనబడలేదు లేదా తప్పు వెర్షన్

సమస్య: python: command not found లేదా తప్పు Python వెర్షన్

పరిష్కారం:

# పైథాన్ వెర్షన్‌ను తనిఖీ చేయండి
python --version
python3 --version

# పైథాన్ 3 'python3' గా ఇన్‌స్టాల్ అయితే, అలియాస్ సృష్టించండి
# macOS/Linux లో, ~/.bashrc లేదా ~/.zshrc లో జోడించండి:
alias python=python3
alias pip=pip3

# లేదా python3 ను స్పష్టంగా ఉపయోగించండి
python3 -m pip install jupyter

Windows పరిష్కారం:

  1. python.org నుండి Python ను మళ్లీ ఇన్‌స్టాల్ చేయండి
  2. ఇన్‌స్టాలేషన్ సమయంలో, "Add Python to PATH" ను ఎంచుకోండి
  3. మీ టెర్మినల్/కమాండ్ ప్రాంప్ట్‌ను రీస్టార్ట్ చేయండి

వర్చువల్ ఎన్విరాన్‌మెంట్ యాక్టివేషన్ సమస్యలు

సమస్య: వర్చువల్ ఎన్విరాన్‌మెంట్ యాక్టివేట్ అవ్వడం లేదు

పరిష్కారం:

Windows:

# మీరు ఎగ్జిక్యూషన్ పాలసీ లోపం పొందితే
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

# అప్పుడు యాక్టివేట్ చేయండి
venv\Scripts\activate

macOS/Linux:

# యాక్టివేట్ స్క్రిప్ట్ అమలు చేయదగినదిగా ఉండాలి
chmod +x venv/bin/activate

# ఆపై యాక్టివేట్ చేయండి
source venv/bin/activate

యాక్టివేషన్ నిర్ధారించుకోండి:

# మీ ప్రాంప్ట్ (venv) చూపించాలి
# Python స్థానం తనిఖీ చేయండి
which python  # venv ను సూచించాలి

Jupyter కర్నెల్ సమస్యలు

సమస్య: "Kernel not found" లేదా "Kernel keeps dying"

పరిష్కారం:

# కర్నెల్‌ను మళ్లీ ఇన్‌స్టాల్ చేయండి
python -m ipykernel install --user --name=datascience --display-name="Python (Data Science)"

# లేదా డిఫాల్ట్ కర్నెల్‌ను ఉపయోగించండి
python -m ipykernel install --user

# జూపిటర్‌ను రీస్టార్ట్ చేయండి
jupyter notebook

సమస్య: Jupyterలో తప్పు Python వెర్షన్

పరిష్కారం:

# మీ వర్చువల్ ఎన్విరాన్‌మెంట్‌లో Jupyter ను ఇన్‌స్టాల్ చేయండి
source venv/bin/activate  # ముందుగా యాక్టివేట్ చేయండి
pip install jupyter ipykernel

# కర్నెల్‌ను రిజిస్టర్ చేయండి
python -m ipykernel install --user --name=venv --display-name="Python (venv)"

# Jupyter లో, Kernel -> Change kernel -> Python (venv) ను ఎంచుకోండి

ప్యాకేజ్ మరియు ఆధారిత సమస్యలు

ఇంపోర్ట్ లోపాలు

సమస్య: ModuleNotFoundError: No module named 'pandas' (లేదా ఇతర ప్యాకేజీలు)

పరిష్కారం:

# వర్చువల్ ఎన్విరాన్‌మెంట్ సక్రియమై ఉందో లేదో నిర్ధారించుకోండి
source venv/bin/activate  # macOS/Linux
venv\Scripts\activate     # Windows

# లేని ప్యాకేజీని ఇన్‌స్టాల్ చేయండి
pip install pandas

# అన్ని సాధారణ ప్యాకేజీలను ఇన్‌స్టాల్ చేయండి
pip install jupyter pandas numpy matplotlib seaborn scikit-learn

# ఇన్‌స్టాలేషన్‌ను ధృవీకరించండి
python -c "import pandas; print(pandas.__version__)"

Pip ఇన్‌స్టాలేషన్ విఫలమవడం

సమస్య: pip install అనుమతి లోపాలతో విఫలమవుతుంది

పరిష్కారం:

# --user ఫ్లాగ్ ఉపయోగించండి
pip install --user package-name

# లేదా వర్చువల్ ఎన్విరాన్‌మెంట్ ఉపయోగించండి (సిఫార్సు చేయబడింది)
python -m venv venv
source venv/bin/activate
pip install package-name

సమస్య: pip install SSL సర్టిఫికేట్ లోపాలతో విఫలమవుతుంది

పరిష్కారం:

# ముందుగా పిప్‌ను నవీకరించండి
python -m pip install --upgrade pip

# నమ్మకమైన హోస్ట్‌తో ఇన్‌స్టాల్ చేయడానికి ప్రయత్నించండి (తాత్కాలిక పరిష్కారం)
pip install --trusted-host pypi.org --trusted-host files.pythonhosted.org package-name

ప్యాకేజ్ వెర్షన్ విరుద్ధతలు

సమస్య: అనుకూలం కాని ప్యాకేజ్ వెర్షన్లు

పరిష్కారం:

# కొత్త వర్చువల్ ఎన్విరాన్‌మెంట్ సృష్టించండి
python -m venv venv-new
source venv-new/bin/activate  # లేదా Windows లో venv-new\Scripts\activate

# అవసరమైతే నిర్దిష్ట సంస్కరణలతో ప్యాకేజీలను ఇన్‌స్టాల్ చేయండి
pip install pandas==1.3.0
pip install numpy==1.21.0

# లేదా pip కు ఆధారాలను పరిష్కరించనివ్వండి
pip install jupyter pandas numpy matplotlib seaborn scikit-learn

Jupyter నోట్‌బుక్ సమస్యలు

Jupyter ప్రారంభం కావడం లేదు

సమస్య: jupyter notebook కమాండ్ కనుగొనబడలేదు

పరిష్కారం:

# జూపిటర్‌ను ఇన్‌స్టాల్ చేయండి
pip install jupyter

# లేదా python -m ఉపయోగించండి
python -m jupyter notebook

# అవసరమైతే PATH లో చేర్చండి (macOS/Linux)
export PATH="$HOME/.local/bin:$PATH"

నోట్‌బుక్ లోడ్ లేదా సేవ్ అవ్వడం లేదు

సమస్య: "Notebook failed to load" లేదా సేవ్ లోపాలు

పరిష్కారం:

  1. ఫైల్ అనుమతులను తనిఖీ చేయండి
# మీరు రాయడానికి అనుమతులు ఉన్నాయో నిర్ధారించుకోండి
ls -l notebook.ipynb
chmod 644 notebook.ipynb  # అవసరమైతే
  1. ఫైల్ కరప్షన్ కోసం తనిఖీ చేయండి
# JSON నిర్మాణాన్ని తనిఖీ చేయడానికి టెక్స్ట్ ఎడిటర్‌లో తెరవడానికి ప్రయత్నించండి
# దెబ్బతిన్నట్లయితే కంటెంట్‌ను కొత్త నోట్‌బుక్‌కు కాపీ చేయండి
  1. Jupyter క్యాషే క్లియర్ చేయండి
jupyter notebook --clear-cache

సెల్ అమలు కావడం లేదు

సమస్య: సెల్ "In [*]" వద్ద అడ్డుకుంటోంది లేదా చాలా సమయం తీసుకుంటోంది

పరిష్కారం:

  1. కర్నెల్‌ను అంతరాయం చేయండి: "Interrupt" బటన్ క్లిక్ చేయండి లేదా I, I నొక్కండి
  2. కర్నెల్‌ను రీస్టార్ట్ చేయండి: Kernel మెనూ → Restart
  3. మీ కోడ్‌లో అనంత లూప్‌లు ఉన్నాయా చూడండి
  4. ఫలితాన్ని క్లియర్ చేయండి: సెల్ → All Output → Clear

ప్లాట్లు ప్రదర్శించబడడం లేదు

సమస్య: matplotlib ప్లాట్లు నోట్‌బుక్‌లో చూపించబడడం లేదు

పరిష్కారం:

# నోట్‌బుక్ టాప్‌లో మేజిక్ కమాండ్‌ను జోడించండి
%matplotlib inline

import matplotlib.pyplot as plt

# ప్లాట్ సృష్టించండి
plt.plot([1, 2, 3, 4])
plt.show()  # show() ను పిలవడం నిర్ధారించుకోండి

ఇంటరాక్టివ్ ప్లాట్లకు ప్రత్యామ్నాయం:

%matplotlib notebook
# లేదా
%matplotlib widget

క్విజ్ అప్లికేషన్ సమస్యలు

npm install విఫలమవుతుంది

సమస్య: npm install సమయంలో లోపాలు

పరిష్కారం:

# npm క్యాషేను క్లియర్ చేయండి
npm cache clean --force

# node_modules మరియు package-lock.json ను తొలగించండి
rm -rf node_modules package-lock.json

# మళ్లీ ఇన్‌స్టాల్ చేయండి
npm install

# ఇంకా విఫలమైతే, legacy peer deps తో ప్రయత్నించండి
npm install --legacy-peer-deps

Quiz App ప్రారంభం కావడం లేదు

సమస్య: npm run serve విఫలమవుతుంది

పరిష్కారం:

# Node.js వెర్షన్‌ను తనిఖీ చేయండి
node --version  # 12.x లేదా అంతకంటే ఎక్కువ ఉండాలి

# డిపెండెన్సీలను మళ్లీ ఇన్‌స్టాల్ చేయండి
cd quiz-app
rm -rf node_modules package-lock.json
npm install

# వేరే పోర్ట్ ప్రయత్నించండి
npm run serve -- --port 8081

పోర్ట్ ఇప్పటికే ఉపయోగంలో ఉంది

సమస్య: "Port 8080 is already in use"

పరిష్కారం:

# పోర్ట్ 8080 పై ప్రాసెస్‌ను కనుగొని ముగించండి
# macOS/Linux:
lsof -ti:8080 | xargs kill -9

# Windows:
netstat -ano | findstr :8080
taskkill /PID <PID> /F

# లేదా వేరే పోర్ట్ ఉపయోగించండి
npm run serve -- --port 8081

Quiz లోడ్ అవ్వడం లేదా ఖాళీ పేజీ

సమస్య: Quiz యాప్ లోడ్ అవుతుంది కానీ ఖాళీ పేజీ చూపిస్తుంది

పరిష్కారం:

  1. బ్రౌజర్ కన్సోల్ లో లోపాలు తనిఖీ చేయండి (F12)
  2. బ్రౌజర్ క్యాషే మరియు కుకీలను క్లియర్ చేయండి
  3. వేరే బ్రౌజర్ ప్రయత్నించండి
  4. జావాస్క్రిప్ట్ ఎనేబుల్ ఉందని నిర్ధారించుకోండి
  5. అడ్బ్లాకర్లు జోక్యం చేస్తున్నాయా చూడండి
# యాప్‌ను మళ్లీ నిర్మించండి
npm run build
npm run serve

Git మరియు GitHub సమస్యలు

Git గుర్తించబడడం లేదు

సమస్య: git: command not found

పరిష్కారం:

Windows:

  • git-scm.com నుండి Git ఇన్‌స్టాల్ చేయండి
  • ఇన్‌స్టాలేషన్ తర్వాత టెర్మినల్‌ను రీస్టార్ట్ చేయండి

macOS:

గమనిక: మీరు Homebrew ఇన్‌స్టాల్ చేయకపోతే, ముందుగా https://brew.sh/ వద్ద సూచనలను అనుసరించండి.

# హోంబ్రూ ద్వారా ఇన్‌స్టాల్ చేయండి
brew install git

# లేదా Xcode కమాండ్ లైన్ టూల్స్ ఇన్‌స్టాల్ చేయండి
xcode-select --install

Linux:

sudo apt-get install git  # డెబియన్/ఉబుంటు
sudo dnf install git      # ఫెడోరా

క్లోన్ విఫలమవుతుంది

సమస్య: git clone ధృవీకరణ లోపాలతో విఫలమవుతుంది

పరిష్కారం:

# HTTPS URL ఉపయోగించండి
git clone https://github.com/microsoft/Data-Science-For-Beginners.git

# మీరు GitHub లో 2FA సక్రియం చేసుకున్నట్లయితే, Personal Access Token ఉపయోగించండి
# టోకెన్ సృష్టించండి: https://github.com/settings/tokens
# అడిగినప్పుడు పాస్వర్డ్ గా టోకెన్ ఉపయోగించండి

అనుమతి నిరాకరించబడింది (publickey)

సమస్య: SSH కీ ధృవీకరణ విఫలమవుతుంది

పరిష్కారం:

# SSH కీని సృష్టించండి
ssh-keygen -t ed25519 -C "your_email@example.com"

# కీని ssh-agent కు జోడించండి
eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_ed25519

# పబ్లిక్ కీని GitHub కు జోడించండి
# కీని కాపీ చేయండి: cat ~/.ssh/id_ed25519.pub
# ఇక్కడ జోడించండి: https://github.com/settings/keys

Docsify డాక్యుమెంటేషన్ సమస్యలు

Docsify కమాండ్ కనుగొనబడలేదు

సమస్య: docsify: command not found

పరిష్కారం:

# గ్లోబల్‌గా ఇన్‌స్టాల్ చేయండి
npm install -g docsify-cli

# macOS/Linuxలో అనుమతి లోపం ఉంటే
sudo npm install -g docsify-cli

# ఇన్‌స్టాలేషన్‌ను ధృవీకరించండి
docsify --version

# ఇంకా కనబడకపోతే, npm గ్లోబల్ పాత్‌ను జోడించండి
# npm గ్లోబల్ పాత్‌ను కనుగొనండి
npm config get prefix

# PATHలో జోడించండి (~/.bashrc లేదా ~/.zshrcలో జోడించండి)
export PATH="$PATH:/usr/local/bin"

డాక్యుమెంటేషన్ లోడ్ అవ్వడం లేదు

సమస్య: Docsify సర్వ్ చేస్తోంది కానీ కంటెంట్ లోడ్ అవ్వడం లేదు

పరిష్కారం:

# మీరు రిపాజిటరీ రూట్‌లో ఉన్నారని నిర్ధారించుకోండి
cd Data-Science-For-Beginners

# index.html కోసం తనిఖీ చేయండి
ls index.html

# నిర్దిష్ట పోర్ట్‌తో సర్వ్ చేయండి
docsify serve --port 3000

# బ్రౌజర్ కన్సోల్‌లో లోపాలను తనిఖీ చేయండి (F12)

చిత్రాలు ప్రదర్శించబడడం లేదు

సమస్య: చిత్రాలు బ్రోకెన్ లింక్ ఐకాన్ చూపిస్తున్నాయి

పరిష్కారం:

  1. చిత్రం మార్గాలు రిలేటివ్‌గా ఉన్నాయా తనిఖీ చేయండి
  2. చిత్రం ఫైళ్లు రిపోజిటరీలో ఉన్నాయా నిర్ధారించుకోండి
  3. బ్రౌజర్ క్యాషే క్లియర్ చేయండి
  4. ఫైల్ ఎక్స్‌టెన్షన్లు సరిపోతున్నాయా తనిఖీ చేయండి (కొన్ని సిస్టమ్స్‌లో కేస్-సెన్సిటివ్)

డేటా మరియు ఫైల్ సమస్యలు

ఫైల్ కనుగొనబడలేదు లోపాలు

సమస్య: డేటా లోడ్ చేస్తున్నప్పుడు FileNotFoundError

పరిష్కారం:

import os

# ప్రస్తుత పని డైరెక్టరీని తనిఖీ చేయండి
print(os.getcwd())

# సంపూర్ణ మార్గాన్ని ఉపయోగించండి
data_path = os.path.join(os.getcwd(), 'data', 'filename.csv')
df = pd.read_csv(data_path)

# లేదా నోట్‌బుక్ స్థానం నుండి సంబంధిత మార్గాన్ని ఉపయోగించండి
df = pd.read_csv('../data/filename.csv')

# ఫైల్ ఉన్నదో లేదో నిర్ధారించండి
print(os.path.exists('data/filename.csv'))

CSV చదవడంలో లోపాలు

సమస్య: CSV ఫైళ్లు చదవడంలో లోపాలు

పరిష్కారం:

import pandas as pd

# వేరే ఎన్‌కోడింగ్స్ ప్రయత్నించండి
df = pd.read_csv('file.csv', encoding='utf-8')
# లేదా
df = pd.read_csv('file.csv', encoding='latin-1')
# లేదా
df = pd.read_csv('file.csv', encoding='ISO-8859-1')

# లేని విలువలను నిర్వహించండి
df = pd.read_csv('file.csv', na_values=['NA', 'N/A', ''])

# కామా కాకపోతే డెలిమిటర్‌ను పేర్కొనండి
df = pd.read_csv('file.csv', delimiter=';')

పెద్ద డేటాసెట్‌లతో మెమరీ లోపాలు

సమస్య: పెద్ద ఫైళ్లు లోడ్ చేస్తున్నప్పుడు MemoryError

పరిష్కారం:

# భాగాలుగా చదవండి
chunk_size = 10000
chunks = []
for chunk in pd.read_csv('large_file.csv', chunksize=chunk_size):
    # భాగాన్ని ప్రాసెస్ చేయండి
    chunks.append(chunk)
df = pd.concat(chunks)

# లేదా నిర్దిష్ట కాలమ్స్ మాత్రమే చదవండి
df = pd.read_csv('file.csv', usecols=['col1', 'col2'])

# మరింత సమర్థవంతమైన డేటా రకాలను ఉపయోగించండి
df = pd.read_csv('file.csv', dtype={'column_name': 'int32'})

పనితీరు సమస్యలు

నోట్‌బుక్ పనితీరు మందగించడం

సమస్య: నోట్‌బుక్స్ చాలా మందగిస్తాయి

పరిష్కారం:

  1. కర్నెల్‌ను రీస్టార్ట్ చేసి అవుట్‌పుట్ క్లియర్ చేయండి

    • Kernel → Restart & Clear Output

  2. వినియోగంలో లేని నోట్‌బుక్స్ మూసివేయండి

  3. కోడ్‌ను ఆప్టిమైజ్ చేయండి:

# లూపుల బదులు వెక్టరైజ్డ్ ఆపరేషన్లు ఉపయోగించండి
# చెడు:
result = []
for x in data:
    result.append(x * 2)

# మంచి:
result = data * 2  # NumPy/Pandas వెక్టరైజేషన్
  1. పెద్ద డేటాసెట్‌ల నుండి నమూనాలు తీసుకోండి:
# అభివృద్ధి సమయంలో నమూనాతో పని చేయండి
df_sample = df.sample(n=1000)  # లేదా df.head(1000)

బ్రౌజర్ క్రాష్‌లు

సమస్య: బ్రౌజర్ క్రాష్ అవుతుంది లేదా స్పందించదు

పరిష్కారం:

  1. వినియోగంలో లేని ట్యాబ్స్ మూసివేయండి
  2. బ్రౌజర్ క్యాషే క్లియర్ చేయండి
  3. బ్రౌజర్ మెమరీ పెంచండి (Chrome: chrome://settings/system)
  4. JupyterLab ఉపయోగించండి:
pip install jupyterlab
jupyter lab

అదనపు సహాయం పొందడం

సహాయం కోరేముందు

  1. ఈ సమస్య పరిష్కరణ గైడ్‌ను తనిఖీ చేయండి
  2. GitHub Issues లో శోధించండి
  3. INSTALLATION.md మరియు USAGE.md ను సమీక్షించండి
  4. లోప సందేశాన్ని ఆన్‌లైన్‌లో శోధించండి

సహాయం ఎలా కోరాలి

సమస్యను సృష్టించేటప్పుడు లేదా సహాయం కోరేటప్పుడు, ఈ వివరాలను చేర్చండి:

  1. ఆపరేటింగ్ సిస్టమ్: Windows, macOS, లేదా Linux (ఏ డిస్ట్రిబ్యూషన్)
  2. Python వెర్షన్: python --version ను రన్ చేయండి
  3. లోప సందేశం: పూర్తి లోప సందేశాన్ని కాపీ చేయండి
  4. పునరుత్పత్తి దశలు: లోపం సంభవించే ముందు మీరు చేసిన దశలు
  5. మీ ప్రయత్నాలు: మీరు ఇప్పటికే ప్రయత్నించిన పరిష్కారాలు

ఉదాహరణ:

**Operating System:** macOS 12.0
**Python Version:** 3.9.7
**Error Message:** ModuleNotFoundError: No module named 'pandas'
**Steps to Reproduce:**
1. Activated virtual environment
2. Started Jupyter notebook
3. Tried to import pandas

**What I've Tried:**
- Ran pip install pandas
- Restarted Jupyter

కమ్యూనిటీ వనరులు

సంబంధిత డాక్యుమెంటేషన్

  • INSTALLATION.md - సెటప్ సూచనలు
  • USAGE.md - పాఠ్యాంశం ఎలా ఉపయోగించాలి
  • CONTRIBUTING.md - ఎలా సహకరించాలి
  • README.md - ప్రాజెక్ట్ అవలోకనం

అస్పష్టత:
ఈ పత్రాన్ని AI అనువాద సేవ Co-op Translator ఉపయోగించి అనువదించబడింది. మేము ఖచ్చితత్వానికి ప్రయత్నించినప్పటికీ, ఆటోమేటెడ్ అనువాదాల్లో పొరపాట్లు లేదా తప్పిదాలు ఉండవచ్చు. మూల పత్రం దాని స్వదేశీ భాషలో అధికారిక మూలంగా పరిగణించాలి. ముఖ్యమైన సమాచారానికి, ప్రొఫెషనల్ మానవ అనువాదం సిఫార్సు చేయబడుతుంది. ఈ అనువాదం వాడకంలో ఏర్పడిన ఏవైనా అపార్థాలు లేదా తప్పుదారితీసే అర్థాలు కోసం మేము బాధ్యత వహించము.