%SECTION0% groupTable
#TableOfContents
%TOC%

---
---++ Purpose
Apply a user-specified function to condense into a single row all those rows for which columns 'label' have identical values. Output table will contain as many rows as there are different (unique) values in the grouping column(s). Periodic domain averaging of coordinate values is supported.  Examples: For grain averaged values, replace all rows of particular 'texture' with a single row containing their average. groupTable --label texture --function np.average data.txt

%UPTOC%
---++ Usage
<pre>
&gt; groupTable options <a href=./AsciiTableFormat.html>ASCII table</a>(s) 
</pre>

%UPTOC%
---++ Options

---+++ General
   $=-l= / =--label=: 
   column label(s) for grouping rows
   $=-f= / =--function= [ *np.average* ]: 
   mapping function
   $=-a= / =--all=: 
   apply mapping function also to grouping column(s)

---+++ periodic averaging
   $=-p= / =--periodic=: 
   coordinate label(s) to average across periodic domain
   $=--limits= [ *0.0, 1.0* ]: 
   min and max of periodic domain