Skip to content

CitationGecko/gecko-react

Repository files navigation

Welcome to Citation Gecko!

Open Source Love MIT Licence DOI

This is a tool that uses the citation relations between scientific papers to help researchers find interesting and relevant papers.

The user specifies several 'seed' papers which define the specific area of the scientific landscape they are interested in.

The tool then searches several databases to find the papers that cite or are cited-by the seed papers.

Papers that are cited by a lot of the seed papers are likely to be important foundational papers in the field (or certainly worth being aware of at least).

Papers that cite a lot of the seed papers are likely to be more recent papers in the same area that might be worth reading.

The tool allows the user to view these highly connected papers either in a table or in the context of the network.

Live demo

citationgecko.com

Running Citation Gecko locally

  1. Clone the git repo: git clone https://github.com/CitationGecko/gecko-react
  2. If you don't have it already install Node.js from https://nodejs.org/en/.
  3. Install Yarn from https://yarnpkg.com/getting-started/install
  4. Open a terminal and navigate to the repository folder.
  5. Run yarn from the command line to install all the package dependencies.
  6. Run yarn run build from the command line to build the app.
  7. Run yarn run start to launch the server.
  8. The application will be served to http://localhost:8000

Instructions for use

  1. Go to citationgecko.com or localhost:8000 if you're running application locally
  2. Add some seed papers by clicking 'Add more seeds' button in the left-hand panel.
  3. There are several ways of choosing seed papers to start with: 2. Upload a bibTex file (NOTE: currently only entries with a DOI will be added)
    • There is an example BibTex in the repository (public/examples/exampleBibTex.bib) which you can try importing as a test case.
    1. Search for seed papers
      • Sends the query to the CrossRef API, can use title / author / keywords etc.
      • Choose which papers to add as seeds by clicking the Add buttons at the end of each row.
    2. Import from Zotero
      • This will redirect you to Zotero in order to authenticate the app allow you to add papers in your zotero collections.
  4. The seed papers added are listed in the left-hand panel and connections between them shown graphically in the right hand panel.
  5. For a list of the papers connected to these seed papers click the icon with 3 dots in the side bar.
  6. You can switch between viewing a graph showing only references of the seed papers and a graph showing only the papers that cite the seed papers by clicking the toggle between 'Papers Cited-By Seed Papers' and 'Papers Citing Seed Papers' that also acts as a key.
  7. If one of the connected papers seems highly relevant you can add it as a seed paper either from the list view or network view, expanding the network in order to uncover more papers.

Citing CitationGecko

To cite CitationGecko use the following details:

Author: Barnabas James Walker

Title: CitationGecko

DOI: https://doi.org/10.5281/zenodo.7068284

An example format may be:

Walker. B (2022) CitationGecko [Software] https://doi.org/10.5281/zenodo.7068284