IDAM
=============

#. 功能介绍

    .. raw:: html

            IDAM is an electrochemical stability analysis method and mainly involves the kinetically favorable electrochemical  decomposition pathway of the target compound, namely the insertion and extraction of metal atoms A (group I, II, III e.g.  Li, Mg or Al). When metal A is used as the anode, the overall electrochemical reaction is shown in eqn:
        A<sub>x</sub>M <sub>y</sub>N <sub>z</sub>+kA&rarr;A<sub>x+k</sub>M<sub>y</sub>N<sub>z</sub> where A<sub>x</sub>M <sub>y</sub>N <sub>z</sub> is the chemical formula of the target compound, k is the number of A atoms extracted or inserted, A<sub>x+k</sub>M<sub>y</sub>N<sub>z</sub> is indirect decomposition product.Oxidation/reduction potential is considered as the potential for extraction/insertion of A.

#. 操作流程

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

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

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


#. 参数说明

    + **输入文件**：
        + **decompose.json**：包含系统内所有相关间接分解产物和相关元素单质的化学式和内能
        + Json文件内容书写格式为：
            {"化学式1": [内能1，内能2。。]，"化学式2": [内能1]} {"Li": [-2.1, -1.9],"Li2S": [-12.4]} 
        + `示例文件 </example_files/esw/example.json>`_

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

                                                            + dp_products：Compute oxidation/reduction decomposition products.
                                                            + dp_potentials：Compute oxidation/reduction decomposition potential.
                                                            + plot_file：Draw a concentration phase diagram for A
        系统内未开放原子对应元素    字符串（String）           示例：Li O 
        系统内未开放原子对应能量    浮点数（Float）
        目标化合物化学式           字符串（String）           示例：Li2S 
        目标化合物的内能           浮点数（Float）  
        开放原子化学式             字符串（String）  
        开放原子化学势             字符串（String）    
        开放原子携带电子           正整数（Int）              默认值为1 
        ========================= ========================= =========================

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

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

#. 计算结果文件

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

        + dp_products：dp_products.json 
        + dp_potentials：dp_potentials.json
        + plot_file：plot_file.json