chore(docs): add image-method example

[jeertmans]

No description provided.

[github-actions]

Rust benchmark results:

group                                                       before                                 changes
-----                                                       ------                                 -------
complete_graph_all_paths/iter                               1.00     24.1±0.51ns 39.6 MElem/sec    1.01     24.4±0.36ns 39.1 MElem/sec
complete_graph_all_paths_array_chunks/1                     1.00     32.9±0.31ns 29.0 MElem/sec    1.00     32.9±0.43ns 29.0 MElem/sec
complete_graph_all_paths_array_chunks/10                    1.04   362.5±15.32ns 26.3 MElem/sec    1.00   348.4±11.64ns 27.4 MElem/sec
complete_graph_all_paths_array_chunks/100                   1.00      2.4±0.03µs 39.4 MElem/sec    1.07      2.6±0.22µs 37.0 MElem/sec
complete_graph_all_paths_array_chunks/1000                  1.00     22.1±0.13µs 43.1 MElem/sec    1.00     22.2±0.35µs 43.0 MElem/sec
di_graph_from_complete_graph_all_paths/iter                 1.00    231.5±2.03ns  4.1 MElem/sec    1.00    232.7±3.92ns  4.1 MElem/sec
di_graph_from_complete_graph_all_paths_array_chunks/1       1.00    244.2±4.13ns  3.9 MElem/sec    1.00    244.4±1.77ns  3.9 MElem/sec
di_graph_from_complete_graph_all_paths_array_chunks/10      1.00      2.6±0.04µs  3.7 MElem/sec    1.02      2.7±0.04µs  3.6 MElem/sec
di_graph_from_complete_graph_all_paths_array_chunks/100     1.00     24.0±0.19µs  4.0 MElem/sec    1.00     24.0±0.45µs  4.0 MElem/sec
di_graph_from_complete_graph_all_paths_array_chunks/1000    1.02    234.8±7.16µs  4.1 MElem/sec    1.00    231.3±4.09µs  4.1 MElem/sec

[github-actions]

Python benchmark results:

------------------------------ benchmark 'test_complete_graph_all_paths': 3 tests -----------------------------
Name (time in ns)                                    Mean              StdDev            OPS (Mops/s)          
---------------------------------------------------------------------------------------------------------------
test_complete_graph_all_paths (0006_pgo)         576.0789 (1.0)      843.7685 (3.48)           1.7359 (1.0)    
test_complete_graph_all_paths (0010_before)      649.4300 (1.13)     242.7649 (1.0)            1.5398 (0.89)   
test_complete_graph_all_paths (0002_changes)     650.2568 (1.13)     986.8141 (4.06)           1.5379 (0.89)   
---------------------------------------------------------------------------------------------------------------

----------------------------- benchmark 'test_complete_graph_all_paths_array_chunks[1000]': 3 tests -----------------------------
Name (time in ns)                                                      Mean              StdDev            OPS (Mops/s)          
---------------------------------------------------------------------------------------------------------------------------------
test_complete_graph_all_paths_array_chunks[1000] (0001_changes)     57.4420 (1.19)     124.4289 (7.17)          17.4089 (0.84)   
test_complete_graph_all_paths_array_chunks[1000] (0005_pgo)         48.1622 (1.0)       17.3485 (1.0)           20.7632 (1.0)    
test_complete_graph_all_paths_array_chunks[1000] (0009_before)      55.8227 (1.16)      46.9910 (2.71)          17.9138 (0.86)   
---------------------------------------------------------------------------------------------------------------------------------

----------------------------- benchmark 'test_complete_graph_all_paths_array_chunks[100]': 3 tests -----------------------------
Name (time in ns)                                                     Mean              StdDev            OPS (Mops/s)          
--------------------------------------------------------------------------------------------------------------------------------
test_complete_graph_all_paths_array_chunks[100] (0011_before)      75.5062 (1.11)     295.6326 (1.0)           13.2439 (0.90)   
test_complete_graph_all_paths_array_chunks[100] (0008_pgo)         68.2161 (1.0)      460.4871 (1.56)          14.6593 (1.0)    
test_complete_graph_all_paths_array_chunks[100] (0004_changes)     76.9454 (1.13)     417.6508 (1.41)          12.9962 (0.89)   
--------------------------------------------------------------------------------------------------------------------------------

----------------------------- benchmark 'test_complete_graph_all_paths_array_chunks[10]': 3 tests ------------------------------
Name (time in ns)                                                     Mean              StdDev            OPS (Mops/s)          
--------------------------------------------------------------------------------------------------------------------------------
test_complete_graph_all_paths_array_chunks[10] (0008_pgo)         145.2429 (1.0)      237.8434 (7.24)           6.8850 (1.0)    
test_complete_graph_all_paths_array_chunks[10] (0011_before)      162.3634 (1.12)      32.8485 (1.0)            6.1590 (0.89)   
test_complete_graph_all_paths_array_chunks[10] (0004_changes)     165.1467 (1.14)     345.1840 (10.51)          6.0552 (0.88)   
--------------------------------------------------------------------------------------------------------------------------------

------------------------------- benchmark 'test_complete_graph_all_paths_array_chunks[1]': 3 tests ------------------------------
Name (time in ns)                                                    Mean                StdDev            OPS (Mops/s)          
---------------------------------------------------------------------------------------------------------------------------------
test_complete_graph_all_paths_array_chunks[1] (0010_before)      654.3011 (1.16)     1,175.2003 (1.0)            1.5283 (0.86)   
test_complete_graph_all_paths_array_chunks[1] (0002_changes)     694.8217 (1.24)     3,959.3734 (3.37)           1.4392 (0.81)   
test_complete_graph_all_paths_array_chunks[1] (0006_pgo)         561.6923 (1.0)      2,057.7689 (1.75)           1.7803 (1.0)    
---------------------------------------------------------------------------------------------------------------------------------

-------------------------------- benchmark 'test_di_graph_from_complete_graph_all_paths': 3 tests -------------------------------
Name (time in ns)                                                    Mean                StdDev            OPS (Kops/s)          
---------------------------------------------------------------------------------------------------------------------------------
test_di_graph_from_complete_graph_all_paths (0001_changes)     1,267.8648 (1.12)     2,222.6592 (1.38)         788.7276 (0.89)   
test_di_graph_from_complete_graph_all_paths (0005_pgo)         1,127.6606 (1.0)      8,337.0072 (5.17)         886.7916 (1.0)    
test_di_graph_from_complete_graph_all_paths (0009_before)      1,336.6329 (1.19)     1,613.3813 (1.0)          748.1486 (0.84)   
---------------------------------------------------------------------------------------------------------------------------------

----------------------------- benchmark 'test_di_graph_from_complete_graph_all_paths_array_chunks[1000]': 3 tests -----------------------------
Name (time in ns)                                                                     Mean             StdDev            OPS (Mops/s)          
-----------------------------------------------------------------------------------------------------------------------------------------------
test_di_graph_from_complete_graph_all_paths_array_chunks[1000] (0007_pgo)         255.0682 (1.03)     49.0603 (1.53)           3.9205 (0.97)   
test_di_graph_from_complete_graph_all_paths_array_chunks[1000] (0004_changes)     247.4345 (1.0)      32.1165 (1.0)            4.0415 (1.0)    
test_di_graph_from_complete_graph_all_paths_array_chunks[1000] (0011_before)      263.6394 (1.07)     36.2064 (1.13)           3.7931 (0.94)   
-----------------------------------------------------------------------------------------------------------------------------------------------

----------------------------- benchmark 'test_di_graph_from_complete_graph_all_paths_array_chunks[100]': 3 tests -----------------------------
Name (time in ns)                                                                    Mean             StdDev            OPS (Mops/s)          
----------------------------------------------------------------------------------------------------------------------------------------------
test_di_graph_from_complete_graph_all_paths_array_chunks[100] (0003_changes)     287.3354 (1.12)     63.5937 (1.65)           3.4803 (0.89)   
test_di_graph_from_complete_graph_all_paths_array_chunks[100] (0008_pgo)         256.6813 (1.0)      38.4454 (1.0)            3.8959 (1.0)    
test_di_graph_from_complete_graph_all_paths_array_chunks[100] (0012_before)      281.9165 (1.10)     39.0503 (1.02)           3.5471 (0.91)   
----------------------------------------------------------------------------------------------------------------------------------------------

------------------------------ benchmark 'test_di_graph_from_complete_graph_all_paths_array_chunks[10]': 3 tests -------------------------------
Name (time in ns)                                                                   Mean                StdDev            OPS (Mops/s)          
------------------------------------------------------------------------------------------------------------------------------------------------
test_di_graph_from_complete_graph_all_paths_array_chunks[10] (0007_pgo)         487.1203 (1.0)      1,228.1572 (1.46)           2.0529 (1.0)    
test_di_graph_from_complete_graph_all_paths_array_chunks[10] (0003_changes)     515.4272 (1.06)       843.3572 (1.0)            1.9401 (0.95)   
test_di_graph_from_complete_graph_all_paths_array_chunks[10] (0012_before)      560.4869 (1.15)     2,371.3371 (2.81)           1.7842 (0.87)   
------------------------------------------------------------------------------------------------------------------------------------------------

------------------------------- benchmark 'test_di_graph_from_complete_graph_all_paths_array_chunks[1]': 3 tests ------------------------------
Name (time in ns)                                                                    Mean              StdDev            OPS (Kops/s)          
-----------------------------------------------------------------------------------------------------------------------------------------------
test_di_graph_from_complete_graph_all_paths_array_chunks[1] (0007_pgo)         1,031.1017 (1.0)      275.3996 (1.12)         969.8365 (1.0)    
test_di_graph_from_complete_graph_all_paths_array_chunks[1] (0003_changes)     1,156.3492 (1.12)     245.2172 (1.0)          864.7906 (0.89)   
test_di_graph_from_complete_graph_all_paths_array_chunks[1] (0012_before)      1,184.5404 (1.15)     288.1201 (1.17)         844.2092 (0.87)   
-----------------------------------------------------------------------------------------------------------------------------------------------

Legend:
  Outliers: 1 Standard Deviation from Mean; 1.5 IQR (InterQuartile Range) from 1st Quartile and 3rd Quartile.
  OPS: Operations Per Second, computed as 1 / Mean

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 97.82%. Comparing base (68f75d8) to head (68cf19e).
Report is 119 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #110      +/-   ##
==========================================
+ Coverage   97.54%   97.82%   +0.27%     
==========================================
  Files          20       20              
  Lines         773      826      +53     
==========================================
+ Hits          754      808      +54     
+ Misses         19       18       -1     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.