Harmony Videos


Install Harmony R library on Windows 10:

Click here to download an example notebook in R markdown.

  • Launch a web browser and go to the CRAN website.

  • Find the download link for R for Windows.

  • Download the R installer file and open it.

  • Accept all the conditions, choose the installation language, and read the terms and conditions.

  • Click Next and choose your local installation location.

  • Go through all the options and press Next again and again until the installation is complete.

  • Click Finish to exit the installer.

To install the Harmony package:

Open R.

Type the following command:


Select where on your local machine you want to install Harmony.

Also, you can choose a CRAN mirror that is close to your location.

Once the installation is complete, you can import Harmony into your R session:


To harmonize two PDFs:

  • Download the two PDFs that you want to harmonize.
  • Load the two PDFs into R using the load_instruments_from_file() function.
  • Append the two instruments into a list of instruments.
  • Call the match() function to harmonize the two instruments.
  • Export the results to a CSV file.
  • Here is an example of how to harmonize two PDFs in R:

Load the two PDFs

instrument_1 <- load_instruments_from_file("PHQ-9.pdf")
instrument_2 <- load_instruments_from_file("GAD-7.pdf")

Append the two instruments into a list

instruments <- list(instrument_1, instrument_2)

Harmonize the two instruments

matches <- match(instruments)

Export the results to a CSV file

write.csv(matches, "harmonized_instruments.csv")

This will create a CSV file called harmonized_instruments.csv that contains the harmonized instruments.

Introduction to Harmony: Data harmonisation with natural language processing


Harmony is a tool that helps researchers harmonize and compare questionnaires and instruments across social sciences, market research, and political polling. The video shows how to use Harmony to integrate data from different sources.

The video begins by showing how to upload a PDF or Excel file of a questionnaire into Harmony. If the file is a PDF, Harmony will extract the questions from it. If the extraction fails, the user can edit or delete rows.

The video then shows how to select multiple questionnaires to be harmonized. In this example, the user selects the CES-D, SCARED English questionnaire, and GAD-7 Portuguese questionnaire collected in Brazil.

Once the questionnaires have been selected, Harmony will match the questions from each questionnaire to the questions in the other questionnaires. The user can then adjust the match threshold percentage to control how strict or lenient the question match is.

The video concludes by showing how to export the harmonized data from Harmony.

Here are some of the key features of Harmony:

  • It can harmonize questionnaires in PDF or Excel format.
  • It can match questions from different questionnaires based on their meaning, not just their exact wording.
  • It allows the user to adjust the match threshold percentage to control how strict or lenient the question match is.
  • It can export the harmonized data in a variety of formats, including Excel, CSV, and JSON.
  • Harmony is a powerful tool that can help researchers harmonize and compare questionnaires and instruments across different sources. It is easy to use and can be customised to meet the specific needs of the user.

Installing Harmony Python library and getting started with French and English instruments


This video is about how to install and use Harmony, a tool for harmonizing and comparing questionnaires and instruments. The video starts by explaining what Harmony is and how it can be used. Then, the video walks through the steps of installing Harmony, including installing Python, Anaconda, Tika, and Java. Once Harmony is installed, the video shows how to use it to match questionnaires. The video also shows how to download an instrument from a PDF and how to work with a multilingual model.

Here are some of the key points from the video:

  • Harmony is a Python library that can be used to harmonise and compare questionnaires and instruments.
  • Harmony can be used to match questionnaires across different languages.
  • Harmony can be used to extract instrument texts from PDFs.
  • Harmony works with multilingual documents - in fact, it supports over eight languages!

The video is a good introduction to Harmony and how it can be used. The video is clear and easy to follow, and it provides a good overview of the features of Harmony.

Here are some of the specific steps that are shown in the video:

  • Installing Python and Anaconda.
  • Installing Tika and Java.
  • Downloading Harmony.
  • Loading example instruments.
  • Matching questionnaires.
  • Downloading an instrument from a PDF.
  • Working with a multilingual model.

The video also includes some helpful tips, such as how to use the match_instruments_with_function function to use a different matching function such as OpenAI.

This video is a good resource for anyone with some Python programming knowledge, who wants to learn more about Harmony and become an advanced user of the tool. The video is clear, easy to follow, and provides a good overview of the features of Harmony.

How easy is it to harmonise questionnaires?

How to harmonise questionnaire data in psychology using Harmony at harmonydata.ac.uk