# Managing Maps and Floors

## Adding Additional Maps

Additional maps can be added to Hamina in the **Floor** drop-down menu at the top. Click the **Floor** drop-down menu, and click the **Add a floor** button to add additional maps.

{% hint style="info" %}
Until floors are added to a building, maps don't have any relationship with each other. Instead, they simply exist in the same project. This is useful if you have several single-floor buildings in a campus environment, and want to contain them all in the same project..
{% endhint %}

## Renaming Maps

To rename a map, click on the **Floor** drop-down, point to the floor, and click **Rename**.

<div align="left"><figure><img src="https://1547340717-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzUQ3TfKTYBeb6nf9W8Hv%2Fuploads%2FQUPOXOEL42jaOnEiA8eA%2Frename_map.png?alt=media&#x26;token=d9671d44-705d-4359-bfa7-2d6bb03228a8" alt=""><figcaption></figcaption></figure></div>

### Map Sorting

In the Floor dropdown, maps are sorted numerically/alphabetically in *descending* (largest to smallest) order, which causes the floors to be sorted logically in how they would stack up in a building, for example:

* Floor 4
* Floor 3
* Floor 2
* Floor 1

It is possible to further organize maps with additional names, such as the names of buildings.

{% hint style="info" %}
Note: Only one multi-floor building is supported per project. If you need to design for more than one multi-floor building, then we recommend creating a unique project for each building.
{% endhint %}

#### Map Sorting for Buildings

When floors are added to a building, they are sorted in the map dropdown based on their order in the building, which can override the default map sorting.

<div align="left"><figure><img src="https://1547340717-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzUQ3TfKTYBeb6nf9W8Hv%2Fuploads%2FemlfGlAC0mbovF4Skjke%2Ffloor_reorder.png?alt=media&#x26;token=ef6eed24-d8fe-433f-b095-6afe84718817" alt=""><figcaption><p>Floor 1 is erroneously placed above Floor 2, to illustrate how buildings override default map sorting.</p></figcaption></figure></div>

## Creating a Building

When a map is added to a building, the maps can be stacked up and aligned to form multiple floors.

{% hint style="success" %}
We recommend renaming all of the maps in your project before creating a building and aligning floors, which makes for more organized projects with cleaner deliverables.
{% endhint %}

To add floors to the building for alignment:

1. Ensure that at least one map has the correct scale, and select it with the **Floor** menu at the top.
2. Click on the **Floor alignment** tool in the toolbar on the left.
3. In the **Floor alignment** pane on the left, drag any desired floors into the build area at the top.
4. Drag the floors into the correct order within the building, with the lower floors on the bottom of the list.

<div align="left"><figure><img src="https://1547340717-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzUQ3TfKTYBeb6nf9W8Hv%2Fuploads%2FuaOrhdeNJ0JLyy8PWFtM%2Fadd_floors.gif?alt=media&#x26;token=7182de07-7206-446b-87b4-85093cfe02d2" alt="" width="360"><figcaption></figcaption></figure></div>

## Aligning Floors

Floor alignment is accomplished by dragging the yellow map until it aligns with the black map.&#x20;

* The **black map** is the the current floor, e.g. the map that is selected with the **Floor** menu on the top.
* The <mark style="color:yellow;">**yellow map**</mark> is the floor that is currently being moved and resized. The position and scale of the yellow map is changed in relation to the position and scale of the black map. You can change which map you want to move and resize by clicking on other maps in the **Floor alignment** pane.

<div align="left"><figure><img src="https://1547340717-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzUQ3TfKTYBeb6nf9W8Hv%2Fuploads%2F0f56ZJp0KCqrXebmhxV4%2Falignment_colors.png?alt=media&#x26;token=7d97faa4-e3ad-42f1-9195-37057539a65c" alt=""><figcaption></figcaption></figure></div>

Align the floors by identifying common features between floors, such as elevators and stairwells.

<div align="left"><figure><img src="https://1547340717-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzUQ3TfKTYBeb6nf9W8Hv%2Fuploads%2F9uEUaDM1nDkpmPEv2VNx%2Fdrag_floors_to_align.gif?alt=media&#x26;token=2169309b-0fc9-4fb6-a8df-9bda3f036733" alt="" width="525"><figcaption></figcaption></figure></div>

### Resizing Floors

In addition to clicking and dragging the yellow map around, you can also use the corner handles to resize the map. The <mark style="color:yellow;">**yellow map**</mark> scale will change, respecting the scale of the **black map**.

{% hint style="danger" %}
It's a good idea to set the known scale on an "anchor" floor, select it in the **Floor** dropdown, and use that as the source of truth for scaling in the project.
{% endhint %}

### Floor Height and Attenuation

The height of each floor and the attenuation of each floor is editable. The attenuation value is for the the space between the current floor and the ceiling of the floor below.

Hamina Network Planner models a static floor thickness of 0.5 meters, and calculates loss on a per-meter basis as the RF travels through the floor.

The input value is the total loss for a vertical RF path through the floor, in other words, the shortest possible path through the floor.

The more oblique (slanted) the RF path through the floor is, the longer a distance the RF must travel to get through the floor, and the more loss the signal will experience.

{% hint style="info" %}
**Why doesn't Hamina Network Planner offer floor thickness and loss per meter controls?**

While some tools do offer the ability to configure the exact floor thickness, and to input how many dB of loss per meter the floor has, getting those measurements from a real building is very challenging. The network designer must be able to measure the floor thickness, calculate how much dB of loss there is from floor to floor, and understand how far the RF had to travel to get through the floor (if at an angle) to be able to calculate how many dB of loss per meter there is in the floor.

Hamina decided to take a more practical approach, and accept a simple vertical RF loss value.
{% endhint %}

### Floor Holes&#x20;

Create openings in floors for atriums and lobby's using the Floor Holes tool. This creates a 'hole in the floor' for the currently selected floor. For example, a 4 story building with a ground floor reception lobby open to the roof would need holes added to floors 2, 3 and 4, to create one large opening from the top of the building to the bottom.

## Cropping Maps

Hamina Network Planner supports non-destructive map cropping, so you can change the cropping of the map without modifying the original floor plan image. When a crop is applied, it can be changed back at any time.

Cropping a vector-based map image (such as a PDF or CAD file) will also automatically resample the map. For example, if the background map is a very large warehouse with lots of white space, Hamina Network Planner might accidentally crush the resolution to fit the image within 8000x8000 pixels (the maximum map resolution). Applying a crop to remove whitespace will cause the image to resample, which can dramatically improve or completely fix the resolution of the map.

1. In the **Maps/Floors** menu, point to the desired map and select **Adjust**.<br>

   <div align="left"><figure><img src="https://1547340717-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzUQ3TfKTYBeb6nf9W8Hv%2Fuploads%2F4NrlWazwTOTA90fYI8hC%2Fadjust-menu.png?alt=media&#x26;token=3aa5733d-cf5d-4007-ae0e-60a4c69c35ec" alt="" width="563"><figcaption></figcaption></figure></div>

2. The **Adjust floor plan image** pane will appear on the right. Click the **Crop** button.<br>

   <div align="left"><figure><img src="https://1547340717-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzUQ3TfKTYBeb6nf9W8Hv%2Fuploads%2FMiwf1zk6kixmoRUUP6Uc%2Fcrop-button.png?alt=media&#x26;token=8428c152-9e1e-4dc6-a10e-b6eede7dd585" alt="" width="374"><figcaption></figcaption></figure></div>

3. On the map, either click and drag to create a rectangle, or use the handles on the corners of the crop area to select the desired area to crop.<br>

   <div align="left"><figure><img src="https://1547340717-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzUQ3TfKTYBeb6nf9W8Hv%2Fuploads%2FR1pz5kR2ehAbBwCBhcO0%2Fset-crop-area.png?alt=media&#x26;token=b3485ca6-f279-4bd3-8591-e4a198a4273a" alt=""><figcaption></figcaption></figure></div>

4. At the top center of the select crop area, click the **Apply crop area** button.<br>

   <div align="left"><figure><img src="https://1547340717-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzUQ3TfKTYBeb6nf9W8Hv%2Fuploads%2F8tQs6sJIQVUPPCaJp8vf%2Fapply-crop-area.png?alt=media&#x26;token=a8741df2-ea2e-4a55-b0e8-7dd7eca24aee" alt=""><figcaption></figcaption></figure></div>

## Ceiling Heights

For each map or floor, there is a ceiling height that is set automatically depending on the circumstances of the project. Walls and attenuating objects set to `Ceiling Height` will use this value.

The ceiling height is set by:

1. The minimum ceiling height, which is determined by the project's **Environment Type**:
   1. **Warehouse**: 10 meters (\~33 feet)
   2. **Retail**: 4 meters (\~13 feet)
   3. **Data Center**: 4.5 meters (\~14 feet)
   4. **Airport**: 6 meters (\~20 feet)
   5. **Convention Center**: 8 meters (\~26 feet)
   6. **Factory**: 6 meters (\~20 feet)
   7. **Shopping Mall:** 5 meters (\~16 feet)
   8. **All other environments**: 2.5 meters (8 feet)
2. Pushed upwards by the highest access point, wall, or attenuating object on the map.

Alternatively, the ceiling height can be defined by adding the map to a building, at which point it becomes a floor, and receives the ceiling height setting from the Align Floors tool.
