citation-map 2.0

A simple tool to generate your Google Scholar citation world map.

Google Scholar Citation World Map

Chen Liu, CS PhD Candidate at Yale University.

Research areas: Machine Learning, Spatial-Temporal Modeling, Medical Vision, AI4Science.

Purpose

This is a simple Python tool to generate an HTML citation world map from your Google Scholar ID.

It is easy to install (pip install citation-map, available on PyPI) and easy to use (see the Usage section).

Expected Outcome

You will be given an HTML file as the output of the script.

If you open it on a browser, you will see your own version of the following citation world map.

News

citation-map has been upgraded to version 2.0! I finally managed to drastically speed up the process using multiprocessing (without being blocked by Google Scholar). On my personal computer, processing my profile with 100 citations took 1 hour with version 1.0 while it's now taking 5 minutes with version 2.0.

Usage

1. Install the package.

   pip install citation-map
   

2. Find your Google Scholar ID.

   • Open your Google Scholar profile. The URL should take the form of https://scholar.google.com/citations?user=GOOGLE_SCHOLAR_ID. In this case, your Google Scholar ID is just the string GOOGLE_SCHOLAR_ID.
   • Please kindly ignore configuration strings such as &hl=en (host language is English) or &sortby=pubdate (sort the works by date of publication).

3. In an empty Python script (for example, the demo script), run the following.

   from citation_map import generate_citation_map
   
   # This is my Google Scholar ID. Replace this with your ID.
   scholar_id = '3rDjnykAAAAJ'
   generate_citation_map(scholar_id)
   

   You can take a look at the input arguments (listed below) of the function generate_citation_map in case you need those functionalities.

   Parameters
   ----
   scholar_id: str
       Your Google Scholar ID.
   output_path: str
       (default is 'citation_map.html')
       The path to the output HTML file.
   num_processes: int
       (default is 16)
       Number of separate processes for parallel processing.
   use_proxy: bool
       (default is False)
       If true, we will use a scholarly proxy.
       It is necessary for some environments to avoid blocks, but it usually makes things slower.
   pin_colorful: bool
       (default is True)
       If true, the location pins will have a variety of colors.
       Otherwise, it will only have one color.
   print_citing_institutions: bool
       (default is True)
       If true, print the list of citing institutions (affiliations of citing authors).
   

Dependencies

Dependencies (scholarly, geopy, folium, tqdm) are already taken care of when you install via pip.

Acknowledgements

This script was written under the assistance of ChatGPT-4o, but of course after intense debugging.