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

# Massing

> 3D Visualizations of Arterial's information

Massing Simulations help visualize the policies and datasets that Arterial has access to—and allows you to derive insights about your project's potential!

A massing on Arterial is composed of two key components:

* **Typology**: a set of storeys and design elements that define the building's envelope
* **Layout**: the types of units and floor plate-level arrangements within the building

Based on these elements, Arterial can provide insights into:

* **Floor Plate Designs**: rectangular or irregular floor plates with your selected units, optimized for revenue
* **Entitlements**: the probability of a project being approved & potential development precedents
* **Design Details**: basic GFA/GLA information, estimated amenity spaces, and other design elements
* **Finances**: unit rents/sales information, NOI/estimated cap rate, returns, valuation, etc.
* **Construction Costing**: the estimated cost of construction based on Arterial's material modelling

## Quickstart

<Steps titleSize="h3">
  <Step title="Geometry Setup">
    All massing simulations are tied to a project, and can be created by navigating to the <Icon icon="cuboid" color="#FFF" /> **Massing** tab in the sidebar.

    When you click <Icon icon="plus" color="#FFF" /> **New Massing**, you'll be prompted to select your massing's setback lines; these are the lines that inform the building's envelope.

    You can select the *type* of setback using <Icon icon="map-pin" color="#FFF" /> **Select**; click on the greyed out lines on the map to the left to select them.

    <Info>
      These lines will be autofilled based on the other massings in your project;
      click <Icon icon="pencil" color="#FFF" /> **Reset** to change the lines.
    </Info>

    Once all lines are selected, the building envelope will be generated in gray on the map.

    <Frame caption="Setbacks provide the e boundary information for Arterial's simulations.">
      <iframe src="https://player.mux.com/nrOgi7UjHYUn8JWhZyCP45FOhqtjhuKlm18PsghccaU?accent-color=%239c9586&muted=true&voluem=0" allow="accelerometer; gyroscope; autoplay; encrypted-media; picture-in-picture;" allowfullscreen className="w-full aspect-video" />
    </Frame>
  </Step>

  <Step title="Template Selection">
    Arterial has a large selection of pre-defined, customizable massing templates that can be used to speed up your ideation; use the <Icon icon="building" color="#FFF" /> **Select Development Typology** dropdown to choose one.

    <Info>
      You can start from scratch by using one of the **General Templates**,
      highlighted at the top. To add in massing details, skip to the [design
      documentation](#massing-design)
    </Info>

    Once you've selected both, hit <Icon icon="arrow-right" color="#FFF" /> **Continue** to create the massing.

    <Frame caption="All organizational and global templates are shown by default.">
      <iframe src="https://player.mux.com/4hnNm28ETSwiO8Fi1VY8B020200QB4OeiLZkoEv9YApC00E?accent-color=%239c9586&muted=true&voluem=0" allow="accelerometer; gyroscope; autoplay; encrypted-media; picture-in-picture;" allowfullscreen className="w-full aspect-video" />
    </Frame>
  </Step>

  <Step title="Unit & Layout Setup">
    Most templates come with pre-defined amenity spaces for internal layout simulation; you'll need to select the unit types that you'd like to use in the <Icon icon="proportions" color="#FFF" /> **Layout** tab.

    <Frame caption="Just add units to get started with simulations!">
      <iframe src="https://player.mux.com/sHA01dHP3Ipnrdgrc5yPW4E29502Z01JSJ01TUm02oLbB4OI?accent-color=%239c9586&muted=true&voluem=0" allow="accelerometer; gyroscope; autoplay; encrypted-media; picture-in-picture;" allowfullscreen className="w-full aspect-video" />
    </Frame>
  </Step>
</Steps>

## Massing Design

### Core Constructs

Massing typologies are split into two key parts: storey design and window wells. Each storey has a set of levers attached to it—height and stepbacks. Stepbacks aggregate across floor plates, just as they would in architecture.

You can add window wells afterwards in the <Icon icon="cuboid" color="#FFF" /> **Typology** tab. These are defined by three parameters:

* **Length**: the horizontal extent of the window well
* **Side depth**: how deep the window well extends into the building
* **Offset**: the positioning of the window well along the building face

When changing any massing, Arterial will give you the option to save the project to a new copy or the same one. This lets you quickly revert and compare changes between different design iterations.

<Frame caption="Both storeys and window wells can be augmented directly!">
  <iframe src="https://player.mux.com/XZzosde5eRhAE1oJ4SW2k8zyrc7Mcu01u6P7SiY898Rw?accent-color=%239c9586&muted=true&voluem=0" allow="accelerometer; gyroscope; autoplay; encrypted-media; picture-in-picture;" allowfullscreen className="w-full aspect-video" />
</Frame>

### Generative Typologies

Rather than needing to create typologies from scratch, you can also get Arterial to generate certain compliant versions for you by pressing on <Icon icon="sparkles" color="#FFF" /> **Generate**. When prompting, you have two options:

* **Full Generation**: Generate a complete typology by pressing <Icon icon="sparkles" color="#FFF" /> **Generate** after adding your prompt
* **Augmentation**: Make additions to existing typology by pressing <Icon icon="hammer" color="#FFF" /> **Augment**

This AI-powered approach allows you to quickly explore design variations while maintaining compliance with local regulations and best practices.

<Frame caption="Typologies can be augmented with natural language">
  <iframe src="https://player.mux.com/m26Y4J7wtHKU00l9Dksk9KBxh5QuCKu02sAPxhXOuLP00c?accent-color=%239c9586&muted=true&voluem=0" allow="accelerometer; gyroscope; autoplay; encrypted-media; picture-in-picture;" allowfullscreen className="w-full aspect-video" />
</Frame>

### Highest-and-Best-Use

Arterial can take all the policies, precedents, and planning information in the area to come up with its own version of a highest-and-best-use study. This analysis will take slightly longer than other generative forms, but it will produce the envelope that rests inside the maximum extent of the law.

This feature leverages Arterial's comprehensive understanding of local zoning regulations, building codes, and development precedents to automatically generate the most economically viable building envelope for your site.

<Frame caption="Typologies can be automatically maxed out using local constraints">
  <iframe src="https://player.mux.com/ejwxdPsQu2GniY47yx024PKtqZQ8S6QVEE200C001Rd7N4?accent-color=%239c9586&muted=true&voluem=0" allow="accelerometer; gyroscope; autoplay; encrypted-media; picture-in-picture;" allowfullscreen className="w-full aspect-video" />
</Frame>

## Templates & Simulations

### Pre-Defined

Templates are pre-defined massing simulations that come with typologies and layouts. You can add them using the dropdown at the top of the massing sidebar or during setup; all templates are pre-vetted for quality and compliance.

Certain templates—the "Optimal" ones—are intelligent and exist as versions of highest-and-best-use massing based on specific building forms. These templates automatically incorporate local regulations and market conditions to suggest the most viable development approach.

### Custom

To save your own typology as a template for future use, you can click on the template dropdown and add a name. This allows you to build a library of custom typologies that work well for your specific market conditions or design preferences.

Custom templates maintain all the same functionality as pre-defined templates, including the ability to generate layouts, analyze finances, and export information for further development.

## Next Steps

<CardGroup cols={2}>
  <Card title="Configure Unit Layouts" icon="proportions" href="/essentials/layout">
    Set up floor plate arrangements and unit mixes for your massing
  </Card>

  <Card title="Analyze Financial Projections" icon="piggy-bank" href="/essentials/finances">
    Assess the economic and financial viability of your massing design
  </Card>

  <Card title="Conduct Entitlement Study" icon="book-up-2" href="/essentials/entitlements">
    Simulate planning risks and development precedents for your massing
  </Card>

  <Card title="Export Information" icon="cloud-download" href="/workflows/exporting">
    Export your massing, analyses and datasets in a variety of formats
  </Card>
</CardGroup>
