Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
tutorials:t1 [2020/02/12 14:21] – [Screen layout] pwarczoktutorials: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's graphical user interface. The interface elements that will be referred to in the subsequent tutorials, are introduced here. At the end, the very basic operations with a workspace are demonstrated. +This first tutorial provides a brief tour of MatCalc's graphical user interface. The interface elements that will be referred to in the subsequent tutorials, are introduced here. At the end, the very basic operations with a workspace and a working directory are demonstrated. 
 ==== Contents ==== ==== Contents ====
  
Line 12: 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 'File' menu   * The 'File' menu
Line 27: 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).
  
-{{ :tutorials:t1:img:t1_screenshot_6011003.png?650 | MatCalc screenshot }}+{{ :tutorials:t1:img:t1_screenshot2_6041001.png?650 | MatCalc screenshot }}
  
 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 37: Line 36:
 ^ Options window| Context-sensitive options to change the way information is displayed. [[tutorials:T2 | Tutorial 2]], [[tutorials:T4 | Tutorial 4]] and [[tutorials:T5 | Tutorial 5]] give more information about the Options window.| ^ Options window| Context-sensitive options to change the way information is displayed. [[tutorials:T2 | Tutorial 2]], [[tutorials:T4 | Tutorial 4]] and [[tutorials:T5 | Tutorial 5]] give more information about the Options window.|
 ^ Variables window| A list of MatCalc's built-in variables with their current values. See [[tutorials:T4 | Tutorial 4]] and [[tutorials:T5 | Tutorial 5]] for more about variables.| ^ Variables window| A list of MatCalc's built-in variables with their current values. See [[tutorials:T4 | Tutorial 4]] and [[tutorials:T5 | Tutorial 5]] for more about variables.|
-^ 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, time, etc.) and on the contents of graphical windows (see [[tutorials:T4 | Tutorial 4]]).| ^ Status bar | Gives information on the current state of the system (temperature, time, etc.) and on the contents of graphical windows (see [[tutorials:T4 | Tutorial 4]]).|
Line 46: Line 44:
 As with any typical GUI application, this gives access to a number of sub-menus. The **File** and **Help** menus are documented in this tutorial, and the contents of the other menus will be described in more detail in subsequent tutorials. As with any typical GUI application, this gives access to a number of sub-menus. The **File** and **Help** menus are documented in this tutorial, and the contents of the other menus will be described in more detail in subsequent tutorials.
  
-^ **File** | opening, saving and closing files (see **'File operations'** below) | + **File**  | opening, saving and closing files (see **'File operations'** below) | 
-^ **Edit** | text-editing commands such as undo, redo, cut, copy, paste | + **Edit**  | text-editing commands such as undo, redo, cut, copy, paste | 
-^ **Global** | commands for setting up the system (see [[tutorials:t2|Tutorial 2]] and subsequent tutorials)| + **Global**  | commands for setting up the system (see [[tutorials:t2|Tutorial 2]] and subsequent tutorials)| 
-^ **Calc** | commands for the most frequent types of calculation (see [[tutorials:t2|Tutorial 2]] and subsequent tutorials) | + **Calc**  | commands for the most frequent types of calculation (see [[tutorials:t2|Tutorial 2]] and subsequent tutorials) | 
-^ **Simulation, Monte Carlo, Regions** | commands for starting various types of calculation | + ** Cells, Monte Carlo **  | commands for starting calculation within additional MatCalc modules 
-^ **Script** | to run scripts (more on this in [[tutorials:T13 | Tutorial 13]]) | + **Script**  | to run scripts (more on this in [[tutorials:T13 | Tutorial 13]]) | 
-^ **View** | to configure the GUI and create new windows for the display of results (see [[tutorials:t4|Tutorial 4]] and [[tutorials:t5|Tutorial 5]]) | + **View**  | to configure the GUI and create new windows for the display of results (see [[tutorials:t4|Tutorial 4]] and [[tutorials:t5|Tutorial 5]]) | 
-^ **Help** | see [[tutorials:T1#Getting help|Getting help]] below |+ **Help**  | see [[tutorials:T1#Getting help|Getting help]] below |
  
-Comprehensive information about the menu items can be found in the [[reference:menu|reference book]].+On platforms running under MacOS an additional menu **mcg** is also present. Comprehensive information about the menu items can be found in the [[reference:menu|reference book]].
 ==== Toolbars ==== ==== Toolbars ====
  
 The toolbar area contains a number of icon groups: The toolbar area contains a number of icon groups:
    
-**File etc**+== File ==
  
-{{:tutorials:t1:img:t1_toolbar_file.png| MatCalc Toolbar File}} \\ +{{:tutorials:t1:img:t1_toolbar_file_6031000.png| MatCalc Toolbar File}} \\ 
-L-R : New, open, save, close workspace, print, contents+L-R : New, open, save, close workspace, print, documentation
    
-**Working directory and script**+== Working directory and script ==
  
-{{:tutorials:t1:img:t1_toolbar_toolbar.png| MatCalc Toolbar Toolbar}} \\ +{{:tutorials:t1:img:t1_toolbar_working_directory_script_6031000.png| MatCalc Toolbar Toolbar}} \\ 
-L-R: browse working directory, run script+L-R: select working directory, browse working directory, run script
  
-**Edit**+== Edit ==
  
-{{:tutorials:t1:img:t1_toolbar_edit.png| MatCalc Toolbar Edit}} \\+{{:tutorials:t1:img:t1_toolbar_edit_6031000.png| MatCalc Toolbar Edit}} \\
 L-R: Undo, redo, cut, copy, paste, find L-R: Undo, redo, cut, copy, paste, find
    
-**Calculation**+== Calculation ==
  
-{{:tutorials:t1:img:t1_toolbar_calculation.png| MatCalc Toolbar Calculation}} \\+{{:tutorials:t1:img:t1_toolbar_calculation_6031000.png| MatCalc Toolbar Calculation}} \\
 L-R: Stop current action, single equilibrium, stepped equilibrium, search phase boundary, precipitate kinetics calculation, select calculation state, save into current calculation state, load from current calculation state, select calculation buffer. L-R: Stop current action, single equilibrium, stepped equilibrium, search phase boundary, precipitate kinetics calculation, select calculation state, save into current calculation state, load from current calculation state, select calculation buffer.
    
-**Manage windows**+== Manage windows ==
  
-{{:tutorials:t1:img:t1_toolbar_manage_windows_2017.png| MatCalc Toolbar Manage Windows}} \\ +{{:tutorials:t1:img:t1_toolbar_manage_windows_6031000.png| MatCalc Toolbar 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:
    
-{{:tutorials:t1:img:t1_toolbarmenu_6011003.png| MatCalc Toolbarmenu}}+{{:tutorials:t1:img:t1_toolbarmenu_6031000.png| MatCalc Toolbarmenu}}
  
 ==== Quick access bar ==== ==== Quick access bar ====
Line 103: Line 103:
 ^ {{ :tutorials:t1:img:t1_icon_start.png |Start}} | Start calculation (green arrow), stop calculation (red 'x' shown while calculation is running). Green tick-mark indicates successfully executed calculation. | ^ {{ :tutorials:t1:img:t1_icon_start.png |Start}} | Start calculation (green arrow), stop calculation (red 'x' shown while calculation is running). Green tick-mark indicates successfully executed calculation. |
 ^ {{ :tutorials:t1:img:t1_icon_freeze.png |Freeze}} | Freeze window updates during calculation.| ^ {{ :tutorials:t1:img:t1_icon_freeze.png |Freeze}} | Freeze window updates during calculation.|
 +^ {{ :tutorials:t1:img:t1_icon_job_manager.png |Job manager}} | Job manager |
 ^ {{ :tutorials:t1:img:t1_icon_fit_to_viewport.png |Fit to viewport}} | Fit windows into viewport (visible area on screen).| ^ {{ :tutorials:t1:img:t1_icon_fit_to_viewport.png |Fit to viewport}} | Fit windows into viewport (visible area on screen).|
 ^ {{ :tutorials:t1:img:t1_icon_zoom_in.png |Zoom in}} | Zoom in.| ^ {{ :tutorials:t1:img:t1_icon_zoom_in.png |Zoom in}} | Zoom in.|
 ^ {{ :tutorials:t1:img:t1_icon_zoom_out.png |Zoom out}} | Zoom out.| ^ {{ :tutorials:t1:img:t1_icon_zoom_out.png |Zoom out}} | Zoom out.|
 ^ {{ :tutorials:t1:img:t1_icon_open_navigator.png |Open navigator}} | Display an overview all open windows, enabling you to find the windows and regions of interest.| ^ {{ :tutorials:t1:img:t1_icon_open_navigator.png |Open navigator}} | Display an overview all open windows, enabling you to find the windows and regions of interest.|
-^ {{ :tutorials:t1:img:t1_icon_display_mode.png |Display mode}} | Clicking the down-arrow to the right of this icon reveals three options: **windowed** - output is in moveable windows on the screen**tabbed** - output is accessible via browser-style tabs at the top of the viewport**expose** - automatic organisation of output, with minimisation of system windows such as options, console, etc. Clicking on the background of the viewport area brings back the previous display mode (windowed/tabbed).|+^ {{ :tutorials:t1:img:t1_icon_display_mode.png |Display mode}} | Management of output windows configuration. Clicking the down-arrow to the right of this icon reveals three options:\\  **windowed** - output is in moveable windows on the screen\\  **tabbed** - output is accessible via browser-style tabs at the top of the viewport\\  **expose** - automatic organisation of output, with minimisation of system windows such as options, console, etc. Clicking on the background of the viewport area brings back the previous display mode (windowed/tabbed).|
  
  
  
-==== 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:T12 | Tutorial 12: Using the MatCalc console]] and [[tutorials:T13 | Tutorial 13: Introduction to scripting]]. The console can be shown or hidden using **View > Show > Show console**, pressing the **F4** key or clicking on the {{:tutorials:t1:img:t1_icon_show_console.png| MatCalc Icon show console}} icon.  
- 
-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 **'MatCalc 5 console'** window.  
- 
-==== 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. 
- 
-{{:tutorials:t1:img:t1_command_history_window_2016.png| MatCalc command history window}} 
- 
-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. 
- 
-{{:tutorials:t1:img:t1_command_history_menu_2013.png| MatCalc command history menu}} 
- 
-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''Nodesand 'Consolewindows 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''Variablesand 'Command Historywindows can also be attached to or detached from the left-hand column area as required.
  
 === 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 [[tutorials:T1#Managing toolbar elements | above]] ('Managing toolbar elements').
  
 === 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: 'console(F4), 'options(F3), 'variables(F2), 'node manager(Shift + F5)  
 + 
 +{{:tutorials:t1:img:t1_menu_show_windows_6031000.png|Menu: show windows}} 
  
 === 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''optionsand 'variableswindows.  
 + 
 +{{:tutorials:t1:img:t1_menu_window_font_6031000.png|Menu: window font settings}}\\  
 + 
 +{{:tutorials:t1:img:t1_window_font_settings_6031000.png|Window font settings}}
  
 === 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.
 +
 +{{:tutorials:t1:img:t1_menu_application_style_6031000.png|Menu: application style settings}}\\ 
 +
 +{{:tutorials:t1:img:t1_select_application_style_6031000.png|Application style settings}}
  
 === View > Display window IDs === === View > Display window IDs ===
Line 156: Line 151:
  
 Restores all windows to their default positions. Restores all windows to their default positions.
 +
 +{{:tutorials:t1:img:t1_restore_window_positions_6031000.png|Menu: restore window positions}}
  
 === View > Windows === === View > Windows ===
Line 163: 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 'File' menu ==== ==== The 'File' menu ====
  
Line 171: 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 under consideration, comprising inputs (elements, phases, compositions, thermodynamic and mobility data) and outputs (results of calculations, graphs, etc.). Saving the workspace preserves all this information for future use.+The **workspace** is the basic element for any activity in MatCalc GUI. It contains all the necessary information on the user calculations, comprising inputs (elements, phases, compositions, thermodynamic and mobility data) and outputs (results of calculations, graphs, etc.). Saving the workspace preserves all this information for future use.
  
-Click on the {{:tutorials:t1:img:t1_file_operation_icon_new.png| MatCalc icon new}} icon, open **New** from the **File** menu or click **Ctrl + N**. The following dialogue box will appear:+To create a new workspace, do one of the following: 
 + 
 +  * Click on the {{:tutorials:t1:img:t1_file_operation_icon_new.png| MatCalc icon new}} icon on the toolbar 
 +  Click on **'New'** from the **'File'** menu 
 + 
 +{{:tutorials:t1:img:t1_menu_file_new_6031000.png| Menu: new}} 
 + 
 +  * Press **Ctrl + N** on the keyboard 
 +  * Click on the {{:tutorials:t1:img:t1_new_workspace_button_6031000.png?250| New workspace button}} button 
 + 
 +The following dialogue box will appear (except when clicked on **'New Workspace'** button):
    
 {{:tutorials:t1:img:t1_file_operations_new_file_2016.png| MatCalc new file}} {{:tutorials:t1:img:t1_file_operations_new_file_2016.png| MatCalc new file}}
    
-Select **MatCalc workspace** from the drop-box. This runs a script file called **autonew.mcs**, which makes two additional windows appear: **Phase details** and **Phase summary**. When the new workspace is first created, the **Phase summary** and **Phase details** windows show messages indicating that no phases have yet been selected. The workspace is now ready for thermodynamic or precipitation calculations to be set up and performed.+Select **'MatCalc workspace'** from the drop-down list. This runs a script file called **autonew.mcs**, which makes two additional windows appear: **Phase details** and **Phase summary**. When the new workspace is first created, the **Phase summary** and **Phase details** windows show messages indicating that no phases have yet been selected. The workspace is now ready for thermodynamic or precipitation calculations to be set up and performed.
  
-{{:tutorials:t1:img:t1_file_operation_6011003.png?650| MatCalc Screenshot}}+{{:tutorials:t1:img:t1_file_operation_6031000.png?650| MatCalc Screenshot}}
  
 ==== Working directory ==== ==== Working directory ====
  
-The **working directory** is the directory opened by default when saving new files or opening existing ones. Clicking on **Working directory...** in the **File** menu allows the user to designate an existing directory as the working directory or to create a new directory for this purpose. MatCalc remembers your chosen working directory for next time.+The **working directory** is the directory opened by default when MatCalc is saving any output files or looking for any input files. Clicking on **'Working directory...'** in the **'File'** menu allows the user to designate an existing directory as the working directory or to create a new directory for this purpose. MatCalc remembers your chosen working directory for next time.
    
 {{:tutorials:t1:img:t1_file_operations_working_directory_6001000.png?650| MatCalc working directory}} {{:tutorials:t1:img:t1_file_operations_working_directory_6001000.png?650| MatCalc working directory}}
Line 197: 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, the sources of experimental data, etc.+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, the sources of experimental data, etc. 
 + 
 +{{:tutorials:t1:img:t1_menu_workspace_info_6031000.png| Menu: workspace info}}
    
-{{:tutorials:t1:img:t1_file_operation_workspace_info_2016.png| MatCalc workspace info}}+{{:tutorials:t1:img:t1_file_operation_workspace_info_6031000.png|MatCalc workspace info}} 
 + 
 +==== Saving workspace ==== 
 + 
 +Workspaces can be saved using alternatively: 
 + 
 +  * **Save...** in the menu **File** 
 +{{:tutorials:t1:img:t1_menu_save_6031000.png| Menu: save}} 
 +  * the keyboard shortcut **Ctrl + S** 
 +  * the {{:tutorials:t1:img:t1_icon_save.png| MatCalc icon save}} icon on the toolbar. 
 + 
 +To save an existing workspace under a different name, select **Save As...** from the file menu. 
 + 
 +{{:tutorials:t1:img:t1_menu_save_as_6031000.png| Menu: save as}}
  
-==== Save, Save as, close ====+==== Close workspace ====
  
-Workspaces can be saved using **Save...** from the file menu, the keyboard shortcut **Ctrl + S** or the {{:tutorials:t1:img:t1_icon_save.png| MatCalc icon save}} icon on the toolbar. To save an existing workspace under a different nameselect **Save As...** from the file menu.+To close a workspace, do one of the following:
  
-To close a file, choose **Close Workspace** from the file menupress **Ctrl + Shift + W** or click on {{:tutorials:t1:img:t1_icon_close.png| MatCalc icon close}}.+  * choose **Close Workspace** from the file menu 
 +  {{:tutorials:t1:img:t1_menu_close_workspace_6031000.png| Menu: close workspace}} 
 +  * press **Ctrl + Shift + W** 
 +  * click on {{:tutorials:t1:img:t1_icon_close.png| MatCalc icon close}} icon on the toolbar.
  
  
tutorials/t1.1581513672.txt.gz · Last modified: 2020/02/12 14:21 by pwarczok
 
Recent changes RSS feed Donate Powered by PHP Valid XHTML 1.0 Valid CSS Driven by DokuWiki