动态群体演化（temporal_graph)
功能介绍
针对包含某些节点的群体，结合时间轴观察其结构的动态演化过程 。
URL
POST /ges/v1.0/{project_id}/graphs/{graph_name}/dynamicgraphs/action?action_id=execute-analysis
|
参数 |
是否必选 |
类型 |
说明 |
|---|---|---|---|
|
project_id |
是 |
String |
项目ID。获取方法请参见获取项目ID。 |
|
graph_name |
是 |
String |
图名称。 |
请求参数
|
参数 |
是否必选 |
类型 |
说明 |
|---|---|---|---|
|
algorithmName |
是 |
String |
算法名称，取值为temporal_graph。 |
|
dynamicRange |
是 |
Object |
动态分析时间参数。 |
|
parameters |
是 |
String |
算法参数。 |
|
参数 |
是否必选 |
类型 |
说明 |
|---|---|---|---|
|
start |
是 |
Date或Integer |
动态分析时间边界的开始时间。注意：start <= end |
|
end |
是 |
Date或Integer |
动态分析时间边界的结束时间。 |
|
time_props |
是 |
Object |
动态分析的时间属性定义。 |
|
参数 |
是否必选 |
类型 |
说明 |
|---|---|---|---|
|
stime |
是 |
String |
动态图开始时间的属性名称。 |
|
etime |
是 |
String |
动态图结束时间的属性名称。 |
|
参数 |
是否必选 |
类型 |
说明 |
|---|---|---|---|
|
source |
是 |
String |
群体内包含的节点id，最多输入100000个节点。 |
|
temporal_vertex |
否 |
Boolean |
是否对节点执行群体演化，默认为false。 |
响应参数
|
参数 |
类型 |
说明 |
|---|---|---|
|
errorMessage |
String |
系统提示信息，执行成功时，字段可能为空。执行失败时，用于显示错误信息。 |
|
errorCode |
String |
系统提示信息，执行成功时，字段可能为空。执行失败时，用于显示错误码。 |
|
data |
Json |
结果详情数据，具体请参见data参数说明。 |
请求样例
观察某些节点群体结构的动态演化过程，算法名称为temporal_graph，动态分析的开始时间为${startTime}，结束时间为${endTime}。
POST http://{SERVER_URL}/ges/v1.0/{project_id}/graphs/{graph_name}/dynamicgraphs/action?action_id=execute-analysis
{
"algorithmName":"temporal_graph",
"dynamicRange":{
"start":"${startTime}",
"end":"${endTime}",
"time_props":{"stime":"${property(start_time)}","etime":"${property(start_time)}"}
},
"parameters":{
"sources":[],
"temporal_vertex":false
}
}
响应示例
状态码： 200
成功响应示例
Http Status Code: 200
{
"data": {
"vertices": [{
"id": "Place00032",
"label": "Place",
"properties": {}
}, {
"id": "Person00041",
"label": "Person",
"properties": {
"gender": ["女"],
"phone": ["P0334529194"],
"name": ["吴桂芳"],
"startTime": [1774368],
"endTime": [16756560],
"age": [48]
}
}],
"edges": [{
"index": "0",
"source": "Person00041",
"label": "hasVisit",
"properties": {
"startTime": [1646092800],
"visitDate": [20220301],
"endTime": [1646126769]
},
"target": "Place00032"
}, {
"index": "3",
"source": "Person00041",
"label": "hasVisit",
"properties": {
"startTime": [1646168289],
"visitDate": [20220301],
"endTime": [1646179199]
},
"target": "Place00032"
}]
}
}
状态码： 400
失败响应示例
Http Status Code: 400
{
"errorMessage": "Dynamic Analysis is not supported in this instance. Please build dynamic graph instance",
"errorCode": "GES.9001"
}
状态码
|
返回值 |
说明 |
|---|---|
|
400 Bad Request |
请求错误。 |
|
401 Unauthorized |
鉴权失败。 |
|
403 Forbidden |
没有操作权限。 |
|
404 Not Found |
找不到资源。 |
|
500 Internal Server Error |
服务内部错误。 |
|
503 Service Unavailable |
服务不可用。 |
