Publishing an Adaptive Questionnaire
Overview
- This section covers the process of publishing a fully configured Bayesian network model as an Adaptive Questionnaire.
Prerequisites
- You need to have a Bayesian network model available that was configured with the WebSimulator Editor in BayesiaLab.
- You have successfully logged in to the WebSimulator Administration Page.
New Questionnaire Workflow
- Click the New Questionnaire button in the upper right corner of the Administration Page.
- A new pop-up window presents you with four tabs:
- Bayesian Network _ Description _ Properties
- Title Bar
Bayesian Network
- Click the Select File button to choose the Bayesian network (in XBL format) that you have configured for use with the Adaptive Questionnaire.
- Click OK to upload the selected file to the server.
- If the uploaded file meets the requirements, the message "Valid" appears behind the Select File button.
Many of the settings in this tab and the following tabs repeat options that you could have specified in the WebSimulator Editor before uploading the XBL file. As a result, many of the fields contain default values. However, you can modify any existing content by providing new values. Please note that such edits only apply "downstream" to the WebSimulator, but they will not propagate backward to your Bayesian network file.
- By default, the Name field adopts any name you specified in the Simulator tab of the WebSimulator Editor. Note that this field is mandatory.
- The same applies to the Author field. Note that the Author information will appear in the context of the properties of your model, which are available to the end-user by clicking the information icon in the published WebSimulator.
The slide-in message on the bottom-right corner of the browser window states that all observations have been removed from your model. This means that any dataset that had been associated with your XBL was immediately stripped and is no longer available on the WebSimulator Server.
Description
- The Description tab allows you to provide background and contextual information regarding your Bayesian network model.
- By default, this field adopts the Description defined in the Simulator tab of the WebSimulator Editor, which, in turn, utilizes any available Network Comments associated with the Bayesian network model.
- End-users can access the Description by clicking the Information icon in the published WebSimulator.
- If an Image was already provided in the WebSimulator Editor, the eye icon will indicate its presence. Typically, you would use an Image depicting the Bayesian network model. Clicking the eye icon provides you with a preview.
- Furthermore, you can remove any existing Image and replace it with a visual of your choice by clicking on Select File.
- Field of Study and Analysis Type allow you to characterize your Bayesian network model. Especially with public WebSimulators, it can help you direct end-users to your model.
Properties
The elements of the Properties tab repeat some of the options that are also available in the Simulator tab of the WebSimulator Editor.
- If you check the Display Variations option, the Questionnaire will highlight the impact of the pieces of evidence set by the end-user, either with respect to the previous state or the Reference State (see next item).
- If you check the Store Initial Reference State option, the Questionnaire will display variations relative to the marginal distributions of the Outputs. More specifically, the Initial Reference State refers to the probabilities and values of the marginal distribution of the Outputs before setting any observations. With this option checked, the variations will be computed as the difference between the current state and the reference state. Otherwise, the variations are computed as the difference between the current state and the previous state, i.e., before setting the most recent piece of evidence.
- For an illustration of the Layout Options, please see Layout in the WebSimulator Editor — Simulator Settings.
Title Bar
- You can specify a Logo or banner to appear in the upper left corner of your model's Questionnaire page.
- Logo URL allows you to associate a hyperlink with the Logo.
- You can specify the Title to be shown at the top of the published WebSimulator page.
- Theme Color refers to the background color of the horizontal panel at the top of your published Questionnaire.
Publishing the Questionnaire
- Once your Questionnaire is set up, you can proceed to publish it.
- From the Administration Page, select your model and then click the Publish button.
- Once you have published your model, its symbol will switch from to in the Published column of the Administration Page.
- The Sharing column indicates whether you have shared your model publicly or privately .
Public & Private Questionnaires
- Generally, you can publish your Bayesian network model as a public or a private Questionnaire. This is analogous to the options for publishing a WebSimulator.
- Depending on your subscription type, you may only have the public option available or both the public and the private.
- The dates show the respective expiration dates of your subscriptions.
Public Questionnaire
- "Public" means that anyone with an Internet connection can access the Questionnaire of the model you published.
- A public Questionnaire will also appear as a tile on the public WebSimulator homepage at https://simulator.bayesia.com (opens in a new tab). This is a great way to showcase your work to the wider world.
- By default, all BayesiaLab Professional licenses allow you to publish public Questionnaires.
Private Questionnaire
- "Private" means that you can restrict access to your Questionnaire to users whom you have given a specific URL plus a password.
- To publish private and password-protected models, you need to subscribe to a private WebSimulator Account. Please see the pricing guide for more details.
A private WebSimulator Account allows you to publish both private WebSimulators and private Adaptive Questionnaires.
- As you publish a private model, you will be prompted to create a password that will be linked to the URL of your Questionnaire.
- The password should have at least 8 characters, including at least one number.
- This means that access to your private Questionnaire is controlled by one URL and one password.
- Anyone to whom you give the URL plus the password will have access to your private Questionnaire.
- To revoke access to your private Questionnaire, you need to unpublish it.
- Even once you have subscribed to a private WebSimulator Account, you still retain your free public account and thus have both options available when publishing a model.
Be careful not to inadvertently publish a model publicly that you intended to share privately.
Show Details
- The Show Details button on the Administrator Page allows you to view all settings of the WebSimulator highlighted in the list.
- A pop-up window shows all settings specified in the New Questionnaire Workflow and also features the same tabs:
- Bayesian Network
- Description
- Properties
- Title Bar
- The Bayesian Network tab, however, provides additional elements:
- The Identifier is an automatically assigned 12-digit number that uniquely identifies your Questionnaire.
- Creation Date
- Modification Date
- Published Date
- Password reveals the password you set for the Questionnaire when you published it. For public Questionnaires, this field is blank.
- Direct URL is the URL you can share with end-users so they can go directly to your Questionnaire.
- The format of the URL follows the pattern:
https://simulator.bayesialab.com/#!simulator/Identifier
Edit Properties
- Clicking the Edit Properties button allows you to modify the properties that you previously specified in the New Questionnaire Workflow or, before that, in the WebSimulator Editor.
- Edit Properties is only available for unpublished Questionnaires. If you wish to modify a currently published Questionnaire, you first need to click the Unpublish button on the Administration Page.
- Upon modification, you can click Publish to republish your Questionnaire again.
Run
- Clicking the Run button opens up your Questionnaire so you can see it and use it like an end-user.
- More specifically, your browser opens the URL
https://simulator.bayesialab.com/#!simulator/Identifier
- This is now the live version of the Questionnaire, of which you could previously only launch a static preview from the WebSimulator Editor.