PBDB Data Service: Most prevalent taxa（最普遍的分类群）

Most prevalent taxa（最普遍的分类群）

描述
用法
参数
方法
响应结果
- 1：basic
格式
术语表

描述

此操作从选定的化石出现集中返回最普遍的分类群列表（根据出现次数）。这些分类群将是门和/或纲，具体取决于列表的大小和请求的条目数。大致处于纲水平的主要分类群可以包括在内，即使它们没有正式排名在该级别。与此数据服务的大多数操作不同，参数限制在确定结果的元素时非常重要。较大的限制将倾向于显示纲而不是门。

用法

/data1.2/occs/prevalence.json?continent=noa&interval=mesozoic&limit=10

{"elapsed_time":0.346,
"records": [
{"oid":"7805","nam":"Mollusca","rnk":20,"img":"935","noc":52761},
{"oid":"4","nam":"Radiolaria","rnk":17,"img":"1723","noc":11669},
{"oid":"36322","nam":"Reptilia (other)","rnk":17,"img":"243","noc":5864},
{"oid":"38505","nam":"Saurischia","rnk":17,"img":"1019","noc":3182},
{"oid":"38712","nam":"Ornithischia","rnk":17,"img":"1014","noc":2973},
{"oid":"36651","nam":"Mammalia","rnk":17,"img":"1710","noc":2067},
{"oid":"4742","nam":"Anthozoa","rnk":17,"img":"2036","noc":1759},
{"oid":"34422","nam":"Chondrichthyes","rnk":17,"img":"875","noc":1682},
{"oid":"94889","nam":"Actinopteri","rnk":17,"img":"1669","noc":1432},
{"oid":"34881","nam":"Osteichthyes (other)","rnk":17,"img":"1201","noc":1378}
]
}

参数

此操作接受的参数与 /data1.2/occs/list_doc.html 接受的参数相同。

除了特别说明外，您可以任意组合使用它们。

coll_id：显示所列集合中分类群的流行率。
all_records：显示数据库中所有出现的分类群的流行率。
clust_id：仅返回与指定地理聚类关联的记录。您可以指定一个或多个集群 ID，以逗号分隔。
coll_match：将与collection_name和collection_aka字段匹配的字符串。仅当记录属于匹配的集合时，才会返回记录。此字符串可能包含通配符 % 和 _。事实上，除非您在开头和/或结尾包含 %，否则它可能与任何内容都不匹配。
coll_re：这就像coll_match，只是它需要一个正则表达式。您可以指定两个或多个由竖线字符 | 分隔的替代项，并且可以使用所有其他标准正则表达式语法，包括反斜杠。
base_name：仅返回与指定分类名称关联的记录，包括所有子分类单元和同义词。您可以指定多个名称，用逗号分隔。您可以使用 ^ 字符将一个或多个排除项附加到任何名称。
taxon_name：仅返回与指定分类名称关联的记录，包括任何同义词。您可以指定多个名称，用逗号分隔。名称可能包含通配符，但如果多个名称匹配，则仅使用数据库中出现次数最多的名称。
match_name：仅返回与指定分类名称关联的记录。您可以指定多个名称，用逗号分隔。名称可能包含通配符 % 和 _，并且将返回与所有匹配名称关联的匹配项。同义词将被忽略。这是一种语法匹配，而不是分类匹配。
immediate：您可以指定此参数以及base_name、base_id或taxon_name。如果这样做，则将忽略指定名称的同义词。此参数不需要任何值，只需包含参数名称即可。
base_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：仅选择与由指定人员授权或输入的事件关联的记录，这些事件由名称或标识符指示

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

方法

这个数据服务接受以下HTTP方法：GET，HEAD。

响应结果

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

1：basic

字段名（pbdb）	字段名（com）	描述
taxon_no	oid	分类的标识符。
taxon_name	nam	分类单元的学名。
taxon_rank	rnk	分类单元的等级。
image_no	img	如果这个值是非零，你可以使用它来构造图像url，使用taxa/thumb和taxa/icon。
class_no	cln	此分类单元所属的类（如果有）。这将允许您从列表中排除订单（如果其类已列出）。
phylum_no	phn	该分类单元所属的门（如果有的话）。这将允许您从列表中排除一个纲或目（如果其门已经列出）。
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格式响应的默认值。一些字段值被类似地简化，而其他字段值则被完整地传递。

PBDB Data Service: Most prevalent taxa（最普遍的分类群）相关推荐

PBDB Data Service：Measurements of specimens（标本测量）
Measurements of specimens(标本测量) 描述参数以下参数可用于指定您感兴趣的标本种类以下参数可用于筛选所选内容以下参数还可用于根据分类筛选结果列表以下参数可用于生成数 ...
PBDB Data Service：RIS format
RIS format 描述概要描述本文详细介绍RIS格式. 概要 RIS(Research Information Systems,科研信息系统)格式是通过以后缀 .ris 结束URL路径来选择 ...
PBDB Data Service：Specimens and measurements（标本和测量）
Specimens and measurements(标本和测量) 描述摘要 1. [Single specimen(单个标本)](https://blog.csdn.net/whitedrogen ...
WCF Data Service 的.NET Client 的不支持原生类型服务操作的解决方法
WCF Data Service 的.NET Client 的不支持返回值为原生类型(string,int)的服务操作调用,例如我们用如下服务操作: [WebGet] public ObjectQu ...
WCF Data Service文章列表
张善友blogs,有不少文章 http://www.cnblogs.com/shanyou/category/240225.html WCF Data Service安全分析和说明 http://ww ...
WCF Data Service安全分析和说明
首先需要知道服务运行在asp.net的承载环境中,具体参考: http://blogs.msdn.com/b/wenlong/archive/2006/01/23/516041.aspx 关于安全有个 ...
Silverlight中服务通信方式的选择(WCF、Data Service、Ria Service)
Silverlight中服务通信方式的选择(WCF.Data Service.Ria Service) 转自 http://www.cnblogs.com/024hi/archive/2011/06/ ...
【转】WCF Data Service 使用小结（二） —— 使用WCF Data Service 创建OData服务
在上一章中,介绍了如何通过 OData 协议来访问 OData 服务提供的资源.下面来介绍如何创建一个 OData 服务.在这篇文章中,主要说明在.NET的环境下,如何使用 WCF Data Se ...
【转】WCF Data Service 使用小结（一）—— 了解OData协议
最近做了一个小项目,其中用到了 WCF Data Service,之前是叫 ADO.NET Data Service 的.关于WCF Data Service,博客园里的介绍并不多,但它确实是个很好的 ...

PBDB Data Service: Most prevalent taxa（最普遍的分类群）

Most prevalent taxa（最普遍的分类群）

描述

用法

参数

方法

响应结果

1：basic

格式

术语表

PBDB Data Service: Most prevalent taxa（最普遍的分类群）相关推荐

最新文章

热门文章