Image (Plot Attribute)

The subnode (

) adds an image to the plot. You can add it to 3D Volume and 2D and 3D Surface plots as an embedded overlaid image on the surfaces of the plot. In the , add one of those plot types; then right-click the plot node and select to embed an image in the plot. You can also add Image plot nodes directly to a 2D or 3D plot group.

Click the button to browse for an image to add. Select it in the file browser window and then click . Click the button (

) to add the image to overlay. Click the button to update the image overlay with the latest version of the image file. Click the button to store the image in the model. You then get information about the imported image file (the filename and its width and height). Click to export the image to a file, and click the button to remove the imported image file and return to the original settings in this section.

This section controls how the image is mapped to the 2D and 3D surfaces; you can choose an automatic or manual mapping as well as predefined planar, cylindrical, and spherical mappings for 3D surfaces and a rectangular mapping for 2D surface.

•

When the list is set to , an automatic planar projection algorithm is used to map the image to the surfaces. The setting always finds the best fitting plane and projects on it while choosing a suitable projection size. If the check is selected (the default), then the image’s aspect ratio is preserved by the automatic mapping algorithm. If the image and the data have aspect ratios, then some padding must be added. The images are centered in the dimension where padding is needed.

•

When you select from the list, you get access to more detailed control over the mapping. Each point on the surface is mapped to a pixel in the image. This functionality can be used for more advanced mappings. The following example provides a mapping that embeds a world map that uses an equirectangular projection on a sphere of radius r centered at the origin (when using a relative coordinate interpretation):

The default setting for the list is (a value in the range of 0–1). Choose to instead enter the coordinates using absolute pixels coordinates.

•

When you select from the list, you can define a plane for the image to be mapped to. From the list, choose one of the following planes: , , , , , , (the default), or . For , the software chooses the plane type that best suits the selected surfaces.

Enter a under , which is the side length that the image will have, interpreted in the length unit of the geometry that the solution dataset refers to. The will be computed based on the image’s size. Also, provide the coordinates for an anchor point in the , , and fields under . For , specify a normal vector in the , , and fields under . The default is (0, 0, 1); that is, the positive z-direction). Also specify a rotation angle, in degrees, if desired, in the field.

•

When you select from the list, you get a cylindrical mapping of the image. Specify the position of the cylinder (center of the bottom circle) in the , , and fields under , and from the list under , choose , , s (the default), , or . For , specify the axis direction in the , , and fields. For , specify the axis direction in the and fields as θ and ϕ angles in degrees. Also specify a rotation angle, in degrees, if desired, in the field.

•

When you select from the list, you get a spherical mapping of the image. Specify the position of the sphere’s center in the , , and fields under , and from the list under , choose , , (the default), , or . For , specify the axis direction in the , , and fields. For , specify the axis direction in the and fields as θ and ϕ angles in degrees. Also specify a rotation angle, in degrees, if desired, in the field.

•

When you select from the list, you define a rectangle for the image to be mapped to. Enter a under , which is the side length that the image will have, interpreted in the length unit of the geometry that the solution dataset refers to. The will be computed based on the image’s size.

From the list, choose (the default), , or to control the type of extrapolation to use. The effect of the option is that each coordinate is mapped to the closest valid value at an edge of the image. The list is not available when you have selected the or mapping from the list.