Sometimes when entering data or naming runs and resources, you will want to fill values down a column using a sequence.
Why would I want to use the Generate Value Sequence feature?
Some common examples include entering sequential time point data, entering repeated sequence, or naming output sample resources or runs:
These examples (any many more) are handled in Riffyn via the "Generate Value Sequence" feature.
How do I access the Generate Value Sequence feature?
To use this feature, first select the runs that you want to be automatically filled using a sequence by scrolling all the way to the left in the bottom panel, and either selecting all runs by clicking the box next the the "Label" header (most common), or selecting a subset of runs:
Next, navigate to the column you want fill using a sequence. This could be a property, the run name column, or an output resource name column. Right click on the value cell (NOT the header) where you want your sequential fill to initiate, then choose "Generate Value Sequence" from the drop down list:
You will see this modal:
Sequences can also be saved and recalled using this sequence editing modal. The last 3 sequences used can be accessed from a context menu by right clicking on a run.
How do I use the Generate Value Sequence feature?
Follow these instructions to generate a sequence of property values or run or resource names. For the 3 examples shown above, the commands were:
- To generate sequential time point data: [1-10]
- This will generate time point series data of the pattern 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 1, 2, 3....etc.
- To generate repeating sequences: [0.5,1,4,8]
- This will generate time point series data of the pattern 0.5, 1, 4, 8, 0.5, 1, 4, 8, 1....etc.
- To generate unique sample names: Sample[1-100]
- This will generate resource names of the pattern Sample1, Sample2, Sample3, etc.
Note: If you want unique names, the largest number in your range needs to be equal to or greater than the number of runs on your step, otherwise, you will end up with repetitive names
Advanced outputs can be generated using combinations of sequences
'[A-C][1-3]' will yield: A1, A2, A3, B1, B2, B3, C1, C2, C3.
'[A-C]![1-3]' will yield: A1, B1, C1, A2, B2, C2, A3, B3, C3. Note that the "!" operator causes the first operand to be iterated first in conjunction with the second operand.
'[A-C];[1-3]' will yield: A, B, C, 1, 2, 3. Note that the ";" operator causes the first operand to be fully iterated first.