# Tutorial

Welcome to the Perovskite Solar Cell Database tutorial section! This comprehensive guide will help you learn how to work with perovskite solar cell data and compositions in NOMAD.

## Getting Started

If you're new to the perovskite solar cell database, we recommend starting with:

1. **[Sharing a Perovskite Composition](sharing_a_perovskite_composition.md)** - Learn the basics of working with perovskite compositions in NOMAD

## Interactive Notebooks

Our collection of Jupyter notebooks provides hands-on examples demonstrating various aspects of querying, analyzing, and working with perovskite solar cell data.

### Basic Queries

Start with these notebooks to learn how to retrieve data from the NOMAD databases:

- **[Query the Perovskite Database](../notebooks/perla_notebooks/query-perovskite-database.ipynb)** - Retrieve perovskite solar cell data from NOMAD
- **[Query the Ion Database](../notebooks/ions_database/query-ion-database-api.ipynb)** - Access the perovskite ion database
- **[Query Perovskite Compositions](../notebooks/ions_database/query-perovskite-composition.ipynb)** - Search for specific perovskite compositions

### Structure Building

Learn how to construct perovskite structures:

- **[Build Perovskite Structures from Ions](../notebooks/ions_database/build-perovskite-structure-from-ion-entry.ipynb)** - Build crystal structures from ionic components

### Data Analysis

Explore how the field has evolved over time:

- **[Architecture Evolution Analysis](../notebooks/perla_notebooks/architecture-evolution.ipynb)** - Analyze device architecture trends
- **[Bandgap Evolution Analysis](../notebooks/perla_notebooks/bandgap-evolution.ipynb)** - Study bandgap distribution changes
- **[Performance Evolution Analysis](../notebooks/perla_notebooks/performance-evolution.ipynb)** - Track device performance improvements
- **[Diversity Evolution Analysis](../notebooks/perla_notebooks/diversity-analysis.ipynb)** - Examine material composition diversity

### Specialized Tools

Discover advanced analysis tools:

- **[PerovScribe Analysis](../notebooks/perla_notebooks/perovscribe-analysis.ipynb)** - Use PerovScribe for automated data extraction
- **[Perovskite Paperbot Plotting](../notebooks/perla_notebooks/perovskite-paperbot-plot.ipynb)** - Visualize data from automated literature mining

### Machine Learning

Apply machine learning techniques to perovskite data:

- **[CrabNet Bandgap Prediction](../notebooks/perla_notebooks/crabnet-perovskite-bandgap-prediction.ipynb)** - Predict bandgaps using CrabNet
- **[ML Distribution Shift Case Study](../notebooks/perla_notebooks/ml-distribution-shift-case-study.ipynb)** - Understand distribution shift in ML models

## Next Steps

After completing the tutorials, explore the [How-to guides](../how_to/install_this_plugin.md) for practical instructions on specific tasks, or dive into the [Reference documentation](../reference/composition_and_ion_schema.md) for detailed schema information.
