disc_from_exe module¶

Make a discipline from an executable¶

Classes:

`DiscFromExe`(input_template, output_template, …)	Generic wrapper for executables.
`FoldersIter`(value)	An enumeration.
`Parsers`(value)	An enumeration.

Functions:

`parse_key_value_file`(_, out_lines[, separator])	Parse the output file from the expected text positions.
`parse_outfile`(output_positions, out_lines)	Parse the output file from the expected text positions.
`parse_template`(template_lines, grammar_is_input)	Parse the input or output template.
`write_input_file`(input_file_path, data, …)	Write the input file from the input data.

class gemseo.wrappers.disc_from_exe.DiscFromExe(input_template, output_template, output_folder_basepath, executable_command, input_filename, output_filename, folders_iter=<FoldersIter.NUMBERED: 0>, name=None, parse_outfile_method=<Parsers.TEMPLATE_PARSER: 1>, write_input_file_method=None, parse_out_separator='=', use_shell=True)[source]¶

Bases: gemseo.core.discipline.MDODiscipline

Generic wrapper for executables.

The DiscFromExe is a generic wrapper for executables. It generates a MDODiscipline from an executable and in inputs/output files wrappers. The input and output files are described by templates. The templates can be generated by executing the module template_grammar_editor to open a GUI.

It requires the creation of templates for input and output file, for instance, from the following input JSON file:
{
"a": 1.01515112125,
"b": 2.00151511213,
"c": 3.00151511213
}
A template that declares the inputs must be generated under this format, where “a” is the name of the input, and “1.0” is the default input. GEMSEO_INPUT declares an input, GEMSEO_OUTPUT declares an output, similarly.
{
"a": GEMSEO_INPUT{a::1.0},
"b": GEMSEO_INPUT{b::2.0},
"c": GEMSEO_INPUT{c::3.0}
}

Current limitations :

Only one input and one output file, otherwise,

inherit from this class and modify the parsers. Only limited input writing and output parser strategies are implemented. To change that, you can pass custom parsing and writing methods to the constructor.

The only limitation in the current file format is that

it must be a plain text file and not a binary file. In this case, the way of interfacing it is to provide a specific parser to the DiscFromExe, with the write_input_file_method and parse_outfile_method arguments of the constructor.

Attributes

input_template (str) – The path to the input template file.
ouput_template (str) – The path to the output template file.
input_filename (str) – The name of the input file.
output_filename (str) – The name of the ouput file.
executable_command (str) – The executable command.
parse_outfile (Callable[Mapping[str, Tuple[int]], Sequence[str]]) – The function used to parse the output file.
write_input_file – (Callable[str, Mapping[str, ndarray], Mapping[str, Tuple[int]], Sequence[int], str): The function used to write the input file.
folder_iter (str) – The method to be used to name new execution directories.
output_folder_basepath (str) – The base path of the execution directories.
data_processor (DataProcessor) – A data processor to be used before the execution of the discipline.

Parameters

input_template (str) –
output_template (str) –
output_folder_basepath (str) –
executable_command (str) –
input_filename (str) –
output_filename (str) –
folders_iter (Union[str, FoldersIter]) –
name (Optional[str]) –
parse_outfile_method (Union[str, Parsers]) –
write_input_file_method (Optional[str]) –
parse_out_separator (str) –
use_shell (bool) –

Return type

None

Constructor.

Parameters

name (Optional[str]) – the name of the discipline
input_grammar_file – the file for input grammar description, if None, name + “_input.json” is used
output_grammar_file – the file for output grammar description, if None, name + “_output.json” is used
auto_detect_grammar_files – if no input and output grammar files are provided, auto_detect_grammar_files uses a naming convention to associate a grammar file to a discipline: searches in the “comp_dir” directory containing the discipline source file for files basenames self.name _input.json and self.name _output.json
grammar_type – the type of grammar to use for IO declaration either JSON_GRAMMAR_TYPE or SIMPLE_GRAMMAR_TYPE
cache_type – type of cache policy, SIMPLE_CACHE or HDF5_CACHE
cache_file_path – the file to store the data, mandatory when HDF caching is used
input_template (str) – The path to the input file template. The input locations in the file are marked by GEMSEO_INPUT{input_name::1.0}, where “input_name” is the input name, and 1.0 is here the default input.
output_template (str) – The path to the output file template. The input locations in the file are marked by GEMSEO_OUTPUT{output_name::1.0}, where “output_name” is the input name.
output_folcer_basepath – The path to the output folder, in which the executions will be performed.
executable_command (str) – The command to run the executable. Will be called through a system call. Example: “python myscript.py -i input.txt -o output.txt
input_filename (str) – The name of the input file. This will determine the name of the input file generated in the output folder. Example “input.txt”.
output_filename (str) – The name of the output file. This will determine the name of the output file generated in the output folder. Example “output.txt”.
(Union[str (folders_iter) – The type of unique identifiers for the output folders. If NUMBERED the generated output folders will be “output_folder_basepath”+str(i+1), where i is the maximum value of the already existing “output_folder_basepath”+str(i) folders. Otherwise, a unique number based on the UUID function is generated. This last option shall be used if multiple MDO processes are runned in the same work directory.
FoldersIter] – The type of unique identifiers for the output folders. If NUMBERED the generated output folders will be “output_folder_basepath”+str(i+1), where i is the maximum value of the already existing “output_folder_basepath”+str(i) folders. Otherwise, a unique number based on the UUID function is generated. This last option shall be used if multiple MDO processes are runned in the same work directory.
name – the name of the discipline. If None, use the class name.
parse_outfile_method (Union[str, Parsers]) – The optional method that can be provided by the user to parse the output file. To see the signature of the method, see the parse_outfile method of this file. If the KEY_VALUE_PARSER is used as output parser, specify the separator key (default : “=”).
write_input_file_method (Optional[str]) – The method to write the input file. If None, use this modules’ write_input_file. To see the signature of the method, see the write_input_file method of this file.
parse_out_separator (str) – The separator used for the output parser.
use_shell (bool) – If True, run the command using the default shell. Otherwise, run directly the command.
output_folder_basepath (str) –
folders_iter (Union[str, FoldersIter]) –

Raises

TypeError – If the provided write_input_file_method is not callable.

Return type

None

Attributes:

`APPROX_MODES`
`AVAILABLE_MODES`
`COMPLEX_STEP`
`FINITE_DIFFERENCES`
`HDF5_CACHE`
`JSON_GRAMMAR_TYPE`
`MEMORY_FULL_CACHE`
`N_CPUS`
`RE_EXECUTE_DONE_POLICY`
`RE_EXECUTE_NEVER_POLICY`
`SIMPLE_CACHE`
`SIMPLE_GRAMMAR_TYPE`
`STATUS_DONE`
`STATUS_FAILED`
`STATUS_PENDING`
`STATUS_RUNNING`
`STATUS_VIRTUAL`
`cache_tol`	Accessor to the cache input tolerance.
`default_inputs`	Accessor to the default inputs.
`exec_time`	Return the cumulated execution time.
`folders_iter`	Getter/Setter for folders_iter.
`linearization_mode`	Accessor to the linearization mode.
`n_calls`	Return the number of calls to execute() which triggered the _run().
`n_calls_linearize`	Return the number of calls to linearize() which triggered the _compute_jacobian() method.
`status`	Status accessor.
`time_stamps`

Methods:

`activate_time_stamps`()	Activate the time stamps.
`add_differentiated_inputs`([inputs])	Add inputs to the differentiation list.
`add_differentiated_outputs`([outputs])	Add outputs to the differentiation list.
`add_status_observer`(obs)	Add an observer for the status.
`auto_get_grammar_file`([is_input, name, comp_dir])	Use a naming convention to associate a grammar file to a discipline.
`check_input_data`(input_data[, raise_exception])	Check the input data validity.
`check_jacobian`([input_data, derr_approx, …])	Check if the jacobian provided by the linearize() method is correct.
`check_output_data`([raise_exception])	Check the output data validity.
`deactivate_time_stamps`()	Deactivate the time stamps for storing start and end times of execution and linearizations.
`deserialize`(in_file)	Derialize the discipline from a file.
`execute`([input_data])	Execute the discipline.
`generate_uid`()	Generate an unique identifier for the execution directory.
`get_all_inputs`()	Accessor for the input data as a list of values.
`get_all_outputs`()	Accessor for the output data as a list of values.
`get_attributes_to_serialize`()	Define the attributes to be serialized.
`get_data_list_from_dict`(keys, data_dict)	Filter the dict from a list of keys or a single key.
`get_expected_dataflow`()	Return the expected data exchange sequence.
`get_expected_workflow`()	Return the expected execution sequence.
`get_input_data`()	Accessor for the input data as a dict of values.
`get_input_data_names`()	Accessor for the input names as a list.
`get_input_output_data_names`()	Accessor for the input and output names as a list.
`get_inputs_asarray`()	Accessor for the outputs as a large numpy array.
`get_inputs_by_name`(data_names)	Accessor for the inputs as a list.
`get_local_data_by_name`(data_names)	Accessor for the local data of the discipline as a dict of values.
`get_output_data`()	Accessor for the output data as a dict of values.
`get_output_data_names`()	Accessor for the output names as a list.
`get_outputs_asarray`()	Accessor for the outputs as a large numpy array.
`get_outputs_by_name`(data_names)	Accessor for the outputs as a list.
`get_sub_disciplines`()	Gets the sub disciplines of self By default, empty.
`is_all_inputs_existing`(data_names)	Test if all the names in data_names are inputs of the discipline.
`is_all_outputs_existing`(data_names)	Test if all the names in data_names are outputs of the discipline.
`is_input_existing`(data_name)	Test if input named data_name is an input of the discipline.
`is_output_existing`(data_name)	Test if output named data_name is an output of the discipline.
`is_scenario`()	Return True if self is a scenario.
`linearize`([input_data, force_all, force_no_exec])	Execute the linearized version of the code.
`notify_status_observers`()	Notify all status observers that the status has changed.
`remove_status_observer`(obs)	Remove an observer for the status.
`reset_statuses_for_run`()	Sets all the statuses to PENDING.
`serialize`(out_file)	Serialize the discipline.
`set_cache_policy`([cache_type, …])	Set the type of cache to use and the tolerance level.
`set_disciplines_statuses`(status)	Set the sub disciplines statuses.
`set_jacobian_approximation`([…])	Set the jacobian approximation method.
`set_optimal_fd_step`([outputs, inputs, …])	Compute the optimal finite-difference step.
`store_local_data`(**kwargs)	Store discipline data in local data.

APPROX_MODES = ['finite_differences', 'complex_step']¶

AVAILABLE_MODES = ('auto', 'direct', 'adjoint', 'reverse', 'finite_differences', 'complex_step')¶

COMPLEX_STEP = 'complex_step'¶

FINITE_DIFFERENCES = 'finite_differences'¶

HDF5_CACHE = 'HDF5Cache'¶

JSON_GRAMMAR_TYPE = 'JSON'¶

MEMORY_FULL_CACHE = 'MemoryFullCache'¶

N_CPUS = 2¶

RE_EXECUTE_DONE_POLICY = 'RE_EXEC_DONE'¶

RE_EXECUTE_NEVER_POLICY = 'RE_EXEC_NEVER'¶

SIMPLE_CACHE = 'SimpleCache'¶

SIMPLE_GRAMMAR_TYPE = 'Simple'¶

STATUS_DONE = 'DONE'¶

STATUS_FAILED = 'FAILED'¶

STATUS_PENDING = 'PENDING'¶

STATUS_RUNNING = 'RUNNING'¶

STATUS_VIRTUAL = 'VIRTUAL'¶

classmethod activate_time_stamps()¶

Activate the time stamps.

For storing start and end times of execution and linearizations.

add_differentiated_inputs(inputs=None)¶

Add inputs to the differentiation list.

This method updates self._differentiated_inputs with inputs

Parameters: inputs – list of inputs variables to differentiate if None, all inputs of discipline are used (Default value = None)

add_differentiated_outputs(outputs=None)¶

Add outputs to the differentiation list.

Update self._differentiated_inputs with inputs.

Parameters: outputs – list of output variables to differentiate if None, all outputs of discipline are used

add_status_observer(obs)¶

Add an observer for the status.

Add an observer for the status to be notified when self changes of status.

Parameters: obs – the observer to add

auto_get_grammar_file(is_input=True, name=None, comp_dir=None)¶

Use a naming convention to associate a grammar file to a discipline.

This method searches in the “comp_dir” directory containing the discipline source file for files basenames self.name _input.json and self.name _output.json

Parameters

is_input – if True, searches for _input.json, otherwise _output.json (Default value = True)
name – the name of the discipline (Default value = None)
comp_dir – the containing directory if None, use self.comp_dir (Default value = None)

Returns

path to the grammar file

Return type

string

property cache_tol¶: Accessor to the cache input tolerance.

check_input_data(input_data, raise_exception=True)¶

Check the input data validity.

Parameters

input_data – the input data dict
raise_exception – Default value = True)

check_jacobian(input_data=None, derr_approx='finite_differences', step=1e-07, threshold=1e-08, linearization_mode='auto', inputs=None, outputs=None, parallel=False, n_processes=2, use_threading=False, wait_time_between_fork=0, auto_set_step=False, plot_result=False, file_path='jacobian_errors.pdf', show=False, figsize_x=10, figsize_y=10)¶

Check if the jacobian provided by the linearize() method is correct.

Parameters

input_data – input data dict (Default value = None)
derr_approx – derivative approximation method: COMPLEX_STEP (Default value = COMPLEX_STEP)
threshold – acceptance threshold for the jacobian error (Default value = 1e-8)
linearization_mode – the mode of linearization: direct, adjoint or automated switch depending on dimensions of inputs and outputs (Default value = ‘auto’)
inputs – list of inputs wrt which to differentiate (Default value = None)
outputs – list of outputs to differentiate (Default value = None)
step – the step for finite differences or complex step
parallel – if True, executes in parallel
n_processes – maximum number of processors on which to run
use_threading – if True, use Threads instead of processes to parallelize the execution multiprocessing will copy (serialize) all the disciplines, while threading will share all the memory This is important to note if you want to execute the same discipline multiple times, you shall use multiprocessing
wait_time_between_fork – time waited between two forks of the process /Thread
auto_set_step – Compute optimal step for a forward first order finite differences gradient approximation
plot_result – plot the result of the validation (computed and approximate jacobians)
file_path – path to the output file if plot_result is True
show – if True, open the figure
figsize_x – x size of the figure in inches
figsize_y – y size of the figure in inches

Returns

True if the check is accepted, False otherwise

check_output_data(raise_exception=True)¶

Check the output data validity.

Parameters: raise_exception – if true, an exception is raised when data is invalid (Default value = True)

classmethod deactivate_time_stamps()¶: Deactivate the time stamps for storing start and end times of execution and linearizations.

property default_inputs¶: Accessor to the default inputs.

static deserialize(in_file)¶

Derialize the discipline from a file.

Parameters: in_file – input file for serialization
Returns: a discipline instance

property exec_time¶

Return the cumulated execution time.

Multiprocessing safe.

execute(input_data=None)¶

Execute the discipline.

This method executes the discipline:

Adds default inputs to the input_data if some inputs are not defined
in input_data but exist in self._default_data
Checks if the last execution of the discipline wan not called with
identical inputs, cached in self.cache, if yes, directly return self.cache.get_output_cache(inputs)
Caches the inputs
Checks the input data against self.input_grammar
if self.data_processor is not None: runs the preprocessor
updates the status to RUNNING
calls the _run() method, that shall be defined
if self.data_processor is not None: runs the postprocessor
checks the output data
Caches the outputs
updates the status to DONE or FAILED
updates summed execution time

Parameters: input_data (dict) – the input data dict needed to execute the disciplines according to the discipline input grammar (Default value = None)
Returns: the discipline local data after execution
Return type: dict

property folders_iter¶

Getter/Setter for folders_iter.

The setter will check that the value provided for folder_iter is valid. This check is done by checking its presence in FOLDERS_ITER.

Raises: ValueError – If the value provided to the setter is not present in the accepted list of folders_iters list.

generate_uid()[source]¶

Generate an unique identifier for the execution directory.

Generate a unique identifier for the current execution. If the folders_iter strategy is NUMBERED, the successive iterations are named by an integer 1, 2, 3 etc. This is multiprocess safe. Otherwise, a unique number based on the UUID function is generated. This last option shall be used if multiple MDO processes are runned in the same workdir.

Returns: An unique string identifier (either a number or a UUID).
Return type: str

get_all_inputs()¶

Accessor for the input data as a list of values.

The order is given by self.get_input_data_names().

Returns: the data

get_all_outputs()¶

Accessor for the output data as a list of values.

The order is given by self.get_output_data_names().

Returns: the data

get_attributes_to_serialize()¶

Define the attributes to be serialized.

Shall be overloaded by disciplines

Returns: the list of attributes names
Return type: list

static get_data_list_from_dict(keys, data_dict)¶

Filter the dict from a list of keys or a single key.

If keys is a string, then the method return the value associated to the key. If keys is a list of string, then the method return a generator of value corresponding to the keys which can be iterated.

Parameters

keys – a sting key or a list of keys
data_dict – the dict to get the data from

Returns

a data or a generator of data

get_expected_dataflow()¶

Return the expected data exchange sequence.

This method is used for the XDSM representation.

Default to empty list See MDOFormulation.get_expected_dataflow

Returns: a list representing the data exchange arcs

get_expected_workflow()¶

Return the expected execution sequence.

This method is used for XDSM representation Default to the execution of the discipline itself See MDOFormulation.get_expected_workflow

get_input_data()¶

Accessor for the input data as a dict of values.

Returns: the data dict

get_input_data_names()¶

Accessor for the input names as a list.

Returns: the data names list

get_input_output_data_names()¶

Accessor for the input and output names as a list.

Returns: the data names list

get_inputs_asarray()¶

Accessor for the outputs as a large numpy array.

The order is the one of self.get_all_outputs().

Returns: the outputs array
Return type: ndarray

get_inputs_by_name(data_names)¶

Accessor for the inputs as a list.

Parameters: data_names – the data names list
Returns: the data list

get_local_data_by_name(data_names)¶

Accessor for the local data of the discipline as a dict of values.

Parameters: data_names – the names of the data which will be the keys of the dictionary
Returns: the data list

get_output_data()¶

Accessor for the output data as a dict of values.

Returns: the data dict

get_output_data_names()¶

Accessor for the output names as a list.

Returns: the data names list

get_outputs_asarray()¶

Accessor for the outputs as a large numpy array.

The order is the one of self.get_all_outputs()

Returns: the outputs array
Return type: ndarray

get_outputs_by_name(data_names)¶

Accessor for the outputs as a list.

Parameters: data_names – the data names list
Returns: the data list

get_sub_disciplines()¶

Gets the sub disciplines of self By default, empty.

Returns: the list of disciplines

is_all_inputs_existing(data_names)¶

Test if all the names in data_names are inputs of the discipline.

Parameters: data_names – the names of the inputs
Returns: True if data_names are all in input grammar
Return type: logical

is_all_outputs_existing(data_names)¶

Test if all the names in data_names are outputs of the discipline.

Parameters: data_names – the names of the outputs
Returns: True if data_names are all in output grammar
Return type: logical

is_input_existing(data_name)¶

Test if input named data_name is an input of the discipline.

Parameters: data_name – the name of the output
Returns: True if data_name is in input grammar
Return type: logical

is_output_existing(data_name)¶

Test if output named data_name is an output of the discipline.

Parameters: data_name – the name of the output
Returns: True if data_name is in output grammar
Return type: logical

static is_scenario()¶

Return True if self is a scenario.

Returns: True if self is a scenario

property linearization_mode¶: Accessor to the linearization mode.

linearize(input_data=None, force_all=False, force_no_exec=False)¶

Execute the linearized version of the code.

Parameters

input_data – the input data dict needed to execute the disciplines according to the discipline input grammar
force_all – if False, self._differentiated_inputs and self.differentiated_output are used to filter the differentiated variables otherwise, all outputs are differentiated wrt all inputs (Default value = False)
force_no_exec – if True, the discipline is not re executed, cache is loaded anyway

property n_calls¶

Return the number of calls to execute() which triggered the _run().

Multiprocessing safe.

property n_calls_linearize¶

Return the number of calls to linearize() which triggered the _compute_jacobian() method.

Multiprocessing safe.

notify_status_observers()¶: Notify all status observers that the status has changed.

remove_status_observer(obs)¶

Remove an observer for the status.

Parameters: obs – the observer to remove

reset_statuses_for_run()¶: Sets all the statuses to PENDING.

serialize(out_file)¶

Serialize the discipline.

Parameters: out_file – destination file for serialization

set_cache_policy(cache_type='SimpleCache', cache_tolerance=0.0, cache_hdf_file=None, cache_hdf_node_name=None, is_memory_shared=True)¶

Set the type of cache to use and the tolerance level.

This method set the cache policy to cache data whose inputs are close to inputs whose outputs are already cached. The cache can be either a simple cache recording the last execution or a full cache storing all executions. Caching data can be either in-memory, e.g. SimpleCache and MemoryFullCache , or on the disk, e.g. HDF5Cache . CacheFactory.caches provides the list of available types of caches.

Parameters

cache_type (str) – type of cache to use.
cache_tolerance (float) – tolerance for the approximate cache maximal relative norm difference to consider that two input arrays are equal
cache_hdf_file (str) – the file to store the data, mandatory when HDF caching is used
cache_hdf_node_name (str) – name of the HDF dataset to store the discipline data. If None, self.name is used
is_memory_shared (bool) – If True, a shared memory dict is used to store the data, which makes the cache compatible with multiprocessing. WARNING: if set to False, and multiple disciplines point to the same cache or the process is multiprocessed, there may be duplicate computations because the cache will not be shared among the processes.

set_disciplines_statuses(status)¶

Set the sub disciplines statuses.

To be implemented in subclasses. :param status: the status

set_jacobian_approximation(jac_approx_type='finite_differences', jax_approx_step=1e-07, jac_approx_n_processes=1, jac_approx_use_threading=False, jac_approx_wait_time=0)¶

Set the jacobian approximation method.

Sets the linearization mode to approx_method, sets the parameters of the approximation for further use when calling self.linearize

Parameters

jac_approx_type – “complex_step” or “finite_differences”
jax_approx_step – the step for finite differences or complex step
jac_approx_n_processes – maximum number of processors on which to run
jac_approx_use_threading – if True, use Threads instead of processes to parallelize the execution multiprocessing will copy (serialize) all the disciplines, while threading will share all the memory This is important to note if you want to execute the same discipline multiple times, you shall use multiprocessing
jac_approx_wait_time – time waited between two forks of the process /Thread

set_optimal_fd_step(outputs=None, inputs=None, force_all=False, print_errors=False, numerical_error=2.220446049250313e-16)¶

Compute the optimal finite-difference step.

Compute the optimal step for a forward first order finite differences gradient approximation. Requires a first evaluation of perturbed functions values. The optimal step is reached when the truncation error (cut in the Taylor development), and the numerical cancellation errors (roundoff when doing f(x+step)-f(x)) are approximately equal.

Warning: this calls the discipline execution two times per input variables.

See: https://en.wikipedia.org/wiki/Numerical_differentiation and “Numerical Algorithms and Digital Representation”, Knut Morken , Chapter 11, “Numerical Differenciation”

Parameters

inputs – inputs wrt the linearization is made. If None, use differentiated inputs
outputs – outputs of the linearization is made. If None, use differentiated outputs
force_all – if True, all inputs and outputs are used
print_errors – if True, displays the estimated errors
numerical_error – numerical error associated to the calculation of f. By default Machine epsilon (appx 1e-16), but can be higher when the calculation of f requires a numerical resolution

Returns

the estimated errors of truncation and cancelation error.

property status¶: Status accessor.

store_local_data(**kwargs)¶

Store discipline data in local data.

Parameters: kwargs – the data as key value pairs

time_stamps = None¶

class gemseo.wrappers.disc_from_exe.FoldersIter(value)[source]¶

Bases: gemseo.utils.base_enum.BaseEnum

An enumeration.

Attributes:

`NUMBERED`
`UUID`

NUMBERED = 0¶

UUID = 1¶

class gemseo.wrappers.disc_from_exe.Parsers(value)[source]¶

Bases: gemseo.utils.base_enum.BaseEnum

An enumeration.

Attributes:

`CUSTOM_CALLABLE`
`KEY_VALUE_PARSER`
`TEMPLATE_PARSER`

CUSTOM_CALLABLE = 2¶

KEY_VALUE_PARSER = 0¶

TEMPLATE_PARSER = 1¶

gemseo.wrappers.disc_from_exe.parse_key_value_file(_, out_lines, separator='=')[source]¶

Parse the output file from the expected text positions.

Parameters

out_lines (Sequence[str]) – The lines of the output file template.
separator (str) – The separating characters of the key=value format.

Returns

The output data in .MDODiscipline friendly data structure (e.g. Dict[str, ndarray]).

Return type

Dict[str, numpy.ndarray]

gemseo.wrappers.disc_from_exe.parse_outfile(output_positions, out_lines)[source]¶

Parse the output file from the expected text positions.

Parameters

output_positions (Mapping[str, Tuple[int]]) – The output position for each data name. The information from the template format {data_name:(start,end,dictionary)}, where name is the name of the output data, start is the index of the starting point in the input file template. This index is a line index (character number on the line) end is the index of the end character in the template line_number is the index of the line in the file
out_lines (Sequence[str]) – The lines of the output file template.

Returns

The output data in .MDODiscipline friendly data structure (e.g. Dict[str, ndarray]).

Return type

Dict[str, numpy.ndarray]

gemseo.wrappers.disc_from_exe.parse_template(template_lines, grammar_is_input)[source]¶

Parse the input or output template.

Parameters

template_lines (Sequence[str]) – The lines of the template file.
grammar_is_input (bool) – True for an input template, False otherwise.

Return type

Tuple[Dict[str, numpy.ndarray], Dict[str, Tuple[int]]]

This function parses the input (or output) template. It returns the tuple (data_dict, pos_dict), where:

data_dict is the {name:value} dict:
- name is the data name
- value is the parsed input or output value in the template
pos_dict describes the template format {data_name:(start,end,line_number)}:
- data_name is the name of the input data
- start is the index of the starting point in the input file template.
This index is a line index (character number on the line)
- end is the index of the end character in the template
- line_number is the index of the line in the file

Returns

A data structure containing the parsed inpout or output template.

Parameters

template_lines (Sequence[str]) –
grammar_is_input (bool) –

Return type

Tuple[Dict[str, numpy.ndarray], Dict[str, Tuple[int]]]

gemseo.wrappers.disc_from_exe.write_input_file(input_file_path, data, input_positions, input_lines, float_format='{:1.18g}')[source]¶

Write the input file from the input data.

Parameters

input_file_path (str) – The absolute path to the file to be written.
data (Mapping[str, numpy.ndarray]) – The local data of the discipline.
input_positions (Mapping[str, Tuple[int]]) – The information from the template format {data_name:(start,end,line_number)}, where name is the name of the input data, start is the index of the starting point in the input file template. This index is a line index (character number on the line). end is the index of the end character in the template, line_number is the index of the line in the file.
input_lines (Sequence[int]) – The lines of the input file template.
float_format (str) – The formating of the input data in the file (Default value = “{:1.18g}”).

Return type

None