From 6a5ab4afd9258d50618bbd99a0c826cc681b1de4 Mon Sep 17 00:00:00 2001
From: medusa <newton214@gmail.com>
Date: Thu, 28 Mar 2024 18:25:30 +0000
Subject: [PATCH] Update docs/tech_docs/python/pandas.md

---
 docs/tech_docs/python/pandas.md | 160 +++++++++++++++++++++++++++++++-
 1 file changed, 159 insertions(+), 1 deletion(-)

diff --git a/docs/tech_docs/python/pandas.md b/docs/tech_docs/python/pandas.md
index 27e2b71..0319866 100644
--- a/docs/tech_docs/python/pandas.md
+++ b/docs/tech_docs/python/pandas.md
@@ -136,4 +136,162 @@ df.to_excel('filename.xlsx')
 # Other formats include: to_sql, to_json, to_html, to_clipboard, to_pickle, etc.
 ```
 
-`pandas` is incredibly powerful for data cleaning, transformation, analysis, and visualization. This guide covers the basics, but the library's capabilities are vast and highly customizable to suit complex data manipulation and analysis tasks.
\ No newline at end of file
+`pandas` is incredibly powerful for data cleaning, transformation, analysis, and visualization. This guide covers the basics, but the library's capabilities are vast and highly customizable to suit complex data manipulation and analysis tasks.
+
+---
+
+For high-performance, flexible, and expressive data structures designed to make working with "relational" or "labeled" data both easy and intuitive, `pandas` stands out as a crucial tool in Python data science libraries. It provides essential data manipulation capabilities akin to those found in programming languages like R. Here’s a concise reference guide for common use cases with `pandas`, especially tailored for data manipulation and cleaning tasks:
+
+# `pandas` Reference Guide
+
+## Installation
+```
+pip install pandas
+```
+
+## Basic Concepts
+
+### Importing pandas
+```python
+import pandas as pd
+```
+
+### Series and DataFrame
+- **Series**: One-dimensional labeled array capable of holding data of any type.
+- **DataFrame**: Two-dimensional labeled data structure with columns of potentially different types.
+
+## Creating DataFrames
+```python
+# From a dictionary
+df = pd.DataFrame({
+    'Column1': [1, 2, 3],
+    'Column2': ['a', 'b', 'c']
+})
+
+# From a list of dictionaries
+df = pd.DataFrame([
+    {'Column1': 1, 'Column2': 'a'},
+    {'Column1': 2, 'Column2': 'b'}
+])
+
+# From a CSV file
+df = pd.read_csv('filename.csv')
+
+# From an Excel file
+df = pd.read_excel('filename.xlsx')
+```
+
+## Basic DataFrame Operations
+
+### Viewing Data
+```python
+# View the first 5 rows
+df.head()
+
+# View the last 5 rows
+df.tail()
+
+# Display the index, columns, and underlying numpy data
+df.info()
+```
+
+### Data Selection
+```python
+# Select a single column
+df['Column1']
+
+# Select multiple columns
+df[['Column1', 'Column2']]
+
+# Select rows by position
+df.iloc[0]  # First row
+
+# Select rows by label
+df.loc[0]  # Row with index label 0
+```
+
+### Data Filtering
+```python
+# Rows where Column1 is greater than 1
+df[df['Column1'] > 1]
+```
+
+### Adding and Dropping Columns
+```python
+# Adding a new column
+df['Column3'] = [4, 5, 6]
+
+# Dropping a column
+df.drop('Column3', axis=1, inplace=True)
+```
+
+### Renaming Columns
+```python
+df.rename(columns={'Column1': 'NewName1'}, inplace=True)
+```
+
+### Handling Missing Data
+```python
+# Drop rows with any missing values
+df.dropna()
+
+# Fill missing values
+df.fillna(value=0)
+```
+
+## Data Manipulation
+
+### Applying Functions
+```python
+# Apply a function to each item
+df['Column1'] = df['Column1'].apply(lambda x: x * 2)
+```
+
+### Grouping Data
+```python
+# Group by column and calculate mean
+df.groupby('Column1').mean()
+```
+
+### Merging and Concatenating
+```python
+# Concatenate DataFrames
+pd.concat([df1, df2])
+
+# Merge DataFrames
+pd.merge(df1, df2, on='key_column')
+```
+
+### Aggregating Data
+```python
+df.agg({
+    'Column1': ['min', 'max', 'mean'],
+    'Column2': ['sum']
+})
+```
+
+## Working with Time Series
+```python
+# Convert column to datetime
+df['DateColumn'] = pd.to_datetime(df['DateColumn'])
+
+# Set the DateTime column as the index
+df.set_index('DateColumn', inplace=True)
+
+# Resample and aggregate by month
+df.resample('M').mean()
+```
+
+## Saving Data
+```python
+# Write to a CSV file
+df.to_csv('new_file.csv')
+
+# Write to an Excel file
+df.to_excel('new_file.xlsx')
+```
+
+`pandas` is an indispensable tool for data munging/wrangling. It provides high-level abstractions for complex operations, simplifying tasks like data filtering, transformation, and aggregation. This guide covers foundational operations but barely scratches the surface of `pandas`' capabilities, which are vast and varied, extending well beyond these basics to support complex data manipulation and analysis tasks.
+```
+
+Given its powerful and flexible data manipulation capabilities, `pandas` is a cornerstone library for anyone working with data in Python, offering a depth of functionality that covers nearly every aspect of data analysis and manipulation.
\ No newline at end of file