Set up and use your workspace in jinkō

The jinkō platform offers a structured and collaborative approach to in-silico modeling. The steps below provide an overview of the platform structure, so you can quickly get started with your first project.

Step 1: create your first groups and projects

In jinkō, you can organize your work using 3 different levels of granularity :

• Groups : a group is where you can create project(s) and share their content with your team and external stakeholders. Other teammates invite you to a group.
• Projects : projects are organized in a group and contain all the research and assets (scientific literature, models, documentation, virtual population, trials, data visualizations...) associated with your simulated trial. You can be invited to a specific project in a group.
• Folders (see step 4) : in projects, all your assets can be organized in custom folders.

-> Let's create your first project from your Dashboard:

• Create a group (optional, you can also use your existing group(s) should you have been invited to one, or should you previoulsy have created one)
• Add a project to your group
• Open your project, you can now see your project home, in which you will be able to organize your folders (see step 4)

Step 2: edit your groups and / or project settings and manage users

You can manage various settings in jinkō for your groups and projects, mainly to configure their general appearance, add members to them and manage their access level:

There are in jinkō 5 levels of access that can be granted to users. Access can be given at Group level or Project level (note that if a user is given an access at the group level, his access level is automatically applied at the project level) :

• Admin: is the owner of the project, can add and edit other members, including creating other admins. Admins have every rights (create, edit, delete) on any item in the projects, whether they created it or not. There is always at least 1 admin per group or project. 
• Editor: is a contributor to the project, can create editors and viewer or commenter members, has the rights to create antd edit items in the project.
• Explorer: is a user able to create, edit and comment any item in a project, but cannot edit items created by other users in the project.
• Commenter: is a user that can view and comment any items in the project.
• Viewer: can only view items in the projects.

Step 3: create items in jinkō

The jinkō platform allows for the creation of a complete range of items necessary for the completion of an in-silico modeling project. Those items can be categorized as such (Note that you can learn more on each of these items on this tutorial on a typical in-silico project workflow using jinkō):

• Knowledge & reporting: you can upload in jinkō references from which it is possible to create pinpointed section of interest, called extracts, thus centralizing the scientific foundations behind your models. With the document editor, you create various reports as well as the model documentation.  

• Modeling & Simulation: a full range of dedicated features to create your models and run a simulated trial. This covers the model itself, output sets, virtual populations protocols, and the trial editor / launcher. 

• Results analysis: observe, group and filters your trial results with a suite of pre-built data analysis used to visualize clinical outcomes. 

You can create new items at any time in jinkō from the 'Create new' main button on your left side navigation bar.

Step 4: organize your work in folders

You can organize your projects into different folders, to categorize your items into a defined structure, that you can customize according to your preferences.

Note: it is possible to add an item into different folders.

Step 5: browse through your items: project home, right-side panel, filters and search engine

The project home is where the items you created are listed and can be browsed. You will notice a few elements:

• Quick access: they are the items you edited last and / or the most frequently. They appear at the top of the project homepage as a shortcut.
• Folders listing: right underneath the quick access section are listed the different folders created in the project, that you can browse to explore your items.
• In each folder (or at the root of the project homepage for items not moved into specific folders), are the list of related items. A click on these items will open them.

You will also notice a right-side panel. This sidebar is used throughout your project and provides information about your items as well as specific features, depending on the items you are working on. This is also where you can start conversations with your team on an item.

In order to find your items faster, you can also make use of filters and of the search engine (available on your project home, folders and on the 'search all items' page):

• you can apply single or multiple filters at once to your items, to sort them by type.
• The search engine can be used to find specific items, searching them per name or terms in their descriptions, or per their author name.  

You are now ready to start your first project with jinkō! To complete this reading, we suggest that you consult our article on jinko's core concepts and typical project workflows using jinkō.