PySpotlight 0.7.2

安装

最新稳定版本可在Python包索引（PyPI）上找到。

因此，安装就像这样简单

pip install pyspotlight

可以通过指定版本安装旧版本

pip install pyspotlight~=0.6.1

从源/github安装的要求

本模块已在Python 2.7和Python 3.5上进行了测试。

只要您使用< span class="docutils literal">setup.py进行安装（python setup.py install），就没有问题，因为Python会为您处理依赖项。

如果您决定不使用< span class="docutils literal">setup.py，则需要< span class="docutils literal">requests库。

所有这些包都可以在Python包索引中找到，并且可以通过easy_install或推荐的方法，即pip轻松安装。

使用< span class="docutils literal">pip特别容易，因为您只需这样做

pip install -r requirements.txt

它将安装该文件中列出的所有包依赖项。

用法

用法简单易懂，就像API一样简单

>>> import spotlight
>>> annotations = spotlight.annotate('http://localhost/rest/annotate',
...                                  'Your test text',
...                                  confidence=0.4, support=20)

这将返回给定文本中找到的所有资源的列表。假设我们为以下文本做了这样的事情

President Obama on Monday will call for a new minimum tax rate for individuals making more than $1 million a year to ensure that they pay at least the same percentage of their earnings as other taxpayers, according to administration officials.

我们可能会得到这个

>>> spotlight.annotate('http://localhost/rest/annotate', sample_txt)
[
  {
    'URI': 'http://dbpedia.org/resource/Presidency_of_Barack_Obama',
    'offset': 0,
    'percentageOfSecondRank': -1.0,
    'similarityScore': 0.10031112283468246,
    'support': 134,
    'surfaceForm': 'President Obama',
    'types': 'DBpedia:OfficeHolder,DBpedia:Person,Schema:Person,Freebase:/book/book_subject,Freebase:/book,Freebase:/book/periodical_subject,Freebase:/media_common/quotation_subject,Freebase:/media_common'
  },
  …(truncated remaining elements)…
]

Spotlight API支持的所有附加过滤参数都可以传递给字典中的< span class="docutils literal">filters参数。

例如

>>> only_person_filter = {
...     'policy': "whitelist",
...     'types': "DBpedia:Person",
...     'coreferenceResolution': False
... }

>>> spotlight.annotate(
...     "http://localhost/rest/annotate",
...     "Any collaboration between Shakira and Metallica seems highly unlikely.",
...     filters=only_person_filter
... )

[{
    'URI': 'http://dbpedia.org/resource/Shakira',
    'offset': 26,
    'percentageOfSecondRank': 1.511934771738109e-09,
    'similarityScore': 0.9999999984880361,
    'support': 2587,
    'surfaceForm': 'Shakira',
    'types': 'Schema:MusicGroup,DBpedia:Agent,Schema:Person,DBpedia:Person,DBpedia:Artist,DBpedia:MusicalArtist'
}]

相同的参数也适用于< span class="docutils literal">spotlight.candidates函数，它返回所有匹配候选实体的列表，而不仅仅是顶级候选实体。

请注意，Spotlight API可能支持尚未在pyspotlight中实现的其他接口。请随意贡献 :-)!

提示

我们强烈建议尝试调整< em>置信度和< em>支持度值。此外，通过查看它们的< em>相似度得分（即上下文得分）来过滤更多注释可能更可取。

如果您想更改默认值，请随意使用itertools.partial创建一个带有简化签名的包装器

>>> from spotlight import annotate
>>> from functools import partial
>>> api = partial(annotate, 'http://localhost/rest/annotate',
...               confidence=0.4, support=20,
...               spotter='SpotXmlParser')
>>> api('This is your test text. This function uses a non-default
...      confidence, support, and spotter. Furthermore all calls go
...      directly to localhost/rest/annotate.')

正如您所看到的，这大大减少了函数的复杂性。Pyspotlight提供基于函数的接口，而不是基于类，以避免不必要的间接层。

测试

如果您想运行测试，您需要从 PyPI 安装 nose2 (~0.6)。然后，您可以从命令行在这个或 spotlight/ 目录下简单地运行 nose2。

所有开发和常规依赖项都可以通过单个命令安装

pip install -r requirements-dev.txt

错误

如果您发现错误，请创建一个问题，并附加您发送的原始响应。请参考 ubergrape/pyspotlight#3 了解如何提交良好的错误报告的示例。

变更日志