added option for vertex number and field value to hover over menu

Author: Tobias W. Harvey

src/m/plot/applyoptions.m

@@ -439,6 +439,14 @@ function applyoptions(md,data,options)
 	set(gca,'pos',Axis);
 end
 
+if exist(options,'datatip')
+    datatip = getfieldvalue(options, 'datatip')
+    p = findobj(gcf, 'Type', 'patch');
+    dcm = datacursormode(gcf);
+    set(dcm, 'Enable', 'on');
+    set(dcm, 'UpdateFcn', {@plot_datatip, p.Vertices(:, 1), p.Vertices(:, 2), p.FaceVertexCData, datatip});
+end
+
 %showregion
 if strcmpi(getfieldvalue(options,'showregion','off'),'on'),
 	%Keep pointer of main axis
@@ -621,3 +629,6 @@ function applyoptions(md,data,options)
 
 %clipping off always: 
 set(gca,'Clipping',getfieldvalue(options,'clipping','on'));
+
+end
+

src/m/plot/plot_datatip.m

@@ -0,0 +1,21 @@
+function output_txt = plot_datatip(~, event_obj, x, y, field, datatip)
+
+    pos = event_obj.Position;
+    [~, idx] = min( (x - pos(1)).^2 + (y - pos(2)).^2 );
+    
+    if strcmp(datatip, 'vertex-field')
+    output_txt = {
+        ['X: ', num2str(pos(1))], ...
+        ['Y: ', num2str(pos(2))], ...
+        ['Vertex #: ', num2str(idx)], ...
+        ['Field: ', num2str(field(idx))]
+                 };
+    else
+        output_txt = {
+            ['X: ', num2str(pos(1))], ...
+            ['Y: ', num2str(pos(2))], ...
+            ['Value: ', num2str(datatip(idx))]
+                     };
+    end
+
+end

src/m/plot/plotdoc.m

@@ -66,6 +66,7 @@ function plotdoc()
 disp('       ''contourticks'': ''on'' or ''off'' to display the ticks of the contours');
 disp('       ''contouronly'': ''on'' or ''off'' to display the contours on a white background');
 disp('       ''contourcolor'': ticks and contour color');
+disp('       ''datatip'': an additional datatip entry (''vertex-field'' for vertex number and field value, or any md.mesh.numberofvertices length array');
 disp('       ''density'': density of quivers (one arrow every N nodes, N integer)');
 disp('       ''inset'': add an inset (zoom) of the current figure if 1 (use ''insetx'', ''insety'' and ''insetpos'' to determine the inset position and content)');
 disp('       ''insetx'': [min(x) max(x)] where min(x) and max(x) are values determining the inset content');