```{image} ../../src/orangecontrib/ewoks3dxrd/icons/imageD11_map.svg
:alt: ImageD11 Grain Map Widget Icon
:class: widget-title-icon
```
# ImageD11 Grain Map Widget

The output file can then be parsed by Crispy for example.


## Functionality
This widget allows you to:
1. Select an input HDF5 data group containing the processed grain map.
2. Define the output file and the HDF5 process group name in which the data will be exported.

## User Interface
![Image showing the initial state of the ImageD11 Grain Map Widget](../_static/tuto/initial_convert_imageD11_grain_map.png)


## Example Usage
1. Connect the widget to a preceding node generating grain data (_Grid Indexing_ or _Refine Grain Mapping_), or use the Browse H5 Group... button to manually select the HDF5 URL containing your grain data group.
2. Specify the target file in the Output ImageD11 File field.
3. Provide a clear identifier in the Process Group Name field.
4. Check the Overwrite Output URL box if you wish to overwrite an existing dataset at that destination.
5. Click Save File. If the saving is successful, a pop-up window will appear notifying you that the data has been successfully written.

![Image showing the successful state of the ImageD11 Grain Map Widget](../_static/tuto/convert_imageD11_grain_map.png)

```{warning}
Do not connect this widget directly to the output of an _Indexing_ node. 
The basic _Indexing_ node only provides grains orientation ($UBI$) matrices; 
it does not compute its position in 3D space. Without these spatial coordinates, 
the downstream applications like **Crispy** will fail to parse the file. 
Always use spatial refinement nodes (_Grid Indexing_ or _Refine Grain Mapping_) before exporting.
```