Research Data Management Platform
RDMP is a free, open source software application for cohort building, loading, linking, anonymisation and extraction of datasets stored in relational databases (SQL Server, MySQL, Postgres and Oracle). It was designed from the bottom up to support with data provenance, preserving domain knowledge and configuration management workflows.
RDMP does not require your data be moved or transformed prior to processing and is integrates into existing SQL based extraction practices.
Install
Signed release binaries for the RDMP client and Command Line Interface (CLI) are in the available in the GitHub releases section.
Build
Building on Windows
You can build RDMP from the command line using dotnet build
or through an IDE e.g. Visual Studio or Visual Studio Code (Requires dotnet5 SDK).
The Windows client:
dotnet build
cd Application\ResearchDataManagementPlatform\bin\Debug\net6.0-windows\win-x64
./ResearchDataManagementPlatform.exe
The console client:
dotnet build
cd Tools\rdmp\bin\Debug\net6.0\
./rdmp.exe --help
Building on Linux
Only the console client can be built/run in Linux
cd Tools/rdmp
dotnet build
cd bin/Debug/net6.0
./rdmp --help
Tests
To run tests you will need an instance of SQL Server. These instructions use localdb which is included in visual studio.
If using a docker container or alternate sql server instance then substitute your host name in place of (localdb)\MSSQLLocalDB
dotnet build
./Tools/rdmp/bin/Debug/net6.0/rdmp.exe install "(localdb)\MSSQLLocalDB" TEST_ -d
echo "ServerName: (localdb)\MSSQLLocalDB" > ./Tests.Common/TestDatabases.txt
echo "Prefix: TEST_" >> ./Tests.Common/TestDatabases.txt
dotnet build
dotnet test ./scripts/run-all-tests.proj -c Release -p:BuildInParallel=false
For a more indepth guide to CI testing see How to set up your test environment in Tests.md.
Contributing
We welcome all contributions including:
- Issues and bug reports
- Code Reviews
- Translations
- Documentation
- Code Contributions