ned.ipac.caltech.edu

NED 旧版 API（legacy APIs）已被官方标记为弃用，且无法访问 2026 年 1 月之后收录的数据。如果你的查询涉及较新的天体、文献或红移数据，继续调用旧接口会得到不完整甚至空的结果。官方给出的替代方案是改用新版 NED API，入口在 NED 网站的 Program Interfaces 区域。下面说明如何确认自己受影响、找到新入口，以及迁移时最容易踩的坑。

先判断你是否真的受影响

旧版 API 并非立刻失效，而是存在一个明确的数据边界：

判断方法很直接：用旧接口查一个你已知在 2026 年之后才被 NED 收录的天体。如果返回空或报错，说明该数据在旧接口的可见范围之外，而不是天体不存在。

新版 API 的入口在哪里

NED 网站把接口相关资源集中在 Program Interfaces 栏目下，其中包含新版 API 的说明与文档。同时网站还提供 Database Tutorials、Best Practices、Search & Retrieval FAQ 等辅助页面，迁移时遇到字段或参数疑问可以先查这些。

需要注意，网站首页明确写着旧版 API 已弃用，并直接指向新版 API。也就是说，官方并不打算长期维护两套接口并存，迁移是方向性的，不是可选项。

迁移时的关键差异

数据时间范围

这是最实质的差别。旧接口的数据快照停在 2026 年 1 月之前，新接口才能拿到之后的收录内容。NED 的数据是持续增长的，例如某次发布就新增了 22.1 万个文献来源、15.7 万个与已有天体的交叉匹配、6.3 万个新天体，并使有红移的天体增加 8.9 万个。这类增量只会进入新接口。

接口形态与调用方式

新旧 API 在请求结构、返回字段命名上通常不完全一致，不能假设把旧请求的 URL 换个域名就能用。迁移时应以新版文档为准，逐个核对：

• 查询参数名称与取值格式
• 返回结果的层级结构（例如天体基本信息、红移、交叉匹配是否分层）
• 分页或结果数量限制的处理方式

按名称、位置、参数的检索

NED 支持按名称、近名称或位置（Cone 搜索）、按 Refcode、按参数检索。迁移时确认新版接口对这些检索方式是否都提供对应端点，尤其是位置检索的坐标格式和半径单位，这类细节最容易在迁移后静默出错——请求成功但结果为空。

迁移步骤

1. 确认受影响范围：列出你当前依赖的旧接口调用，标出哪些查询的是近期数据。
2. 找到新版入口：在 NED 网站 Program Interfaces 区域获取新版 API 文档。
3. 对照字段：用同一个天体分别请求新旧接口，逐字段比对，记录差异。
4. 改写请求：按新文档调整参数名、坐标格式、返回解析逻辑。
5. 验证边界：用一个 2026 年后才收录的天体测试，确认新接口能返回、旧接口返回空。
6. 回归测试：对历史天体也跑一遍，确保迁移没有破坏原有查询。

常见卡点

• 以为旧接口还能用：只要查询不涉及新数据，旧接口可能看起来正常，容易误判为无需迁移。
• 坐标与单位不一致：位置检索迁移后返回空，往往不是天体不存在，而是坐标系或半径单位写错。
• 忽略交叉匹配字段：NED 大量价值来自天体间的交叉匹配，迁移时若只取主记录，会丢掉关联信息。
• 不做新旧对照：直接改写后上线，字段错位很难被发现，建议保留一段并行验证期。

小结

旧版 API 的核心限制是数据截止在 2026 年 1 月，无法获取之后的收录内容；官方替代方案是网站 Program Interfaces 下的新版 NED API。迁移的重点不在换地址，而在核对数据时间范围、请求参数和返回结构，并用新旧对照的方式验证。

NED（NASA/IPAC Extragalactic Database）在 Tools 栏目下提供四类在线计算器：坐标计算器、消光计算器、速度计算器和宇宙学计算器。它们都是网页表单式工具，输入参数后直接返回结果，不需要下载软件，也不需要登录。如果你要做的只是坐标换算、查消光值、由红移推速度，或算宇宙学距离，用这些页面比翻文献快得多。

坐标计算器（Coordinate Calculator）

用途是把一个坐标系下的天体位置换算到另一个坐标系，或做常见的坐标格式转换。

典型任务场景：你从一篇老文献里拿到 B1950 历元的赤经赤纬，想转成 J2000 再拿去检索；或者手里是十进制度数，想转成时分秒格式。

使用方式：在页面里选择输入坐标系（如 B1950、J2000）和输出坐标系，填入赤经、赤纬，提交后得到换算结果。输入格式通常同时接受时分秒/度分秒和十进制度数，具体以页面提示为准。

验证方法：拿一个已知天体（例如某个 NED 对象页面上同时给出 J2000 坐标）反代回去，看输出是否与对象页面一致。

常见卡点：把历元（B1950/J2000）和坐标系类型（赤道/银道）混为一谈。两者是独立的选项，选错任一个结果都会偏。

消光计算器（Extinction Calculator）与消光定律计算器

这两个不是同一个工具，容易混淆：

消光计算器的输入是坐标（或直接由对象页面调用），输出是该视线方向上的消光估计值，通常以 E(B−V) 或特定波段的 A_λ 给出。消光定律计算器则是选定律、给波长范围，得到归一化的消光曲线，用于把观测流量改正到内禀值。

适用条件：消光计算器给的是银河系前景消光，不包含天体自身或宿主星系的内部消光，后者需要你自己用光谱拟合或巴尔末减缩等方法处理。

常见卡点：不同消光图（如 Schlegel 1998、SFD）给出的值有系统差异，做精确测光时要说明用的是哪一套，并在论文里注明来源。

速度计算器（Velocity Calculator）

用途是在红移 z 与速度之间做换算，并区分几种速度定义。

关键机制：红移到速度不是单一公式。常用定义包括：

• 相对论性多普勒速度（radial velocity，相对论公式）
• 退行速度 v = cz（低红移近似）
• 宇宙学意义上的共动距离随时间的变化率

低红移（z ≲ 0.01 量级）时几种定义差别很小，可以直接用 v = cz；红移变大后差异显著，选错定义会引入系统性偏差。

输入输出：填入红移 z（或速度），选择速度定义，得到对应结果。做星系巡天统计或与文献速度表比对时，先确认对方用的是哪种定义。

宇宙学计算器（Cosmology Calculators）

用途是给定一组宇宙学参数（H₀、Ω_m、Ω_Λ 等）和红移，计算宇宙学距离和体积量。

常见输出包括：

• 共动距离（comoving distance）
• 角直径距离（angular diameter distance）
• 光度距离（luminosity distance）
• 共动体积元，用于计算巡天体积或体积密度

适用条件：结果完全取决于你输入的参数集。用 Planck 参数和用 WMAP 参数算出的光度距离在中等红移下可差百分之几，做测光或质量估算时要固定并写明参数来源。

验证方法：在低红移极限下，光度距离应趋近于 cz/H₀，可以拿这个做量级检查。

怎么选、怎么用

• 只做坐标换算 → 坐标计算器
• 要改正观测流量 → 消光计算器（前景）+ 消光定律计算器（波长依赖）
• 红移与速度互换 → 速度计算器，先确认速度定义
• 距离、体积、宇宙学量 → 宇宙学计算器，先确认参数集

这些工具都在 NED 的 Tools 栏目下，与 Search Objects、Program Interfaces 并列。注意 NED 的 legacy APIs 已弃用，无法访问 2026 年 1 月之后入库的数据，新工作应改用新的 NED APIs；网页版计算器本身不受此影响，但如果你要把计算结果和最新入库对象关联，走 API 更稳妥。

NED（NASA/IPAC Extragalactic Database，NASA/IPAC 河外星系数据库）是一个由 NASA 资助、IPAC 运营的天文学专业数据库，核心用途是汇总和交叉检索银河系以外的天体对象及其文献信息。它适合天文学研究人员、学生以及需要查询河外天体位置、红移、命名或相关文献的人使用。网站本身是公开的科研资源，但资料未说明是否需要登录或是否收费，实际使用前建议以站内说明为准。

核心定位：河外星系数据的汇总与交叉匹配

NED 的名字已经说明了范围：Extragalactic，即银河系之外。它把来自不同文献和巡天项目的数据整合到统一的对象记录中，并提供交叉匹配，让同一个天体在不同星表里的名称和测量结果能够对应起来。

从页面信息看，NED 的数据规模在持续增长。例如 Sept 2026 Release Highlights 提到，该次发布从文献中收录了 221K 个源，其中包括 157K 个与 NED 对象的交叉匹配和 63K 个新对象，使有红移的 NED 对象增加了 89K。这说明 NED 不只是静态星表，而是随文献发表不断更新的数据库。

主要提供哪些内容

根据首页导航和发布说明，NED 的主要内容包括：

• 天体对象检索：可按名称（By Name）、按位置或锥形搜索（Near Name or Position / Cone）、按参数（By Parameters）等方式查找。
• 文献参考：可按作者名检索文献参考（Literature References by Author Name），也可做参考查询（Reference Lookup）。
• 命名服务：提供 Nomenclature Services，用于天体命名相关查询。
• 计算工具：包括坐标计算器（Coordinate Calculator）、消光计算器（Extinction Calculator）、速度计算器（Velocity Calculator），以及宇宙学计算器和消光律计算器。
• 数据集与统计：Holdings、Nomenclature Counts、Graphics、Data Sets、References 等入口，用于查看数据库收录情况和图形化数据。
• 帮助与文档：User Guides、Database Tutorials、Best Practices、Search & Retrieval FAQ、Scientific Calculations FAQ、Known Issues 等。

数据来源与更新示例

NED 的数据来自天文学文献和巡天项目。首页发布说明中列举了若干近期收录内容，例如：

这些条目说明 NED 会把新发表的大规模巡天和文献结果纳入数据库，并标注对应文献，方便使用者追溯数据来源。

使用前需要注意的几点

• API 变更：页面明确提示，NED legacy APIs 已弃用，无法访问 2026 年 1 月之后收录的数据，建议使用新的 NED APIs。如果依赖旧接口，需要先确认迁移方案。
• 数据引用规范：NED 建议在投稿前参考 Best Practices for Data Publication in the Astronomical Literature（Chen et al. 2022），以便发表数据能顺利整合进 NED。
• 服务调整：导航中有 Discontinuing Services 入口，说明部分服务可能停止或调整，使用前可先查看该页面。
• 帮助资源：如果检索或科学计算遇到问题，可先查 Search & Retrieval FAQ、Scientific Calculations FAQ 和 Known Issues。

适合谁用

NED 主要面向需要河外天体信息的科研场景，例如：

• 查某个星系、类星体或河外源的基本参数和红移；
• 确认一个天体在不同星表中的名称对应关系；
• 查找某个天体或某个主题的相关文献；
• 做坐标、消光、速度等常规换算；
• 了解某次发布新增了哪些数据。

如果只是做一般天文科普查询，NED 的界面和数据密度可能偏专业；但它的公开入口和帮助文档足以支撑有明确查询目标的使用者上手。

NED（NASA/IPAC Extragalactic Database）提供四类主要检索入口：按天体名称、按位置或锥形搜索（Cone Search）、按参数筛选，以及按文献作者或参考文献查找。它收录的是河外星系与相关天体数据，因此太阳系内天体、纯银河系恒星通常不在检索范围内。以下按使用场景说明每种方式怎么用、能得到什么结果。

按名称搜索（Search Objects By Name）

适用于你已经知道目标名称的情况，例如星系编号、常用别名或文献中出现的名称。

• 在搜索框输入名称后提交，NED 会返回匹配对象及其基本条目。
• 一个天体可能有多个名称（不同星表、不同文献的命名），NED 会做名称交叉匹配，因此输入别名通常也能命中。
• 如果名称存在歧义或匹配到多个对象，结果页会列出候选，需要你自行确认。

预期结果是进入该天体的对象页面，其中汇总位置、红移、分类、参考文献等条目信息。

按位置或锥形搜索（Near Name or Position / Cone）

适用于你只有一个坐标、或者想找出某个天区范围内所有 NED 对象的情况。

• 输入方式有两种：直接给坐标，或给一个已知名称让 NED 以其位置为中心。
• 锥形搜索需要指定搜索半径，NED 返回该半径内所有匹配对象。
• 半径设得越大，返回对象越多，也越容易混入与目标无关的天体。

预期结果是天区内对象列表。常见卡点是半径选择：太小可能漏掉目标，太大则结果噪声增加，需要结合目标类型和已知位置精度调整。

按参数搜索（By Parameters）

适用于你不关心具体是哪个天体，而是想筛选满足某些物理或观测条件的一批对象。

• 可按红移、星等、分类等参数设置条件，返回符合条件的天体集合。
• 适合做样本构建，例如统计某一红移区间内的特定类型星系。

预期结果是符合条件的对象列表，可进一步用于批量检索或导出。卡点在于参数条件过宽会返回大量记录，过窄可能为空，建议先用较宽条件试探再逐步收紧。

按文献作者或参考文献查找（Literature References）

适用于从文献角度切入：你想知道某位作者、某篇文献涉及哪些天体，或想核对某个参考文献编号对应的内容。

• 可按作者姓名检索，也可用参考文献编号（Refcode）查找。
• 结果指向文献条目及其关联的 NED 对象。

预期结果是文献与天体的关联列表，适合追溯数据来源或补充某天体在文献中的记录。

辅助工具与注意事项

• 坐标计算器、消光计算器、速度计算器：在检索前后做单位换算或改正时可用。
• 命名服务（Nomenclature）：涉及天体命名规范时可参考。
• API 状态：NED 旧版 API 已弃用，无法访问 2026 年 1 月之后录入的数据，新检索或程序化访问应使用新版 NED API。
• 数据更新：NED 持续从文献录入新对象与交叉匹配，例如 2026 年 9 月发布说明提到新增约 22.1 万个文献来源、其中约 15.7 万个与已有 NED 对象交叉匹配、约 6.3 万个新对象，并新增约 9.1 万个带红移的对象。检索结果会随版本更新而变化。

该选哪种方式

如果一次检索没有命中，先确认目标是否属于河外天体范围，再检查名称拼写、坐标单位或半径设置，通常能定位到问题所在。

NASA/IPAC Extragalactic Database（NED）把学习与支持资源集中放在网站的 Information 栏目下，主要入口包括 User Guides、Database Tutorials、Best Practices、Search & Retrieval FAQ、Scientific Calculations FAQ、Known Issues、Level5 Knowledge Base 和 Glossary。如果你要查的是某个具体操作（比如按坐标搜索、算消光）或某个报错，通常能在这些页面里找到对应说明，不需要发邮件等待回复。

主要学习与支持入口

按任务找对应资源

• 想系统学 NED 怎么用：先看 User Guides 了解各功能模块，再配合 Database Tutorials 做具体操作练习。
• 搜索时遇到问题：查 Search & Retrieval FAQ；如果涉及计算（坐标、消光、速度、宇宙学），查 Scientific Calculations FAQ。
• 结果看起来不对：先看 Known Issues，确认是否为已记录的问题。
• 需要术语解释：查 Glossary。
• 准备发表论文并希望数据被 NED 收录：参考 Best Practices，NED 明确建议在投稿前查阅其数据发布最佳实践（Chen et al. 2022）。

工具类资源

NED 在 Tools 下提供在线计算器，包括 Coordinate Calculator、Extinction Calculator、Velocity Calculator，以及 Cosmology Calculators 和 Extinction-Law Calculators。这些计算器与上面的 FAQ 配合使用：先看说明，再用计算器完成具体换算。

联系支持

网站提供 Contact Us 入口，并设有 Ticket Status 页面用于查看支持请求的处理状态。遇到 FAQ 和 Known Issues 都未覆盖的问题时，可以通过 Contact Us 提交。

需要注意的一点

NED 的 legacy API 已被弃用，且无法访问 2026 年 1 月之后入库的数据，官方要求改用新的 NED APIs。如果你的教程或脚本仍基于旧接口，需要先迁移到新 API，再参考 User Guides 和 Database Tutorials 中的当前说明。