HEPdata info and instructions

Basic information/Introduction

Nowadays it is more and more important to have our published data readily available for the outside world. The "industry-wide" format for that is HEPData, hence STAR management has decided to give "shift-like" credit for uploading papers to HEPData. On this webpage we describe the details of this coordinated effort of STAR to have all our public data available on HEPData.

• Papers before GPC #250 should be uploaded by "shifters". At least ~20 figures (numbered figures from the paper that have data in the data.html file on drupal; i.e. one figure with many subfigures or many actual table columns is still counted as one figure for this purpose) are worth one shift credit (i.e. equivalent of doing a data taking shift of ~56 hours), that could be for example 2 medium sized PRC papers, 1 very long PRC paper, or a few PRL papers, or a combination of these. No fractional credit is given, and papers shall be finished by one shifter; so shifters should try to select papers with 20 figures altogether, or maybe slightly more.
• Sign up for HEPData shifts is possible at
  docs.google.com/spreadsheets/d/1-3YLUyIKGDwxwvcve2LQSkUPyTRqA5o8j9B5TCxUodw/edit
  and shifters are expected to finish uploading paper data within the given week indicated in the signup table; review shall also happen within that week.
• People interested in signing up for HEPData shifts should consult both the signup sheet and the
  www.star.bnl.gov/protected/common/GPCs/gpc-committees.xml
  table to see which papers are available (and also check below which papers are in progress, i.e. "taken" already).
• A merged list is also linked here:
  docs.google.com/spreadsheets/d/1-3YLUyIKGDwxwvcve2LQSkUPyTRqA5o8j9B5TCxUodw/edit#gid=967716397
  where papers are marked "selected" or "done" (and some other markings are also possible); please only select papers where no such comment is given in the "HEPdata status" column.
• A reviewer should also be named, it could be someone from the shifter's group, e.g. the team leader/supervisor/experienced colleague. The main task for the reviewer is to check if the upload was done correctly, no major mistakes were made, or mistakes of the original data upload (such as typos) are corrected.
• Shifters should contact Mate Csanad (minimally a few days before their shift) to discuss and settle which papers will be done in the given shift. This decision has to be made before the week of the shift, so that actual work can start and finish during the shift week.
• Papers with the most citations (see list linked in the "Resources" section) should be chosen first, since these are most likely to be needed by the community, but other than that, people are free to choose.
• To start the uploads, the name and email (the one used at hepdata.net) of both the uploader and the reviewer is needed.
• After review is done, a notification should be sent to Frank Geurts and Mate Csanad, so that final approval and publication of the HEPdata record can be done. After this is done, shifters are kindly asked to send the public HEPdata link for each completed paper (with GPC number) so that this can be recorded in the paper list.
• Credit will be given once the upload is done and approved; a final email to Mate Csanad with the public HEPdata link(s) and corresponding GPC number(s) is needed to mark the shift as done.
• Credits will be counted at the end of the given data taking period.
• Shifts finished before Nov 13 count towards Run 20, later ones will count towards Run 21, if finished before the end of Run 21. Institutional credit is added to the database at that point.

Useful links are given below, and of course feel free to ask on the Mattermost channel or in email.

Requirements for data uploads

• Check other submissions, e.g. a great example is www.hepdata.net/record/ins1771348
• All data tables given on the STAR publication webpage (data.html file) should be uploaded, with proper descriptions.
• Double check if any mistake has been made on the publication webpage, e.g. comparing to the publication. Clear mistakes should be corrected, otherwise the data.html file should be followed (as the official public data record of the given paper).
• Make sure the plot is understandable in HEPData, i.e. energy, collision system, particle type etc. are given in the appropriate labels or tags.
• Follow the PDG rules for significant digits, also summarized here: drupal.star.bnl.gov/STAR/pwg/common/policies/significant-digits-hepdata-table
• Please also add link to public STAR data webpage as well as an arXiv link:
  
  • {description: Webpage with all figures, location: 'https://drupal.star.bnl.gov/STAR/publications/...'} (adding this one will provide some additional pointers to the page on which we summarize arXiv, journal, as well as individual pictures)
  • {description: arXiv, location: 'http://arxiv.org/abs/arXiv:...'}
• An “Image file” and a “Thumbnail image file” shoud be given for all figures. Those fields really give a nice connection to the relevant figure from the paper. (To be obtained from STAR’s png plots are on the paper website or directly cropped from the paper.) In the submission.yaml file you can add these through these lines:
  

  --
      additional_resources:
      - {description: Image file, location: Fig2.png}
      - {description: Thumbnail image file, location: thumb_Fig2.png}
      Data_file: figure_2.yaml
  

  And here is a simple unix command to create thumbnails from all the image files downloaded from the publication webpage:
  

  convert "*.png[200x]" -set filename:base "%[basename]" "thumb_%[filename:base].png"

• The review and sign-off should be done by the appointed reviewer.
• Once everything is in place, send public HEPData link (the one with 'ins' in it), arXiv/INSPIRE link and STAR data website for final approval.

Resources

• Local STAR data
• STAR data available on HEPdata.net
• INSPIRE list of STAR publications ordered by the number of citations (to help in chosing papers for uploading)
• Submission process in a nutshell
  • a brief introduction (Frank's slides at 2020 collaboration meeting)
  • a lot more information from its creators
• A useful YAML maker
• HEPData YAML validator (useful to use before submission)
• Another simple validator
• HEPdata sandbox for checking uploads
• A set of useful slides compiled by Nandita
• Local STAR support (Mattermost)

Dashboard

(last update: May 2020)
(Full list available at: docs.google.com/spreadsheets/d/1-3YLUyIKGDwxwvcve2LQSkUPyTRqA5o8j9B5TCxUodw/edit#gid=967716397)

HEPdata Submission Dashboard

GPC ID	title	date	submitter	reviewer	status
16	Centrality Dependence of High $p_T$ Hadron Suppression in Au + Au Collisions at $\sqrt{s_{NN}}$ = 130 GeV	August 2020	Christal Martin (UTK)	Frank Geurts	588808
17	Disappearance of back-to-back high pT hadron correlations in central Au+Au collisions at sqrt(sNN)=200GeV	Feb.24, 2020	Junlin Wu (IMP)	Frank Geurts
56	Azimuthal anisotropy in Au+Au collisions at s(NN)**(1/2) = 200-GeV	Feb.16, 2020	Mate Csanad (Eotvos)	Frank Geurts
126	Identified particle production, azimuthal anisotropy, and interferometry measurements in Au+Au collisions at s(NN)**(1/2) = 9.2- GeV	Feb.16, 2020	Mate Csanad (Eotvos)	Frank Geurts	831944
154	Di-electron spectrum at mid-rapidity in $p+p$ collisions at $\sqrt{s} = 200$ GeV	September 2020	?	Frank Geurts	in progress
176	Strangeness Enhancement in Cu+Cu and Au+Au \sqrt{s_{NN}} = 200 GeV Collisions	August 2020	Christal Martin (UTK)	Frank Geurts	918779
183	Systematic measurements of dielectron production in 200 GeV Au+Au collisions at the STAR experiment	August 2020	Jaanita Mehrani (Rice)	Frank Geurts	1275614
207	Bulk Properties of the Medium Produced in Relativistic Heavy-Ion Collisions from the Beam Energy Scan Program	Feb.23,2017	Malena Fassnacht/Nick Coupey (Rice)	Frank Geurts	1510593
224	Measurement of D0 azimuthal anisotropy at mid-rapidity in Au+Au collisions at sqrt(SNN)=200GeV	April 26, 2017	Xin Dong	Bedanga Mohanty
227	Measurements of Dielectron Production in Au+Au Collisions at sqrt(sNN)= 27, 39, and 62.4 GeV from the STAR Experiment	September 2020	Yiding Han (Rice)	Frank Geurts	in progress
230	Beam Energy Dependence of Jet-Quenching Effects in Au+Au Collisions at	Sept.11, 2018	Jaanita Mehrani (Rice)	Frank Geurts	1609067
233	Beam-Energy Dependence of Directed Flow of Lambda, anti-Lambda, K+/-, Short, and phi in Au+Au collisions	August 30, 2017	Prashanth Shanmuganathan	Zhenyu Ye
237	Strange hadron production in Au+Au collisions at sort(sNN)=7.7, 11.5, 19.6, 27, and 39GeV	April 30, 2020	Xianglei Zhu	Rongrong Ma	1378002
247	J/Psi production cross section and its dependence on charged-particle multiplicity in p+p collisions at sqrt(s)=200GeV	Sept. 21, 2018	Zhenyu Ye	Jaro Bielcik	1672453
249	Low pT e+e- pair production in Au+Au collisions at sqrt(sNN)=200GeV and U+U collisions at sort(sNN)=193GeV	Sept.10, 2018	Jaanita Mehrani (Rice)	Frank Geurts	1676541
253	Centrality and transverse momentum dependence of D0-meson production at mid-rapidity in Au+Au collisions at sqrt(sNN) = 200 GeV	August 2020	Christal Martin (UTK)	Frank Geurts	in progress
262	Observation of excess J/Psi yield at very low transverse momenta in Au+AU collisions at sqrt(sNN)=200GeV and U+U collisions at sqrt(sNN)=193GeV	Sept. 6, 2019	Wangmei Zha	Jaro Bielcik
274	Measurement of Groomed Jet Substructure Observables in pp Collisions at sqrt(s)=200GeV with STAR	March 19, 2020	Raghav Kunnawalkam Elayavalli	Rongrong Ma	1783875
277	Probing Extreme Electromagnetic Fields with the Breit-Wheeler Process	Feb. 12, 2020	Daniel Brandenburg	Frank Geurts
281	Observation of enhancement of charmed baryon-to-meson ratio in Au+Au collisions at sqrt(sNN)=200GeV	April 17, 2020	Sooraj Radhakrishnan	Wei Xie	1762441
290	Measurement of the central exclusive production of charged particle pairs in proton-proton collisions at sort(s)=200GeV with the STAR detector at RHIC	April 287, 2020	Rafal Sikora	Xin Dong	1792394
GPC ID	title	date	submitter	reviewer	status/inspireid (when completed)
GPC ID	title	date	submitter	reviewer	status/inspireid (when completed)
GPC ID	title	date	submitter	reviewer	status/inspireid (when completed)
GPC ID	title	date	submitter	reviewer	status/inspireid (when completed)
GPC ID	title	date	submitter	reviewer	status/inspireid (when completed)
GPC ID	title	date	submitter	reviewer	status/inspireid (when completed)