OTS/Fiber¶
Table with one row for each element of the type: 'OTS/Fiber'.
Columns¶
| Name | Description |
|---|---|
| Transceiver (A) | The optional pluggable bidirectional transceiver connected at the origin node of the element |
| Attributes | User-defined attributes associated to this element |
| SRGs | The Shared Risk Groups (SRGs) this element belongs to: the SRGs that mandate the shutdown (set in failure state) of this element |
| TAPI uuid | TAPI global uuid json object |
| Name | A user-defined name (typically short) that can be assigned to this element |
| Identifier | A unique identifier set to the element, and never changed |
| Valid spectrum (THz) | The total valid specturm in the fiber, in THz, summing upu all the usable bands defined for the fiber |
| Length (km) | The length in km of this element |
| Output: total power (dBm) | Total output power at the fiber span output, in dBm, considering all the propagated channels |
| Second order refractive index (square meter per Watt) | THe second order refractive index physical parameter, in square meters per Watt. Used in non-linear optical signal impairment calculation |
| Tags | User-defined tags associated to this element |
| Valid spectrum bands | The list of the bands of the spectrum that are usable for optical connections in this fiber. They are specified as a list of low frequnecy - high frequency, in THz |
| Second order dispersion coefficient (square ps per nm) | The second order dispersion coefficient of the fiber, a physical parameter, measured in square ps per nm. Used in non-linear optical signal impairment calculation |
| Attenuation (dB/km) | The attenuation coefficient of the network, at the reference frequency of 193.1 |
| Transceiver (B) | The optional pluggable bidirectional transceiver connected at the destination node of the element |
| Spectrum utilization (%) | The total occupied specturm in the fiber, in THz |
| Intra-node | Indicates if both end nodes are the same or not |
| Bidi pair | If this element is bidirectional, contains its bidirectional pair |
| JSON | An optional JSON content describing this element |
| Optical connections (nominal) | The optical connections defined, that traverse this element in its nominal path |
| TAPI Local uuid | TAPI local UUID. This means, local respet to belonging TAPI element |
| Show | Show the element in the canvas, or else hide it |
| Up | Indicates if the element is up (active) or down (failed) |
| Chromatic dispersion mask (ps/nm/km for different frequencies in THz) | The chromatic dispersion coefficient of the fiber (in ps/nm/km), at different frequencies (in THz). The chromatic dispersion for different frequencies is obtained with linear interpolation |
| WDM link | The WDM link traversing this fiber span, if any |
| Output: channel power mismatch (dB) | The ratio between the maximum power density and the minimum power density, among the propagated channels, in dB. If 0 dB, all the channels are perfectly equalized |
| A | Origin node |
| B | Destination node |
| Description | A user-defined text description (potentially long) that can be assigned to this element |
| Input: channel power mismatch (dB) | The ratio between the maximum power density and the minimum power density, among the propagated channels, in dB. If 0 dB, all the channels are perfectly equalized |
| CEP B | TAPI connection-edge-point in the link destination |
| NEP A | TAPI node-edge-point in the link origin |
| CEP A | TAPI connection-edge-point in the link origin |
| NEP B | TAPI node-edge-point in the link destination |
| Occupied spectrum (THz) | The total occupied specturm in the fiber, in THz |
| Optical connections (waste spectrum) | The optical connections defined, that does not traverse this element in its nominal path, but for for which its signal eventually propagates through this fiber, i.e. the signal is not appropriately filtered in a nominal path node (e.g. filterless node) and thus propagates through this element |
| Input: Total power (dBm) | Total input power at the fiber span input, in dBm, considering all the propagated channels |
| Latency (ms) | The latency in miliseconds added to the traffic traversing this element |
| Added CD (ps/nm) | The contribution to the chromatic dispersion of the fiber, for the frequency of 193.6 THz |
| CD coef (ps/km/nm) | The chromatic dispersion coefficient of the fiber, in ps per nm and km, at the reference frequency of 193.1 |
| Fiber type | An optional user-defined string identifying the type of fiber of the span |
| OLS Paths (nominal) | The Optical Line System (OLS) paths defined, that traverse this element in its nominal path |
| Attenuation mask (dB/km for different frequencies in THz) | A mask indicating the fiber attenuation in dB/km, for different frequency values (in THz). The attenuation for different frequencies is obtained with linear interpolation |
| External links | Indicates if this element has one or more user-defined external URLs associated to it. If so, when the user clicks this cell, and selects the URL (if more than one), a navigator is launched and the URL page is shown. External links are not editable in the GUI, but via API. |
| Effective area (square microm) | The fiber effective area physical parameter, in square micrometers. Used in non-linear optical signal impairment calculation |
| TAPI JSON | Full TAPI JSON for this element |
| Clashing spectrum (GHz) | The total specturm in the fiber (in GHz) where spectrum clashing occurs: spectrum occupied by two or more overlapping channels, that get destroyed because of this clashing |
| Installed | Indicates if the element is installed. If not installed, the element behaves as if it did not exist, being unable to e.g. handle traffic or reserve any bandwidth |
| Average attenuation (dB) | The subtraction in dB between the total power at fiber input (dBm) and at fiber output (dBm) |
Views¶
| Name | Columns | Description |
|---|---|---|
| Full view | Name, Identifier, Description, ExternalLinks, Show, A, B, Intra-node, BidiPair, Length(km), Latency(ms), Up, Installed, Srgs, WdmLink, Transceiver(a), Transceiver(b), ValidSpectrumBands, ValidSpectrum(thz), OccupiedSpectrum(thz), SpectrumUtilization(%), ClashingSpectrum(ghz), OlsPaths(nominal), OpticalConnections(nominal), OpticalConnections(wasteSpectrum), Input:TotalPower(dbm), Input:ChannelPowerMismatch(db), Output:TotalPower(dbm), Output:ChannelPowerMismatch(db), AverageAttenuation(db), AddedCd(ps/nm), FiberType, Attenuation(db/km), CdCoef(ps/km/nm), EffectiveArea(squareMicrom), SecondOrderDispersionCoefficient(squarePsPerNm), SecondOrderRefractiveIndex(squareMeterPerWatt), AttenuationMask(db/kmForDifferentFrequenciesInThz), ChromaticDispersionMask(ps/nm/kmForDifferentFrequenciesInThz), Tags, Attributes, Json, NepA, NepB, CepA, CepB, TapiLocalUuid, TapiUuid, TapiJson | This table view corresponds to a view with all the table columns. In some occassions, this may imply an impractically large number of columns for human inspection. |
| TAPI | A, B, Up, NepA, NepB, CepA, CepB, TapiLocalUuid, TapiUuid, TapiJson | Columns associated to TAPI-related info |
| Failure status | A, B, Up, Installed, Srgs | Columns associated to the risks this element belongs to, and its failure status |
| Spectrum info | A, B, Up, ValidSpectrumBands, ValidSpectrum(thz), OccupiedSpectrum(thz), SpectrumUtilization(%), ClashingSpectrum(ghz) | This view collects information of the spectrum associated with this element. |
| Physical coefficients | A, B, Up, FiberType, Attenuation(db/km), CdCoef(ps/km/nm), EffectiveArea(squareMicrom), SecondOrderDispersionCoefficient(squarePsPerNm), SecondOrderRefractiveIndex(squareMeterPerWatt), AttenuationMask(db/kmForDifferentFrequenciesInThz), ChromaticDispersionMask(ps/nm/kmForDifferentFrequenciesInThz) | This view collects the information more closely related to the optical physical coefficients of the fibre, that permit estimating the optical performances of the propagated signals |
| Signal KPIs | A, B, Up, Input:TotalPower(dbm), Input:ChannelPowerMismatch(db), Output:TotalPower(dbm), Output:ChannelPowerMismatch(db), AverageAttenuation(db), AddedCd(ps/nm) | This view collects the KPIs describing the optical signal performances of the channels in the fiber |
| Connectivity | A, B, BidiPair, Up, WdmLink, Transceiver(a), Transceiver(b), OlsPaths(nominal), OpticalConnections(nominal), OpticalConnections(wasteSpectrum) | Columns associated to the element related paths, links, neighbor nodes and alike |
| Description & tags & attributes | Name, Identifier, Description, ExternalLinks, A, B, Up, Tags, Attributes, Json | Columns associated to side information like element names, descriptions, user associated tags or attributes |
| KPIs | A, B, Length(km), Latency(ms), Up, Installed | Columns associated to traffic-related KPIs of the multicast flows |
| Default view | Show, A, B, Latency(ms), Up, WdmLink, Tags | This table view corresponds to a subset of columns selected as representative for a default table view. They typically include the most typical required values |
Table right-click menu¶
- Set for selected elements...: Menu with options for setting values to different parameters of the selected elements
- Value at column 'Name': This option sets the value at column 'Name'
- For selected elements: Set the value at column 'Name' for: Selected elements (The elements already selected by the user in the table before calling this action)
- For all table elements: Set the value at column 'Name' for: All table elements (All the elements in the table, not applying any filter, and not considering any pagination)
- Value at column 'Identifier': This option sets the value at column 'Identifier'
- For selected elements: Set the value at column 'Identifier' for: Selected elements (The elements already selected by the user in the table before calling this action)
- For all table elements: Set the value at column 'Identifier' for: All table elements (All the elements in the table, not applying any filter, and not considering any pagination)
- Value at column 'Description': This option sets the value at column 'Description'
- For selected elements: Set the value at column 'Description' for: Selected elements (The elements already selected by the user in the table before calling this action)
- For all table elements: Set the value at column 'Description' for: All table elements (All the elements in the table, not applying any filter, and not considering any pagination)
- Value at column 'Show': This option sets the value at column 'Show'
- As true:
- For selected elements: Set the value at column 'Show' for: Selected elements (The elements already selected by the user in the table before calling this action)
- For selected elements: Set the value at column 'Show' for: All table elements (All the elements in the table, not applying any filter, and not considering any pagination)
- As false:
- For selected elements: Set the value at column 'Show' for: Selected elements (The elements already selected by the user in the table before calling this action)
- For selected elements: Set the value at column 'Show' for: All table elements (All the elements in the table, not applying any filter, and not considering any pagination)
- Value at column 'Length (km)': This option sets the value at column 'Length (km)'
- For selected elements: Set the value at column 'Length (km)' for: Selected elements (The elements already selected by the user in the table before calling this action)
- For all table elements: Set the value at column 'Length (km)' for: All table elements (All the elements in the table, not applying any filter, and not considering any pagination)
- Scale link length by a multiplicative factor: This option sets the value at column 'Length (km)'
- For selected elements: Set the value at column 'Length (km)' for: Selected elements (The elements already selected by the user in the table before calling this action)
- For all table elements: Set the value at column 'Length (km)' for: All table elements (All the elements in the table, not applying any filter, and not considering any pagination)
- Set link length from geographical distance of end nodes: This option sets the value at column 'Length (km)'
- For selected elements: Set the value at column 'Length (km)' for: Selected elements (The elements already selected by the user in the table before calling this action)
- For all table elements: Set the value at column 'Length (km)' for: All table elements (All the elements in the table, not applying any filter, and not considering any pagination)
- Value at column 'Latency (ms)': This option sets the value at column 'Latency (ms)'
- For selected elements: Set the value at column 'Latency (ms)' for: Selected elements (The elements already selected by the user in the table before calling this action)
- For all table elements: Set the value at column 'Latency (ms)' for: All table elements (All the elements in the table, not applying any filter, and not considering any pagination)
- Scale latency by a multiplicative factor: This option sets the value at column 'Latency (ms)'
- For selected elements: Set the value at column 'Latency (ms)' for: Selected elements (The elements already selected by the user in the table before calling this action)
- For all table elements: Set the value at column 'Latency (ms)' for: All table elements (All the elements in the table, not applying any filter, and not considering any pagination)
- Set link latency as proportional to link length: This option sets the value at column 'Latency (ms)'
- For selected elements: Set the value at column 'Latency (ms)' for: Selected elements (The elements already selected by the user in the table before calling this action)
- For all table elements: Set the value at column 'Latency (ms)' for: All table elements (All the elements in the table, not applying any filter, and not considering any pagination)
- Value at column 'Up': This option sets the value at column 'Up'
- As true:
- For selected elements: Set the value at column 'Up' for: Selected elements (The elements already selected by the user in the table before calling this action)
- For selected elements: Set the value at column 'Up' for: All table elements (All the elements in the table, not applying any filter, and not considering any pagination)
- As false:
- For selected elements: Set the value at column 'Up' for: Selected elements (The elements already selected by the user in the table before calling this action)
- For selected elements: Set the value at column 'Up' for: All table elements (All the elements in the table, not applying any filter, and not considering any pagination)
- Value at column 'Installed': This option sets the value at column 'Installed'
- As true:
- For selected elements: Set the value at column 'Installed' for: Selected elements (The elements already selected by the user in the table before calling this action)
- For selected elements: Set the value at column 'Installed' for: All table elements (All the elements in the table, not applying any filter, and not considering any pagination)
- As false:
- For selected elements: Set the value at column 'Installed' for: Selected elements (The elements already selected by the user in the table before calling this action)
- For selected elements: Set the value at column 'Installed' for: All table elements (All the elements in the table, not applying any filter, and not considering any pagination)
- Value at column 'Fiber type': This option sets the value at column 'Fiber type'
- For selected elements: Set the value at column 'Fiber type' for: Selected elements (The elements already selected by the user in the table before calling this action)
- For all table elements: Set the value at column 'Fiber type' for: All table elements (All the elements in the table, not applying any filter, and not considering any pagination)
- Value at column 'Effective area (square microm)': This option sets the value at column 'Effective area (square microm)'
- For selected elements: Set the value at column 'Effective area (square microm)' for: Selected elements (The elements already selected by the user in the table before calling this action)
- For all table elements: Set the value at column 'Effective area (square microm)' for: All table elements (All the elements in the table, not applying any filter, and not considering any pagination)
- Value at column 'Second order dispersion coefficient (square ps per nm)': This option sets the value at column 'Second order dispersion coefficient (square ps per nm)'
- For selected elements: Set the value at column 'Second order dispersion coefficient (square ps per nm)' for: Selected elements (The elements already selected by the user in the table before calling this action)
- For all table elements: Set the value at column 'Second order dispersion coefficient (square ps per nm)' for: All table elements (All the elements in the table, not applying any filter, and not considering any pagination)
- Value at column 'Second order refractive index (square meter per Watt)': This option sets the value at column 'Second order refractive index (square meter per Watt)'
- For selected elements: Set the value at column 'Second order refractive index (square meter per Watt)' for: Selected elements (The elements already selected by the user in the table before calling this action)
- For all table elements: Set the value at column 'Second order refractive index (square meter per Watt)' for: All table elements (All the elements in the table, not applying any filter, and not considering any pagination)
- Value at column 'Attenuation mask (dB/km for different frequencies in THz)': This option sets the value at column 'Attenuation mask (dB/km for different frequencies in THz)'
- For selected elements: Set the value at column 'Attenuation mask (dB/km for different frequencies in THz)' for: Selected elements (The elements already selected by the user in the table before calling this action)
- For all table elements: Set the value at column 'Attenuation mask (dB/km for different frequencies in THz)' for: All table elements (All the elements in the table, not applying any filter, and not considering any pagination)
- Value at column 'Chromatic dispersion mask (ps/nm/km for different frequencies in THz)': This option sets the value at column 'Chromatic dispersion mask (ps/nm/km for different frequencies in THz)'
- For selected elements: Set the value at column 'Chromatic dispersion mask (ps/nm/km for different frequencies in THz)' for: Selected elements (The elements already selected by the user in the table before calling this action)
- For all table elements: Set the value at column 'Chromatic dispersion mask (ps/nm/km for different frequencies in THz)' for: All table elements (All the elements in the table, not applying any filter, and not considering any pagination)
- Add fiber spans / WDM links: Different options for adding fiber spans and potentially WDM links on them
- Add a single fiber span: This option permits adding a fiber span, over existing or newly created OTS fiber ports.
- Add a sequence of fiber spans: This option permits adding a sequence of fiber spans, and the optical amplifiers between them, between two nodes. Additionally, a single-path WDM link can be created on top.
- Add a WDM link over existing fiber spans: This option permits adding a WDM link, assigning to it one or two (1+1) sequence of fiber spand interconnected by optical amplifiers, that should already exist (and not be part of other WDM link) in the underlying infrastructure.
- Remove: Different remove options
- Selected elements: Remove elements: Selected elements (The elements already selected by the user in the table before calling this action)
- All table elements: Remove elements: All table elements (All the elements in the table, not applying any filter, and not considering any pagination)
- Apply pre-stored fiber model to selected fibers: Applies a user-selected fiber-model, among those stored, to all selected fiber spans. The fiber model includes default values for different physical layer parameters
- G.652: Applies the fiber-model stored for G.652 fibers
- PSCF: Applies the fiber-model stored for PSCF fibers
- NZDSF: Applies the fiber-model stored for NZDSF fibers
- Bidirectional relations: Different options to manage bidirectionality relations between elements
- Remove bidirectional association to selected elements: For all selected elements that are bidirectional, removes such bidirectional association leaving two unidirectional independent elements
- Set bidirectional pair to selected element: For all selected elements that are not currently bidirectional, are arranged into pairs of opposite elements (with opposite end nodes), and are set as bidirectional.
- Tags: Different menu options related to user-defined tags
- Add tag: Adds a user-defined tag to the indicated elements
- Remove tag: Removes a user-defined tag from the indicated elements
- Remove all tags: For all the indicated elements, all their tags are removed
- Add tags to element end nodes: For all the user indicated elements, a user-defined tag is added to both end nodes of the element
- Remove tags from element end nodes: For all the user indicated elements, a user-defined tag is removed from both end nodes of the element
- Attributes: Different menu options related to user-defined attributes
- Add attribute: Adds a user-defined attribute (key-value pair) to all the selected elements. Any attribute with the same key is replaced by the new value.
- Remove attribute: Removes a user-defined attribute (key-value pair) from all the selected elements.
- Remove all attributes: Removes all the user-defined attributes (key-value pair) from the indicated elements.
Form-required interactions¶
Add a single fiber span¶
Form to complete:
- Add a single fiber span: This option permits adding a fiber span, over existing or newly created OTS fiber ports..
- Origin node: The origin node of this element.
- Origin port: The port of this element at the origin node..
- Destination node: The destination node of this element.
- Destination port: The port of this element at the end node..
- Bidirectional: If checked, a bidirectional element is created, or else a unidirectional one.
Add a sequence of fiber spans¶
Form to complete:
- Add a sequence of fiber spans: This option permits adding a sequence of fiber spans, and the optical amplifiers between them, between two nodes. Additionally, a single-path WDM link can be created on top..
- Origin node: The origin node of this element.
- Create origin port: If checked, a new fiber port is created in the node for hosting this link.
-
New origin port type (if created): If a new port is created, its type.
-
Origin port: The port of this element at the origin node..
- Destination node: The destination node of this element.
- Create origin port: If checked, a new fiber port is created in the node for hosting this link.
-
New destination port type (if created): If a new port is created, its type.
-
Destination port: The port of this element at the end node..
- Bidirectional: If checked, a bidirectional element is created, or else a unidirectional one.
- Span length (in multi-span links)): In fiber links composed of multiple OTS sections, interconnected by amplifiers, this indicates the maximum span length in km.
Options: * Optical line amplifier (OLA): Creates amplifier nodes of the type Optical line amplifier (OLA) to place them between contiguous fiber spans. * Optical line amplifier (OLA): Creates amplifier nodes of the type Optical line amplifier (OLA) to place them between contiguous fiber spans. * Make WDM link: If checked, the created fiber span or sequence of fiber spans, is framed as an Optical Multiplexing Section (OMS), or WDM link.
Add a WDM link over existing fiber spans¶
Form to complete:
- Add a WDM link over existing fiber spans: This option permits adding a WDM link, assigning to it one or two (1+1) sequence of fiber spand interconnected by optical amplifiers, that should already exist (and not be part of other WDM link) in the underlying infrastructure..
- Origin node: The origin node of this element.
- Destination node: The destination node of this element.
- Bidirectional: If checked, a bidirectional element is created, or else a unidirectional one.
- WDM 1+1 line protection: If checked, the WDM link is configured with two paths, that must be disjoint. The first one is the working path, unless it fails. If so, the second path (protection path) will be used, unless it is also failed.
- Number of fiber paths to show: Indicates the number of paths to enumerate, and show for the user to choose among them.
- Primary path: The primary path of the WDM link. Chosen among the paths of idle fiber links between the end nodes (idle means that the fiber spans are not part of other WDM link).
- Backup path: The backup path of the WDM link. Can be chosen among the paths of idle fiber links between the end nodes (idle means that the fiber spans are not part of other WDM link).
Network Controller-AddTag¶
Form to complete:
- Tag: The tag string.
- Applicable elements: This selector indicates the elements to which this action is going to be applied. Options:
- Selected elements: The elements already selected by the user in the table before calling this action.
- All table elements: All the elements in the table, not applying any filter, and not considering any pagination.
Network Controller-RemoveTag¶
Form to complete:
- Tag: The tag string.
- Applicable elements: This selector indicates the elements to which this action is going to be applied. Options:
- Selected elements: The elements already selected by the user in the table before calling this action.
- All table elements: All the elements in the table, not applying any filter, and not considering any pagination.
Network Controller-RemoveAllTags¶
Form to complete:
- Applicable elements: This selector indicates the elements to which this action is going to be applied. Options:
- Selected elements: The elements already selected by the user in the table before calling this action.
- All table elements: All the elements in the table, not applying any filter, and not considering any pagination.
Ethernet link-AddTagToEndNodes¶
Form to complete:
- Tag: The tag string.
- Applicable elements: This selector indicates the elements to which this action is going to be applied. Options:
- Selected elements: The elements already selected by the user in the table before calling this action.
- All table elements: All the elements in the table, not applying any filter, and not considering any pagination.
Ethernet link-RemoveTagFromEndNodes¶
Form to complete:
- Tag: The tag string.
- Applicable elements: This selector indicates the elements to which this action is going to be applied. Options:
- Selected elements: The elements already selected by the user in the table before calling this action.
- All table elements: All the elements in the table, not applying any filter, and not considering any pagination.
Network Controller-AddAttribute¶
Form to complete:
- Key: The attributes key, or name.
- Value: The attribute value, to associate to the attribute name.
- Applicable elements: This selector indicates the elements to which this action is going to be applied. Options:
- Selected elements: The elements already selected by the user in the table before calling this action.
- All table elements: All the elements in the table, not applying any filter, and not considering any pagination.
Network Controller-RemoveAttribute¶
Form to complete:
- Key: The attributes key, or name.
- Applicable elements: This selector indicates the elements to which this action is going to be applied. Options:
- Selected elements: The elements already selected by the user in the table before calling this action.
- All table elements: All the elements in the table, not applying any filter, and not considering any pagination.
Network Controller-RemoveAllAttributes¶
Form to complete:
- Applicable elements: This selector indicates the elements to which this action is going to be applied. Options:
- Selected elements: The elements already selected by the user in the table before calling this action.
- All table elements: All the elements in the table, not applying any filter, and not considering any pagination.