# Translucent Modifier

![](/files/-MihqgaIxjWfIdyb-qUK)

![](/files/-MihqbMwpplnRUhVXq8W) - [\[source code\]](https://github.com/ladybug-tools/honeybee-grasshopper-radiance/blob/master/honeybee_grasshopper_radiance/src//HB%20Translucent%20Modifier.py)

Create a translucent radiance modifier from a reflectance and transmittance.

The sum of the reflectances and transmittances must be less than 1 and any energy not transmitted or reflected is assumed to be absorbed. The resulting material will always be grey with equivalent red, green and blue channels.

### Inputs

* **name**

Text to set the name for the modifier and to be incorporated into a unique modifier identifier.

* **diff\_ref \[Required]**

A number between 0 and 1 for the diffuse reflectance of the material.

* **diff\_trans \[Required]**

A number between 0 and 1 for the transmitted diffuse component. This is the fraction of transmitted light that is diffusely scattered.

* **spec\_trans**

A number between 0 and 1 for the transmitted specular component. This is the fraction of transmitted light that is not diffusely scattered but passes through like a beam. (Default: 0).

* **spec**

A number between 0 and 1 for the fraction of specularity. Specularity fractions greater than 0.1 are not common in non-metallic materials. (Default: 0).

* **rough**

Roughness is specified as the rms slope of surface facets. A value of 0 corresponds to a perfectly smooth surface, and a value of 1 would be a very rough surface. Roughness values greater than 0.2 are not very realistic. (Default: 0).

### Outputs

* **modifier**

A translucent modifier that can be assigned to a Honeybee geometry or Modifier Sets.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.ladybug.tools/hb-radiance-primer/components/1_modifiers/translucent_modifier.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.