PBDB Data Service：Fossil diversity over time (quick computation) 化石多样性随时间的变化（快速计算）

描述

此操作返回化石多样性随时间变化的表格，类似于 occs/diversity 提供的表格。它返回结果的速度要快得多，但只返回每个时间间隔中出现的不同分类群的基本计数。此操作适用于快速概览图。如果您想进行详细的多样性分析，我们建议您改用occs/diversity 操作，或者list of occurrences并执行您自己的程序，以制表随时间推移的分类群多样性。

用法

• /data1.2/occs/quickdiv.txt?base_name=Dinosauria^Aves&continent=NOA&count=genera

"interval_no","interval_name","max_ma","min_ma","sampled_in_bin","n_occs"
"111","Danian","66.00000","61.60000","1","1"
"112","Maastrichtian","72.10000","66.00000","137","3533"
"113","Campanian","83.60000","72.10000","130","2558"
"114","Santonian","86.30000","83.60000","8","33"
"115","Coniacian","89.80000","86.30000","5","20"
"116","Turonian","93.90000","89.80000","18","88"
"117","Cenomanian","100.50000","93.90000","28","143"
"118","Albian","113.00000","100.50000","46","627"
"119","Aptian","125.00000","113.00000","19","92"
"120","Barremian","129.40000","125.00000","24","84"
"121","Hauterivian","132.90000","129.40000","4","9"
"122","Valanginian","139.80000","132.90000","4","6"
"123","Berriasian","145.00000","139.80000","6","11"
"124","Tithonian","152.10000","145.00000","44","676"
"125","Kimmeridgian","157.30000","152.10000","46","757"
"126","Oxfordian","163.50000","157.30000","22","46"
"127","Callovian","166.10000","163.50000","6","17"
"128","Bathonian","168.30000","166.10000","2","13"
"129","Bajocian","170.30000","168.30000","2","11"
"130","Aalenian","174.10000","170.30000","2","10"
"131","Toarcian","182.70000","174.10000","6","43"
"132","Pliensbachian","190.80000","182.70000","15","113"
"133","Sinemurian","199.30000","190.80000","31","353"
"134","Hettangian","201.30000","199.30000","28","436"
"135","Rhaetian","208.50000","201.30000","9","51"
"136","Norian","228.00000","208.50000","22","185"
"137","Carnian","237.00000","228.00000","2","5"

参数

以下参数指定要计数的内容以及时间分辨率

• count：此参数指定要计数的分类级别。如果未指定，则默认为属。接受的值有：genera——计数属，也可写作genus；families——计数科，也可写作family。orders——计数目，也可写作order。
• time_reso：此参数指定计数的时间分辨率。如果未指定，则默认为stage。您还可以使用参数名称 reso。接受的值为：stage——计数阶；epoch——计数世；period——计数纪；era——计数代。

以下参数选择要分析的实例

*除了特别说明外，您可以任意组合使用它们。*所有这些参数也可以与 occs/list 一起使用，以检索用于计算此多样性表的确切事件列表。但是请注意，在制表多样性时，可能会跳过某些事件，因为它们在时间或分类学上描述得不精确。

• 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时，此参数才相关。

当然还可以使用任何特殊参数，请参阅PBDB Data Service：Special parameters（特殊参数）。

响应结果

使用此操作对HTTP请求的响应将包含以下列表中的字段。

1：basic

字段名（pbdb）	字段名（com）	描述
interval_no	oid	此记录表示的时间间隔的标识符
interval_name	nam	此记录表示的时间间隔的名称
max_ma	eag	这个间隔的最大年龄，Ma为单位。
min_ma	lag	这个间隔的最小年龄，Ma为单位。
sampled_in_bin	dsb	在此区间内发现的不同分类群的数量。这等于前四个字段的总和，减去来自 Xbt 的分类群数量，这些分类群实际上没有在此区间内发生。
n_occs	noc	解析到此间隔的出现次数总数

格式

以下响应格式可用于此操作。必须通过向 URI 路径添加适当的后缀来为请求选择所需的格式。

格式	后缀	文档
JSON	.json	JSON format
Comma-separated text	.txt	Text formats
Comma-separated text	.csv	Text formats
Tab-separated text	.tsv	Text formats

术语表

术语表	名称	默认格式	描述
PaleobioDB field names	pbdb	txt, csv, tsv	PBDB词汇表来自数据库中的基础字段名和值，并增加了一些新字段。在大多数情况下，使用此词汇表的响应将直接与从PBDB Classic接口下载的响应相比较。此词汇表是Text格式响应的默认词汇。
Compact field names	com	json	Compact词汇表是一组3个字符的字段名，旨在将响应消息的大小最小化。这是JSON格式响应的默认值。一些字段值被类似地简化，而其他字段值则被完整地传递。