View source for Asymptote: Getting Started/Windows/Downloads and Installation

{{Asymptote}}

:'''''NOTE''': The following instructions assume that you are using a Windows machine.  Instructions for MAC and Unix users can be found under Documentation <math>\rightarrow</math> Installation [http://asymptote.sourceforge.net/ here].''

To begin using Asymptote, you must first download and install it.  To view the eps-format images you produce, you will also need to download an eps viewer such as GSview.  (GSview is convenient because it can display both eps and pdf files, and with GhostScript installed, Asymptote can easily output the images in pdf format as well.)

== Asymptote ==
To download and install Asymptote on your Windows machine:

#Go to [http://asymptote.sourceforge.net SourceForge] and click on the Download link on the left.  This will bring you to a page that has the latest file release in a box, with a green button marked "Download" on the right side of this box.  Follow this link.
# You will now see a box with four files, only one of which ends in <tt>.exe</tt> (it should look something like <tt>asymptote-1.41-setup.exe</tt>, depending on the number of the latest release.)  Click on this link, and a download window will pop up in your browser.  Choose to save the file, and take note of where on your hard drive you saved it to.  Let's say you saved it to the folder <tt>D:\downloads\Asymptote</tt>.
#When the download is complete, browse to <tt>D:\downloads\Asymptote</tt>, or wherever you saved the file, and double-click on the <tt>.exe</tt> file (<tt>asymptote-1.41-setup.exe</tt>).  This will open an installer window, where you can choose the folder that Asymptote will be installed to (or simply use the default <tt>C:\Program Files\Asymptote</tt>), and choose whether you wish to have shortcuts added to the desktop and start menu.  When you have finished, click Install.

Asymptote is ready to start producing images, but you still need a way to view these images.  (NOTE: if you already have a previewer capable of viewing .eps and .pdf files, you do not need to download the file below.)

== GSview ==
GSview is a standard viewer for .eps files, which is the standard output format for Asymptote images.  To download and install GSview,
# Go to [http://www.cs.wisc.edu/~ghost/gsview/get48.htm this download site], and click on <tt>gsv48w32.exe</tt>.  A download window will pop up in your browser.  Choose to save the file, and take note of where on your hard drive you saved it to.  Let's say you saved it to the folder <tt>D:\downloads\Ghostscript</tt>. (If you are unable to get the file <tt>gsv48w32.exe</tt> from this site, try [ftp://ftp.mirror.ac.uk/sites/mirror.cs.wisc.edu/pub/mirrors/ghost/ghostgum/ this site] instead.)
# When the download is complete, browse to <tt>D:\downloads\Ghostscript</tt> in your files and double-click on the .exe file gsv48w32.exe.  This will bring you to an installation window.  Click Setup.
# After it extracts the necessary files, there will be a new installation window.  Click Next twice, and there will be two checkboxes, which can set GSview to be the default eps or pdf previewer.  If you wish to use the more common Acrobat Reader, or some other pdf reader, to view pdf files, only leave the first box checked.  However, you can check both if desired.
# Click Next, and choose the directory in which you want GSview installed (or leave the default setting, <tt>C:\Program Files\Ghostgum</tt>). 
# Click Next twice, and choose the Start Menu folder to which a shortcut will be added.  (The default is Ghostgum.)
# Click Finish, and GSview will be installed.

== Ghostscript ==
Ghostscript may also need to be installed on your system.  You may download it [http://pages.cs.wisc.edu/~ghost here] by clicking on the first link down, GPL Ghostscript. Then, click on the first link down, and copy the file to your computer. After that, run it to install Ghostscript. You may then need to set the version of Ghostscript in GSview.  Do this by choosing the <tt>Easy Configure</tt> option in the <tt>Options</tt> menu in GSview.

You now have installed everything you need to use Asymptote on the most basic level, as described in the next section.

:[[Asymptote: Getting Started/Windows/Interactive Mode| Next: Interactive Mode]]