AquaTerm is a Mac OS X grahics renderer. It allows command line applications written in ObjC, C, FORTRAN, Lisp, Perl or Python to display vector graphics, text and images using a simple API. Adapters for gnuplot, PGPLOT, and PLplot exists as well. May 06, 2015.
The #k@ project is compatible with both Mac OS X and Linux. We will go over the steps to install #k@ for each particular operating system.
Required programs:
- Python 2.7. At present Python 3 is not supported.
- for Mac OS X, an installer such as Homebrew
Recommended programs:
- Gephi. Our documentation is in Gephi 0.8.
Mac OS X
The following outlines the installation of #k@ on Mac OS X:
Download the latest build of #k@ at hashkat.org by clicking on 'Latest Build'.
Enter a terminal (which can be accessed by searching for 'terminal' in your system) and go into your Downloads directory/folder by typing in the following command and pressing return:
cd Downloads/To see the list of files in your Downloads directory, type into the command line:
lsAmongst your various other downloads you should see the following:
hashkat.2015.08.20.tarPlease note that the date in the file you downloaded may be different from the one above. That's totally fine, it just means that you've downloaded a newer version of #k@.
To unpack this tar file, type in the command:
tar -xf hashkat.2015.08.20.tarOnce this is completed, look into the list of files in this directory and you will see amongst them:
hashkatFor ease of access, move this directory into your 'home' directory by typing in the command:
mv ~/Downloads/hashkat ~/Now return to your 'home' directory by typing in the command:
Let's now go into the hashkat directory by typing in the command:
cd hashkat/Once in this directory, you can see the list of all the files and directories that compose the #k@ project by again typing in the command:
lsYou will need to install the CMake package on to your computer to build #k@. You can install this package to your computer using Homebrew. To install Homebrew to your computer, simply type in the command:
ruby -e '$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)'A prompt may appear asking you if you'd like to install the 'command line developer tools'. Click 'Install' and agree to the licensing agreement to install these tools. Once these tools have been installed, you can continue installing Homebrew by pressing return.
With Homebrew installed, you an install the CMake package by typing in the command:
brew install cmakeYou must now do a build of #k@ on your computer. You may be in the Cmake directory. You will need to go to the hashkat directory by typing in the commands:
cdcd hashkat./build.sh -Obuild.sh is followed by 'capital oh'. The 'O' stands for 'optimized build' and is optional.
You can now run #k@ in this hashkat directory by typing the command:
./run.shIn hashkat you need to remove (or move) the network_state and output files between simulations or an error will be thrown.
You may remove the files by typing the following commands:
To move the data instead:
Gnuplot is the primary graphing utility used in this documentation. To install Gnuplot, type in the command:
brew install gnuplot -x11gnuplot is followed by 'ex one one'
It is also recommended to download and install Gephi from their website to use for visualizations of collected data. For simulations with max_agents <= 10000, #k@ automatically produces files with a .gexf suffix, suitable for Gephi visualization. Our tutorials are illustrated with Gephi 0.8.

Linux

The following steps outline how to install #k@ on Linux (these instructions assume you are using a Debian-based distribution such as Ubuntu, Linux Mint, or Debian):
Download the latest build of #k@ at hashkat.org by clicking on 'Latest Build' and then clicking 'Save File' and then 'OK' on the prompt that appears.
Enter a terminal (which can be accessed by searching for 'terminal' in your system) and go into your Downloads directory/folder by typing in the following command and pressing Enter:
cd DownloadsTo see the list of files in your Downloads directory, type into the command line:
lsAmongst your various other downloads you should see the following:
hashkat.2015.08.20.tar.gzPlease note that the date in the file you downloaded may be different from the one above. That's totally fine, it just means that you've downloaded a newer version of #k@!
To unpack this tar file, type in the command:
tar -xzvf hashkat.2015.08.20.tar.gz
This command creates a hashkat directory within the Downloads directory.
Once this is completed, list the files in the Downloads directory and you will see amongst them:
hashkatFor ease of access, move this directory into your 'home' directory ('mv old_location new_location') by typing in the command:
mv ~/Downloads/hashkat ~/To return to your 'home' directory type in the command:
cd ~Now navigate to the directory where you have stored the Cmake tar file.
To install the CMake package, type the following commands:
tar -xzvf cmake.version.tar.gzsudo apt-get install cmakesudo apt-get install build-essential -yIf asked for sudo permission, enter your Linux password.
You must now do a build of #k@ on your computer. You need to change back to the hashkat directory first:
cd ~cd hashkat./build.sh -Obuild.sh is followed by 'capital oh'. The 'O' stands for 'optimized build' and is optional.
You can now run hashkat by typing in the command:
./run.shIn hashkat you need to move or remove the network_state and output files between simulations or an error will be thrown.
You may remove the files created from the simulation by typing the following commands:
To move the files:
Gnuplot is the primary graphing utility used in this documentation. To install Gnuplot, from the terminal type in the command:
sudo apt-get install gnuplot-x11gnuplot is followed by 'dash ex one one' with no space.
With Gnuplot installed, to access it, simply type:
plotat the beginning of the line in the console. You should be in the same directory as the data files you want to access.
It is also recommended to download and install Gephi from their website to use for visualizations of collected data. For simulations with max_agents <= 10000, #k@ automatically produces files with a .gexf suffix, suitable for Gephi visualization. Our tutorials are illustrated with Gephi 0.8. If max_agents <= 10000#k@ automatically produces files with a .gexf suffix, suitable for visualization with Gephi.
Supplementary Tools
This is not necessary for the running of #k@, but you can use the C++ compiler Clang if you're having issues with the 'g++' compiler by doing the following:
Gnuplot Mac Os
For Mac OS X, input the command:
brew install clangFor Linux, input the command:
sudo apt-get install clangAdd the following to your .bashrc file (for both Mac OS X and Linux):
export CC=clangexport CXX=clang++
You can now use Clang as a C++ compiler when using #k@.
Check compatibility
You can upgrade to OS X El Capitan from OS X Snow Leopard or later on any of the following Mac models. Your Mac also needs at least 2GB of memory and 8.8GB of available storage space.
MacBook introduced in 2009 or later, plus MacBook (13-inch, Aluminum, Late 2008)
MacBook Air introduced in late 2008 or later
MacBook Pro introduced in mid 2007 or later
Mac mini introduced in early 2009 or later
iMac introduced in mid 2007 or later
Mac Pro introduced in early 2008 or later
Xserve models introduced in early 2009
Gnuplot Download For Windows 10
To find your Mac model, memory, storage space, and macOS version, choose About This Mac from the Apple menu . If your Mac isn't compatible with OS X El Capitan, the installer will let you know.
Make a backup
Before installing any upgrade, it’s a good idea to back up your Mac. Time Machine makes it simple, and other backup methods are also available. Learn how to back up your Mac.
Get connected
It takes time to download and install OS X, so make sure that you have a reliable Internet connection. If you're using a Mac notebook computer, plug it into AC power.
Download OS X El Capitan
For the strongest security and latest features, find out whether you can upgrade to macOS Catalina, the latest version of macOS.
Install Gnuplot Windows 10
If you still need OS X El Capitan, use this link: Download OS X El Capitan. A file named InstallMacOSX.dmg will download to your Mac.
Install the macOS installer
Double-click the downloaded file to open a window showing its contents. Then double-click the file within, named InstallMacOSX.pkg.
Gnuplot Tutorial
Follow the onscreen instructions, which will guide you through the steps necessary to install.
Begin installation
After installation of the installer is complete, open the Applications folder on your Mac, then double-click the file named Install OS X El Capitan.
Click Continue and follow the onscreen instructions. You might find it easiest to begin installation in the evening so that it can complete overnight, if needed.
Allow installation to complete
Please allow installation to complete without putting your Mac to sleep or closing its lid. Your Mac might restart, show a progress bar, or show a blank screen several times as it installs both OS X and related updates to your Mac firmware.
Learn more
- OS X El Capitan won't install on top of a later version of macOS, but you can erase your disk first or install on another disk.
- You can use macOS Recovery to reinstall macOS.