edc-randomization 0.1.26

Randomization classes for clinicedc/edc projects.

edc-randomization

Randomization objects for clinicedc projects

Overview

The default randomizer class will refer to and update the randomization list in the default RandomizationList model. You may refer to more than one randomizer within a project by declaring a custom randomizer class and registering it with site_randomizer. Randomizers are referred to by name in site_randomizer. Each randomizer class should have a custom model associated with it. See the RandomizationListModelMixin and its randomizer_cls attribute.

Importing from CSV

You can import data from CSV into the RandomizationList (or your custom model) using the import_randomization_list management command:

python manage.py import_randomization_list

--or--

python manage.py import_randomization_list --name=my_custom_randomizer_name

Customizing the default randomizer

The important values are:

• sid: unique sequence

• site: Site name

• allocation: integer repreasentation of arms (e.g. 1, 2)

The default randomizer is loaded at startup, uses the RandomizationList model and an allocation map of “Active=1” vs “Placebo=2”.

Without declaring a new randomizer class, you can change the allocation arms from “Active” vs “Placebo” to something custom. To do so, update settings with:

EDC_RANDOMIZATION_ASSIGNMENT_MAP=INTERVENTION=1,CONTROL=2  # for example

With the above, your CSV file will have 1’s and 2’s in the allocation column and mapped to INTERVENTION, CONTROL respectively.

Creating a custom randomizer

Unless you explicitly tell it not to, the site_randomizer will load the default randomizer. This may be OK if you have multiple randomizers within the same protocol where the default is one of them. If not, you can prevent the “default” from loading by updating settings with:

EDC_RANDOMIZATION_REGISTER_DEFAULT_RANDOMIZER=False

To create a custom randomizer class, declare a subclass of Randomizer in file randomizers.py at the root of your app. On startup the site_randomizer will pick it up. See the Randomizer class.