# Fiber metadata

**Fiber Metadata**

* The intention for a separate Fiber metadata is to uniquely identify the fiber used to make the measurements. More than one cable may be used over the course of an experiment and there may be several fibers within a cable.
* Required fields *(mark with an asterisk, and indicated in the tables below)*\
  [fiber\_id\*](#fiber_id) | [cable\_id\*](#cable_id) | [fiber\_geometry\*](#fiber_geometry) | [fiber\_mode\*](#fiber_mode) | [fiber\_refraction\_index\*](#fiber_refraction_index)
* Optional fields\
  [fiber\_winding\_angle](#fiber_winding_angle) | [fiber\_winding\_angle\_unit](#fiber_winding_angle_unit) | [fiber\_start\_location](#fiber_start_location) | [fiber\_start\_location\_unit](#fiber_start_location_unit) | [fiber\_end\_location](#fiber_end_location) | [fiber\_end\_location\_unit](#fiber_end_location_unit) | [fiber\_optical\_length](#fiber_optical_length) | [fiber\_optical\_length\_unit](#fiber_optical_length_unit) | [fiber\_one\_way\_attenuation](#fiber_one_way_attenuation) | [fiber\_one\_way\_attenuation\_unit](#fiber_one_way_attenuation_unit) | [comment](#comment)

***

#### fiber\_id

| attributeID          | fiber\_id  `Required`                                                                                                                               |
| -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Description**      | Unique identifier for the physical fiber, with a maximum of 8 alphanumeric characters with no special characters (e.g., underscores, period, dash). |
| **Required**         | True                                                                                                                                                |
| **Type**             | String                                                                                                                                              |
| **Style**            | Alphanumeric                                                                                                                                        |
| **Units or options** | --                                                                                                                                                  |
| **Example**          | F001                                                                                                                                                |

#### cable\_id

| attributeID          | cable\_id  `Required`                                        |
| -------------------- | ------------------------------------------------------------ |
| **Description**      | Unique identifier associates this fiber to a specific cable. |
| **Required**         | True                                                         |
| **Type**             | String                                                       |
| **Style**            | Alphanumeric                                                 |
| **Units or options** | --                                                           |
| **Example**          | CA001                                                        |

#### fiber\_geometry

| attributeID          | fiber\_geometry  `Required` |
| -------------------- | --------------------------- |
| **Description**      | Geometry of fiber.          |
| **Required**         | True                        |
| **Type**             | String                      |
| **Style**            | Controlled vocabulary       |
| **Units or options** | \[linear                    |
| **Example**          | linear                      |

#### fiber\_mode

| attributeID          | fiber\_mode  `Required` |
| -------------------- | ----------------------- |
| **Description**      | Mode of fiber.          |
| **Required**         | True                    |
| **Type**             | String                  |
| **Style**            | Controlled vocabulary   |
| **Units or options** | \[single-mode           |
| **Example**          | linear                  |

#### fiber\_refraction\_index

| attributeID          | fiber\_refraction\_index  `Required`                                                     |
| -------------------- | ---------------------------------------------------------------------------------------- |
| **Description**      | Refractive index of the fiber (unitless). Typical value for single mode fiber is 1.4681. |
| **Required**         | True                                                                                     |
| **Type**             | Float                                                                                    |
| **Style**            | na                                                                                       |
| **Units or options** | -                                                                                        |
| **Example**          | 1.4681                                                                                   |

#### fiber\_winding\_angle

| attributeID          | fiber\_winding\_angle  `Optional`                                          |
| -------------------- | -------------------------------------------------------------------------- |
| **Description**      | If helical, this is the winding angle relative to the center of the cable. |
| **Required**         | False                                                                      |
| **Type**             | Float                                                                      |
| **Style**            | na                                                                         |
| **Units or options** | -                                                                          |
| **Example**          | -                                                                          |

#### fiber\_winding\_angle\_unit

| attributeID          | fiber\_winding\_angle\_unit  `Optional` |
| -------------------- | --------------------------------------- |
| **Description**      | Unit of fiber winding angle             |
| **Required**         | False                                   |
| **Type**             | String                                  |
| **Style**            | Controlled vocabulary                   |
| **Units or options** | degree                                  |
| **Example**          | -                                       |

#### fiber\_start\_location

| attributeID          | fiber\_start\_location  `Optional`                                                                        |
| -------------------- | --------------------------------------------------------------------------------------------------------- |
| **Description**      | The start distance along the fiber with respect to the interrogator, referred to as StartLocus in PRODML. |
| **Required**         | False                                                                                                     |
| **Type**             | Float                                                                                                     |
| **Style**            | na                                                                                                        |
| **Units or options** | -                                                                                                         |
| **Example**          | -                                                                                                         |

#### fiber\_start\_location\_unit

| attributeID          | fiber\_start\_location\_unit  `Optional` |
| -------------------- | ---------------------------------------- |
| **Description**      | Unit of fiber start location.            |
| **Required**         | False                                    |
| **Type**             | String                                   |
| **Style**            | Controlled vocabulary                    |
| **Units or options** | \[meter                                  |
| **Example**          | meter                                    |

#### fiber\_start\_location

| attributeID          | fiber\_start\_location  `Optional`                                                                        |
| -------------------- | --------------------------------------------------------------------------------------------------------- |
| **Description**      | The start distance along the fiber with respect to the interrogator, referred to as StartLocus in PRODML. |
| **Required**         | False                                                                                                     |
| **Type**             | Float                                                                                                     |
| **Style**            | na                                                                                                        |
| **Units or options** | -                                                                                                         |
| **Example**          | -                                                                                                         |

#### fiber\_start\_location\_unit

| attributeID          | fiber\_start\_location\_unit  `Optional` |
| -------------------- | ---------------------------------------- |
| **Description**      | Unit of fiber start location.            |
| **Required**         | False                                    |
| **Type**             | String                                   |
| **Style**            | Controlled vocabulary                    |
| **Units or options** | \[meter                                  |
| **Example**          | meter                                    |

#### fiber\_end\_location

| attributeID          | fiber\_end\_location  `Optional`                                               |
| -------------------- | ------------------------------------------------------------------------------ |
| **Description**      | The end location or distance along the fiber with respect to the interrogator. |
| **Required**         | False                                                                          |
| **Type**             | Float                                                                          |
| **Style**            | na                                                                             |
| **Units or options** | -                                                                              |
| **Example**          | -                                                                              |

#### fiber\_end\_location\_unit

| attributeID          | fiber\_end\_location\_unit  `Optional` |
| -------------------- | -------------------------------------- |
| **Description**      | Unit of fiber end location.            |
| **Required**         | False                                  |
| **Type**             | String                                 |
| **Style**            | Controlled vocabulary                  |
| **Units or options** | \[meter                                |
| **Example**          | meter                                  |

#### fiber\_optical\_length

| attributeID          | fiber\_optical\_length  `Optional`                                                                       |
| -------------------- | -------------------------------------------------------------------------------------------------------- |
| **Description**      | Total length of this fiber. Typically, it is the sum of fiber\_start\_location and fiber\_end\_location. |
| **Required**         | False                                                                                                    |
| **Type**             | Float                                                                                                    |
| **Style**            | na                                                                                                       |
| **Units or options** | -                                                                                                        |
| **Example**          | 8400                                                                                                     |

#### fiber\_optical\_length\_unit

| attributeID          | fiber\_optical\_length\_unit  `Optional` |
| -------------------- | ---------------------------------------- |
| **Description**      | Unit of fiber optical length.            |
| **Required**         | False                                    |
| **Type**             | String                                   |
| **Style**            | Controlled vocabulary                    |
| **Units or options** | \[meter                                  |
| **Example**          | meter                                    |

#### fiber\_one\_way\_attenuation

| attributeID          | fiber\_one\_way\_attenuation  `Optional`                                                      |
| -------------------- | --------------------------------------------------------------------------------------------- |
| **Description**      | Power loss for one-way travel of a beam of light. Typical value for single mode fiber is 0.4. |
| **Required**         | False                                                                                         |
| **Type**             | Float                                                                                         |
| **Style**            | na                                                                                            |
| **Units or options** | -                                                                                             |
| **Example**          | -                                                                                             |

#### fiber\_one\_way\_attenuation\_unit

| attributeID          | fiber\_one\_way\_attenuation\_unit  `Optional` |
| -------------------- | ---------------------------------------------- |
| **Description**      | Unit of fiber optical length.                  |
| **Required**         | False                                          |
| **Type**             | String                                         |
| **Style**            | Controlled vocabulary                          |
| **Units or options** | \[decibels/meter                               |
| **Example**          | -                                              |

#### comment

| attributeID          | comment  `Optional`  |
| -------------------- | -------------------- |
| **Description**      | Additional comments. |
| **Required**         | False                |
| **Type**             | String               |
| **Style**            | Free form text       |
| **Units or options** | --                   |
| **Example**          | na                   |


---

# 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://das-metadata.gitbook.io/das-metadata-standard-by-das-rcn/term/fiber.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.
