Installing Unshake
Contents
- Installing Unshake for Java
- System Requirements
- Installation Under Windows
- Installation Under Unix (including Linux)
- Installation on Mac's
- Installation of the C version under Linux
- Mirroring
- Disclaimers and Acknowledgements
- Technical note
You will need Sun's Java 2 (or 5), or a Java 2 which includes Sun's JPEG routines,
"com.sun.image.codec.jpeg". It is relatively easy to download, and instructions are
given below. Apart from that, your system limits only the time taken
to "Unshake" an image, and the size of image which can be processed:
On a Gigahertz PC with 256 MByte of RAM, it should take less than 5 seconds
for a 256 by 256 pixel image, and 4 times that for a 512 by 512 image.
On a 300 Megahertz PC, it takes about 3 times as long, and on my little
75 Megahertz PC it used to take nearly 15 minutes for a 512 by 512 pixel image!
RAM is also a consideration: My little PC only had 64 MByte of RAM, so it
slowed down a lot if I did anything else with it while it was processing a 512
by 512 pixel image.
So the conclusion is: If you can run Java 2, you can run Unshake, though if
you have a small or slow computer, you will have to be patient.
A newly bought PC should have no trouble at all running the code.
- Download this zip file, and
unpack it in a convenient place. A folder will appear called Unshake.
-
Now you need to install Sun's Java 2 (or 5) Runtime Environment, if you
haven't already. It should be enough simply to install the Java
Runtime Environment (JRE), and the best way to do that is to download
it directly from here, or
somewhere else in the site if that link
is out of date. Use the SDK or JRE 1.4 or 1.5, if it is available for
your machine, although earlier versions will be good enough.
Make sure you do not download "Java 1", also known as "1.0" and
"1.1". You need "Java 2" (or 5), which is "1.2", "1.3" etc.
-
You will now be able to run Unshake, from the launcher (see
Use of Unshake, Instructions.html).
If you want an icon on your desktop which will launch Unshake, try
right-clicking on "Launch" in the Unshake folder, and choosing copy,
then pointing to your desktop and choosing "Paste Shortcut". Maybe I'll try creating a nice icon later. If you tell me that it matters!
Any updates for the code will be posted at
http://www.unshake.co.uk/Updates/index.html,
ISP's permitting.
(Including Linux.)
- Download this zip file, and
unpack it in a convenient place. A directory will appear called Unshake.
-
Change directory to Unshake, and make the script unlaunch.sh executable;
mv Unshake15r1.zip convenientplace
cd convenientplace
unzip Unshake15r1.zip
cd Unshake
chmod 755 unlaunch.sh
-
Now you need to install Sun's Java 2 (or 5), if you haven't already (type "java -version" to check this).
Download it directly here,
or somewhere else in the site if that
link is out of date. Use the SDK or JRE 1.4 or 1.5, if it is available
for your machine, although earlier versions will be good
enough. Follow Sun's instructions for installing it, bearing in mind
that Unshake will automatically look for it in your PATH, and in a few
other known places. So if you have root access to your computer, you
might type
# cd /usr/local/bin
# ln -s ../../java/j2sdk1.4.2/bin/java
-
With java installed, you will be able to run Unshake from the launcher
(see Use of Unshake, Instructions.html).
Any updates for the code will be posted at
http://www.unshake.co.uk/Updates/index.html,
ISP's permitting.
The launcher for Mac
OS X (sorry, this does not work for earlier versions of Mac OS) is on trial
release, because I do not have a Mac at home. However, I have created
an applescript which should work with Unshake 1.5, with a few minor
irritations;
- Download this zip file, and unpack it
in a convenient place. A folder will appear called Unshake.
- Move the Unshake folder into Applications>Utilities on your
hard drive. Only this location will work.
- In the Unshake folder is a file MacOSX.dmg. Open this disc image,
and drag the applescript file Unshake from it to a convenient place,
such as your desktop.
- You can now run Unshake by opening the applescript file at any time.
If this fails, open a terminal window
(Applications>Utilities>Terminal), and type "cd
Applications/Utilities" if you have already moved the Unshake folder
there , then follow Installation under Unix, steps 2
and 4 before following the rest of the instructions for generic
UNIX, and please let me know.
In either case, to run Unshake, please see Use of Unshake, Instructions.html.
First check the licence for the C version, LICENCE.txt. Download
the zip file as above, and unpack it. In it you will find a
"tarball" UnshakeC1.5r1.tar.gz. Unpack this, and read the file
"README".
You are welcome to put
Unshake on your own web site (so long as it is in a country which
respects copyright and patents granted in the European Union). Note
that the distribution includes a Linux distribution, which has its own
licence file.
- Download the zip file, and unpack it.
- Move the zip file into the resulting Unshake directory.
- Make the entire directory available on your site.
- Email me, so
that I can let you know if I ever update Unshake.
- This version of Unshake is dedicated to Frank di Marzio, who died
tragically and unexpectedly in the Summer of 2005.
- Unshake started out as "my first Java program", and sort of grew.
While I have now put some effort into making it easier to use, I
do not have a lot of free time, so please don't blame me if it isn't as easy
to use as some other programs.
- Long ago, Unshake grew out of Sun's examples of how to use Java,
in particular their "JAI File Browser", so
here is their disclaimer.
- Unshake uses a marvellous routine called a Cooley-Tukey Fast
Fourier Transform. Cooley and Tukey deserve a lot of thanks
for revolutionising scientific computing. The particular version
used here is based on one from E. Oran Brigham,
The Fast Fourier Transform, p164, found in Appendix 2 of
Morgan Pickering, "An Introduction to Fast Fourier Transform
Methods for Partial Differential Equations, with Applications",
Pub. Research Studies Press.
- Apart from the above, Unshake is "all my own work", it is
copyright and I have started patenting it. It is distributed free,
solely for personal use.
- For myself, I am prepared to trust that Unshake will not harm
my computer. But, just like Sun,
I take no responsibility for what it does on your particular computer,
or with your particular images. In jargon, I think
that translates as: Unshake is supplied "as is", without warranty of any
kind. I prefer it in plain English, myself.
- Please do not distribute Unshake in any form other than the one
in which I am supplying it.
- Please do not distribute Unshake in any country which does not
respect copyright and patents granted in Europe.
- Note that images produced by Unshake can be clearly identified.
Ummm, sometimes.
- Thanks to DJR and UA for very helpful comments - I hope this
release is an improvement for you.
- Have fun!
Unshake uses Sun's JPEG algorithms to save files. These are not
standard Java, so I have set the file-saving routine apart in a
special subclass, Unshakes. If there ever comes a time when these
algorithms are not available, it is possible to write your own class
to use a different algorithm. Here is a
template for such a class.
12/9/06. © M.D. Cahill 2000-2006.