Analyze the psychological evolution of VHs during a simulation

Learn about the PsychologicalEvolution endpoint.

This API helps you understand the changes (evolution) in the psychological profiles of the Virtual Humans (VHs) involved in a simulation after it is complete.

Error while loading OpenAPI operation — Failed to fetch OpenAPI file

API Request

Parameters

Parameter	Description
project_ID*	Unique identifier of the simulation project for which you want to observe psychological evolution.
entity_Ids	Unique identifiers of the VH entities for which you want to observe psychological evolution. Note: If you do not pass any value to this parameter, the API returns all available data.
session_IDs	The unique identifiers of the sessions for which you want to observe psychological evolution.
stages	Unique identifiers of successful interactions.
persona_attributes	An array of user persona attributes that enable retrieval of information about VHs that generated based on specific users. Note: Although VHs are not directly mapped to users, EDAA™, the underlying technology that powers Affective Computing, maps them at the persona attribute and profile level. For example, you can enter a persona attribute such as male_18_yo or female_18_yo and retrieve e psychological evolution data for all VHs the profiles of which were generated from users who match those attributes. However, to filter evolution results by user persona attributes, you must ensure that the attributes are the same as the ones declared in the RDC project.
triggered_Action_Ids	The identifiers of the specific triggered actions based on which you want to filter results
maxResultCount	A pagination parameter that helps you limit the number of results returned. It specifies the number of retrieved results.
skipCount	A pagination parameter that helps you define the number of results to skip (i.e. where to start counting) when returning results.

API response

Sample

{
    "result": {
        "project_Id": 6,
        "entities": {
            "totalCount": 2,
            "items": [
                {
                    "entity_Id": 181,
                    "persona": [
                        {
                            "attribute": "Diagnosis_architectural_knowledge_level__Architectural_Layman",
                            "value": "Architectural"
                        },
                        {
                            "attribute": "Diagnosis_area_of_interest__Historical_Technical_Fantastical_Cultural",
                            "value": "Cultural"
                        }
                    ],
                    "personality_evolution": "Not evolving",
                    "sessions": [
                        {
                            "session_id": null,
                            "stage": -1,
                            "perceptions": null,
                            "levelOfPsychologicalWellBeing": 37.922587500000006,
                            "mentalWellBeing": {
                                "area": "",
                                "anxiety": "0.36182755739585426",
                                "level_of_stress": "1.9396900612620007",
                                "self_knowledge": "0.5228675378193727",
                                "aggressiveness": "1.8914243552536614",
                                "creativity": "0",
                                "social_skills": "0",
                                "open_to_changes": "0",
                                "inhibited": "0"
                            }
                        }
                    ]
                },
                {
                    "entity_Id": 184,
                    "persona": [
                        {
                            "attribute": "Diagnosis_architectural_knowledge_level__Architectural_Layman",
                            "value": "Architectural"
                        },
                        {
                            "attribute": "Diagnosis_area_of_interest__Historical_Technical_Fantastical_Cultural",
                            "value": "Cultural"
                        }
                    ],
                    "personality_evolution": "Not evolving",
                    "sessions": [
                        {
                            "session_id": null,
                            "stage": -1,
                            "perceptions": null,
                            "levelOfPsychologicalWellBeing": 41.28343,
                            "mentalWellBeing": {
                                "area": "",
                                "anxiety": "1.4759986447629594",
                                "level_of_stress": "2.2175039194665316",
                                "self_knowledge": "0.17995373299231762",
                                "aggressiveness": "1.891367000305465",
                                "creativity": "0",
                                "social_skills": "0",
                                "open_to_changes": "0",
                                "inhibited": "0"
                            }
                        }
                    ]
                }
            ]
        }
    },
    "targetUrl": null,
    "success": true,
    "error": null,
    "unAuthorizedRequest": false,
    "__abp": true
}

Understanding the response structure

• Persona-related information and their corresponding values are available for each VH in the persona array. However, the attributes and values defined during user persona creation are displayed. In this sample, the Diagnosis_architectural_knowledge_level__Architectural_Layman and Diagnosis_area_of_interest__Historical_Technical_Fantastical_Cultural, are illustrative examples.

• The levelOfPsychologicalWellBeing and mentalWellBeing parameters are grouped in the same sessions array for easier consumption.

• Pagination is implemented at the Item level (showing the totalCount of items).

• The data for each entity (VH) is displayed. If a specific VH didn’t undergo an evolution, no data or the initial value is displayed.

• Data outputs are not based on "digital word time".

• If psychological evolution is observed, the perceptions parameter displays the number of perceptions experienced by the VH.

Data insights

You can gain the following insights from the response:

Insight	Response parameter or attribute	Description
Psychological Well-Being	levelOfPsychologicalWellBeing	One of the following values is returned: A value in percentage 0 if there is no data for the specific session A higher percentage indicates a positive progression towards psychological well-being. Conversely, a lower percentage indicates a negative progression, i.e. lack of psychological well-being.
Personality Evolution	personality_evolution	One of the following string (text) values is returned to indicate whether there is personality evolution: Evolving: The VH's personality is evolving in a positive way. Not evolving: The VH's personality didn’t achieve a positive evolution (regression).
Mental Well-Being	mentalWellBeing	Percentages of different components of mental well-being are returned: For anxiety, level_of_stress, self_knowledge, and aggressiveness, if there is no data for a particular session, the value returned is 0. For creativity, social_skills, open_to_changes, and inhibited, if the VH didn’t complete a sufficient number of interactions for a reliable conclusion, the value returned is 0. For anxiety, level_of_stress, aggressiveness, and inhibited: A higher percentage indicates negative progress. A lower percentage indicates positive progress. For creativity, social_skills, open_to_changes and self_knowledge: A higher percentage indicates positive progress. A lower percentage indicates negative progress. Note: An VH should undergo more than 4 sessions to receive information about its mental well-being.