PTM Project Workflow: Difference between revisions

From XMS Wiki
Jump to navigationJump to search
No edit summary
No edit summary
 
(3 intermediate revisions by the same user not shown)
Line 8: Line 8:
|
|
: Typically a completed ADCIRC simulation is used. See the [[ADCRIC Project Workflow]] for more information.
: Typically a completed ADCIRC simulation is used. See the [[ADCRIC Project Workflow]] for more information.
:* For simulations completed using other models, [[PTM Data Conversion Workflow|convert the data]] for use with PTM.
|}
|}
{|class="mw-collapsible mw-collapsed" style="width:80%; border:1px solid #D0E0FF; margin-bottom:0.4em;"
{|class="mw-collapsible mw-collapsed" style="width:80%; border:1px solid #D0E0FF; margin-bottom:0.4em;"
Line 32: Line 33:
|-
|-
|
|
:# Check model simulation.
:# [[SMS:Model Checker|Check model]] simulation.
:# [[SMS:PTM_Graphical_Interface#Running_the_Model|Run PTM]].  
:# [[SMS:PTM_Graphical_Interface#Running_the_Model|Run PTM]].  
|}
|}

Latest revision as of 14:06, 6 September 2016

This workflow includes specific workflows needed in creating a general PTM project.

To build a PTM model in SMS, use the following:

1. Start with a completed model simulation as background data.
Typically a completed ADCIRC simulation is used. See the ADCRIC Project Workflow for more information.
  • For simulations completed using other models, convert the data for use with PTM.
2. Define PTM sources.
1. Create a PTM map coverage.
Create a new coverage with the "PTM" type.
1. Create new coverage from scratch.
  1. Select Map Data in the Project Explorer and use the New Coverage right-click command.
  2. Use the New Coverage dialog to create a new coverage by selecting the desired coverage type, and naming the coverage.
2. Create new coverage from an existing coverage.
  1. Use the Duplicate command on an existing coverage. This will copy any feature objects on the coverage.
  2. Use the Rename command to give the coverage a new name.
  3. Change the coverage type.
2. Create the particle source or trap feature objects.
In the PTM coverage, create feature arcs or points for the particle source or traps.
1. Create feature arcs, nodes and vertices.
In the Map module, create feature objects in the active coverage.
  1. Use the Create Feature Arc SMS Create Arc Tool.svg tool to create arcs in the map coverage.
  2. Begin creating a new arc by clicking in the Graphics Window at either arc end. If clicking on an existing feature node, vertex or arc, the new arc will snap to that object.
  3. Double-click or press the Enter key to terminate the arc.
  4. Use the Create Feature Node Create Points Tool.svg tool to create additional nodes alone or to split arcs.
2. Modify arcs.
Feature arcs often need to be edited after initial creation.
1. Create additional vertices on arcs.
  1. Use the Create Feature Vertex SMS Create Vertex Tool.svg tool to add vertices along arcs.
2. Refine the arc shape.
  1. Use the Select Feature Vertex SMS Select Vertex Tool.svg tool and the Select Feature Node SMS Select Node Tool.svg tool to move/edit existing arcs and refine the shape by dragging the nodes/vertices.
  2. Use the Select Feature Arc SMS Select Arc Tool.svg tool to move entire arcs .
3. Split arcs.
An existing arc can be split by:
1. Converting a vertex to a node.
  1. Use the Select Feature Vertex SMS Select Vertex Tool.svg tool and right-click on a vertex along an arc.
  2. Select the Convert to Node command to split the arc into two arcs.
2. Add a node the arc.
  1. Use the Create Feature Node Create Points Tool.svg tool to add a node on an arc in order to split it into two arcs.
3. Add a new connecting arc.
  1. Use the Create Feature Arc SMS Create Arc Tool.svg tool to start or end a new arc on an existing arc to split the existing arc into two arcs.
4. Use the Split Arcs Tool.
  1. Right-click on an arc using the Select Feature Arc SMS Select Arc Tool.svg tool and select the Split Arc(s)... command.
  2. Use the Split Arcs Tool to divide arcs.
5. Split overlapping arcs using the Clean Options dialog.
  1. Select overlapping arcs using the Select Feature Arc SMS Select Arc Tool.svg tool.
  2. Use the Feature Objects | Clean command to bring up the Clean Options dialog.
  3. Select the Intersect selected arcs option (for selected arcs) or Intersect arcs option (for all overlapping arcs) to split the arcs.
4. Merge arcs.
Two arcs that share an end node can be merged together.
  1. Select the shared node using the Select Feature Node SMS Select Node Tool.svg tool.
  2. Right-click on the node and select the Convert to Vertex command to merge the arcs.
  3. If desired, the Select Feature Vertex SMS Select Vertex Tool.svg tool can be used to select and delete the new vertex.
5. Smooth arcs.
The variability or roughness of an arc can be reduced.
  1. Right-click on an arc using the Select Feature Arc SMS Select Arc Tool.svg tool and select the Smooth Arc(s)... command.
  2. Use the Smooth Arcs Tool to reduce the variability of the arc.
6. Prune arcs.
Concave sections of the arc can be removed.
  1. Right-click on an arc using the Select Feature Arc SMS Select Arc Tool.svg tool and select the Prune Arc(s)... command.
  2. Use the Prune Arcs dialog to remove concave sections.
7. Extend/trim arcs.
Extend or shorten an arc to match an existing arc's length.
  1. Using the Select Feature Arc SMS Select Arc Tool.svg tool, select two intersecting arcs.
  2. Right-click on an arc using the Select Feature Arc SMS Select Arc Tool.svg tool and select the Extend/Trim Arc... command.
  3. Use the Trim/Extend Arc dialog to select the target arc and source arc.
3. Assign source attributes.
  1. Using the Select Feature Arc SMS Select Arc Tool.svg or Select Feature Point or Node SMS Select Node Tool.svg tool, double-click on the particle source object.
  2. Define the particle source in the Feature Object Attributes dialog. Sources can be defined for:
4. Assign trap attributes.
  1. Using the Select Feature Arc SMS Select Arc Tool.svg or Select Feature Point or Node SMS Select Node Tool.svg tool, double-click on the particle source object.
  2. Define the particle trap in the Feature Object Attributes dialog. Traps can be defined for:
3. Define PTM model parameters.
1. Create a PTM simulation.
  1. Switch to the Particle module Particle Set Icon.svg.
  2. Select the PTM | New Simulation menu command.
2. Define the PTM model parameters in the model control.
  1. Select the PTM | Model Control menu command.
  2. Enter simulation parameters in the PTM Model Control dialog, including:
4. Run the PTM simulation.
  1. Check model simulation.
  2. Run PTM.
5. Review results.
1. Load solution files.
The solution file should load after running the model assuming the Load Solution option was checked in the model wrapper before exiting the model run. If loading the solution file separately from the model run, do the following:
  1. Open the output files generated from the model run.
2. Review results datasets and data visualization.
1. Manually review dataset solutions.
  1. In the Project Explorer, click on solution dataset created from the simulation run and view results in the Graphics Window.
  2. Click through the time steps for each dataset to see changes over time in the Graphics Window.
2. Adjust the display options.
1. Set display options.
  1. Open the Display Options Display Options Macro.svg dialog.
  2. Set the general display options.
  3. Set general lighting options.
  4. Set display options for each module that is being used.
  5. Set contour options.
  6. Set vector options.
2. View display.
  1. Use the Rotate Rotate Tool.svg, Pan Pan Tool.svg, and Zoom Zoom Tool Icon.svg tools.
  2. Use the View menu commands found in the Display menu.
  3. Use the Frame Frame Macro.svg command to center and resize the display as needed.
3. Adjust display.
Display may need to be adjusted during the remainder of the project.
  1. Use the Display Options dialog and viewing tools as needed.
  2. Use the Frame Frame Macro.svg command to center and resize the display as needed.
3. Create a film loop visualization.
  1. Select a solution dataset and use the Data | Film Loop menu command.
  2. Use the Film Loop Setup wizard to specify the animation parameters.
  3. Save and view the animation file.
4. Create a plot.
1. Load solution files if not already in the project.
  1. The solution should load automatically assuming the Load Solution option was checked in the model wrapper before exiting the model run.
  2. If loading the solution separately from the model run, open the solution file generated from model run.
2. Create an observation coverage.
Create a new coverage with the "Observation" type.
  1. Select Map Data in the Project Explorer and use the New Coverage right-click command.
  2. Use the New Coverage dialog to create a new coverage by selecting the desired coverage type, and naming the coverage.
3. Create observation points in the observation coverage.
1. Create feature arcs, nodes and vertices.
In the Map module, create feature objects in the active coverage.
  1. Use the Create Feature Arc SMS Create Arc Tool.svg tool to create arcs in the map coverage.
  2. Begin creating a new arc by clicking in the Graphics Window at either arc end. If clicking on an existing feature node, vertex or arc, the new arc will snap to that object.
  3. Double-click or press the Enter key to terminate the arc.
  4. Use the Create Feature Node Create Points Tool.svg tool to create additional nodes alone or to split arcs.
2. Modify arcs.
Feature arcs often need to be edited after initial creation.
1. Create additional vertices on arcs.
  1. Use the Create Feature Vertex SMS Create Vertex Tool.svg tool to add vertices along arcs.
2. Refine the arc shape.
  1. Use the Select Feature Vertex SMS Select Vertex Tool.svg tool and the Select Feature Node SMS Select Node Tool.svg tool to move/edit existing arcs and refine the shape by dragging the nodes/vertices.
  2. Use the Select Feature Arc SMS Select Arc Tool.svg tool to move entire arcs .
3. Split arcs.
An existing arc can be split by:
1. Converting a vertex to a node.
  1. Use the Select Feature Vertex SMS Select Vertex Tool.svg tool and right-click on a vertex along an arc.
  2. Select the Convert to Node command to split the arc into two arcs.
2. Add a node the arc.
  1. Use the Create Feature Node Create Points Tool.svg tool to add a node on an arc in order to split it into two arcs.
3. Add a new connecting arc.
  1. Use the Create Feature Arc SMS Create Arc Tool.svg tool to start or end a new arc on an existing arc to split the existing arc into two arcs.
4. Use the Split Arcs Tool.
  1. Right-click on an arc using the Select Feature Arc SMS Select Arc Tool.svg tool and select the Split Arc(s)... command.
  2. Use the Split Arcs Tool to divide arcs.
5. Split overlapping arcs using the Clean Options dialog.
  1. Select overlapping arcs using the Select Feature Arc SMS Select Arc Tool.svg tool.
  2. Use the Feature Objects | Clean command to bring up the Clean Options dialog.
  3. Select the Intersect selected arcs option (for selected arcs) or Intersect arcs option (for all overlapping arcs) to split the arcs.
4. Merge arcs.
Two arcs that share an end node can be merged together.
  1. Select the shared node using the Select Feature Node SMS Select Node Tool.svg tool.
  2. Right-click on the node and select the Convert to Vertex command to merge the arcs.
  3. If desired, the Select Feature Vertex SMS Select Vertex Tool.svg tool can be used to select and delete the new vertex.
5. Smooth arcs.
The variability or roughness of an arc can be reduced.
  1. Right-click on an arc using the Select Feature Arc SMS Select Arc Tool.svg tool and select the Smooth Arc(s)... command.
  2. Use the Smooth Arcs Tool to reduce the variability of the arc.
6. Prune arcs.
Concave sections of the arc can be removed.
  1. Right-click on an arc using the Select Feature Arc SMS Select Arc Tool.svg tool and select the Prune Arc(s)... command.
  2. Use the Prune Arcs dialog to remove concave sections.
7. Extend/trim arcs.
Extend or shorten an arc to match an existing arc's length.
  1. Using the Select Feature Arc SMS Select Arc Tool.svg tool, select two intersecting arcs.
  2. Right-click on an arc using the Select Feature Arc SMS Select Arc Tool.svg tool and select the Extend/Trim Arc... command.
  3. Use the Trim/Extend Arc dialog to select the target arc and source arc.
4. Add observation point attributes.
  1. With the Select Feature Point SMS Select Node Tool.svg tool, right-click on the observation point and select the Node Attributes command.
  2. Set the observation attributes in the Observation Coverage dialog.
5. Use the Plot Wizard to generate plot type.
The Plot Wizard can generate any of the following plot types:
1. Computed vs. Observed Data plot.
  1. Select Display | Plot Wizard to start the Plot Wizard.
  2. Select the "Computed vs. Observed Data" option on the left and click Next.
  3. Review measurements to be plotted in step 2 of the Plot Wizard then click Finish.
  4. Review plot window.
2. Residual vs. Observed Data plot.
  1. Select Display | Plot Wizard to start the Plot Wizard.
  2. Select the "Residual vs. Observed Data" option on the left and click Next.
  3. Review measurements to be plotted in step 2 of the Plot Wizard then click Finish.
  4. Review plot window.
3. Error vs. Simulation plot.
  1. Select Display | Plot Wizard to start the Plot Wizard.
  2. Select the "Error vs. Simulation" option on the left and click Next.
  3. Specify plot options in step 2 of the Plot Wizard then click Finish.
  4. Review plot window.
4. Error vs. Time Step plot.
  1. Select Display | Plot Wizard to start the Plot Wizard.
  2. Select the "Error vs. Time Step" option on the left and click Next.
  3. Specify plot options in step 2 of the Plot Wizard then click Finish.
  4. Review plot window.
5. Error Summary plot.
  1. Select Display | Plot Wizard to start the Plot Wizard.
  2. Select the "Error Summary" option on the left and click Next.
  3. Specify measurements to be plotted in step 2 of the Plot Wizard then click Finish.
  4. Review plot window.
6. Time Series plot.
  1. Select Display | Plot Wizard to start the Plot Wizard.
  2. Select the "Time Series" option on the left and click Next.
  3. Specify plot options in step 2 of the Plot Wizard then click Finish.
  4. Review plot window.
3. Use an observation profile plot.
1. Create an observation coverage.
Create a new coverage with the "Observation" type.
  1. Select Map Data in the Project Explorer and use the New Coverage right-click command.
  2. Use the New Coverage dialog to create a new coverage by selecting the desired coverage type, and naming the coverage.
2. Create observation arcs in the observation coverage.
1. Create feature arcs, nodes and vertices.
In the Map module, create feature objects in the active coverage.
  1. Use the Create Feature Arc SMS Create Arc Tool.svg tool to create arcs in the map coverage.
  2. Begin creating a new arc by clicking in the Graphics Window at either arc end. If clicking on an existing feature node, vertex or arc, the new arc will snap to that object.
  3. Double-click or press the Enter key to terminate the arc.
  4. Use the Create Feature Node Create Points Tool.svg tool to create additional nodes alone or to split arcs.
2. Modify arcs.
Feature arcs often need to be edited after initial creation.
1. Create additional vertices on arcs.
  1. Use the Create Feature Vertex SMS Create Vertex Tool.svg tool to add vertices along arcs.
2. Refine the arc shape.
  1. Use the Select Feature Vertex SMS Select Vertex Tool.svg tool and the Select Feature Node SMS Select Node Tool.svg tool to move/edit existing arcs and refine the shape by dragging the nodes/vertices.
  2. Use the Select Feature Arc SMS Select Arc Tool.svg tool to move entire arcs .
3. Split arcs.
An existing arc can be split by:
1. Converting a vertex to a node.
  1. Use the Select Feature Vertex SMS Select Vertex Tool.svg tool and right-click on a vertex along an arc.
  2. Select the Convert to Node command to split the arc into two arcs.
2. Add a node the arc.
  1. Use the Create Feature Node Create Points Tool.svg tool to add a node on an arc in order to split it into two arcs.
3. Add a new connecting arc.
  1. Use the Create Feature Arc SMS Create Arc Tool.svg tool to start or end a new arc on an existing arc to split the existing arc into two arcs.
4. Use the Split Arcs Tool.
  1. Right-click on an arc using the Select Feature Arc SMS Select Arc Tool.svg tool and select the Split Arc(s)... command.
  2. Use the Split Arcs Tool to divide arcs.
5. Split overlapping arcs using the Clean Options dialog.
  1. Select overlapping arcs using the Select Feature Arc SMS Select Arc Tool.svg tool.
  2. Use the Feature Objects | Clean command to bring up the Clean Options dialog.
  3. Select the Intersect selected arcs option (for selected arcs) or Intersect arcs option (for all overlapping arcs) to split the arcs.
4. Merge arcs.
Two arcs that share an end node can be merged together.
  1. Select the shared node using the Select Feature Node SMS Select Node Tool.svg tool.
  2. Right-click on the node and select the Convert to Vertex command to merge the arcs.
  3. If desired, the Select Feature Vertex SMS Select Vertex Tool.svg tool can be used to select and delete the new vertex.
5. Smooth arcs.
The variability or roughness of an arc can be reduced.
  1. Right-click on an arc using the Select Feature Arc SMS Select Arc Tool.svg tool and select the Smooth Arc(s)... command.
  2. Use the Smooth Arcs Tool to reduce the variability of the arc.
6. Prune arcs.
Concave sections of the arc can be removed.
  1. Right-click on an arc using the Select Feature Arc SMS Select Arc Tool.svg tool and select the Prune Arc(s)... command.
  2. Use the Prune Arcs dialog to remove concave sections.
7. Extend/trim arcs.
Extend or shorten an arc to match an existing arc's length.
  1. Using the Select Feature Arc SMS Select Arc Tool.svg tool, select two intersecting arcs.
  2. Right-click on an arc using the Select Feature Arc SMS Select Arc Tool.svg tool and select the Extend/Trim Arc... command.
  3. Use the Trim/Extend Arc dialog to select the target arc and source arc.
3. Create an observation plot.
  1. Select Display | Plot Wizard to start the Plot Wizard.
  2. Select the "Observation Profile" option on the left and click Next.
  3. Select arcs, datasets, and time steps to be plotted.
  4. Review plot window.
4. Create and compare datasets.
  1. Select the Data | Dataset Toolbox menu command.
  2. In the Dataset Toolbox, compare datasets by subtracting the alternate dataset from the base dataset.
  3. New dataset can be generated in the Dataset Toolbox using the Data Calculator.