Guide to Activity Tab
The activity tab shows installation and maintenance statistics for a particular plugin, including:
- How many times the plugin has been installed since it was released
- How many times the plugin has been installed in the past 30 days
- Installs of the plugin in the past year are graphed
- How many commits since released, since created, time of last commit, and number of monthly commits in the past year
We aim to represent plugin installations from plugin users, excluding those done by plugin developers or for non-user purposes, but there are many caveats. For example, since the installation data we utilize is anonymous, we may show multiple installs from a single user.
We use the Linehaul project to gather install data, which is the same tool used by PyPI. Linehaul shows all installs, including developer installs used for troubleshooting or building the package. The developer installs can fall into multiple buckets including continuous integration (CI), mirror installs, and release candidate installs. PyPI shows all installs. You can view install data from PyPI at pypistats.org.
We select for installs made by plugin users and exclude as many developer installs as possible. We clean the install data from Linehaul by excluding CI installs such as those from AWS (Amazon Web Services), mirror installs, and release candidate installs. Our data may not match pypi stats due to this data exclusion. (e.g. napari-allencell-segmenter on the hub vs napari-allencell-segmenter on pypi).
-
We show the past 12 completed months from the previous month to the current month. So if it’s January 2023, we show February 2022 through January 2023 as in this example:
-
The dashed line indicating “Public release” aligns with the month it was publicly released, as shown in this example:
-
The data for the first month of the plugin’s public existence may not be for a complete month if the plugin was released at any date after the first of the month. We still show what data we had for that month in aggregate once that month is complete and we are in the next month. In this example, the plugin was released more than one month ago but not two months ago. It shows 1 install in the past 30 days, which may not be all the installs for the current month.
-
Graphs are not displayed if a plugin was released in the current month.
- If a plugin was publicly released < 7 days ago, we say “less than a week ago”.
- If a plugin was publicly released >= 7 days, but < 14 days prior, we say "a week ago".
- If a plugin was publicly released >= 14 days, but < 30 days prior, we say "n weeks ago". e.g., “3 weeks ago”
- If a plugin was publicly released >= 30 days, but < 24 months prior, we say "n months ago". e.g., “7 months ago” or “19 months ago”
- If a plugin was publicly released > 24 months prior, we say "n years ago". e.g., "2 years ago" or “6 years ago”
If a plugin is on GitHub, the following maintenance statistics are shown:
- Commits since released
- Commits since plugin repo was created
- Time of the latest commit
- Monthly commits in past year are graphed
Here is an example:
The statistics for plugins on GitHub are gathered using the GitHub API. For more information on GitHub statistics, refer to Repository statistics. Note that the graph refers to statistics from the date the repository was created. The statistics may be inaccurate if a repository is renamed or if it is transferred from one user account to another.
We do not track statistics for plugins on other platforms.
There is also a new tab that gives information on citations. To see the prototype, look here. We strongly recommend that you cite the plugin (and napari) in any published information that you produce.
The source of this data is Open Alex (https://openalex.org/). We gather a list of DOIs (Digital Object Identifiers) for the canonical or standard, authoritative works in the fields of microbiology, neuroscience, cell science, biology, and others. These are translated to OpenAlex ids. Those OpenAlex ids are used to retrieve the publications. We search for the last 5 papers that cited a plugin, then the 5 most cited papers among those that cite ours. So we are looking at the papers that cited our plugins and then find out how many times those papers are cited. We retrieve the data for the 5 papers that cited us the most. **Here is a discussion of the various parts of that tab. **
Please note that different formats for the citation are available, including: APA, BibTex, and RIS. The heading or title section of the tab contains the name of the plugin and a brief overview, as shown below:
The next section, How this plugin has been cited, has three sub-sections: Top citations, Most recent citations, and Top fields citing this plugin. The Top citations section looks like this:
This information comes from ...
Most recent citations looks like this:
Notice that there is a link to all the citations at the bottom of this section.
This information comes from ....
Top fields citing this plugin looks like this:
This information comes from ....