Awesome

<a href="https://harmonydata.ac.uk"><span align="left">🌐 harmonydata.ac.uk</span></a> <a href="https://www.linkedin.com/company/harmonydata"><img align="left" src="https://raw.githubusercontent.com//harmonydata/.github/main/profile/linkedin.svg" alt="Harmony | LinkedIn" width="21px"/></a> <a href="https://twitter.com/harmony_data"><img align="left" src="https://raw.githubusercontent.com//harmonydata/.github/main/profile/x.svg" alt="Harmony | X" width="21px"/></a> <a href="https://www.instagram.com/harmonydata/"><img align="left" src="https://raw.githubusercontent.com//harmonydata/.github/main/profile/instagram.svg" alt="Harmony | Instagram" width="21px"/></a> <a href="https://www.facebook.com/people/Harmony-Project/100086772661697/"><img align="left" src="https://raw.githubusercontent.com//harmonydata/.github/main/profile/fb.svg" alt="Harmony | Facebook" width="21px"/></a> <a href="https://www.youtube.com/channel/UCraLlfBr0jXwap41oQ763OQ"><img align="left" src="https://raw.githubusercontent.com//harmonydata/.github/main/profile/yt.svg" alt="Harmony | YouTube" width="21px"/></a>

Harmony example scripts

Harmony is a tool using AI which allows you to compare items from questionnaires and identify similar content. You can try Harmony at https://harmonydata.ac.uk/app and you can read our blog at https://harmonydata.ac.uk/blog/.

Here you can find example scripts for using the Python and R libraries.

R examples

Walkthrough R notebook in R Studio: <a href="https://harmonydata.ac.uk/harmony_r_example.nb.html" target="_parent"><img src="https://img.shields.io/badge/RStudio-4285F4" alt="Open In R Studio"/></a>
Walkthrough R notebook in Google Colab: <a href="https://colab.research.google.com/github/harmonydata/experiments/blob/main/Harmony_R_example.ipynb" target="_parent"><img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open In Colab"/></a> View the PDF documentation of the R package on CRAN
R Markdown to Check for Correspondence between Differently Worded Versions of the Same Scale Item <a target="new" href="https://github.com/harmonydata/harmony_examples/blob/main/R%20Markdown%20to%20Check%20for%20Correspondence%20between%20Differently%20Worded%20Versions%20of%20the%20Same%20Scale%20Item.Rmd" target="_parent">View on Github</a> - credit to Deanna Varley
R Script to Check for Matches between Items from Different Scales <a target="new" href="https://github.com/harmonydata/harmony_examples/blob/main/R%20Script%20to%20Check%20for%20Matches%20between%20Items%20from%20Different%20Scales.R" target="_parent">View on Github</a> - credit to Deanna Varley

Python examples

Walkthrough Python notebook in Google Colab with a single click: <a href="https://colab.research.google.com/github/harmonydata/harmony/blob/main/Harmony_example_walkthrough.ipynb" target="_parent"><img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open In Colab"/></a>
Example script to create a crosswalk table on real survey data
Example script to strip prefixes from questions

🖱 Looking to try Harmony in the browser?

Visit: https://harmonydata.ac.uk/app/

Looking for Harmony source code?

Harmony is based on four repositories: the core Python library, the API, the R port, and the front end for running in the browser. We welcome contributions and you can raise issues, pick up issues, and make pull requests.

Python - the main core library and the Python package which is on Pypi
R - the R port is on CRAN and it is slightly less mature than Python so we really appreciate if you can give the R package some TLC.
API - the Python API runs with Pydantic and Fast API and is running on an on-prem server enabling the web app to work
Web front end - we welcome feedback and contributions on front end and UX issues
If you're doing research and found Harmony useful, please cite us!
If you're a researcher trying to use the tool, and you encounter a problem, a bug, or a feature which you would like us to implement, please raise an issue on Github or message us on Discord.

Read our guide to contributing to Harmony here or read CONTRIBUTING.md.

🖥 Installation instructions for Python library (video)

Who to contact?

You can contact Harmony team at https://harmonydata.ac.uk/, or Thomas Wood at https://fastdatascience.com/.

‎😃💁 Who worked on Harmony?

Harmony is a collaboration project between Ulster University, University College London, the Universidade Federal de Santa Maria, and Fast Data Science. Harmony has been funded by Wellcome as part of the Wellcome Data Prize in Mental Health and by Economic and Social Research Council (ESRC).

The core team at Harmony is made up of:

Dr Bettina Moltrecht, PhD (UCL)
Dr Eoin McElroy (University of Ulster)
Dr George Ploubidis (UCL)
Dr Mauricio Scopel Hoffmann (Universidade Federal de Santa Maria, Brazil)
Thomas Wood (Fast Data Science)

📜 License

📜 How do I cite Harmony?

You can cite our validation paper:

McElroy, Wood, Bond, Mulvenna, Shevlin, Ploubidis, Scopel Hoffmann, Moltrecht, Using natural language processing to facilitate the harmonisation of mental health questionnaires: a validation study using real-world data. BMC Psychiatry 24, 530 (2024), https://doi.org/10.1186/s12888-024-05954-2

A BibTeX entry for LaTeX users is

@article{mcelroy2024using,
  title={Using natural language processing to facilitate the harmonisation of mental health questionnaires: a validation study using real-world data},
  author={McElroy, Eoin and Wood, Thomas and Bond, Raymond and Mulvenna, Maurice and Shevlin, Mark and Ploubidis, George B and Hoffmann, Mauricio Scopel and Moltrecht, Bettina},
  journal={BMC psychiatry},
  volume={24},
  number={1},
  pages={530},
  year={2024},
  publisher={Springer}
}