Harmony update: new features and bug fixes

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

Harmony update: new features and bug fixes

Harmony update: new features and bug fixes

We are pleased to announce the release of a new update to Harmony, our online platform for harmonising questions. This update includes a number of new features and bug fixes, designed to improve the user experience and make Harmony even more useful for researchers.

New features:

  • Complete reworking of the search functionality: The search functionality in Harmony has been completely rewritten to support Lucene-like queries. This means that you can now use wildcards, logical operators, parentheses, and negation to create precise and complex searches. You can also search by data field (instrument, question, or topic), and select matches by clicking them to build up a list of selected matches from multiple different queries.

  • Three data fields are exposed: instrument, question and topic - allowing queries such as << instrument:RCAD and instrument:GAD >> which will show matches in your results between these two instruments only.

  • Data fields do not need to be specified and by default all are searched.

  • Wildcards, logical operators, parentheses and negation are supported in addition to specifying data fields allowing precise complex searches to be performed. Proximity searches, fuzzy searches and search boosting are not currently supported.

  • Complete cosine similarity matrix: The complete cosine similarity matrix for the model is now provided on a second sheet in every exported Excel file. This can be useful for researchers who want to perform more advanced analyses of their data.

  • Integration to the Catalogue of Mental Health Measures: The integration to the MHC is now shown as a separate card at the top of the results list. This card shows topics for the entire results model, rather than individually for each match.

  • Rating popup: We have added a 5-star rating popup to Harmony. This allows you to rate your experience with the tool and provide feedback to help us improve it.

Bug fixes:

  • A number of minor bugs have been fixed, including:
    • An issue with the export functionality has been fixed.
    • An issue with the search functionality has been fixed.
    • A number of typos have been fixed.

We hope that you enjoy using the new features and bug fixes in Harmony. Please let us know if you have any feedback or questions.

How to try the updated tool:

The update to Harmony is now available to all users. To try it, simply visit

Thank you for using Harmony!

Related Posts

Harmony issue tracker

Harmony issue tracker

Tracking Harmony issues and raising feedback Have you found a problem with Harmony? You can use the links on the Harmony homepage at - you can see there are buttons titled Raise NLP issue and Raise UI issue, which take you to the process for logging issues in Github. The issues remain in the issue trackers and can be assigned to people either under “Assignee” or in the comments:

Developer guide

Developer guide

Git and GitHub workflow The preferred workflow for contributing to Harmony’s repository is to fork the main repository on GitHub, clone, and develop on a new branch. Please read our general guide about contributing to Harmony. Fork the main project repository by clicking on the ‘Fork’ button near the top right of the page. This creates a copy of the code under your GitHub user account. For more details on how to fork a repository see this guide.

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.