Configuration#

Introduction#

In this section you will learn how to customize GAMS MIRO. As you saw previously when creating your first app, MIRO launches without any further configuration. However, there are many configuration options to adapt MIRO to your specific model.

The configuration is done via a graphical configuration interface, with which you can create plots and widgets or change certain settings with a few mouse clicks, visually supported by a live preview. In addition, the configuration can also be done manually via a JSON file. In fact, all the graphical Configuration Mode does is create this JSON file.

Custom visualization options

Configuration Mode#

This chapter shows how to configure MIRO using the graphical interface. For those who feel more comfortable writing JSON, the section Configuration via JSON shows how to configure a MIRO app without using the graphical interface.

The Configuration Mode is directly accessible via GAMS Studio:

start the Configuration Mode

To launch the Configuration Mode via the command line, the environment variable MIRO_MODE=config needs to be set instead of MIRO_MODE=base. The other steps (see here) remain the same.

Note

Changes made in Configuration Mode take effect after a restart of the MIRO application.

The Configuration Mode is categorized as follows:

General settings

Appearance and general behavior of the app

configuration_general.html

Symbols

Symbol naming, ordering, grouping, etc.

configuration_symbols.html

Tables

Global table and individual output table settings

configuration_tables.html

Input widgets

How to communicate input data with GAMS

widgets.html

Graphs

Visualization of input and output data

charts.html

Colors

Configure custom themes

configuration_colors.html

Database management

Backup, restore or remove the database

configuration_database.html

Options not Available in Configuration Mode#

With the Configuration Mode we pursue the goal that a user can completely configure a MIRO application without having to write any JSON code. However, there are a few advanced options that are not yet available in the Configuration Mode and must be configured manually. The following sections describe these options:

Advanced topics#

The following more advanced topics are covered in subsequent chapters: