---

[% INCLUDE header.us3/ title = 'UltraScan III Load Model Distributions' %]

UltraScan Load Model Distributions:

A number of UltraScan III applications load model distribution data for processing. These applications use the US_ModelLoader dialog class to allow the user to choose the model(s).

The dialog presented when a US_ModelLoader is executed allows a list of model choices from local disk or from the database. A Search button and text field allow the list to be pared down to those of interest. After a model or set of models is selected in the list, an Accept button passes model data to the caller.

Database Check this radio button to generate a list from the database. Local Disk Check this radio button to generate a model list from local disk */ultrascan/data/models files. Select Investigator Click on this button to open an Investigator Dialog that enables you to browse potential database investigators and select one. This button is diabled for normal unprivileged users and when Local Disk is selected. (investigator text) This read-only text box displays the current investigator identifier number, last name, and first name. Search As characters are typed in the search text box, the list of models is pared down to those whose description matches the search field. Note that the search is case-insensitive. Enter a blank field to restore the full list. See detailed notes below on special search field text. (model list) The list of model descriptions is generated either from local disk or db. Click on one or more entries to indicate your choice(s) of data to load. Click an entry with the right mouse button to get a Model Information Dialog detailing model information. If models are selected, a right-mouse-button click displays information for all selected model entries. If there are no selections, the right-mouse-button click gives information for the row at which the cursor is positioned. Help Click to bring up this documentation. Cancel Click to close the dialog with no choices made. Accept Click to accept the choice(s) highlighted in the model list and pass distribution data to the caller.

Search Field Details:

Text you enter in the search field limits the models listed to those that match the implied criteria. In the simpliest and most common case, a string entered pares down the list to models whose description contains the given phrase without regard to case. For example, a search field of "mc" results in models with "mc", "MC", "Mc", or "mC" in their descriptions.

The search field "=edit" results in only models that derive from a specific edited data set. This facility applies in applications that preceed the model loader dialog with an edited velocity data set loader dialog.

Another special field - "=s" - designates that Monte Carlo model sets normally presented as a composite model be separated out into each of the single models comprising the group. Use of this field should rarely be needed and be limited to advanced or developer users. If used, it may be combined with other fields. So, entries like "=s demo1", "demo1=s", "=edit=s" can be used to specify "single MC models" as well as a description filter on the list.

[% INCLUDE footer.us3 %]