scottk/oopt-gnpy
1
0
Fork 0
mirror of https://github.com/Telecominfraproject/oopt-gnpy.git synced 2025-10-29 09:12:37 +00:00
Code Issues Packages Projects Releases 10 Wiki Activity

fix documentation and release notes

Browse Source 
Signed-off-by: EstherLerouzic <esther.lerouzic@orange.com>
Change-Id: I18457b1bdebd92bdd547877760a039706ad995a3
This commit is contained in:
EstherLerouzic
2025-07-07 10:59:06 +02:00
parent e27e6d5c7b
commit 78227e65da
2 changed files with 114 additions and 72 deletions
Download Patch File Download Diff File Expand all files Collapse all files

153
docs/json.rst
View File

@@ -229,6 +229,9 @@ The modes are defined as follows:
+----------------------------+-----------+-----------------------------------------+ +----------------------------+-----------+-----------------------------------------+
| ``bit_rate`` | (number) | in bit/s | | ``bit_rate`` | (number) | in bit/s |
+----------------------------+-----------+-----------------------------------------+ +----------------------------+-----------+-----------------------------------------+
| ``min_spacing`` | (number) | in Hz. Min required slot size for this |
| | | mode. |
+----------------------------+-----------+-----------------------------------------+
| ``roll_off`` | (number) | Pure number between 0 and 1. TX signal | | ``roll_off`` | (number) | Pure number between 0 and 1. TX signal |
| | | roll-off shape. Used by Raman-aware | | | | roll-off shape. Used by Raman-aware |
| | | simulation code. | | | | simulation code. |
@@ -810,78 +813,84 @@ It also defines the channels to be propagated for the gnpy-transmission-example
Flexgrid channel partitioning is available since the 2.7 release via the extra ``--spectrum`` option. Flexgrid channel partitioning is available since the 2.7 release via the extra ``--spectrum`` option.
In the simplest case, homogeneous channel allocation can be defined via the ``SpectralInformation`` construct which defines a spectrum of N identical carriers: In the simplest case, homogeneous channel allocation can be defined via the ``SpectralInformation`` construct which defines a spectrum of N identical carriers:
+----------------------+-----------+-------------------------------------------+ +-------------------------------------+-----------+-------------------------------------------+
| field | type | description | | field | type | description |
+======================+===========+===========================================+ +=====================================+===========+===========================================+
| ``type_variety`` | (string) | Optional. Default: ``default`` | | ``type_variety`` | (string) | Optional. Default: ``default`` |
| | | A unique name to ID the band for | | | | A unique name to ID the band for |
| | | propagation or design. | | | | propagation or design. |
+----------------------+-----------+-------------------------------------------+ +-------------------------------------+-----------+-------------------------------------------+
| ``f_min``, | (number) | In Hz. Define spectrum boundaries. Note | | ``f_min``, ``f_max`` | (number) | In Hz. Define spectrum boundaries. Note |
| ``f_max`` | | that due to backward compatibility, the | | | | that due to backward compatibility, the |
| | | first channel central frequency is placed | | | | first channel central frequency is placed |
| | | at :math:`f_{min} + spacing` and the last | | | | at :math:`f_{min} + spacing` and the last |
| | | one at :math:`f_{max}`. | | | | one at :math:`f_{max}`. |
+----------------------+-----------+-------------------------------------------+ +-------------------------------------+-----------+-------------------------------------------+
| ``baud_rate`` | (number) | In Hz. Simulated baud rate. | | ``baud_rate`` | (number) | In Hz. Simulated baud rate. |
+----------------------+-----------+-------------------------------------------+ +-------------------------------------+-----------+-------------------------------------------+
| ``spacing`` | (number) | In Hz. Carrier spacing. | | ``spacing`` | (number) | In Hz. Carrier spacing. |
+----------------------+-----------+-------------------------------------------+ +-------------------------------------+-----------+-------------------------------------------+
| ``roll_off`` | (number) | Pure number between 0 and 1. TX signal | | ``roll_off`` | (number) | Pure number between 0 and 1. TX signal |
| | | roll-off shape. Used by Raman-aware | | | | roll-off shape. Used by Raman-aware |
| | | simulation code. | | | | simulation code. |
+----------------------+-----------+-------------------------------------------+ +-------------------------------------+-----------+-------------------------------------------+
| ``tx_osnr`` | (number) | In dB. OSNR out from transponder. | | ``tx_osnr`` | (number) | In dB. OSNR out from transponder. |
+----------------------+-----------+-------------------------------------------+ +-------------------------------------+-----------+-------------------------------------------+
| ``power_dbm`` | (number) | In dBm. Target input power in spans to | | ``power_dbm`` | (number) | In dBm. Target input power in spans to |
| | | be considered for the design | | | | be considered for the design |
| | | In gain mode | | | | In gain mode |
| | | (see spans/power_mode = false), if no | | | | (see spans/power_mode = false), if no |
| | | gain is set in an amplifier, auto-design | | | | gain is set in an amplifier, auto-design |
| | | sets gain to meet this reference | | | | sets gain to meet this reference |
| | | power. If amplifiers gain is set, | | | | power. If amplifiers gain is set, |
| | | ``power_dbm`` is | | | | ``power_dbm`` is |
| | | ignored. | | | | ignored. |
| | | | | | | |
| | | In power mode, the ``power_dbm`` | | | | In power mode, the ``power_dbm`` |
| | | is the reference power for | | | | is the reference power for |
| | | the ``delta_p`` settings in amplifiers. | | | | the ``delta_p`` settings in amplifiers. |
| | | It is also the reference power for | | | | It is also the reference power for |
| | | auto-design power optimisation range | | | | auto-design power optimisation range |
| | | Spans/delta_power_range_db. For example, | | | | Spans/delta_power_range_db. For example, |
| | | if delta_power_range_db = `[0,0,0]`, the | | | | if delta_power_range_db = `[0,0,0]`, the |
| | | same power=power_dbm is launched in every | | | | same power=power_dbm is launched in every |
| | | spans. The network design is performed | | | | spans. The network design is performed |
| | | with the power_dbm value: even if a | | | | with the power_dbm value: even if a |
| | | power sweep is defined (see after) the | | | | power sweep is defined (see after) the |
| | | design is not repeated. | | | | design is not repeated. |
| | | | | | | |
| | | If the ``--power`` CLI option is used, | | | | If the ``--power`` CLI option is used, |
| | | its value replaces this parameter. | | | | its value replaces this parameter. |
+----------------------+-----------+-------------------------------------------+ +-------------------------------------+-----------+-------------------------------------------+
| ``tx_power_dbm`` | (number) | In dBm. Optional. Power out from | | ``tx_power_dbm`` | (number) | In dBm. Optional. Power out from |
| | | transceiver. Default = power_dbm | | | | transceiver. Default = power_dbm |
+----------------------+-----------+-------------------------------------------+ +-------------------------------------+-----------+-------------------------------------------+
| ``power_range_db`` | (number) | Power sweep excursion around | | ``power_range_db`` | (number) | Power sweep excursion around |
| | | ``power_dbm``. | | | | ``power_dbm``. |
| | | This defines a list of reference powers | | | | This defines a list of reference powers |
| | | to run the propagation, in the range | | | | to run the propagation, in the range |
| | | power_range_db + power_dbm. | | | | power_range_db + power_dbm. |
| | | Power sweep uses the ``delta_p`` targets | | | | Power sweep uses the ``delta_p`` targets |
| | | or, if they have not been set, the ones | | | | or, if they have not been set, the ones |
| | | computed by auto-design, regardless of | | | | computed by auto-design, regardless of |
| | | of preceding amplifiers' power | | | | of preceding amplifiers' power |
| | | saturation. | | | | saturation. |
| | | | | | | |
| | | Power sweep is an easy way to find the | | | | Power sweep is an easy way to find the |
| | | optimal reference power. | | | | optimal reference power. |
| | | | | | | |
| | | Power sweep excursion is ignored in case | | | | Power sweep excursion is ignored in case |
| | | of gain mode. | | | | of gain mode. |
+----------------------+-----------+-------------------------------------------+ +-------------------------------------+-----------+-------------------------------------------+
| ``sys_margins`` | (number) | In dB. Added margin on min required | | ``sys_margins`` | (number) | In dB. Added margin on min required |
| | | transceiver OSNR. | | | | transceiver OSNR. |
+----------------------+-----------+-------------------------------------------+ +-------------------------------------+-----------+-------------------------------------------+
| ``use_si_channel_count_for_design`` | (boolean) | Optional. If True, the design uses the SI |
| | | definition for channel count computation |
| | | instead of the amplifier bandwidth. |
| | | This option enable to reproduce legacy |
| | | behaviour. |
+-------------------------------------+-----------+-------------------------------------------+
It is possible to define a set of bands in the SI block. In this case, type_variety must be used. It is possible to define a set of bands in the SI block. In this case, type_variety must be used.
Each set defines a reference channel used for design functions and autodesign processes. Each set defines a reference channel used for design functions and autodesign processes.

33
docs/release-notes.rst
View File

@@ -7,13 +7,20 @@ Release change log
Each release introduces some changes and new features. Each release introduces some changes and new features.
(prepare text for next release) (prepare text for next release)
**Environment**
The windows-2019 environment is no more supported.
**Yang Conversion Utilities** **Yang Conversion Utilities**
This release introduces new conversion utilities to facilitate conversion between YANG and legacy formats, This release introduces new conversion utilities to facilitate conversion between YANG and legacy formats,
ensuring full compatibility with GNPy. The "legacy" format also benefit from the YANG validation for ensuring full compatibility with GNPy. The "legacy" format also benefit from the YANG validation for
a stricter verification of input files. a stricter verification of input files.
Console Script for Yang Conversion: Added a new command-line script to perform Yang format conversions easily. Console Script for Yang Conversion: Added a new command-line script to perform Yang format conversions easily.
**Design Enhancements** **Design Enhancements**
This release adds the ability to parametrize power target calculations, allowing customization of reference This release adds the ability to parametrize power target calculations, allowing customization of reference
span loss and deviation ratios. It implements the use of a reference channel per OMS (Optical Multiplex Section) span loss and deviation ratios. It implements the use of a reference channel per OMS (Optical Multiplex Section)
instead of total power for design calculations, improving accuracy and performance. instead of total power for design calculations, improving accuracy and performance.
@@ -21,11 +28,13 @@ It also includes spacing information in design band data to assist in maximum po
targets compution during autodesign. targets compution during autodesign.
**Excel handling** **Excel handling**
XLSX files are now read with openpyxl library (while XLS files are still read with xlrd library). Latest release of XLSX files are now read with openpyxl library (while XLS files are still read with xlrd library). Latest release of
xlrd is supported, which solves compatibility issues with anaconda install. xlrd is supported, which solves compatibility issues with anaconda install.
v2.12 v2.12
===== =====
**Important Changes:** **Important Changes:**
The default values for EDFA configuration, including frequency range, gain ripple, noise figure ripple, or dynamic gain tilt The default values for EDFA configuration, including frequency range, gain ripple, noise figure ripple, or dynamic gain tilt
@@ -35,6 +44,30 @@ However, users can define their own custom parameters using the default_config_f
This change streamlines the configuration process but requires users to explicitly set parameters through the new This change streamlines the configuration process but requires users to explicitly set parameters through the new
model if the default values do not suit their needs via the --extra-config option. model if the default values do not suit their needs via the --extra-config option.
v2.11.1
-------
**Environment**
The macOS-12 environment is no more supported.
**per degree impairment enabled in xls input**
This release now read per degre roadm-path impairment from roadm sheet
Several optional columns are added: 'type_variety' and 'from degrees'
and 'from degree to degree impairment id'.
- 'from degrees' can contain a list of degrees separated with ' | ', then the
'from degree to degree impairment id' must contain a list of ids of the same
length.
Impairment ids are expected to be defined in the ROADM equipment library and
from degree must be among the previous node from this ROADM.
**optimizing computation speed**
The computation of path is skipped if the provided include nodes provides
a complete explicit path (speeds simulation time).
v2.11 v2.11
===== =====