New drawing style

[thomasrobiglio]

Related to #358, allows for new drawing style where hyperedges/simplices of different orders are draw on different layers of a 3-dimensional plot.

[codecov]

Codecov Report

Patch coverage: 100.00% and project coverage change: +0.13 🎉

Comparison is base (76e9295) 90.58% compared to head (5563578) 90.72%.

❗ Current head 5563578 differs from pull request most recent head f99cb4f. Consider uploading reports for the commit f99cb4f to get more accurate results

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #369      +/-   ##
==========================================
+ Coverage   90.58%   90.72%   +0.13%     
==========================================
  Files          41       41              
  Lines        3060     3105      +45     
==========================================
+ Hits         2772     2817      +45     
  Misses        288      288              

Impacted Files	Coverage Δ
xgi/drawing/draw.py	76.02% <100.00%> (+3.63%)	⬆️

☔ View full report in Codecov by Sentry.
📢 Do you have feedback about the report comment? Let us know in this issue.

[nwlandry]

Thanks for this contribution, @thomasrobiglio! Looks great 🤩. My only question is, Is there a reason for using PolyCollection instead of scatter for the nodes? Also maybe you can open an issue on allowing 3d axes in draw_nodes(), draw_hyperedges(), etc? Overall, great work!

[thomasrobiglio]

Thank you for the comment @nwlandry!

Actually I'm not sure I understand you question - I use ax.scatter to draw the nodes at line 1417 and use Poly3DCollection at line 1409 to create the hyperedges that are then added as a 3d collection.

About opening the issues we can for sure do that. I'm a bit afraid that using draw_nodes() or draw_hyperedges() in this function would require to modify a lot the original functions while it might be easier to open issues (or do that on this PR 😄) about expanding this function to allow the same personalisation possibilities we have in the other plotting functions (e.g. edges/nodes labels or nodes' size/color from stats ...). Let me know what you think about that!

[nwlandry]

Looks great to me! The comments that I was suggesting don't seem feasible.

[maximelucas]

It looks very pretty @thomasrobiglio thanks :) I even showed it to my class on Friday hehe.

[leotrs]

Thank you so much @thomasrobiglio !