---
title: "VRayLightMeter"
canonical: "https://documentation.chaos.com/space/VMAYA/111741414/VRayLightMeter"
format: markdown
---
This page describes the V-Ray Light Meter and its use.

 

## <span style="color: #000000">**Overview**</span>

---


## <span style="color: #000000">**Dimensions**</span><span style="color: #000000"> </span>

---

 

## <span style="color: #000000">**Preview**</span><span style="color: #000000"> </span>

---


## <span style="color: #000000">**Actions**</span>

---

 

---

 

### <span style="color: #000000">**Example: VRayLightMeter**</span>


<span style="color: #000000">The following example shows how VrayLightMeter measures the illuminance from two lights.</span>


## <span style="color: #000000">**MEL Script Methods**</span>

---

<span style="color: #000000">The following methods of the VRayLightMeter node are accessible from the Script Editor.</span>


| **VRayLightMeter Method** | **Description** |
| --- | --- |
| vrayLightMeterCalculate("VrayLightMeterShapeX"); | Calculates the values along the light meter grid. |
| vrayLightMeterSaveToCSV("VrayLightMeterShapeX", "*path/filename.csv*"); | Saves the values from the grid into the specified text file, in CSV (comma separated values) format. |
| vray getLightmeterMaxValue <NODE NAME - STRING> [direct|gi|total] | Returns the maximum value of a lightmeter (for Direct/GI/Total light). |
| vray getLightmeterAverageValue <NODE NAME - STRING> [direct|gi|total] | Returns the average value of a VRayLightMeter node. |


## <span style="color: #000000">**Notes**</span>

---

- <span style="color: #000000">The VRayLightMeter node is based on the texture baking and render elements functionality of the V-Ray renderer.</span>
- <span style="color: #000000">The VRayLightMeter node uses brute force GI with user selected GI Subdivs and 100 Bounces to calculate the measured values.</span>