Mapdl.ocread(fname='', ext='', option='', **kwargs)

Reads externally defined ocean data.


  • fname – External ocean data file name (excluding the filename extension) and directory path containing the file. For more information, see the Notes section.

  • ext – Filename extension (limited to eight characters).

  • -- – Reserved field.

  • option – Integer value passed to the userOceanRead subroutine (as iOption) for user-defined waves. This value does not apply to the diffracted wave type.


The OCREAD command imports ocean data that has been defined externally (for example, via the Hydrodynamic Diffraction System (AQWA)).

The command operates on the ocean load ID specified via the most recently issued OCTYPE command. Issue a separate OCREAD command for each ocean load that you want to read into the program.

Fname is limited to 248 characters, including the directory path. If Fname does not include a directory path, the program searches for the specified file in the current working directory. An unspecified Fname defaults to Jobname.

For the diffracted wave type (KWAVE = 8 on the OCDATA command), you must issue an OCREAD command for the ocean wave ID in order to import the hydrodynamic data from the hydrodynamic analysis.

For more information, see Applying Ocean Loading from a Hydrodynamic Analysis in the Advanced Analysis Guide.

To learn more about creating user-defined waves, see Subroutine userPanelHydFor (Calculating Panel Loads Caused by Ocean Loading) in the Programmer’s Reference.

This command is also valid in PREP7.