# Examples

Practical code examples demonstrating Nicole's capabilities.

## Getting Started

New to Nicole? Start here:

- **[First Tensor](basic/first-tensor.md)**: Create your first symmetry-aware tensor
- **[Arithmetic Operations](basic/arithmetic.md)**: Add, subtract, and scale tensors
- **[Indexing and Blocks](basic/indexing.md)**: Access and manipulate tensor blocks

## Symmetries

Learn to work with different symmetry groups:

- **[U1 Examples](symmetries/u1-examples.md)**: Particle number conservation
- **[Z2 Examples](symmetries/z2-examples.md)**: Parity and binary symmetries  
- **[Product Groups](symmetries/product-examples.md)**: Multiple simultaneous symmetries

## Operations

Master tensor operations:

- **[Contraction](operations/contraction-examples.md)**: Contract, trace, and multiply tensors
- **[Decomposition](operations/decomposition-examples.md)**: SVD and tensor decomposition
- **[Manipulation](operations/manipulation-examples.md)**: Permute, transpose, conjugate

## Advanced

For experienced users:

- **[Custom Operators](advanced/custom-operators.md)**: Build physical operators with symmetries
- **[Performance Tips](advanced/performance.md)**: Optimize your code

## Example Format

Each example page includes:

1. **Complete runnable code**
2. **Step-by-step explanations**
3. **Expected output**
4. **Links to API reference**

## Running Examples

All examples assume Nicole is installed:

```python
pip install -e .
```

Then copy-paste code directly into Python or Jupyter notebooks.

## Contributing Examples

Have an interesting use case? Contributions welcome! See the [GitHub repository](https://github.com/Ideogenesis-AI/Nicole) to submit examples.

## See Also

- [API Reference](../api/index.md): Complete function documentation
- [Getting Started](../getting-started.md): Tutorial introduction
- [Tutorials](../tutorials/index.md): In-depth guides
