UtrechtUniversity / SWORDS-UU

Implementation of the SWORDS framework for Utrecht University.
MIT License
8 stars 6 forks source link
fair open-science research-software swords utrecht-university

SWORDS@UU

banner

This repository implements for the Scan and revieW of Open Research Data and Software (SWORDS) framework. SWORDS is a powerful tool to gain insights in the open source activities of your, but not limited to, university or research institute. Studies show that open source contributions can be very benificial for organisations and society. SWORDS is divided into 3 stages that can be exectued and analyzed standalone: finding user profiles associated to your organisation, extract relevant repositories, and study the contents of the respositories.

This repository is an implementation of SWORDS for Utrecht University.

SWORDS@UU

Background

Conducting science in an open and collaborative way is very important for greater scientific and societal impact (https://www.nwo.nl/en/open-science). The Open Science movement is therefore actively promoting and advancing openness in academic publications, data, software, and other types of output. Major steps have been taken in the last years, however, there is still a lot to improve and win. A result of this movement towards more open research output is the increase of code and software published by researchers on online platforms. The use and reuse of open source (research) software and code is widespread nowadays.

For (research) organisations, it can be interesting to have insights into the contributions and activities in open source software projects. Especially because activities of members, researchers, or employees can be divided over multiple user profiles and platforms (e.g. GitHub and GitLab). Having an overview of the activity, contents, and quality can be useful for various reasons like connecting initiatives, improve quality, and reward and recognize contributions. The SWORDS framework was introduced to help with collecting insights and assessing quality.

The SWORDS framework

The SWORDS framework consists of three mostly-independent steps. Each step is described below and detailed information and instructions can be found in the links.

  1. Find user profiles associated to organisation. In this first step of the framework, multiple strategies are available to find users on GitHub and GitLab that are members or employees of your organisation. By using multiple collection strategies, the recall is considered to be high. The findability of members or employees is one of the output variables of this step. A structured list of users is used as input for the next step.
  2. Collect relevant repositories. In the second step, the repositories of the users collected in the previous step are collected and filtered. Not all repositories are research output. These repositories are filted out automatically and/or manually.
  3. Study and analyze repositories. In this step, further variables of research repositories are gathered. These are then examined and studied on various quantitiative and qualitative properties. One can think about quality assesments, documentation availablity, FAIRness scores.

The SWORDS framework is written in Python 3.6+. The SWORDS framework implements the reproducible project structure as proposed by Wilson et al. (2017) for each step of the framework. For more information about the phases, please look into the corresponding subfolders for further information on installation and usage. All output data is stored in output folders. There is also a corresponding interactive data analysis jupyter notebook file in each step. This notebook can be used for results.

Results

The results of the three steps of the SWORDS framework can be found in each of the subfolders of the project. Each step contains a Jupyter notebook with results, code, and narrative. Output data files can be found in the output folder in each step.

Results of step 1: Find user profiles associated to organisation

Results of step 2: Collect relevant repositories

Results of step 3: Study and analyze repositories

Dashboard

A Kibana dashboard has been implemented to work with the data in addition to the Jupyter notebooks. The exported dashboard can be found in the subfolder kibana_dashboard/data-dashboard.ndjson. In order to run the dashboard on your local machine, first install ElasticSearch and Kibana as stated on the Elastic website. To import the data and dashboard, follow the documentation. Alternatively, there is an easier method of importing in version 7.16:

  1. Open the hamburger menu
  2. Scroll down to Management --> click Stack management
  3. Under Kibana, click on Saved Objects
  4. Click on the import button and select the file data-dashboard.ndjson.

After following their documentation or these steps, the dashboard with the related data in the indices repos and users should be loaded.

Usage

In the normal use case, you start with phase 1 and go through each phase as the output of phase 1 can be used for phase 2. However, if you already have collected a list of users for example, you can skip phase 1 and use that collected list as input for phase 2. Since the phases are independent of each other, this approach is possible. For details on how to execute each phase, look into the corresponding subfolder.

Citation

Use this citation for citing the SWORDS implementation of Utrecht University.

@software{de_Bruin_Scan_and_revieW_2021,
author = {de Bruin, Jonathan and Quach, Keven and Slewe, Christopher and Lamprecht, Anna-Lena},
month = {9},
title = {{Scan and revieW of Open Research Data and Software at Utrecht University}},
url = {https://github.com/UtrechtUniversity/SWORDS-UU},
version = {1.0.0},
year = {2021}
}

To cite the SWORDS project and the SWORDS template, use

@software{de_Bruin_Scan_and_revieW_2022,
author = {de Bruin, Jonathan and Quach, Keven and Slewe, Christopher and Lamprecht, Anna-Lena},
month = {2},
title = {{Template of Scan and revieW of Open Research Data and Software}},
url = {https://github.com/UtrechtUniversity/SWORDS-template},
version = {1.0.0},
year = {2022}
}

License

The SWORDS project template is published under the MIT License.

Icons of the banner are made by Freepik from www.flaticon.com.

Contact

For contact about this implementation of the SWORDS project, SWORDS@UU, post an issue on the issue tracker or contact Jonathan de Bruin or Keven Quach.

For general questions and remarks about the SWORDS project and the template can be posted on the issue tracker of the SWORDS template. You can also contact either Jonathan de Bruin or Keven Quach.

The SWORDS project is an idea of the FAIR Data and Software working group of the Utrecht University Open Science Programme.