> For the complete documentation index, see [llms.txt](https://das-metadata.gitbook.io/das-metadata-standard-by-das-rcn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://das-metadata.gitbook.io/das-metadata-standard-by-das-rcn/term/fiber.md). # 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 This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## 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, and the optional `goal` query parameter: ``` GET https://das-metadata.gitbook.io/das-metadata-standard-by-das-rcn/term/fiber.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.