A lightweight JavaScript library for embedding charts that visualize bibliometric indicators of scientific papers and researchers. These charts are powered by the BIP! Services platform.
- Include the embed.js or preferably the minified version embed.min.js in your HTML page:
<script src="https://cdn.jsdelivr.net/gh/athenarc/bip-plugin@main/embed.min.js"></script>
- Add elements with the
bip-embedclass:<div class="bip-embed" data-doi="10.1093/nar/gkx1141"></div> <div class="bip-embed" data-doi="10.1038/nature12373"></div>
You can embed multiple paper charts and/or researcher badges on the same page — each will automatically fetch and display data for its respective identifier.
<!DOCTYPE html>
<html>
<head>
<title>Research Impact Visualization</title>
<script src="https://cdn.jsdelivr.net/gh/athenarc/bip-plugin@main/embed.min.js"></script>
</head>
<body>
<h1>Paper Impact Metrics</h1>
<!-- Single chart -->
<div class="bip-embed" data-doi="10.1093/nar/gkx1141"></div>
<!-- Multiple charts -->
<div class="bip-embed" data-doi="10.1038/nature12373"></div>
<div class="bip-embed" data-doi="10.1126/science.1234567"></div>
</body>
</html>To display bibliometric indicators for a researcher, use the bip-scholar-embed class with a data-orcid attribute:
<div class="bip-scholar-embed" data-orcid="0000-0002-1234-5678"></div>This renders a stats badge that shows several indicators pulled from the BIP! API via the researcher's ORCID identifier:
| Metric | Description |
|---|---|
| Publications | Total number of published papers |
| Datasets | Total number of dataset records |
| Software | Total number of software records |
| Other | Total number of other research outputs |
| Citations | Total citation count across works |
| Popular | Number of works classified as Popular (Top 10% or better) |
| Influential | Number of works classified as Influential (Top 10% or better) |
| h-index | The researcher's h-index score |
| Acad. Age | Academic age (years since first publication) |
| Open Access | Percentage of works available as Open Access |
Clicking on the badge redirects to the researcher's full BIP! Scholar profile in a new tab.
If space is limited, you can display a compact version of the badge which hides the text labels and relies only on the indicator icons. Simply add data-layout="compact" to the element:
<div class="bip-scholar-embed" data-orcid="0000-0002-1234-5678" data-layout="compact"></div>By default, if no public BIP! Scholar profile is found for a given ORCID, the widget will display a fallback message ("No BIP! profile found for this ORCID").
If you prefer the widget to completely hide itself when no profile is found (silent mode), you can add the data-empty-mode="silent" attribute:
<div class="bip-scholar-embed" data-orcid="0000-0002-1234-5678" data-empty-mode="silent"></div>Both embed types can be freely mixed on the same page — each operates independently:
<!-- Paper-level doughnut chart -->
<div class="bip-embed" data-doi="10.1093/nar/gkx1141"></div>
<!-- Researcher stats badge -->
<div class="bip-scholar-embed" data-orcid="0000-0002-1234-5678"></div>
<!-- Compact researcher stats badge -->
<div class="bip-scholar-embed" data-orcid="0000-0002-1234-5678" data-layout="compact"></div>The BIP! Services platform offers a range of citation-based impact indicators; a detailed description of the indicators is available here.
For each indicator, the platform classifies research works into five performance tiers:
| Class | Label | Color | Description | Percentage |
|---|---|---|---|---|
| C1 | Top 0.01% | #00441b |
Exceptional impact | Top 0.01% of research works |
| C2 | Top 0.1% | #1b7837 |
Very high impact | Top 0.1% of research works |
| C3 | Top 1% | #4daf4a |
High impact | Top 1% of research works |
| C4 | Top 10% | #a6d96a |
Above average | Top 10% of research works |
| C5 | Average | #808080 |
Average impact | Remaining 90% |
- C1-C4: Filled segments with green gradient (darker = higher impact)
- C5: Unfilled arc with grey text (represents average performance)
Chart not displaying:
- Check that the DOI or ORCID is valid and accessible
- Verify internet connection (API calls required)
- Check browser console for JavaScript errors
Styling issues:
- Ensure no CSS conflicts with existing styles
- Check that Google Fonts (Nunito) is loading properly
API errors:
- Verify the DOI/ORCID exists in the BIP database
- Check API endpoint availability
- Some DOIs may not have complete data
Enable console logging by opening browser developer tools to see detailed information about data fetching and chart rendering.
This project is open source. Please check the BIP! platform terms of use for further guidelines.
Contributions are welcome! Please feel free to submit issues, feature requests, or pull requests.
For technical support or questions about the BIP platform:
- BIP! Services Support: bip@athenarc.gr
- BIP! Services Website: https://bip.imsi.athenarc.gr