Lighting Grids & Room Lux Mapping

The lighting grid tools in Lux Meter Pro let you build a room grid, tap each cell to record measured lux, and instantly see total and average lux for the whole area. Perfect for planning a new install or checking how well an existing layout really performs.

8×8+ Flexible Grids Add / Remove Rows & Columns Total & Average Lux PDF Heat‑Map Export
Download Lux Meter Pro Why Use Grids

Why Use Lighting Grids?

Grids give you a structured way to measure and visualise how light is distributed across a room, not just at a single point.

1. Create a Grid for Your Room

Start by creating a new grid for the room you’re assessing. Give it a job reference and basic address details so your lux map is always tied back to a real project and location.

Define the job and grid ID

In the app, the CreateGridView screen lets you create a new lighting grid with:

  • Job reference – a name you recognise (project, room, client).
  • Business/Resident name and address – for clear reporting.
  • Automatic Grid ID – a unique ID (UUID) stored as gridId used to link your CSV data and PDF reports to this grid.
  • Start date – when you began the survey or design work.

When you tap “Create”, Lux Meter Pro:

  • Saves the grid metadata into a local grids.json file.
  • Creates a matching gridId.csv with row/column placeholders for lux values.
Create grid screen in Lux Meter Pro

2. Tap Cells & Record Lux Across the Room

Once your grid is created, open it in the Room Grid view. You can tap any cell, input the measured lux and add a light reference to build a complete lux map of the space.

Room grid view with lux cells in Lux Meter Pro

Interactive cell editing

The RoomGridView uses a dictionary of LuxCell objects (keyed as row_column) to hold your readings. Tapping a cell opens CellInputView, where you can:

  • Select the row/column (automatically shown in the title).
  • Enter a Light reference (fitting ID or location note).
  • Type the measured lux value for that point.
  • Save, which updates the grid in memory and writes back to the CSV file.

You’re not locked to a fixed 8×8 grid. Use the controls at the bottom to:

  • Add or delete rows to cover longer spaces or corridors.
  • Add or delete columns to widen the grid as needed.
  • Switch between square and circle cells for a different visual style.
Long‑press a cell to clear it if you entered the wrong value.
Pinch to zoom the grid in or out for tight or wide overviews.

3. Use Total & Average Lux to Plan Install Locations

As you fill in more cells, Lux Meter Pro automatically calculates total and average lux, plus grid area. This helps you decide where extra fittings are needed or where you can safely reduce lighting.

Instant stats for design decisions

At the top of RoomGridView, the app shows a live stats bar:

  • Total area – based on the number of rows × columns (assuming 1 m² per cell by default).
  • Total lux – sum of all lux values across the grid.
  • Average lux – total lux divided by the number of populated cells.

With this, you can:

  • Compare actual average lux with the target value from your design or standard.
  • See if a proposed layout meets requirements before committing to final positions.
  • Demonstrate to clients why extra fittings are needed in darker areas.

When you’re ready, tap the PDF export control to generate a heat‑map style PDF:

  • Grid values and layout rendered clearly for reports.
  • Job details (client, address, date) included from your grid metadata.
  • Contractor logo and contact details added from your stored settings.
Lighting grid stats and PDF export in Lux Meter Pro