Full-pol H-theta plot (plot_h_theta_fp) — PolSARtools 0.10 documentation

Skip to main content
`Ctrl`+`K`

# Full-pol H-theta plot (`plot_h_theta_fp`)

polsartools.plot_h_theta_fp(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)

  Generates and saves a density plot of entropy (H) versus theta (degrees) for full-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_fp(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_fp.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.