BayesiaLab
Publishing a Websimulator

Publishing a WebSimulator

Context

  • This section covers the process of publishing a fully configured Bayesian network model as a WebSimulator.

Prerequisites

New Simulator Workflow

  • Click the New Simulator 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 WebSimulator.
  • 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 to the WebSimulator Server. 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 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. This can help you direct end-users to your model, especially with public WebSimulators.

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, your model's WebSimulator will highlight the impact of the pieces of evidence set by the end-user.
  • If you check the Store Initial Reference State option, the WebSimulator will display variations relative to the marginal distributions of the Outputs.
  • 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 WebSimulator 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 WebSimulator.

Publishing the Simulator

  • Once your WebSimulator 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 WebSimulator

  • You can generally publish your Bayesian network model as a public or a private 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 WebSimulator

  • "Public" means that anyone with an Internet connection can access the WebSimulator of your published model.
  • A public WebSimulator 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 WebSimulators.

Private WebSimulator

  • "Private" means that you can restrict access to your WebSimulator 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 WebSimulator.
  • The password should have at least 8 characters, including at least one number.
  • This means that access to your private WebSimulator is controlled by one URL and one password.
  • Anyone to whom you give the URL plus the password will have access to your private WebSimulator.
  • To revoke access to your private WebSimulator, you need to unpublish it.
  • Even once you have subscribed to a private WebSimulator account, you still retain your free public account, so you 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 the WebSimulator settings highlighted in the list.
  • A pop-up window shows all settings specified in the New Simulator 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 WebSimulator.
    • Creation Date
    • Modification Date
    • Published Date
    • Password reveals the password you set for the WebSimulator when you published it. For public WebSimulators, this field is blank.
    • Direct URL is the URL you can share with end-users so they can go directly to your WebSimulator.
    • 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 Simulator Workflow or, before that, in the WebSimulator Editor.
  • Edit Properties is only available for unpublished WebSimulators. If you wish to modify a currently published WebSimulator, you must first click the Unpublish button on the Administration Page.
  • Upon modification, you can click Publish to republish your WebSimulator again.

Run

  • Clicking the Run button opens up your WebSimulator so you can see it and use it as an end-user.
  • More specifically, your browser opens the URL https://simulator.bayesialab.com/#!simulator/Identifier
  • This is now the live version of the WebSimulator, of which you could previously only launch a static preview in the WebSimulator Editor.

For North America

Bayesia USA

4235 Hillsboro Pike
Suite 300-688
Nashville, TN 37215, USA

+1 888-386-8383
info@bayesia.us

Head Office

Bayesia S.A.S.

Parc Ceres, Batiment N 21
rue Ferdinand Buisson
53810 Change, France

For Asia/Pacific

Bayesia Singapore

1 Fusionopolis Place
#03-20 Galaxis
Singapore 138522


Copyright © 2024 Bayesia S.A.S., Bayesia USA, LLC, and Bayesia Singapore Pte. Ltd. All Rights Reserved.