User Manual for CubicOne 1m3 Test System

Based on CubicOne v1.0.3, Nov. 2016 EDIT 1.0



1.1 About 1 m3 Test Device

A 1m3 test device contains a 1 m3 large steel structure test chamber for dust/gas explosion experiments, along with sensors, control bus and other hardware parts.

1.2 CubicOne: Software as a Desktop Test System

CubicOne is a software who helps to control data acquisition (DAQ) process, manage test projects & records and view record graphs. It runs on PC desktop with graphic user interface. Users can operate with mouse and keyboard.

CubicOne is a GREEN software, meaning you can just copy the entire application folder anywhere on your computer and it works the same.

Since CubicOne is under maintenance, more functionalities and bug fixes will be added in future versions, and software UI layout might be changed. Please check the edition of this manual (on the title page) to confirm it is applied to your version of CubicOne.

1.3 System Requirements

1.3.1 Hardware Requirements

1.3.2 Software Requirements

1.4 Terms

1.4.1 Operation Terms

1.4.2 Project Terms

1.4.3 Record Terms


2.1 Main Window

Once CubicOne is started, the MAIN WINDOW is shown like Figure 1. This window has 4 parts mainly in the layout: menu, toolbar, operation zone, and status bar.

Figure 1 CubicOne main window

When a project is open or create, the operation zone will be filled with a tab panel which contains 2 pages.

The first page is CONTROL PANEL, shown as Figure 2. In the top part of this page is a button and a progress bar. The button (icon as ) works just like menu item ‘Operation – Prepare Record’ or ‘Operation – Cancel Record’.

Figure 2 Main window - control panel

The second page is PROJECT SETTING, shown as Figure 3. In the project setting page you can edit properties of the opened project. The records of the project are listed in the Test Records part.

Figure 3 Main window – project setting view

Note: All changes made on project properties are automatically saved when project is closed or exiting the application.

2.1.1 Menu

Menu items and corresponding functions are listed in Table 1.

Table 1 Main menu items and their function

New Project Create a new project.
Open Project Open existing project.
Save Project Save opened project manually when unsaved changes have been made.
Save Project As Save opened project as a new one with a brand new project name.
Close Project Close current opened project.
Manage Project Open the dialog where user can manage (delete/import/export) all existing projects.
Connect Device Connect with test device.
Disconnect Device Disconnect from test device.
Prepare Record Make system wait for DAQ trigger signal.
Cancel Record Make system stop waiting for DAQ trigger signal.
Available only when preparing record.
Application Config Open application configuration dialog so that user can modify options to change system behaviors, such as font size, connection strategy, DAQ configuration, etc.
See section 2.4 for more details.
Manual Open manual document.
Online Help Start web browser and navigate to online help page.
About Open the dialog that supplies basic information about the application.

2.1.2 Toolbar

Toolbar contains several buttons. Each button works as a short cut to a menu item function. The relation of each button and its relative menu item is shown as Table 2.

Table 2 Main window toolbar buttons

Files - New Project
Files – Open Project
Files – Save Project
Files – Save Project As…
Help - Manual

2.1.3 Test Records Part

In the main window project setting page there is 'Test Records' part where existing records of the project are list and some operating entries are accessible. As shown in Figure 4.

Figure 4 Test record operation part

For each item listed in the records part, there are 3 buttons: Record Properties, View Curve and Delete. 'Record Properties' button opens record properties editing dialog (see section 3.2.3); 'View Curve' button opens record curve window to display data in plot (see section 2.2 and 3.2.4); 'Delete' button removes selected record from the project.

Note: Deleting a record is irreversible. The record collection of a project is automatically saved.

2.2 Curve Window

By clicking 'View Curve' button in a record list item, the record curve window shows. Figure 5 demonstrated how a record data is displayed in the curve window.

The window consists of 2 parts: Toolbar and Curve Plot.

Figure 5 Record curve window with DEMO data.

2.2.1 Toolbar

Toolbar contains 3 buttons. Each button and its function are listed in Table 3.

Table 3 Curve window toolbar buttons.

Save image as PNG/XAML/EMF format.
Export data to a CSV file.
Open curve configuration dialog to change data post-procedure strategy and display behavior.

2.2.2 Curve Plot

The curve plot takes most of area of curve window interface as you can see in Figure 5. It has a title 'Explosion Curve' in bold style, 3 axes with label and unit, and the main plot panel in which lay the data curves, guiding lines and peek value annotations.

Plot title text cannot be changed, and its font size is not affected by application font size setting (see section 2.4 to know about application configuration setting).

The 3 axes are: the time axis on the bottom, the pressure axis on the left and the temperature axis on the right. In a single test record the counts of 2 curve types is determined by application DAQ configuration. All pressure curves belong to PRESSURE AXIS, while temperature curves belong to TEMPERATURE AXIS.

For each type of curve, if there is only 1 curve of that type in the record, guiding lines are drawn to indicate the position of Pex and slope.

The peek value annotations show the peek values of data. Pressure peek value is on the top left corner, and temperature on the top right corner.

2.3 Curve Configuration

Click curve configuration button (the 3rd in Table 3), the curve configuration dialog will open. The dialog includes 3 pages, looking like Figure 6 ~ Figure 8.

In visibility setting page, you can choose to hide specified channel curve by uncheck its corresponding item.

Figure 6 Curve configurations - visibility of curves.

In peek searching parameter setting page, you can set relevant parameters for pressure and temperature data separately. For each quantity there are 4 parameters:

Figure 7 Curve configurations - peek value searching parameters.

In axis range setting page, you can set the minimum and maximum values of axis range.

Figure 8 Curve configurations - display ranges of axes

Note: After making the changes, click Finish button to save. If you click the closing button on the top right corner of the window, all changes will be discarded.

2.4 Application Configuration

Click menu item 'Help - Application Config' to open application configuration dialog. The dialog interface is shown in Figure 9 ~ Figure 10.

Figure 9 Application configuration - system common settings.

Figure 10 Application configuration - DAQ settings.

There are 2 pages of configurations. The 'System' page contains system common setting items explained in Table 4, and the 'DAQ' page is used for data acquisition configuration.

Table 4 Application common setting items.

Item Explain
Language System language. Need to restart application to take effect.
Connect device automatically on startup Check this option if you want application connect with test device automatically. Need to restart application to take effect.
System font size UI font size.

Generally a DAQ device has several channels, and one and only one of them must be used as trigger channel. A trigger channel listens to the trigger voltage signal. Once the signal is found, the acquisition process begins, and data is fetched from other quantity channels.

The raw data from DAQ device is usually not what we want, because it is voltage or current. To transform raw data unit to pressure or temperature, we need 'Trans. Ratio' and 'Trans. Interc. '. Target value is calculated with the equation as below:

value = Ratio*raw + Interc

All DAQ setting items are explained in Table 5.

Table 5 Application DAQ setting items.

Item Explain
Sample Rate per Ch. Sample rate per channel. Sample rate is the data count per sec. In Hz.
Sample Count per Ch. The total amount of data for each channel.
Trigger Vol. Trigger signal voltage. DAQ begins when trigger channel voltage is higher than this value.
Trigger Monitor Interval Clock interval for monitoring trigger signal.
Channel ID The ID of a channel, given by system, cannot be changed.
Channel Type Channel type could be one of the four: Trigger Channel, Pressure Sensor, Temperature Sensor or Unused.
Trans. Ratio Used to transform raw data to pressure or temperature.
Trans. Interc. Used to transform raw data to pressure or temperature.

2.5 File System

CubicOne save all project and record data in a self-maintained folder:

[My Documents]/EnvSafe/CubicOne

Although CubicOne is a green software, this self-maintained data folder is irrelevant with application execution folder.

The data folder has a subdirectory - 'logs'. Application logs are saved in this directory.

Warning: DO NOT modify data folder nor any files in it.


3.1 Project Operation

3.1.1 Create Project

To create a new project, first save opened project if necessary, then click menu item 'Files - New Project', choose YES if confirmation message pops up. Once a new project is created, the main window project setting page will be updated, and the main window operation zone turns accessible. You would notice all the project field are set as their default values.

Note that just creating a new project doesn't automatically save it. You have to SAVE the project for long time use.

3.1.2 Open Project

Instead of creating a new project, you can open an existing project that was created before. If there is already an opened/created project under operation, save it as necessary, then click menu item 'Files - Open Project', in the opened dialog (shown in Figure 11) choose the project item you want to open, then click 'OK'. Once a project is opened, the main window project setting page will be updated, and the main window operation zone turns accessible.

Figure 11 Open project dialog.

3.1.3 Save Project

Click menu item 'Files - Save Project' to save an opened or new created project after making changes. Saving an existing project will overwrite the old local file to store latest contents. Saving a new created project is equivalent to 'SAVE PROJECT AS' the project.

Click menu item 'Files - Save Project As…' to save an opened or new created project with a new given project name. When doing this a dialog will pop up as shown in Figure 12. Fill the project name and click 'Save' to confirm.

Figure 12 Saving project dialog when saving new created project or saving an opened project as a new one.

Note: You CANNOT change a project name after it was saved. However, to save it as a new project and then delete the old achieves the same goal.

3.1.4 Close Project

To close opened project, click menu item 'Files - Close Project', then the operation zone of main window becomes unfilled blank.

After the project is closed, some system operations turn enabled, such as PROJECTS MANAGEMENT.

3.1.5 Manage Projects

Click menu item 'Files - Manage Project' and Projects Management dialog will show up. In this dialog existing projects are listed, you can delete them, export a project as a C1E (CubicOne exported) file, or import projects from C1E files. The dialog looks like in Figure 13.

Figure 13 Projects management dialog.

Note: Remember projects management is DISABLED when a project is opened, so you have to close project to use it.

3.2 Record Operation

3.2.1 New Test

If a project is opened, the control panel in main window becomes visible and menu item 'Operation - Prepare Record' becomes enabled. Click Prepare Record button in the control panel or menu item 'Files - Prepare Record', New Record dialog pops up, as shown in Figure 14. Fill the record information and click 'Save', system turns into a state waiting for DAQ trigger signal. While waiting for trigger signal, a progress bar displays DAQ status in control panel as Figure 15 shows. At the meanwhile, Prepare Record button becomes Cancel Record button, menu item 'Operation - Cancel Record' is enabled.

When DAQ process finishes, a new record is added into the project, and its record list would be updated.

If you choose to cancel at any step of this process, the action of creating new test record will be aborted.

Figure 14 New Record dialog with empty record information.

Figure 15 Progress bar in control panel during DAQ process.

Note: Once a record is created its ID can NO LONGER be changed. Yet other record properties can be edited, see section 3.2.3.

3.2.2 Manage Records

Once a project is opened, all its records are listed in main window - project setting page - test record part. See section 2.1.3 as reference.

3.2.3 Edit Record Properties

Once a project is opened, all its records are listed in main window - project setting page - test record part. For each record item in the list, you can open the Edit Record dialog by clicking 'Record Properties' button. The dialog is shown in Figure 16.

Note: All changes on record properties are automatically saved when closing the edit dialog.

Figure 16 Edit Record dialog.

3.2.4 View Curve

Once a project is opened, all its records are listed in main window - project setting page - test record part. For each record item in the list, you can open curve window by clicking 'View Curve' button.

Curve window is introduced in section 2.2, curve configuration setting is introduced in section 2.3.