------------------------------------------------------------------------
Prosperity Sphere: Who cites your paper?
------------------------------------------------------------------------

Would you like to know who cites your papers? If so, read on.

You need to execute four steps
------------------------------------------------------------------------
Ia. Make a list of your papers and export the list of "BibCodes"
------------------------------------------------------------------------

1. In ADS make a list of of your papers. 
2. "Export" the papers choosing "Other Formats" and within that
  set "Custom Format" set to "%R"
3. Save the file, as say,
	Author_BC.txt 
  where BC stands for bibcode

------------------------------------------------------------------------
Ib. Get a personal RSA code from ADS 
------------------------------------------------------------------------

1. Create an ADS account, in case one does not exist.

2. Visiting the URL below will create a token 
	https://ui.adsabs.harvard.edu/user/settings/token

3. Copy the 40-character the ADS RSA token and save it in file "ADS_Token".

------------------------------------------------------------------------
Ic. Check RSA token is valid
------------------------------------------------------------------------

Please note you are allowed only 5,000 inquiries per day. So, execute this
line to both your RSA token and  see how many inquires you have left.

$ ./InquiriesLeft


------------------------------------------------------------------------

II. Make a list of BibCodes of the papers that cite your papers 
------------------------------------------------------------------------
$ bc2cites Author_BC.txt 

The utility reads each line (BibCode of your first paper) and
generates the BibCodes of the citations to that paper. It then outputs
cites_BC001.txt. Read the next line and repeate.  So the output is 

	cites_BC001.txt 
	cites_BC002.txt 
        ...
Review those files.

------------------------------------------------------------------------
IIb. Restrictions
------------------------------------------------------------------------
As noteda above, you are allowed only 5,000 inquiries per day. For this reason
the utilities are built to work on a paper at a time. For instance, in
the previous step, the starting index (BC001) can be set to a desired value.

$ bc2cites Author_BC.txt 10

would produce cites_BC010.txt, cites_BC011.txt and so on.


------------------------------------------------------------------------
III. Produce author list for each bibcode 
------------------------------------------------------------------------
Produce list of authors for each cites_BCnnn.txt file.

$ ./cites2authors cites_BC*.txt

For each ``cites_BCnnn.txt" the utility produces the corresponding
``Author_cites_BCnnn.txt" in which the authors of all the BibCodes
in the input files are listed.

Bearing the daily allocation of inquiries, you may wish to stage
this step incrementally. For instance,

$ ./cite2authors cites_BC01{0..9}.txt 

will process files BC010 through BC010.


------------------------------------------------------------------------
IV. Histogram the authors
------------------------------------------------------------------------