Vastu Assessment for Existing Apartments

This is the most important distinction in an apartment assessment. The Vastu API's zone and Brahmasthan analysis are relative to whatever polygon you submit. For a single apartment:

• Submit the internal unit boundary — the polygon formed by the apartment's own walls. This is the space the resident actually occupies and can influence.
• Do not submit the whole building boundary or the plot boundary. The building's overall orientation and common areas are relevant context for the practitioner to note, but the geometric analysis should reflect the client's private space.

• Place a coordinate origin at a fixed reference corner of the apartment (e.g. the SW internal corner of the main entrance wall).
• Measure each wall vertex in the same unit (metres preferred). Walk the entire unit perimeter.
• For each named room, measure the internal polygon (walls only, not including hallways unless intentional).
• Stand inside the apartment facing the main entrance door (looking toward the door from inside). Measure the compass bearing of that direction. This is your entrance bearing_deg (if you also pass a non-zero north_angle, send compass bearing − north_angle instead).
• If plan-up on your drawing (your +Y axis) does not point True North, measure the True North bearing of plan-up, clockwise (for example 90 if plan-up faces East). That is north_angle.

For an apartment assessment, the minimum useful call is /vastu/plan/analyze with the full polygon, rooms and entrance. Use individual endpoints for lightweight or incremental workflows:

{
  "status": 200,
  "response": {
    "calculation": {
      "plot": {
        "area": <number>,
        "aspect_ratio": <number>,
        "centroid": {"x": <n>, "y": <n>},
        "bounding_box": {"minX":<n>,"maxX":<n>,"minY":<n>,"maxY":<n>,"width":<n>,"height":<n>}
      },
      "zones": [           // 8 zones (N,NE,E,SE,S,SW,W,NW)
        {
          "direction_8": "NW",
          "label_en": "North-West",
          "deity": "Vayu",
          "area": <number>,
          "area_pct": <0–100>  // percentage of total plot area
        }, ...
      ],
      "brahmasthan": {
        "polygon": [...],
        "area": <number>,
        "plot_fraction": <0–1>,
        "is_obstructed": <boolean>,
        "centre_point": {"x": <n>, "y": <n>},
        "is_fully_in_plot": <boolean>
      },
      "rooms": [
        {
          "name": "Master Bedroom",
          "zone_8": "NW",
          "centroid": {"x": <n>, "y": <n>},
          "bearing_from_plot_centre_deg": <number>
        }
      ],
      "entrance": {
        "direction_8": "NE",
        "deity": "Ishana (Shiva)",
        "label_en": "North-East",
        "label_hi": "...",
        "label_sa": "..."
      }
    },
    "rule_evaluation": {
      "findings": [
        {
          "rule_id": "entrance-ne-positive",
          "subject": "main-entrance",
          "category": "entrance",
          "predicate": "entrance-direction",
          "outcome": "positive",
          "severity": "minor",
          "source_type": "consensus",
          "source_text": null,
          "source_verification_status": "consensus_only",
          "interpretive_confidence": "moderate",
          "description": "<string>",
          "trigger": "Main entrance faces NE"
        }, ...
      ],
      "positive_count": <number>,
      "negative_count": <number>,
      "critical_count": <number>,
      "informational_count": <number>,
      "rules_version": "1.0.0"
    },
    "interpretation": null,
    "metadata": { "geometry_engine_version": "1.0.0", "vastu_rules_version": "1.0.0", "north_angle_applied_deg": <number>, ... }
  },
  "remaining_api_calls": <number>
}

The diagram below shows the 20×10 synthetic teaching fixture with its 8-zone orientation, Brahmasthan centre and the bedroom in the NW quadrant. The entrance arrow represents a NE bearing (45°) — this is a compass direction, not a surveyed door position.

SYNTHETIC teaching example — 20×10 rectangle, NW bedroom, NE entrance bearing 45°. Not a real property. Brahmasthan boundary is approximate in this diagram.

Each finding includes an interpretive_confidence label, alongside source_type and source_verification_status:

• high: Rule is consistently cited across primary Vastu Shastra texts with minimal source variation. No claim of empirical scientific validation is made.
• moderate: Rule appears in Vastu literature with some variation between sources, or is a derivative inference. Treat as contextual guidance rather than a definitive prescription.

The rule engine evaluates 23 rules in Phase 1. The full rule list and confidence table are available via GET /api/v1/vastu/methodology.

Most apartments present significant structural constraints. When presenting findings to a client:

• Identify which findings relate to fixed elements (load-bearing walls, shared walls with neighbours, stairwells) — these have no practical remedy available to the resident.
• Focus actionable recommendations on non-structural elements: furniture arrangement, decorative placement, lighting, plants, symbolic objects and colour.
• For entrance direction: in a rented apartment the main door direction is typically fixed. Some traditions recommend threshold-level enhancements; a qualified practitioner can advise on these.
• For Brahmasthan obstruction: heavy furniture (not load-bearing walls) in the central zone is a practical point of intervention for many residents.