Hotel operating metrics (USALI)
calc_hotel_metricsRead-onlyIdempotent
Occupancy, ADR, RevPAR, TRevPAR, and a USALI-style profit ladder for a period: departmental profit, GOP and margin, GOPPAR, management fees, EBITDA, FF&E reserve, and NOI (EBITDA less replacement reserve). Deterministic: use this instead of doing the math yourself; cite formula calc.hotel_metrics@1 and the returned steps, and surface any warnings.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| rooms | Yes | Rooms in inventory (keys). | |
| nights | Yes | Nights in the period, e.g. 365 for a year or 30 for a month. | |
| fb_revenue | No | Food and beverage revenue, USD (USALI Food and Beverage department revenue). | |
| rooms_sold | Yes | Room-nights occupied by paying guests in the period (USALI: rooms sold, excluding complimentary rooms). | |
| room_revenue | Yes | Rooms revenue for the period, USD (USALI Rooms department revenue, net of taxes and allowances). | |
| other_revenue | No | Other operated departments plus miscellaneous income, USD (USALI Other Operated Departments and Miscellaneous Income). | |
| ffe_reserve_rate | No | FF&E replacement reserve as a share of total operating revenue, e.g. 0.04 (USALI Replacement Reserve, below EBITDA). | |
| rooms_out_of_order | No | Room-nights (rooms × nights, not rooms) taken off the market in the period, e.g. 20 rooms closed for a 30-night renovation = 600. Subtracted from rooms × nights to give rooms available. USALI (11th ed.) keeps short-term out-of-order rooms in rooms available; include only rooms formally removed from sale. | |
| management_fee_rate | No | Base management fee as a share of total operating revenue, e.g. 0.03 (USALI Management Fees). | |
| management_fee_fixed | No | Fixed or incentive management fee for the period, USD, added to the percentage fee (USALI Management Fees). | |
| departmental_expenses | No | Total departmental expenses, USD: rooms, F&B, and other operated departments (USALI Total Departmental Expenses). | |
| non_operating_expenses | No | Property taxes, insurance, ground rent, and other non-operating expenses, USD (USALI Non-Operating Income and Expenses). | |
| undistributed_expenses | No | Total undistributed operating expenses, USD: administrative and general, information and telecommunications, sales and marketing, property operation and maintenance, utilities (USALI Total Undistributed Operating Expenses). |