# Face

![](/files/-MihntRBvFomjJey_ufd)

![](/files/-MihntRCh3_21j3F6DKz) - [\[source code\]](https://github.com/ladybug-tools/honeybee-grasshopper-core/blob/master/honeybee_grasshopper_core/src//HB%20Face.py)

Create Honeybee Face

## Inputs

* **geo \[Required]**

  Rhino Brep or Mesh geometry.&#x20;
* **name**

  Text to set the name for the Face and to be incorporated into unique Face identifier. If the name is not provided, a random name will be assigned.&#x20;
* **type**

  Text for the face type. The face type will be used to set the material and construction for the surface if they are not assigned through the inputs below. The default is automatically set based on the normal direction of the Face (up being RoofCeiling, down being Floor and vertically-oriented being Wall). Choose from the following:

  * Wall
  * RoofCeiling
  * Floor
  * AirBoundary
* **bc**

  Text for the boundary condition of the face. The boundary condition is also used to assign default materials and constructions as well as the nature of heat excahnge across the face in energy simulation. Default is Outdoors unless all vertices of the geometry lie below the below the XY plane, in which case it will be set to Ground. Choose from the following:

  * Outdoors
  * Ground
  * Adiabatic
* **ep\_constr**

  Optional text for the Face's energy construction to be looked up in the construction library. This can also be a custom OpaqueConstruction object. If no energy construction is input here, the face type and boundary condition will be used to assign a default.&#x20;
* **rad\_mod**

  Optional text for the Face's radiance modifier to be looked up in the modifier library. This can also be a custom modifier object. If no radiance modifier is input here, the face type and boundary condition will be used to assign a default.&#x20;

## Outputs

* **report**

  Reports, errors, warnings, etc.&#x20;
* **faces**

  Honeybee surface. Use this surface directly for daylight simulation or to create a Honeybee zone for Energy analysis.&#x20;


---

# 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/honeybee-primer/components/0_create/face.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.
