SHUFFLE

[ Program Manual | User's Guide | Data Files | Databases ]

Table of Contents
FUNCTION
DESCRIPTION
EXAMPLE
OUTPUT
INPUT FILES
RELATED PROGRAMS
COMMAND-LINE SUMMARY
LOCAL DATA FILES
PARAMETER REFERENCE

FUNCTION

[ Top | Next ]

Shuffle randomizes the order of the symbols in a sequence without changing the composition.

DESCRIPTION

[ Previous | Top | Next ]

Shuffle uses a random number generator to scramble the positions of the symbols in a sequence. The generator is initialized with the current time, so repeated shuffles should yield different results.

EXAMPLE

[ Previous | Top | Next ]

Here is a session using Shuffle to randomize the bases of gamma.seq:


% shuffle

  SHUFFLE of what sequence ?  gamma.seq

                    Begin (* 1 *) ?
                  End (* 11375 *) ?
                 Reverse (* No *) ?

  What should I call the output file (* gamma.shuffle *) ?

%

OUTPUT

[ Previous | Top | Next ]

The file gamma.shuffle now contains the shuffled contents of gamma.seq.

INPUT FILES

[ Previous | Top | Next ]

Shuffle accepts a single sequence as input. The function of Shuffle depends on whether your input sequence(s) are protein or nucleotide. Programs determine the type of a sequence by the presence of either Type: N or Type: P on the last line of the text heading just above the sequence. If your sequence(s) are not the correct type, see Appendix VI for information on how to change or set the type of a sequence.

RELATED PROGRAMS

[ Previous | Top | Next ]

Sample extracts sequence fragments randomly from sequence(s). You can set a sampling rate to determine how many fragments Sample extracts. Corrupt randomly introduces small numbers of substitutions, insertions, and deletions into nucleotide sequence(s).

COMMAND-LINE SUMMARY

[ Previous | Top | Next ]

All parameters for this program may be added to the command line. Use -CHEck to view the summary below and to specify parameters before the program executes. In the summary below, the capitalized letters in the parameter names are the letters that you must type in order to use the parameter. Square brackets ([ and ]) enclose parameter values that are optional. For more information, see "Using Program Parameters" in Chapter 3, Using Programs in the User's Guide.


Minimal Syntax: % shuffle [-INfile=]gamma.seq -Default

Prompted Parameters:

-BEGin=1 -END=11375       sets the range of interest
-REVerse                  uses the reverse strand
[-OUTfile=]gamma.shuffle  names the output file

Local Data Files:       None

Optional Parameters:

-PREServe=2             preserves dinucleotide or dipeptide composition
                          in shuffled sequence
         =3             preserves trinucleotide or tripeptide composition
                          in shuffled sequence
-NONUMbering            suppresses the numbering in the output file

LOCAL DATA FILES

[ Previous | Top | Next ]

None.

PARAMETER REFERENCE

[ Previous | Top | Next ]

You can set the parameters listed below from the command line. For more information, see "Using Program Parameters" in Chapter 3, Using Programs in the User's Guide.

-PREServe=2

preserves the input sequence's dinucleotide or dipeptide composition in the output shuffled sequence. Use -PREServe=3 to preserve the trinucleotide or tripeptide composition.

-NONUMbering

suppresses the numbering in the output file.

Printed: December 9, 1998 16:29 (1162)

[ Program Manual | User's Guide | Data Files | Databases ]


Documentation Comments: doc-comments@gcg.com
Technical Support: help@gcg.com

Copyright (c) 1982, 1983, 1985, 1986, 1987, 1989, 1991, 1994, 1995, 1996, 1997, 1998 Genetics Computer Group Inc., a wholly owned subsidiary of Oxford Molecular Group, Inc. All rights reserved.

Licenses and Trademarks Wisconsin Package is a trademark of Genetics Computer Group, Inc. GCG and the GCG logo are registered trademarks of Genetics Computer Group, Inc.

All other product names mentioned in this documentation may be trademarks, and if so, are trademarks or registered trademarks of their respective holders and are used in this documentation for identification purposes only.

Genetics Computer Group

www.gcg.com