---
myst:
    substitutions:
        bloc1:
            python: 1-5,16-22,25-68,71-72
            cpp: 5-9,15-19,22-66,69-70
        bloc2:
            python: 27-32
            cpp: 24-29
---
(use_cases_macro_relauncher_key)=
# Macro "**relauncherCodeMultiTypeKey.{{extension}}**"

## Objective

The objective of this macro is to test the case where vectors and strings are produced as outputs, 
using the code described in [](#use_cases_macro_launcher_input_output_outputs), with a Key format, 
obtained by doing: 

```none
multitype -mtKey
```

The resulting output file, named `_output_multitype_mt_Key_.dat` looks like:

{{
    "```{literalinclude} " + parent_dir
    + "/usermanual/use_cases/files/_output_multitype_mt_Key_.dat"
    + "\n"
    + ":language: none\n"
    + "```"
}}

(use_cases_macro_relauncher_key_macro)=
## Macro {{uranie}}

{{
    "```{literalinclude} " + parent_dir
    + "/roottest/uranie/doc/relauncher/use_cases/" + language + "/relauncherCodeMultiTypeKey."
    + extension
    + "\n"
    + ":language: " + language + "\n"
    + ":lines: " + bloc1[language] + "\n"
    + "```"
}}

The beginning of the code is pretty common to many other macros: creating a dataserver and input 
attributes (here the only one is the seed, needed for the random generator to produce vectors and 
strings). A sampling object is created as well to produce a 100-points {{doe}} and the output 
attributes are created, as such:

{{
    "```{literalinclude} " + parent_dir
    + "/roottest/uranie/doc/relauncher/use_cases/" + language + "/relauncherCodeMultiTypeKey."
    + extension
    + "\n"
    + ":language: " + language + "\n"
    + ":lines: " + bloc2[language] + "\n"
    + "```"
}}

This is where the specificity of the vector and string is precised. It will be passed on to the 
rest of the code automatically. The rest is common to many relauncher job (for instance 
[](#use_cases_macro_relauncher_sequential)) with the only difference being that the output file is a 
key type one. It results in the following plots.

## Graph

{{
    "```{" "figure" "} " + parent_dir +
        "/roottest/build/uranie/doc/relauncher/use_cases/" + language 
        + "/key/relauncherCodeMultiTypeKey.png\n"
    ":align: center\n"
    ":name: usecases_relauncherCodeMultiTypeKey\n"
    + figure_scale + "\n"
    "\n"
    "Graph of the macro **\"relauncherCodeMultiTypeKey." + extension + "\"**\n"
    "```"
}}