alterlab-dask
Scales pandas/NumPy workflows beyond memory with Dask distributed computing — parallel DataFrames, arrays, delayed task graphs, and cluster execution. Use when existing pandas/NumPy code must run on larger-than-RAM data or across clusters, for parallel file processing, distribute
Install
npx skills add https://github.com/AlterLab-IEU/AlterLab-Academic-Skills/tree/main/skills/data-science/alterlab-dask
claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install alterlab-ieu-alterlab-academic-skills@llmmart
git clone https://github.com/AlterLab-IEU/AlterLab-Academic-Skills.git
The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole alterlab-ieu/alterlab-academic-skills collection as a plugin from our marketplace. Git is the plain clone.
Skill manifest
Dask
Overview
Dask is a Python library for parallel and distributed computing that enables three critical capabilities:
- Larger-than-memory execution on single machines for data exceeding available RAM
- Parallel processing for improved computational speed across multiple cores
- Distributed computation supporting terabyte-scale datasets across multiple machines
Dask scales from laptops (processing ~100 GiB) to clusters (processing ~100 TiB) while maintaining familiar Python APIs.
When to Use This Skill
This skill should be used when:
- Process datasets that exceed available RAM
- Scale pandas or NumPy operations to larger datasets
- Parallelize computations for performance improvements
- Process multiple files efficiently (CSVs, Parquet, JSON, text logs)
- Build custom parallel workflows with task dependencies
- Distribute workloads across multiple cores or machines
Does NOT Trigger
| Scenario | Use Instead |
|---|---|
| Data fits in RAM and the goal is maximum single-machine DataFrame speed | alterlab-polars |
| Billion-row out-of-core exploration and big-data plots on one machine, no cluster | alterlab-vaex |
| Designing chunked, compressed Zarr stores and codecs (rather than computing on them) | alterlab-zarr |
Hand-off rule. When the request matches a row above, open your answer by naming that skill by its exact id (for example alterlab-polars) and saying in one line why it fits better, then stop applying this skill's procedure. Name it even when you also need to ask for missing input. If only part of the request is out of scope, name the skill for that part and do only the in-scope part. A brief general pointer is fine; the named skill does the work.
Version notes
Since 2025.1 the query-planning DataFrame (formerly dask-expr) is the only Dask DataFrame
implementation and ships inside dask; dask.config.set({"dataframe.query-planning": False})
no longer exists. Text columns load as a string dtype (PyArrow-backed in Dask; str in pandas 3)
and reductions do not skip them silently: ddf.mean() raises TypeError and
ddf.groupby(...).mean() raises NotImplementedError when non-numeric columns are present, so
select columns or pass numeric_only=True.
Core Capabilities
Dask provides five main components, each suited to different use cases:
1. DataFrames - Parallel Pandas Operations
Purpose: Scale pandas operations to larger datasets through parallel processing.
When to Use:
- Tabular data exceeds available RAM
- Need to process multiple CSV/Parquet files together
- Pandas operations are slow and need parallelization
- Scaling from pandas prototype to production
Reference Documentation: For comprehensive guidance on Dask DataFrames, refer to references/dataframes.md which includes:
- Reading data (single files, multiple files, glob patterns)
- Common operations (filtering, groupby, joins, aggregations)
- Custom operations with
map_partitions - Performance optimization tips
- Common patterns (ETL, time series, multi-file processing)
Quick Example:
import dask.dataframe as dd
# Read multiple files as single DataFrame
ddf = dd.read_csv('data/2024-*.csv')
# Operations are lazy until compute()
filtered = ddf[ddf['value'] > 100]
result = filtered.groupby('category').mean(numeric_only=True).compute()
Key Points:
- Operations are lazy (build task graph) until
.compute()called - Use
map_partitionsfor efficient custom operations - Convert to DataFrame early when working with structured data from other sources
2. Arrays - Parallel NumPy Operations
Purpose: Extend NumPy capabilities to datasets larger than memory using blocked algorithms.
When to Use:
- Arrays exceed available RAM
- NumPy operations need parallelization
- Working with scientific datasets (HDF5, Zarr, NetCDF)
- Need parallel linear algebra or array operations
Reference Documentation: For comprehensive guidance on Dask Arrays, refer to references/arrays.md which includes:
- Creating arrays (from NumPy, random, from disk)
- Chunking strategies and optimization
- Common operations (arithmetic, reductions, linear algebra)
- Custom operations with
map_blocks - Integration with HDF5, Zarr, and XArray
Quick Example:
import dask.array as da
# Create large array with chunks
x = da.random.random((100000, 100000), chunks=(10000, 10000))
# Operations are lazy
y = x + 100
z = y.mean(axis=0)
# Compute result
result = z.compute()
Key Points:
- Chunk size is critical (aim for ~100 MB per chunk)
- Operations work on chunks in parallel
- Rechunk data when needed for efficient operations
- Use
map_blocksfor operations not available in Dask
3. Bags - Parallel Processing of Unstructured Data
Purpose: Process unstructured or semi-structured data (text, JSON, logs) with functional operations.
When to Use:
- Processing text files, logs, or JSON records
- Data cleaning and ETL before structured analysis
- Working with Python objects that don't fit array/dataframe formats
- Need memory-efficient streaming processing
Reference Documentation: For comprehensive guidance on Dask Bags, refer to references/bags.md which includes:
- Reading text and JSON files
- Functional operations (map, filter, fold, groupby)
- Converting to DataFrames
- Common patterns (log analysis, JSON processing, text processing)
- Performance considerations
Quick Example:
import dask.bag as db
import json
# Read and parse JSON files
bag = db.read_text('logs/*.json').map(json.loads)
# Filter and transform
valid = bag.filter(lambda x: x['status'] == 'valid')
processed = valid.map(lambda x: {'id': x['id'], 'value': x['value']})
# Convert to DataFrame for analysis
ddf = processed.to_dataframe()
Key Points:
- Use for initial data cleaning, then convert to DataFrame/Array
- Use
foldbyinstead ofgroupbyfor better performance - Operations are streaming and memory-efficient
- Convert to structured formats (DataFrame) for complex operations
4. Futures - Task-Based Parallelization
Purpose: Build custom parallel workflows with fine-grained control over task execution and dependencies.
When to Use:
- Building dynamic, evolving workflows
- Need immediate task execution (not lazy)
- Computations depend on runtime conditions
- Implementing custom parallel algorithms
- Need stateful computations
Reference Documentation: For comprehensive guidance on Dask Futures, refer to references/futures.md which includes:
- Setting up distributed client
- Submitting tasks and working with futures
- Task dependencies and data movement
- Advanced coordination (queues, locks, events, actors)
- Common patterns (parameter sweeps, dynamic tasks, iterative algorithms)
Quick Example:
from dask.distributed import Client
client = Client() # Create local cluster
# Submit tasks (executes immediately)
def process(x):
return x ** 2
futures = client.map(process, range(100))
# Gather results
results = client.gather(futures)
client.close()
Key Points:
- Requires distributed client (even for single machine)
- Tasks execute immediately when submitted
- Pre-scatter large data to avoid repeated transfers
- ~1ms overhead per task (not suitable for millions of tiny tasks)
- Use actors for stateful workflows
5. Schedulers - Execution Backends
Purpose: Control how and where Dask tasks execute (threads, processes, distributed).
When to Choose Scheduler:
- Threads (default): NumPy/Pandas operations, GIL-releasing libraries, shared memory benefit
- Processes: Pure Python code, text processing, GIL-bound operations
- Synchronous: Debugging with pdb, profiling, understanding errors
- Distributed: Need dashboard, multi-machine clusters, advanced features
Reference Documentation: For comprehensive guidance on Dask Schedulers, refer to references/schedulers.md which includes:
- Detailed scheduler descriptions and characteristics
- Configuration methods (global, context manager, per-compute)
- Performance considerations and overhead
- Common patterns and troubleshooting
- Thread configuration for optimal performance
Quick Example:
import dask
import dask.dataframe as dd
# Use threads for DataFrame (default, good for numeric)
ddf = dd.read_csv('data.csv')
result1 = ddf.mean(numeric_only=True).compute() # Uses threads
# Use processes for Python-heavy work
import dask.bag as db
bag = db.read_text('logs/*.txt')
result2 = bag.map(python_function).compute(scheduler='processes')
# Use synchronous for debugging
dask.config.set(scheduler='synchronous')
result3 = problematic_computation.compute() # Can use pdb
# Use distributed for monitoring and scaling
from dask.distributed import Client
client = Client()
result4 = computation.compute() # Uses distributed with dashboard
Key Points:
- Threads: Lowest overhead (~10 µs/task), best for numeric work
- Processes: Avoids GIL (~10 ms/task), best for Python work
- Distributed: Monitoring dashboard (~1 ms/task), scales to clusters
- Can switch schedulers per computation or globally
Best Practices
For comprehensive performance optimization guidance, memory management strategies, and common pitfalls to avoid, refer to references/best-practices.md. Key principles include:
Start with Simpler Solutions
Before using Dask, explore:
- Better algorithms
- Efficient file formats (Parquet instead of CSV)
- Compiled code (Numba, Cython)
- Data sampling
Critical Performance Rules
1. Don't Load Data Locally Then Hand to Dask
# Wrong: Loads all data in memory first
import pandas as pd
df = pd.read_csv('large.csv')
ddf = dd.from_pandas(df, npartitions=10)
# Correct: Let Dask handle loading
import dask.dataframe as dd
ddf = dd.read_csv('large.csv')
2. Avoid Repeated compute() Calls
# Wrong: Each compute is separate
for item in items:
result = dask_computation(item).compute()
# Correct: Single compute for all
computations = [dask_computation(item) for item in items]
results = dask.compute(*computations)
3. Don't Build Excessively Large Task Graphs
- Increase chunk sizes if millions of tasks
- Use
map_partitions/map_blocksto fuse operations - Check task graph size:
len(ddf.__dask_graph__())
4. Choose Appropriate Chunk Sizes
- Target: ~100 MB per chunk (or 10 chunks per core in worker memory)
- Too large: Memory overflow
- Too small: Scheduling overhead
5. Use the Dashboard
from dask.distributed import Client
client = Client()
print(client.dashboard_link) # Monitor performance, identify bottlenecks
Common Workflow Patterns
ETL Pipeline
import dask.dataframe as dd
# Extract: Read data
ddf = dd.read_csv('raw_data/*.csv')
# Transform: Clean and process
ddf = ddf[ddf['status'] == 'valid']
ddf['amount'] = ddf['amount'].astype('float64')
ddf = ddf.dropna(subset=['important_col'])
# Load: Aggregate and save. Named aggregation keeps flat string column names;
# a dict-of-lists .agg() creates MultiIndex columns that Parquet rejects.
summary = ddf.groupby('category').agg(
amount_sum=('amount', 'sum'),
amount_mean=('amount', 'mean'),
)
summary.to_parquet('output/summary.parquet')
Unstructured to Structured Pipeline
import dask.bag as db
import json
# Start with Bag for unstructured data
bag = db.read_text('logs/*.json').map(json.loads)
bag = bag.filter(lambda x: x['status'] == 'valid')
# Convert to DataFrame for structured analysis
ddf = bag.to_dataframe()
result = ddf.groupby('category').mean(numeric_only=True).compute()
Large-Scale Array Computation
import dask
import dask.array as da
# Load or create large array
x = da.from_zarr('large_dataset.zarr')
# Pass 1: global statistics in one read (float64 accumulators for float32 data)
mean, std = dask.compute(x.mean(dtype='float64'), x.std(dtype='float64'))
# Pass 2: elementwise, chunk by chunk; each output chunk needs only its own input chunk
normalized = ((x - mean) / std).astype(x.dtype)
da.to_zarr(normalized, 'normalized.zarr')
For data larger than memory, do not write the lazy one-liner (x - x.mean()) / x.std(): every output chunk then waits on a full-array reduction, so the scheduler keeps the loaded input chunks in memory until it finishes (with dask 2026.8 a 128 MB Zarr array peaked at ~133 MB that way and ~7 MB in two passes).
Custom Parallel Workflow
from dask.distributed import Client
client = Client()
# Scatter large dataset once
data = client.scatter(large_dataset)
# Process in parallel with dependencies
futures = []
for param in parameters:
future = client.submit(process, data, param)
futures.append(future)
# Gather results
results = client.gather(futures)
Selecting the Right Component
Use this decision guide to choose the appropriate Dask component:
Data Type:
- Tabular data → DataFrames
- Numeric arrays → Arrays
- Text/JSON/logs → Bags (then convert to DataFrame)
- Custom Python objects → Bags or Futures
Operation Type:
- Standard pandas operations → DataFrames
- Standard NumPy operations → Arrays
- Custom parallel tasks → Futures
- Text processing/ETL → Bags
Control Level:
- High-level, automatic → DataFrames/Arrays
- Low-level, manual → Futures
Workflow Type:
- Static computation graph → DataFrames/Arrays/Bags
- Dynamic, evolving → Futures
Integration Considerations
File Formats
- Efficient: Parquet, HDF5, Zarr (columnar, compressed, parallel-friendly)
- Compatible but slower: CSV (use for initial ingestion only)
- For Arrays: HDF5, Zarr, NetCDF
Conversion Between Collections
# Bag → DataFrame
ddf = bag.to_dataframe()
# DataFrame → Array (for numeric data)
arr = ddf.to_dask_array(lengths=True)
# Array → DataFrame
ddf = dd.from_dask_array(arr, columns=['col1', 'col2'])
With Other Libraries
- XArray: Wraps Dask arrays with labeled dimensions (geospatial, imaging)
- Dask-ML: Machine learning with scikit-learn compatible APIs
- Distributed: Advanced cluster management and monitoring
Debugging and Development
Iterative Development Workflow
- Test on small data with synchronous scheduler:
dask.config.set(scheduler='synchronous')
result = computation.compute() # Can use pdb, easy debugging
- Validate with threads on sample:
sample = ddf.head(1000) # Small sample
# Test logic, then scale to full dataset
- Scale with distributed for monitoring:
from dask.distributed import Client
client = Client()
print(client.dashboard_link) # Monitor performance
result = computation.compute()
Common Issues
Memory Errors:
- Decrease chunk sizes
- Use
persist()strategically and delete when done - Check for memory leaks in custom functions
Slow Start:
- Task graph too large (increase chunk sizes)
- Use
map_partitionsormap_blocksto reduce tasks
Poor Parallelization:
- Chunks too large (increase number of partitions)
- Using threads with Python code (switch to processes)
- Data dependencies preventing parallelism
Reference Files
All reference documentation files can be read as needed for detailed information:
references/dataframes.md- Complete Dask DataFrame guidereferences/arrays.md- Complete Dask Array guidereferences/bags.md- Complete Dask Bag guidereferences/futures.md- Complete Dask Futures and distributed computing guidereferences/schedulers.md- Complete scheduler selection and configuration guidereferences/best-practices.md- Comprehensive performance optimization and troubleshooting
Load these files when users need detailed information about specific Dask components, operations, or patterns beyond the quick guidance provided here.
Files (alterlab-academic-skills)
-
evals
-
evals.json 5.6 KB
Loading…
-
-
references
-
arrays.md 11.7 KB
Loading… -
bags.md 10.6 KB
Loading… -
best-practices.md 7.1 KB
Loading… -
dataframes.md 9.1 KB
Loading… -
futures.md 11.8 KB
Loading… -
schedulers.md 11.1 KB
Loading…
-
-
SKILL.md 16.6 KB
--- name: alterlab-dask description: Scales pandas/NumPy workflows beyond memory with Dask distributed computing — parallel DataFrames, arrays, delayed task graphs, and cluster execution. Use when existing pandas/NumPy code must run on larger-than-RAM data or across clusters, for parallel file processing, distributed ML, or integration with existing pandas code. For out-of-core analytics on a single machine prefer vaex; for in-memory speed prefer polars. Part of the AlterLab Academic Skills suite. license: MIT allowed-tools: Read Write Edit Bash(python:*) Bash(uv:*) compatibility: No API key required. Runs locally via `uv run --python ">=3.12" --with "dask[complete]>=2025.1" python script.py` (no install step; the interpreter pin matters because an older default Python resolves older releases); requires dask >= 2025.1 (current 2026.8 as of 2026-09; install `dask[complete]` for DataFrames, arrays, and the distributed scheduler). metadata: skill-author: AlterLab version: "1.0.1" last_updated: "2026-09-23" --- # Dask ## Overview Dask is a Python library for parallel and distributed computing that enables three critical capabilities: - **Larger-than-memory execution** on single machines for data exceeding available RAM - **Parallel processing** for improved computational speed across multiple cores - **Distributed computation** supporting terabyte-scale datasets across multiple machines Dask scales from laptops (processing ~100 GiB) to clusters (processing ~100 TiB) while maintaining familiar Python APIs. ## When to Use This Skill This skill should be used when: - Process datasets that exceed available RAM - Scale pandas or NumPy operations to larger datasets - Parallelize computations for performance improvements - Process multiple files efficiently (CSVs, Parquet, JSON, text logs) - Build custom parallel workflows with task dependencies - Distribute workloads across multiple cores or machines ### Does NOT Trigger | Scenario | Use Instead | |----------|-------------| | Data fits in RAM and the goal is maximum single-machine DataFrame speed | `alterlab-polars` | | Billion-row out-of-core exploration and big-data plots on one machine, no cluster | `alterlab-vaex` | | Designing chunked, compressed Zarr stores and codecs (rather than computing on them) | `alterlab-zarr` | **Hand-off rule.** When the request matches a row above, open your answer by naming that skill by its exact id (for example `alterlab-polars`) and saying in one line why it fits better, then stop applying this skill's procedure. Name it even when you also need to ask for missing input. If only part of the request is out of scope, name the skill for that part and do only the in-scope part. A brief general pointer is fine; the named skill does the work. ### Version notes Since 2025.1 the query-planning DataFrame (formerly `dask-expr`) is the only Dask DataFrame implementation and ships inside `dask`; `dask.config.set({"dataframe.query-planning": False})` no longer exists. Text columns load as a string dtype (PyArrow-backed in Dask; `str` in pandas 3) and reductions do not skip them silently: `ddf.mean()` raises `TypeError` and `ddf.groupby(...).mean()` raises `NotImplementedError` when non-numeric columns are present, so select columns or pass `numeric_only=True`. ## Core Capabilities Dask provides five main components, each suited to different use cases: ### 1. DataFrames - Parallel Pandas Operations **Purpose**: Scale pandas operations to larger datasets through parallel processing. **When to Use**: - Tabular data exceeds available RAM - Need to process multiple CSV/Parquet files together - Pandas operations are slow and need parallelization - Scaling from pandas prototype to production **Reference Documentation**: For comprehensive guidance on Dask DataFrames, refer to `references/dataframes.md` which includes: - Reading data (single files, multiple files, glob patterns) - Common operations (filtering, groupby, joins, aggregations) - Custom operations with `map_partitions` - Performance optimization tips - Common patterns (ETL, time series, multi-file processing) **Quick Example**: ```python import dask.dataframe as dd # Read multiple files as single DataFrame ddf = dd.read_csv('data/2024-*.csv') # Operations are lazy until compute() filtered = ddf[ddf['value'] > 100] result = filtered.groupby('category').mean(numeric_only=True).compute() ``` **Key Points**: - Operations are lazy (build task graph) until `.compute()` called - Use `map_partitions` for efficient custom operations - Convert to DataFrame early when working with structured data from other sources ### 2. Arrays - Parallel NumPy Operations **Purpose**: Extend NumPy capabilities to datasets larger than memory using blocked algorithms. **When to Use**: - Arrays exceed available RAM - NumPy operations need parallelization - Working with scientific datasets (HDF5, Zarr, NetCDF) - Need parallel linear algebra or array operations **Reference Documentation**: For comprehensive guidance on Dask Arrays, refer to `references/arrays.md` which includes: - Creating arrays (from NumPy, random, from disk) - Chunking strategies and optimization - Common operations (arithmetic, reductions, linear algebra) - Custom operations with `map_blocks` - Integration with HDF5, Zarr, and XArray **Quick Example**: ```python import dask.array as da # Create large array with chunks x = da.random.random((100000, 100000), chunks=(10000, 10000)) # Operations are lazy y = x + 100 z = y.mean(axis=0) # Compute result result = z.compute() ``` **Key Points**: - Chunk size is critical (aim for ~100 MB per chunk) - Operations work on chunks in parallel - Rechunk data when needed for efficient operations - Use `map_blocks` for operations not available in Dask ### 3. Bags - Parallel Processing of Unstructured Data **Purpose**: Process unstructured or semi-structured data (text, JSON, logs) with functional operations. **When to Use**: - Processing text files, logs, or JSON records - Data cleaning and ETL before structured analysis - Working with Python objects that don't fit array/dataframe formats - Need memory-efficient streaming processing **Reference Documentation**: For comprehensive guidance on Dask Bags, refer to `references/bags.md` which includes: - Reading text and JSON files - Functional operations (map, filter, fold, groupby) - Converting to DataFrames - Common patterns (log analysis, JSON processing, text processing) - Performance considerations **Quick Example**: ```python import dask.bag as db import json # Read and parse JSON files bag = db.read_text('logs/*.json').map(json.loads) # Filter and transform valid = bag.filter(lambda x: x['status'] == 'valid') processed = valid.map(lambda x: {'id': x['id'], 'value': x['value']}) # Convert to DataFrame for analysis ddf = processed.to_dataframe() ``` **Key Points**: - Use for initial data cleaning, then convert to DataFrame/Array - Use `foldby` instead of `groupby` for better performance - Operations are streaming and memory-efficient - Convert to structured formats (DataFrame) for complex operations ### 4. Futures - Task-Based Parallelization **Purpose**: Build custom parallel workflows with fine-grained control over task execution and dependencies. **When to Use**: - Building dynamic, evolving workflows - Need immediate task execution (not lazy) - Computations depend on runtime conditions - Implementing custom parallel algorithms - Need stateful computations **Reference Documentation**: For comprehensive guidance on Dask Futures, refer to `references/futures.md` which includes: - Setting up distributed client - Submitting tasks and working with futures - Task dependencies and data movement - Advanced coordination (queues, locks, events, actors) - Common patterns (parameter sweeps, dynamic tasks, iterative algorithms) **Quick Example**: ```python from dask.distributed import Client client = Client() # Create local cluster # Submit tasks (executes immediately) def process(x): return x ** 2 futures = client.map(process, range(100)) # Gather results results = client.gather(futures) client.close() ``` **Key Points**: - Requires distributed client (even for single machine) - Tasks execute immediately when submitted - Pre-scatter large data to avoid repeated transfers - ~1ms overhead per task (not suitable for millions of tiny tasks) - Use actors for stateful workflows ### 5. Schedulers - Execution Backends **Purpose**: Control how and where Dask tasks execute (threads, processes, distributed). **When to Choose Scheduler**: - **Threads** (default): NumPy/Pandas operations, GIL-releasing libraries, shared memory benefit - **Processes**: Pure Python code, text processing, GIL-bound operations - **Synchronous**: Debugging with pdb, profiling, understanding errors - **Distributed**: Need dashboard, multi-machine clusters, advanced features **Reference Documentation**: For comprehensive guidance on Dask Schedulers, refer to `references/schedulers.md` which includes: - Detailed scheduler descriptions and characteristics - Configuration methods (global, context manager, per-compute) - Performance considerations and overhead - Common patterns and troubleshooting - Thread configuration for optimal performance **Quick Example**: ```python import dask import dask.dataframe as dd # Use threads for DataFrame (default, good for numeric) ddf = dd.read_csv('data.csv') result1 = ddf.mean(numeric_only=True).compute() # Uses threads # Use processes for Python-heavy work import dask.bag as db bag = db.read_text('logs/*.txt') result2 = bag.map(python_function).compute(scheduler='processes') # Use synchronous for debugging dask.config.set(scheduler='synchronous') result3 = problematic_computation.compute() # Can use pdb # Use distributed for monitoring and scaling from dask.distributed import Client client = Client() result4 = computation.compute() # Uses distributed with dashboard ``` **Key Points**: - Threads: Lowest overhead (~10 µs/task), best for numeric work - Processes: Avoids GIL (~10 ms/task), best for Python work - Distributed: Monitoring dashboard (~1 ms/task), scales to clusters - Can switch schedulers per computation or globally ## Best Practices For comprehensive performance optimization guidance, memory management strategies, and common pitfalls to avoid, refer to `references/best-practices.md`. Key principles include: ### Start with Simpler Solutions Before using Dask, explore: - Better algorithms - Efficient file formats (Parquet instead of CSV) - Compiled code (Numba, Cython) - Data sampling ### Critical Performance Rules **1. Don't Load Data Locally Then Hand to Dask** ```python # Wrong: Loads all data in memory first import pandas as pd df = pd.read_csv('large.csv') ddf = dd.from_pandas(df, npartitions=10) # Correct: Let Dask handle loading import dask.dataframe as dd ddf = dd.read_csv('large.csv') ``` **2. Avoid Repeated compute() Calls** ```python # Wrong: Each compute is separate for item in items: result = dask_computation(item).compute() # Correct: Single compute for all computations = [dask_computation(item) for item in items] results = dask.compute(*computations) ``` **3. Don't Build Excessively Large Task Graphs** - Increase chunk sizes if millions of tasks - Use `map_partitions`/`map_blocks` to fuse operations - Check task graph size: `len(ddf.__dask_graph__())` **4. Choose Appropriate Chunk Sizes** - Target: ~100 MB per chunk (or 10 chunks per core in worker memory) - Too large: Memory overflow - Too small: Scheduling overhead **5. Use the Dashboard** ```python from dask.distributed import Client client = Client() print(client.dashboard_link) # Monitor performance, identify bottlenecks ``` ## Common Workflow Patterns ### ETL Pipeline ```python import dask.dataframe as dd # Extract: Read data ddf = dd.read_csv('raw_data/*.csv') # Transform: Clean and process ddf = ddf[ddf['status'] == 'valid'] ddf['amount'] = ddf['amount'].astype('float64') ddf = ddf.dropna(subset=['important_col']) # Load: Aggregate and save. Named aggregation keeps flat string column names; # a dict-of-lists .agg() creates MultiIndex columns that Parquet rejects. summary = ddf.groupby('category').agg( amount_sum=('amount', 'sum'), amount_mean=('amount', 'mean'), ) summary.to_parquet('output/summary.parquet') ``` ### Unstructured to Structured Pipeline ```python import dask.bag as db import json # Start with Bag for unstructured data bag = db.read_text('logs/*.json').map(json.loads) bag = bag.filter(lambda x: x['status'] == 'valid') # Convert to DataFrame for structured analysis ddf = bag.to_dataframe() result = ddf.groupby('category').mean(numeric_only=True).compute() ``` ### Large-Scale Array Computation ```python import dask import dask.array as da # Load or create large array x = da.from_zarr('large_dataset.zarr') # Pass 1: global statistics in one read (float64 accumulators for float32 data) mean, std = dask.compute(x.mean(dtype='float64'), x.std(dtype='float64')) # Pass 2: elementwise, chunk by chunk; each output chunk needs only its own input chunk normalized = ((x - mean) / std).astype(x.dtype) da.to_zarr(normalized, 'normalized.zarr') ``` For data larger than memory, do not write the lazy one-liner `(x - x.mean()) / x.std()`: every output chunk then waits on a full-array reduction, so the scheduler keeps the loaded input chunks in memory until it finishes (with dask 2026.8 a 128 MB Zarr array peaked at ~133 MB that way and ~7 MB in two passes). ### Custom Parallel Workflow ```python from dask.distributed import Client client = Client() # Scatter large dataset once data = client.scatter(large_dataset) # Process in parallel with dependencies futures = [] for param in parameters: future = client.submit(process, data, param) futures.append(future) # Gather results results = client.gather(futures) ``` ## Selecting the Right Component Use this decision guide to choose the appropriate Dask component: **Data Type**: - Tabular data → **DataFrames** - Numeric arrays → **Arrays** - Text/JSON/logs → **Bags** (then convert to DataFrame) - Custom Python objects → **Bags** or **Futures** **Operation Type**: - Standard pandas operations → **DataFrames** - Standard NumPy operations → **Arrays** - Custom parallel tasks → **Futures** - Text processing/ETL → **Bags** **Control Level**: - High-level, automatic → **DataFrames/Arrays** - Low-level, manual → **Futures** **Workflow Type**: - Static computation graph → **DataFrames/Arrays/Bags** - Dynamic, evolving → **Futures** ## Integration Considerations ### File Formats - **Efficient**: Parquet, HDF5, Zarr (columnar, compressed, parallel-friendly) - **Compatible but slower**: CSV (use for initial ingestion only) - **For Arrays**: HDF5, Zarr, NetCDF ### Conversion Between Collections ```python # Bag → DataFrame ddf = bag.to_dataframe() # DataFrame → Array (for numeric data) arr = ddf.to_dask_array(lengths=True) # Array → DataFrame ddf = dd.from_dask_array(arr, columns=['col1', 'col2']) ``` ### With Other Libraries - **XArray**: Wraps Dask arrays with labeled dimensions (geospatial, imaging) - **Dask-ML**: Machine learning with scikit-learn compatible APIs - **Distributed**: Advanced cluster management and monitoring ## Debugging and Development ### Iterative Development Workflow 1. **Test on small data with synchronous scheduler**: ```python dask.config.set(scheduler='synchronous') result = computation.compute() # Can use pdb, easy debugging ``` 2. **Validate with threads on sample**: ```python sample = ddf.head(1000) # Small sample # Test logic, then scale to full dataset ``` 3. **Scale with distributed for monitoring**: ```python from dask.distributed import Client client = Client() print(client.dashboard_link) # Monitor performance result = computation.compute() ``` ### Common Issues **Memory Errors**: - Decrease chunk sizes - Use `persist()` strategically and delete when done - Check for memory leaks in custom functions **Slow Start**: - Task graph too large (increase chunk sizes) - Use `map_partitions` or `map_blocks` to reduce tasks **Poor Parallelization**: - Chunks too large (increase number of partitions) - Using threads with Python code (switch to processes) - Data dependencies preventing parallelism ## Reference Files All reference documentation files can be read as needed for detailed information: - `references/dataframes.md` - Complete Dask DataFrame guide - `references/arrays.md` - Complete Dask Array guide - `references/bags.md` - Complete Dask Bag guide - `references/futures.md` - Complete Dask Futures and distributed computing guide - `references/schedulers.md` - Complete scheduler selection and configuration guide - `references/best-practices.md` - Comprehensive performance optimization and troubleshooting Load these files when users need detailed information about specific Dask components, operations, or patterns beyond the quick guidance provided here.
Comments (0)
Sign in to join the conversation.
Reviews (0)
No reviews yet.
No comments yet.