... | ... | @@ -176,13 +176,20 @@ There are multiple ways to specify `<participant>`: |
|
|
|
|
|
### `ama group auto-assign`
|
|
|
|
|
|
Participants can be part of one or more _contexts_. This is administered in the pepAssessor GUI, during the data collection phase. Participants can also be marked as being test participants. PEP can automatically derive participant groups based on this information. This can be done with:
|
|
|
Automatically update participant groups based on participant assignment to study _contexts_, and participants being marked as test participants. The command
|
|
|
|
|
|
- assigns every non-test participant to the `all` participant group, and
|
|
|
- for every study context that a non-test participant belongs to, assigns that participant to a participant group named `all-[STUDY_CONTEXT]`, and
|
|
|
- for every participant group whose name is `all` or starts with `all-`, removes participants from that group if they should not (or no longer) be assigned to that group, and
|
|
|
- removes empty participant groups whose name is `all` or starts with `all-`.
|
|
|
|
|
|
```
|
|
|
pepcli ama group auto-assign
|
|
|
```
|
|
|
|
|
|
For every existing study context, this command will add participants that are in that context to the participant group with the name `all-[STUDY_CONTEXT]`. Test participants are not added. If the group does not exist, it will be created.
|
|
|
By default the command only outputs the (re-)assignments that would be performed, but doesn't update the configuration. To actually perform the (re-)assignments, invoke the command with the `--wet` switch (indicating that it's not a "dry" run).
|
|
|
|
|
|
Use the command's `--mapname` switch to create `all-[MAPPED_REPLACEMENT]` groups instead of groups whose names correspond with a raw context name. Multiple `--mapname`s may be specified with a single invocation.
|
|
|
|
|
|
### `ama query`
|
|
|
|
... | ... | |