# 使用HyG算法分析图
GES服务为您提供了丰富的基础图算法、图分析算法和图指标算法，您可以使用图算法做关系分析等。
#### 前提条件
前端创建持久化版图时，选择开启HyG计算引擎。
图1HyG计算引擎   
![](https://support.huaweicloud.com/api-ges/zh-cn_image_0000001812353720.png)
#### 操作步骤
1. 创建HyG图。
   1. 发送"POST /ges/v1.0/{project_id}/hyg/{graph_name}"，project_id为项目ID，graph_name为图数据库中已创建的图名。
   
   2. 在Request Header中增加"X-Auth-Token"。
   
   3. 在Request Body中传入参数如下：
      ```
      {
          "inEdge": true  //图是否包含入边
      }
      ```
      
   
   4. 查看请求响应结果。请求成功时，响应参数如下：
      ```
      {
          "result": "success"
      }
      ```
      请求异常时，错误码请参见[错误码](https://support.huaweicloud.com/api-ges/ges_03_0110.html)。
      
    
2. HyG图数据同步，将图数据库的数据同步到HyG计算引擎。
   1. 发送"POST /ges/v1.0/{project_id}/hyg/{graph_name}/sync"，project_id为项目ID，graph_name为图名。
   
   2. 在Request Header中增加"X-Auth-Token"。
   
   3. 在Request Body中传入参数如下：
      ```
      {
          "vertex": [],  //点属性列表
       
          "edge": [
              {
                  "property": [
                      "Rating"
                  ],
                  "label": "rate"
              }
          ]  //边属性列表
      }
      ```
      
   
   4. 根据JobId查看请求响应结果。请求成功时，响应参数如下：
      ```
      {
          "status": "complete",
          "result": "success"
      }
      ```
      请求异常时，错误码请参见[错误码](https://support.huaweicloud.com/api-ges/ges_03_0110.html)。
      如果对图数据库执行了增、删、改操作，使用该接口可以将图数据库的修改信息同步到HyG计算引擎。首次执行数据同步时，请求body里面的vertex和edge参数生效，后续执行数据同步，该参数默认跟首次指定的保持一致。
      
    
3. 查询HyG图详情。
   1. 发送"GET /ges/v1.0/{project_id}/hyg/{graph_name}/summary"，project_id为项目ID，graph_name为图名。
   
   2. 在Request Header中增加"X-Auth-Token"。
   
   3. 查看请求响应结果。请求成功时，响应参数如下：
      ```
      {
          "data": {
              "inEdge": true,
              "idIndex": true,
              "policy": "oec",
              "updateTime": "2024-01-25 10:55:31",
              "vertex": [],
              "edge": [
                  {
                      "label": "rate",
                      "property": [
                          "Rating"
                      ]
                  }
              ],
              "vertexNum": 146,
              "edgeNum": 1659
          },
          "result": "success"
      }
      ```
      请求异常时，错误码请参见[错误码](https://support.huaweicloud.com/api-ges/ges_03_0110.html)。
      
    
4. 执行算法
   1. 发送"POST /ges/v1.0/{project_id}/hyg/{graph_name}/algorithm"，project_id为项目ID，graph_name为图名。
   
   2. 在Request Header中增加"X-Auth-Token"。
   
   3. 在Request Body中传入参数如下（以pagerank为例）。
      ```
      {
      "algorithmName":"pagerank",
        "parameters":{
              "alpha":0.85,
              "convergence":0.00001,
              "max_iterations":1000,
              "directed":true
        }
      }
      ```
      
   
   4. 根据JobId查看请求响应结果。请求成功时，响应参数如下：
      ```
      {
          "status": "complete",
          "data": {
              "outputs": {
                  "data_offset": 0,
                  "data_return_size": 147,
                  "data_total_size": 147,
                  "pagerank": [
                      {
                          "38": 0.02115960730038959
                      },
                      {
                          "13": 0.018535705068819635
                      },
                      {
                          "7": 0.0166381431701182
                      },
                      … …
                  ],
                  "runtime": 0.022
              }
          },
          "result": "success"
      }
      ```
      请求异常时，错误码请参见[错误码](https://support.huaweicloud.com/api-ges/ges_03_0110.html)。
      
    
5. 删除HyG图。
   1. 发送"DELETE /ges/v1.0/{project_id}/hyg/{graph_name}"，project_id为项目ID，graph_name为图名。
   
   2. 在Request Header中增加"X-Auth-Token"。
   
   3. 根据jobId查看请求响应结果。请求成功时，响应参数如下：
      ```
      {
          "status": "complete",
          "result": "success"
      }
      ```
      请求异常时，错误码请参见[错误码](https://support.huaweicloud.com/api-ges/ges_03_0110.html)。