Configuration Guide for Cisco NCS 1001, IOS XR Release 25.x.x

OTDR machine learning events

Updated: July 27, 2026

Want to summarize with AI?

This topic provides reference details for OTDR machine learning feature history and event classifications shown in scan output when machine learning is enabled.

Use this reference to identify the OTDR machine learning feature changes and the event types that can appear in scan output.

Table 1. Feature history
Feature name	Release information	Description
OTDR machine learning model	Cisco IOS XR Release 7.3.2	The OTDR machine learning model is updated to Version 4 to improve event recognition performance.

Table 2. Feature history
Feature name	Release	Description
OTDR machine learning	Cisco IOS XR Release 7.3.1	Machine learning can be enabled on the OTDR card. If enabled, the OTDR measurement provides additional event information about the fiber.

When the machine learning parameter is set to one, the scan output can display these event types:

Table 3. Machine learning event types
Event	Description
FIBER TERMINATED	The fiber is correctly plugged in to the far-end node.
OPEN CONNECTOR	The fiber is not correctly plugged in to the far-end node.
FACE PLATE	The beginning of the fiber.
PASS THROUGH	The connection between two fibers.

Enable machine learning on the OTDR card

Enable ML for the selected OTDR slot, port, and direction in configuration mode.

When ML is enabled, OTDR scan output includes additional event classifications for the fiber span.

Procedure

Use the hw-module location command to enable ML on the selected OTDR card, port, and direction.

hw-module location location slot slot-number otdr port port-number direction direction ml-enabled 1

Example:


hw-module location 0/RP0/CPU0 slot 1 otdr port 1 direction tx ml-enabled 1

Machine learning is enabled for the selected OTDR card, port, and direction.

View scan output with machine learning enabled

View scan output by position number after ML is enabled on the OTDR card.

The ML graph analysis section in the command output shows additional event classifications.

Procedure

Use the show hw-module command to display the scan output for position 0.

Example:


RP/0/RP0/CPU0:156-ML#show hw-module slot 1 otdr scan 0
Measurement on: 20200916-171424
OTDR device number: 1
Scan direction: Tx
Scan mode: Auto
Directory location: /harddisk:/otdr
File name: 156-ML_ncs1001_slot1_otdr1_TX.20200916-171424.sor
Total ORL: 31.37 dB
Distance (estimate): 61.275 km
High Reflection Location: 0.00 km
Total number of event detected: 2

ML graph analysis:
Total number of event detected: 3
Event# | TYPE           | LOCATION(km)
-------+----------------+-------------
   A   | FACE PLATE     | 0.001
   B   | PASS THROUGH   | 11.876
   C   | OPEN CONNECTOR | 61.285

The OPEN CONNECTOR event type in the output indicates that the fiber span is not connected to a far-end node.

Use the show hw-module command to display the scan output for another measurement position.

Example:

RP/0/RP0/CPU0:156-ML#show hw-module slot 1 otdr scan 6
Measurement on: 20200917-140822
OTDR device number: 1
Scan direction: Tx
Scan mode: Auto
Directory location: /harddisk:/otdr
File name: 156-ML_ncs1001_slot1_otdr1_TX.20200917-140822.sor
Total ORL: 31.29 dB
Distance (estimate): 61.279 km
High Reflection Location: 0.00 km
Total number of event detected: 1

ML graph analysis:
Total number of event detected: 3
Event# | TYPE             | LOCATION(km)
-------+------------------+-------------
   A   | FACE PLATE       | 0.001
   B   | PASS THROUGH     | 11.876
   C   | FIBER TERMINATED | 61.622

The FIBER TERMINATED event type in the output indicates that the fiber span is properly connected to a far-end node.

Need help?

Open a support case

(Requires a Cisco Service Contract)

The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.