See also: Problems installing and running
USEARCH
32-bit and 64-bit binaries
Intro for users of blast, cd-hit, qiime, mothur
Command line
Binary
filename
Installing multiple versions on
the same computer
There is no installer --
don't double-click on the download
filename! USEARCH is
distributed as one file, known as the binary file or executable
file. It is completely self-contained: it does not require
configuration files, environment variables, third-party libraries
or other external dependencies. There is no setup script or
installer because they're not needed. To install it, all you do is
download or copy the binary to a directory that is accessible from
the computer where you want to run the code. For convenience, you
may want to rename the binary file
to usearch to avoid typing long names like usearch6.0.98_i86linux32.
No graphical user interface
USEARCH does not have a GUI. USEARCH will not
work if you try to start it in a graphical interface like
Windows Explorer or the Mac Finder. You must
run USEARCH from within a
command window or shell. See table below for how to
get a shell prompt. If you're not familiar with using command-line programs,
you're probably going to have trouble figuring out how to use USEARCH -- I
recommend getting a colleague to help you who is familiar with using
command-line programs.
Missing DLL problem in Windows
See here if you get missing a vcomp100.dll error.
Execute permissions Under Linux and OSX you must ensure that you have read and execute
permissions for the binary file. If needed, use the chmod command to set the
execute bit, e.g.:
chmod +x
/usr/bin/usearch6.0.98_i86linux32
PATH or pathname The binary
file must be in one of the directories specified in your PATH variable,
or you must type the full path to the file, e.g. for
Linux:
/usr/bin/usearch6.0.98_i86linux32 -id 0.9
-cluster_fast reads.fasta -uc results.uc
Under the Windows CMD shell, path names
are separated by backslashes, e.g.:
C:\MyPrograms\usearch6.2.98_win32.exe -id 0.9
-cluster_fast reads.fasta -uc
results.uc
How to get a shell prompt
Platform |
|
How to get a command-line interface |
Linux |
|
There are many different
graphical interfaces and configurations for Linux and Unix, too
many that I can cover them all. Look for an icon labeled something
like ''Shell', 'Command window' or 'Terminal'.
|
Mac OSX |
|
Look for the Terminal command
under Applications > Utilities. This will give you a shell
prompt similar to Unix and Linux.
|
Windows |
|
You can get a command-prompt
by navigating Start > All Programs > Accessories > Command
Prompt, or similar, depending on which version of Windows you're
using. You can also use Start > Run, and type CMD or CMD.EXE
when prompted for the name of the program to
run.
|
Windows with Cygwin |
|
If you're familiar with using
Unix or Linux shells, you might want to check out the Cygwin environment: it's a really good
Linux emulator for Windows that includes shells (sh, bash, csh, tsh
etc.) and a huge number of standard Linux utilities (ls, grep, tar,
ssh and so on). The *win32.exe or *win64.exe binaries run fine
under Cygwin, though there can be subtle issues with file names and
path names because the native build doesn't understand
Cygwin-specific stuff like mount points. As a general rule, you can
use Windows paths under Cygwin, including drive letters. You can
use forward- or back-slashes in the path name, though you have to
be careful with back-slashes because they're significant for the
shell; usually it's easier to use forward
slashes. |
|