> For the complete documentation index, see [llms.txt](https://docs.fabricplan.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fabricplan.com/planning-sheets/how-tos/measure-and-row-based-planning/measure-based-modelling.md).

# Measure-based modeling

Measure modeling is used to organize the measures defined in a semantic model into a hierarchical structure that reflects business performance. This type of modeling enables users to analyze how changes in one measure propagate through related measures. For example, if there is a change in material cost, you get to see the changes cascading up to the net profit level.

Typically, when the measures are placed in the value field, they are displayed as column items. It is difficult to create a hierarchy for measures and analyze the performance. A Measure Model addresses this limitation by allowing you to build a measure hierarchy that can be applied across all row category items.

**Using a Measure Model, you can:**

* Organize measures according to business requirements.
* Perform planning and simulations at the measure level.
* Analyze the cascading impact of changes across the hierarchy in a single view.

### Configure measure-based model

1. Create a planning model by assigning **row** fields, **column** fields, and measures under the **value** field.

Consider the revenue model in the following image.

<figure><img src="https://257222532-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUtolck8kt8atqxFPsEBn%2Fuploads%2FihawkXNziwX9J36oFpp2%2F1%20-%20Assigning%20fields.png?alt=media&amp;token=a1ff0695-d670-4e58-9ce2-304b8ed3362a" alt=""><figcaption></figcaption></figure>

2. Navigate to the **Model** ribbon and select **Measure Model.**

<figure><img src="https://257222532-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUtolck8kt8atqxFPsEBn%2Fuploads%2FhADfya7WwyNtoJjiRQI1%2F2.%20Measure%20model%20option.png?alt=media&amp;token=d158c851-1ac6-4c23-a698-d5b0b38a57ba" alt=""><figcaption></figcaption></figure>

3. The Measure model canvas opens, displaying all the measures assigned to the planning sheet.

<figure><img src="https://257222532-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUtolck8kt8atqxFPsEBn%2Fuploads%2Fke6CSMZmhiL6anSS9DaX%2F3.%20Measures%20list.png?alt=media&amp;token=2803a2c7-c2ca-4529-ae21-3f7261773aea" alt=""><figcaption></figcaption></figure>

4. Now you can create the required hierarchy using the measures list. Select **Add measure** > **Formula.**

<figure><img src="https://257222532-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUtolck8kt8atqxFPsEBn%2Fuploads%2FdE4DJcRXaWHluSkGtEDx%2F4.%20Formula%20measure.png?alt=media&amp;token=3fa1f137-4f36-470b-89e3-f5515dd038b6" alt="" width="375"><figcaption></figcaption></figure>

5. In the side panel, enter the title as *Gross Revenue* and define the formula as: `Sales Volume * Avg Selling Price`.
6. Select **Create**.

<figure><img src="https://257222532-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUtolck8kt8atqxFPsEBn%2Fuploads%2FKKOoQ3rd0Lh0CJ03YGge%2F5.%20Gross%20Revenue.png?alt=media&amp;token=f3ccd500-c7d6-4a1d-9108-2e61b74f5265" alt="" width="375"><figcaption></figcaption></figure>

7. The newly created *Gross Revenue* measure is added to the measures list. Drag the *Gross Revenue* measure onto the top section of the canvas to create a hierarchy.

<figure><img src="https://257222532-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUtolck8kt8atqxFPsEBn%2Fuploads%2F00L6uwZFn47WQXUTKYPK%2F6.%20Assigning%20Gross%20Revenue.png?alt=media&amp;token=75771f9c-eed9-4dc9-833c-c110753c8807" alt=""><figcaption></figcaption></figure>

8. Gross Revenue is now available on the canvas screen. Select *Sales Volume* and *Avg Selling Price* from the measure list. From the **Insert Measure** list, select Gross Revenue and select **Insert.**

<figure><img src="https://257222532-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUtolck8kt8atqxFPsEBn%2Fuploads%2FQeSez9qA1dxzOZ07NZuq%2F7.%20Configuring%20Volume%20and%20Price.png?alt=media&amp;token=2c3e6303-e2bb-4208-b833-3923a380f627" alt=""><figcaption></figcaption></figure>

9. The measures are now placed as child rows under Gross Revenue. This creates a *Gross Revenue* measure hierarchy.

<figure><img src="https://257222532-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUtolck8kt8atqxFPsEBn%2Fuploads%2FAclJXnLJcfuFSQpDFw7y%2F8.%20Gross%20Revenue%20hierarchy.png?alt=media&amp;token=1d1945a1-cc83-4656-8b39-e8f9bbee7157" alt=""><figcaption></figcaption></figure>

10. Now, drag and drop the *Discount and Returns* measure to the **Drop from measure list** section. This measure is added outside of the *Gross Revenue* hierarchy as a sibling of the *Gross Revenue* measure.

<figure><img src="https://257222532-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUtolck8kt8atqxFPsEBn%2Fuploads%2FFmNFsNIuP1F5MKI548Eu%2F9.%20Assigning%20Discount%20and%20Returns.png?alt=media&amp;token=f44e1b6b-ca5c-43fc-b92f-038bba4934c8" alt=""><figcaption></figcaption></figure>

All the measures are now part of the canvas.

<figure><img src="https://257222532-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUtolck8kt8atqxFPsEBn%2Fuploads%2FdJ6NVf9Hz4hQyFM4ihZs%2F10.%20All%20measures.png?alt=media&amp;token=a7a6c683-a576-4a59-bce4-b6d9a4b244d8" alt=""><figcaption></figcaption></figure>

To create any measure hierarchy and complete the model, follow these steps 4 through 10.

11. Select **Add measure** and select **Formula** again. Enter the title as *Net Revenue* and define the formula as, `Gross Revenue - Discount and Returns`. Select **Create**.

<figure><img src="https://257222532-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUtolck8kt8atqxFPsEBn%2Fuploads%2Fy7uGdE3mb7hN2ZK8jBlN%2F11.%20Net%20Revenue.png?alt=media&amp;token=a4d6c66b-ebf6-4655-8d28-3c886e321660" alt="" width="375"><figcaption></figcaption></figure>

12. Drag the *Net Revenue* measure onto the canvas. Drag the *Gross Revenue* measure below *Net Revenue* until it snaps into place as its child. Repeat this step for the *Discount and Returns* measure so that both measures appear as children of **Net Revenue**.

<figure><img src="https://257222532-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUtolck8kt8atqxFPsEBn%2Fuploads%2Fi903C497oRbY04VMntad%2F12.%20Net%20Revenue%20hierarchy.png?alt=media&amp;token=65cdc021-8acf-4751-a64d-c8ea26f984b5" alt=""><figcaption></figcaption></figure>

13. Once the *Net revenue* measure hierarchy is created, select **Back to Home** in the toolbar.

<figure><img src="https://257222532-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUtolck8kt8atqxFPsEBn%2Fuploads%2FJljgPvqziVKHypdf9p7C%2F13.%20Navigation%20to%20main%20screen.png?alt=media&amp;token=1f34295f-a9d4-453c-9ff4-ddeedbb57dac" alt=""><figcaption></figcaption></figure>

14. To display the measures in rows, in the **Planning** screen, select **Layout**, and under **Measures,** select **In Rows.**

<figure><img src="https://257222532-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUtolck8kt8atqxFPsEBn%2Fuploads%2FVNFh5ZziLK5AKYSQBd0K%2F14.%20Measures%20in%20Rows.png?alt=media&amp;token=51cc45bb-0ac4-4823-ad4a-df706015cfa5" alt=""><figcaption></figcaption></figure>

15\. The measures are now displayed in a hierarchical structure under each row category.

<figure><img src="https://257222532-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUtolck8kt8atqxFPsEBn%2Fuploads%2FecjuH8XQXvOU7mtsKUpZ%2F15.%20Measure%20model.png?alt=media&amp;token=86fb9fcf-90b2-431b-a56a-2dc9b497388e" alt=""><figcaption></figcaption></figure>

#### How the Measure model helps analyze business performance

A Measure Model automatically cascades simulation impacts through both the measure hierarchy and the row hierarchy. This enables users to understand how changes in business drivers affect overall performance.\
For example, suppose the sales volume of *Brazil* is increased through simulation; the impact is reflected in *Brazil*'s gross revenue and net revenue. The impact can also be seen on its parent *Latin America* up till the top level.

You can create multiple scenarios and perform simulations. These scenarios can be compared to understand which driver yields better performance for the business.

### Creating scenarios and perform simulations

This section explains the steps to create a scenario and perform simulations in a measure model to understand the impact on the overall business performance.

1. Once the measure model is created, in the **Planning** ribbon, select **Layout** and select **Tree**.

<figure><img src="https://257222532-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUtolck8kt8atqxFPsEBn%2Fuploads%2FW0vpl0159jtZQ9c8g4kM%2F16.%20Navigating%20to%20Tree%20Layout.png?alt=media&amp;token=d0151059-87f5-4594-8467-f223fbb0da26" alt=""><figcaption></figcaption></figure>

2. The model is displayed in a tree structure expanding from the grand total through regions, countries, and the measure hierarchy.

<figure><img src="https://257222532-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUtolck8kt8atqxFPsEBn%2Fuploads%2FdfGXWG5YCXO2bXdNslvF%2F17.%20Tree%20Layout.png?alt=media&amp;token=7fc0ef28-2a26-41c9-b580-637427bf7b69" alt=""><figcaption></figcaption></figure>

3. In the **Tree View** ribbon, select **Display** and toggle off **Show Header KPI** for a cleaner view.

<figure><img src="https://257222532-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUtolck8kt8atqxFPsEBn%2Fuploads%2Fc2MEwoD1hq46XORK6wQD%2F18.%20Show%20header%20KPI.png?alt=media&amp;token=84995710-5edb-4a20-9355-2f160d7d1349" alt=""><figcaption></figcaption></figure>

4. Select **Create New Scenario** from the ribbon. Enter the **Scenario name** as "Best Case"**.**

<figure><img src="https://257222532-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUtolck8kt8atqxFPsEBn%2Fuploads%2FAmS9p00KJBKpRjqTeHAe%2F19.%20Creating%20new%20scenario.png?alt=media&amp;token=19ef67ed-fa98-4cd8-afdb-00cf7d864a16" alt=""><figcaption></figcaption></figure>

5. Select any node in the tree, the simulation panel appears on the side. You can perform simulation by either entering simulation % or using a slider.\
   For example: For the *United States* node, apply the following changes:

* Sales Volume: 5%
* Avg Selling price: 3%
* Discount and Returns: -2%

{% hint style="info" %}
**NOTE**\
\
You can either enter a simulation % or simulation value by just selecting the value section.
{% endhint %}

<figure><img src="https://257222532-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUtolck8kt8atqxFPsEBn%2Fuploads%2Fmsk6dzwtQ1aTsQ3LpBbD%2F20.%20Performing%20simulations.png?alt=media&amp;token=9715d9ee-5de1-42f8-95c1-5d576811f372" alt=""><figcaption></figcaption></figure>

6. The simulation results automatically cascade through *Gross Revenue* and *Net revenue* at the measure level and to *North America* at the parent level. Select the down arrow to expand and see all the measures listed for each node in a hierarchical format.

<figure><img src="https://257222532-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUtolck8kt8atqxFPsEBn%2Fuploads%2FNvPzwqIwv63J3I8iOsYP%2F21.%20Simulation%20impact.png?alt=media&amp;token=dbdfc8fe-acf1-4d94-832f-345fa1d71f2a" alt=""><figcaption></figcaption></figure>

7. Repeat the process to create multiple scenarios and compare them to determine which business drivers produce the best performance.

<figure><img src="https://257222532-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUtolck8kt8atqxFPsEBn%2Fuploads%2FwDKGRqqFg4MG8XbhlPt2%2Fimage.png?alt=media&amp;token=dcf51611-bf1e-401a-83e3-87d9cd51c00e" alt=""><figcaption></figcaption></figure>

### Benefits of measure model

A measure model helps organizations:

* Organize measures into meaningful business hierarchies.
* Perform simulations at the measure level.
* Visualize the cascading impact of changes across measures and dimensions.
* Improve planning and decision-making with a consolidated hierarchical view of business performance.

### Related Content

For FAQ's of measure model, you can refer to this [section](/resources/plan-preview-frequently-asked-questions/measure-model.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.fabricplan.com/planning-sheets/how-tos/measure-and-row-based-planning/measure-based-modelling.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
