计算结构位点的马德隆常数
========================

#. 功能介绍

    .. raw:: html

          As a classical method for calculating long-range interactions, the Ewald technique decomposes the electrostatic energy into long-range and short-range terms, by calculating two terms in the real space and the reciprocal space, respectively, which results in rapid convergence of the summation.

#. 操作流程

    **依次按照以下步骤创建计算任务**

    .. figure:: ../../../_static/computational_workflow.png
        :alt: computational_workflow
        :align: center

        computational_workflow

    .. raw:: html
      
        <br>
      
    +  **step 1. 新建任务**：在对应页面中输入计算任务的名称、描述信息，点击页面的“OK”按钮，完成计算任务的创建；点击“Cancel”按钮，清空输入内容。
    +  **step 2. 上传文件**：在对应页面按照页面提示上传计算输入文件。 

        .. raw:: html

            <span style="color:red">
            <b>
            Attention:
            </b>
            </span>

        + **请务必以英文命名计算输入文件！**
        + **如需上传多个计算输入文件，请将其打包为zip格式压缩包进行上传。**
    +  **step 3. 设置计算参数**：在对应页面按照页面提示设置计算参数。
    +  **step 4. 设置运行参数**：目前，运行参数无需设置，保持输入框默认参数即可
    +  **step 5. 保存计算任务**：完成计算任务的创建，并将其添加到计算项目中。在跳转的页面中，可选择：

        + **继续添加计算任务**：添加新的计算任务
        + **查看项目**：查看当前待提交的计算项目详情。


#. 参数说明

    + 输入文件：
        包含化合价信息的cif结构文件。`示例文件 </example_files/eice/example.cif>`_

    + 计算参数：
        ======================= ======================= =======================
        参数名称                参数类型                说明  
        ======================= ======================= =======================
        Function                ——                      计算结构位点的马德隆常数时，默认使用madelung_potential函数
        Method                  ——                      目前共有五种方法以供选择：

                                                        + Ewald_2D：
                                                        + Ewald_3D：
                                                        + Ewald_3DC*：
                                                        + Ewald3DC_planar_boundary：
                                                        + Ewald3DC_spherical_boundary：
        Fractional Coordinate x 浮点数(Float)           分数坐标x  
        Fractional Coordinate y 浮点数(Float)           分数坐标y  
        Fractional Coordinate z 浮点数(Float)           分数坐标z  
        ======================= ======================= =======================

    + 运行参数：
        目前无需设置，保存默认即可。
    
        ================= ================= =================
        参数名称          参数类型          说明  
        ================= ================= =================
        Machine Name      字符串（String ） 计算机器名称，默认为machine01 
        Number of Core    正整数（Int）     计算核数，默认为1  
        Number of Process 正整数（Int）     计算进程数，默认为1 
        ================= ================= =================

#. 计算结果文件

    + out.txt：计算结果