c8_changes.rst

C7主巡天流水线接口
================

Change list
    - 仓库名修改：
        - ``csst_ms*`` 修改为 ``csst_msc_*``, 注意修改文件夹路径和 ``setup.py`` 中的名称
    - 接口文件修改：
        ``top_level_interface.py`` 文件改名为 ``api.py`` , 这个文件中用于导入每个 python package 与流水线的接口函数
    - 接口名称修改：
        每个开发模块需要把接口函数命名为 ``base_`` 开头的函数，例如 ``base_phot``
    - ``DataManager`` ``FileRecorder`` 不再使用, 底层接口都尽可能使用文件路径作为参数
    - 使用 ``csst_common.status.Result`` 作为返回类型, 包含三个部分：
        - 运行状态 ``status`` 必须是 ``CsstStatus`` 的三种类型之一
        - 输出文件列表 ``file_list``, 是一个 ``list``, 需要包含所有输出文件，包括临时文件
        - 额外输出 （一般不需要，除非有其他额外输出）
    - 程序中禁止使用当前文件夹 ``.`` 或 ``./``，所有路径应使用绝对路径
    - 接口定义修改：
        ``csst_msc_mbi_distortion`` 样例代码如下

        .. code-block:: python

            from csst_common.status import CsstStatus, CsstResult

            def base_distortion(input_file, output_file, rc="/path/to/gaia_dr3.fits", **kwargs) -> CsstResult:
                """ your docstring here """
                # do your calculation
                process(input_file, output_fle)
                # construct CsstResult
                result = CsstResult(
                    status=CsstStatus.PERFECT,
                    file_list=[output_file, "an additional output file"]
                )
                return result

主巡天模块-接口列表
----------------------

.. code-block:: python


    # csst-l1/mbi/csst_msc_mbi_instrument
    def base_instcorr(input_file, img_file, wht_file, flg_file)
    # csst-l1/mbi/csst_msc_mbi_distortion
    def base_distortion(input_file, img_file, wht_file, flg_file)
    # csst-l1/mbi/csst_msc_mbi_position
    def base_position_single(input_file, img_file, wht_file, flg_file)
    def base_position_single(input_file, img_file, wht_file, flg_file)
    # csst-l1/mbi/csst_msc_mbi_flux
    def base_flux(input_file, img_file, wht_file, flg_file)
    # csst-l1/mbi/csst_msc_mbi_photometry
    def base_phot(input_file, img_file, wht_file, flg_file)
    # csst-l1/sls/csst_msc_sls_instrument
    def base_instcorr(input_file, output_file)
    # csst-l1/sls/csst_msc_sls_position
    def base_position(input_file, output_file)
    # csst-l1/sls/csst_msc_sls_mosaic	base_mosaic
    def base_instcorr(input_file, img_file, wht_file, flg_file)
    # csst-l1/sls/csst_msc_sls_directimage	base_dimg
    def base_instcorr(input_file, img_file, wht_file, flg_file)
    # csst-l1/sls/csst_msc_sls_sky	base_skybkg
    def base_instcorr(input_file, img_file, wht_file, flg_file)
    # csst-l1/sls/csst_msc_sls_objextraction	base_objext
    def base_instcorr(input_file, img_file, wht_file, flg_file)
    # csst-l1/sls/csst_msc_sls_axe	base_axe
    def base_instcorr(input_file, img_file, wht_file, flg_file)
    # csst-l1/sls/csst_msc_sls_cde	base_cde
    def base_instcorr(input_file, img_file, wht_file, flg_file)
    # csst-l1/qc/csst_msc_qc0	base_qc0
    def base_instcorr(input_file, img_file, wht_file, flg_file)
    # csst-l1/qc/csst_msc_sls_qc1	base_qc1
    def base_instcorr(input_file, img_file, wht_file, flg_file)