> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kamu.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Examples

> Sample data projects executed with kamu

export const Diagram = ({src, alt}) => {
  return <div style={{
    display: "flex",
    "flex-direction": "column",
    "align-items": "center"
  }}>
    <img src={src} alt={alt} style={{
    background: "#dddddd",
    "margin-bottom": 0
  }} />
    <span>{alt}</span>
  </div>;
};

export const YouTubeList = ({id}) => {
  const src = `https://www.youtube.com/embed/videoseries?list=${id}`;
  return <iframe className="w-full aspect-video rounded-xl" src={src} allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen></iframe>;
};

export const YouTube = ({id, width}) => {
  const src = `https://www.youtube.com/embed/${id}`;
  return <iframe className="w-full aspect-video rounded-xl" src={src} allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen width={width}></iframe>;
};

export const Schema = ({t, id}) => {
  const anchor = id ? id : t.toLowerCase().replace(/\s+/g, "-");
  const link = `/odf/schemas#${anchor}`;
  return <a class="schema-object" href={link}>{t}</a>;
};

export const Term = ({t, id}) => {
  const anchor = id ? id : t.toLowerCase().replace(/\s+/g, "-");
  const link = `/general/glossary#${anchor}`;
  return <a class="glossary-term" href={link}>{t}</a>;
};

## Guided Examples

| Name                                                   |     Level    |                               Topics                              |
| ------------------------------------------------------ | :----------: | :---------------------------------------------------------------: |
| [Self-serve Tutorial](/start/tutorial)                 |   Beginner   |                           basic commands                          |
| [Currency Conversion](/examples/currency-conversion)   |   Beginner   |                        temporal-table joins                       |
| [COVID-19 Daily Cases](/examples/covid19)              |   Beginner   |   harmonization, unions, tumbling window aggregations, notebooks  |
| [Leaderboard](/examples/leaderboard)                   |   Beginner   |                  top-n aggregations, push ingest                  |
| [Housing Prices](/examples/housing-prices)             |   Beginner   |           GIS data, GIS functions, GIS joins, notebooks           |
| [Stock Market Trading](/examples/stock-trading)        | Intermediate |     aggregations, temporal-table joins, watermarks, notebooks     |
| [Overdue Order Shipments](/examples/overdue-shipments) | Intermediate |                 stream-to-stream joins, watermarks                |
| [Web3 Data](/examples/web3-data)                       | Intermediate | repositories, temporal-table joins, stream processing, watermarks |

To work with examples we recommend you to clone the [kamu-cli repo](https://github.com/kamu-data/kamu-cli) and use directories in `examples/` as your workspaces.

For instance:

```bash theme={null}
git clone https://github.com/kamu-data/kamu-cli.git
cd kamu-cli/examples/currency_conversion

kamu init
kamu add . -r
kamu pull --all
```

## Miscellaneous

| Name                                                                                   | Description                                                                                  |
| -------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- |
| [MQTT ingest](https://github.com/kamu-data/kamu-cli/tree/master/examples/mqtt)         | Shows how to ingest MQTT data using publicly available Mosquitto broker                      |
| [FlightSQL API](https://github.com/kamu-data/kamu-cli/tree/master/examples/flight-sql) | Examples of connecting to Kamu via FlightSQL protocol using a variety of different libraries |

## Need More Examples?

The wild variety of formats and ways to model data used by the data publishers today often makes ingesting data a challenge. When you work with the data that is already in the ODF network you feel like a productive data scientist, but until publishers start using this format directly we'll have to continue wasting time on dull tasks like parsing CSVs, inferring schemas, and cleaning data.

To give you more examples on how to deal with **different ingest scenarios** we've created an [experimental repository](https://github.com/kamu-data/kamu-contrib) where we publish dataset manifests for a variety of Open Data sources.

<Tip>
  Stuck on parsing a yet another variety of timestamps? Confused on how to change projection of the GIS data when reading ESRI file? Then check out [`kamu-contrib`](https://github.com/kamu-data/kamu-contrib) repo.
</Tip>