Compact-pol H-theta plot (plot_h_theta_cp)#

polsartools.plot_h_theta_cp(h, theta, ppath=None, cmap='jet', cbar=True, norm='', vmin=None, vmax=None, grey_region=True, zone_lines=True, zone_line_color='k', zone_ids=True, gridsize=200)[source]

Generates and saves a density plot of entropy (H) versus theta (degrees) for compact-pol data, including optional zone lines, zone IDs, and grey regions.

radial axis is 1-H angular axis is 2*theta

Example:#

>>> plot_h_theta_cp(h, theta, ppath="HT_plot.png", cmap='jet', cbar=True, norm='log')
This will generates a H/Theta plot  from the input arrays and save it as HT_plot.png, using the 'jet' colormap and logarithmic normalization

Parameters:#

hpath or array-like

path to the Entropy file or Array representing entropy values.

thetapath or array-like

path to the Theta file or Array representing theta values in degrees.

ppathstr, optional

Path to save the generated plot. If a folder is given, the plot is saved as ‘htheta_plot_cp.png’ inside that folder. If the file already exists, it will be overwritten.

cmapstr, optional

Colormap used for the hexbin plot. Defaults to ‘jet’.

colorbarbool, optional

If True, displays a colorbar representing sample count. Defaults to True.

normstr, optional

If set to ‘log’, applies logarithmic normalization to the hexbin plot.

grey_regionbool, optional

If True, fills non-feasible regions of the plot with a grey color to indicate feasible boundaries. Defaults to True.

zone_linesbool, optional

If True, adds dashed lines to mark different entropy-alpha zones. Defaults to True.

zone_line_colorstr, optional

Color used for zone boundary lines. Defaults to ‘k’ (black).

zone_idsbool, optional

If True, labels predefined zones with numerical identifiers. Defaults to True.

gridsizeint, optional

Number of hexagonal bins used in the plot. Higher values result in finer binning. Defaults to 200.

Returns:#

None

Displays the plot and optionally saves it to the specified location.