Gnpy

New Features
- **Documentation Updates**:
- Moved and updated documentation on equipment types and amplifiers for better organization and accessibility.
- Improved documentation for script options, providing clearer guidance for users.
- Added a list of collaborative PSE publications to the documentation.

- **Enhanced Configuration Management**:
- The default values for EDFA configuration, including frequency range, gain ripple, noise figure ripple, or dynamic gain tilt are now hardcoded in parameters.py and are no longer read from the `default_edfa_config.json` file.
- Introduced the ability to read a list of optional extra equipment files, allowing for more flexible configuration.
- Users can now input their own default configuration file with the new `default_config_from_json` attribute for fixed and variable gain amplifiers.

Refactoring:
- Refactored methods to avoid unnecessary returns when modifying equipment dictionaries, streamlining the code.
- Defined defaults in common parts to be utilized by both CLI and API, enhancing consistency across interfaces.

Release Notes

New Features
- **Enhanced Warning System for Amplifiers**: Added more warnings when user settings do not match the library, improving user awareness of potential issues.
- **ROADM Excel Sheet Input Documentation**: Comprehensive documentation has been added for the ROADM Excel sheet input, aiding users in understanding the input requirements.
- **Per Degree Impairment Reading from Excel inputs**: The program now supports reading per degree impairment from the ROADM sheet, allowing for more detailed impairment management.

Bug Fixes
- **Plot Functionality**: Resolved an issue where the plot function would overwrite the path variable, causing errors in plotting.
- **Tilt-Target Default Value**: Adjusted the handling of the tilt-target to maintain a `None` value when not specified by the user, rather than defaulting to 0 dB.
- **UID Information in Logs**: Restored UID information in warning logs for better traceability.
- **Multiple Multiband Amplifiers**: Fixed a case where multiple multiband amplifiers matching the sub amplifier type could cause issues.
- **Offset Handling**: Corrected the offset handling for reversed paths to ensure accurate calculations.
- **Autodesign File Saving**: Ensured that the autodesign file is saved correctly after the autodesign process.
- **Linter Issues**: Addressed various linter issues across multiple files, improving code quality and maintainability.

These updates enhance the overall functionality and user experience of the program. Thank you for your continued support!

**Full Changelog**: https://github.com/Telecominfraproject/oopt-gnpy/compare/v2.11...v2.11.1

This release enables the definition of a multiband amplifier site composed of multiple amplifiers, each for a separated band (a typical application is C+L transmission).

The release also includes autodesign for links (Optical Multiplex Section, OMS) composed of multi_band amplifiers. Multi_band autodesign includes basic tilt and tilt_target calculation when the Raman flag is enabled with the --sim-params option.

The spectrum is demultiplexed before propagation in the amplifier and multiplexed at the amplifier output before the propagation in the output fiber.

A preturbative Raman solution and an approximated GGN model are introduced for a faster evaluation of the Raman and Kerr effects, respectively. These implementations are intended to reduce the computational effort required for multiband transmission simulations.

This release introduces detailed impairments for ROADMs:
ROADM impairments can be defined per degree and roadm-path type (add, drop or express).
Minimum loss when crossing a ROADM is no more 0 dB. It can be set per ROADM degree with roadm-path-impairments.

The transceiver output power, which was previously set using the same parameter as the input span power (power_dbm),
can now be set using a different parameter.

This release introduces a major refactor that enables
a clear separation of design and propagation functions.
It also introduces some behaviour correction and bug fixes.

- fix frequency scaling for fibers
- fix documentation on readthedocs.io
- possible to freeze a design and propagate on it without automatic changes
- checking for power saturation during design for all cases

This new release adds some improvements in existing features,
and some new features:
- Spectrum assignment now supports multiple slots assignments
in a single request.
- Logs are now generalized in the library instead of bare
prints. Default verbose is "WARNING".
- Chromatic dispersion, effective area, Raman Gain coefficient,
and nonlinear coefficient can now be defined with a scaling
along frequency.
- Power equalization now enables defining a power offset
in transceiver library to represent the deviation from the
general equalisation strategy defined in ROADMs.
- Propagation now includes a latency calculation
- The library now supports of python 3.12