New Features
The features below were added or revised during the last calendar year.
NOTE: After installing a new version of Mira, your web browser may display cached pages of the online User's Guides. To refresh the cache, use Shift+F5 or Shift + Reload the first time you open the online User's Guide.
Reminder: For class objects, the class methods are always specified using the colon operator whereas class properties are specified using the dot operator.
Added CMeasurePlotPoints and CMeasurePlotLines classes to the Mira Pro Script module.
Added a topic describing the relationship between scripts and the Mira User Interface.
Several new features were added:
New fitpoly1d function fits a polynomial to (x,y) where y = f(x). This is a simplified non-class version of the CLsqFit class method CLsqfit:Fit.
New fitpoly2d function fits a polynomial to (x,y,z) where z = f(x,y). This is a simplified non-class version of the CLsqFit class method CLsqfit:Fit.
The new SetAttrib method updates the CPlotView object using values in a PlotAttrib table.
Added the SetNegX and SetNegY methods to the CPlotView class.
Added GetPt to the CLsqFit class. This method returns a table containing both the independent and dependent variables of a point.
Changed RGB parameter passing in the CLsqFit methods AddPt and AddPtWt. Previously, an RGB value was passed as a string; now it is passed as an array.
Added FindCol2 and FindRow2 to the CGridView class. The new methods match the column or row title by including leading and trailing whitespace that may exist in the title. In comparison, the FindCol and FindRow methods ignore leading and trailing whitespace that may exist in the grid title.
Added the SetInfo method to the CPlot class to attach a string of data to a plotted point. This works only for scatter plots and connected plots.
Several new features were added:
The new GetAttrib method returns a PlotAttrib table containing the general properties of the plot window atached to a CPlotView object.
The new PlotAttrib table contains properties of the CPlotView object.
The new_image and CImage:new functions can also construct a CImage object from a simple (keyless) 1-dimensional lua table.
Added the nBgCornerPixelsPct option for background calculation in source extraction by the CImExtract Module. See the ImExtractParams Table.
The new global commands to attach desktop view windows using their title (name). See attach_gridview_by_name, attach_imageview_by_name, attach_plotview_by_name, and attach_textview_by_name. Also see the list of Non-class Attachment Functions.
Added the CRegistry:DeleteValue and CRegistry:DeleteKey methods to delete a registry value (keyword-value pair) or an entire registry key including all its subkeys and values.
Changed the name "Datatype" to "PixelType"
To improve consistency with the Mira GUI commands and documentation, all forms of the words "Datatype" and "data type" used by images in the script language were renamed to "PixelType" and "pixel type". Also notice the change in upper/lower case characters for the word "type" in method and function names, as in Datatype --> PixelType. The term "data type" is still used by grids, such as in the CGrid class and GridView class.
Added Execute Script commands to several Mira Window Types
An Execute Script command was added to the menus for Image Windows, Plot Windows, Report Windows, Measurement Panes and other Grid Controls. See the class descriptions for CImageView, CPlotView, and CGridView and the corresponding window descriptions in the Mira Pro x64 User's Guide. Several sample scripts named "Execute.... .lua" are provided to show script execution from the Mira windows corresponding to the classes listed above. These are launched using the Execute Script command.
Numerous revisions were made to topics in this User's Guide.
Numerous sample scripts were added.
Help for learning to use the script language is included in the many scripts installed in the <Documents>/Mira Pro x64 Data/Scripts/Samples folder. Many new sample scripts were included.
Date, Time, and Angle Functions (added a topic overview)
CGrid class (new)
CGridView class (new)
CFileList class (new)
FiltBlockSum method was added to the script library.
PixelTypeStr fixed an internal bug.
PixelType fixed an internal bug.
Datatype, DatatypeStr, and SetDatatype are obsolete and should not be used in future scripts.
GetWcsType method was added.
GetWcsProj method
ToTable (new)
TableToRect (new)
TableToCol (new)
TableToRow (new)
ColToTable (new)
RowToTable (new)
RectToTable (new)
Plotting Functions (added several non-class functions)
connect and connecterr functions (new)
histplot (new)
line and lineerr functions (new)
scatter and scattererr functions (new)
stepline and steplineerr functions (new)
Close method (new)
Connect method (new)
Line method (new)
Scatter method (new)
StepLine method (new)
PlotConnected changed return value
PlotLine changed return value
PlotScatter changed return value
PlotStepLine changed return value
PlotMatrixLine changed return value
PlotMatrixRangeLine changed return value
PlotMatrix changed return value
PlotMatrixRange changed return value
AddPoints changed return value
PlotImageCol changed return value
PlotImageRow changed return value
PlotPoints changed return value
Text Formatting Functions (topic overview)
Dialog Functions (topic overview)
Directory Functions (new topic overview and new directory functions)
Close method (new)
SaveUndo method (new)
Undo method (new)
SaveUndoAll method (new)
UndoAll method (new)
Update method (new)
UpdateAll method (new)
AlignWcs (new method)
AlignWcs2 (new method)
AlignWcs3 (new method)
nFilterSepMinMethod property
nFilterSepMinCompare property
CLabels class revisions
CLsqFit class (new)
CMeasureAngles class (new)
CMeasure Lines class (new)
CMeasurePoints class (new)
CMeasureRegions class (new)
CPlot class (new)
Close method (new)
CPoint class (new)
CStats class revisions
Added two versions of all estimator methods that return the estimator and standard deviation. The additional versions return only the estimator, e.g., CStats:Mean versus CStats:MeanSdev.
Added two versions of Min and Max that return the estimator and its coordinates. The additional methods return only the estimator, e.g., CStats:Min versus CStats:MinXy.
Close method (new)
CValueSet class (new)
Added a new discussion of Table and Array Functions with emphasis on using the non-class array and table functions.
Added new topics for Array Functions and Table Functions.
Added 22 new Table Functions. Most of these have the letter "n" appended to their name.
Added several new functions and expanded the parameter options.
Added new versions of the mean and median methods for arrays that previously returned both the estimator and standard deviation. The new versions return only the estimator, e.g., mean versus meansdev.
Added new versions of the min and max for arrays that previously returned the estimator and its coordinates. The new functions return only the estimator, e.g., min versus minxy.
Mira Pro x64 Script User's Guide, v.8.73 Copyright Ⓒ 2024
Mirametrics, Inc. All Rights Reserved.