COSMOS User Guide

This guide is entirely around the Co-creation Service Modelling System (COSMOS) application of the Living Lab platform.

About COSMOS

Established from a Living Lab methodology, COSMOS (Co-Creation Service Modelling System) permits the stakeholders involved with social and service innovation to visually and interactively position themselves within their service and social innovation environment, and across several theoretical models. COSMOS is a an open-source web-based application comprising of multiple digital representations of these theoretical models which assist with the identification of inputs and outputs from the innovation process whilst doing so in a co-creative manner. Developed in response to requirements identified as part of the Co-production of Social Innovation in Europe (COSiE) project - a pan-European project across nine countries each delivering unique social innovation pilots - each model within COSMOS has been developed and provided in response to identified aspects of co-creation found within the COSiE project. These models have been purposefully designed to engage stakeholders using a range of input questions, prompts, and comments. By engaging with COSMOS, each participant's replies and comments entered within the application in real-time. These responses lead to the description and identification of roles and responsibilities within the innovation, moral ordering of social innovation, models of change, amongst others - COSMOS provides a real-time, interactive reflection and representation of the co-creation environment. The digital representation of these models, which also allows for the collection of external websites, images and files, and social media and open data sources for simple referencing and wider discussions, can be completed interactively or offline, individually or within a workshop environment. The outputs can then be shared and compared with a range of involved stakeholders in the form of a boundary object to extend the discussion regarding the service and social innovation.

Accessing COSMOS

This section describes how to access COSMOS including user account creation and navigation of the application.

Accessing COSMOS

Logging In

The first page presented to you when reaching COSMOS, is the login screen. There are three options available to you:

  1. Login with the default username and password for COSMOS, provided to you by the Living Lab team;
  2. Login with details provided by an administrator of COSMOS; or
  3. Create an account

Once succussfully authenticated, you will be directed to the Dashboard.

image-1605820714964.png

The ability to 'Create an account' is an adminstrative function controlled within the COSMOS administration feature. Additionally, this function only becomes operational when both the 'Enable new user self-registration' and 'Email' options are enabled in 'Settings'.

Accessing COSMOS

Creating a New Account

In the event you have not been invited to COSMOS, or you wish to register a new account, it is possible to 'Create an account' to access COSMOS. To do this, enter your name and a valid email address. A link to finalise the completion of your new account will be sent to the provided email address.

image-1606350055296.png

Upon clicking register, the following notificaiton will appear:

image-1606389373112.png

Within the email will contain a link to the password reset function where you will be asked to supply a password containing 8 or more characters.

Click the 'Submit' button to save your password.

Depending on the email settings of COSMOS, email used to create a new account may be sent to Spam or Junk folders. Please check these folders. Should there still be issues, please contact info@livinglab.org.uk for further assistance.

Accessing COSMOS

Dashboard

Once logged into COSMOS, you are presented with three main areas within the Dashboard.

These are:

Open project: Where a project has been previously created, these will be visible in the list. It is also possible to search for existing projects and also to display all COSMOS projects, or just display those that you have created.

The ability to see 'All' projects depends on the permissions granted to you by the COSMOS administrator. By default, you will not have permission to see any other projects.

Create new project: When needing to create a new COSMOS project, it is possible to do so from this area. Also, specific models that should be included in the project are also selected here.

Import project: In some cases, it might be necessary to import an existing COSMOS project. This might be necessary to move or duplicate an existing project. The imported project can then be updated whilst preserving the original version, for example.

image-1605821947821.png

Accessing COSMOS

Open an Existing Project

To open an existing project, simply click on the name of the project in the list. This will then open the project in either editing or viewing mode depending on your permissions on the project.

To search for an existing project, begin typing the name of the project into the 'Search' text box. The list of projects will automatically begin to display matching search results. From here, click on the name of the project to open it:

image-1609377235498.png

To view only your projects, click the 'Just mine' button. This will display just the projects that have been created by you. This button also works with the search function too: the search results will just return those that match the search criteria and your own projects. Click on the name of the project to open it:

image-1609377313498.png

 

 

 

Accessing COSMOS

Create a New COSMOS Project

The COSMOS Dashboard makes it really simple to create a new COSMOS Project. In the 'Create new project' section of the Dashboard, enter a name of your project in the 'Name' field.

image-1609407772591.png

Once entered, select from the Models listed which of those you would like to be included witin your new project. By default, all projects are selected. Once selected click the 'Create' button which will then create the project and take you into the COSMOS Environment.

Accessing COSMOS

Import a Project from a Backup

In the even that you wish to move or restore a back up a COSMOS project, this is completed using the Import project feature form the Dashboard.

In order to import a project, it is first necessary to export a current project. The ouput of the export is a .zip file.

To import a COSMOS project, drag the exported COSMOS, in .zip format, to the dotted-line box or click in the dotted-line box to open your file browser on your device. Navigate to the COSMOS project - again in .zip format - select 'Open' and then click 'Import'.

image-1609420421539.png

The imported project will appear at the bottom of the 'Open project' list.

When the project is imported, you will then become the owner of the project.

Accessing COSMOS

Exporting a COSMOS Project

From the COSMOS Toolbar, it is possible to export a COSMOS project in it's entirity. The exported file - in .zip format - can then be transported and imported into another COSMOS instance

In order to export a project, click the 'Export' button from the COSMOS Toobar. This will immediately download the export to your device.

The default file name of the export will be cosmos-{name_of_project}.zip. From here, the export can be imported to another COSMOS instance, or as a new COSMOS project.

 

Accessing COSMOS

The COSMOS Environment

The COSMOS Environment is divided into three sections: the COSMOS Toolbar which runs along the top of the screen, the Side-Bar Menu which contains the Project Navigation and Model Questions on the left, and the Responsive Model Canvas on the right.

The way in which COSMOS works is based on the input provided from the Model Questions. When answers are provided and completed, the answers to these questions are then displayed, in real-time, in the Responsive Model Canvas:

image-1609378360754.png

As more responses are provided, the Responsive Model Canvas provides a completed visualisation of the model:

image-1609378570761.png

 

 

 

Accessing COSMOS

The COSMOS Toolbar

The COSMOS Toolbar is a constant set of tools relating to COSMOS projects:

image-1609407497426.png

It provides access to the following features:

Save: This is a manual way to save your current progress. If automatic saving is disabled by your adminsitrator, clicking 'Save' will store the current progress of your project.

Download: By clicking 'Download' it is possible to export the current COSMOS model in it's current state in PDF or .PNG formats. The 'Download' function allows for a snapshot of progress to be created in either format.

Export: COSMOS allows for the exporting of projects. This allows for the moving and duplication of projects across users and different COSMOS instances. 

Last saved at: This is a visual indictator as to the last time the project was saved within the current session.

More details: 'More details' is a feature whilch allows for users to enter more information into the Responsive Model Canvas area within COSMOS models. Toggling this will disable the creation and display of 'Moore details' within the Responsive Model Canvas. It is enabled by default. 

Scale to fit: On occaison, the size of the Responsive Model Canvas within COSMOS is too big for the current display. Toggling the Scale to fit on will resize the canvas to fit to the size of your display. It is disabled by default.

Username: This displays the current, logged on user accessing the COSMOS project. By clicking on this, it directs the user to their account details where it's possible to change email address and password.

Language: Clicking on this changes the native language of COSMOS. The current options are: English, Greek, Spanish, Hungarian, Finnish, French, German, Polish, Italian, Dutch, Estonian, and Swedish.

Accessing COSMOS

More Details Toolbar Option

By double-clicking anywhere on the Responsive Model Canvas, it is possible invoke the the 'More details' pop-up box. 'More details' allows the End User to discretely record more information directly on to the canvas:

image-1609407631258.png

'More details' appear on the canvas as an image-1609555810255.png icon. This icon can be dragged around the Responsive Model Canvas to be placed in a more convenient location. Equally, an unlimited number of 'More details' can be added.

Should a 'More details' be required to be deleted, simply click on the image-1609555810255.png icon, and then press the trash can button.           

 

The ability to use the 'More details' feature is dependant on whether the End User has the correct roles - in this case, the Edit and Admin roles - for the project. Also, the 'More details' feature can be toggled off - via the COSMOS Toolbar.

 

 

 

The COSMOS Models

An overview and description of all the models featured within COSMOS to provide context and applicability.

The COSMOS Models

Analytical Model

About the Analytical Model

The Analytical Model is designed as a probe on the initial service model to identify the specific actors who, at various stages in the development of the initiative, have undertaken one or more of these change agency roles. It asks the question "Who are they?". This is explored in the Analytical Model:

image-1609695015431.png

All of the social innovations involve the engagement of organisational structures and processes which span policy making, the configuration and management of service resources and front line delivery. Further, in some contexts there can be tensions and even conflict of interest and value along this chain. One dimension of co-creativity is concerned with how power and participation is distributed along this axis.

 

 

The COSMOS Models

Change Model

The Change Model adopts a cybernetic stance, that is to say it is about how things are guided, how changes are made, distinguishing different sorts of orders of change.

We start with the simple and obvious feedback process of the first order (Vision: Plan: Execute and Measure)
We have all had the experience, in retrospect, of looking at a change that has taken place and realising that we have:

image-1606350932166.png

This is all evidence that a shift has taken place from first order thinking to second order thinking which puts our original first order loop into a second order loop. This involves sense-making, that is to say, a process of re-examining and reconceptualising our ways of framing and understanding our world. One sign that this is happening is that “languaging” take place: new terms are adopted to reflect new distinctions and categorisations.

Transitions from first to second and from second back to first order work often need to be facilitated and enabled. This can take the form of the exposure of paradox and contradiction, threats and challenges. When these are orchestrated deliberately and with purpose, we identify third order interventions which are attempts to stimulate and nurture appropriate transitions between first and second order work.

Such interventions can elicit a zero-order response. This is emotional rather than rational in nature and represents the fight or fly response to threat. We represent it as a shift to the right-hand side of our model where there is a spectrum of responses from this to what we call the “fourth order” which is the seemingly spontaneous emergence of positive and fruitful commitments to transformational initiatives as a group response to situations.

The COSMOS Models

Co-Creation of Service Model

This model is designed to encourage its users to put their local initiative into a wider structural and infrastructural context and to consider the ongoing relationships between the activities they have undertaken and this relevant external considerations.

The Co-Creation of Service Model emerged from a consideration several Social Innovations and is an attempt, on the one hand, to identify the core internal elements that are common to all the various approaches of them and, on the other, to make certain key external elements and factors which, are relevant to any service environment, explicit if it is to be sustainable. It represents an attempt to present and interrelate a number of terms and categories to provide the basis for a common language and framing of the service innovations activities.

The service process model below is included in this model as a set of Structural Relationships and Occasions. Each pilot can populate some or all of these processes with the identities of actual participants. For example, as we have seen, in some cases, Policy has represented an external input to which the pilot has had to respond whereas in others, policy was generated internally.

image-1606473868281.png

The service life-cycle processes are distributed over, and supported by, a service definition and development platform and a service delivery platform. For example, a social hackathon represents such a definition and development platform. The nature of the delivery platform for any service or service set defined in a hackathon is one of the outputs of the co-creation process. In the another case, the business development support facility has been both service definition and development as well as the delivery platform.

The reason for introducing these concepts is to encourage discussion about reusable infrastructure which is able to support and sustain successive initiative in co-creative service development which is an important element of sustainability through growth and diversification. Having identified an abstract, generic model of co-creation and of service, we have created the opportunity for shared resources between co-creation initiatives and services. Thus, below the platform we have a space in which to locate infrastructural capacities to support deliberation, design, communications, the means of access to different sorts of services and service components and for the processes of qualification, scheduling and evaluation. The precise shape and nature of these resources will vary from pilot to pilot but there are some universal elements that are common requirements in many classes of wellbeing and developmental services. Many of these are concerned with the support of information management and communication, such as publication channels, registration services by which new actors and resources which join the service environment can be given identifiers and locators, catalogue publication and management and recording and profiling tools. The description so far has covered the right-hand part of the model above. This represents elements that are considered to be within the co-creative ethos of a pilot’s actions. The left-hand side of the model represents relevant external elements that are part of the initiation of such a process or have some ongoing impact on it.

 

 

The COSMOS Models

Intervention Theory Model

The Intervention Theory Model is an attempt to create a representation of the multi-dimensional complexity of human wellbeing because this is the “space” in which social investments and innovations are taking place.

image-1606350893699.png

The model presents three perspectives or projections of wellbeing:

We will examine each of these as follows:

Consider four major sub-domains or perspectives of human wellbeing. These are:

Each of these contain many facets which interact with each other and there are strong couplings between the four domains. These interdependencies can create catastrophic cascades of positive feedback, self-maintaining loops and deadlocks as well as sustainable coping and development. All of these are affected by, and interact with, external elements of the physical environment and the socio-cultural environment which also interact in complex ways.

Fortunately, for most of us, for most of our lives, we have only one major problem, challenge or crisis at a time. A specific remedial intervention, perhaps with some rehabilitative components, is a sufficient and appropriate response to what will be experienced as an episode of care in which a problem gets fixed. Integration, from both the providing and receiving perspectives, are usually achievable through the planning and standardisation of pathways and protocols of a single service which can be specified with sufficient flexibility to respond to the levels of variation and uncertainty experienced in most cases of simple episodic care.

 

 

The COSMOS Models

Moral Ordering Model

The Moral Ordering Model distinguishes between the contexts and occasions (or stages in the lifecycle of a social innovation) including:

 

image-1608292746775.png

The COSMOS Models

User Journey Model

Social innovation processes are implied in the instigation, deployment and fruition of a service and can be seen as a combination of processes and as the interactions between roles and responsibilities. This is represented as follows:

image-1609693917087.png

Along the bottom of this model we see the Service Journey and immediately above this, the set of roles that a member of the public or a community could play in relation to the service. The remaining boxes represent the roles involved in instigating, designing, delivering and evaluating the service. In this modelling projection, the processes that are involved are conversational in nature; they involve the production of sets of information referred to by the red legends.
This model has been developed to augment the conventional user journey approach to encompass the concept of co-creation. The experience of “Touch Points” is no longer simply one of the evaluation of encounter and operation but one of participation and influence. Thus:

  1. Were you involved in the instigation of this service? If so, was this as an activist-driven, part of a political process or a civic one? What were the occasions? How do you evaluate the experience? If you did not, how much are you aware to the parties who did instigate the service?
  2. Were you involved in the definition and design of the service? The identification of the intended benefits and targeted priorities and beneficiaries? The way the service was targeted and communicated?
  3. How did you find out about the service and the possibilities to participate, influence (?) and to make use of it?
  4. What was your experience of the accessibility of the service and your rights to make use of it?
  5. How was the experience of using/participating in the service? Has the experience changed in any ways?
  6. What is your participation and experience in the evaluation of the service? Has the service changed as a result

These questions can be answered from the perspective of an individual service user/participant, their informal carer, a front line service deliverer, the administrative staff associated with the service or a front line manager, middle manager of a senior or political level individual. In aggregate, they provide a map of co-creation experience at the intersections between the service lifecycle processes and the personal experiences of participants.

Completing a COSMOS Project

This section describes how to undertake the necessary tasks in the COSMOS interface to complete the models and project in response to the environment within which the investigation is occuring.

Completing a COSMOS Project

The COSMOS Side-Bar Menu

The COSMOS Side-Bar Menu is a way to navigate within a project and provides access to the many models and sections of the COSMOS application. Within the COSMOS environment, this is also referred to as the Project Navigation and Model Questions pane.

The content of the COSMOS Side-Bar Menu depends on the models selected when creating a project, in the 'Project Details' options within the project.


Project Navigation

The full COSMOS Side-Bar Menu is seen as follows. Clicking on each of the menu items opens the following screens, models and areas of COSMOS:

image-1608291424810.pngProject Details: Gives the ability to rename the project, and also to provide information relating to the name of the creator of the COSMOS project, the country within which the COSMOS analysis is being undertaken, and also to select which models are part of the project.

Co-Creation of Service Model: Opens the Co-Creation of Service Model.

Analytical Model: Opens the Analytical Model.

Intervention Theory Model: Opens the Intervention Theory Model.

Change Model: Opens the Change Model.

Moral Ordering: Opens the Moral Ordering Model.

User Journey Model: Opens the User Journey Model.

Theory of Change: Opens the Theory of Change section.

Community Reporting: Open the Community Reporting section.

Social Media: Opens the Social Media section.

Documents: Opens the Documents section

 

In addtion, the following icons appear to provide quick access to either editing of the model or provide an overview of the text recorded. 

image-1606351522186.png

Opens the chosen menu item in edit mode whereby the End User can add, delete and edit content in the appropriate section.

image-1606351532071.png

Provides an overview of text that has been input into the model. Applies to Change Model, Moral Ordering, and User Journey Model.

image-1609551801580.png

 

Once inside a section or model, this returns the user back to the top of the COSMOS Side-Bar Menu.

The ability to edit models within COSMOS depends on the End User permissions. If the End User does not have 'Edit' permissions, this option is not visible.

Model Questions

The Side-Bar Menu within COSMOS also doubles-up as way to interact with COSMOS. Within each of the COSMOS Models (and the Theory of Change, Community Reporting, Social Media, and Documents sections) there are text boxes within which input from the End User is required. 

The following example highlights this within the 'Co-Creation of Service Model':

image-1609692561952.png

The Title entered in the Project Navigation and Model Questions on the left, appears in the Responsive Model Canvas in real-time. Also, after each question, there is a 'Next' button to move on to the next question/request for input:

image-1609692762845.png

Equally, as questions are answered, the responses as well as a reveal of the model, are added to the Responsive Model Canvas.

In order for a model to appear completed in the Responsive Model Canvas, all questions must be completed - any blank reponses will not reveal the model in its entirity.

Completing a COSMOS Project

Project Details

The Project Details section of a COSMOS project allows for the following options across three areas.

Project

Project name: The title of the project which is used to identify it in the 'Open Project' area of the Dashboard.

Created by: The author of the project. The default value for this is taken from the End-User that created the project initally - or imported it.

Country

The options here - which are not mandatory - allow the customer to specify the country where the analysis using COSMOS is taking place. The flag of the country appears in the top right-hand corner of the Responsive Model Canvas when provided.

Models

The options here allows the specification of models to be included within the COSMOS project. Models allows for the adding and removing of the COSMOS models in a project following its creation.

 

Completing a COSMOS Project

The User Guide

Several of the COSMOS models have a User Guide activated within them. These appear at the top of the Responsive Model Canvas.

image-1606351327304.png

By clicking 'Next' two things occur: the next part of the User Guide is displayed and the next part of the model is displayed. The model is built along with the User Guide and provides a step-by-step display of the model. If necessary, it is possible go back through the model by clicking the 'Back' button.  Once the model is completed, the 'Close' button is displayed. Clicking 'Close' allows the End User to commence with their own completion of the model:

image-1609694246268.png

If the User Guide is not required, clicking 'Skip user guide' will close it and will allow the End User to begin to complete the model.

The purpose User Guide is to both describe, in a step-by-step manner, the features and purpose of the model, but also to provoke and promote conversation about the model. Furthermore, it is also used to associate the model with the suggest content, as well provide a visual indication of the completed model.

In addition, the icons used within the User Guide are prompts for the End User or Facilitator to ask or consider the 

image-1606351441734.png

This is is an information item regarding the model including the theory and practice that underpins it. The informational items tend to provide the participants with direction and aspects to consider. 

image-1606351461648.png

 

This is a discussion item and provides specific highlights relating to the model and its content which would benefit from wider discussion with any participants. Equally, the comments provided are meant to provoke the discussion so as to fulfill the wider purpose of COSMOS.

 

 

Completing a COSMOS Project

Theory of Change

About the Theory of Change Section

The purpose of the Theory of Change is to provide external web links to files, documents and resources which may be useful to further explain those components included within the environment COSMOS has been applied to analyse.

The Theory of Change section does not permit the uploading of files - this is reserved for the Documents section of COSMOS.  The Theory of Change section of COSMOS is defined for handling external web links which may lead  to documents, photos or other files.

Adding a Theory of Change Item

1) When no 'Theory of Change' items exist, the following will be displayed. If items do exist, skip to Step 3 below.

image-1609553056955.png

2) Click 'Manage Theory of Change'

3) The Project Navigation will now show the following:

image-1609553125900.png

4) Here, enter a recognizable name and press 'Enter'. This will now create an item in the Responsive Model Canvas:

image-1609553363145.png

5) In the Project Navigation click the Theory of Change item to reveal more detail:

image-1609553683036.png

Enter a web address to provide more information regarding the item and click 'OK'. The Responsive Model Canvas will update to include an arrow which, when clicking on it, will launch the destination in a new web browser window:

image-1609553825590.png

Reordering a Theory of Change Item

In the Project Navigation click and drag the image-1609553517970.png icon and move up-and-down to reorder the Theory of Change item.

Removing a Theory of Change Item

1) In the Project Navigation click the Theory of Change item to reveal more detail:

image-1609553683036.png

2) Click the red, trash can icon to delete the Theory of Change item.

Completing a COSMOS Project

Community Reporting

About the Community Reporting Section

The purpose of the Community Reporting section is to provide external web links to files, documents and resources which may be useful to further explain those components included within the environment COSMOS has been applied to analyse.

The Comunity Reporting section does not permit the uploading of files - this is reserved for the Documents section of COSMOS.  The Community Reporting section of COSMOS is defined for handling external web links which may lead  to documents, photos or other files.

Adding a Community Reporting Item

1) When no 'Community Reporting' items exist, the following will be displayed. If items do exist, skip to action #3 below.

image-1609554678038.png

2) Click 'Manage Community Reporting'

3) The Project Navigation will now show the following:

image-1609554718979.png

4) Here, enter a recognizable name and press 'Enter'. This will now create an item in the Responsive Model Canvas:

image-1609554744541.png

5) In the Project Navigation click the Cimmunity Reporting item to reveal more detail:

image-1609553683036.png

Enter a web address to provide more information regarding the item and click 'OK'. The Responsive Model Canvas will update to include an arrow which, when clicking on it, will launch the destination in a new web browser window:

image-1609554794414.png

Reordering a Community Reporting Item

When there are two or more items, it is possible to reorder them. To do so, in the Project Navigation click and drag the image-1609553517970.png icon and move up-and-down to reorder the Community Reporting items.

Removing a Community Reporting Item

1) In the Project Navigation click the Community Reporting item to reveal more detail:

image-1609553683036.png

2) Click the red, trash can icon to delete the Community Reporting item.

Completing a COSMOS Project

Social Media

About the Social Media Section

The Social Media Section of a COSMOS project is used to link to several social media platforms providing a quick way to access content.

The Social Media section of COSMOS is used as a means to collate - and provide links to - content from within the their respective social media platforms. Given COSMOS is used for the discussion of content, this was deemed the best approach to direct participants.

The Social Media section of COSMOS currently caters for Twitter, Facebook, Instagram, and YouTube.

Adding a Social Media Entry

To add an entry to each Social Media platform, first click on the Social Media provider icon. Each provider then has their own way to add an entry.

Twitter

image-1609690883758.png

Twitter within COSMOS expects hastags (#) which can be entered with, or without the #. Enter the associated hashtag in to the the Twitter text box and press Enter. The entry will then appear in the Responsive Model Canvas.

image-1609690855317.png

By clicking on the entry in the Responsive Model Canvas, this will open Twitter and return the search results using the hastag entry supplied.

Facebook

image-1609690981230.png

Facebook within COSMOS provides access to groups (rather than individual, closed profiles). To add a new Social Media entry, add the full link of the Facebook group (copied and pasted from Facebook) in to the Facebook text box and press Enter. The entry will then appear in the Responsive Model Canvas.

image-1609691118365.png

By clicking on the entry in the Responsive Model Canvas, this will open Facebook and go directly to the Group page.

Instagram

image-1609691197690.png

Instagram, as with Twitter, within COSMOS expects hastags (#) which can be entered with, or without the #. Enter the associated hashtag in to the Instagram text box and press Enter. The entry will then appear in the Responsive Model Canvas.

image-1609691233837.png

By clicking on the entry in the Responsive Model Canvas, this will open Instagram and return the search results using the hastag entry supplied.

YouTube

image-1609691686653.png

YouTube within COSMOS provides direct access to video content hosted by the social media platform. To add a new Social Media entry, add the full link of the YouTube video (copied and pasted from YouTube) in to the YouTube text box and press Enter. COSMOS will convert the full link to the unique identifier for the video and will then appear in the Responsive Model Canvas.

image-1609691586636.png

By clicking on the entry in the Responsive Model Canvas, this will open YouTube and go directly to the video.

Removing and Editing a Social Media Entry

To remove a Social Media entry, double-click the entry in the Project Navigation panel and remove all text. The same process also enables the editing of the Social Media entry.

 

Completing a COSMOS Project

Documents

About the Documents Section

The purpose of the Documents section is to provide a way to upload files - specifically images - and to provide web links to files, documents and resources which may be useful to further explain those components included within the environment COSMOS has been applied to analyse.

The  Document seciton does permit the uploading of files - however this is specifically limited to image files. Links can be be provided to external documents, photos or other files and documents.

Adding a Document

1) When no Documents exist, the following will be displayed. If items do exist, skip to Step 3 below.

image-1609583509325.png

2) Click 'Manage documents and files'

3) The Project Navigation will now show the following:

image-1609583533703.png

4) Here, enter a recognizable name and press 'Enter'. This will now create an item in the Responsive Model Canvas:

image-1609583593618.png

5) In the Project Navigation click the Document item to reveal more detail:

image-1609583664930.png

Enter a web address to provide more information regarding the item and click 'OK'. Also, should the Document be a image, click in the dotted-line box to browse your device and upload the file. The Document item can be either an image or a file - or both. The Responsive Model Canvas will update to include an arrow which, when clicking on it, will launch the destination in a new web browser window, whilst clicking on the image will open this in a new web-browser tab:

image-1609586269161.png

Reordering a Document

In the Project Navigation click and drag the image-1609553517970.png icon and move up-and-down to reorder the Document.

Removing a Document

1) In the Project Navigation click the Document to reveal more detail:

image-1609586367655.png

2) Click the red, trash can icon to delete the Document.

Settings

Settings

Account Details

By clicking on your email address from within in the COSMOS Toolbar, it is possible to change your details including your name and email address. Also, from this section of COSMOS, it is also possible to update your password:

image-1609584858866.png

To change your name and email address, simply change the details and click 'Update'.

Settings

Changing your Password

In order to maintain security, or in the event of a need to change a user password, this is completed here. Arriving from the COSMOS Toolbar, clicking on the 'Password' tab asks the End User for the following information:

Current password: the password used by the user to login to COSMOS

New password: the new password required for access to COSMOS. This is required twice.

Once a new password has been supplied, click 'Change Password' to store it.

The new password must be 8 characters or more.

image-1605822908700.png

Settings

General

General Settings are only available to users with the Admin role within COSMOS. If you are unsure as to the impact of the changes, it is recommended that these settings remain unchanged.

The General Settings area of COSMOS enable several options within COSMOS. These are:

Enable new user self-registration: This provides new users for COSMOS to sign-up using their email address. When this is option is disabled, an End-User must be given their username and password from a COSMOS administrator or the Living Lab Team. As of v3.4.0, this option is enabled by default.

Auto-save projects: Auto-save ensures that projects are automatically saved after every action is performed by the End-User. This ensures that any responses or updates to a project are saved without the need to constantly click 'Save'. As of v3.4.0, this option is enabled by default. More information regarding auto-save and saving is found within the COSMOS Toolbar section.

Fathom tracking Site ID: COSMOS uses Fathom Analytics (https://usefathom.com/) for it's site-based analyitcs. The Site ID can be generated from Fathom and inserted here. To do so, an account with Fathom is required and the Site ID, once created in Fathom, should be entered here.

image-1605796490705.png

Settings

Email

Email settings are only available to users with the Admin role within COSMOS. If you are unsure as to the impact of the changes, it is recommended that these settings remain unchanged.

In order for COSMOS to send emails to new users, it is necesary to configure specfic email settings. Whilst these settings are now set as default in COSMOS, some users may need their own settings to enable the sending of email. As of v3.4.0, these settings are provided by default, however customised email settings may be required for some instances.

image-1605796584281.png

SMTP Server

Within this section, the known details of an email server which is enabled to send emails must be added. Please contact your ISP or email service provider for these details. 

Email Sender

Email Address (#1): This is the actual email address of the sending email account. The format must be that of of an email e.g. someone@test.com.

Email Address (#2): This is the name of the email sender. This can be any value.

Export / Import Email Settings

Export

Should it be necessary to Export a complete set of email settings (for example to another instance or for backup), it is possible to do this using COSMOS. By clicking 'Export', the following box appears:

image-1609585796410.png

Select all the text from inside the box and copy it to the clipboard. Then click 'Close'.

Import

To Import the settings from another instance, click the 'Import' button. The following box will appear:

image-1609585915992.png

Paste the copied text from the 'Export' process above into the box and click 'Import'. The email settings will now be imported.

 

 

 

 

Settings

User Management

As an administrator or facilitor, it may be necessary to invite a user that may not have a) signed up to COSMOS or b) may bot be a part of COSMOS that has new user registration enabled. 

As such, it may be necessary to invite users to COSMOS. This achieved using the following steps:

In order to perform these steps, a user must have the 'Admin' role within COSMOS

1) Click on the username / email address within the COSMOS Toolbar. The following toolbar will now appear:

image-1609552586767.png

2) Click 'Users'. The following screen will appear:

image-1605822949454.png

3) Click 'Invite new user'. Enter a name and email address of the new users.

image-1609552420190.png

4) Provide the user with the correct role.

Admin

The user will be able to see all other projects - including their own - as well as administer COSMOS

Edit

The user will be able to edit any project that they create or have access to.

View

The user will be only able to view any project that they have access to.

5) Once completed, click 'Invite new user'. This will send an email to the new user, whereby they have to click on a link to commence the signup process.

6) The list of users - and their status and permissions - will then appear in the user account list.

 

 

Current Version and Change History

This section of the guide details the latest version of COSMOS as well as providing a full Change History of updates, features, improvement, and bug fixes.

Current Version and Change History

3.5.1 - 16/12/2020

Update to Analytical Model to allow the showing of descriptions on stakeholders when no value set

Additonal questions added to User Journey Model

Updated language files for User Journey Model added 

Current Version and Change History

3.5.0 - 14/12/2020

New 'User Journey' Model added.

Current Version and Change History

3.4.1 - 23/11/2020

New registering users are able to create their own projects

Current Version and Change History

3.4.0 - 20/11/2020

Default settings established so that email, auto save and login are enabled upon deployment.

Current Version and Change History

3.3.0 - 17/11/2020

This version of COSMOS, released on 17th November 2020, contains the following updates, changes, and improvements:

Moral Ordering Model: Option inputs relating to a single selection have been converted into free text input.

Moral Ordering Model: Text input boxes which required URL inputs only have been convered to free text input with recognition of web links - which can be followined - in the text.

Language Selection: Improved translation of Hungarian.

Current Version and Change History

3.2.4 - 17/11/2020

Moral Ordering Hungarian Language File: Further update to Hungarian language file for the Moral Ordering Model. Many thanks to Flórián Sipos (floriansipos@gmail.com).

COSMOS Videos

A selection of videos used to assist with the usage of COSMOS.

COSMOS Videos

User Guide

The following is a short video of COSMOS that provides an overview of the platform, orientation of the interface, and examples of models being used: