Histogram plots a histogram for a region drawn in the image, or for the
Plugin Type: Local
Histogram is a local plugin, which means it is associated with a channel.
An instance can be opened for each channel.
Click and drag to define a region within the image that will be used to calculate the histogram. To take the histogram of the full image, click the button in the UI labeled “Full Image”.
Depending on the size of the image, calculating the full histogram may take time.
If a new image is selected for the channel, the histogram plot will be recalculated based on the current parameters with the new data.
Unless disabled in the settings file for the histogram plugin, a line of simple statistics for the box is calculated and shown in a line below the plot.
Three radio buttons at the bottom of the UI are used to control the effects of the click/drag action:
select “Move” to drag the region to a different location
select “Draw” to draw a new region
select “Edit” to edit the region
To make a log plot of the histogram, check the “Log Histogram” checkbox. To plot by the full range of values in the image instead of by the range within the cut values, uncheck the “Plot By Cuts” checkbox.
The “NumBins” parameter determines how many bins are used in calculating the histogram. Type a number in the box and press “Enter” to change the default value.
Cut Levels Convenience Controls
Because a histogram is useful feedback for setting the cut levels, controls are provided in the UI for setting the low and high cut levels in the image, as well as for performing an auto cut levels, according to the auto cut levels settings in the channel preferences.
You can set cut levels by clicking in the histogram plot:
left click: set low cut
middle click: reset (auto cut levels)
right click: set high cut
In addition, you can dynamically adjust the gap between low and high cuts
by scrolling the wheel in the plot (i.e. the “width” of the histogram plot
curve). This has the effect of increasing or decreasing the contrast
within the image. The amount that is changed for each wheel click is set
by the plugin configuration file setting
scroll_pct. The default is 10%.
It is customizable using
is your HOME directory:
# # Histogram plugin preferences file # # Place this in file under ~/.ginga with the name "plugin_Histogram.cfg" # Switch to "move" mode after selection draw_then_move = True # Number of bins for histogram num_bins = 2048 # Histogram color hist_color = 'aquamarine' # Calculate extra statistics on box show_stats = True # Controls formatting (width) of statistics numbers maxdigits = 7 # percentage to adjust cuts gap when scrolling in histogram scroll_pct = 0.10