Creating histograms

You can create a visual representation of the distribution of records in a table across multiple intervals.

To create a histogram:

  1. Select Analyze > Histogram.
  2. On the Main tab, do one of the following:
    • Select the field on which to base the histogram from the Histogram On drop-down list.

    • Click Histogram On to select the field, or to create an expression.

  3. If you selected a numeric field or expression in Histogram On, do the following:
    1. In Minimum, enter the minimum value of the first interval.
    2. In Maximum, enter the maximum value of the last interval.
  4. If you selected a numeric field or expression in Histogram On, do one of the following:
    • Select Intervals and enter the number of equally sized intervals that will be created between the minimum to maximum values. The default value is 10.

      Tip

      You can change the default number of intervals by selecting Tools > Options, Command tab, and updating the Intervals value.

    • Select Free and enter the start point of each interval and the end point of the last interval. You must enter each value on a separate line.

  5. If there are records in the current view that you want to exclude from processing, enter a condition in the If text box, or click If to create an IF statement using the Expression Builder.

    The IF statement considers all records in the view and filters out those that do not meet the specified condition.

  6. Click the Output tab.
  7. Select the appropriate output option in the To panel:
    • Screen – Select this option to display the results in the ACL display area. If the output table contains a large number of records, it is faster and more useful to save the results to a file than to display the results on the screen.

    • Print – Select this option to send the results to the default printer.

    • Graph – Select this option to create a graph of the results and display it in the ACL display area.

    • File – Select this option to save or append the results to a text file. The file is saved outside ACL.

    Note

    Output options that do not apply to a particular analytical operation are disabled.

  8. If you selected File as the output type, specify the following information in the As panel:
    • File TypeASCII Text File or Unicode Text file (depending on which edition of ACL you are using) is the only option. Saves the results to a new text file, or appends the results to an existing text file.

    • Name – Enter a file name in the Name text box. Or click Name and enter the file name, or select an existing file in the Save or Save File As dialog box to overwrite or append to the file. If ACL prefills a file name, you can accept the prefilled name, or change it.

      You can also specify an absolute or relative file path, or navigate to a different folder, to save or append the file in a location other than the project location. For example: C:\Results\Output.txt or Results\Output.txt.

    • Local – Disabled and selected. Saving the file locally is the only option.

  9. Depending on the output type, you can optionally specify a Header and/or a Footer in the text box(es).

    Headers and footers are centered by default. Type a left angle bracket (<) before the header or footer text to left align the text. Click Header or Footer to enter a header or footer of more than one line. Alternatively, you can enter a semi-colon (;) as a line-break character in the header or footer text box. Left aligning multiple lines requires a left angle bracket at the beginning of each line.

  10. Click the More tab.
  11. Select the appropriate option in the Scope panel.
    • All – This option is selected by default. Leave it selected to specify that all records in the view will be processed.

    • First – Select this option and enter a number in the text box to start processing at the first record in the view and include only the specified number of records.

    • Next – Select this option and enter a number in the text box to start processing at the currently selected record in the view and include only the specified number of records. The actual record number in the leftmost column must be selected, not data in the row.

    • While – Select this option to use a WHILE statement to limit the processing of records in the view based on a particular criterion or set of criteria. You can enter a condition in the While text box, or click While to create a WHILE statement using the Expression Builder.

      A WHILE statement allows records in the view to be processed only while the specified condition evaluates to true. As soon as the condition evaluates to false, the processing terminates, and no further records are considered. You can use the While option in conjunction with the All, First, or Next options.

    Note

    The number of records specified in the First or Next options references either the physical or the indexed order of records in a table, and disregards any filtering or quick sorting applied to the view. However, results of analytical operations respect any filtering.

    If a view is quick sorted, Next behaves like First.

  12. If you do not want to show values that fall outside the specified minimum and maximum interval values, select Suppress Others.
  13. In Columns, enter the number of text columns that you want to use if you are saving the results in a text file. If you leave the Columns field blank, the default value of 78 is applied.
    Note

    In this context, Columns refers to the number of units of text that can fit across the width of the page or screen, not columns in an ACL table. In most cases, you can leave the field blank to accept the default of 78.

  14. If you are sending histogram output to screen, a file, or printer you can optionally break down the output results based on the values in a character field. Enter the field name in the Break text box, or click Break to select the field, or to create an expression.

    For example, a histogram of an accounts receivable table could be broken down by customer. Break can only be used with a single character field, so nested breakdowns are not supported.

    Note

    For the Break option to yield meaningful results, the character field must be sorted prior to creating a histogram.

  15. If you selected File as the output type, and want to append the output results to the end of an existing text file, select Append To Existing File.
  16. Click OK.
  17. If the overwrite prompt appears, select the appropriate option.
Related concepts
About histograms


(C) 2013 ACL Services Ltd. All Rights Reserved. | Send feedback