Concept 4E Building Entry
Deterministic facade-entry estimates, standard-derived O2I scenarios, material evidence, API behavior, and canonical audit.
Concept 4E is a bounded analysis for the question: “What is the
estimated signal immediately inside a representative building facade?”
It is available at 2.6 GHz and 28 GHz. It does not turn the building
dataset into an indoor radio map, a floor/room model, or a
whole-building coverage claim. The 140 GHz research_sub_thz
profile remains outside this concept.
Boundary and no-double-counting rule
Concept 4E evaluates a two-stage link:
- Use the Concept 4D
urban_short_rangeUMa outdoor LOS/NLOS median baseline from the serving cell to a representative facade point. - Subtract one standard O2I external-wall entry term at a receiver placed at zero indoor depth immediately inside that facade.
The facade target is not treated as an outdoor wall event.
Outdoor-to-outdoor NLOS already uses the Concept 4D empirical NLOS
formula, so Concept 4E does not add the legacy per-wall loss to that
outdoor baseline. The response reports
outdoor_wall_loss_db: 0 for this reason. The entry term is
applied once, separately, as low_loss and
high_loss scenarios.
There is no interior-room, floor, interior-wall, reflection, fast-fading, building-height, or whole-building inference. The receiver height is the configured per-cell receiver height. The result is one deterministic estimate per selected building, served by the strongest eligible cell under the low-loss scenario; the response retains both scenario powers.
Standard-derived loss model
The reference is 3GPP TR 38.901 V19.4.0, §7.4.3.1, “O2I building penetration loss.” The standard writes the O2I path loss as:
PL = PL_b + PL_tw + PL_in + X_sigma
where PL_b is the basic outdoor path loss,
PL_tw is external-wall loss, PL_in is
depth-dependent indoor loss, and X_sigma is penetration
shadowing. Concept 4E uses the deterministic median
(X_sigma = 0) and sets d2D-in = 0 m, so
PL_in = 0 dB. Its implemented link budget is therefore:
P_outdoor_facade = Concept 4D UMa LOS/NLOS received power
P_low_inside = P_outdoor_facade - PL_tw_low
P_high_inside = P_outdoor_facade - PL_tw_high
For 28 GHz, the standard material terms are evaluated with
f in GHz:
L_glass = 2 + 0.2 f
L_IRRglass = 25.4 + 0.11 f
L_concrete = 5 + 4 f
The two reference compositions are:
PL_tw_low = 5 - 10 log10(0.3 * 10^(-L_glass/10)
+ 0.7 * 10^(-L_concrete/10))
PL_tw_high = 5 - 10 log10(0.7 * 10^(-L_IRRglass/10)
+ 0.3 * 10^(-L_concrete/10))
At 28 GHz these evaluate to 17.8287874527 dB and
35.0290195972 dB. At 2.6 GHz the implementation uses the
standard’s UMa/UMi single-frequency backward-compatibility value from
Table 7.4.3-3: PL_tw = 20 dB and
PL_in = 0.5 * d2D-in. Because Concept 4E fixes indoor depth
at zero, its low/high API scenarios are equal at 2.6 GHz
(20 dB each). The standard’s reference sigmas are exposed
as metadata, but no random draw is sampled.
The standard’s material composition is a simulation parameter
dependent on metal-coated glass, regional market, and deployment
scenario. A.T.O.M. does not invent that mapping from a generic OSM
building type. Known tags are returned as optional evidence only; they
never select one profile automatically. If material evidence is absent
or not defensibly mapped, both profiles remain in the response and
selected_entry_profile is unknown.
Geometry and deterministic selection
The backend evaluates one HTTP request containing the selected cell RF profiles and the building filter. It then:
- sorts cells and footprints by stable ID;
- selects footprints inside the effective per-cell radius union,
unless an explicit
building_idsfilter is supplied; - obtains a representative interior point from the polygon centroid when it is inside, then a vertex average, then a deterministic 15×15 interior grid;
- finds the first true outside-to-inside crossing from the cell to that point;
- rejects invalid polygons, tangent-only contacts, boundary-only points, and unclassifiable outdoor paths;
- classifies blockers before the target facade as outdoor LOS/NLOS and excludes the target building from the blocker test;
- evaluates the Concept 4D outdoor baseline and applies the two entry losses.
The response identifies the point sources and includes the facade
coordinate, outdoor LOS state, outdoor received power, both entry
losses, both just-inside powers, serviceability flags, material
evidence, and limitations for each building. The -100 dBm
building-service threshold and each cell’s receiver sensitivity are
reported separately; they are not interchangeable.
Geometry regression fixtures cover rectangular, concave, multipart/decomposed, centroid-outside, invalid, and tangent cases. GeoJSON holes are not inferred as interior rooms: the existing runtime footprint representation uses outer rings, and Concept 4E makes no claim beyond the selected representative facade point.
API
POST /api/building-entry-analysis accepts the
network-shaped RF defaults and one to six selected cells. The request is
batched; it does not issue one HTTP request per building.
{
"towers": [
{
"id": "cell-28-a",
"tower_lon": 32.8541,
"tower_lat": 39.9208,
"azimuth": 45,
"rf_profile": {
"schema_version": 1,
"network_tech": "5g",
"propagation_model": "urban_short_range",
"frequency_ghz": 28,
"band": "n257",
"bandwidth_mhz": 100,
"channel_id": "NR-634666",
"duplex_mode": "tdd",
"tx_power_dbm": 30,
"antenna_gain_dbi": 17,
"system_loss_db": 2,
"radius_m": 400,
"beam_width": 120,
"antenna_height_m": 25,
"receiver_height_m": 1.5,
"receiver_sensitivity_dbm": -115
}
}
],
"rays": 72,
"radius_m": 400,
"frequency_ghz": 28,
"tx_power_dbm": 30,
"beam_width": 120,
"calibration_offset_db": 0,
"residential_only": false,
"building_ids": []
}The endpoint returns model, applicability,
summary, per-building results, per-cell
summaries, effective profiles, rf_contract, and
diagnostics.
diagnostics.http_requests_required is 1; the
frontend stores the response under an RF-derived source key containing
effective cell profiles, coordinates, azimuths, dataset revision, and
filters.
Concept 4E results are invalidated when frequency, power, beam, antenna/RF profile, azimuth, selected cells, tower inventory, or dataset revision changes. Optimization priorities alone do not invalidate them because they do not change the RF payload. A successful azimuth/network optimization does invalidate the prior entry result because it changes effective RF state. The analysis is diagnostic/reporting output only; it is not an optimizer objective, constraint, score term, or candidate-site coupling.
Data audit
The active Ankara Open Planning Dataset is version
2026.07. Its manifest contains 451 towers and 161,626
building GeoJSON features; the runtime index contains 161,784 outer-ring
footprints after multipart decomposition. Dataset validation reported
zero invalid, repaired, or dropped building geometries.
The material audit scans building:material,
facade:material, material, and
roof:material. The canonical Ankara pack contains no usable
material metadata in those fields, so Concept 4E reports 0 known and
100% unknown for that pack. Building type and residential/demand
attributes remain useful for filtering and weighting, but they do not
become material composition.
Canonical six-cell Ankara audit
The gated regression fixture uses the existing six-cell 28 GHz Ankara
network scenario, with deterministic repeated execution and the active
dataset. The following values are from the measured run on 17 September
2026. The analyzed building domain is
summary.relevant_buildings, which includes all selected
relevant footprints. summary.relevant_residential_buildings
is a subset used for residential reporting; it is not the denominator
for the all-building service rows. A service numerator includes only
buildings with an applicable, valid facade estimate that meets the
relevant threshold; unsupported buildings remain in the denominator but
cannot enter the numerator.
| Metric | Result |
|---|---|
| Analyzed buildings (all relevant footprints) | 1,488 |
| Residential buildings (subset) | 899 |
| Valid facade estimates | 675 / 1,488 |
| Outdoor service — all buildings | 675 / 1,488 |
| Low-loss entry — all buildings | 675 / 1,488 |
| High-loss entry — all buildings | 253 / 1,488 |
| Low-loss served demand weight | 2,175.000 |
| High-loss served demand weight | 440.000 |
| Material-known / material-unknown | 0 / 1,488 |
| Unsupported/no eligible serving cell | 813 |
| Invalid geometry | 0 |
| Candidate cell-link evaluations | 698 |
| Analysis runtime (observed) | 34.8 ms |
| HTTP requests required | 1 |
Unsupported reason breakdown
The unsupported count is derived from the implementation applicability status, not from a free-text interpretation. The canonical breakdown is:
| Applicability reason | Count | Share of unsupported | Representative building |
|---|---|---|---|
no_eligible_serving_cell |
813 | 100.00% | feature-104140 |
There were no invalid_geometry records in this run. The
dominant status is an intentional aggregate result for buildings where
no selected cell produced a valid eligible facade baseline under the
configured radius/beam contract; it is not evidence that invalid
geometry or a propagation-model fallback was hidden.
Representative ledger rows from the same run:
| Case | Building | Serving cell | Outdoor facade Rx | Low-loss Rx | High-loss Rx |
|---|---|---|---|---|---|
| Strong facade signal | feature-7237 |
LTE-35104 |
-33.620 dBm | -51.448 dBm | -68.649 dBm |
| Near threshold | feature-9613 |
LTE-313110 |
-79.950 dBm | -97.778 dBm | -114.979 dBm |
| Low-loss pass / high-loss fail | feature-101294 |
LTE-35877 |
-87.441 dBm | -105.269 dBm | -122.470 dBm |
No known-material row or both-scenarios-fail row occurred among the selected canonical targets; those are intentionally reported as absent rather than fabricated examples. Repeating the fixture produced identical summaries, results, and cell summaries.
The complete low-loss-pass/high-loss-fail ledger for
feature-101294 is:
| Field | Value |
|---|---|
| Serving cell | LTE-35877 |
| Representative facade point | lon 32.852901154309, lat
39.924769672379 |
| Outdoor facade Rx | -87.441 dBm |
| Low-loss entry | 17.829 dB → -105.269 dBm, serviceable |
| High-loss entry | 35.029 dB → -122.470 dBm, not
serviceable |
| Receiver threshold | -115.000 dBm |
| Material evidence | unavailable; normalized material unknown; not used to
select a profile |
| Model / applicability | urban_short_range; applicable —
representative facade entry estimate at zero indoor depth |
| Geometry metadata | indoor depth 0.0 m; outdoor wall loss
0.0 dB; outdoor LOS state nlos |
Scope of future refinement
The current contract intentionally stops at a representative facade entry estimate. A later concept could add explicit floor/room geometry, material survey evidence, interior depth distributions, or calibrated regional composition parameters. Those additions would require a new model contract; they must not be inferred by silently extending Concept 4E.