New function - viz.plot_network_highlighted_clusters (collaborating with Remy Cazabet at UCBL)

[amineitji]

New function - viz.plot_network_highlighted_clusters

💻 Are you changing functionalities?

Description of the Change

This pull request introduces a new function called plot_network_highlighted_clusters to the CDlib library. This function serves as an intermediary between the existing functions plot_network_clusters and plot_community_graph. It is designed to visualize networks with highlighted communities, node color coding for communities, and polygons drawn around clusters.

Alternate Designs

No alternate designs were considered for this function.

Possible Drawbacks

Users may need to familiarize themselves with the new function and its parameters.

Verification Process

To verify the correctness of this change, I followed these steps:

1. I manually inspected the code changes to ensure they align with the provided specifications.
2. I ran the example provided in the function's docstring to visualize a sample network with highlighted communities.
3. I tested various combinations of parameters to ensure they produce expected results and do not cause any errors.
4. I reviewed the documentation to ensure it accurately describes the purpose and usage of the new function.

Release Notes

This improvement introduces a new function plot_network_highlighted_clusters as an intermediary between plot_network_clusters and plot_community_graph functions. It enables users to visualize networks with highlighted communities, node color coding for communities, and polygons drawn around clusters.