332

I want to shuffle the lines of a text file randomly and create a new file. The file may have several thousands of lines.

How can I do that with cat, awk, cut, etc?

3

19 Answers 19

413

You can use shuf. On some systems at least (doesn't appear to be in POSIX).

As jleedev pointed out: sort -R might also be an option. On some systems at least; well, you get the picture. It has been pointed out that sort -R doesn't really shuffle but instead sort items according to their hash value.

[Editor's note: sort -R almost shuffles, except that duplicate lines / sort keys always end up next to each other. In other words: only with unique input lines / keys is it a true shuffle. While it's true that the output order is determined by hash values, the randomness comes from choosing a random hash function - see manual.]

17
  • 39
    shuf and sort -R differ slightly, because sort -R randomly orders the elements according to hash of them, which is, sort -R will put the repeated elements together, while shuf shuffles all the elements randomly.
    – semekh
    Aug 28, 2012 at 14:32
  • 151
    For OS X users: brew install coreutils, then use gshuf ... (: Jan 24, 2013 at 15:53
  • 15
    sort -R and shuf should be seen as completely different. sort -R is deterministic. If you call it twice at different times on the same input you will get the same answer. shuf, on the other hand, produces randomized output, so it will most likely give different output on the same input. Feb 6, 2013 at 15:41
  • 22
    That is not correct. "sort -R" uses a different random hash key each time you invoke it, so it produces different output each time. May 16, 2014 at 21:30
  • 4
    Note on randomness: per the GNU docs, "By default these commands use an internal pseudo-random generator initialized by a small amount of entropy, but can be directed to use an external source with the --random-source=file option." Nov 26, 2015 at 6:11
92

Perl one-liner would be a simple version of Maxim's solution

perl -MList::Util=shuffle -e 'print shuffle(<STDIN>);' < myfile
6
  • 7
    I aliased this to shuffle on OS X. Thanks! Feb 22, 2014 at 17:38
  • This was the only script on this page that returned REAL random lines. Other awk solutions often printed duplicate output. May 13, 2014 at 6:38
  • 1
    But be careful because in the out you will lost one line :) It just will be joined with another line :)
    – JavaRunner
    Nov 3, 2014 at 17:38
  • @JavaRunner: I assume you're talking about input without a trailing \n; yes, that \n must be present - and it typically is - otherwise you'll get what you describe.
    – mklement0
    May 2, 2015 at 18:15
  • 1
    Wonderfully concise. I suggest replacing <STDIN> with <>, so the solution works with input from files too.
    – mklement0
    May 2, 2015 at 18:16
68

This answer complements the many great existing answers in the following ways:

  • The existing answers are packaged into flexible shell functions:

    • The functions take not only stdin input, but alternatively also filename arguments
    • The functions take extra steps to handle SIGPIPE in the usual way (quiet termination with exit code 141), as opposed to breaking noisily. This is important when piping the function output to a pipe that is closed early, such as when piping to head.
  • A performance comparison is made.


  • POSIX-compliant function based on awk, sort, and cut, adapted from the OP's own answer:
shuf() { awk 'BEGIN {srand(); OFMT="%.17f"} {print rand(), $0}' "$@" |
               sort -k1,1n | cut -d ' ' -f2-; }
shuf() { perl -MList::Util=shuffle -e 'print shuffle(<>);' "$@"; }
shuf() { python -c '
import sys, random, fileinput; from signal import signal, SIGPIPE, SIG_DFL;    
signal(SIGPIPE, SIG_DFL); lines=[line for line in fileinput.input()];   
random.shuffle(lines); sys.stdout.write("".join(lines))
' "$@"; }

See the bottom section for a Windows version of this function.

shuf() { ruby -e 'Signal.trap("SIGPIPE", "SYSTEM_DEFAULT");
                     puts ARGF.readlines.shuffle' "$@"; }

Performance comparison:

Note: These numbers were obtained on a late-2012 iMac with 3.2 GHz Intel Core i5 and a Fusion Drive, running OSX 10.10.3. While timings will vary with OS used, machine specs, awk implementation used (e.g., the BSD awk version used on OSX is usually slower than GNU awk and especially mawk), this should provide a general sense of relative performance.

Input file is a 1-million-lines file produced with seq -f 'line %.0f' 1000000.
Times are listed in ascending order (fastest first):

  • shuf
    • 0.090s
  • Ruby 2.0.0
    • 0.289s
  • Perl 5.18.2
    • 0.589s
  • Python
    • 1.342s with Python 2.7.6; 2.407s(!) with Python 3.4.2
  • awk + sort + cut
    • 3.003s with BSD awk; 2.388s with GNU awk (4.1.1); 1.811s with mawk (1.3.4);

For further comparison, the solutions not packaged as functions above:

  • sort -R (not a true shuffle if there are duplicate input lines)
    • 10.661s - allocating more memory doesn't seem to make a difference
  • Scala
    • 24.229s
  • bash loops + sort
    • 32.593s

Conclusions:

  • Use shuf, if you can - it's the fastest by far.
  • Ruby does well, followed by Perl.
  • Python is noticeably slower than Ruby and Perl, and, comparing Python versions, 2.7.6 is quite a bit faster than 3.4.1
  • Use the POSIX-compliant awk + sort + cut combo as a last resort; which awk implementation you use matters (mawk is faster than GNU awk, BSD awk is slowest).
  • Stay away from sort -R, bash loops, and Scala.

Windows versions of the Python solution (the Python code is identical, except for variations in quoting and the removal of the signal-related statements, which aren't supported on Windows):

  • For PowerShell (in Windows PowerShell, you'll have to adjust $OutputEncoding if you want to send non-ASCII characters via the pipeline):
# Call as `shuf someFile.txt` or `Get-Content someFile.txt | shuf`
function shuf {
  $Input | python -c @'
import sys, random, fileinput;
lines=[line for line in fileinput.input()];
random.shuffle(lines); sys.stdout.write(''.join(lines))
'@ $args  
}

Note that PowerShell can natively shuffle via its Get-Random cmdlet (though performance may be a problem); e.g.:
Get-Content someFile.txt | Get-Random -Count ([int]::MaxValue)

  • For cmd.exe (a batch file):

Save to file shuf.cmd, for instance:

@echo off
python -c "import sys, random, fileinput; lines=[line for line in fileinput.input()]; random.shuffle(lines); sys.stdout.write(''.join(lines))" %*
2
  • SIGPIPE doesn't exist on Windows so I used this simple one-liner instead: python -c "import sys, random; lines = [x for x in sys.stdin.read().splitlines()] ; random.shuffle(lines); print(\"\n\".join([line for line in lines]));"
    – elig
    Sep 28, 2019 at 20:08
  • @elig: Thanks, but omitting from signal import signal, SIGPIPE, SIG_DFL; signal(SIGPIPE, SIG_DFL); from the original solution is sufficient, and retains the flexibility of also being able to pass filename arguments - no need to change anything else (except for quoting) - please see the new section I've added at the bottom.
    – mklement0
    Sep 29, 2019 at 4:26
27

I use a tiny perl script, which I call "unsort":

#!/usr/bin/perl
use List::Util 'shuffle';
@list = <STDIN>;
print shuffle(@list);

I've also got a NULL-delimited version, called "unsort0" ... handy for use with find -print0 and so on.

PS: Voted up 'shuf' too, I had no idea that was there in coreutils these days ... the above may still be useful if your systems doesn't have 'shuf'.

2
  • nice one, RHEL 5.6 does not have shuf ( May 12, 2011 at 12:49
  • 1
    Nicely done; I suggest replacing <STDIN> with <> in order to make the solution work with input from files too.
    – mklement0
    May 2, 2015 at 18:19
22

Here is a first try that's easy on the coder but hard on the CPU which prepends a random number to each line, sorts them and then strips the random number from each line. In effect, the lines are sorted randomly:

cat myfile | awk 'BEGIN{srand();}{print rand()"\t"$0}' | sort -k1 -n | cut -f2- > myfile.shuffled
6
  • 9
    UUOC. pass the file to awk itself.
    – ghostdog74
    Jan 28, 2010 at 11:30
  • 1
    Right, I debug with head myfile | awk .... Then I just change it to cat; that's why it was left there. Jan 28, 2010 at 13:00
  • Don't need -k1 -n for sort, since the output of awk's rand() is a decimal between 0 and 1 and because all that matters is that it gets reordered somehow. -k1 might help speed it up by ignoring the rest of the line, though the output of rand() should be unique enough to short-circuit the comparison. Mar 19, 2014 at 14:00
  • @ghostdog74: Most so called useless uses of cat are actually useful for being consistent between piped commands and not. Better to keep the cat filename | (or < filename |) than remember how each single program takes file input (or not). Aug 26, 2014 at 18:25
  • 2
    shuf() { awk 'BEGIN{srand()}{print rand()"\t"$0}' "$@" | sort | cut -f2- ;}
    – Meow
    Jan 22, 2015 at 3:27
16

here's an awk script

awk 'BEGIN{srand() }
{ lines[++d]=$0 }
END{
    while (1){
    if (e==d) {break}
        RANDOM = int(1 + rand() * d)
        if ( RANDOM in lines  ){
            print lines[RANDOM]
            delete lines[RANDOM]
            ++e
        }
    }
}' file

output

$ cat file
1
2
3
4
5
6
7
8
9
10

$ ./shell.sh
7
5
10
9
6
8
2
1
3
4
1
  • Nicely done, but in practice much slower than the OP's own answer, which combines awk with sort and cut. For no more than several thousands line it doesn't make much of a difference, but with higher line counts it matters (the threshold depends on the awk implementation used). A slight simplification would be to replace lines while (1){ and if (e==d) {break} with while (e<d).
    – mklement0
    May 5, 2015 at 22:01
11

A one-liner for python:

python -c "import random, sys; lines = open(sys.argv[1]).readlines(); random.shuffle(lines); print ''.join(lines)," myFile

And for printing just a single random line:

python -c "import random, sys; print random.choice(open(sys.argv[1]).readlines())," myFile

But see this post for the drawbacks of python's random.shuffle(). It won't work well with many (more than 2080) elements.

3
  • 2
    the "drawback" is not specific to Python. Finite PRNG periods could be workarounded by reseeding PRNG with entropy from the system like /dev/urandom does. To utilize it from Python: random.SystemRandom().shuffle(L).
    – jfs
    Sep 24, 2014 at 19:26
  • doesn't the join() need to be on '\n' so the lines get printed each in its own ?
    – elig
    Sep 28, 2019 at 20:09
  • @elig: No, because .readLines() returns the lines with a trailing newline.
    – mklement0
    Sep 29, 2019 at 4:36
9

Simple awk-based function will do the job:

shuffle() { 
    awk 'BEGIN{srand();} {printf "%06d %s\n", rand()*1000000, $0;}' | sort -n | cut -c8-
}

usage:

any_command | shuffle

This should work on almost any UNIX. Tested on Linux, Solaris and HP-UX.

Update:

Note, that leading zeros (%06d) and rand() multiplication makes it to work properly also on systems where sort does not understand numbers. It can be sorted via lexicographical order (a.k.a. normal string compare).

3
  • Good idea to package the OP's own answer as a function; if you append "$@", it'll also work with files as input. There is no reason to multiply rand(), because sort -n is capable of sorting decimal fractions. It is, however, a good idea to control awk's output format, because with the default format, %.6g, rand() will output the occasional number in exponential notation. While shuffling up to 1 million lines is arguably enough in practice, it's easy to support more lines without paying much of a performance penalty; e.g. %.17f.
    – mklement0
    May 7, 2015 at 11:30
  • 1
    @mklement0 I didn't notice OPs answer while writing mine. rand() is multiplied by 10e6 to make it work with solaris or hpux sort as far as I remember. Good idea with "$@" May 8, 2015 at 12:46
  • 1
    Got it, thanks; perhaps you could add this rationale for the multiplication to the answer itself; generally, according to POSIX, sort should be able to handle decimal fractions (even with thousands separators, as I've just noticed).
    – mklement0
    May 8, 2015 at 12:53
8

Ruby FTW:

ls | ruby -e 'puts STDIN.readlines.shuffle'
2
  • 1
    Great stuff; If you use puts ARGF.readlines.shuffle, you can make it work with both stdin input and filename arguments.
    – mklement0
    May 8, 2015 at 14:34
  • 1
    Even shorter ruby -e 'puts $<.sort_by{rand}' — ARGF is already an enumerable, so we can shuffle the lines by sorting it by random values.
    – akuhn
    Jul 24, 2015 at 3:08
8

A simple and intuitive way would be to use shuf.

Example:

Assume words.txt as:

the
an
linux
ubuntu
life
good
breeze

To shuffle the lines, do:

$ shuf words.txt

which would throws the shuffled lines to standard output; So, you've to pipe it to an output file like:

$ shuf words.txt > shuffled_words.txt

One such shuffle run could yield:

breeze
the
linux
an
ubuntu
good
life
6

One liner for Python based on scai's answer, but a) takes stdin, b) makes the result repeatable with seed, c) picks out only 200 of all lines.

$ cat file | python -c "import random, sys; 
  random.seed(100); print ''.join(random.sample(sys.stdin.readlines(), 200))," \
  > 200lines.txt
5

We have a package to do the very job:

sudo apt-get install randomize-lines

Example:

Create an ordered list of numbers, and save it to 1000.txt:

seq 1000 > 1000.txt

to shuffle it, simply use

rl 1000.txt
4

If like me you came here to look for an alternate to shuf for macOS then use randomize-lines.

Install randomize-lines(homebrew) package, which has an rl command which has similar functionality to shuf.

brew install randomize-lines

Usage: rl [OPTION]... [FILE]...
Randomize the lines of a file (or stdin).

  -c, --count=N  select N lines from the file
  -r, --reselect lines may be selected multiple times
  -o, --output=FILE
                 send output to file
  -d, --delimiter=DELIM
                 specify line delimiter (one character)
  -0, --null     set line delimiter to null character
                 (useful with find -print0)
  -n, --line-number
                 print line number with output lines
  -q, --quiet, --silent
                 do not output any errors or warnings
  -h, --help     display this help and exit
  -V, --version  output version information and exit
1
  • 2
    Installing Coreutils with brew install coreutils provides the shuf binary as gshuf. Aug 22, 2017 at 15:19
3

This is a python script that I saved as rand.py in my home folder:

#!/bin/python

import sys
import random

if __name__ == '__main__':
  with open(sys.argv[1], 'r') as f:
    flist = f.readlines()
    random.shuffle(flist)

    for line in flist:
      print line.strip()

On Mac OSX sort -R and shuf are not available so you can alias this in your bash_profile as:

alias shuf='python rand.py'
2

If you have Scala installed, here's a one-liner to shuffle the input:

ls -1 | scala -e 'for (l <- util.Random.shuffle(io.Source.stdin.getLines.toList)) println(l)'
1
  • Alluringly simple, but unless the Java VM must be started up anyway, that startup cost is considerable; doesn't perform well with large line counts either.
    – mklement0
    May 8, 2015 at 21:42
1

This bash function has the minimal dependency(only sort and bash):

shuf() {
while read -r x;do
    echo $RANDOM$'\x1f'$x
done | sort |
while IFS=$'\x1f' read -r x y;do
    echo $y
done
}
1
  • Nice bash solution that parallels the OP's own awk-assisted solution, but performance will be a problem with larger input; your use of a single $RANDOM value shuffles correctly only up to 32,768 input lines; while you could extend that range, it's probably not worth it: for instance, on my machine, running your script on 32,768 short input lines takes about 1 second, which is about 150 times as long as running shuf takes, and about 10-15 times as long as the OP's own awk-assisted solution takes. If you can rely on sort being present, awk should be there as well.
    – mklement0
    May 8, 2015 at 20:25
0

In windows You may try this batch file to help you to shuffle your data.txt, The usage of the batch code is

C:\> type list.txt | shuffle.bat > maclist_temp.txt

After issuing this command, maclist_temp.txt will contain a randomized list of lines.

Hope this helps.

1
  • Doesn't work for large files. I gave up after 2 hours for a 1million+ lines file Aug 19, 2014 at 10:41
0

Not mentioned as of yet:

  1. The unsort util. Syntax (somewhat playlist oriented):

    unsort [-hvrpncmMsz0l] [--help] [--version] [--random] [--heuristic]
           [--identity] [--filenames[=profile]] [--separator sep] [--concatenate] 
           [--merge] [--merge-random] [--seed integer] [--zero-terminated] [--null] 
           [--linefeed] [file ...]
    
  2. msort can shuffle by line, but it's usually overkill:

    seq 10 | msort -jq -b -l -n 1 -c r
    
0

Another awk variant:

#!/usr/bin/awk -f
# usage:
# awk -f randomize_lines.awk lines.txt
# usage after "chmod +x randomize_lines.awk":
# randomize_lines.awk lines.txt

BEGIN {
  FS = "\n";
  srand();
}

{
  lines[ rand()] = $0;
}

END {
  for( k in lines ){
    print lines[k];
  }
}

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service, privacy policy and cookie policy

Not the answer you're looking for? Browse other questions tagged or ask your own question.