no way to compare when less than two revisions

Differences

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


Previous revision
Next revision
tutorials:t5 [2019/07/30 15:57] – [T5: MatCalc built-in variables; graphical output] pwarczok
Line 1: Line 1:
 +===== T5: MatCalc built-in variables; graphical output=====
  
 +//This tutorial was tested on\\
 +MatCalc version 6.02 rel 1.003\\
 +license: free\\
 +database: mc_fe.tdb//
 +
 +==== Complimentary files ====
 +
 +Click {{:tutorials:t5:script:t5_6021003.mcs|here}} to view the script for this tutorial.
 + 
 +
 +==== Contents ====
 +
 +  * Adding further plots to a plot window
 +  * Using the built-in variables
 +  * Defining a default x-axis
 +  * Modifying the series
 +  * Adding a new series to a plot
 +  * Removing a series from a plot
 +  * Duplicating and locking series
 +  * Editing series data
 +  * Converting series to tables
 +
 +===== Before starting... =====
 +
 +Re-open the file saved in [[tutorials:T4 | Tutorial 4]] and save it under a new name.
 +
 +===== Adding plots of different variables =====
 +
 +==== Creating a new plot ====
 +
 +Highlight the plot window and right-click in this window outside the plot area to bring up the plot context menu already seen in Tutorial 4. Click on **'New plot'**.
 +
 +{{:tutorials:t5:img:t5_new_plot_6011003.png| MatCalc new plot context}}
 +
 +An empty plot appears below the original one.
 +
 +==== Variables ====
 +
 +As well as the phase fraction variables **'F$*'** encountered in the previous tutorial, MatCalc contains many other built-in variables which are evaluated at each step-value of the stepped equilibrium calculations. These can be found in the variables window. Information about each variable is contained in the small window below the main variables window. Locate the **'driving forces'** category and drag **'DFM$*'** to the empty plot window, to give a plot as shown below.
 + 
 +{{:tutorials:t5:img:t5_plot_dfm_2016.png?650| MatCalc plot}}
 + 
 +Other variable categories of particular interest for stepped equilibrium calculations are highlighted in blue in the image below:
 +
 +{{:tutorials:t5:img:t5_variables_2017.png| MatCalc variables}} 
 +
 +==== - 'favorites' ====
 +
 +This contains the most frequently needed variables: temperature in Kelvin (**'T'**) and in Celsius (**'T$C'**), step-value, phase fractions (**'F$*'**) and compositions expressed in mole fraction (**'X$*$*'**) and in weight percent (**'X$*$*$wp'**). In these composition variables, the first asterisk represents the phase, and the second, the element, for example **'X$LIQUID$C'**.
 +
 +==== -'general' ====
 +
 +Temperature, step-value and pressure can also be found under this category. The temperature is in Kelvin by default, but the temperature in Celsius can be obtained by appending **'$c'**, as has already been seen in the **'Favorites'** category. This suffix is known as a **'unit qualifier'**. Another unit qualifier is **'f'** which appended to temperature variable in form of **'t$f'** returns the value of temperature in Fahrenheit. The **'information on variables'** window shows the valid unit qualifiers for the variables:
 + 
 +{{:tutorials:t5:img:t5_general_2015.png| MatCalc gerneral}}
 +
 +==== - 'phase fractions' ====
 +
 +The phase fractions **'F$*'** are repeated here.
 +
 +==== - 'composition' ====
 +
 +This contains the **'X$*$*'** composition variables mentioned above, and a number of other composition-related variables, expressed either as either **mole fractions (X...)** or as **u-fractions (U...)**. (Not all of these are applicable to stepped-equilibrium calculations, e.g. **'XPR$*$*'** and **'UP$*$*'** are for precipitation calculations).\\
 +Compositions in weight percent are not given separately here, but it can be seen from the **'variables information'** window that **'wp'** is a valid unit qualifier for the variables beginning with **'X'**. This means that weight percentages can be obtained by appending **'$wp'** to the names of these variables.
 +
 +==== - 'site fractions' ====
 +
 +The **'Y$*$*$*'** variables give the site fraction of an element on a particular sublattice of a phase. For example, BCC_A2 has the variables **'Y$BCC_A2$FE$0'** (site fraction of iron on sublattice 0) and **'Y$BCC_A2$C$1'** (site fractions of carbon and vacancies on sublattice 1). The **'YX$*$*'** variables represent the mole fraction of an element on a particular sublattice position of a phase; in this case, vacancies are not considered.
 +
 +==== - 'state variables' ====
 +
 +This category consists of a number of thermodynamic variables, including molar Gibbs free energies, entropies, enthalpies and heat capacities of the system and of each phase.
 +
 +==== - 'chemical potentials', 'activities' ====
 +
 +These categories include chemical potentials **'MU$*$*'**, activities **'AC$*$*'** and activity coefficients **'ACC$*$*'**.\\
 +Further plots can be added to the same plot window using **'New plot'**; they will share the same buffer, default x-data and colour scheme. Some examples are shown below:
 +
 +- Molar Gibbs free energy (**'GMP$*'**)
 + 
 +{{:tutorials:t5:img:t5_plot_gmp_2016.png?650| MatCalc plot}}
 + 
 +- Chemical potential of carbon (**'MUP$*$C'**)
 + 
 +{{:tutorials:t5:img:t5_plot_mup_c_2016.png?650| MatCalc plot}}
 + 
 +- Molar heat capacity (**'CPP$*'**, note the lambda-anomaly at the Curie temperature in BCC_A2)
 +
 +{{:tutorials:t5:img:t5_plot_cpp_2016.png?650| MatCalc plot}} 
 +
 +Note the search field on the top of the 'variables' window. By typing the variable name or a keyword (e.g. 'strength'), only the relevant variables will be shown.
 +
 +{{:tutorials:t5:img:t5_variables_filter_6011003.png| MatCalc plot}}
 +
 +==== Arranging plots in the columns ====
 +
 +When there are many plots in the plot window then they will get streched so much that they will eventually become unreadable. In order to obtain a transparency, it might be a good idea to arrange the plots in more than one column. To place the plots in two columns, click on **'plot columns'** in **'Options'** window and type **'2'** in the appearing dialog.
 +
 +{{:tutorials:t5:img:t5_plot_columns_2016.png| MatCalc plot columns}} 
 +
 +==== Default x-axis ====
 +
 +To give a consistent appearance to all the x-axes in the plot window, a **'default x-axis'** can be defined. This is found towards the top of the **'Options'** window. Change **'no'** to **'yes'** in the 'use for all plots' line and define the properties of the x-axis in the same way as for a normal x-axis.
 +
 +{{:tutorials:t5:img:t5_default_x-axis_2013.png| MatCalc default x-axis}} 
 +
 +==== Displaying x-values of multiple plots ====
 +
 +If the plot window contains several plots, right-clicking and dragging the mouse in one of these will display not only a cross in that plot, but a vertical line at the same x-value in all the others. An example is shown below:
 +
 +{{:tutorials:t5:img:t5_plot_red_line_2016.png?650| MatCalc plot red line}}
 +
 +===== Modifying the series in a plot =====
 +
 +This part of the tutorial will demonstrate how to use the unit qualifiers mentioned above. Add a new plot to the plot window and drag and drop **'X$*$C'** (carbon content of the phases) from the **'variables'** window. The resulting plot should look like this:
 +
 +{{:tutorials:t5:img:t5_plot_carbon_content_2016.png| MatCalc plot carbon content}}
 +
 +By default, the carbon content is expressed in mole fraction. To change the units to weight percent, firstly click on the new plot to select it. This should expand the section of the **'Options'** list which applies to the new plot. Click on the triangle by **'series'** to open the series options:
 +
 +{{:tutorials:t5:img:t5_option_series_2016.png| MatCalc series}}
 +
 +Double-click on **'y-data'** for the first series to open the following box. Append **'$wp'** to the existing expression and click **'OK'**.
 +
 +{{:tutorials:t5:img:t5_new_value_2015.png| MatCalc new value}}
 +
 +This will change the values plotted for the **'LIQUID'** series. Repeat for the other three series. The final appearance of the plot, with appropriate axis labels added, should be as shown below.
 +
 +{{:tutorials:t5:img:t5_plot_carbon_content_wt_pct_2016.png| MatCalc Plot}}
 +
 +
 +
 +===== Modifying the series with drag and drop =====
 +
 +Alternatively you can select the variable and drag it to the window, and press **'Ctrl'** __before__ dropping it to the plot. An option window will pop up, where you can modify the original expression (read as %s) by adding mathematical operations or **change** it **to weight percent** by **appending '$wp'**.
 +
 +{{:tutorials:t5:img:t5_modify_expression_2016.png| Modify expression}}
 +
 +**Note:** Press **'Ctrl'**-key **after** selecting in 'variables' window and **before** dragging the desired variable.
 +
 +===== Other series operations =====
 +
 +Right-clicking on **'series'** in the **'Options'** window displays a context menu:
 +
 +{{:tutorials:t5:img:t5_option_window_2015.png| MatCalc window}}
 +
 +==== - 'New series' ====
 + 
 +The **'New series'** part of the menu expands to give the following sub-menu (provided that a plot is selected).
 +
 +{{:tutorials:t5:img:t5_new_series_menu_2016.png| MatCalc new series menu}}
 +
 +Clicking on **'core buffer results'** creates an empty series (given the name of **'auto'** on the plot) to contain variables evaluated from the results of a buffer. Edit the **'y-data'** line in the **'Options'** window for this series to enter any valid built-in or user-defined variable or an expression.\\
 +
 +Variables can be copied from the **'Variables'** window by right-clicking on the expression required to display a menu containing Copy, Paste and other operations.
 +
 +{{:tutorials:t5:img:t5_variable_window_2013.png| MatCalc variables menu}}
 +
 +The other series types which can be added are as follows:\\
 +
 +- **'table/experimental data'**: allows the user to add a set of experimental data points to a plot. This will be demonstrated in [[tutorials:T10 | Tutorial 10]]\\
 +- **'function/expression'**: enables an algebraic expression in (x) to be entered. This will be demonstrated in [[tutorials:T12 | Tutorial 12]]
 +
 +==== - 'Remove series', 'Remove all series', 'Remove all locked series' ====
 +
 +To remove a series from a plot, first click on the plot to select it. This will expand the part of the Options list which applies to the plot. Select the name of the series from this list and choose **'Remove series'** from the right-click menu (shown above) or press **'Delete'**. Multiple series in the same plot can be selected at once by holding down the CTRL key while clicking on the series names. **'Remove all series'** in the right-click menu deletes all the series in the selected plot. **'Remove all locked series'** removes all the series which are locked (locking the series is described below).
 +
 +==== - 'Duplicate and lock series ...', 'Duplicate and lock all series' ====
 +
 +This feature is available in the right-click menus of both the Options window and the plot window. Click on **'Duplicate and lock series'**, select a series from the list shown and click on **'Duplicate'** button.  This will lock the original series and create a copy.
 +
 +{{:tutorials:t5:img:t5_duplicate_series_2016.png| MatCalc duplicate}}
 +
 +**'Duplicate and lock all series'** performs this operation for all series in the selected plot window.\\
 +
 +The locked series is protected from any changes when the buffer contents are updated with new calculation results, while the copy is unlocked. This enables an easy comparison between results obtained under different conditions.
 +
 +
 +==== - 'Edit series data ...' ====
 +
 +This is also available in both the Options and the plot windows. Select a series in the appearing window and click on **'Edit...'** to display a table containing the numerical data used to plot the graph.
 +
 +{{:tutorials:t5:img:t5_edit_series_data_2016.png| MatCalc series data}}
 +
 +The data can be copied using the **'Copy selection'** or **'Copy all'** buttons. The contents of the rows and columns can be modified using **'Paste'** (to add data copied from another source), **'Clear cell(s)'**, **'Insert row'**, **'Insert col'** and **'Delete rows/cols'** buttons. Use **'Write'** to save the whole dataset to a text file and **'Read'** to load a dataset from a text file.
 +
 +==== - 'Convert series to table' ====
 +
 +This places the data from the series into a named table, which can be accessed from the **'Global'** menu.\\ 
 +Select the '**series**' in '**Options**' window, click on **'Convert series to table'**, select the series name and edit the name of the table, if necessary, in the box which appears, as shown below.
 +
 +{{:tutorials:t5:img:t5_convert_tables_2016.png| MatCalc convert tables}}
 +
 +To open and edit a table, select **'Tables and arrays'** from the **'Global'** menu. This will display a list of all the available tables, which can be edited in the same way as the series data described above.
 +
 +{{:tutorials:t5:img:t5_tables_window_2016.png| MatCalc tables}}
 +
 +===== Consecutive articles =====
 +
 +The tutorial is continued in article [[tutorials:T6 | T6 - Introduction to user-defined functions]].
 +
 +Go to [[:tutorials|MatCalc tutorial index]].
tutorials/t5.txt · Last modified: 2023/08/01 15:55 by pwarczok
 
Recent changes RSS feed Donate Powered by PHP Valid XHTML 1.0 Valid CSS Driven by DokuWiki