gctl_potential/lib/potential/gkernel_triangle.h
2025-04-25 18:09:51 +08:00

130 lines
5.6 KiB
C++

/********************************************************
* ██████╗ ██████╗████████╗██╗
* ██╔════╝ ██╔════╝╚══██╔══╝██║
* ██║ ███╗██║ ██║ ██║
* ██║ ██║██║ ██║ ██║
* ╚██████╔╝╚██████╗ ██║ ███████╗
* ╚═════╝ ╚═════╝ ╚═╝ ╚══════╝
* Geophysical Computational Tools & Library (GCTL)
*
* Copyright (c) 2022 Yi Zhang (yizhang-geo@zju.edu.cn)
*
* GCTL is distributed under a dual licensing scheme. You can redistribute
* it and/or modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation, either version 2
* of the License, or (at your option) any later version. You should have
* received a copy of the GNU Lesser General Public License along with this
* program. If not, see <http://www.gnu.org/licenses/>.
*
* If the terms and conditions of the LGPL v.2. would prevent you from using
* the GCTL, please consider the option to obtain a commercial license for a
* fee. These licenses are offered by the GCTL's original author. As a rule,
* licenses are provided "as-is", unlimited in time for a one time fee. Please
* send corresponding requests to: yizhang-geo@zju.edu.cn. Please do not forget
* to include some description of your company and the realm of its activities.
* Also add information on how to contact you by electronic and paper mail.
******************************************************/
#ifndef _GCTL_GRAV_KERNEL_TRIANGLE_H
#define _GCTL_GRAV_KERNEL_TRIANGLE_H
#include "gm_data.h"
#include "gctl/poly/triangle.h"
#include "gctl/utility/progress_bar.h"
namespace gctl
{
/**
* @brief 三角形面元正演重力场需要的参数
*/
struct gravtri_para
{
tensor F; ///< 面的张量积
tensor E[3]; ///< 边的张量积
double edglen[3]; ///< 边的长度
};
typedef type_triangle<gravtri_para> grav_triangle; ///< 带gravtri_para属性的三角形结构体
/**
* @brief calculate the gravity parameters of given element type.
*
* @param in_tri Input elements
* @param out_para The output parameter array
*/
void callink_gravity_para(array<grav_triangle> &in_tri, array<gravtri_para> &out_para);
/**
* @brief 正演计算直角坐标下的三维三角形单元体重力位
*
* @param out_obs 输出的重力观测值
* @param[in] ele 三维三角形单元体数组
* @param[in] obsp 三维直角坐标下的观测点数组
* @param[in] rho 矩形单元体密度数组
* @param[in] verbose 返回信息层级
*/
void gobser(array<double> &out_obs, const array<grav_triangle> &ele, const array<point3dc> &obsp,
double rho, verbose_type_e verbose = FullMsg);
/**
* @brief 正演计算直角坐标下的三维三角形单元体重力值
*
* @param out_obs 输出的重力观测值
* @param[in] ele 三维三角形单元体数组
* @param[in] obsp 三维直角坐标下的观测点数组
* @param[in] rho 矩形单元体密度数组
* @param[in] verbose 返回信息层级
*/
void gobser(array<point3dc> &out_obs, const array<grav_triangle> &ele, const array<point3dc> &obsp,
double rho, verbose_type_e verbose = FullMsg);
/**
* @brief 正演计算直角坐标下的三维三角形单元体重力梯度值
*
* @param out_obs 输出的重力观测值
* @param[in] ele 三维三角形单元体数组
* @param[in] obsp 三维直角坐标下的观测点数组
* @param[in] rho 矩形单元体密度数组
* @param[in] verbose 返回信息层级
*/
void gobser(array<tensor> &out_obs, const array<grav_triangle> &ele, const array<point3dc> &obsp,
double rho, verbose_type_e verbose = FullMsg);
/**
* @brief 正演计算球角坐标下的三维三角形单元体重力位
*
* @param out_obs 输出的重力观测值
* @param[in] ele 三维三角形单元体数组
* @param[in] obsp 三维直角坐标下的观测点数组
* @param[in] rho 矩形单元体密度数组
* @param[in] verbose 返回信息层级
*/
void gobser(array<double> &out_obs, const array<grav_triangle> &ele, const array<point3ds> &obsp,
double rho, verbose_type_e verbose = FullMsg);
/**
* @brief 正演计算球角坐标下的三维三角形单元体重力值
*
* @param out_obs 输出的重力观测值
* @param[in] ele 三维三角形单元体数组
* @param[in] obsp 三维直角坐标下的观测点数组
* @param[in] rho 矩形单元体密度数组
* @param[in] verbose 返回信息层级
*/
void gobser(array<point3dc> &out_obs, const array<grav_triangle> &ele, const array<point3ds> &obsp,
double rho, verbose_type_e verbose = FullMsg);
/**
* @brief 正演计算球角坐标下的三维三角形单元体重力梯度值
*
* @param out_obs 输出的重力观测值
* @param[in] ele 三维三角形单元体数组
* @param[in] obsp 三维直角坐标下的观测点数组
* @param[in] rho 矩形单元体密度数组
* @param[in] verbose 返回信息层级
*/
void gobser(array<tensor> &out_obs, const array<grav_triangle> &ele, const array<point3ds> &obsp,
double rho, verbose_type_e verbose = FullMsg);
};
#endif // _GCTL_GRAV_KERNEL_TRIANGLE_H