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.
Signed release binaries for the RDMP client and Command Line Interface (CLI) are in the available in the GitHub releases section.
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\net5.0-windows\win-x64
./ResearchDataManagementPlatform.exe
The console client:
dotnet build
cd Tools\rdmp\bin\Debug\net5.0\
./rdmp.exe --help
Only the console client can be built/run in Linux
cd Tools/rdmp
dotnet build
cd bin/Debug/net5.0
./rdmp --help
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/net5.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.
We welcome all contributions including:
- Issues and bug reports
- Code Reviews
- Translations
- Documentation
- Code Contributions