# Hierarchical data structures

> For the complete documentation index, see [llms.txt](https://kotlin.github.io/dataframe/llms.txt).

[DataFrame](dataframe.html) can represent hierarchical data structures using two special types of columns:

API reference: [ColumnGroup](https://kotlin.github.io/dataframe/api-docs/core/org.jetbrains.kotlinx.dataframe.columns/-column-group/index.html), [FrameColumn](https://kotlin.github.io/dataframe/api-docs/core/org.jetbrains.kotlinx.dataframe.columns/-frame-column/index.html), [ValueColumn](https://kotlin.github.io/dataframe/api-docs/core/org.jetbrains.kotlinx.dataframe.columns/-value-column/index.html)

* [ColumnGroup](datacolumn.html#columngroup) is a group of [columns](datacolumn.html)

* [FrameColumn](datacolumn.html#framecolumn) is a column of [dataframes](dataframe.html)

You can read [DataFrame](dataframe.html) [from json](read.html#read-from-json) or [from in-memory object graph](createdataframe.html#todataframe) preserving original tree structure.

Hierarchical columns can also appear as a result of some [modification operations](modify.html):

* [group](group.html) produces [ColumnGroup](datacolumn.html#columngroup)

* [groupBy](groupby.html) produces [FrameColumn](datacolumn.html#framecolumn)

* [pivot](pivot.html) may produce [FrameColumn](datacolumn.html#framecolumn)

* [split](split.html) of [FrameColumn](datacolumn.html#framecolumn) will produce several [ColumnGroup](datacolumn.html#columngroup)

* [implode](implode.html) converts [ColumnGroup](datacolumn.html#columngroup) into [FrameColumn](datacolumn.html#framecolumn)

* [explode](explode.html) converts [FrameColumn](datacolumn.html#framecolumn) into [ColumnGroup](datacolumn.html#columngroup)

* [merge](merge.html) converts [ColumnGroup](datacolumn.html#columngroup) into [FrameColumn](datacolumn.html#framecolumn)

* etc.

Operations in the navigation tree are grouped such that you can find operations and their respective inverse together, like `group` and `ungroup`. This allows you to quickly find out how to simplify any hierarchical structure you come across.

