Difference between revisions of "Asymptote: Macintosh"

m (Installing Asymptote on a Mac)
m (Usage: fixed line breaks in tex code)
(4 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 +
{| class="wikitable" style="border:1px solid black; background:#CEE0F2;text-align:center;"
 +
|-
 +
|style="background:#B0C4DE;"|'''[[Asymptote (Vector Graphics Language)]]'''
 +
|-
 +
|[[Asymptote: Getting Started|Getting Started]] - [[Asymptote: Basics|Basics]] - [[Asymptote: Reference|Reference]] - [[Asymptote: Useful commands and their Output|Examples]] - [[Asymptote: Macros and Packages|Macros and Packages]] - [[Asymptote: Advanced | Advanced Asymptote]] - [[Asymptote: Help|Help]]
 +
[[Asymptote: Useful functions|Useful functions]] - [[Asymptote: CSE5|CSE5 Package]]
 +
[[Category:Asymptote]]
 +
|}<noinclude>
 +
 
== Installing Asymptote on a Mac ==
 
== Installing Asymptote on a Mac ==
  
Line 4: Line 13:
  
  
Download the Asymptote source [http://sourceforge.net/project/showfiles.php?group_id=120000 here] (at the time of writing, it is version 1.43).
+
Download the Asymptote source [http://sourceforge.net/project/showfiles.php?group_id=120000 here] (at the time of writing, it is version 1.44).
  
Follow directions in the INSTALL file. The process is summarized here. "x.xx" represents the Asymptote version number (e.g., 1.43), and terminal commands are italicized.
+
Follow directions in the INSTALL file. The process is summarized here. "x.xx" represents the Asymptote version number (e.g., 1.44), and terminal commands are italicized.
  
 
# Open Terminal (located in /Applications/Utilities/Terminal.app)
 
# Open Terminal (located in /Applications/Utilities/Terminal.app)
 
# Run: ''cd ~/Desktop''
 
# Run: ''cd ~/Desktop''
# ''gunzip asymptote-x.xx.src.tgz''
+
# ''tar -xvzf asymptote-x.xx.src.tgz''
# ''tar -xf asymptote-x.xx.src.tar''
 
 
# ''cd asymptote-x.xx''
 
# ''cd asymptote-x.xx''
 
# ''curl -O <nowiki>http://www.hpl.hp.com/personal/Hans_Boehm/gc/gc_source/gc-7.1.tar.gz</nowiki>''
 
# ''curl -O <nowiki>http://www.hpl.hp.com/personal/Hans_Boehm/gc/gc_source/gc-7.1.tar.gz</nowiki>''
Line 19: Line 27:
  
 
You have finished installing Asymptote.
 
You have finished installing Asymptote.
 +
 +
Unfortunately, this does not work on Mac OS 10.6 "Snow Leopard", at least not as of 5 April 2011.  There are some suggestions for patches one can do to the source code at http://sourceforge.net/projects/asymptote/forums/forum/409349/topic/3387231 but these did not work completely.
  
 
== Usage ==
 
== Usage ==
Line 26: Line 36:
 
Here is a sample file:
 
Here is a sample file:
  
<code>
 
 
  \documentclass[letterpaper,12pt]{article}
 
  \documentclass[letterpaper,12pt]{article}
 
  \usepackage{amsmath}
 
  \usepackage{amsmath}
Line 37: Line 46:
 
     draw((0,0)--(1,1),blue);
 
     draw((0,0)--(1,1),blue);
 
  \end{asy}
 
  \end{asy}
  \end{document}</code>
+
  \end{document}
  
Use whatever LaTeX editor to compile the file. It'll return an error that looks something like this:
+
Use whatever LaTeX editor to compile the file. It will return a warning that looks something like this:
  
<code>
 
 
  Package asymptote Warning: file asyfile_1.pdf does not exist on input line 17.
 
  Package asymptote Warning: file asyfile_1.pdf does not exist on input line 17.
</code>
 
  
 
Terminal again.
 
Terminal again.
  
<code>
 
 
  cd ~/Desktop
 
  cd ~/Desktop
 
  asy asyfile
 
  asy asyfile
</code>
 
  
 
That will run asymptote on the file '''asyfile.asy,''' (created when the tex file was compiled) producing '''asyfile_1.pdf.'''
 
That will run asymptote on the file '''asyfile.asy,''' (created when the tex file was compiled) producing '''asyfile_1.pdf.'''
Line 60: Line 65:
  
 
[http://www.artofproblemsolving.com/Forum/viewtopic.php?p=1241236#1241236 This post] describes a shell script that automates the compilation process.
 
[http://www.artofproblemsolving.com/Forum/viewtopic.php?p=1241236#1241236 This post] describes a shell script that automates the compilation process.
 
== Troubleshooting ==
 

Revision as of 01:03, 13 October 2012

Asymptote (Vector Graphics Language)
Getting Started - Basics - Reference - Examples - Macros and Packages - Advanced Asymptote - Help

Useful functions - CSE5 Package

Installing Asymptote on a Mac

This tutorial was tested on Mac OS 10.5 "Leopard," but should work for most older systems.


Download the Asymptote source here (at the time of writing, it is version 1.44).

Follow directions in the INSTALL file. The process is summarized here. "x.xx" represents the Asymptote version number (e.g., 1.44), and terminal commands are italicized.

  1. Open Terminal (located in /Applications/Utilities/Terminal.app)
  2. Run: cd ~/Desktop
  3. tar -xvzf asymptote-x.xx.src.tgz
  4. cd asymptote-x.xx
  5. curl -O http://www.hpl.hp.com/personal/Hans_Boehm/gc/gc_source/gc-7.1.tar.gz
  6. ./configure
  7. make all
  8. sudo make install

You have finished installing Asymptote.

Unfortunately, this does not work on Mac OS 10.6 "Snow Leopard", at least not as of 5 April 2011. There are some suggestions for patches one can do to the source code at http://sourceforge.net/projects/asymptote/forums/forum/409349/topic/3387231 but these did not work completely.

Usage

Suppose that on the Desktop, you have a file named asyfile.tex

Here is a sample file:

\documentclass[letterpaper,12pt]{article}
\usepackage{amsmath}
\usepackage{amssymb}
\usepackage{asymptote}

\begin{document}
\begin{asy}
    size(300);
    draw((0,0)--(1,1),blue);
\end{asy}
\end{document}

Use whatever LaTeX editor to compile the file. It will return a warning that looks something like this:

Package asymptote Warning: file asyfile_1.pdf does not exist on input line 17.

Terminal again.

cd ~/Desktop
asy asyfile

That will run asymptote on the file asyfile.asy, (created when the tex file was compiled) producing asyfile_1.pdf.

Now run latex on asyfile.tex again, and with any luck, it should compile with no errors. (The image produces a diagonal blue line.)


Automation

This post describes a shell script that automates the compilation process.