Back to Details

searching-academic-outputs-with-dimensions

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Overview

概述

Query the Dimensions academic database to find publications, grants, patents, clinical trials, and researchers using the shortwing CLI.
Queries use the Dimensions Search Language (DSL) piped to shortwing.
Reference Documentation:
  • dsl-reference.md — Full DSL syntax, operators, fields, and example queries
Authentication: Requires API key from https://app.dimensions.ai/account/tokens. Configure credentials in 
~/.dimensions/dsl.ini
or use environment variables (
DIMENSIONS_KEY
, 
DIMENSIONS_ENDPOINT
). See Authentication section in dsl-reference.md for details.
使用shortwing CLI查询Dimensions学术数据库，以查找出版物、资助项目、专利、临床试验和研究人员信息。查询需使用Dimensions搜索语言（DSL）并通过管道传递给shortwing。
参考文档：
  • dsl-reference.md — 完整的DSL语法、运算符、字段及示例查询
身份验证： 需要从https://app.dimensions.ai/account/tokens获取API密钥。可在`~/.dimensions/dsl.ini`中配置凭据，或使用环境变量（`DIMENSIONS_KEY`、`DIMENSIONS_ENDPOINT`）。详情请参阅[dsl-reference.md](dsl-reference.md)中的身份验证章节。

Quick Start

快速开始

bash
undefined
bash
undefined

Search publications

搜索出版物

echo 'search publications for "machine learning" return publications limit 10' | shortwing
echo 'search publications for "machine learning" return publications limit 10' | shortwing

Search grants

搜索资助项目

echo 'search grants for "artificial intelligence" return grants[title+funding_usd] limit 10' | shortwing
echo 'search grants for "artificial intelligence" return grants[title+funding_usd] limit 10' | shortwing

Find researchers

查找研究人员

echo 'search researchers for "John Smith" return researchers[first_name+last_name+current_research_org] limit 10' | shortwing
undefined
echo 'search researchers for "John Smith" return researchers[first_name+last_name+current_research_org] limit 10' | shortwing
undefined

Query Structure

查询结构

search <source> [for "<terms>"] [where <filters>] return <result> [limit N]
search <source> [for "<terms>"] [where <filters>] return <result> [limit N]

Available Sources

可用数据源

SourceDescription
publications
Research papers, articles, books
grants
Research funding awards
patents
Patent applications and grants
clinical_trials
Clinical trial records
researchers
Researcher profiles
datasets
Research datasets
数据源描述
publications
研究论文、文章、书籍
grants
研究资助项目
patents
专利申请与授权
clinical_trials
临床试验记录
researchers
研究人员档案
datasets
研究数据集

Common Query Patterns

常见查询模式

TaskQuery
Search by keyword
search publications for "CRISPR" return publications limit 20
Filter by year
search publications where year=2024 return publications limit 10
Search title only
search publications in title_only for "climate change" return publications limit 10
Highly cited papers
search publications for "AI" where times_cited>100 return publications sort by times_cited desc limit 10
Grants by funder
search grants where funders.name~"NIH" return grants[title+funding_usd] limit 10
Recent patents
search patents where filing_year>=2023 return patents[title+assignees] limit 10
Clinical trials
search clinical_trials for "diabetes" return clinical_trials[title+phase] limit 10
Aggregations
search publications for "robotics" return research_orgs aggregate count sort by count desc limit 10
任务查询语句
关键词搜索
search publications for "CRISPR" return publications limit 20
按年份筛选
search publications where year=2024 return publications limit 10
仅标题搜索
search publications in title_only for "climate change" return publications limit 10
高引用论文
search publications for "AI" where times_cited>100 return publications sort by times_cited desc limit 10
按资助方查找项目
search grants where funders.name~"NIH" return grants[title+funding_usd] limit 10
近期专利
search patents where filing_year>=2023 return patents[title+assignees] limit 10
临床试验检索
search clinical_trials for "diabetes" return clinical_trials[title+phase] limit 10
聚合统计
search publications for "robotics" return research_orgs aggregate count sort by count desc limit 10

Return Specific Fields

返回指定字段

Use 
+
to combine fields:
bash
echo 'search publications for "quantum" return publications[id+title+doi+year+times_cited] limit 10' | shortwing
使用
+
组合多个字段：
bash
echo 'search publications for "quantum" return publications[id+title+doi+year+times_cited] limit 10' | shortwing

Filter Operators

过滤运算符

OperatorExample
=
equals
year=2024
>
greater than
times_cited>100
~
contains
journal.title~"Nature"
in
range
year in [2020:2024]
and/or
combine
year=2024 and type="article"
运算符示例
=
等于
year=2024
>
大于
times_cited>100
~
包含
journal.title~"Nature"
in
范围
year in [2020:2024]
and/or
组合
year=2024 and type="article"

Boolean Search Operators

布尔搜索运算符

Boolean operators in search terms must be UPPERCASE and inside the quotes:
PatternExample
AND (both required)
for "machine learning AND healthcare"
OR (either matches)
for "python OR java"
NOT (exclude)
for "AI NOT robotics"
Grouped
for "(cancer OR tumor) AND treatment"
Exact phrase
for "\"peer feedback\""
(escaped quotes)
Proximity
for "\"formal model\"~10"
(within 10 words)
Important: Lowercase 
and/or
in the 
where
clause combines filters, but search terms require UPPERCASE 
AND/OR/NOT
.
搜索词中的布尔运算符必须为大写且位于引号内部：
模式示例
AND（同时满足）
for "machine learning AND healthcare"
OR（满足其一）
for "python OR java"
NOT（排除）
for "AI NOT robotics"
分组
for "(cancer OR tumor) AND treatment"
精确短语
for "\"peer feedback\""
（转义引号）
邻近搜索
for "\"formal model\"~10"
（10个词以内）
重要提示：
where
子句中的小写
and/or
用于组合过滤条件，但搜索词中必须使用大写的
AND/OR/NOT
。

Tips for Precise Results

精准检索技巧

  1. Use targeted search indexes for relevant results:
    bash
    # Most specific - title only
echo 'search publications in title_only for "machine learning" return publications limit 20' | shortwing

# Good balance - title and abstract
echo 'search publications in title_abstract_only for "peer feedback AND writing" return publications limit 20' | shortwing
  2. Use phrase searches for exact multi-word terms:
    bash
    echo 'search publications in title_abstract_only for "\"formative assessment\" AND \"higher education\"" return publications limit 20' | shortwing
  3. Combine search with filters to narrow scope:
    bash
    echo 'search publications in title_abstract_only for "\"peer review\"" where year>=2020 and times_cited>10 return publications[title+doi+times_cited+year] limit 20' | shortwing
  4. Filter by citation count to find influential papers:
    bash
    echo 'search publications for "cognitive load" where times_cited>50 return publications sort by times_cited desc limit 10' | shortwing
  1. 使用针对性的搜索索引获取相关结果：
    bash
    # 最精准 - 仅标题
echo 'search publications in title_only for "machine learning" return publications limit 20' | shortwing

# 平衡精准度与覆盖范围 - 标题和摘要
echo 'search publications in title_abstract_only for "peer feedback AND writing" return publications limit 20' | shortwing
  2. 使用短语搜索匹配精确的多词术语：
    bash
    echo 'search publications in title_abstract_only for "\"formative assessment\" AND \"higher education\"" return publications limit 20' | shortwing
  3. 结合搜索与过滤条件缩小范围：
    bash
    echo 'search publications in title_abstract_only for "\"peer review\"" where year>=2020 and times_cited>10 return publications[title+doi+times_cited+year] limit 20' | shortwing
  4. 按引用次数过滤找到有影响力的论文：
    bash
    echo 'search publications for "cognitive load" where times_cited>50 return publications sort by times_cited desc limit 10' | shortwing

General Tips

通用技巧

  • Always use double quotes around search terms: 
    for "search term"
  • Use 
    ~
    for partial string matching: 
    where journal.title~"Nature"
  • Use 
    limit
    to control result size
  • See dsl-reference.md for complete syntax and all available fields
  • 始终在搜索词周围使用双引号：
    for "search term"
  • 使用
    ~
    进行部分字符串匹配：
    where journal.title~"Nature"
  • 使用
    limit
    控制结果数量
  • 查看dsl-reference.md获取完整语法和所有可用字段

Error Handling

错误处理

ErrorSolution
shortwing not foundInstall from ~/aves/shortwing: 
cd ~/aves/shortwing && uv pip install .
Configuration error (exit code 2)Set 
DIMENSIONS_KEY
env var or create 
~/.dimensions/dsl.ini
Invalid credentialsGet new key from https://app.dimensions.ai/account/tokens
Query syntax error (exit code 1)Check DSL syntax in dsl-reference.md
错误解决方法
shortwing未找到从~/aves/shortwing安装：
cd ~/aves/shortwing && uv pip install .
配置错误（退出码2）设置
DIMENSIONS_KEY
环境变量或创建
~/.dimensions/dsl.ini
文件
凭据无效从https://app.dimensions.ai/account/tokens获取新密钥
查询语法错误（退出码1）查看dsl-reference.md中的DSL语法规范