Releases for Demo Setup Tools

Bug Fixes - minor

New Features

• Includes a function Freeze_Traces(...). The benefit of this function is to allow you to set a static snapshot of traces on a graph and then vary input parameters to see how the variations change the positions or shapes of the curves relative to the snapshot.

Improvements

• provides a way for you to develop the procedure code entirely in the global procedure window rather than relying on an external procedure file (simply use Convert_toDemo() or Convert_toDemo(exprfile=0)
• provides an option to use the current experiment name as name for the external procedure file (no input for procname and exprfile=1)
• provides a portrait mode option for layout of the graph and panel (pmode = 1 in Layout function call)
• provides an option to control the lock state on panel before conversion (plock global parameter)
• runs initialize_me() at conversion step if needed

In short, this new version allows you to develop an experiment with a graph and panel where the procedure code is in the global procedure window, include the header portion in your procedure file (with the Notebook_, Layout_, and Quit_ functions), and finally simply type DemoSetupTools#Convert_toDemo() on the command line to create a stand-alone demonstration experiment.

Revisions That Affect Previous Users

The layout and notebook functions now call functions that MUST include notestr input as a required parameter. When you revise a procedure file that had the old style ParamIsDefault(notestr) method, the compiler will now throw an error. See the documentation for how you must revise your Notebook and Layout functions. This change was made so that users who may not be entirely savvy about IgorPro coding will not have to puzzle over the ParamIsDefault approach. The state of notestr is now handled entirely in the Demo Setup Tools procedure itself (checks for an empty string instead of a missing input, as it should have done in the first place).

Improvements

This release provides you with an easier process to convert an experiment to a stand-alone demo.

• Create one procedure file for your experiment.
• #include the procedure file in the main procedure file for the experiment.
• #include the procedure file for Demo Setup Tools in the main procedure file for the experiment.
• Assure that all parts of your code are properly interfaced to the Send to Notebook, Send to Layout, and Quit menu options in the newly appearing Demo ... menu.
• Add any initialization routines that you want to your (separate) procedure file.
• Type DemoSetupTools#Convert_toDemo(procname="name of procedure file") on the command line.
• Do some minor clean up and ...

--> VOILA .... you have just created a stand-alone demo from your experiment.

This version will DELETEINCLUDE the two #included procedure files from the main procedure window and ADOPT them independently back into the experiment. You will be prompted to save a Working Copy of the unconverted experiment before the conversion process starts.