visual3d:documentation:pipeline:general_information:recalc_pipeline
This is an old revision of the document!
, click the 'open pipeline' button and append the saved pipeline to the existing recalc pipeline.
recalc_pipeline.jpg
by adding the calculations to the recalc pipeline, these will be recalculated when the recalc button is pressed. the recalc pipeline is saved in the .cmo file so it will always be there, and it is also saved in the report template so that when you open the report the items which should be recalculated (or calculated for a first time) are performed.
==== saving the recalc pipeline ====
if the button is checked to display the recalc pipeline, the pipeline list box will be shaded pink.
selecting the button to save the pipeline will save the contents of the recalc pipeline.
selecting the button to open the pipeline will either replace or append the existing recalc pipeline.
deleting the recalc pipeline will remove the recalc pipeline from the workspace.
==== opening a report template ====
when a report template is added to the workspace, all of the report graphs are deleted and all of the model based data definitions contained in the report template are appended to the **cmo recalc script**. for design reasons we elected not to delete the existing model based data because we felt it was easier for users to delete entries from the **cmo recalc script** than to re-create the model based data that they created before opening the report template. however, when the **recalc** button is pressed, the old compute model based signals will be **removed** from the recalc pipeline.
==== recalc pipeline processing acts on the active files ====
by default, all_files are active for the recalc pipeline.
it is possible to %22trick%22 visual3d by inserting select_active_file commands into the recalc pipeline, which allows you to selectively determine which files are being re-processed, but you need to be careful because the recalc pipeline is a critical part of the report template, so only do this when you want the changes to persist in your report template.
==== removing a signal from the workspace ====
if a signal is defined in the recalc pipeline, removing (or) renaming the signal in the data tree won't do the trick. as soon as the recalc pipeline is executed the signal will re-appear. you need to remove the signal from both the recalc pipeline and the data tree.
all model based signals are automatically added to the recalc pipeline when they are created.
visual3d checks for duplicate entries in the recalc pipeline, but it is possible that a user can inadvertently add duplicates to the pipeline.
==== warning about editing the recalc pipeline ====
removing an item from the recalc pipeline does not remove the item from the data tree (e.g. the workspace). the signal in the data tree no longer has a definition, however, so changing the properties of the model, which would normally change the related model based signals, will not modify the signal as expected.
if you aren't sure, you can save the cmo file, then remove all the model based signals from the data tree, select recalc and see what signals didn't re-appear.
if you are missing a specific signal, re-open the saved cmo file and check the history of the signal missing from the recalc pipeline. version 4.5 of visual3d allows you to copy the history (e.g. the model based definition), so you can paste it into the recalc pipeline.
==== modifying the definition of model based items in the recalc pipeline ====
you can edit the commands in the recalc pipeline directly. in the pipeline dialog, select the button (check box) to make the recalc pipeline editable and edit a command.
you can also select compute model based data under the model menu option, and edit the definition there. visual3d will automatically search for a model based signal of the same name in the data tree and replace the properties.){kind=link}
visual3d/documentation/pipeline/general_information/recalc_pipeline.1718801464.txt.gz · Last modified: 2024/06/19 12:51 by sgranger