This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
tutorials:t1 [2019/07/17 15:10] – [Quick access bar] pwarczok | tutorials:t1 [2023/12/01 19:47] (current) – [Screen layout] pwarczok | ||
---|---|---|---|
Line 2: | Line 2: | ||
//This tutorial was tested on \\ | //This tutorial was tested on \\ | ||
- | MatCalc version 6.02 rel 1.003 \\ | + | MatCalc version 6.04 rel 1.001 \\ |
license: free \\ | license: free \\ | ||
database: none // | database: none // | ||
- | This first tutorial provides a brief tour of MatCalc' | + | This first tutorial provides a brief tour of MatCalc' |
==== Contents ==== | ==== Contents ==== | ||
Line 13: | Line 12: | ||
* Menus and toolbar | * Menus and toolbar | ||
* Console window | * Console window | ||
- | * Command history | ||
* Configuring the layout of the GUI | * Configuring the layout of the GUI | ||
* The ' | * The ' | ||
Line 28: | Line 26: | ||
When MatCalc is first opened, the screen appears as shown below (Windows version). | When MatCalc is first opened, the screen appears as shown below (Windows version). | ||
- | {{ : | + | {{ : |
The table below gives brief descriptions of the different areas of the screen. | The table below gives brief descriptions of the different areas of the screen. | ||
Line 35: | Line 33: | ||
^ Toolbar| Icons giving quick access to frequently used functions (see [[tutorials: | ^ Toolbar| Icons giving quick access to frequently used functions (see [[tutorials: | ||
^ Quick access bar| Icons giving quick access to window management options (see [[tutorials: | ^ Quick access bar| Icons giving quick access to window management options (see [[tutorials: | ||
- | ^ Console| This window has an area for entering command-lines and an area that shows output from calculations and other operations; more information is given [[tutorials: | + | ^ Console| This window has an area that shows output from calculations and other operations, as well, as an area for entering command-lines; more information is given [[tutorials: |
^ Options window| Context-sensitive options to change the way information is displayed. [[tutorials: | ^ Options window| Context-sensitive options to change the way information is displayed. [[tutorials: | ||
^ Variables window| A list of MatCalc' | ^ Variables window| A list of MatCalc' | ||
- | ^ Information on variables| Notes on the currently highlighted entry in the variables window (meaning of variable, units, etc.).| | ||
^ Nodes window| List of nodes used in simulation. Multiple nodes are used in advanced calculations. | | ^ Nodes window| List of nodes used in simulation. Multiple nodes are used in advanced calculations. | | ||
^ Status bar | Gives information on the current state of the system (temperature, | ^ Status bar | Gives information on the current state of the system (temperature, | ||
Line 47: | Line 44: | ||
As with any typical GUI application, | As with any typical GUI application, | ||
- | ^ **File** | opening, saving and closing files (see **' | + | ^ **File** |
- | ^ **Edit** | text-editing commands such as undo, redo, cut, copy, paste | | + | ^ **Edit** |
- | ^ **Global** | commands for setting up the system (see [[tutorials: | + | ^ **Global** |
- | ^ **Calc** | commands for the most frequent types of calculation (see [[tutorials: | + | ^ **Calc** |
- | ^ **Simulation, Monte Carlo, Regions** | commands for starting | + | ^ ** Cells, Monte Carlo ** | commands for starting calculation |
- | ^ **Script** | to run scripts (more on this in [[tutorials: | + | ^ **Script** |
- | ^ **View** | to configure the GUI and create new windows for the display of results (see [[tutorials: | + | ^ **View** |
- | ^ **Help** | see [[tutorials: | + | ^ **Help** |
- | Comprehensive information about the menu items can be found in the [[reference: | + | On platforms running under MacOS an additional menu **mcg** is also present. |
==== Toolbars ==== | ==== Toolbars ==== | ||
The toolbar area contains a number of icon groups: | The toolbar area contains a number of icon groups: | ||
- | **File etc** | + | == File == |
- | {{: | + | {{: |
- | L-R : New, open, save, close workspace, print, | + | L-R : New, open, save, close workspace, print, |
- | **Working directory and script** | + | == Working directory and script |
- | {{: | + | {{: |
- | L-R: browse working directory, run script | + | L-R: select working directory, |
- | **Edit** | + | == Edit == |
- | {{: | + | {{: |
L-R: Undo, redo, cut, copy, paste, find | L-R: Undo, redo, cut, copy, paste, find | ||
- | **Calculation** | + | == Calculation |
- | {{: | + | {{: |
L-R: Stop current action, single equilibrium, | L-R: Stop current action, single equilibrium, | ||
- | **Manage windows** | + | == Manage windows |
- | {{: | + | {{: |
- | L-R: Show/hide console, create new output window | + | L-R: Show/hide console, create new output window, create new plot window (p1-type) |
+ | |||
+ | === Managing toolbar elements === | ||
Right-clicking on the toolbar area gives a menu allowing the user to control which windows and which icon groups are to be displayed on the screen: | Right-clicking on the toolbar area gives a menu allowing the user to control which windows and which icon groups are to be displayed on the screen: | ||
- | {{: | + | {{: |
==== Quick access bar ==== | ==== Quick access bar ==== | ||
Line 104: | Line 103: | ||
^ {{ : | ^ {{ : | ||
^ {{ : | ^ {{ : | ||
+ | ^ {{ : | ||
^ {{ : | ^ {{ : | ||
^ {{ : | ^ {{ : | ||
^ {{ : | ^ {{ : | ||
^ {{ : | ^ {{ : | ||
- | ^ {{ : | + | ^ {{ : |
- | ==== Console ==== | ||
- | |||
- | This window allows command-line input, as an alternative to using the graphical controls. Commands can also be grouped into script files, for easier and more rapid execution of repetitive or complex tasks. More on the console, command-line syntax and scripts will be found in [[tutorials: | ||
- | |||
- | MatCalc 6 uses a new formalism for the command-line input. While commands used in the scripts for the older versions are recognized by the current version, the old command formalism is to be typed in **' | ||
- | |||
- | ==== Command history ==== | ||
- | |||
- | The command history window can be made to appear by selecting the console window and either clicking on the up-arrow icon or pressing **Ctrl + up-arrow**. This window gives a chronological list of all the commands entered in the Console. | ||
- | |||
- | {{: | ||
- | |||
- | A command can be selected using the mouse pointer or arrow keys. Right-clicking on the command displays the following menu. On the right-hand side of the menus in MatCalc are keyboard shortcuts for the more commonly used commands. It can be seen from the image below that it is sufficient to press the **Enter** key to execute the selected command. | ||
- | |||
- | {{: | ||
- | |||
- | Previously used commands can also be accessed in the Console window itself; pressing the up-arrow key displays the most recently entered command, and pressing it repeatedly scrolls through recent commands in reverse chronological order. The command displayed can be edited then executed by pressing the **Enter** key. | ||
==== Configuring the layout ==== | ==== Configuring the layout ==== | ||
- | In addition to the display options described above, icon groups and the Options, Variables, Nodes and Console windows can be detached from their locations and rearranged as desired by dragging and dropping. In this case, they are given title bars similar to that of the **MatCalc console**. The Console, Options, Variables and Command History windows can also be attached to or detached from the left-hand column area as required. | + | In addition to the display options described above, icon groups and the 'Options', 'Variables', 'Nodes' |
=== Menu bar right-click menu === | === Menu bar right-click menu === | ||
- | Right-clicking on the menu bar brings up a menu allowing the user to show or hide menu icon groups and windows as described above. | + | Right-clicking on the menu bar brings up a menu allowing the user to show or hide menu icon groups and windows as described |
=== View > Show === | === View > Show === | ||
- | Enables the following windows to be displayed or hidden: console (F4), options (F3), variables (F2), node manager (Shift + F5) | + | Enables the following windows to be displayed or hidden: |
+ | |||
+ | {{: | ||
=== View > Select window font === | === View > Select window font === | ||
- | Here the user can select an alternative font/font size for the display of numerical output. This does not affect the appearance of the console, nodes, options and variables windows. | + | Here the user can select an alternative font/font size for the display of numerical output. This does not affect the appearance of the 'console', 'nodes', 'options' |
+ | |||
+ | {{: | ||
+ | |||
+ | {{: | ||
=== View > Select application style === | === View > Select application style === | ||
The overall appearance of MatCalc can be modified here. The different options offer a greater or lesser degree of free space around text items, stronger or more subtle contrast etc. - experiment until you find an option that suits you. | The overall appearance of MatCalc can be modified here. The different options offer a greater or lesser degree of free space around text items, stronger or more subtle contrast etc. - experiment until you find an option that suits you. | ||
+ | |||
+ | {{: | ||
+ | |||
+ | {{: | ||
=== View > Display window IDs === | === View > Display window IDs === | ||
Line 157: | Line 151: | ||
Restores all windows to their default positions. | Restores all windows to their default positions. | ||
+ | |||
+ | {{: | ||
=== View > Windows === | === View > Windows === | ||
Line 164: | Line 160: | ||
===== File operations ===== | ===== File operations ===== | ||
+ | Having inspected most GUI elements, let’s have some interaction with MatCalc. In this section, a MatCalc workspace will be handled. A working directory will be specified also. | ||
==== The ' | ==== The ' | ||
Line 172: | Line 169: | ||
==== Creating a new workspace file ==== | ==== Creating a new workspace file ==== | ||
- | The **workspace** is the basic file type in MatCalc. It contains all the necessary information on the calculation or series of calculations | + | The **workspace** is the basic element for any activity |
+ | |||
+ | To create a new workspace, do one of the following: | ||
+ | |||
+ | * Click on the {{: | ||
+ | * Click on **' | ||
+ | |||
+ | {{: | ||
+ | |||
+ | * Press **Ctrl + N** on the keyboard | ||
+ | * Click on the {{: | ||
- | Click on the {{: | + | The following dialogue box will appear (except when clicked |
{{: | {{: | ||
- | Select **MatCalc workspace** from the drop-box. This runs a script file called **autonew.mcs**, | + | Select **'MatCalc workspace'** from the drop-down list. This runs a script file called **autonew.mcs**, |
- | {{: | + | {{: |
==== Working directory ==== | ==== Working directory ==== | ||
- | The **working directory** is the directory opened by default when saving | + | The **working directory** is the directory opened by default when MatCalc is saving |
{{: | {{: | ||
Line 198: | Line 205: | ||
==== Adding workspace information ==== | ==== Adding workspace information ==== | ||
- | Clicking on **Workspace info...** opens a box in which information about the current workspace can be entered. This is useful for details of the assumptions used in the calculation, | + | Clicking on **Workspace info...** in menu **File** opens a box in which information about the current workspace can be entered. This is useful for details of the assumptions used in the calculation, |
+ | |||
+ | {{: | ||
- | {{: | + | {{: |
+ | |||
+ | ==== Saving workspace ==== | ||
+ | |||
+ | Workspaces can be saved using alternatively: | ||
+ | |||
+ | * **Save...** in the menu **File** | ||
+ | {{: | ||
+ | * the keyboard shortcut **Ctrl + S** | ||
+ | * the {{: | ||
+ | |||
+ | To save an existing workspace under a different name, select **Save As...** from the file menu. | ||
+ | |||
+ | {{: | ||
- | ==== Save, Save as, close ==== | + | ==== Close workspace |
- | Workspaces can be saved using **Save...** from the file menu, the keyboard shortcut **Ctrl + S** or the {{: | + | To close a workspace, |
- | To close a file, choose **Close Workspace** from the file menu, press **Ctrl + Shift + W** or click on {{: | + | * choose **Close Workspace** from the file menu |
+ | {{: | ||
+ | * press **Ctrl + Shift + W** | ||
+ | * click on {{: | ||