asteriks 0.6.dev1

# asteriks 0.5
[](https://travis-ci.org/christinahedges/asteriks)
[](https://badge.fury.io/py/asteriks)

`asteriks`是一个开源Python工具，用于处理开普勒/K2数据并生成太阳系对象的亮度曲线。`asteriks`目前处于开发中！如果您尝试使用它并出现问题，请在上方打开一个问题。

## 安装

您可以在终端中执行以下命令来安装`asteriks`的最新版本...

```
git clone https://github.com/christinahedges/asteriks.git
cd asteriks
python setup.py
```

我们最新的稳定版本可在PyPI上找到，您可以使用以下命令安装

```
pip安装asteriks
```

注意：如果您想运行此代码并使用该代码生成电影，您需要安装ffmpeg

```
sudo apt-get install ffmpeg
```

## 入门

您可以从notebooks文件夹中的演示开始学习使用`asteriks`。（注意：docs文件夹构建网站！）演示由jupyter笔记本组成，将向您展示如何构建亮度曲线和目标像素文件。

## 数据产品

您可以在[此处](https://christinahedges.github.io/asteriks/index.html)查看我们所有当前发布的数据产品。

## 文件格式

`asteriks`提供两个最终产品；一个包含亮度曲线的对象在开普勒焦平面上的运动目标像素文件的fits文件。以下是fits文件的说明。

### .fits文件

fits文件中包含多个扩展，每个扩展都是一个不同的**孔径**。第一个扩展是“最佳”孔径，由`asteriks`管道决定。其他扩展具有不同大小的孔径，使用户可以使用视觉检查来确定最适合其科学研究的孔径。

##### 文件头

文件的主要头包含起源（asteriks）和目标名称（使用`OBJECT`查找名称。曝光开始和结束时间也包含在头信息中。关键字`LDLGCORR`代表“领先滞后校正”。如果为真，则对对象已应用领先滞后校正，提供更多质量标志。（请参阅进一步文档以获取领先滞后校正的完整描述。）最后，asteriks版本号包含在主要头信息中。

#### 第一个扩展

第一个扩展包含管道决定的最佳孔径。以下列出了包含的列

* `TIME`: 每次观测的时间（JD）
* `FLUX`: 对象的通量，由开普勒观测
* `FLUX_ERR`: 开普勒观测的对象通量的误差
* `RA_OBJ`: 每次曝光的对象赤经，由JPL小天体数据库确定
* `DEC_OBJ`: 每次曝光的对象赤纬，由JPL小天体数据库确定
* `LEAD_QUAL`: 简称'Lead Quality'。对象通量的第一个质量标志。这是领先滞后校正的质量。如果为假，则无法成功应用领先滞后校正。在这种情况下，用户可以选择屏蔽低质量数据。
* `NPIX_QUAL`: 简称'Number of Pixels Quality'。对象通量的第二个质量标志。如果所有像素的孔径都具有实际值（即不是NaN），则此标志为真。例如，如果小行星移出探测器的边缘，NPIX_QUAL将为假。
* `BKG_QUAL`: 简称'Background Quality'。对象通量的第三个质量标志。如果管道确定背景是静态且已校正，则此标志为真。如果管道确定存在可变背景且校正不佳，例如来自移动到饱和恒星或通过明亮恒星光环的对象，则此标志为假。
* `NPIX_APER`: 在每个时间点孔径内的像素数
* `EXTNAME`: 扩展名称。如果为第一个扩展，则名称为`BESTAPER`
* `PERC`: 创建孔径时使用的百分位数切割
* `NPIX`: 孔径中的像素数。
* `LEADFLAG`: 是否使用领先滞后校正。