edc-randomization 0.3.31

Randomization classes for clinicedc/edc

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 representation 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”.

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.