TITLE: IRIS Software Protocol
AUTHORS: Leonardo Zilli, Erica Andreose, Salvatore Di Marzo

[DESCRIPTION]
This project aims to investigates the discoverability of University of Bologna's scholarly output within OpenCitations Meta, a platform that stores and delivers bibliographic metadata for alle the publications involved in OpenCitations Index which contains recording citations allowing the user to visualize all of the citation links between a document and another. Specifically, this project aims to analyze the coverage of University of Bologna's publications within the OpenCitations Meta, particularly those deposited in the IRIS institutional repository. Various publication types are observed to discern patterns in representation. Utilizing OpenCitations data, the citation impact of these IRIS publications is quantified, encompassing both the citations they receive and those they provide. Additionally, the study delves into the nature of citations, distinguishing between those involving publications within IRIS and those referencing external sources. The study unveils the citation impact of IRIS publications, clarifying their influence within the scholarly community. By dissecting citations, the research also delineates the interplay between internal and external citations, providing a deeper understanding of the institution's scholarly ecosystem. The methodology used will be all compliant to the core values of Open Science, the data and the software used will all be made available to allow the user to replicate, reproduce and validate the conclusions drawn by the end results of the project, that will hold significance for researchers and academic institutions, facilitating informed decision-making and fostering a deeper understanding of scholarly communication dynamics.

[BEFORE_START]
Before starting, we suggest to make sure you have Python3.x installed on your computer, in addition, in order to correctly execute the provided scripts, you must install the required libraries:
requirements.txt
- pandas

[GUIDELINES]
To let the user with complete reproducibility of the protocol, links to the data used are provided here.
Download link for the UNIBO IRIS bibliographic data dump, dated 14 March 2024: https://amsacta.unibo.it/id/eprint/7608/
OpenCitations Meta can be accessed and queried through a REST API: https://w3id.org/oc/meta/api/v1 

[STEPS]
SECTION: IRIS Dataset Preparation
1. 
 
After downloading the IRIS dataset, the contents appear divided into 7 different csv files, descriptive as the following:
- "ODS_L1_IR_ITEM_CON_PERSON.csv": information about the people involved in the publications (authors, editors, etc.)
- "ODS_L1_IR_ITEM_DESCRIPTION.csv": the string of the authors and other related metadata of publications
- "ODS_L1_IR_ITEM_IDENTIFIER.csv": the identifiers (including DOIs) of publications
- "ODS_L1_IR_ITEM_LANGUAGE.csv": the language in which the publication has been written (when applicable)
- "ODS_L1_IR_ITEM_MASTER_ALL.csv": basic metadata information of publications (title and date of publication) 
- "ODS_L1_IR_ITEM_PUBLISHER.csv": the publishers of publications
- "ODS_L1_IR_ITEM_RELATION.csv": additional metadata related to the context of publications (publication venue, editors, etc.)

These files are connected among themselves with a unique item ID tied to each entry, after we gathered the files we converted them into dataframes with Python Pandas.

 

(https://pandas.pydata.org/)
SECTION: OpenCitations Meta Dataset Querying
4. 
 
The OpenCitations Meta Sparql endpoint allowed us after querying it, to download a csv file of the results of our queries which we then transformed into dataframes.

These are the queries that gave as a result the files:

 


 


 

SECTION: Data Visualization
7. The visualizations of the results obtained are computed with the _ _ library.


 


 


 


 



 





SECTION: Research Question answering
6. We answer the questions:
SECTION: Research Question answering
6.1. What is the coverage of the publications available in IRIS (strictly concerning research conducted within the University of Bologna) in OpenCitations Meta?

 

SECTION: Research Question answering
6.2. Which are the types of publications that are better covered in OpenCitations Meta?


 

SECTION: Research Question answering
6.3. What is the amount of citations (according to OpenCitations Index) coming from the IRIS publications that are involved in OpenCitations Meta (as citing entity and as cited entity)?

 

SECTION: Research Question answering
6.4. How many of these citations come from and go to publications that are not included in IRIS?

 

SECTION: Research Question answering
6.5. How many of these citations involve publications in IRIS as both citing and cited entities?

 

SECTION: OpenCitations Index Dataset Querying
5. 
 
The OpenCitations Index Sparql endpoint allowed us after querying it, to download a csv file of the results of our queries which we then transformed into dataframes.

These are the queries that gave as a result the files:


 

 

 

SECTION: OpenCitations Meta Dataset Querying
4.1. We then use these csv files to create the pandas DataFrames that will be used to perform the analyses.

 

SECTION: OpenCitations Index Dataset Querying
5.1. We then use these csv files to create the pandas DataFrames that will be used to perform the analyses.

 

SECTION: IRIS Dataset Preparation
2. The csv files are converted into Dataframes 
 

SECTION: IRIS Dataset Preparation
3. The DataFrames are grouped into one mashup dataframe through the item_ID, to see the various connections and data that the files could offer for the same entry.