---
title: kuqcd_load_gaugefield
description: "加载规范场对象"
url: https://www.hikunpeng.com/document/detail/zh/kunpenghpcs/hpckit/devg/KunpengHPCKit_developer_221.html
sourcePath: /source/zh/kunpenghpcs/hpckit/devg/KunpengHPCKit_developer_221.html
indexId: 190e0783f968c04537d11dac2e1d53440a86e939f15e4de0f31453899391e50d67
---
# kuqcd_load_gaugefield

加载规范场对象

#### 接口定义

KuQCDStatus kuqcd_load_gaugefield(void *h_gauge, KuQCDGaugeParam *param);


#### 参数

| 参数名 | 类型 | 描述 | 输入/输出 |
| --- | --- | --- | --- |
| h\_gauge | void \* | 规范场的数据 | 输入 |
| param | KuQCDGaugeParam \* | 规范场的配置选项，具体内容如表表1所示 | 输入 |


**表1 KuQCDGaugeParam结构体字段描述**

| 字段名 | 类型 | 描述 |
| --- | --- | --- |
| lat | unsigned int [4] | x,y,z,t方向格点数 |
| halo\_depth | int | halo区大小，对于旋量场取0；对于规范场，若做rhmc，取3，只做inverter，取0。 |
| od | KuQCDRankOrder | 进程排布顺序，可取KUQCD\_XYZT\_ORDER（x方向快变）或KUQCD\_TZYX\_ORDER（t方向快变） |
| site\_subset | KuQCDSiteSubset | 子格点，可取值KUQCD\_EVEN, KUQCD\_ODD, KUQCD\_ALL |
| gauge\_order | KuQCDGaugeOrder | 数据排布顺序，可取KUQCD\_NORMAL\_ORDER（对于旋量场(even\-odd)\-y\-z\-y\-x\-Ns\-3\-(real\-imag)，对于规范场(even\-odd)\-t\-z\-y\-x\-direction\-col\-row\-(real\-imag)）和KUQCD\_BATCH\_ORDER（对于旋量场(even\-odd)\-y\-z\-y\-(x/Nbatch)\-Ns\-3\-(real\*Nbatch\-imag\*Nbatch)，对于规范场(even\-odd)\-t\-z\-y\-(x/Nbatch)\-direction\-col\-row\-(real\*Nbatch\-imag\*Nbatch)） |
| prec | KuQCDPrecision | 精度，可取KUQCD\_SINGLE\_PRECISION和KUQCD\_DOUBLE\_PRECISION |
| link\_type | KuQCDLinkType | 链接类型，取值有 KUQCD\_WILSON\_LINK（暂不支持） KUQCD\_FAT\_LINK KUQCD\_LONG\_LINK |
| recon | KuQCDReconstructType | SU(3)矩阵压缩方式，取值有 KUQCD\_GAUGE\_RECON\_NO KUQCD\_GAUGE\_RECON\_U14（暂不支持） KUQCD\_GAUGE\_RECON\_12（暂不支持） KUQCD\_GAUGE\_RECON\_8（暂不支持） |


#### 返回值

| 返回值 | 类型 | 描述 |
| --- | --- | --- |
| KUQCD\_SUCCESS | int | 执行成功 |
| KUQCD\_ERR\_INVALID\_PARAM | int | 无效参数 |
| KUQCD\_ERR\_UNSUPPORTED | int | 不支持的选项 |
| KUQCD\_ERR\_NULL\_POINTER | int | 空指针 |