# Examples

Welcome to the **mp-units** examples collection! These practical, runnable examples demonstrate
how to use the library in real-world scenarios, from simple introductory programs to advanced
domain-specific applications.

## What are Examples?

Examples bridge the gap between learning and doing, showing complete, working applications
that you can study and adapt for your own projects.

These examples:

- ✅ Show complete, runnable code in real-world scenarios
- ✅ Demonstrate library features in context
- ✅ Range from beginner to advanced complexity
- ✅ Are organized by level, system, feature, and domain
- ✅ Work with all [supported compilers](../getting_started/cpp_compiler_support.md)
- ✅ Use [Wide Compatibility](../how_to_guides/integration/wide_compatibility.md) mode for
  maximum portability

**Prerequisites**: Basic familiarity with **mp-units** from [Tutorials](../tutorials/index.md).
Beginner examples include detailed explanations; intermediate and advanced examples assume
fundamental knowledge.

## How to Use This Section?

### Learning Path

Follow examples sequentially by complexity level:

- **Beginner** - Start here if you're new to **mp-units**. Detailed, line-by-line explanations
  of library fundamentals including code structure, headers, and namespaces.

- **Intermediate** - Demonstrate specific features in depth. Skip repetitive boilerplate and
  focus on unique value each example provides.

- **Advanced** - Complex, real-world applications showing how **mp-units** solves challenging
  problems in specialized domains.

### Finding Examples by Tags

Browse the [tag index](tags.md) to filter examples by:

- **Level** - Beginner, intermediate, or advanced
- **System** - SI, CGS, Imperial, Natural, IAU, and more
- **Feature** - Conversions, affine space, custom units, generic programming, and more
- **Domain** - Physics, electronics, aerospace, embedded systems, and more

## When to Use Examples?

Use Examples when you:

- Want to see complete, working applications
- Need inspiration for your own projects
- Want to understand how features work together
- Are looking for patterns to adapt to your use case
- Need domain-specific implementation examples

## Other Resources

- **[Tutorials](../tutorials/index.md)** - Learning-oriented lessons for getting started
- **[User's Guide](../users_guide/index.md)** - Explanation-oriented understanding of concepts
- **[How-to Guides](../how_to_guides/index.md)** - Task-oriented solutions to specific problems
- **[Workshops](../workshops/index.md)** - Practice advanced patterns with hands-on exercises
- **[Reference](../reference/index.md)** - Information-oriented technical descriptions