DDAM
=============

#. 功能介绍

    .. raw:: html

        &emsp;&emsp;  DDAM is an electrochemical analysis method. The target compound is assumed to be an open system to the mobile metals atom A (group I, II, III e.g. Li, Mg or Al). Thus, the corresponding chemical potential μ<sub>A</sub> can be represented as a function of the electric potential Φ:μ<sub>A</sub>()=μ<sup>0</sup><sub>A</sub>-eqΦ where μ<sup>0</sup><sub>A</sub> is the chemical potential of metallic A, e is the electron charge and q is the number of electrons transferred from A. So, DDAM can be used to determine the decomposition products from oxidation/reduction at a given Φ based on the differences in grand potential, thereby accurately predicting decomposition of some compounds.<br>

#. 操作流程

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

    .. 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. 保存计算任务**：完成计算任务的创建，并将其添加到计算项目中。在跳转的页面中，可选择：

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


#. 参数说明

    + **输入文件**：
        + **stable.json**：包含系统内所有相关稳定化合物（包括单质）的化学式、内能和带隙
        
        + Json文件内容书写格式为：
            {"化学式1": [内能1，内能2。。]，"化学式2": [内能1]} {"Li": [-2.1, -1.9],"Li2S": [-12.4]} 
        + `示例文件 </example_files/esw/example.json>`_

    + 计算参数：
        ========================= ========================= =========================
        参数名称                   参数类型                  说明  
        ========================= ========================= =========================
        Function                  ——                        共有以下五种功能：

                                                            + plot:Plot the potential-decomposition energy curve
                                                            + windowDE:Compute the decomposition energy of the target compound within the window
                                                            + show_allde_file:Compute the decomposition energy of the target compound at each electric potential
                                                            + show_dpp_file:Compute the electrochemical decomposition process of the target compound
                                                            + dP_and_dC:Compute the oxidation/reduction electric potential of the target compound
        系统内未开放原子对应元素    字符串（String）           示例：Li O 
        目标化合物化学式           字符串（String）           示例：Li2S 
        目标化合物的内能           浮点数（Float）  
        开放原子化学式             字符串（String）  
        开放原子携带电子           正整数（Int）               默认值为1 
        电势检测步长               浮点数（Float）             默认值为0.1 
        最大检测电势               正整数（Int）               默认值为99 
        起始检测电势               正整数（Int）               默认值为0 
        ========================= ========================= =========================

    + 运行参数：
        目前无需设置，保存默认即可。

        ================= ================= =================
        参数名称          参数类型          说明  
        ================= ================= =================
        Machine Name      字符串（String ） 计算机器名称，默认为machine01 
        Number of Core    正整数（Int）     计算核数，默认为1  
        Number of Process 正整数（Int）     计算进程数，默认为1 
        ================= ================= =================

#. 计算结果文件

    根据Function选项不同，产生不同的文件

        + plot_data:plot_data.json
        + windowDE:windowDE.json
        + show_dpp_file:show_dpp_file.json
        + show_allde_file:show_allde_file.json
        + dP_and_dC:dP_and_dC.json