Description
Plan unit-width histogram bins centered on every integer from first through last inclusive.
Histogram edges divide a numeric coordinate axis into ordered bins, while each bin mass represents a count or nonnegative weight. Probability mass is a fraction of the total; probability density additionally divides by bin width and therefore has inverse coordinate units. An edge plan alone contains no observations.
Plan unit-width histogram bins centered on every integer from first through last inclusive.
When to use this tool
Use these edges when each integer observation should lie at the center of its own unit-width bin.
How to use the tool and how it works
- Enter first, last using the definitions below.
- Run the operation. Resolve input-format errors before interpreting an output.
- Read result.edges, using the stated boundary, ordering, sign and absence conventions.
Emit unit-spaced edges first-0.5, first+0.5, and so on through last+0.5, so the bins are centered on every integer first through last.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| first | First integer bin center, within ±10⁹. | Finite safe integer satisfying the stated bounds. |
| last | Final integer bin center, integer first through first+126. | Finite safe integer satisfying the stated bounds. |
| Output field | Interpretation |
|---|---|
| result | Object containing the fields below. |
| result.edges | Resulting increasing coordinate boundaries; no observations are implicitly added. |
{
"input": {
"first": -1,
"last": 2
},
"output": {
"result": {
"edges": [
-1.5,
-0.5,
0.5,
1.5,
2.5
]
}
}
}Limitations and assumptions
- first is an integer within ±10⁹ and last is an integer from first through first+126. The result is an edge plan only; observations are not counted.
- This operation returns a coordinate edge plan only. It does not select a statistically optimal bin count, count observations or assign sample weights. Floating-point representability remains part of the plan’s validation.
- Every declared outer field is required and unknown outer fields are rejected. Strings and JSON text have size limits, lists are bounded to 128 entries, and JSON nesting/node counts are bounded. Tighter operation-specific bounds stated above take precedence.
- Numeric outputs must remain finite and within safe-integer magnitude. Original record indexes and cell coordinates are zero-based; stated half-open ranges exclude their end.
Alternative or Complementary methods
Keep edge definitions with mass arrays. Use common-boundary coarsening and whole-bin merging for aligned comparisons; use observation-level data when a calculation requires locations within bins.
References
Similar or alternative tools
- Histogram Log Spaced Edge Plan
Plan logarithmically spaced positive histogram edges with explicit endpoints and a supplied bin count.
- Histogram Sample Provenance Groups
Group original observation indexes into explicit histogram bins and retain outside-domain indexes.