mastcasjobs 0.0.6

安装

安装mastcasjobs和casjobs模块的当前版本

pip install mastcasjobs

如果您想在mastcasjobs模块上进行开发，请克隆它，然后使用以下命令安装：

pip install .

用法

以下是一个示例查询，它对坐标RA=187.706，Dec=12.391（以度为单位）50弧秒内的PS1对象进行圆锥搜索

import mastcasjobs

query = """select o.objID, o.raMean, o.decMean,
o.nDetections, o.ng, o.nr, o.ni, o.nz, o.ny,
m.gMeanPSFMag, m.rMeanPSFMag, m.iMeanPSFMag, m.zMeanPSFMag, m.yMeanPSFMag
from fGetNearbyObjEq(187.706,12.391,50.0/60.0) nb
inner join ObjectThin o on o.objid=nb.objid and o.nDetections>1
inner join MeanObject m on o.objid=m.objid and o.uniquePspsOBid=m.uniquePspsOBid
"""

# user is your MAST Casjobs username
# pwd is your Casjobs password
# These can also come from the CASJOBS_USERID and CASJOBS_PW environment variables,
# in which case you do not need the username or password parameters.
# Create a Casjobs account at <https://mastweb.stsci.edu/ps1casjobs/CreateAccount.aspx>
#   if you do not already have one.

user = "myusername"
pwd = "My super secret password"

jobs = mastcasjobs.MastCasJobs(username=user, password=pwd, context="PanSTARRS_DR2")
results = jobs.quick(query, task_name="python cone search")
print(results)

请注意，默认情况下，快速查询的结果以astropy表格的形式返回。您可以通过添加可选参数astropy=False来获取一个字符串。

jobs对象有其他有用的方法，允许您执行几乎可以通过Web界面运行的任何查询。使用help(jobs.function)获取详细信息。一些常用的函数包括：

quick:

运行执行时间少于1分钟的短查询。

submit:

提交长时间运行的查询。

status，monitor，cancel:

监视提交的查询。

fast_table:

从MyDB表快速检索数据（仅在MAST Casjobs上工作）。

get_table:

获取小型或大型 MyDB 表格（较慢但可在其他 Casjobs 安装中工作）。

list_tables:

列出 MyDB 中的表格（或在其他上下文中）。

drop_table_if_exists:

如果存在，从您的 MyDB 中删除表格。

需求

这依赖于 casjobs 模块（版本 0.0.2 或更新）和 requests 模块。

由于 Python 2.7 已不再受支持，此版本软件的安装需要 Python 3.5 或更高版本。实际上，该软件仍然可以在 Python 2.7 中运行，但您需要手动安装。

许可证

MIT