Deploy updated documentation HTML pages in EGGPU

Author: eggpig

docs/.buildinfo

@@ -1,4 +1,4 @@
 # Sphinx build info version 1
-# This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
-config: 7192bb01cb11925cfee048363011ddbc
+# This file records the configuration used when building these files. When it is not found, a full rebuild will be done.
+config: ee9d4dca1a41b2451476f1b60504ade0
 tags: 645f666f9bcd5a90fca523b33c5a78b7

docs/.buildinfo.bak

@@ -0,0 +1,4 @@
+# Sphinx build info version 1
+# This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
+config: 7192bb01cb11925cfee048363011ddbc
+tags: 645f666f9bcd5a90fca523b33c5a78b7

docs/_images/res_clusterings.png

@@ -17,6 +17,7 @@ EGGPU is engineered with a three-layer architecture:
 .. image:: eggpu_architecture.png
    :align: center
 
+
 Installation
 +++++++++++++
 
@@ -39,3 +40,54 @@ On Windows
    git clone --recursive https://github.com/easy-graph/Easy-Graph
    set EASYGRAPH_ENABLE_GPU=TRUE
    pip install ./Easy-Graph
+
+Benchmarking and Performance Evaluation
++++++++++++++
+
+Our experiments were conducted on a machine equipped with a 12th Gen Intel Core i9-12900K CPU (16 cores, 24 logical processors) and an NVIDIA GeForce RTX 4090 GPU (114 SMs, 1536 max threads per SM, GPU clock speed: 2520.0 MHz, memory clock speed: 10501.0 MHz). The CUDA-based implementations demonstrated **significant acceleration**, as shown in the benchmark results below.
+
+.. list-table::
+   :widths: 50 50
+   :header-rows: 0
+
+   * - .. image:: res_clusterings.png
+          :align: center
+     - .. image:: res_constraint.png
+          :align: center
+
+
+
+Examples
++++++++++++++
+
+We provide a comprehensive guide to EGGPU's GPU-accelerated functions within the **EasyGraph** ecosystem, demonstrating both native NVCC compilation of CUDA kernels and seamless invocation via our Python API.
+
+
+.. code-block:: python
+
+   import easygraph as eg
+
+   def add_weighted(G):
+   G.add_edges(
+   [(0,1),(0,2),(0,3),(1,2),(1,3),(1,5),(2,3),(2,4),(3,5),
+   (5,6),(5,8),(6,7),(6,8),(7,8)],
+   edges_attr=[
+   {'weight': 1},{'weight': 3},{'weight': 2},{'weight': 1},
+   {'weight': 2},{'weight': 4},{'weight': 2},{'weight': 1},
+   {'weight': 2},{'weight': 1},{'weight': 2},{'weight': 4},
+   {'weight': 3},{'weight': 3},
+   ]
+   )
+   G_gpu = eg.GraphC()
+   add_weighted(G_gpu)
+
+   print(eg.constraint(G_gpu, weight="weight"))
+   """
+   [0.73650971 0.62929697 0.58577806 0.64878836 0.4685571  1.
+   0.83901931 0.78530837 0.94929847]
+   """
+   print(eg.effective_size(G_gpu, weight="weight"))
+   """
+   [1.76388889 2.54166667 2.94047619 2.70833333 3.16666667 1.
+   1.94791667 2.09375    1.10714286]
+   """

docs/_images/res_constraint.png

@@ -1,12 +1,5 @@
 /*
- * basic.css
- * ~~~~~~~~~
- *
  * Sphinx stylesheet -- basic theme.
- *
- * :copyright: Copyright 2007-2023 by the Sphinx team, see AUTHORS.
- * :license: BSD, see LICENSE for details.
- *
  */
 
 /* -- main layout ----------------------------------------------------------- */
@@ -55,7 +48,7 @@ div.sphinxsidebarwrapper {
 
 div.sphinxsidebar {
     float: left;
-    width: 270px;
+    width: 230px;
     margin-left: -100%;
     font-size: 90%;
     word-wrap: break-word;
@@ -115,15 +108,11 @@ img {
 /* -- search page ----------------------------------------------------------- */
 
 ul.search {
-    margin: 10px 0 0 20px;
-    padding: 0;
+    margin-top: 10px;
 }
 
 ul.search li {
-    padding: 5px 0 5px 20px;
-    background-image: url(file.png);
-    background-repeat: no-repeat;
-    background-position: 0 7px;
+    padding: 5px 0;
 }
 
 ul.search li a {
@@ -237,6 +226,10 @@ a.headerlink {
     visibility: hidden;
 }
 
+a:visited {
+    color: #551A8B;
+}
+
 h1:hover > a.headerlink,
 h2:hover > a.headerlink,
 h3:hover > a.headerlink,

docs/_sources/eggpu.rst.txt

@@ -1,5 +1,4 @@
-var DOCUMENTATION_OPTIONS = {
-    URL_ROOT: document.getElementById("documentation_options").getAttribute('data-url_root'),
+const DOCUMENTATION_OPTIONS = {
     VERSION: '1.4.1',
     LANGUAGE: 'en',
     COLLAPSE_INDEX: false,

docs/_static/basic.css

@@ -1,19 +1,12 @@
 /*
- * language_data.js
- * ~~~~~~~~~~~~~~~~
- *
  * This script contains the language-specific data used by searchtools.js,
  * namely the list of stopwords, stemmer, scorer and splitter.
- *
- * :copyright: Copyright 2007-2023 by the Sphinx team, see AUTHORS.
- * :license: BSD, see LICENSE for details.
- *
  */
 
 var stopwords = ["a", "and", "are", "as", "at", "be", "but", "by", "for", "if", "in", "into", "is", "it", "near", "no", "not", "of", "on", "or", "such", "that", "the", "their", "then", "there", "these", "they", "this", "to", "was", "will", "with"];
 
 
-/* Non-minified version is copied as a separate JS file, is available */
+/* Non-minified version is copied as a separate JS file, if available */
 
 /**
  * Porter Stemmer