This tutorial will give you a very brief non-scientific overview on the controls of Un-Code.
For deep knowledge about the science behind this application, please refer to the book publication of Gerrits/Marks 2017.


Creating an account

First you will have to create yourself an user account at the starting page. All data or sources you input are only visible by this account. Please choose a secure password. Your password is stored heavily encrypted in the database. After you’ve created the account and logged in, you are ready to go.

Accounts are absolutely free. Un-Code is an open source software for scientists and interested individuals.

Note: If you want to just have a first look upon the software, you can use our demo account. Login: demo – Password: uncode. Please note that any changes to the demo account will be reset automatically, so don’t use it for any serious work.


Creating a study and a lineage

Data is structured in (case) studies and lineages. After creating a case study, you need to create one of more lineages. Lineages are basically sub-cases – narratives of how a case is developing, such as conceptional phase, implementation phase, etc. However, dividing the case into lineages is optional – you can of course also just work with one lineage within the study.

Creating fields and actors

Now you can create fields for your lineage. Lineages consist of multiple fields. Fields are means of structuring the data towards the time dimension of lineages. To create a field, click on Add“  in the list of fields and enter a field name. Every lineage needs to have a starting date and an end date. Time spans of different fields must not overlap. After entering the dates, click on „Save data“ or press F2 on your keyboard. At the bottom, you can also upload source documents to the web server (any format, such as pdf).

Actors are created the same way as fields. If an actor is not present in specific fields (i.e. just entering the lineage later or leaving the lineage earlier), check the box „Actor is not present in this Field“.

Entering PSD data (Problem-Solution-Definitions)

After you have created the fields and actors, it would be plausible to now assign problem and solution definitions to each actor at each point in time.

To make it easier for the user, you can first create a pool of problem-definitions and solution-definitions with the „add“ button. Don’t forget to save your input by using the F2 key or Save button. All definitions in the pool are available everywhere in the lineage. Now you can easily assign definitions to each actor at each point in time by simply using the arrows in the middle of the screen to move a definition from the main pool to the specific actor. This means that an actor at this point in time shares a problem or solution definition.


Connections and fitness

To calculate the connectedness, it is important to set which actor is connected with whom for each field. This can be done using the connection table with the button „set starting connections“. The fitness value can be entered below.

Output and Visualization

You can visualize your case using the 3D Visualization (button „visualize“). For system requirements see here. A dedicated graphics card and a fast cpu is recommended for best performance. You can select any combination of fields and actors (using the ctrl or shift buttons). The visualization will dynamically load data from the database, calculate it and present it visually. Play around with the different visulization options to get a feeling of how it works. In the case of problems, reloading the page (F5) might help.

Another possibility of visualization is the „Show PSD Persistance“ button, where you can create an Excel sheet presenting the development, rise and fall, of definitions throughout the lineage.