File loading keywords were confusing and the docstrings were incorrect.
I've changed the default reading behaviour to not load any arrays, and the keyword arrays_to_load or keys for from_file or read respectively works as follows:
Passing empty array []: load nothing
Passing None: load everything
Passing a list of array names: load that subset of arrays
This is technically API breaking so I'm placing this PR in v4-prep
File loading keywords were confusing and the docstrings were incorrect.
I've changed the default reading behaviour to not load any arrays, and the keyword
arrays_to_load
orkeys
forfrom_file
orread
respectively works as follows:Passing empty array
[]
: load nothing PassingNone
: load everything Passing a list of array names: load that subset of arraysThis is technically API breaking so I'm placing this PR in v4-prep