PFChrom v5 Documentation Contents            AIST Software Home            AIST Software Support

View Function(X)


The Data menu's View Function(X) option is used to graph up to 25 functions of x across the x range of your choice. The graph can be scaled, formatted, printed, or copied to the clipboard. You may also plot the derivatives or cumulative area of the functions and you may numerically evaluate a function you have entered.

v5_ViewFXDialog.png

Function(X) Entry

Enter up to twenty-five functions of X you wish to graph. You may enter any numeric calculation. All of the functions and constants available within PFChrom which are available in the parser can be accessed.

Each Function(X) line is limited to single line Y[n]= expression up to 500 characters in length. The Y[n]= prefixes are automatically supplied.

Parser Functions Help

PFChrom's full parser for user-defined peaks is available for view functions. You can use any supported function which is available at the time of the procedure, including any presently compiled user-defined peaks.

There are two dropdowns. The first lists the class of function, and the second lists the specific function in that class. The default All Constants, Variables, and Functions lists everything in the parser. The Insert Button will automatically place the function, with any parameter list, in the Y[n]= field where you presently have the cursor.

Validation

If the functions are not successfully validated, the math or parser error causing the failure will be shown and the cursor will be placed at the location in the function where the error was detected.

Copy, Cut, Paste

Use the Copy, Cut, and Paste buttons to paste in text expressions from the clipboard, or to copy or modify the function text.

Maple and Mathematica

If you paste expressions from Maple, copy the final expression as text in Maple's language code. For Mathematica copy the final expression as plain text. For most function expressions, the 500 character limit should not come into play. The text from Maple should not require any special handling; the PFChrom parser has been extended to handle the Maple text directly. When you paste in text from Mathematica, you will need to use the Paste MM button. This converts Mathematica's syntax to that which is compatible with PFChrom. Note that certain functions in the Maple and Mathematica function sets may not be available in the PFChrom parser, although every function we found that was applicable to peak modeling should be available.

Note that certain functions in the parser may have two or three different names. One may be compatible with prior versions of the product, another will support Maple's nomenclature, and yet another will support Mathematica's. The functions will be identical and you can use them interchangeably.

Built-in Functions

The parser's built-in functions will be identical to those used in the fitting. For example, the GenHVL[Z] model is used as follows: GenHVL[Z](x,area,center,width,distortn,z-asym). Because the <irf> models are convolution integrals fitted in the Fourier domain, those models will not be available in this option. There may, however, be a few specialty integral peak models in the Integral Convolution models. For example, the GenHVLZ[ge]i(x,area,ctr,width,distortion,asym,g-sd,e-tau,fracg) creates a time-domain integral of the GenHVL[Z]<ge> model. Such integrals will be very slow.

User Defined Peaks

When creating user-defined peaks, you can plot and view then using this feature.

Generate/PROC11.gif  Be sure you have entered and exited the User Function procedure to be certain the user-defined peaks are compiled and available to this procedure. Even if these user-defined peaks are imported in the PDF data file, they are not compiled until used.

To view a user function, you use the UDF1P, UDF2P, ... UDF8P() parser functions. The number in the function name is the count of adjustable parameters. The first argument is the user function number (1 to 60), the second is usually x, and the remaining arguments are usually the a0, a1, a2, etc. parameter arguments.

For example, the following function plots user function 27, a 6-parameter model: UDF6P(27,x,1,1,.256,-.1*7/1,.023,-.055)

Common Parameters for All View Functions

When entering a large number of functions, or when you wish to have the flexibility of changing a parameter common to each of the functions, this option allows you to enter the models similar to the example above and place the common parameters in the A0 to A11 parameter fields. If you wish to subsequently see how all of the functions change when the a3 distortion is doubled, for example, you only need to change the common A3 field's value.

Save

Use the Save button to save a VFX file to disk. These are ASCII files. You should edit these only in the program.

Read

Use the Read button to import a VFX file from disk. The functions are assumed valid even if they contain user-defined models which may not currently be imported or compiled. If that occurs, you will see zeros for all function values.

Clear All

Use the Clear All button to erase all fields in the dialog.

View Function Graph

When you click OK from the entry dialog, you will see the following:

v5_ViewFXDialog2.png

Y2 Plot

There are four options for displaying the Function(X) functions:

None - displays only the functions in a single plot graph

1st Deriv - displays the functions (Y axis) and first derivatives (Y2 axis) in a dual plot graph

2nd Deriv - displays the functions (Y axis) and second derivatives (Y2 axis) in a dual plot graph

Cumulative - displays the functions (Y axis) and cumulative areas (Y2 axis) in a dual plot graph

Simply select one of the four options to create the desired PFChrom Graph.

Note that cumulative areas require the evaluation of an integral for every pixel drawn in the plot. With a number of functions, with mathematically complex functions, or with large high-resolution graphs, these integrations may require some time. The integrations are done from a lower limit which corresponds with the lower limit of the displayed graph. By changing the lower X of the graph, you are thus changing this lower limit of integration.

The functions will be plotted in colors which correspond with the component colors in the PFChrom graph. These may be different for each of the graph's available color schemes and these are user-customizable.

Undo

Use the Undo item to return to the Function entry screen in order to revise the functions or X range.

Zoom

Ten levels of zoom-out are available by using the scrollbar in the graph's control panel. If this is a Cumulative graph , there may be an appreciable delay in updating the graph following a change in the zoom setting.

Evaluation

The Eval item is used to perform a full-featured numeric evaluation of one of the functions. If two or more functions are present, you must choose one for this numeric evaluation.

Export

For experimental work, the Export option will create 10,001 point data ASCII (PRN) sets of each of the functions in a directory of your choosing. Each of the data sets will have as much of the expression in the automatically generated file name as possible. These files can be imported back into the program with the main ASCII import option (File|Import Data Set(s)|Import from ASCII/AIA Data Files). If the functions are integrals, this process will take some time.

 



c:\1pf\v5 help\home.gif Smooth Peaks Menu