化石多样性随时间的变化(完整计算)
描述
此操作根据一组选定的产出记录返回化石多样性随时间变化的表格。您可以使用对 occs/list 操作有效的任何参数选择要分析的事件集。此操作可能会占用大量服务器时间,因此,如果您只想显示快速概览图,请使用 occs/quickdiv 操作。
需要注意的是,此操作返回的多样性统计数据仅反映该数据库中记录的化石数量,而不是整个化石记录。另请注意,任何在时间上或分类学上未充分解决的事件都将被忽略。如果您希望应用不同的过程来确定如何计算此类事件,我们建议您改用 occs/list 操作,并将您的过程直接应用于返回的发生列表。
此操作返回的字段名称派生自以下源:Origination and Extinction Components of Taxonomic Diversity: General Problems.
用法
"interval_no","interval_name","max_ma","min_ma","X_Ft","X_bL","X_FL","X_bt","sampled_in_bin","implied_in_bin","n_occs"
"106","Priabonian","38.00000","33.90000","0","0","0","0","0","0","1"
"107","Bartonian","41.30000","38.00000","0","0","0","0","0","0","0"
"108","Lutetian","47.80000","41.30000","0","0","0","0","0","0","0"
"109","Ypresian","56.00000","47.80000","0","0","0","0","0","0","0"
"110","Thanetian","59.20000","56.00000","0","0","0","0","0","0","0"
"743","Selandian","61.60000","59.20000","0","0","0","0","0","0","0"
"111","Danian","66.00000","61.60000","0","0","0","0","0","0","1"
"112","Maastrichtian","72.10000","66.00000","0","47","31","0","78","11","1745"
"113","Campanian","83.60000","72.10000","41","6","105","6","158","12","2956"
"114","Santonian","86.30000","83.60000","1","1","4","11","6","5","43"
"115","Coniacian","89.80000","86.30000","1","0","0","11","1","2","31"
"116","Turonian","93.90000","89.80000","0","0","4","11","5","2","25"
参数
以下参数指定要计数的内容以及时间分辨率
- count:此参数指定要计数的分类级别。如果未指定,则默认为属。接受的值有:species——计数物种;genera——计数属,也可写作genus;genera_plus——计数属,亚属提升为属。也可写作genus_plus。families——计数科,也可写作family。orders——计数目,也可写作order。
- subgenera:您可以将此参数用作快捷方式,等效于指定 count=genera_plus。只需包含其名称,不需要任何值。
- recent:如果指定了此参数,则已知现存的分类群将被视为范围到现在,而不管其最后一次已知化石出现的年龄如何。
- 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时,此参数才相关。
- occs_created_before:仅选择与在指定日期或日期/时间之前创建的事件关联的记录。
- occs_created_after:仅选择与在指定日期或日期/时间之后创建的事件关联的记录。
- occs_modified_before:仅选择与在指定日期或日期/时间之前修改的事件关联的记录。
- occs_modified_after:仅选择与在指定日期或日期/时间之后修改的事件关联的记录。
- occs_authorized_by:仅选择与指定人员授权的事件关联的记录,这些事件由名称或标识符指示。
- occs_entered_by:仅选择与指定人员输入的由名称或标识符指示的事件关联的记录
- occs_modified_by:仅选择与指定人员修改的事件关联的记录,这些事件由名称或标识符指示
- occs_touched_by:仅选择与指定人员授权、输入或修改的事件关联的记录,这些事件由名称或标识符指示
- occs_authent_by:仅选择与由指定人员授权或输入的事件关联的记录,这些事件由名称或标识符指示
以下参数可用于筛选分析多样性的实例选择
- pres:此参数指示是选择标识为遗迹分类群、形式分类群还是常规分类群的产出记录。默认值为 all,这将选择满足其他指定条件的所有记录。可以将以下一个或多个值指定为列表:
regular:选择常规分类群
form:选择形式分类群
ichno:选择遗迹分类群
all:选择所有分类群
以下参数可用于生成数据存档
最简单的方法是使用下载生成器表单。
- archive_title:此参数的值指示使用指定的标题创建存档,除非已存在存档。
- archive_replace:此参数的 true 值指示如果存在具有指定标题的现有存档,则其内容应替换为当前请求的输出。如果没有此参数,如果指定的标题与现有记录匹配,则将返回错误代码E_EXISTING。如果现有记录具有 DOI,则将返回错误E_IMMUTABLE,并且无法覆盖。
- archive_authors:此参数的值(如果有)将放入已创建或更新的存档记录的“作者”字段中。
- archive_desc:此参数的值(如果有)将放入已创建或更新的存档记录的“描述”字段中。
当然还可以使用任何特殊参数,请参阅PBDB Data Service:Special parameters(特殊参数)。
方法
这个数据服务接受以下HTTP方法:GET,HEAD。
响应结果
使用此操作对HTTP请求的响应将包含以下列表中的字段。
1:basic
字段名(pbdb) | 字段名(com) | 描述 |
---|---|---|
interval_no | oid | 此记录表示的时间间隔的标识符 |
interval_name | nam | 此记录表示的时间间隔的名称 |
max_ma | eag | 这个间隔的最大年龄,Ma为单位。 |
min_ma | lag | 这个间隔的最小年龄,Ma为单位。 |
X_Ft | xft | 首次出现在此区间内且其范围跨越区间顶部边界的不同分类群的数量:物种、属、科或目,具体取决于您为参数count提供的值。该字段和接下来三个字段的术语来自:Origination and Extinction Components of Taxonomic Diversity: General Problems。 |
X_bL | xbl | 其最后一次已知出现在此区间内且其范围跨越区间底部边界的不同分类群的数量。 |
X_FL | xfl | 仅在此区间内发现的不同分类群的数量,以便它们的出现范围不会跨越任一边界。 |
X_bt | xbt | 首次出现在此区间之前,最后一次出现在此区间之后的不同分类群的数量,以便出现范围跨越两个边界。请注意,这些分类群实际上可能发生也可能不发生在间隔内。 |
sampled_in_bin | dsb | 在此区间内发现的不同分类群的数量。这等于前四个字段的总和,减去来自 Xbt 的分类群数量,这些分类群实际上没有在此区间内发生。 |
implied_in_bin | dib | 由于不精确识别的发生,该区间中隐含的其他不同分类群的数量。例如,如果要对物种进行计数,则仅标识到属级别的事件将添加到此区间中未出现的属,则会在此计数中增加一个。这是一个实验性功能,此字段中报告的数字不会影响其他统计信息。如果需要,您可以随意忽略它。 |
n_occs | noc | 解析到此间隔的出现次数总数 |
摘要块将由以下列表中的字段组成。
2:summary
字段名(pbdb) | 字段名(com) | 描述 |
---|---|---|
n_occs | noc | 在计算此多样性结果的过程中扫描的出现次数。 |
bin_total | tbn | 所有箱中的出现次数总和。此值可能大于扫描的出现次数,因为某些可能计入多个箱(请参阅时间规则)。此值也可能小于扫描的出现次数,因为某些匹配项可能没有足够精确的时间位置,无法放入任何箱中。 |
imprecise_time | itm | 跳过的出现次数,因为它们的时间位置不够精确。您可以通过选择不同的时间规则和/或不同的时间分辨率级别来调整此数字。 |
imprecise_taxon | itx | 跳过的出现次数,因为它们的分类鉴定不够精确。您可以通过在更高或更低的分类级别计数来调整此数字。 |
missing_taxon | mtx | 由于此数据库中的分类层次结构不完整而跳过的出现次数。例如,某些属尚未归入其适当的家族,因此,如果您正在计算家族,则将跳过这些属中的出现次数。 |
格式
以下响应格式可用于此操作。必须通过向 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格式响应的默认值。一些字段值被类似地简化,而其他字段值则被完整地传递。 |