# istat command

The istat command produces a graphic
representation of item-ID distribution within a file and suggests
a new modulo. The istat command is equivalent to
the hash-test command.

## Syntax

```
istat file.reference{item.list} {modifiers} {(options)}
```

## Parameter(s)

| options | r | Provides additional information about indirect (pointer) items, that are otherwise not accurately reflected by the output. |
| --- | --- | --- |
| s | Suppresses display of histogram; displays summary statistics only. | |

## Example(s)

```
istat entity (s
file = entity modulo = 11 16:08:40 14 Feb 2004
frames bytes items
 11
 Hash-Test/Istat Statistics
total item count = 8 byte count = 2226
avg. bytes/item = 270.2 avg. items/group = 3
std. deviation = 1.0 avg. bytes/group = 202.3
suggested modulo = 3.0
```

## See also

- [AQL command categories](https://d3codex.com/access/aql-command-categories/)
- [f-resize command](https://d3codex.com/tcl/f-resize-command/)
- [File reference (Access Query Language)](https://d3codex.com/access/file-reference-access-query-language/)
- [File-of-files file (VME)](https://d3codex.com/systemfiles/file-of-files-file-vme/)
- [hash-test command](https://d3codex.com/access/hash-test-command/)
- [item command](https://d3codex.com/tcl/item-command/)
- [Item list](https://d3codex.com/access/item-list/)
- [Modifiers](https://d3codex.com/access/modifiers/)
- [modulo](https://d3codex.com/attributedefiningitem/modulo-attribute-defining-items/)
- [nframe-index command](https://d3codex.com/tcl/nframe-index-command/)
- [Options (Access Query Language)](https://d3codex.com/access/options-access-query-language/)
- [Pointer item](https://d3codex.com/definitions/pointer-item/)
- [resize command](https://d3codex.com/tcl/resize-command/)
- [Selection criteria](https://d3codex.com/access/selection-criteria/)
- [check-sum command](https://d3codex.com/access/check-sum-command/)

---
Source: https://d3codex.com/access/istat-command/ - part of the D3Codex reference.