File formats

From Eclat-Digital Ocean 2014 Documentation
Revision as of 12:49, 10 March 2014 by Admin (Talk | contribs)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

Ocean natively supports reading and writing various file formats.

Scene formats

Ocean XML

Ocean scene files are stored using a human readable, XML based format, with the .ocxml file extension. A compressed .ocxmlz format also exists.

For instance, a camera will be described like this:

<instrument type="idealrectcam" name="outside-view">
	<prm pos="0.278 0.273 -0.800"/>
	<prm up="0.0 1.0 0.0"/>
	<prm forwards="0.0 0.0 1.0"/>
	<prm fnumber="5.6"/>
	<prm shutter="0.8"/>
	<prm focusdistance="2.0"/>
	<prm sensor_ar="1"/>
	<prm sensor_width="0.025"/>
	<prm focallength="0.035"/>
	<prm xresolution="512"/>
	<prm yresolution="512"/>
	<prm pixelfilter="bilinear"/>
</instrument>

For instance:

  • The camera position is : X=0.278, Y=0.273 and Z=-0.800
  • The focal length is 35mm (0.035 meters)
  • The aperture is f5.6
  • The focusing distance is 2 meters

This format is documented in the manual pages, and maps in text format the graphical object tree structures.

Ocean Binary

This format is not human readable, but takes much less disk space than Ocean XML. It is also much faster to read and write. It is mostly used for large data sets, such as mesh geometries. It stores the exact same information than Ocean XML.

Ocean binary files have the .ocbin file extension. A compressed .ocbinz format also exists.

The Ocean binary format is not documented in these pages, but the specification is available on demand.

SketchUp

Ocean 2014 natively reads .skp files from SketchUp 8 and earlier. It imports the surface geometries, materials with basic color properties, and instruments from the defined scene tabs. As advanced Ocean data cannot be defined in .skp files, saving to this format is not possible. Any changes made should be saved to Ocean XML or Ocean Binary files.

Plugins

Ocean supports exporting data from various modeling software through plug-ins. Currently, the only plug-in shipped with Ocean is for McNeel Rhinoceros 5, but other plug-ins can be added on demand.


Simulation result formats

When a simulation has been performed, it may be saved or exported to various formats listed below.

Ocean RAW

Ocean RAW files store the full simulation values, as well as post-processing and instrument information. They allow changing post-processing parameters and doing value analysis later. See Ocean raw files for more details.

Standard images

Simulation results may be stored to .png or .jpg image files. Rendered images may also be copied to the clipboard from preview tabs.

High dynamic range images

The OpenEXR (.exr) file format allows saving results to floating-point images with no loss of precision or dynamic range. All channels are exported : writing images in the XYZ color space or even spectral images is possible. However, most software able to read .exr images only read R, G and B channels.

OpenDocument Spreadsheet

Numerical values can be saved to spreadsheets using the .ods format. These can be opened in various software, such as OpenOffice Calc, LibreOffice Calc, or Microsoft Excel 2007 and later.

Comma Separated Values

Numerical values can be saved to comma separated value .csv text files. If multiple channels are present, one file by channel is written, with the channel name inserted between the file name and the extension.

See Also

Ocean Manual Contents