Getting started

From LabRPS Documentation
Revision as of 09:00, 29 October 2024 by LabRPS (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

Foreword

LabRPS is a computation tool for the numerical simulation of random phenomena. It is designed for Researchers, Scientics, Engineers, Students and others who need to numerically represent a random phenomenon. Currently, three phenomena are implemented in LabRPS:

  1. Stochastic wind velocity
  2. Seismic ground motion
  3. Sea surface

LabRPS has been under development since 2015, and it offers a large list of features. Capabilities are still missing but it is powerful enough to be used. There is a fast-growing community of enthusiastic users who participate in the LabRPS forum, and you can find many examples of quality projects developed with LabRPS there.

Like all free software projects, LabRPS depends on its community to grow, gain features, and fix bugs. Don't forget this when using LabRPS; if you like it, you can donate and help LabRPS in various ways, such as writing documentation.

See also:

Installing

First of all, download and install LabRPS. See the Download page for information on current versions and updates, and the installation instructions for you operating system (Windows, Linux or Mac). There are install packages ready for Windows (.msi), Debian and Ubuntu (.deb), openSUSE (.rpm), and Mac OSX. LabRPS is available from the package managers of many other Linux distributions. A standalone AppImage executable is also available, which will run on most recent 64-bit Linux systems. As LabRPS is open-source, you can also grab the source code and compile it yourself.

Exploring the interface

LabRPS interface base divisions.png

The standard LabRPS interface

See a full explanation in Interface.

1. The main view area, which can contain different tabbed windows.
2. The graph view, showing the graphical representation of the simulation data or any data involved in the application.
3. The combo view (tree view, task panel and property editor), showing the hierarchy and construction history of objects in the document and also allow the user to run tasks for active commands.
4. The selection view, which indicates the objects or sub-elements of objects that are selected.
5. The report view (or output window), where messages, warnings and errors are shown.
6. The Python console, where all the commands executed are printed, and where you can enter Python code.
7. The project explorer, shows all tables, matrices and plots created in the application.
8. The result log, where the simulation results, analysis results and informations are displayed.
9. The status bar, where some messages and tooltips appear.
10. The plot property editor, allows viewing and modifying properties of the items such as tables, matrices and plots in the active view.
11. The standard menu, which holds basic operations of the program.
12. The toolbar area, where the toolbars are docked.
13. The workbench selector, where you select the active workbench.

The Start page allows you to quickly jump to one of the most common workbenches, open one of the recent files, or see the latest news from the LabRPS world. You can change the default workbench in the preferences.

First steps with LabRPS

LabRPS's focus is to allow you to numerically generate random phenomena in an accuarate and realistic way, to allow researchers quicky developing new simulation tools. It is therefore very different from some other applications made for similar purposes. Its learning curve is made very short. If you are struck at some point, don't forget that the friendly community of users on the LabRPS forum might be able to get you out in no time.

The plugin you will start working with in LabRPS depends on the type of random phenomenon you need to simulate. If you are going to work on random wind velocity, you'll probably want to activate the WindLab Workbench. If you are going to work on seismic ground motion, then switch to the SeismicLab Workbench.

Working with WindLab

WindLab is a module in LabRPS that provides and manages all LabRPS's capabilities for the simulation of stochastic wind velocity. This module is automatically actived when you active the WindLab Workbench. Don't confuse WindLab and WindLab Plugin. WindLab, also called WindLab Workbench is LabRPS internal module providing the simulation framework of random wind velocity while WindLab Plugin is one of the offical plugins provided by LabRPS for simulation of random wind velocity. This is a typical WindLab workflow:

  1. Create new wind velocity simulation
  2. Edit the properties of newly created wind velocity simulation to switch your need.
  3. Create new WindLab feature (simulation points, mean wind profile, wind spectrum, etc.)
  4. Right click on the created feature in the tree view and select action to run the feature and show computation results.

Scripting

And finally, one of the most powerful features of LabRPS is the scripting environment. From the integrated python console (or from any other external Python script), you can gain access to almost any part of LabRPS, create or modify RPS features or access and modify the LabRPS interface. Python scripting can also be used in macros, which provide an easy method to create custom commands.