---
myst:
    substitutions:
        bloc1:
            python: 1-5,15-24
            cpp: 3-6,11-16
        bloc2:
            python: "17"
            cpp: "11"
        bloc3:
            python: "19"
            cpp: "13"
        bloc4:
            python: "24"
            cpp: "16"
---
(use_cases_macro_dataserver_ionosphere)=
# Macro "**dataserverLoadASCIIFileIonosphere.{{extension}}**"

## Objective

The objective of this macro is to load the ASCII data file `ionosphere.dat` which defines 34 input 
variables and one output variable **y** and applies visualisation on one of these variables. The data 
file `ionosphere.dat` is in the "Salome-table" format of {{uranie}} but is not shown for convenience.

## Macro {{uranie}}

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

The {{tds}} is filled with `ionosphere.dat` with the `fileDataRead` method

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

A new title is set for the variable **x28**

{{
    "```{literalinclude} " + parent_dir
    + "/roottest/uranie/doc/dataserver/use_cases/" + language + "/dataserverLoadASCIIFileIonosphere." 
    + extension 
    + "\n"
    + ":language: " + language + "\n"
    + ":lines: " + bloc3[language] + "\n"
    + "```"
}}

This variable is then drawn with its new title

{{
    "```{literalinclude} " + parent_dir
    + "/roottest/uranie/doc/dataserver/use_cases/" + language + "/dataserverLoadASCIIFileIonosphere." 
    + extension 
    + "\n"
    + ":language: " + language + "\n"
    + ":lines: " + bloc4[language] + "\n"
    + "```"
}}

## Graph

{{
    "```{" "figure" "} " + parent_dir +
        "/roottest/build/uranie/doc/dataserver/use_cases/" + language 
        + "/dataserverLoadASCIIFileIonosphere.png\n"
    ":align: center\n"
    ":name: usecases_dataserverLoadASCIIFileIonosphere\n"
    + figure_scale + "\n"
    "\n"
    "Graph of the macro `\"dataserverLoadASCIIFileIonosphere." + extension + "\"`\n"
    "```"
}}