此操作返回有关与化石发生相关的分类意见的信息。您可以使用它来检索与任何选定的一组事件相关的意见。
"opinion_no","record_type","opinion_type","taxon_rank","taxon_name","orig_no","child_name","child_spelling_no","status","parent_name","parent_no","parent_spelling_no","spelling_reason","author","pubyr","reference_no"
"800409","opn","class","unranked clade","Cetacea","36652","","81220","belongs to","Cetartiodactyla","71830","","rank change","Bisconti and Bosselaers","2020","73428"
"656343","opn","unsel","unranked clade","Cetacea","36652","","81220","belongs to","Cetartiodactyla","71830","","rank change","Berta","2017","63144"
"640342","opn","unsel","class","Cetacea","36652","","351937","belongs to","Artiodactyla","87634","","rank change","Godfrey et al.","2017","62154"
如果要检索与此数据库中输入的整个发生记录集相对应的分类意见,则可以使用以下参数。请谨慎使用,因为结果集将包含超过 400,000 条记录,并且大小至少为 50 MB。您还可以通过指定下面列出的参数的某种组合来选择此列表的子集。
除以下说明外,您可以任意组合使用它们。如果不指定all_records,则必须从以下列表中至少指定一个选择参数。
occ_id:以逗号分隔的出现标识符列表。选择指定的实例,前提是它们满足此请求给出的其他参数。您也可以使用参数名称 id。您还可以将此参数与任何其他参数一起使用,以根据其他条件筛选已知的匹配项列表。
coll_id:集合标识符的逗号分隔列表。选择与指定集合关联的所有匹配项,前提是它们满足此请求给出的其他参数。
clust_id:返回仅与指定地理集群相关的记录。您可以指定一个或多个集群 ID,以逗号分隔。
coll_match:返回与collection_name和collection_aka字段匹配的字符串。仅返回属于匹配的采集记录的产出记录。字符串可以包含通配符 % 和 _ 。事实上,除非你在字符串的开头和/或结尾加上%,否则你不会匹配到任何结果。
coll_re:与coll_match相似,唯一不同在于此项接收正则表达式。你可以使用 | 二者或多者择一,可以使用包括 \ 在内的所有标准正则表达式。
base_name:仅返回与特定分类名相关的记录,包括所有亚类群和异名。您可以用逗号分隔来指定多个名称。您可以使用 ^ 排除掉任意名称。例如,Osteichthyes^Tetrapoda 将会选择除Tetrapoda外的所有Osteichthyes记录。
taxon_name:仅返回与特定分类名相关的记录,包括所有异名。您可以用逗号分隔来指定多个名称。名称可以包含通配符,但如果匹配到了不止一个名称,那么只会使用数据库中产出记录数量最多的那个。
match_name:仅返回与特定分类名相关的记录。您可以用逗号分隔来指定多个名称。名称可以包含通配符 % 和 _ ,所有与匹配到的名称相关的产出记录都会返回。将会忽略掉异名。此项比起分类学匹配而言,更像是语法匹配。
immediate:您可以与base_name,base_id或taxon_name一起设置此项。设置此项会忽略掉指定名称的异名。此参数不需要值,在请求中包含此参数即可。
base_id:仅返回与特定分类名相关的记录,包括所有亚类群和异名。您可以用逗号分隔来指定多个ID。请注意,您最多可以指定taxon_name、taxon_id、base_name和 base_id之一。
taxon_id:仅返回与特定分类名相关的记录,不包括亚类群和异名。您可以用逗号分隔来指定多个ID。
exclude_id:排除掉与指定类群ID相关的分类名称或其下级名称。这是 **^**的另一种方式。
idreso:选择与指定分类阶元匹配的产出记录,或将同属/同科的产出记录合并。可接受的值有:
species:仅选择鉴定为种的产出记录
genus:仅选择鉴定到属或种的产出记录
family:仅选择鉴定到科或属或种的产出记录
lump_genus:仅选择鉴定到属或种的产出记录,并将同一采集记录中同属的所有产出记录合并为单条记录
lump_gensub*:仅选择鉴定到属或种的产出记录,并将同一采集记录中同属/亚属的所有产出记录合并为单条记录
idtype:本参数决定如何处理重新鉴定的产出记录。可接受的值包括:
latest:仅选择每项产出记录的最新鉴定,忽略掉其余鉴定。此值为默认值。
orig:仅选择每项产出记录的原始鉴定,忽略掉其余鉴定。
reid:选择被重新鉴定的产出记录的所有鉴定,包括原始鉴定。忽略数据库中没有重新鉴定记录的产出记录。这可能造成每项产出记录返回多条记录。注意,如果您指定了一个分类名称,那么不符合该名称的鉴定将被忽略。您可以通过按ID专门查询您感兴趣的产出记录来找到它们,加上idtype=all。
all:选择所有匹配其他搜索参数的鉴定。这可能会导致为给定产出记录返回多条记录。
idqual:此参数根据其分类修饰符选择或排除产出记录。允许的值包括:
any: 选择所有匹配项,而不考虑修饰符。这是默认值。
certain:排除用以下任何修饰符标记的所有匹配项:aff. / cf. / ? / “” / informal / sensu lato.
genus_certain:类似certain,但只看属/亚属,忽略物种修饰符。
uncertain:选择用以下任何修饰符标记的所有匹配项:aff. / cf. / ? / “” / informal / sensu lato.
new:仅选择标有以下项之一的匹配项:n. gen. / n. subgen. / n. sp.
idmod:此参数根据分类修饰符的任意组合选择或排除产出记录。如果您需要选择无法通过 idqual 获得的修饰符组合,则可以使用此参数和/或 idgen 和 idspc。您可以指定以下一个或多个代码,以逗号分隔。如果第一个前面是 !那么他们被排除在外。否则,仅包括标有至少一个的产出记录:
ns:n. sp.
ng:n. gen. or n. subgen.
af:aff.
cf:cf.
sl:sensu lato
if:informal
eg:ex gr.
qm:question mark(?)
qu:quotes(“”)
idgenmod:此参数根据属和/或亚属名称上的分类修饰符的任意组合选择或排除产出记录。请参阅上面的 idmod。
idspcmod:此参数根据物种名称上的分类修饰符的任意组合选择或排除产出记录。请参阅上面的 idmod。
abundance:此参数仅选择具有特定种类丰度值的产出记录。接受的值为:
count:仅选择丰度类型为’individuals’, ‘specimens’ ‘grid-count’, ‘elements’, or 'fragments’的产出记录
coverage:仅选择丰度类型为“%-…”的产出记录
any:仅选择具有某种类型丰度信息的产出记录
您也可以附加一个冒号,后跟一个十进制数。这将仅选择丰度至少为指定最小值的产出记录。
lngmin
lngmax:仅返回当前经度在给定边界内的记录。如果指定其中一个参数,则必须同时指定这两个参数。如果提供的边界超出 -180° 到 180° 的范围,它们将被收缩到适当的范围内。例如,如果您指定 lngmin=270 和 lngmax=360,则查询将lngmin=-90 和 lngmax=0 进行处理。在这种情况下,查询结果中的所有经度值都将调整为落在您指定的实际数值范围内。
latmin:仅返回当前纬度至少为给定值的记录。
latmax:仅返回当前纬度最多为给定值的记录。
loc:仅返回当前位置(经度和纬度)属于指定范围的记录,必须以 WKT 格式给出,坐标为经度和纬度值。
plate:仅返回位于指定地质板块上的记录。如果此参数的值以 ! 开头,则排除指定板块上的所有记录。如果此参数的值继续以 G 开头,则这些值将被解释为 GPlates 模型中的板块编号。如果是S,则这些值将被解释为 Scotese 模型中的板块编号。否则,它们将根据参数 pgm 的值进行解释。该值的其余部分必须是板块编号。
pgm:指定返回古坐标时要使用的古地理模型。您可以从以下列表中指定一个或多个,以逗号分隔。如果未为此参数指定值,则默认模型为 gplates。
gplates:Wright et. al., 2013; Towards community-driven paleogeographic reconstructions
scotese:Scotese, C.R., 2021. An Atlas of Paleogeographic Maps: The Seas Come In and the Seas Go Out, Annual Reviews of Earth and Planetary Sciences, v. 49, p. 669-718
seton:Seton et. al., 2012; Global continental and ocean basin reconstructions since 200 Ma
pgs:指定是返回每个采集记录的年龄范围的开头、中间还是结尾的古坐标。可接受的值为:early, mid, late。您可以指定多个作为逗号分隔的列表。
cc:仅返回位置在指定地理区域内的记录。此参数的值应为一个或多个双字符国家/地区代码和/或三个字符的洲代码作为逗号分隔的列表。如果参数值以 ! 开头,则属于这些区域的记录将被排除而不是包括在内。任何以 ^ 开头的国家/地区代码都将从过滤器中减去。例如:
ATA,AU:选择来自南极洲和澳大利亚的产出记录
NOA,SOA,^AR,^BO:选择来自北美和南美的实例,但不包括阿根廷或玻利维亚
!EUR,^IS:排除来自欧洲的产出记录,但来自冰岛的除外
state:仅从指示为属于指定州或省的采集记录中返回产出记录。此信息不会记录所有采集记录,并且未检查其准确性。鉴于国家/地区之间有时会重复州名称,因此建议也使用 cc 参数指定国家/地区。
county:仅返回指定属于指定县或其他次州级行政区划的采集记录中的产出记录。此信息不会记录所有采集记录,并且未检查其准确性。鉴于县名经常在州和国家/地区之间重复,建议您同时使用 state 参数指定州,并使用 cc 参数指定国家/地区。
continent:仅返回地理位置在一个或多个指定大陆内的记录。此参数的值应为以逗号分隔的洲代码列表。此参数已弃用;请改用cc。
strat:仅返回属于指定地质地层或地层内的记录。您可以指定多个,用逗号分隔。名称可以包括标准的SQL通配符 % 和 _ ,并且可以跟着’fm’,‘gp’,'mbr’中的任何一个。如果未给出这些后缀,则将选择所有匹配的地层名称。如果参数值以 ! 开头,则与此层或地层关联的记录将被排除而不是包括在内。请注意,此参数仅通过字符串匹配进行解析。地层命名法目前在数据库中没有标准化,因此可能会出现拼写错误。
formation:仅返回属于指定地层构造内的记录。此参数已弃用,请改用 strat。
stratgroup:仅返回属于指定地层组内的记录。此参数已弃用,请改用 strat。
member:仅返回属于指定地层成员的记录。此参数已弃用,请改用 strat。
lithology:仅返回记录为来自任何指定岩性和/或岩性类型的记录。如果参数值字符串以 !然后,将改为排除匹配的记录。如果符号 ^ 出现在任何岩性名称的开头,则所有后续值将从过滤器中减去。例如:carbonate,^bafflestone。
envtype:仅返回记录为属于任何指定环境和/或环境区域的记录。如果参数值字符串以 !然后,将改为排除匹配的记录。如果符号 ^ 出现在任何环境代码的开头,则将从筛选器中减去所有后续值。例如:terr,^fluvial,lacustrine or !slope,^carbonate。您可以指定以下一个或多个值作为逗号分隔的列表:
terr:任何陆相环境
marine:任何海相环境
carbonate:碳酸盐环境
silicic:硅碎屑环境
unknown:未知或不确定的环境
lacust:湖区
fluvial:河流区
karst:喀斯特地带
terrother:其他陆地区域
marginal:边缘海洋区
reef:礁石区
stshallow:浅潮下带
stdeep:深潮下带
offshore:近海区
slope:斜坡/盆地区
marindet:海洋不确定区
interval_id:仅返回其时间在给定的地质时间间隔内(由数字标识符指定)的记录。如果指定多个间隔,则使用的时间范围将从最早指定间隔的开始到最晚指定间隔的结束的连续时间段。
interval:仅返回其时空位置在命名的地质时间间隔内(由名称指定)内的记录。您可以指定多个间隔,用逗号或短划线分隔。如果指定多个间隔,则使用的时间范围将从最早指定间隔的开始到最晚指定间隔的结束的连续时间段。
min_ma:仅返回其时间位置至少为此的记录,单位为Ma。
max_ma:仅返回其时间位置至多为此的记录,单位为Ma。
timerule:根据指定的规则解析时空位置,如下所示。对于多样性输出,此规则应用于将每个匹配项放入一个或多个时态条柱中,或者在与任何条柱不匹配时忽略该项。可用的规则包括:
contain:仅选择其时空位置严格包含在指定时间范围内的记录。这是最严格的规则。对于多样性输出,此规则保证每个匹配项最多落入一个时态图格,但许多实例将被忽略,因为它们的时间位置太宽而无法落入任何条柱中。
major:仅选择至少 50% 的时态位置范围落在指定时间范围内的记录。对于多样性输出,此规则还保证每个匹配项最多落入一个时态条柱。许多匹配项将被忽略,因为它们的时间位置宽度是任何重叠条柱的两倍多,但忽略的次数少于contain规则。这是默认时间规则,除非您专门选择一个时间规则。
buffer:仅选择其时间位置与指定时间范围重叠且完全位于此范围周围的“缓冲区”内的记录。这个缓冲区默认为古生代和中生代的1200万年,新生代的默认值为500万年。您可以使用参数timebuffer和late_buffer覆盖缓冲区宽度。对于多样性输出,某些事件将计为落入多个箱中。某些事件仍将被忽略,但比上述规则要少。
overlap:仅选择其时态位置与指定时间范围重叠任意数量的记录。这是最宽松的规则。对于多样性输出,将计算所有产出记录。许多人将被计入多个条箱中。
timebuffer:解析时间局部性时覆盖默认缓冲期。该值必须以数百万年为单位给出。仅当timerule设置为buffer时,此参数才相关。
latebuffer:解析时间局部性时,覆盖时间范围结束时的默认缓冲期。这允许缓冲区在间隔的后期与在早期结束时不同。该值必须以数百万年为单位给出。仅当timerule设置为buffer时,此参数才相关。
如果您希望使用其中之一,并且尚未指定上面列出的任何选择参数,请使用 all_records。
最简单的方法是使用下载生成器表单。
当然还可以使用任何特殊参数,请参阅PBDB Data Service:Special parameters(特殊参数)。
这个数据服务接受以下HTTP方法:GET,HEAD。
使用此操作对HTTP请求的响应将包含以下列表中的字段。
字段名(pbdb) | 字段名(com) | 描述 |
---|---|---|
opinion_no | oid | 此意见记录的唯一标识符。 |
record_type | typ | 此记录的类型。 |
opinion_type | otp | 所代表的意见类型:C代表分类意见,U代表未被选为分类意见的意见。 |
taxon_rank | rnk | 本意见所分配的分类学名称的等级,该分类学名称是本意见的主题。 |
taxon_name | nam | 作为本意见主题的分类学名称。 |
orig_no | tid | 作为本意见主题的分类名称的标识符。 |
child_name | cnm | 作为本意见主题的名称的特定变体(如果与当前接受的名称不同)。 |
child_spelling_no | vid | 作为本意见主题的特定变体的标识符。 |
status | sta | 本意见所表达的该名称的分类学地位。 |
parent_name | prl | 放置主题的分类名称(“父”分类名称)。请注意,此字段的值是意见中给出的名称的特定变体,不一定是当前接受的变体。 |
parent_no | par | 父分类名称的标识符。 |
parent_spelling_no | pva | 意见中给出的父名称变体的标识符(如果这与该名称的当前接受变体不同)。 |
spelling_reason | spl | 说明为什么给出这个名字。 |
basis | bas | 意见的依据,见上文列表。 |
author | oat | 意见的作者。 |
pubyr | opy | 意见发布的年份。 |
reference_no | rid | 输入此意见的参考文献的标识符。 |
字段名(pbdb) | 字段名(com) | 描述 |
---|---|---|
taxon_attr | att | 作为本意见主题的分类学名称的归属(作者和年份)。 |
parent_attr | atp | 父分类名称的归属(作者和年份)。 |
字段名(pbdb) | 字段名(com) | 描述 |
---|---|---|
basis | bas | 意见的依据,见上文列表。 |
字段名(pbdb) | 字段名(com) | 描述 |
---|---|---|
ref_author | aut | 输入此意见的参考文献的作者。请注意,如果参考文献是次要来源,则意见本身的作者可能会有所不同。 |
ref_pubyr | pby | 输入此意见的参考文献的发布年份。请注意,如果参考文献是次要来源,则意见本身的年份可能会有所不同。 |
字段名(pbdb) | 字段名(com) | 描述 |
---|---|---|
lft | lsq | 此数字给出了主题分类单元在分类树的预序遍历中的位置。 |
rgt | rsq | 此数字大于或等于该分类单元的所有子分类单元的序列号的最大值,并且小于序列中任何后续分类单元的序列。您可以使用它以及 lft 来确定子分类单元关系。 |
字段名(pbdb) | 字段名(com) | 描述 |
---|---|---|
primary_reference | ref | 与此记录关联的主要引用(作为格式化文本) |
字段名(pbdb) | 字段名(com) | 描述 |
---|---|---|
authorizer_no | ati | 授权输入此记录的人员的标识符 |
enterer_no | eni | 实际输入此记录的人员的标识符。 |
modifier_no | mdi | 上次修改此记录的人员的标识符(如果已修改)。 |
字段名(pbdb) | 字段名(com) | 描述 |
---|---|---|
authorizer_no | ati | 授权输入此记录的人员的标识符 |
enterer_no | eni | 实际输入此记录的人员的标识符。 |
modifier_no | mdi | 上次修改此记录的人员的标识符(如果已修改)。 |
authorizer | ath | 授权输入此记录的人员的姓名 |
enterer | ent | 实际输入此记录的人员的姓名 |
modifier | mdf | 上次修改此记录的人员的姓名(如果已修改)。 |
字段名(pbdb) | 字段名(com) | 描述 |
---|---|---|
created | dcr | 创建此记录的日期和时间。 |
modified | dmd | 上次修改此记录的日期和时间。 |
以下响应格式可用于此操作。必须通过向 URI 路径添加适当的后缀来为请求选择所需的格式。
格式 | 后缀 | 文档 |
---|---|---|
JSON | .json | JSON format |
Comma-separated text | .txt | Text formats |
Comma-separated text | .csv | Text formats |
Tab-separated text | .tsv | Text formats |
RIS | .ris | RIS format |
术语表 | 名称 | 默认格式 | 描述 |
---|---|---|---|
PaleobioDB field names | pbdb | txt, csv, tsv | PBDB词汇表来自数据库中的基础字段名和值,并增加了一些新字段。在大多数情况下,使用此词汇表的响应将直接与从PBDB Classic接口下载的响应相比较。此词汇表是Text格式响应的默认词汇。 |
Compact field names | com | json | Compact词汇表是一组3个字符的字段名,旨在将响应消息的大小最小化。这是JSON格式响应的默认值。一些字段值被类似地简化,而其他字段值则被完整地传递。 |