# Story

![](/files/-MihrbXJ4U-MRIUJUDfq)

![](/files/-MihrbHzPzHSq7S7wd4K) - [\[source code\]](https://github.com/ladybug-tools/dragonfly-grasshopper/blob/master/dragonfly_grasshopper/src//DF%20Story.py)

Create a Dragonfly Story from individual Dragonfly Room2D objects.

## Inputs

* **room2ds \[Required]**

  A list of Dragonfly Story objects to be joined into one Building.&#x20;
* **flr\_to\_flr**

  A number for the distance from the floor plate of this Story to the floor of the story above this one (if it exists). If None, this value will be the maximum floor\_to\_ceiling\_height of the input \_room\_2ds.&#x20;
* **flr\_height**

  A number for the absolute floor height of the Story. If None, this will be the minimum floor height of all the Story's room\_2ds, which is suitable for cases where there are no floor plenums. (Default: None).&#x20;
* **name**

  Text to set the name for the Story, which will also be incorporated into unique Story identifier. If the name is not provided a random one will be assigned.&#x20;
* **multiplier**

  An integer with that denotes the number of times that this Story is repeated over the height of the building. Default: 1.&#x20;
* **constr\_set**

  Text for the construction set of the Story, which is used to assign all default energy constructions needed to create an energy model. Text should refer to a ConstructionSet within the library such as that output from the "HB List Construction Sets" component. This can also be a custom ConstructionSet object. If nothing is input here, the Story will have a generic construction set that is not sensitive to the Story's climate or building energy code.&#x20;

## Outputs

* **report**

  Reports, errors, warnings, etc.&#x20;
* **story**

  Dragonfly Building.&#x20;


---

# Agent Instructions: 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:

```
GET https://docs.ladybug.tools/dragonfly-primer/components/0_create/story.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
