Batch 6 triage: 21 data manipulation filters categorized

- Tier 1 (Critical): 0
- Tier 2 (Important): 10 (CreateAttributeMatrix, CreateDataGroup, DeleteData,
  RenameDataObject, MoveData, CopyFeatureArrayToElementArray,
  CreateFeatureArrayFromElementArray, ConditionalSetValue,
  ConvertColorToGrayScale, ReshapeDataArray)
- Tier 3 (Polish): 11 (CreateDataArray, CreateDataArrayAdvanced,
  CopyDataObject, CombineAttributeArrays, ConcatenateDataArrays,
  SplitDataArrayByComponent, SplitDataArrayByTuple,
  ExtractComponentAsArray, ConvertData, ArrayCalculator, InitializeData)

Author: imikejackson

docs/documentation_review_tracker.md

@@ -15,7 +15,7 @@
 | 3 | Segmentation / Feature Identification | 10 | 10 | 10 | Complete |
 | 4 | Neighbor / Kernel Operations | 11 | 11 | 11 | Complete |
 | 5 | Geometry Creation / Manipulation | 15 | 15 | 15 | Complete |
-| 6 | Data Manipulation (Copy, Create, Delete, Rename) | ~20 | 0 | 0 | Not Started |
+| 6 | Data Manipulation (Copy, Create, Delete, Rename) | 21 | 21 | 0 | Triaged |
 | 7 | I/O Filters (Read/Write) | ~15 | 0 | 0 | Not Started |
 | 8 | Image Processing (ITK wrappers) | ~88 | 0 | 0 | Not Started |
 | 9 | Remaining SimplnxCore filters | ~varies | 0 | 0 | Not Started |
@@ -438,7 +438,139 @@ None. No filter in this batch has a non-expert blocker.
 
 ---
 
-## Batches 6-9: Not Yet Triaged
+## Batch 6: Data Manipulation
+
+**Plugin:** SimplnxCore
+**Filters:** 21 (create / copy / delete / rename / move / combine / split / convert / initialize / calculate)
+
+### Tier 1 — Critical
+
+None. No filter in this batch is incomprehensible to a non-expert.
+
+### Tier 2 — Important
+
+| Filter | Plugin | Status |
+|--------|--------|--------|
+| CreateAttributeMatrix | SimplnxCore | Pending |
+| CreateDataGroup | SimplnxCore | Pending |
+| DeleteData | SimplnxCore | Pending |
+| RenameDataObject | SimplnxCore | Pending |
+| MoveData | SimplnxCore | Pending |
+| CopyFeatureArrayToElementArray | SimplnxCore | Pending |
+| CreateFeatureArrayFromElementArray | SimplnxCore | Pending |
+| ConditionalSetValue | SimplnxCore | Pending |
+| ConvertColorToGrayScale | SimplnxCore | Pending |
+| ReshapeDataArray | SimplnxCore | Pending |
+
+- [ ] **CreateAttributeMatrixFilter** (SimplnxCore)
+  - **Clarity:** Extremely brief (only ~20 lines). Lone example does not explain what an Attribute Matrix conceptually represents.
+  - **Completeness:** Missing the *why* (tuple-dimensions discipline for arrays in the same matrix), the *when* (typical use cases — creating a Feature Attribute Matrix, an Ensemble Attribute Matrix), and the relationship to DataGroup.
+  - **Accessibility:** Assumes the user already knows what an Attribute Matrix is.
+  - **Figures Needed:** Optional — a hierarchy diagram showing Image Geometry → Cell Attribute Matrix → arrays would also serve CreateGeometry/CreateDataGroup.
+  - **Concept Links:** Attribute Matrix, tuple dimensions, DataGroup vs Attribute Matrix
+  - **Notes:** Add "What is an Attribute Matrix?" subsection. Cross-link to CreateDataGroup with explicit when-to-use-which guidance. Note tuple-dimension consistency requirement.
+
+- [ ] **CreateDataGroupFilter** (SimplnxCore)
+  - **Clarity:** Only 1 paragraph; says "unlike AttributeMatrix, DataGroups are capable of holding any DataObject of any size" but doesn't explain when to choose one over the other.
+  - **Completeness:** Missing typical use case (organizing related arrays of different sizes, creating an output structure for a future filter).
+  - **Concept Links:** DataGroup, AttributeMatrix
+  - **Notes:** Expand. Cross-reference CreateAttributeMatrix and explain the choice: DataGroup for heterogeneous content, Attribute Matrix when all child arrays must share tuple dimensions.
+
+- [ ] **DeleteDataFilter** (SimplnxCore)
+  - **Clarity:** Two use cases (memory and name collisions) clearly explained.
+  - **Completeness:** Missing: cascade behavior (does deleting a Geometry also delete its Attribute Matrices? Does deleting an Attribute Matrix delete its child arrays?), what happens to downstream filters that reference the deleted object.
+  - **Concept Links:** cascade delete, object lifetimes
+  - **Notes:** Document the cascade behavior. Add explicit warning: subsequent filters that selected the deleted object will fail preflight.
+
+- [ ] **RenameDataObjectFilter** (SimplnxCore)
+  - **Clarity:** Single sentence.
+  - **Completeness:** Missing: what happens to filter parameters downstream that reference the old name (they won't auto-update — preflight will fail). What name collisions are allowed/disallowed.
+  - **Notes:** Expand to one paragraph. Warn about downstream filter parameter references not updating automatically.
+
+- [ ] **MoveDataFilter** (SimplnxCore)
+  - **Clarity:** Brief but covers the tuple-count requirement.
+  - **Completeness:** Missing: examples (moving a computed array into a Feature Attribute Matrix; moving an array between DataGroups). What happens to arrays that are children of the moved object.
+  - **Concept Links:** parent-child hierarchy, tuple validation
+  - **Notes:** Add concrete examples. Explain that tuple-dimension *shape* doesn't need to match — only the *number of tuples*.
+
+- [ ] **CopyFeatureArrayToElementArrayFilter** (SimplnxCore)
+  - **Clarity:** "Xmdf visualization files write only the Element attributes" is jargon and almost the entire rationale.
+  - **Completeness:** Missing: general "when to use" (broadcasting a per-Feature scalar to every cell of that feature for visualization), parameter description.
+  - **Notes:** Lead with the general purpose (broadcast Feature-level value back to all cells of the Feature). Explain the Xmdf-export reason as one specific use case rather than the only one. Add Required Input Sources.
+
+- [ ] **CreateFeatureArrayFromElementArrayFilter** (SimplnxCore)
+  - **Clarity:** "the value of the *last element copied*" is buried as the central footgun.
+  - **Completeness:** Missing: warning that this filter is destructive when used on per-cell scalars that vary within a feature (since most cells get discarded). When to use vs. ComputeArrayStatistics (which computes per-feature means).
+  - **Notes:** Promote the "last element copied" caveat to a Warning section. Cross-reference ComputeArrayStatistics for averaging behavior. Add Required Input Sources.
+
+- [ ] **ConditionalSetValueFilter** (SimplnxCore)
+  - **Clarity:** Two modes (conditional mask vs value-replacement) buried in one dense sentence.
+  - **Completeness:** Mode parameter (*Use Conditional Mask*) is the central control but not promoted.
+  - **Notes:** Split the two modes into their own subsections. Document *Use Conditional Mask* explicitly. Add Required Input Sources.
+
+- [ ] **ConvertColorToGrayScaleFilter** (SimplnxCore)
+  - **Clarity:** Four conversion algorithms documented with formulas.
+  - **Completeness:** Missing: when to use (preprocessing color images for downstream grayscale-only filters), expected input format (uint8 RGB/RGBA), output type.
+  - **Notes:** Add "When to Use" lead-in. State input/output array types and component shapes. Add Required Input Sources (ITK image reader).
+
+- [ ] **ReshapeDataArrayFilter** (SimplnxCore)
+  - **Clarity:** Critical footgun warning ("DOES NOT MOVE ANY VALUES IN MEMORY") is buried at line 11.
+  - **Completeness:** Stride-mismatch example is good but the warning needs more prominence given that misuse silently produces wrong results.
+  - **Concept Links:** strides, row-major / C-order storage, tuple dimensions
+  - **Notes:** Promote the "no memory rearrangement" warning into a top-level Warning section. Add a "When NOT to Use" callout. Add Required Input Sources.
+
+### Tier 3 — Polish
+
+| Filter | Plugin | Status |
+|--------|--------|--------|
+| CreateDataArray | SimplnxCore | Pending |
+| CreateDataArrayAdvanced | SimplnxCore | Pending |
+| CopyDataObject | SimplnxCore | Pending |
+| CombineAttributeArrays | SimplnxCore | Pending |
+| ConcatenateDataArrays | SimplnxCore | Pending |
+| SplitDataArrayByComponent | SimplnxCore | Pending |
+| SplitDataArrayByTuple | SimplnxCore | Pending |
+| ExtractComponentAsArray | SimplnxCore | Pending |
+| ConvertData | SimplnxCore | Pending |
+| ArrayCalculator | SimplnxCore | Pending |
+| InitializeData | SimplnxCore | Pending |
+
+- [ ] **CreateDataArrayFilter** (SimplnxCore)
+  - **Notes:** Already has good data-type ranges table and semicolon-notation example. Minor polish: state that Number of Components must be ≥ 1; explicitly note that this filter creates a *single component dimension* (use CreateDataArrayAdvanced for multi-dimension components). Add Required Input Sources (none).
+
+- [ ] **CreateDataArrayAdvancedFilter** (SimplnxCore)
+  - **Notes:** Documents 4 initialization modes (Fill, Incremental, Random, Random With Range) and Step Operation. Mostly good. Polish: state component-dimension product must be ≥ 1; clarify that multi-dimensional components (e.g., 3x3 tensor) are supported here. Cross-link CreateDataArray as the simpler version.
+
+- [ ] **CopyDataObjectFilter** (SimplnxCore)
+  - **Notes:** Clear; "deep copy" semantics for BaseGroup containers documented. Polish: cross-link Copy to New Parent option more explicitly; add Required Input Sources (none).
+
+- [ ] **CombineAttributeArraysFilter** (SimplnxCore)
+  - **Notes:** Already has worked examples and figures. Polish: cross-link "Concatenate Data Arrays" already present; mention the use case of building a Vertex coordinates array from three separate x/y/z arrays. Add Required Input Sources.
+
+- [ ] **ConcatenateDataArraysFilter** (SimplnxCore)
+  - **Notes:** Brief but clear. Cross-link to Combine Attribute Arrays is present. Polish: state that the result is always 1-D (already does); add example.
+
+- [ ] **SplitDataArrayByComponentFilter** (SimplnxCore)
+  - **Notes:** Clear worked example. Polish: minor copy-edit ("unput" → "input"); state the "specifying a subset of components" mode more cleanly; cross-link Combine Attribute Arrays as the inverse operation (already does).
+
+- [ ] **SplitDataArrayByTupleFilter** (SimplnxCore)
+  - **Notes:** Clear worked example. Polish: cross-link Split Data Array (By Component) present. Polish: state units on tuple counts (integer counts).
+
+- [ ] **ExtractComponentAsArrayFilter** (SimplnxCore)
+  - **Notes:** Title in cpp is "Extract/Remove Components" — verify match. Brief but covers the 3 operation modes. Polish: add a worked example showing the 3 modes; add Required Input Sources.
+
+- [ ] **ConvertDataFilter** (SimplnxCore)
+  - **Notes:** Already very thorough with up/down casting and signed/unsigned warnings. Polish: cross-link to Reshape Data Array for the related-but-different "interpret data differently" use case. Add Required Input Sources.
+
+- [ ] **ArrayCalculatorFilter** (SimplnxCore)
+  - **Notes:** Already extremely thorough — operator tables, multi-component handling, explicit array name escaping, multiple worked examples. Polish: minor only. Cross-link to Convert Angles to Degrees or Radians (already mentioned). Add Required Input Sources.
+
+- [ ] **InitializeDataFilter** (SimplnxCore)
+  - **Notes:** Content is good but the prose is rambly. Polish: restructure each initialization mode into its own subsection with a brief intro and bullet list of nuances rather than nested bullet trees. Move boolean entry rules to a single dedicated subsection.
+
+---
+
+## Batches 7-9: Not Yet Triaged
 
 The following batches have been identified in the design spec but have not yet been triaged. Each batch will be triaged at the start of its work cycle.
 
@@ -627,10 +759,6 @@ The following batches have been identified in the design spec but have not yet b
 
 ---
 
-### Batch 6: Data Manipulation (~20 filters)
-**Plugin:** SimplnxCore
-Basic data operations (copy, create, delete, rename, move, combine attribute arrays, etc.)
-
 ### Batch 7: I/O Filters (~15 filters)
 **Plugin:** SimplnxCore + OrientationAnalysis
 Read/write filters (DREAM3D, STL, VTK, CSV, etc.)