New XYPlot Frame

 

Description

Version

Date

Writer

1

Create

V1.0.0

2017/8/9

Luoliangfeng

2

Tutorial

V1.0.1

2017/9/7

Luoliangfeng

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

1 Introduction

    The new XYPlot frame is designed as 2d curves viewer, which can show multiple ports of the 2d curves page by page.

Files required:Files.zip

2 User Interface

2.1 Main Menu

2.1.1 File

    The XYPlot Frame supports for to read and write the special project file including XYPlot Data. User can "open", "save" and "save as" this kind of file.

 

New: Delete the memory.

Print: Show print dialog to print picture for XYPlot graphics.

Close: Hide the XYPlot frame but don't delete the memory.

Exit: Hide the XYPlot Frame and delete the memory.

2.1.2 View

Left Panel: Hide or show left panel by check or uncheck.

Bottom Panel: Hide or show bottom panel by check or uncheck.

Parameter Panel: Hide or show parameter panel by check or uncheck.

Default: Return the default view of frame GUI.

Show Port: Show the current port graphics on Main Window with model.

2.2 Left Panel

2.2.1 Project Panel

 

Tree list: To show the pages and ports.

 

 

Right Click Pull Down Menu:

Delete: Delete the selected port.

Create new page: Create another new empty page.

Cancel: Cancel this operation.

 

 

 

 

 

 

Mouse drag operation: When left drag one port to another position on the tree list, the port on main graphics will be changed position as it. When right drag, it will show pull down menu.

Drag Pull Down Menu:

Move here: Move the dragged port to destination port.

Copy here: Copy the dragged port to destination port.

Cancel: Cancel this operation.

 

2.2.2 Parameter Panel

The parameter panel is designed as to create template file for 2d curves plotting and operations.

 

 

Parameter Name: "LineColor", "LineStyle" and "Name".

Parameter Value: Set the parameter for "LineColor"; Set the parameter for "LineStyle"; Set the parameter for "Name".

Create Template Dialog: Set the path name and template file's name.

2.3 Main Graphics

2.3.1 Head

Page Title: Show the page title and number.

Next Page: Go to next page.

Previous Page: Go to previous page.

 

Page Setting Dialog: Show page setting dialog.

 

Name: Set page title.

Row: Set the row number of main graphics, which can be 1, 2 or 3.

Column: Set the column number of main graphics, which can be 1, 2 or 3.

2.3.2 Main Graphics

Main graphics shows the ports in one page.

 

Mouse Operation:

1.When show multiple ports in one page, left click one port, the port will be highlighted and be selected.

2.When show multiple ports in one page, double click one port, the port will be shown full of the whole graphics.

3.When show one port in the whole page, double click, it will return to multiple ports state.

4.When show one port in the whole page, left click, it will slide next port in this page.

2.4 Bottom Panel

2.4.1 Curve Panel

  The curve panel is used for dealing with the curves by "scale panel", "attribute panel", "filter panel", "operation panel", " legend panel", "cross panel", "extend panel" and "save panel". On the left of "curve panel", there exists a curves list to show the current port's curve names; on the right of curve panel, it can switch different panels to deal with the curves of current port.

 

Curves List: List the curves for current port.

All: Select all of the curves on list.

Rev: Revert selected curves on the list.

None: None selected curves on the list.

Delete: Delete selected curves on the list.

Show: Show selected curves on list.

2.4.1.1 Scale Panel

Set or change the scale, offset or boundary of current curves.

 

 

Scale and Offset:

X Scale: Set x scale value.

Y Scale: Set y scale value.

X Offset: Set x offset value.

Y Offset: Set y offset value.

 

Boundary Setting:

XMin: Set x minimum value.

YMin: Set y minimum value.

XMax: Set x maximum value.

YMax: Set y maximum value.

 

Apply: Apply the scale, offset and boundary values.

Reset: Reset setting to the default values.

2.4.1.2 Attribute Panel

Change attribute of curves.

 

 

 

Symbol

Symbol Choice: Select symbol style.

Symbol Reset: Reset to default symbol style.

Color Choice: Select symbol color.

Color Reset: Reset to default symbol color.

Points Every Symbol: Input number of points pre symbol.

Join symbols with line: Add or remove the lines between symbols.

Auto Symbols: Automatically mark every lines with different symbols.

 

Line

Color Choice: Select line color.

Color Reset: Reset to default line color.

Width Choice: Select line width.

Width Reset: Reset to default line width.

Style Choice: Select line style.

Style Reset: Reset to default line style.

 

Apply: Apply attribute value.

Reset: Reset to default attribute value.

2.4.1.3 Filter Panel

Set curve filtering.

 

 

Filter: Select the filter to apply.

Time: Select time units.

C/S(Hz): Select/Enter frequency.

Point Average: Select/Enter number of points to average.

Apply: Apply the filter values.

Reset: Reset to the default values.

2.4.1.4 Operation Panel

Operation Type Choice: Select type of operating curves. There're single, multiple, Hic-CSI and expression, and when selected the "multiple", the "curves selected" panel will be activated; when selected the "Hic-CSI", the "Time and Gravity" panel will be activated; when selected the "expression", the "Expression" panel will be activated.

Operation List: Select an operation to apply for curve.

 

Curves Selected:

1st Curve: Pick/Enter 1st curve from curve list.

2nd Curve: Pick/Enter 2nd curve from curve list.

3rd Curve: Pick/Enter 3rd curve from curve list.

 

Time and Gravity:

Time Units: Enter/Select HIC/CSI time units.

Gravity Constant: Enter/Select HIC/CSI gravity constant.

 

Expression:

Variable Name: Enter a variable name.(max 8-char)

Add>>: Add selected curve to variable list.

Remove<<: Remove selected variable from list.

Variable Name List: List the definition variable.

Expression: Enter formula expression.

 

Mode:

Replace: Operated curves will replace with the current port's curves.

New: Operated curves will be shown another new port.

 

Apply: Apply the operation setting to the selected curves.

Reset: Reset operated curves to initial status.

2.4.1.5 Legend Panel

Change curves' legend.

 

Selected Curve Name: Modify curve name.

Up, Down, Left, Right, Middle: Move the legend director and return the default position.

 

2.4.1.6 Cross Panel

Curves List: Show the curves on the list. Select one curve, which will be insert into x, y or z text to prepare for crossing plotting.

 

2D/3D: Select 2D or 3D plotting.

 

Cross Area:

X: Enter x from curves list.

Y: Enter y from curves list.

Z:Enter z from curves list.

Interpolate: Set number of divisions for interpolation.

Apply: Apply setting to plot 2d/3D graphics.

 

Export 3DPlot file Area:

This area is used to save 3d plotting file to prepare for 3d graphics viewer.

Curve ID: Input the curve id.

Curve Name: Input curve name.

Mode: Set mode of saving the file.

Save: Save 3dplotting file.

2.4.1.7 Extend Panel

Curve extending using linear or hyperbolic function.

 

 

Linear: The formula is y = a*x.

X End Value: Enter the value of x end.

 

Hyperbolic & Young:

N: The power parameters in formula.

X Step: Enter x step.

Hyperbolic X End Value: Enter hyperbolic x end value.

Young's X End Value: Enter young's x end value.

Only Hyperbolic: Use only hyperbolic x end value.

 

2.4.1.8 Save Panel

Write curves data to a file.

 

 

File Name: Show or edit the file's full path name.

Browser: Select the directory of saving file.

File Type: Select data output type.

Save: Write curves to a file.

 

Advanced:

Interval: Select/Enter number of time steps between outputs.

Interpolate: Toggle interpolate curve before saving.

Points: Set number of divisions for interpolation.

Curve Clip: Clip curve from abscissa minimum to maximum.

Points or Value: Select start and end clip points or value.

AMin: Enter minimum abscissa point or value.

AMax: Enter maximum abscissa point or value.

 

Option for MSoft:

Single X-Axis: Save single X-Axis for Microsoft CSV file.

Multiple X-Axis: Save multiple X-Axis for Microsoft CSV file.

 

Option for ISO:

 

Channel Name: Input Channel Name.

Cust. Channel Code: Input customer channel code.

Channel Code: Input Channel Code.

NO. Of Points: Input number of points.

Direction: Select direction.

Unit: Select Unit.

Gravity Constant: Select gravity constant.

2.4.2 Port Panel

Change the style, title, axis and tick of port.

2.4.2.1 Port Style Setting

 

Grid: Add or remove grid lines in current XY-Plot port.

Grid Space: Select grid space degree.

Tick: Add or remove tick marks in current XY-Plot port.

Frame: Add or remove frame in current XY-Plot port.

Legend: Add or remove legend in current XY-plot port.

Autofit: Toggle Automatically Fit data in current XY-Plot port (on/off).

Timeline: Toggle time line in current XY-Plot port.

Invert: Invert background color in current XY-Plot port.

Maxgraph: Use all of current XY-Plot port to display data

Minmax: Add or remove min/max label in current XY-Plot port.

Minorgrid: Add or remove minor grid lines in current XY-Plot port.

Apply To All: After checked the styles are applied for all ports.

2.4.2.2 Port Tile Setting

Port: Enter current port title.

Legend: Enter legend name.

2.4.2.3 Port Axis Setting

Xlabel: Enter x-Axis label.

Ylabel: Enter y-Axis label.

Unit: Select axis unit.

2.4.2.4 Port Ticks Setting

Axis: Select x or y axis.

 

Major:

Auto: Select the major tick automatic method.

Fixed Range: Select/Enter the fixed range between major ticks.

Fixed Number: Select/Enter the fixed number method for major tick.

Minor:

Auto: Select the minor tick automatic method.

Fixed Number: Select/Enter the fixed number method for minor tick.

 

 

2.4.3 Template Panel

Run template.

 

Template File list: List the template files.

Load: Load a template file.

UnLoad: Unload the selected template file on list.

 

Setting Parameters:

File: Change parameter "File" by full path name.

Browse: Browse file for the parameter "File".

LineColor: Change parameter "LineColor".

LineStyle: Change parameter "LineStyle".

Name: Change parameter "Name".

 

Mode: Select the mode of showing results after running template file.

Overlay: The results will be overlaid the last results.

Append: The results will be appended at the end of last results.

Replace: The results will replace with the last results.

 

Apply: Apply the setting parameters and run template file.

2.4.4 Annotation Panel

 

Labels List: Show the labels user defined.

Add: Enter "lsprepost" in label text, click add, the "lsprepost" will be added into labels list.

Clear: Clear Label text.

Delete: Delete the selected label in the labels list.

 

Type: Set the type of annotation. There exist two type of text and arrow.

Property: Select annotation color, the label angle and the font size of annotation.

Reset: Clear up all of the annotation labels and arrows.

 

3 Tutorial

3.1 Basic

3.1.1 Plot curves from Ascii, Binout or XYFile

Select radio button "Main" to plot curves into new xyplot frame on "Ascii", "Binout" or "XY Plot" dialog.

 

3.1.2 Timeline with model animation

1.         Load a d3plot model.

2.         Go to Post->History Dialog. Select "Nodal" radio button, and then the general selection dialog will be shown.

3.         Select several nodes on the model, Select "X-coordinate" on the component list. Change to "main" radio button, click plot.

4.         The 2d curves will be shown on both frame and main graphics window. like this,

 

5.         Go to "Port panel" on Frame, check the "timeline".

6.         Click on the main graphics window to hide the frame.

7.         Click "Start" on Animation Dialog, the time line will animate on the 2d curves port with the model together.

 

 

3.2 Advanced

3.2.1 Compare with Binout data using template

3.2.1.1 Binout Data preparation and requirement

More than two sets of binout data should be similar with each other. They should have the same data directory, the same data ids and component names.

 

3.2.1.2 Edit template file

Advanced user can edit command file to create template file. Here is the command document and a template file example.

 

3.2.1.3 Create template file on "Parameter" Panel

1. Open "New XYPlot Frame" on the bottom of toolbar.

2. Check the Parameter panel on the view of menu, and the Parameter panel will be shown on the left of new XYPlot frame.

 

3. Click "Start Record Template", the "Create Template" dialog will be shown. Browse files to select a file directory and set a template name. Click "Ok". At this time, user can begin to record the template file. It only supports for binout file's operations recording currently.

 

 

4. Go to binout dialog, load a binout file named "fine_arm_mesh2_MT_certChanges.binout0000".

5. Plot several curves on "Main". Such as "deforc/10500/dsiplacement", "elout/beam/10000/axial", "glstat/energy_ratio", "matsum/1/eroded_internal_energy" and so on.

6. After a new port is plotted on the frame, the curves can be operated by operation panel on the bottom of frame.

7. After a new port is plotted on the frame, the curves can be also filtered by "filter panel" on the bottom of frame.

 

8. Click the "Stop Record Template" on the "Parameter panel" to finish recording template file.

The "template panel" will be activated.

9. The template file is created correctly. In the next step, go to "3.2.1.4" step 2, 3, 4, skip step 1.

3.2.1.4 Use template file on "Template" Panel

1. Load a template file, which will run automatically to show the results.

Here is an example "plots_template.cfile "

 

The parameters "File", "LineColor", "LineStyle", "Name" will be set in the text area.

 

 

 

 

 

 

2. On "Setting Parameters" panel, Click the "Browse" on the left of parameter "File", change another binout file.

 

3. On "Setting Parameters" panel, change parameter "LineColor" to "Green", change parameter "LineStyle" to "dot", and change parameter "Name" to "Run-2".

 

4. Select the mode "Overlay", Click "Apply". The template will use new parameters("File", "LineColor", "LineStyle" and "Name") to run again.