Metadata-Version: 2.4
Name: floorplan
Version: 0.1.0
Summary: Lightweight Python utility for architectural floor area modeling, usable area calculations, and room management.
Author-email: Rylse Solutions <hello@rylse.com>
License-Expression: MIT
Keywords: floorplan,architecture,usable-area,cad,proptech,real-estate,room-dimensions
Requires-Python: >=3.8
Description-Content-Type: text/markdown

# 📐 floorplan

A lightweight, zero-dependency Python utility for structuring architectural floor plans, managing rooms, computing usable floor area (including attic slopes), and checking room distributions.

## ⚡ Installation

```bash
pip install floorplan
```

## 🚀 Quickstart

```bash
import floorplan

plan = floorplan.FloorPlan(name="Apartment 4B")

# Add standard rectangular rooms (length, width in meters)
plan.add_room("Living Room", length=5.5, width=4.0)
plan.add_room("Bedroom", length=4.0, width=3.2)
plan.add_room("Bathroom", length=2.5, width=2.0)

# Add attic room with sloped ceiling calculation
# (e.g. 20 sqm total floor area, but 5 sqm has height < 1.4m and 3 sqm is 1.4m - 2.2m)
plan.add_sloped_room(
    name="Attic Studio",
    total_floor_area=20.0,
    area_below_140cm=5.0,
    area_between_140_and_220cm=3.0
)

print(f"Total Gross Floor Area: {plan.total_gross_area:.2f} m²")
print(f"Total Usable Area: {plan.total_usable_area:.2f} m²")
print(plan.room_breakdown())
```

## ⚠️ Disclaimer
This package provides mathematical modeling for spatial layouts. It does not replace licensed architectural surveying, certified construction obmiar standards, or local building code verifications. Always consult a certified architect or surveyor for official legal documentation.
