https://github.com/digital-science/dimcli

Python client and CLI for scientometrics and research analytics using the Dimensions API.
https://github.com/digital-science/dimcli

api cli dimensions jupyter-notebook python research-analytics scientometrics

Last synced: about 1 month ago
JSON representation

Python client and CLI for scientometrics and research analytics using the Dimensions API.

• Host: GitHub
• URL: https://github.com/digital-science/dimcli
• Owner: digital-science
• License: mit
• Created: 2018-05-18T16:16:51.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2023-12-12T10:40:24.000Z (11 months ago)
• Last Synced: 2024-04-29T23:00:02.679Z (7 months ago)
• Topics: api, cli, dimensions, jupyter-notebook, python, research-analytics, scientometrics
• Language: Jupyter Notebook
• Homepage: https://digital-science.github.io/dimcli/getting-started.html
• Size: 45.2 MB
• Stars: 43
• Watchers: 9
• Forks: 6
• Open Issues: 19
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Dimcli

Dimcli is a Python client for accessing the Dimensions Analytics API. It makes it easier to authenticate against the API, send queries to it and process the JSON data being returned.  

```bash

>>> import dimcli

>>> dimcli.login(key="private-key-here",  

                 endpoint="https://app.dimensions.ai/api/dsl/v2")

               

>>> dsl = dimcli.Dsl()

>>> res = dsl.query("""search grants for "malaria" return researchers""")

>>> print(res.json)

{'researchers': [{'id': 'ur.01332073522.49',

   'count': 75,

   'last_name': 'White',

   'first_name': 'Nicholas J'},

  {'id': 'ur.01343654360.43',

   'count': 59,

   'last_name': 'Marsh',

   'first_name': 'Kevin'},

  .............

  ],

 '_stats': {'total_count': 8735}}

```

## CLI

Dimcli includes also a command line interface (CLI) that aims at simplifying the process of learning the grammar of the Dimensions Search Language (DSL).

![dimcli_animation](https://raw.githubusercontent.com/digital-science/dimcli/master/static/dimcli_animated.gif)

## Jupyter

Dimcli plays nice with Jupyter notebooks too. It comes with various magic commands for querying the API, transforming JSON data into dataframes and turning them into interactive tables with hyperlinks - so that data can be inspected further on external websites. 

![dimcli_animation_jupyter](https://raw.githubusercontent.com/digital-science/dimcli/master/static/dimcli_animated_jupyter.gif)

## More info

For more information see the [Getting Started with Dimcli](https://digital-science.github.io/dimcli/getting-started.html) tutorial.

Current version: see [pypi homepage](https://pypi.org/project/dimcli/). Source code hosted on [github](https://github.com/digital-science/dimcli). 

[![Downloads](https://pepy.tech/badge/dimcli)](https://pepy.tech/project/dimcli)

## Comments, bug reports

Dimcli lives on [Github](https://github.com/digital-science/dimcli/). You can file [issues]([issues](https://github.com/digital-science/dimcli/issues/new)) or pull requests there. Suggestions, pull requests and improvements welcome!