Getting started: Difference between revisions
Jump to navigation
Jump to search
User documentation
No edit summary |
|||
| (One intermediate revision by the same user not shown) | |||
| Line 1: | Line 1: | ||
{{Docnav | {{Docnav | ||
|[[ | |[[Installing_on_Mac|Installing on Mac]] | ||
|[[ | |[[Document_structure|Document structure]] | ||
}} | }} | ||
| Line 8: | Line 8: | ||
==Foreword== | ==Foreword== | ||
LabRPS is a computation tool for the [[About_LabRPS|numerical simulation of random phenomena]]. It is | LabRPS is a computation tool for the [[About_LabRPS|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: | ||
# Stochastic wind velocity | |||
# Seismic ground motion | |||
# Sea surface | |||
LabRPS has been under development since 2015, and it offers a large list of [[Feature_list|features]]. Capabilities are still missing but it is powerful enough | LabRPS has been under development since 2015, and it offers a large list of [[Feature_list|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 [https://labrps.com/boards LabRPS forum], and you can find [https://labrps.com/boards 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|donate]] and [[Help_LabRPS|help LabRPS]] in various ways, such as writing documentation. | 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|donate]] and [[Help_LabRPS|help LabRPS]] in various ways, such as writing documentation. | ||
| Line 25: | Line 28: | ||
==Exploring the interface== | ==Exploring the interface== | ||
[[File:LabRPS_interface_base_divisions. | [[File:LabRPS_interface_base_divisions.png|1024px]] | ||
{{Caption|The standard LabRPS interface}} | {{Caption|The standard LabRPS interface}} | ||
| Line 31: | Line 34: | ||
{{Emphasis|See a full explanation in [[Interface|Interface]].}} | {{Emphasis|See a full explanation in [[Interface|Interface]].}} | ||
:1. The [[main_view_area|main view area]], which can contain different tabbed windows. | :1. The [[main_view_area|main view area]], which can contain different tabbed windows. | ||
:2. The [[ | :2. The [[Dependency_graph_view|graph view]], showing the graphical representation of the simulation data or any data involved in the application. | ||
:3. The [[ | :3. The [[combo_view|combo view]] ([[tree_view|tree view]], [[task_panel|task panel]] and [[property_editor|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|selection view]], which indicates the objects or sub-elements of objects that are selected. | |||
: | :5. The [[report_view|report view]] (or output window), where messages, warnings and errors are shown. | ||
: | :6. The [[Python_console|Python console]], where all the commands executed are printed, and where you can enter [[Python|Python]] code. | ||
: | :7. The [[Plot_explorer|project explorer]], shows all tables, matrices and plots created in the application. | ||
:8. The [[ | :8. The [[Pesult_view|result log]], where the simulation results, analysis results and informations are displayed. | ||
:9. The [[ | :9. The [[status_bar|status bar]], where some messages and tooltips appear. | ||
:10. The [[ | :10. The [[Plot_editor|plot property editor]], allows viewing and modifying properties of the items such as tables, matrices and plots in the active view. | ||
:11. The toolbar area, where the toolbars are docked. | :11. The [[Standard_Menu|standard menu]], which holds basic operations of the program. | ||
: | :12. The toolbar area, where the toolbars are docked. | ||
:13. The [[Std_Workbench|workbench selector]], where you select the active [[workbenches|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_Editor|preferences]]. | |||
The Start page allows you to quickly jump to | |||
==First steps with LabRPS== | ==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 | 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 [https://labrps.com/boards 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|WindLab Workbench]]. If you are going to work on seismic ground motion, then switch to the [[SeismicLab_Workbench|SeismicLab Workbench]]. | |||
==Working with WindLab== | ==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 | 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|WindLab Workbench]]. Don't confuse [[WindLab_Workbench|WindLab]] and [[WindLab_Plugin|WindLab Plugin]]. WindLab, also called [[WindLab_Workbench|WindLab Workbench]] is LabRPS internal module providing the simulation framework of random wind velocity while [[WindLab_Plugin|WindLab Plugin]] is one of the offical plugins provided by LabRPS for simulation of random wind velocity. | ||
Don't confuse WindLab and | |||
This is a typical WindLab workflow: | This is a typical WindLab workflow: | ||
# | # Create new [[WindLab_New|wind velocity simulation]] | ||
# | # Edit the properties of newly created wind velocity simulation to switch your need. | ||
# Create new [[WindLab_NewFeature|WindLab feature]] (simulation points, mean wind profile, wind spectrum, etc.) | |||
# | # Right click on the created feature in the [[tree_view|tree view]] and select action to run the feature and show computation results. | ||
# | |||
[[ | |||
==Scripting== | ==Scripting== | ||
And finally, one of the most powerful features of LabRPS is the [[ | And finally, one of the most powerful features of LabRPS is the [[Power_users_hub#Scripting_in_LabRPS|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|macros]], which provide an easy method to create custom commands. | ||
{{Docnav | {{Docnav | ||
|[[ | |[[Installing_on_Mac|Installing on Mac]] | ||
|[[ | |[[Document_structure|Document structure]] | ||
}} | }} | ||
Latest revision as of 09:00, 29 October 2024
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:
- Stochastic wind velocity
- Seismic ground motion
- 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
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:
- Create new wind velocity simulation
- Edit the properties of newly created wind velocity simulation to switch your need.
- Create new WindLab feature (simulation points, mean wind profile, wind spectrum, etc.)
- 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.
User documentation
- Getting started
- Installation: Download, Windows, Linux, Mac, Additional components, AppImage
- Basics: About LabRPS, Interface, RPS Objects, Object name, Preferences, Workbenches, Document structure, Properties, Help LabRPS, Donate
- Hubs: User hub, Power users hub, Developer hub