\(\renewcommand\AA{\unicode{x212B}}\)
LoadMD v1¶
Summary¶
Load a MDEventWorkspace in .nxs format.
See Also¶
Properties¶
Name |
Direction |
Type |
Default |
Description |
|---|---|---|---|---|
Filename |
Input |
string |
Mandatory |
The name of the Nexus file to load, as a full or relative path. Allowed extensions: [‘.nxs’] |
MetadataOnly |
Input |
boolean |
False |
Load Box structure and other metadata without events. The loaded workspace will be empty and not file-backed. |
BoxStructureOnly |
Input |
boolean |
False |
Load partial information about the boxes and events. Redundant property currently equivalent to MetadataOnly |
FileBackEnd |
Input |
boolean |
False |
Set to true to load the data only on demand. |
Memory |
Input |
number |
-1 |
For FileBackEnd only: the amount of memory (in MB) to allocate to the in-memory cache. If not specified, a default of 40% of free physical memory is used. |
LoadHistory |
Input |
boolean |
True |
If true, the workspace history will be loaded |
OutputWorkspace |
Output |
IMDWorkspace |
Mandatory |
Name of the output MDEventWorkspace. |
Description¶
This algorithm loads a MDEventWorkspace that was previously saved using the SaveMD v2 algorithm to a .nxs file format.
If the workspace is too large to fit into memory, You can load the workspace as a file-backed MDWorkspace by checking the FileBackEnd option. This will load the box structure (allowing for some visualization with no speed penalty) but leave the events on disk until requested. Processing file-backed MDWorkspaces is significantly slower than in-memory workspaces due to frequent file access!
For file-backed workspaces, the Memory option allows you to specify a cache size, in MB, to keep events in memory before caching to disk.
Finally, the BoxStructureOnly and MetadataOnly options are for special situations and used by other algorithms, they should not be needed in daily use.
Usage¶
Note
To run these usage examples please first download the usage data, and add these to your path. In Mantid this is done using Manage User Directories.
Example - Load MD workspace.
# Load sample MDEvent workspace, present in Mantid unit tests
mdws = LoadMD('MAPS_MDEW.nxs');
# Check results
print("Workspace type is: {}".format(mdws.id()))
print("Workspace has:{0:2} dimensions and contains: {1:4} MD events".format(mdws.getNumDims(),mdws.getNEvents()))
Output:
Workspace type is: MDEventWorkspace<MDLeanEvent,4>
Workspace has: 4 dimensions and contains: 0 MD events
Categories: AlgorithmIndex | MDAlgorithms\DataHandling
Source¶
C++ header: LoadMD.h
C++ source: LoadMD.cpp