Harmony Videos


Harmony orientation session 19 Feb 2024

Interested in contributing to an open source project involving psychology and natural language processing? Whether you’re new to Harmony or looking to dive deeper into our projects, this event is for you.

  • Introduction to Harmony
  • Overview of Current Projects
  • How to Get Involved

Key points from the video

  • Harmony is free to use under the MIT license and aims to build a community of developers for further development.

  • The tool parses questionnaire items from PDFs and allows psychologists to export the data as Excel.

  • Key areas needing help:

  • Ways to contribute:

    • Fork the code on GitHub (3 repositories: library, API, front-end).
    • Add a new feature (e.g., GPT support).
    • Create a pull request with unit tests.
    • Discuss ideas on Discord.
  • Resources:

  • The video includes a demonstration of the tool and the contribution process.

  • The team welcomes any ideas and contributions from the community.

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

Signup to our newsletter

The latest news on data harmonisation project.

Please select all the ways you would like to hear from Harmony project:

You can unsubscribe at any time by clicking the link in the footer of our emails. For information about our privacy practices, please visit our website. We use Mailchimp as our marketing platform. By clicking below to subscribe, you acknowledge that your information will be transferred to Mailchimp for processing. Learn more about Mailchimp's privacy practices.