Page Elements are objects that allow users to upload, view, and interact with data within Virtualitics Predict.

Elements comprise the base of the Page hierarchy. A Page is a collection of Elements organized logically using Sections and/or Cards.

Element Types

The following types of Elements are supported in Virtualitics Predict:

• InputElement: Allow users to provide input to Virtualitics Predict, including the following types of input:
  • Dropdown: Facilitates the creation of a dropdown menu; a user may select one or more options (multi-select) displayed in a Dropdown element.
  • DateTimeRange: Allows users to specify date/time ranges.
  • DataSource: Allows users to select/upload data.
  • TextInput: Allows users to provide text input.
  • NumericRange: Allows users to specify a numeric range.
  • CustomEvent: Allows users to call custom functions (via the callback() method) by clicking an element in Virtualitics Predict.
  • AssetSelection: Allows users to search available Assets (by label/type) in an instance of Virtualitics Predict.
• Image: Render an image within a Card.
  
  
• Infographic: Display high impact metrics for immediate consumption quickly and clearly. Within an Infographic object, users may define:
  • InfographData: Object containing a label and text for the presented metric (information block); users may optionally define:
    • A unit for the presented metric (days, meters, etc.)
    • An icon in the top right corner of the information block (must be an icon in the set of Google Material Icons)
    • InfographDataType: Sets icon types/colors for the information block; supported values are:
      • InfographDataType.INFO
      • InfographDataType.POSITIVE
      • InfographDataType.NEGATIVE
      • InfographDataType.WARNING
      • InfographDataType.NEUTRAL
    • InfographicOrientation: Optionally define how information blocks are arranged in an infographic; supported values include:
      • InfographOrientation.ROW (horizontal arrangement)
      • InforgraphOrientation.COLUMN (vertical arrangement)
  • An event that triggers a backend action (see CustomEvent)
• Plot: Display a plot without the use of Explore; supported plot types include:
  • Scatter
  • Plotly
  • Waterfall
  • Bar
  • Line
• Table: Allows users to display data in a table.
• Dashboard: Allows users to arrange displayed tables, charts, and any other content on a Page in an easily consumable manner.
  • Dashboards may be used to customize how Page Elements appear relative to each other.
  • Dashboards are particularly useful when creating Pages for different personas within a Flow.
    • For example, assume you have written a Flow that requires a ML model. In addition to Pages/Steps where you train your model, you may also want:
      • A Dashboard presenting impact metrics and calls to actions for executives,
      • A Dashboard with visualizations conveying the performance of your ML model for analysts/business development executives, and
      • A Dashboard allowing data scientists to probe the innards of a machine learning model.
  • With the use of Assets, you could even create a Flow consisting of the Steps/Pages used to the train models (where a trained model is saved as an Asset) and separate Flows/persona (each Flow containing the Dashboard(s) for the relevant persona).
    
    
• XAIDashboard: Place the Scenario Planning Tool (SPT) on a Page, allowing users to explore machine learning models by modifying inputs and observing changes in outputs.

Please refer to the Virtualitics SDK for complete technical documentation of each Page Element type.

Using Page Elements

Page Elements are also ubiquitous in Virtualitics Predict. Since Flows require at least one Page, Flows will likely contain at least one Page Element. The type of Page Element you need depends on what you are looking to accomplish on the Page.

Here are some examples of when you would need to use a Page Element:

• You want to display an infographic to summarize the performance of your ML models. You would create an element of type Infographic and likely place it in a Dashboard.
• You want to display an image you created in matplotlib. You would use Virtualitics Predict convenience functions to create an image and pass the content (bytes) of that image to an Image element.
• You want to allow the user to select one or more items from a dropdown menu (their selection(s) will be used later in the Flow). You would create an element of type Dropdown, passing in the options available to the user.