The cosmic carbon footprint of massive stars stripped in binary systems

# Structure

## Overview

The folder data/ contains the inlists and mod files used in this work. Intermediate data (like history or profile) files must be regenerated from the provided files.

The folder plots/ contains a jupyter notebook set-up to remake all plots (assuming the data is saved in the data/ folder). There are also additional scripts and files needed to reproduce this work.

The griffith.txt file is the data from https://ui.adsabs.harvard.edu/abs/2021arXiv210309837G/abstract and was accessed from https://github.com/giganano/VICE/blob/master/vice/yields/ccsne/S16/W18F/FeH0/v0/explosive/c.dat

## Data folders

corehedep - Evolution from ZAMS to end of core helium burning
coreodep - Evolution from end of core helium burning to end of core oxygen burning
cc - Evolution from end of core oxygen burning up to core collapse
ccsn - Evolution from core collapse to shock breakout

engmc - Tests variations in the injection energy and mass cut of ccsn explosions
spacetime - Test variations in space/time resolution of ccsn explosions
ccsn_t_m - Test variations in injection time and injection mass of ccsn explosions

## Sub-folders

corehedep/base - Base folder with inlists for this set of models
corehedep/binary - Contains a folder for each mass for the binary-stripped stars (11-45)
corehedep/single - Contains a folder for each mass for the single stars (11-45)
corehedep/net/23 - A single star 23msun model ran with a larger nuclear network

coreodep/base - Base folder with inlists for this set of models
coreodep/binary  - Contains a folder for each mass for the binary-stripped stars (11-45)
coreodep/single - Contains a folder for each mass for the single stars (11-45)

coreodep/mesh - Test variations with respect to space and time during carbon burning
coreodep/overshoot - Test variations with respect to overshoot during carbon burning
coreodep/net - A single star 23msun model ran with a larger nuclear network

cc/base - Base folder with inlists for this set of models
cc/binary - Contains a folder for each mass for the binary-stripped stars (11-45)
cc/single  - Contains a folder for each mass for the single stars (11-45)

ccsn/base - Base folder with inlists for this set of models
ccsn/binary  - Contains a folder for each mass for the binary-stripped stars (11-45)
ccsn/single  - Contains a folder for each mass for the single stars (11-45)
ccsn/laplace_binary - Contains core collapse explosions of the binary-stripped models from Laplace et al 2021
ccsn/laplace_single - Contains core collapse explosions of the single star models from Laplace et al 2021

spacetime/base - Base folder with inlists for this set of models
spacetime/binary - Test variations in space/time resolution of ccsn explosions

ccsn_t_m/base - Base folder with inlists for this set of models
ccsn_t_m/binary - Test variations in injection time and injection mass of ccsn explosions

engmc/base - Base folder with inlists for this set of models
engmc/binary - Tests variations in the injection energy and mass cut of ccsn explosions

## Notes

Folders with the name '_k' have enhanced profile output for use in Kippenhan plots.

Folders with the name '_v' have enhanced profile output for use in the video of the shock explosion.

Each numbered folder contains a set of inlists used (which usually only vary one or two parameters), the rest of the inlists are stored in the base/ folders (See the submit.sh files for how to get MESA to read these files). They also contain a initial.mod file (which is the starting point for this phase of evolution), this is a softlink to the final.mod file from the previous phase (thus coreodep soft links to files in corehedep, corehdep uses MESA's built in ZAMS models to start).

The folders that handle the core collapse explosions have additional .mod files that handle each phase of the explosion. See the base/ folders for details on the order.

## Files

cacheHist.py - Runs mesaplot code to turn history files into a python binary file for faster reading.
plotKip.py - Does a quick kippenhan plot for diagnostics

# 结构

## 概览

`data/` 文件夹包含本研究中使用的输入列表（inlists）与mod模型文件。中间数据（如演化历史文件或恒星结构剖面文件）需从提供的原始文件重新生成。

`plots/` 文件夹包含可复现所有绘图的Jupyter Notebook（Jupyter 笔记本），使用前提是数据已保存至`data/`文件夹，同时附带复现本研究所需的全部辅助脚本与文件。

`griffith.txt` 文件的数据来源于 https://ui.adsabs.harvard.edu/abs/2021arXiv210309837G/abstract，获取自 https://github.com/giganano/VICE/blob/master/vice/yields/ccsne/S16/W18F/FeH0/v0/explosive/c.dat

## 数据文件夹

corehedep：从零年龄主序星（Zero-Age Main Sequence, ZAMS）阶段到核心氦燃烧阶段结束的恒星演化序列
coreodep：从核心氦燃烧阶段结束到核心氧燃烧阶段结束的恒星演化序列
cc：从核心氧燃烧阶段结束至核心坍缩前的恒星演化序列
ccsn：从核心坍缩到激波突破的演化过程

engmc：测试核心坍缩超新星（Core-Collapse Supernova, ccsn）爆发的注入能量与质量截断的参数变体
spacetime：测试核心坍缩超新星爆发的时空分辨率参数变体
ccsn_t_m：测试核心坍缩超新星爆发的注入时间与注入质量的参数变体

## 子文件夹

corehedep/base：本系列模型的基础输入列表文件夹
corehedep/binary：包含每个质量（11~45倍太阳质量）的双星剥离恒星对应的子文件夹
corehedep/single：包含每个质量（11~45倍太阳质量）的单星对应的子文件夹
corehedep/net/23：使用更大核反应网络计算的23倍太阳质量单星模型

coreodep/base：本系列模型的基础输入列表文件夹
coreodep/binary：包含每个质量（11~45倍太阳质量）的双星剥离恒星对应的子文件夹
coreodep/single：包含每个质量（11~45倍太阳质量）的单星对应的子文件夹
coreodep/mesh：测试碳燃烧阶段的时空网格参数变体
coreodep/overshoot：测试碳燃烧阶段的超射参数变体
coreodep/net：使用更大核反应网络计算的23倍太阳质量单星模型

cc/base：本系列模型的基础输入列表文件夹
cc/binary：包含每个质量（11~45倍太阳质量）的双星剥离恒星对应的子文件夹
cc/single：包含每个质量（11~45倍太阳质量）的单星对应的子文件夹

ccsn/base：本系列模型的基础输入列表文件夹
ccsn/binary：包含每个质量（11~45倍太阳质量）的双星剥离恒星对应的子文件夹
ccsn/single：包含每个质量（11~45倍太阳质量）的单星对应的子文件夹
ccsn/laplace_binary：包含Laplace等人2021年研究中的双星剥离恒星模型的核心坍缩爆发结果
ccsn/laplace_single：包含Laplace等人2021年研究中的单星模型的核心坍缩爆发结果

spacetime/base：本系列模型的基础输入列表文件夹
spacetime/binary：测试核心坍缩超新星爆发的时空分辨率参数变体

ccsn_t_m/base：本系列模型的基础输入列表文件夹
ccsn_t_m/binary：测试核心坍缩超新星爆发的注入时间与注入质量参数变体

engmc/base：本系列模型的基础输入列表文件夹
engmc/binary：测试核心坍缩超新星爆发的注入能量与质量截断参数变体

## 备注

名称带有`_k`后缀的文件夹包含增强的恒星剖面输出文件，用于绘制基彭哈恩图（Kippenhahn plot）。
名称带有`_v`后缀的文件夹包含增强的恒星剖面输出文件，用于制作激波爆发过程的可视化视频。
每个编号文件夹均包含一组输入列表（通常仅修改1至2个参数），其余通用输入列表存储于`base/`子文件夹中（详见`submit.sh`文件，了解如何让MESA读取这些文件）。此类文件夹还包含`initial.mod`文件，即本演化阶段的初始模型，该文件为指向前一阶段最终生成的`final.mod`文件的软链接：因此`coreodep`文件夹的文件软链接至`corehedep`中的结果，而`corehedep`则使用MESA内置的零年龄主序星模型作为初始条件。
包含核心坍缩爆发模拟的文件夹附带用于模拟爆发各阶段的额外`.mod`文件，详细执行顺序参见各`base/`子文件夹的说明。

## 文件

`cacheHist.py`：运行MESA自带的mesaplot代码，将演化历史文件转换为Python二进制格式以加快读取速度。
`plotKip.py`：快速生成基彭哈恩图用于诊断分析。