4.93 sddssequence

• description: sddssequence generates an SDDS file with a single page and several columns of data of arithmetic sequences. An example application is generating values for an independent variable that may be used by sddsprocess() to produce a mathematical function.
• examples:
      sddssequence example.sdds -define=Index,type=long -sequence=begin=1,number=100,delta=1  
      

• synopsis:
      sddssequence [-pipe=[output]] [<outputfile>]  
                   -define=<columnName>[,<definitionEntries>] [-repeat=<number>]  
                   -sequence=begin=<value>[,number=<integer>][,end=<value>][,delta=<value>][,interval=<integer>]  
                   [-sequence=begin=<value>[,number=<integer>][,end=<value>][,delta=<value>][,interval=<integer>] ...]  
      

• switches:
  • -pipe=[output] — The standard SDDS Toolkit pipe option.
  • -define=<columnName>[,<definitionEntries>] — Defines a new column. One or more -sequence options should follow. Definition entries have the form fieldName=value where fieldName is the name of any namelist command field (except the name field) for a column. The default data type is double. To get a different type, use type=<typeName>. Multiple -define options can be used to create multiple columns, each with its own set of -sequence options.
  • -sequence=begin=<value>[,number=<integer>][,end=<value>][,delta=<value>][,interval=<integer>] — Defines the arithmetic sequence for the data column. More than one -sequence option can be given for a column definition, allowing arithmetic sequences of different character in one column. The begin value must be given in the first -sequence option. If subsequent -sequence options follow immediately, a default value equal to the previous end value plus the previous delta value is used. For the rest of the suboptions, the user must supply (end,delta), (end,number), or (delta,number). If number isn’t supplied, then the set of begin, end, delta must imply a positive number of rows. The interval field specifies the number of rows for which the value is frozen within the sequence.
  • -repeat=<number> — Repeats the sequence identically for the given number of times.
• files: outputfile is the name of the SDDS file containing data generated.
• see also:
  • sddsprocess()
  • sddsprintout()
• author: M. Borland, ANL/APS.