SetExcitationWeightFile
=======================
```{function} SetExcitationWeightFile(CSX, name, fileName, propDir)
```
Full definition:
```{code-block} matlab
function CSX = SetExcitationWeightFile(CSX, name, fileName, propDir)
```
function CSX = SetExcitationWeightFile(CSX, name, fileName, propDir, origin)

Set the HDF5 weight file and propagation direction for an excitation.

Required arguments:
  CSX      - CSX structure
  name     - name of the excitation property
  fileName - path to the HDF5 weight file
  propDir  - propagation direction vector, e.g. [0 0 1] for z-propagation

Optional:
  origin   - [x,y,z] coordinate origin for weight file evaluation
             (in drawing units). If given, coordinates are shifted by this
             offset before interpolation into the mode file.

See also AddExcitation, SetExcitationWeight, InitCSX, DefineRectGrid


-----------------------
Author: (2023-2025) Gadi Lahav - gadi@rfwithcare.com