omas.machine_mappings

omas.machine_mappings(machine, branch, user_machine_mappings=None, return_raw_mappings=False, raise_errors=False)[source]

Function to load the json mapping files (local or remote) Allows for merging external mapping rules defined by users. This function sanity-checks and the mapping file and adds extra info required for mapping

Parameters
  • machine – machine for which to load the mapping files

  • branch – GitHub branch from which to load the machine mapping information

  • user_machine_mappings – Dictionary of mappings that users can pass to this function to temporarily use their mappings (useful for development and testinig purposes)

  • return_raw_mappings – Return mappings without following __include__ statements nor resoliving eval2TDI directives

  • raise_errors – raise errors or simply print warnings if something isn’t right

Returns

dictionary with mapping transformations