Mathcad® Prime™ 2.0 Migration Guide

Mathcad® Prime™ 2.0Migration Guide

December 2011

Copyright © 2011 Parametric Technology Corporation and/or Its Subsidiary Companies.All Rights Reserved.

User and training guides and related documentation from Parametric Technology Corporation and itssubsidiary companies (collectively "PTC") are subject to the copyright laws of the United States and othercountries and are provided under a license agreement that restricts copying, disclosure, and use of suchdocumentation. PTC hereby grants to the licensed software user the right to make copies in printed form ofthis documentation if provided on software media, but only for internal/personal use and in accordance withthe license agreement under which the applicable software is licensed. Any copy made shall include the PTCcopyright notice and any other proprietary notice provided by PTC. Training materials may not be copiedwithout the express written consent of PTC. This documentation may not be disclosed, transferred, modified,or reduced to any form, including electronic media, or transmitted or made publicly available by any meanswithout the prior written consent of PTC and no authorization is granted to make copies for such purposes.

Information described herein is furnished for general information only, is subject to change without notice,and should not be construed as a warranty or commitment by PTC. PTC assumes no responsibility or liabilityfor any errors or inaccuracies that may appear in this document.

The software described in this document is provided under written license agreement, contains valuable tradesecrets and proprietary information, and is protected by the copyright laws of the United States and othercountries. It may not be copied or distributed in any form or medium, disclosed to third parties, or used in anymanner not provided for in the software licenses agreement except with written prior approval from PTC.

UNAUTHORIZED USE OF SOFTWARE OR ITS DOCUMENTATION CAN RESULT IN CIVILDAMAGES AND CRIMINAL PROSECUTION. PTC regards software piracy as the crime it is, and we viewoffenders accordingly. We do not tolerate the piracy of PTC software products, and we pursue (both civillyand criminally) those who do so using all legal means available, including public and private surveillanceresources. As part of these efforts, PTC uses data monitoring and scouring technologies to obtain and transmitdata on users of illegal copies of our software. This data collection is not performed on users of legallylicensed software from PTC and its authorized distributors. If you are using an illegal copy of our softwareand do not consent to the collection and transmission of such data (including to the United States), cease usingthe illegal version, and contact PTC to obtain a legally licensed copy.

Important Copyright, Trademark, Patent, and Licensing Information: See the About Box, or copyright notice,of your PTC software.

UNITED STATES GOVERNMENT RESTRICTED RIGHTS LEGEND

This document and the software described herein are Commercial Computer Documentation and Software,pursuant to FAR 12.212(a)-(b) (OCT’95) or DFARS 227.7202-1(a) and 227.7202-3(a) (JUN’95), and areprovided to the US Government under a limited commercial license only. For procurements predating theabove clauses, use, duplication, or disclosure by the Government is subject to the restrictions set forthin subparagraph (c)(1)(ii) of the Rights in Technical Data and Computer Software Clause at DFARS252.227-7013 (OCT’88) or Commercial Computer Software-Restricted Rights at FAR 52.227-19(c)(1)-(2)(JUN’87), as applicable. 01012011

Parametric Technology Corporation, 140 Kendrick Street, Needham, MA 02494 USA

Contents

About This Guide........................................................................................................ 5

Converting Legacy Files.............................................................................................. 7Before Converting ................................................................................................ 8Using the XMCD, MCD Converter ......................................................................... 8Understanding the Conversion Results.................................................................. 9Display Differences .............................................................................................. 9Calculation Differences....................................................................................... 18Other Notable Differences .................................................................................. 21

Resolving Conversion Issues..................................................................................... 25Region Placement.............................................................................................. 26Worksheet Calculation........................................................................................ 26Solving Functions............................................................................................... 27WRITEEXCEL Function ..................................................................................... 282D Plots ............................................................................................................ 293D Plots ............................................................................................................ 35Headers and Footers.......................................................................................... 45

Appendix A. Supported and Unsupported Features ..................................................... 47

3

About This Guide

This Migration Guide is intended for users of the previous versions of Mathcadwho are migrating to Mathcad Prime 2.0.

How to Use This GuideThis guide supplements the Mathcad Prime 2.0 Help Center. This guide assumesyou are already familiar with Mathcad functionality.

Use this guide to learn about converting your files from earlier versions ofMathcad to Mathcad Prime 2.0. Step-by-step procedures are provided here forconverting your legacy worksheets to Mathcad Prime 2.0 worksheets. Informationon troubleshooting file conversion issues is also given.

Technical SupportContact PTC Technical Support via the PTC Web site, phone, fax, or e-mail if youencounter problems using your software. For more information, see Openingand Tracking a Call to Technical Support in the PTC Customer Service Guideenclosed with your shipment. The guide is also on the PTC Support Web page athttp://www.ptc.com/support/index.htm.

You must have a Service Contract Number (SCN) before you can receive technicalsupport. If you do not have a number, contact PTC License Management usingthe instructions in your PTC Customer Service Guide under License Management.You can receive free technical support for the first 30 days after purchasing newsoftware from PTC. If you do not have a SCN, you can contact technical andlicensing support at http://www.ptc.com/appserver/cs/mathcad_logger/options.jsp

5

http://www.ptc.com/support/index.htm

http://www.ptc.com/support/index.htm

If you run into issues with installation or licensing, and need further assistance, goto http://www.ptc.com/support/mathcad_supportCenter.htm.

DocumentationPTC provides documentation on the product CD-ROM in the following forms:

• Help Center with context-sensitive help and tutorials.• Mathcad Prime 2.0 Installation and Administration Guide in PDF format.

NoteTo view and print the PDF document, you must have the Adobe AcrobatReader installed.

You can click any item in the user interface or any function and press F1 to openthe relevant Help topic.

To access the Help Center or the Getting Started Tutorial, click or press F1.

Feedback to DocumentationPTC welcomes your suggestions and comments on its documentation—sendfeedback to the following address:

[email protected]

Please include the name of the application and its release with your comments.

Documentation Conventions

Convention Item ExampleBold Buttons and other selectable

elements or options from theRibbon

Click Calcula-tion ▶▶▶ Calculation OptionsClick Approximate Equal-ity.

Courier User input, system messages,directories, and file names

Processingcompleted.

Courier withless-than andgreater-thansymbols (< >)

Variables for which the usersubstitutes an appropriate value

output=<25

6 Mathcad® Prime™ 2.0 Migration Guide

http://www.ptc.com/support/mathcad_supportCenter.htm

mailto:[email protected]

1Converting Legacy Files

Before Converting....................................................................................................... 8Using the XMCD, MCD Converter................................................................................ 8Understanding the Conversion Results ........................................................................ 9Display Differences..................................................................................................... 9Calculation Differences ............................................................................................. 18Other Notable Differences ......................................................................................... 21

Legacy files are worksheets that were created using previous versions of Mathcad.You cannot open legacy files directly in Mathcad Prime 2.0. However, you can usethe Mathcad Prime 2.0 XMCD, MCD Converter to convert .mcd, .xmcd, .mct,.xmct, and .xmcdz legacy worksheets to Mathcad Prime 2.0 .mcdx format.

This chapter provides instructions for using the converter.Note• To convert legacy Mathcad files to Mathcad Prime 2.0 MCDX format,

you must have Mathcad 15.0 M010 installed. Otherwise, the converterwill not function properly. You can download Mathcad 15.0 M010 fromhttp://www.ptc.com/products/mathcad/mathcad-15-0/free-trial.htm.

• You can use your Mathcad Prime 2.0 license for Mathcad 15.0 as well.

7

http://www.ptc.com/products/mathcad/mathcad-15-0/free-trial.htm

Before ConvertingCheck your legacy worksheet to see if it contains any of the following items, andthen take the appropriate actions before starting the conversion process.

Locked AreasThe XMCD, MCD Converter cannot process legacy files that contain collapsedlocked areas. You must unlock any locked collapsed areas before converting theworksheet.

Using the XMCD, MCD Converter1. To start the XMCD, MCD Converter, on the Input/Output tab, in the Mathcad

Worksheets group, click XMCD, MCD Converter. The converter opens.

Alternatively, you can start it from the Start menu.2. Click Add Worksheet. The Open dialog box opens.3. Browse for and select the legacy worksheets, then and click Open. The file

names you selected appear in the Source Worksheet column. The versionof Mathcad you used to create the legacy worksheet appears in the Versioncolumn.

4. Click Add References. If the worksheet contains references to otherworksheets, they appear in the converter.

5. Select the desired worksheets and click Convert. The conversion process startsand the Status changes to In Progress. If the conversion is successful, theStatus changes to Converted, otherwise it changes to Failed.

For each successful conversion, the converter creates a new file with a.mcdxfile extension in the same folder as the source file. The source file is notmodified.

The XMCD, MCD Converter displays a conversion log that lists all the issuesfound during conversion. Click on a worksheet name to see the log for it. TheXMCD, MCD Converter stores all the log files in the directory that containsyour legacy files. You can open log files with a text editor like Notepad oran XML editor.

6. Press Ctrl+F5 to recalculate the worksheet and view the updated results.Note• The worksheets generated by the XMCD, MCD Converter cannot be read by

previous versions of Mathcad Prime.• You can continue working in Mathcad Prime 2.0 while files are being converted.


Understanding the Conversion ResultsWhen you convert legacy worksheets, all regions that require your attention areannotated. A red line segment appears to the left of the affected region and ared arrow points to the affected region. For example, a region might contain afunction with different solving algorithm, a different display, or a feature that isunsupported in Mathcad Prime 2.0. Features that are not available in MathcadPrime 2.0 are converted as images, so that no information is lost. All annotateddifferences belong to one of the following categories:

• Display differences• Calculation differences• Unsupported features and formatting (not available in Mathcad Prime 2.0)

To understand and handle annotated regions, perform the following steps:

1. In a converted worksheet, click an annotated region. The annotation appearsbelow the region.

2. Read the annotation and resolve any conversion issues. After you edit all theregions, on the Input/Output tab, in the Mathcad Worksheets group, click ClearAnnotations. The annotation marks disappear.NoteClear Annotations removes all the annotations in the worksheet. Do not clickthis button until you have reviewed all the issues.

Refer to Resolving Conversion Issues on page 25 for information on resolvingconversion issues.

Display DifferencesThe display of some features is different in Mathcad Prime 2.0. These displaydifferences do not affect calculation results.

Fractional Results and Mixed Number FormattingThe result is formatted according to the default Mathcad Prime 2.0 worksheet style.

Nondecimal ExpressionsIn Mathcad Prime 2.0, binary, octal, and hexadecimal base numbers lose their “b”,“o”, and “h” postfix. These numbers are converted to decimal numbers. The otherletters in a hexadecimal number are also converted.

Converting Legacy Files 9

Complex NumbersIn previous versions of Mathcad, you entered z:=2π*1i and the displayed resultwas z:=2π*i, but in Mathcad Prime 2.0 the displayed result is z:=2π*1i (theimaginary unit is prefixed with the number 1). A new polar operator allows you todisplay complex results in polar form.

ParenthesesSome parentheses in previous versions of Mathcad that are only used for displaypurposes are not converted. For example, consider the following equation:

Subscripts appear without parentheses when converted by Mathcad Prime 2.0:

The meaning of the resulting equation is identical.

Display Precision in ResultsMathcad Prime 2.0 can display up to 15 decimal places in results. This affects theconversion of results.

Previous versions of Mathcad Mathcad Prime 2.0

Displays 17 decimal places Displays 15 decimal places

NoteThe precision of internal results is the same.

DerivativesThe display of partial derivatives is not supported in Mathcad Prime 2.0. Theyappear as derivative operators.



NoteThe partial derivative variables use literal subscripts.

Symbolic Evaluation• Stacking of Symbolic Keywords and Modifiers

In previous versions of Mathcad, the keyword and modifier placeholders areto the left of the symbolic evaluation operator. In Mathcad Prime 2.0, theyare above it.


• Programming Operator

The display of Mathcad Prime 2.0 symbolic evaluation results containingprogramming operators appears slightly different.

Previous versions of Mathcad

Mathcad Prime 2.0

• Collapsed Nested Matrices

Mathcad Prime 2.0 does not support the display of collapsed nested matrices insymbolic evaluation results.


Previous versions of Mathcad

Mathcad Prime 2.0

• Long Symbolic Results

In previous versions of Mathcad, long symbolic results are displayed fully andyou must scroll to the right to see the full result. Mathcad Prime 2.0 truncatesthe display of long results and places three ellipses at the truncation point.Clicking the math region displays a resize bar for making the region widthsmaller or larger.

• Symbolic Expressions or Keywords

Unlike previous versions of Mathcad, Mathcad Prime 2.0 does not supportthe hiding of:

○ LHS expressions○ Keywords

Operators with Multiple FormsSome operators have multiple forms in previous versions of Mathcad. MathcadPrime 2.0 uses a single operator with multiple placeholders, to make it easierto use whichever form you want. The additional placeholders can be filled inor left empty.

• Square root and Nth root



Square Root

Nth Root

Insert both theSquare Root andNth Root operatorsby pressing \

• Derivative and Nth derivative


Derivative

NthDerivative

Insert bothforms of thederivative operatorby pressingCtrl+Shift+D

• Definite integral and indefinite integral


Definiteintegral

Indefiniteintegral

Insert both forms ofthe integral operatorby pressingCtrl+Shift+I

• Summation



Summation

RangeVariableSummation

Insert the threeforms of theSummationoperatorby pressingCtrl+Shift+$

• Product

Previous versions of Mathcad Mathcad Prime 2.0RangeVariableIteratedProduct

IteratedProduct

Insert bothforms of theProduct operatorby pressingCtrl+Shift+#

• Limit


Two-sidedlimit

Right-handlimit

Left-handlimit

Insert all threeforms of thelimit operator bypressing Ctrl+L

• Symbolic Evaluation


Previous versions of Mathcad Mathcad Prime 2.0SymbolicEvaluationSymbolicKeywordEvaluation

Insert both formsof the symbolicoperator bypressing Ctrl+.(period)

NoteIn Mathcad Prime 2.0, the keyword placeholders are above the symbolicevaluation operator.

WRITEPRN and APPENDPRN FunctionsThe WRITEPRN and APPENDPRN functions are converted into differentMathcad Prime 2.0 formats.




Mathcad Prime 2.0 converts the definitions WRITEPRN(“file”):=M andAPPENDPRN(“file”):=M to WRITEPRN(”file”, M)= and APPENDPRN(”file”,M)= respectively.

Excel ComponentsExcel components have a new format in Mathcad Prime 2.0. When you converta legacy Excel component, the converter adds input and output expressions tofit the new format.

Whether created from an external file or from typing in data, Excel componentsare treated identically by the converter. If the converted Excel component is linkedto an external file, the converter embeds the data inside the Excel component. Theconverted worksheet is not linked to the external file.

An Excel component that is displayed as an icon in previous versions of Mathcadis converted to an Excel component with a single cell displayed.NoteYou must have Excel 2003 or later installed for the conversion to work properly.

Previous versions of Mathcad Mathcad Prime 2.0Excel component with no inputs andoutputs.

Excel component with empty Inputs areaand Outputs area.

Excel component with inputs andoutputs. x is the input variable. y isthe output variable.

The inputs and outputs are converted toinput and output expressions.



Other notable differences for Excel components are listed here:

• In previous versions of Mathcad, when you open the Excel component table,the Excel ribbon is a part of the Mathcad menu. In Mathcad Prime 2.0, aseparate Excel window opens to show the full Excel component table.

• If a component table in the legacy file contains the value of NaN, the converterchanges the cell’s value to blank. Like any other blank cell, if you assign ablank cell to an output variable, its value is 0.

• Mathcad Prime 2.0 does not support using an Excel component to definefunctions. If the legacy file contains a function definition that its expression isan Excel component, the conversion fails.

Converted TextText is converted properly when your display is set to 96 DPI. If your display isset to 120 DPI, then the converted file might contain text that wraps onto morethan one line.

Disabled RegionsIn legacy files a disabled region is marked with a black square. When converted,the disabled region appears grayed out.


AreasCollapsed areas are supported in Mathcad Prime 2.0. However, you cannot lockareas in Mathcad Prime 2.0. If the legacy file contains a locked area that iscollapsed, the conversion fails. Expanded locked areas and unlocked areas areconverted directly to Mathcad Prime 2.0 areas.

Page LayoutYou can view the Mathcad Prime 2.0 worksheet with or without gridlines. Bydefault Mathcad Prime 2.0 opens in page view in which your worksheet appearsas a series of pages with gridlines. The non-printable continuous space that isvisible on the right side of the legacy Mathcad worksheets is hidden. To view thenonprintable space, click the Draft View icon in the bottom right of the statusbar or under the Document tab. To view a print preview of your worksheet, clickthe Page View icon . If you want to make your page view larger, choose adifferent page size or adjust the margins under the Document tab. You can alsopreview your pages by saving them to XPS (XML Paper Specification) or printingthem to PDF directly from Mathcad Prime 2.0.

Global Definition OperatorMathcad Prime 2.0 does not include the global definition operator. When youconvert a legacy file containing one or more global definition operators, a tablecontaining all converted definitions is inserted at the top of the file, and a localdefinition operator is inserted where each global definition operator appeared inthe original file. This ensures that the resulting file has the same values as theoriginal file.

Calculation DifferencesTOL and CTOLMathcad Prime 2.0 uses the KNITRO optimization solvers. This means thattolerances for solve block functions find, minerr, minimize and maximize areset internally. Unlike previous versions of Mathcad, you no longer need to setTOL in a solve block.

CTOL continues to control the constraint satisfaction tolerance for functions findand minerr.

Clearing the Previous Value of a VariableIn previous versions of Mathcad, the expression x:=x was used to clear theprevious symbolic value of x while leaving the numeric value intact.


The XMCD, MCD Converter converts the legacy expression x:=x to the newMathcad Prime 2.0 function clearsym(x).

UnitsMathcad Prime 2.0 has dynamic unit checking. This means that units are checkedwhile functions are processed. In Mathcad 12 through 15, units are checked firstand then processed.

Mathcad 12 through 15 Mathcad Prime 2.0

An error on the function definition indicatesthat the units do not match.

An error only appears after thefunction is evaluated.

Dynamic checking gives more flexibility, so some expressions that produce anerror in earlier versions of Mathcad work properly in Mathcad Prime 2.0. Forexample, in Mathcad 12 through 15, you cannot define a program or function thatdepends on a numeric value to determine the units of output.

But in Mathcad Prime 2.0, the program works as expected:

NoteThis program contains the new if/else operator, which replaces if/otherwise.

Solve BlocksSolve blocks in Mathcad Prime 2.0 are clearly defined regions within a solve blockbox. You do not need the word Given to mark the start of a solve block. Guessvalues, constraints, and solvers are labeled for clarity. All regions inside the solveblock construct can move as one unit. For more information on solve blocks, referto the Help and the Solving Tutorial for Mathcad Prime 2.0.


The following restrictions apply to solve blocks:

• You cannot include a range loop above the solver function inside a solve block.You can have a range variable but not a range loop such as this:

• You cannot include any definitions inside an ODE solve block, that is, a solveblock containing odesolve.

• Mathcad Prime 2.0 does not support symbolic evaluation of functions insidesolve blocks.

Worksheet CalculationEarlier versions of Mathcad open by recalculating all results, and you can chooseto save the file with results stored or unstored.

Mathcad Prime 2.0 does not recalculate the results when you first open the file, soif results were stored, they will show in the file. When you edit a file, the resultsare recalculated. When you edit results, the results are always recalculated.

Inline Math ExpressionsYou cannot insert math regions inside text regions in Mathcad Prime 2.0. Instead,you can insert an image of a math region inside a text region. If you need the mathto participate in the calculations, you must keep it as a math region. When a legacyfile is converted, math in text regions is converted to images. If the math is neededfor calculation, you must retype it in a math region below.

DerivativesWhen you convert a legacy worksheet that contains partial derivatives where theorder of derivatives is a variable or an expression, the converter will annotatesuch regions as follows:


Previous Versions of Mathcad Mathcad Prime 2.0

NoteThe order of derivatives in Mathcad Prime 2.0 must be an integer from 1 through 5.

Other Notable DifferencesDOE Functions• In Mathcad Prime 2.0, the ordering in the fullfact, fractfact and boxwilson

functions is based on The National Institute of Standards and Technology(NIST) standard. In previous versions of Mathcad, the ordering is basedon Understanding Industrial Designed Experiments/Book and Disk-Excel[Hardcover] by Stephen R. Schmidt and Robert G. Launsby.

• In Mathcad Prime 2.0, the result of boxwilson is displayed as a matrix, whereasin previous versions of Mathcad it is displayed as a table. The accuracy of theresult is not affected.

Previous Versions of Mathcad


Mathcad Prime 2.0


Mathcad Prime 2.0



Mathcad Prime 2.0

Greek Letters in Text RegionsTo insert a Greek letter inside a Mathcad Prime 2.0 text region, first type theequivalent Latin character, then select the typed letter and change its font toSymbol. Alternatively, insert the character from the Character Map program underAccessories.


You can also copy a variable name containing Greek symbols from a math regionto a text region.

ImagesMathcad Prime 2.0 does not have a Picture tool. To display an image that resultsfrom processing an input image, save the new image to the current workingdirectory and on the Math or Document tab, in the Regions group, click Image.Click Browse for Image... to locate and insert your image.


2Resolving Conversion Issues

Region Placement .................................................................................................... 26Worksheet Calculation .............................................................................................. 26Solving Functions ..................................................................................................... 27WRITEEXCEL Function ............................................................................................ 282D Plots ................................................................................................................... 293D Plots ................................................................................................................... 35Headers and Footers ................................................................................................ 45

When you convert a legacy worksheet to Mathcad Prime 2.0 format, the convertedfile may contain visual or calculation issues that require your intervention. Use theinformation in this chapter to learn how to resolve file conversion issues.

25

Region PlacementThe worksheet conversion process may result in some regions overlapping otherregions. This can be caused by one or more of the following reasons:

• Difference in page size• Difference in font size and style• Little or no space between regions in the legacy worksheet• Excel component display differences• Matrix display differences

ResolutionClick near the top of the page in the Mathcad Prime 2.0 worksheet. On theDocument tab, in the Spacing group, click Separate Regions and then selectVertically.

Worksheet CalculationThe worksheet conversion process might run into math regions that it cannotresolve or plot regions that it cannot convert. The converter turns such regions intoimages with appropriate annotations so none of your original content is lost.NoteThe converter cannot process legacy files that contain collapsed, locked areas.Unlock or collapse such areas before converting them.

Built-In VariablesWhen your legacy worksheet contains a built-in variable whose value is definedon the Calculation tab, in the Worksheet Settings group, you must define thatvariable at the top of your converted worksheet. For example, if the value ofORIGIN in your legacy worksheet is 2, you type ORIGIN := 2 at the top of yourconverted worksheet.

Result FormattingResult formatting differences do not affect the accuracy of results, but some resultsmay look different in your converted worksheet because the following options aredifferent in Mathcad Prime 2.0:

• Results formatting: Complex threshold, zero threshold, exponential threshold,fraction, exponents in engineering format, format units, hexadecimal, octalor binary display.

• Show unit exponents as a fraction


• Display precision: Mathcad Prime 2.0 supports display precision of up to15 decimal places.

• Matrix display styleNoteWhen you open a worksheet in Mathcad Prime 2.0, the results are not recalculatedautomatically. You must press Ctrl+F5 to recalculate the worksheet and view theactual results in Mathcad Prime 2.0.

Solving FunctionsSolving Functions Outside Solve BlocksIf your legacy worksheet contains solving functions outside a solve block (notfollowing the keyword Given), the converted worksheet displays an annotatedregion with the solving function maximize (or minimize) showing the correctsolution.

Legacy Worksheet After Conversion

If you recalculate the worksheet, the solving function displays an error message.To resolve the issue, insert a new solve block, copy the solving regions, paste theminside the solve block, and press Ctrl+F5 to recalculate.

Resolving Conversion Issues 27

After Recalculation Fixed

Note• The minimize and maximize functions now only work inside solve blocks.• You cannot drag regions into, or out of, solve blocks.

WRITEEXCEL FunctionOrder of ArgumentsTheWRITEEXCEL function has a different order of arguments in MathcadPrime 2.0. However, Mathcad Prime 2.0 still supports the previous order ofarguments. The converter reserves the original order of the arguments.


In Mathcad Prime 2.0 you can useWRITEEXCEL with a different order ofarguments.


Cell Range ArgumentIn previous versions of Mathcad, an optional argument of theWRITEEXCELfunction defines the Excel cell range where the input matrix is written to.

Previous versions of MathcadWRITEEXCEL writes out matrix M to cells B1 through D2 of the Excel file.

In Mathcad Prime 2.0, you can define which rows and columns of the input matrixare written to the Excel file, as well as define the Excel cell range.

If you convert a call toWRITEEXCEL that defines a cell range, an error messageis displayed.

After ConversionAn error appears after you recalculate your worksheet.

To resolve the issue, add the rows and columns of the input matrix to theWRITEEXCEL arguments, before the cell range argument. To copy all rowsand columns, set both their value to 1.

2D PlotsWaterfall PlotWhen the y-axis is a matrix of multiple columns, legacy Mathcad plots one traceper column:


After you convert the worksheet and perform the actions below, Mathcad Prime2.0 displays the plot as follows:

Perform one of the following actions:

• XY plot—Change the trace type to Waterfall Trace.• Polar plot—Plot the columns one at a time with one y-axis expression per

vector.Note• All legacy waterfall plots are converted to a line trace. You can change the line

trace to a waterfall trace with multiple lines as shown in the image above.• When the number of columns of x is greater than y (as in the plot on the right),

a trace is plotted for each column in the x axis expression. You must delete theextra columns in x if you want this plot to look exactly as the legacy plot.


Secondary Y AxisWhen your legacy plot contains a secondary y-axis, the plot is converted as follows— assuming the tick marks of the first y-axis were user-defined:

Legacy Plot After Conversion

NoteThe secondary y-axis is converted as a second trace of the primary y-axis. In thiscase, the secondary y-axis trace is not visible in the plot.

To resolve the issue, scale and plot the graph as follows:

You can use the above scaling formula for any plot with a normal scale, but notfor log scale.

Plots with UnitsMathcad 15.0 does not fully support units in plots. You can place values withunits in plotted expressions, limits, and markers, but Mathcad does not performunit checking. Mathcad uses the magnitude of values converted by default to SIunits, or to the unit system you set for the worksheet.


If you wish to scale the y-axis and view velocity in terms of kilometer per hour,you must divide the plotted function v(t) by kph:

With Mathcad Prime 2.0, you can plot functions and data with units, and Mathcadscales the axes values appropriately. You insert the unit directly into the unitplaceholder.


If your legacy plot contains markers or tick marks with units, after conversion youmust remove the unit to clear the error.

Plotting Two Range VariablesWhen your legacy worksheet contains a plot with two range variables, theconversion result is as follows:


Legacy Plot After Conversion

To resolve the issue, define vectors vx and vy above the converted plot:

Replace j and i in the plot with vy and vx.

Change the trace type to Waterfall Trace:


NoteThis solution only applies to XY plots.

3D PlotsIn previous versions of Mathcad, you can insert various types of 3D plots inyour worksheet. In Mathcad Prime 2.0, scattered data, curves, and surfaces areconverted to a single type of 3D plot.

Mathcad converts the tick mark values according to their settings in the legacyplot. When the plot displays a function, the converter calls CreateMesh orCreateSpace to capture its original ranges, including its start and endpoints, aswell as its number of intervals.

After you open the converted file in Mathcad Prime 2.0, you do not need to keepthe call to CreateMesh or CreateSpace. You can obtain an identical looking plotby typing the function name directly in the axis expression and then by editingthe tick mark values, by editing the number of grids points, or by defining rangevariables above the plot.

Functions of Two Arguments with Default Starts and EndsWhen a legacy plot displays a function of two arguments with default starts (-5)and ends (5), the converter does not need to add arguments to CreateMesh orCreateSpace to define the lower and upper bounds of the plotted range.

In previous versions of Mathcad, the number of plotted points is defined as thenumber of grids (or intervals). However, in CreateMesh, the number of plottedpoints is defined as the number of grid points. The converter must add +1 to thenumber of intervals to preserve the original plotted range.NoteThe default plotted range in Mathcad Prime 2.0 is (-10, 10). When changing theNumber of Points on the Ribbon, you are changing the number of grid pointsand not the number of intervals.

Previous versions of Mathcad Mathcad Prime 2.0A function of 2 arguments with 5intervals in the x- and y-direction. Theintervals are defined in the Propertiesdialog box under the QuickPlot tab.

After conversion, the plot displaysCreateMesh with 12 points in the x- andy-direction.



In this example, due to the singularity at (0, 0), the function can only be plottedwith an odd number of intervals as seen in previous Mathcad versions, or witheven number of points as seen with CreateMesh in Mathcad Prime 2.0.

After conversion, you may want to remove CreateMesh. For the example above,you can proceed as follows:

NoteIn this particular case, plotting the function returns an error due to a singularity at(0,0). To fix this, replace the division operator with a multiplication operator andgo through step 2 before changing back the operator to division.

1. In the z-axis expression, replace CreateMesh(f, 12) with f.2. On the Plots tab, in the Traces group, change the Number of Points to 12.3. Edit the minimum and maximum tick mark values of x-axis and y-axis to

-5 and 5.


Functions of Two Arguments with User-Defined Starts, Ends, andNumber of IntervalsWhen a legacy plot displays a function of two arguments with user-defined startsand ends or number of intervals, the converter adds arguments to CreateMeshor CreateSpace to define the lower and upper bounds of the plotted range andnumber of grid points.

Previous versions of Mathcad Mathcad Prime 2.0A function of 2 arguments with 25intervals in the x-direction and 30intervals in the y-direction. Theplotted range of x is (-10, 0) and theplotted range of y is (0, 15). Theintervals are defined in the Propertiesdialog box under the QuickPlot tab.

After conversion, the plot displaysCreateMesh with the correspondingplotted ranged. There are 26 points in thex-direction and 31 points in y-direction.



After conversion, you can remove CreateMesh. For the example above, to capturethe plot ranges accurately, you must define the ranges as range variables abovethe plot:

1. Above the plot, evaluate x2nd and y2nd according to the following equation:

2. Define x and y as range variables.

3. In the z-axis expression, replace CreateMesh(f, -10,0,0,15,26,31) with f(x,y).


Vector-Valued FunctionsVector-valued functions in legacy plots are converted the same way as functions oftwo arguments. The plotted range is captured by the arguments of CreateMeshor CreateSpace.


A function defining a parametricsurface with 11 intervals.

Mathcad uses CreateMesh to plot thefunction after conversion, with thecorresponding range and grid points.


To remove the call to CreateMesh or CreateSpace, you can use the sameprocedure as described in the previous section where range variables are definedabove the plot.


Combined InputsIn previous versions of Mathcad, you can combine inputs with parentheses orvectors, instead of defining inputs one by one, separated by commas, as is done in2D plots. In Mathcad Prime 2.0, you must define each input in a separate z-axisexpression. Mathcad converts combined inputs in such a way as to preserve thelook of the converted plot as close as possible to the legacy plot.

For example, given the following combined input, the conversion works as shownbelow.



Bar PlotsBar plots are not supported in Mathcad Prime 2.0. They are converted to surfaceplots.



Patch PlotsPatch plots are not supported in Mathcad Prime 2.0. They are converted to 3Dscattered plots.


Cylindrical and Spherical Coordinate System PlotsIn previous versions of Mathcad you can plot data in a cylindrical or a sphericalcoordinate system. Mathcad Prime 2.0 converts a cylindrical or a sphericalcoordinate system plot to an image.


3D Plots SizeWhen you convert a legacy worksheet that contains a wide plot or a narrow plot,the converter resets the plot to a cube.


Headers and FootersLegacy worksheet header:


Conversion output:

The following table outlines the legacy header and footer syntax and the equivalentcommand on the Mathcad Prime 2.0 Document tab, in the Headers and Footersgroup. Use the table to replace the legacy syntax character with the equivalentMathcad Prime 2.0 header or footer field.

LegacySyntax

Description Mathcad Prime 2.0Command

{f} Insert file name File ▶▶▶ Name{p} Insert file path File ▶▶▶ Path

{n} Insert page number Page Number with choices{nn} Insert number of pages Page Number with choices{fd} Insert date last saved Saved Date

{ft} Insert time last saved Not available{d} Insert current date Not available{t} Insert current time Not available

The following header and footer customization options are not available inMathcad Prime 2.0:

• Changing the number of the first page• Using a different header and footer on first page• Using a frame around the header, footer, or main worksheetNote• You may need to resize images or format text to keep the content within the

header or footer.• If your header is too wide to fit, change the margins to wide margins.


ASupported and Unsupported

Features

This appendix provides a comprehensive list of supported and unsupportedfeatures for Mathcad Prime 2.0.

A number of Mathcad functions have been deprecated, and their support will bephased out in future Mathcad Prime releases. Refer to the Help Center for a list ofdeprecated functions and suggested alternate functions to use in converted or newlycreated worksheets. Deprecated functions work properly when the worksheets thatcontain them are converted to Mathcad Prime 2.0 format. They can also be used inMathcad Prime 2.0 directly, but are not documented in the Help Center.

Feature In MathcadPrime 2.0

Not inMathcadPrime 2.0

New Ribbon

Ribbon user interface based on MicrosoftOffice

ü

Customizable Quick Access Toolbar ü

Physical constants in the Ribbon ü

Features and functionality are morevisible and not hidden in menus anddialog boxes

ü

Calculation

Multithreading ü

47



System Support

64-bit operating system support ü

Units

Dynamic units ü

Mixed units in matrices and tables ü

Mixed units in plots ü

Choice of MKS, None, and customizedunit systems

û

Most functions now accept units ü

Functions

Two new and more flexible Fouriertransform functions

ü

24 new Design of Experiments (DOE)functions that support units ü

Data Analysis , Signal Processing,and Image Processing Extension Packfunctions added

ü

Improved performance for computationalsignal and image functions ü

Most functions now accept units ü

New Read/Write functions: READCSVand WRITECSV, READEXCEL andWRITEEXCEL, READTEXT andWRITETEXT

ü

Advanced KNITRO 7.0 optimizationsoftware library for minimize andmaximize solvers ü




New clear variable definitions functionfor numeric and symbolic expressions

ü

Math and Equation Editor

Choice of solving algorithms û

Custom currency symbols û

Definition and evaluation on the same lineü

Error tracing ü

Explicit evaluation feature üHexadecimal, octal, and binary numberformat û

Included worksheets can be cached forportability ü

Literal subscripts can be inside a variablename like H2O ü

Math styles ûMixed numbers (fractions) ûMultilevel worksheet references (includereferenced files inside another worksheet) ü

New improved equation editor showingstructure of the math ü

New Labels feature for using the samenames for different elements, such as mfor meters and v for variables.

ü

Pdesolve and PDE solve blocks ûResult Formatting Tolerance: Zero andcomplex threshold

Number format: Show exponents asE±000

û

Solve blocks as a block that can be movedas a grouped regions with a border ü

Supported and Unsupported Features 49



Solve blocks contain local variables. üSymbolic math (except for menusymbolics, symbolics in solve blocks, andsymbolic result formatting)

ü

Large symbolic results are truncated andcan be resized to view as much of theresult as desired

ü

Matrices and VectorsAdd and delete rows and columns fromthe Ribbon or with the mouse ü

Insert matrix with desired rows andcolumns from the Ribbon ü

Matrix navigator for panning and resizinglarge matrices ü

Mixed units in matrices üOperatorsCustom display of operators ûCustom operators, prefix and postfixoperators û

Direct substitution of operators byovertyping ü

Global definition ûGradient operator ûIndefinite integral üNew linear and circular convolutionoperators ü

New polar operator üNew row operator for matrices üPicture operator ûScalar operator üSquare root and nth root operatorcombined into one operator ü

Two derivative operators combined intoone operator with multiple placeholders ü

Two product operators combined into oneoperator with multiple placeholders ü

Two summation operators combined intoone operator with multiple placeholders ü




Two-sided, left-hand, and right-hand limitoperator combined into one operator ü

New Is Element Of comparison operator üPlots2D plots traces: line, column, bar, stem,box, error, effects ü

Animation, vector field plot, 3D bar, 3Dpatch, second y-axis û

Box plot üContour plots (improved) üEffects plot üHide axis expression üLine markers (unlimited number) üMixed units in plots üPareto plot üPolar plots üPlot legends, titles, embedded regions û3D plots: spin, pan, zoom ü3D plots: surfaces, curves, scattered plots ü2D plots: trace and zoom ûWaterfall plots and plotting matrices üProgramming

Debugging tools ûEasier editing of programs üMathsoft controls and web controls ûNew programming operators:if/else-if/else and if/also-if/else ü

Programming operators can be insertedby typing ü

Document FeaturesAlign regions horizontally and vertically û

, use gridAuto save ûCollapsed areas üLocked areas ûCompare worksheets ûDraft view and page view display ü




E-books ûEmbedded math in text ûFind and Replace üFind all and replace all ûGrid with two display settings üHyperlinks ûImproved headers and footers üLandscape pages üMultiple tabbed worksheet interface üPaste special ûPrint to XPS and PDF üRegion background color and border ûRuler and guidelines ûSeparate regions vertically or horizontally üSpell check ûTab to different regions üTemplates ûText blocks that push down other regions üText styles ûTile worksheets ûView regions ûWide pages in draft view üWorksheet protection ûXMCD, MCD Converter (single or batch)for converting previous versions ofMathcad worksheets to Mathcad Prime2.0 with annotated differences

ü

DocumentationNew Help with bookmarks and maththat can be copied to Mathcad Prime 2.0worksheets

ü

New tutorials üMigration Guide for converting olderworksheets to Mathcad Prime 2.0 ü

Detailed tooltips üTablesInsert a table with desired rows andcolumns from the Ribbon ü




Add and delete rows and columns byusing the Ribbon or keyboard shortcuts ü

Tables include a header row for listingunits ü

Each column can contain values ofdifferent units

ü

Define multiple variables with vectorsand units ü

Integration with other applications

Microsoft Excel 2003, 2007, 2010 support üExcel add-in ûImport or paste from Excel üREADEXCEL function with previewand ability to edit function for parametricprocessing

ü

Creo Parametric integration üWindchill Workgroup Managerintegration ü

Automation API ûExcel Component üSDK (Software Development Kit) ûUser-defined DLLs, scripts û


Mathcad® Prime™ 2.0 Migration Guide

Documents

Transcript of Mathcad® Prime™ 2.0 Migration Guide