Skip to main content

Tools to interact with the DigLab metadata collection standard

Project description

DigLabTools

DigLabTools is a collection of tools to interact with the DigLab metadata collection standard based on RedCap surveys.

Installation

To use DigLabTools you need to have a Python installation available on your computer including the pip package. You can install DigLabTools from PyPI via pip install DigLabTools. Note that DigLabTools requires git. If git is not available on your system you can install it manually. When using conda this can be done via conda install -c anaconda git.

Generate an API token

To be able to access the metadata from a RedCap server an API token needs to be created. For this login to your local RedCap server and go to the API menu on the left pane. Here you can generate a personalized access token for your user account. Copy the generated token, you will need to add it to your DigLab project configuration in the next step.

Configure your DigLab project

You need to create a project configuration json file on your computer to store the RedCap API token you just generated. Use your preferred text editor to create a <project_name>.json file with the following content:

{
  "structure": "structure.csv",
  "customization": "customization.csv",
  "validation": [],
  "api_token": "<paste your API token here>",
  "api_url": "<put the url of your RedCap server here>/api/"
}

Replace the <...> entries with the corresponding values for your project. The structure, customization and validation entries are required for project building and not needed to download the collected metadata.

Usage

Downloading metadata

To download the metadata of a project you can use the command line tool RedCapBridge. Use the RedCapBridge --help to learn more about the different functions that RedCapBridge offers.

Building projects

The functions for project building, validation and control are only accessible via Python. Read the module documentation to learn more about these methods.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

DigLabTools-0.0.1a7.tar.gz (18.4 kB view details)

Uploaded Source

Built Distribution

DigLabTools-0.0.1a7-py3-none-any.whl (26.6 kB view details)

Uploaded Python 3

File details

Details for the file DigLabTools-0.0.1a7.tar.gz.

File metadata

  • Download URL: DigLabTools-0.0.1a7.tar.gz
  • Upload date:
  • Size: 18.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.0 CPython/3.9.13

File hashes

Hashes for DigLabTools-0.0.1a7.tar.gz
Algorithm Hash digest
SHA256 0b3ddc55f34e8a2709ec428db38c1254e404bdbf58f70275ea9e82458f3c22de
MD5 6a3c89396582ec8918100d5f84a06a2c
BLAKE2b-256 8566398524a3c40146409822deea629b33c4fd22bde69d071d8aee0f7c3f1775

See more details on using hashes here.

Provenance

File details

Details for the file DigLabTools-0.0.1a7-py3-none-any.whl.

File metadata

File hashes

Hashes for DigLabTools-0.0.1a7-py3-none-any.whl
Algorithm Hash digest
SHA256 e0426ebcb81bc747d2dd8a27e144d7515e1feff62d26c155723cafd697d1ab83
MD5 f09a8215f62496fe519abf93948a7a4c
BLAKE2b-256 0d09ee2496e08fece5577a1c966a73148b62b2d732dd8fb92d1df415cf823570

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page