Skip to main content
Skip table of contents

Fan Tutorial 1 - Specify Product - Part 1

In this tutorial, we will go through one of the primary user flows that can get you started using Valispace:

  • Gather and Write Requirements

  • Breakdown Requirements

  • Review and Improve Requirements

  • Approve and Release Specifications

The first two aspects, ie “Gather and Write Requirements” and “Break down Requirements” are covered in Part 1, and the rest in part 2 of the specify product tutorial. This first tutorial will take approximately 15 -20 minutes to complete. All the values and requirements are arbitrary

(1) Create a new Project

  • In the top left corner (see Figure Creating a New Project), click on the project/workspace dropdown menu (1)

  • Verify that you are in the correct workspace. If you are not, select your workspace from below.

We recommend you to create the tutorial project in the “Training workspace”. If you are in the default workspace, you can select the “Training Workspace” and create the new project.

  • In the list of projects, scroll down and select + Create new project (2)

image-20240320-163009.png

Creating a New Project - You can create a new project by clicking on “+ Create new project“

  • Once you select this option, you will be taken to our “Quickstart” Feature (see Figure Quickstart Feature). Click on the Simple Create option for an “Empty project”

image-20240320-163302.png

Quickstart Feature - From here you can create a new project in various ways. For this Tutorial please select “Simple create“.

  • Upon clicking, you will be asked, as seen in Figure Setting up Project Name, to Enter a unique (not yet existing) project name (e.g. ValiFan_yourname) (1) and press Create Project (2). In the Project permissions, you can choose to use the same permissions as for the workspace, which means that the users who have access to the workspace will also have access to the project. You can also set up custom permissions to select the user permissions yourself. For this tutorial, you can select “Use workspace permissions (Read & Write)” for the Project Permissions.

The project name does not recognise special characters except “_' and “-”. Also spaces are not accepted.

Setting up Project Name - Here you can choose the project name and the permissions. For this tutorial leave the permissions as they are for now.

  • Now you can see the Dashboard of your project. Navigate to About (1) in the left navigation panel, and feel free to add information about your project. Here, you can also change the name of your project (2) at any time (see Figure About Project Page).

  • You can always collapse or expand the main navigation pane by clicking the arrow (3) next to it.

image-20240320-163942.png

About Project Page - Here crucial project information is displayed such as name, description, image and Start and End Date.

(2) Define Stakeholder Requirements - Import Requirements


Most design and development of systems follows the V cycle. The first process in a V cycle is understanding the business needs and eliciting the stakeholders' needs. These stakeholder needs are then converted to Stakeholder Requirements. The stakeholder's requirements can be directly created in Valispace, imported through CSV/xlsx, or even created through the AI-powered “ValiAssistant”. So for this part, we will try the import method.

We have received a file from our stakeholders and will import these requirements to Valispace.


To do that, download the following CSV file:

Valifan_stakeholder_Requirements.csv

  • Go to the Requirements Module (see Figure Requirements Module) by clicking on Requirements in the left navigation pane (1)

  • Upon entering the Requirements module, Click on the Import Requirements (2)

image-20240320-165120.png

Requirements Module - This is the Requirements Module of Valispace. Here we will upload the Stakeholder Requirements.

Once the option is selected, you can choose a specification or create one directly within the import wizard. In our case, we will create the specification within the import wizard (see Figure Import Wizard 1).

  • Select Create a Specification , type Stakeholder_requirements, and click Continue.

image-20240320-165544.png

Import Wizard 1 - In the first step we create the Specification where the Requirements are going to be stored.

The next step is to upload the CSV to let the import wizard read and import the file. Once the import is done, you can use a feature called “Valify“ which transforms text based parameters into references that store the value and the unit, also called Valis. This is shown in the video below (Import Requirements into Valispace).

During the import of requirements, we demonstrated a feature of Valispace “Valify”. After mapping the attributes and importing the requirements, you have a message screen where you can use “Check Now” to use the “Valify” feature.
The “Valify” option let you to convert the numerical values to the requirement valis automatically. Valis are design parameters of components, requirements or analyses which can be used in calculations and documentation. A Vali has a numerical value and contains additional information such as type, unit, formula, description, and minimum/max requirements.

Doing so, you can compare the requirement valis with the design vali’s from the System Design Module in future as the project progress. The you can opt to Valify or not within the importer wizard

(3) Add System Requirements

In a typical system engineering flow, the systems requirements are created with the help of the stakeholder requirements. Most technical developments are designed against strict requirements, e.g. on mass, power consumption and budget. Valispace maintains a complete overview of whether your design fulfils all these requirements.

Now we will create a few system requirements manually within valispace (see Figure Creating the Fan Specification)

  • Click on + Specification (1) and enter Fan_Specs (2) and click Create (3)

image-20240320-173152.png

Creating the Fan Specification - Manually creating a Specification in Valispace is easy.

  • In Figure Create a new requirement manually Click on Fan_Specs (1). Within this specification, click on Create Requirements(2). Alternatively, you can also click on the blue “Add requirement” button in the upper right-hand corner Add Requirement (3)

image-20240320-173740.png

Create a new requirement manually

  • In the pop-up menu, verify that you have selected the correct specification. Then, add a unique identifier (1), e.g. R-Fan-001 and type The Mass of the fan should not exceed 300g under “Requirement text” (2)

Note how the AI will automatically suggest how to improve your Requirement and you can choose whether you want to accept the suggestion or not by clicking on “Replace“.

image-20240320-174230.png

Create a new requirement manually - In here you can select the Identifier, Title, Text and even Rationale for your Requirement.

Having the tick mark on Check for possible Valis checks for the numeric values within the requirement and converts it directly into valis through the Valify feature.

  • Using the same method but without ticking Check for possible Valis, create another requirement called R-Fan-002 with the requirement text: The Mass of the propeller shall not exceed 50g.

image-20240320-174646.png

The two Fan Spec Requirements with their Valis.

For the second requirement, during the creation, we did not use “Valify” feature. In case, you don't want to valify automatically, you have the option to create valis within requirement manually. Lets see how we can do that.

Creating Requirement Valis within a requirement

  • Double-click on the text column of the requirement R-Fan-002 and delete 50g

  • Type $ on the text column, and a popup showing the list of valis/objects inside the project opens.

  • On the top right corner of the dialog box, select the option to create new

  • Input the following details. Name: req_mass_propeller, Formula and unit: 50g and Display unit: g

Creating a Requirement Vali manually - Try it out in Valispace!

Break down requirements with parent and child relationships

Observe Figure Enable Columns to see how to enable more columns in your Requirements table.

  • Click on column (1) on the right side of the table

  • Verify that the Parents and Children boxes are checked (2)

image-20240324-114128.png

Enable Columns - Verify if the parents and children columns are checked

  • In the requirements table, find the second requirement you created called R-Fan-002. In the parents column, double-click on cell (1)

  • In the drop-down menu, type in R-Fan-001 to link both requirements. Note that the children are automatically added to the requirement R-Fan-001

image-20240324-114433.png

Creating parent-child relationship - By double-clicking on either Parents or Children, you can assign inheritance between requirements.

  • By clicking on the Connections Graph(2) tab found at the top centre of the requirements table, you can see and verify this relationship (see Figure Connection Graph)

Connections Graph - The Connection Graph shows the parent-child relationship of the selected Specification. Blue boxes around the Requirements indicated the Specification they are in.

Try this : You can generate requirements/breakdown requirements through the ValiAssistant. For example, Click on the ValiAssitant, choose the option Generate Requirements, and type a prompt like Create 2 safety requirements for designing a fan.

Remember that ValiAssistant is powered by an LLM (Large Language Model) and results on the generated requirements may vary.

The steps are shown below in the Tutorial:

Generating Safety Requirements through the Valiassistant with a Prompt.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.