DOI: 10.6084/m9.figshare.7654637.v3
title: Analysis scripts and supplementary files: Barriers to implementing clinical trials on non-pharmacological treatments in developing countries – lessons learnt from addressing pain in HIV

description: <b>DESCRIPTION</b>This repository contains analysis scripts (with outputs), figures from the manuscript, and supplementary files the HIV Pain (HIP) Intervention Study. All analysis scripts (and their outputs -- <i>/outputs</i> subdirectory) are found in <i>HIP-study.zip</i>, while PDF copies of the analysis outputs that are cited in the manuscript as supplementary material are found in the relevant <i>supplement-*.pdf</i> file<i>.</i><b>Note: </b>Participant consent did not provide for the publication of their data, and hence neither the original nor cleaned data have been made available. However, we do not wish to bar access to the data unnecessarily and we will judge requests to access the data on a case-by-case basis. Examples of potential use cases include independent assessments of our analyses, and secondary data analyses. Please contact Peter Kamerman (peter.kamerman@gmail.com), Dr Tory Madden (torymadden@gmail.com, or open an issue on the GitHub repo (https://github.com/kamermanpr/HIP-study/issues).<b><br></b><b>BIBLIOGRAPHIC INFORMATION</b><b>Repository citation</b>Kamerman PR, Madden VJ, Parker R, Devan D, Cameron S, Jackson K, Reardon C, Wadley A. Analysis scripts and supplementary files: Barriers to implementing clinical trials on non-pharmacological treatments in developing countries – lessons learnt from addressing pain in HIV. DOI: 10.6084/m9.figshare.7654637.<b><br></b><b>Manuscript citation</b>Parker R, Madden VJ, Devan D, Cameron S, Jackson K, Kamerman P, Reardon C, Wadley A. Barriers to implementing clinical trials on non-pharmacological treatments in developing countries – lessons learnt from addressing pain in HIV. <i>Pain Reports </i>[submitted 2019-01-31]<br><br><b>Manuscript abstract</b><b>introduction:</b> Pain affects over half of people living with HIV/AIDS (LWHA) and pharmacological treatment has limited efficacy. Preliminary evidence supports non-pharmacological interventions. We previously piloted a multimodal intervention in amaXhosa women LWHA and chronic pain in South Africa with improvements seen in all outcomes, in both intervention and control groups. <b>Methods:</b> A multicentre, single-blind randomised controlled trial with 160 participants recruited was conducted to determine whether the multimodal peer-led intervention reduced pain in different populations of both male and female South Africans LWHA. Participants were followed up at Weeks 4, 8, 12, 24 and 48 to evaluate effects on the primary outcome of pain, and on depression, self-efficacy and health-related quality of life. <b>Results:</b> We were unable to assess the efficacy of the intervention due to a 58% loss to follow up (LTFU). Secondary analysis of the LTFU found that sociocultural factors were not predictive of LTFU. Depression, however, did associate with LTFU, with greater severity of depressive symptoms predicting LTFU at week 8 (p=0.01). <b>Discussion:</b> We were unable to evaluate the effectiveness of the intervention due to the high LTFU and the risk of retention bias. The different sociocultural context in South Africa may warrant a different approach to interventions for pain in HIV compared to resource-rich countries, including a concurrent strategy to address barriers to health care service delivery. We suggest that assessment of pain and depression need to occur simultaneously in those with pain in HIV. We suggest investigation of the effect of social inclusion on pain and depression. <br><b>USING DOCKER TO RUN THE HIP-STUDY ANALYSIS SCRIPTS</b>These instructions are for running the analysis on your local machine.You need to have <i>Docker </i>installed on your computer. To do so, go to <i>docker.com </i>(https://www.docker.com/community-edition#/download) and follow the instructions for downloading and installing Docker for your operating system. Once <i>Docker</i> has been installed, follow the steps below, noting that <i>Docker</i> commands are entered in a terminal window (<i>Linux</i> and <i>OSX/macOS</i>) or command prompt window (<i>Windows</i>). <i>Windows</i> users also may wish to install <i>GNU Make </i>(http://gnuwin32.sourceforge.net/downlinks/make.php) (required for the `make` method of running the scripts) and <i>Git </i>(https://gitforwindows.org/) version control software (not essential).<br><br><b>Download the latest image</b>Enter: <i>docker pull kamermanpr/docker-hip-study:v1.0.1</i><br><b>Run the container</b>Enter: <i>docker run -d -p 8787:8787 -v :/home/rstudio --name threshold -e USER=hip -e PASSWORD=study kamermanpr/docker-hip-study:v1.0.1</i>Where <i></i> refers to the path to the HIP-study directory on your computer, which you either cloned from GitHub (https://github.com/kamermanpr/HIP-study.git), <i>`git clone https://github.com/kamermanpr/HIP-study`</i>, or downloaded and extracted from figshare (https://doi.org/10.6084/m9.figshare.7654637).If you use <i>git </i>you can preconfigure the docker image with your <i>git</i> credentials: <i>`docker run -d -p 8787:8787 -v :/home/rstudio --name hip -e USER=hip -e PASSWORD=study -e GIT_USER="" -e GIT_EMAIL="" kamermanpr/docker-hip-study:v1.0.1`</i><br><b>Login to RStudio Server</b>- Open a web browser window and navigate to: <i>`localhost:8787`</i>- Use the following login credentials: - Username: <i>hip</i> - Password: <i>study</i><i><br></i> <b>Prepare the HIP-study directory</b>The HIP-study directory comes with the outputs for all the analysis scripts in the _/outputs_ directory (<i>html </i>and <i>md</i> formats). However, should you wish to run the scripts yourself, there are several preparatory steps that are required:1. Acquire the data. The data required to run the scripts have not been included in the repo because participants in the studies did not consent to public release of their data. However, the data are available on request from Peter Kamerman (peter.kamerman@gmail.com). Once the data have been obtained, the files should be copied into a subdirectory named <i>/data-original</i>.2. Clean the <i>/outputs</i> directory by entering <i>`make clean`</i> in the <i>Terminal</i> tab in RStudio.<br><b>Run the HIP-study analysis scripts</b>To run all the scripts (including the data cleaning scripts), enter <i>`make all`</i> in the <i>Terminal</i> tab in RStudio.To run individual RMarkdown scripts (<i>*.Rmd</i> files)1. Generate the cleaned data using one of the following methods: - Enter <i>`make data-cleaned/demographics.rds` </i>in the <i>Terminal</i> tab in RStudio. - Enter <i>`source('clean-data-script.R')`</i> in the <i>Console</i> tab in RStudio. - Open the <i>clean-data-script.R</i> script through the <i>File</i> tab in RStudio, and then click the <b>'Source'</b> button on the right of the <i>Script</i> console in RStudio for each script. 2. Run the individual script by: - Entering <i>`make outputs/.html`</i> in the <i>Terminal</i> tab in RStudio, <b>OR</b> - Opening the relevant <i>\*.Rmd</i> file through the <i>File</i> tab in RStudio, and then clicking the <b>'knit'</b> button on the left of the <i>Script</i> console in RStudio. <br><b>Shutting down</b>Once done, log out of RStudio Server and enter the following into a terminal to stop the Docker container: `docker stop hip`. If you then want to remove the container, enter: `docker rm threshold`. If you also want to remove the Docker image you downloaded, enter: `docker rmi kamermanpr/docker-hip-study:v1.0.0`