wcmcits/reciter repository overview

⁠ReCiter

⁠Purpose

ReCiter is a highly accurate system for guessing which publications in PubMed a given person has authored. ReCiter includes a Java application, a DynamoDB-hosted database, and a set of RESTful microservices which collectively allow institutions to maintain accurate and up-to-date author publication lists for thousands of people. This software is optimized for disambiguating authorship in PubMed and, optionally, Scopus.

ReCiter accurately identifies articles, including those at previous affiliations, by a given person. It does this by leveraging institutionally maintained identity data (e.g., departments, relationships, email addresses, year of degree, etc.) With the more complete and efficient searches that result from combining these types of data, you can save time and your institution can be more productive. If you run ReCiter daily, you can ensure that the desired users are the first to learn when a new publication has appeared in PubMed.

ReCiter is fast. It uses an advanced multi-threading strategy known as a work stealing pool⁠ to make up to 10 retrieval requests at a time.

ReCiter is freely available and open source under the Apache 2.0 license⁠.

Please see the ReCiter wiki⁠ for more information.

⁠Technical

⁠Prerequisites

• Java 11
• Latest version of Maven. To install Maven navigate to the directory where ReCiter will be installed, execute brew install maven and then mvn clean install

If you want to use Java 8 then update <java.version>1.8</java.version> in pom.xml⁠

It is not necessary to install ReCiter in order to use the API.

⁠Technological stack

Key technologies include:

• ReCiter stores data about researchers and publications in DynamoDB, which can be hosted on Amazon AWS or installed locally.
• Its main computation logic is written in Java.
• It employs the Spring Framework, a Java-based application framework designed to manage RESTful web services and server requests.
• ReCiter uses Swagger, a toolset that provides a user interface with helpful cues for how to interact with the application's RESTful APIs.

You may choose to run ReCiter on either:

• A server - ReCiter will run on Linux, Mac OS X, and Windows versions 7 and higher. A minimum of 4GB of RAM is required; 16GB of RAM are recommended. An Internet connection is required to download article data from scholarly databases.
• A local machine - ReCiter's APIs may be run in a browser on any modern machine. The ReCiter server must be accessible to the local machine via a local area network or internet connection.

⁠Related code repositories

The ReCiter application depends on the following separate GitHub-hosted repositories:

• PubMed Retrieval Tool⁠
• Scopus Retrieval Tool⁠ (optional)
• Data models:
  • ReCiter-Identity-Model⁠
  • ReCiter-Scopus-Model⁠
  • ReCiter-Article-Model⁠
  • ReCiter-Dynamodb-Model⁠
  • ReCiter-PubMed-Model⁠

Additionally, users can install:

• ReCiter Publication Manager⁠ - a user interface tool
• ReCiter Machine Learning / Analysis⁠ - a suite of scripts and tools for retrieving and analyzing data from ReCiter