Group of Participants

Participants of the experiments are organized into groups.

Creating and Editing a Group

A group contains:

  • A title (obligatory);

  • A description (obligatory);

  • One or more diagnoses of diseases specified using the International Classification of Diseases (ICD) as inclusion criteria;

  • A list of participants; and

  • An experimental protocol.

However, while creating a new group, the screen asks only for the title and description. Those are also the fields that can be updated if you click the Edit button in the visualization screen. Inclusion criteria and experimental protocol can be added while visualizing a group. Only authorized users can update a group, which means the owner of the study of the experiment of this group or users with permission to change studies from others (See Permissions for more information).

../../_images/edit_group.png

Visualizing a Group

While in the screen for visualizing an experiment, you can see more information about an existing group by clicking on its title in the list of groups. While viewing a group, you can delete it by clicking the Delete button. However, this button is visible only for the users that have permission to update the group.

../../_images/view_group.png

Inclusion Criteria

Researchers may include one or more diagnoses to be used as inclusion criteria for participants in the group. This information is only informative. The system does not verify if participants included in the group have the specified disease. To include a new diagnosis, you should type the name or part of the name of the disease or the ICD code. A drop down list of suggestion will be shown for you to select one of the diagnoses from the list. To remove an inclusion criteria, you simply click the :x: button associated to it. Again, only users that have permission to update a group can add or remove inclusion criteria. Non-authorized users can’t see the text field.

../../_images/icd.png

Questionnaires of the Experimental Protocol

To help users visualizing data already collected from participants of the group, the screen that shows detailed information about a group has a specific section that summarizes the number of fills for each questionnaire of the experimental protocol. Each line shows the identification of the questionnaire, the number of fills needed per participant, the total number of fills needed for the group and the total number of fills already done. Clicking on the identification of the questionnaire, you can see a screen showing detailed information about the questionnaire and a list of participants. The list includes a graphical representation of the number of fills already done by the participant in relation to the number of fills needed from the participant and the date of each started or finished fill. The date is a link to a page that allows you to finish the fill, in case of an uncompleted fill, or a page that shows the answers, in case of a completed fill. See Managing a Questionnaire Fill for more details.

../../_images/questionnaire_of_a_group_with_list_of_participants.png

Listing and Inserting Participants

A group can have an unlimited number of participants. If no participant has yet been registered in the group, you will see a Add participant/s button.

../../_images/group_new_participant.png

If at least one participant was registered, you will see a link whose text informs the number of participants already registered. Both this link and the Add participant/s button will take the user to a screen that allows a participant to be registered and lists the participants already registered. If you do not have the [[permission | Permissions]] to add a participant to a group, you will only see a message informing the number of participants already registered.

To register a new participant, you should type the name or the CPF of the participant. While the user types, the system suggests participants that match the typed term. Suggestions are given since the first character typed. Each suggestion is a link. By clicking the link, you include the participant in the list of registered participants.

The list of registered participants includes a link (:paperclip:) to a screen that allows you to attach / visualize the file that stores the term of consent signed by the participant, and a graphical representation of the number of questionnaires already completed (all the required fills have been done) by the participant in relation to the number of questionnaires included in the experimental protocol.

../../_images/list_of_participants.png

Visualizing a Participant

Clicking the name of the participant takes you to a screen that shows all the fills of this participant. If you have the Permissions to remove a participant from the group, you will also see a Delete button.

../../_images/participant_of_a_group.png

Experimental Protocol

If no experimental protocol has yet been configured in the group, you will see a Configure / Create button. If you click this button, NES will show the screen for creating or reusing a component that will become the root of the experimental protocol of the group. The root of an experimental protocol will always be a set of steps. If you do not have the Permissions to change the study, you will only see a message informing that no experimental protocol was configured.

../../_images/no_experimental_protocol.png

If the root of the experimental protocol has already been configured, you will see a link whose text informs the identification of the set of steps that is the root of the experimental protocol of the group. If you click this link, NES will show the visualization screen for this set of steps. If you have the permission to change the study, you will also see a :x: button that can be used to unset the experimental protocol.

You find more information about this topic in Configuring an Experimental Protocol.