Copyright in Elves is owned by the University of California.
The University makes Elves freely-available to
academic and not-for-profit institutions,
or any on-site user of a synchrotron beam line.
Other users must obtain a license from the University.
To obtain a license, see below.
Elves
version 1.3.19 is the current release. It is available here
as a plain
script file, a gzipped
script, or a tarball
distribution. Use the tar
file if you want all the Elves components and all their embedded goodies
in independently-accessible form.
Not-for-Profit Organizations and synchrotron guests
You may download and use Elves for academic and not-for-profit use or on-site use at a synchrotron beam line,
without fee and without a signed license agreement. Other users must obtain a license from the University. To
obtain a license, see below.
Elves for the impatient...
-
download Elves
(last updated: 3-6-2019)
-
save the file
as "Elves" somewhere in your $path
(~/bin/Elves, perhaps, or just ./Elves)
-
make sure you set the permissions: chmod u+x
~/bin/Elves
-
you are now ready to run Elves
-
Make Elves a place to work
-
cd /bigdisk/yourname/ (or something)
-
mkdir elves
-
cd elves
-
Run Elves
-
unix% Elves process data in /where/ever/your/frames/are/
in P212121 with 8 selenium sites
-
(if your $path is screwed up, you
might need to type "rehash", or use:
~/bin/Elves or maybe ./Elves)
-
Elves were created to be easy to use and understand. Anything they do or
say that you do not understand is, oficially, considered a bug. Please
report bugs to James Holton.
In a pinch, the Elves
Manual might be helpful in finding your way around them.
That's it!
Fore more detailed instructions on how to use Elves, please see the
Elves
Manual.
For an illustrated reenactment of a session with Elves, see the Example
Elves Session.
That didn't work...
If you follow the above procedure and Elves crash immediately, the file
might have been corrupted in transfer. In that case, follow these
directions:
-
download Elves.gz
-
save the file
as "Elves.gz" somewhere in your $path
(~/bin/Elves.gz, perhaps, or just
./Elves.gz)
-
unpack it
-
decompress the file: gunzip ~/bin/Elves.gz
-
make sure you set the permissions: chmod u+x
~/bin/Elves
-
you are now ready to run Elves
-
Make Elves a place to work
-
cd /bigdisk/yourname/ (or something)
-
mkdir elves
-
cd elves
-
Run Elves
-
unix% Elves process data in /where/ever/your/frames/are/
in P212121 with 8 selenium sites
-
(if your $path is screwed up, you
might need to type "rehash", or use:
~/bin/Elves or maybe ./Elves)
Full installation...
If you want to install Elves and all their embedded programs in exploded
form (i.e. you are a system administrator), follow these instructions:
-
download Elves_1.3.6.1.1.tar.gz
-
save the file
as "Elves_1.3.6.1.1.tar.gz". Doesn't
matter where.
-
Decide on where to put the files (/usr/local/bin,
/programs/bin,
or $CBIN are popular choices)
-
unpack it
-
decompress the tar file: gunzip Elves_1.3.6.1.1.tar.gz
-
cd to where you want to put the files: cd /programs/bin
-
restore the tar archive: tar xvf ~/Elves_1.3.6.1.1.tar
-
as long as /programs/bin is in your
$path,
you are now ready to run Elves
-
Make Elves a place to work
-
cd /bigdisk/yourname/ (or something)
-
mkdir elves
-
cd elves
-
Run Elves
-
unix% Elves process data in /where/ever/your/frames/are/
in P212121 with 8 selenium sites
-
(if your $path is screwed up, you
might need to type "rehash", or use:
~/bin/Elves
or maybe ./Elves)
This is a full installation of Elves and all their goodies.
For-Profit Organizations
You need a license to use Elves except for the collection and processing of data during assigned times at a
synchroton beamline. Anyone is welcome to download Elves onto a beamline computer and use it during your
beam time. If you decide that you like Elves so much that you want to take them home (and I hope you do),
please send an email to Curt:
Curt Theisen
Office of Technology
Licensing
2150 Shattuck Avenue, Suite 510
Berkeley, CA 94704-1347
(510)-643-7214 FAX: (510)-642-4566
Back to the Elves Page.
This page is not finished. It will never be finished, and neither will
yours. Admit it.