Difference between revisions of "Ubuntu Installation"

From GridPACK
Jump to: navigation, search
(Be more specific about the Ubuntu distribution)
 
(6 intermediate revisions by 2 users not shown)
Line 1: Line 1:
  
GridPACK is relatively easy to install on an [https://www.ubuntu.com/ Ubuntu Linux] system. Working packages for [https://www.gridpack.org/wiki/index.php/Software_Required_to_Build_GridPACK GridPACK prerequisites] are available from standard repositories. If you do not need to modify the GridPACK source, e.g. just use the GridPACK example applications or build your own application, you can install the binary package from the [https://launchpad.net/~wperkins/+archive/ubuntu/gridpack-ppa GridPACK PPA].  
+
GridPACK is relatively easy to install on an [https://www.ubuntu.com/ Ubuntu Linux] system. Working packages for most [https://www.gridpack.org/wiki/index.php/Software_Required_to_Build_GridPACK GridPACK prerequisites] are available from standard repositories. If you do not need to modify the GridPACK source, e.g. just use the GridPACK example applications or build your own application, you can install the binary package from the [https://launchpad.net/~wperkins/+archive/ubuntu/gridpack-ppa GridPACK PPA].  
  
'''''Currently, only 64-bit (AMD64) Ubuntu 16.04 is supported''''', which is a long term support (LTS) release which will be supported until 2021. If you are installing Ubuntu on a system or virtual machine, download the [http://releases.ubuntu.com/16.04 16.04 LTS ''Desktop'' AMD64 distribution] and follow the [https://tutorials.ubuntu.com/tutorial/tutorial-install-ubuntu-desktop#0 installation instructions].
+
GridPACK packages are available for the long term support (LTS) 64-bit (AMD64) Ubuntu series 16.04 (xenial) and 18.04 (bionic). If you are installing Ubuntu on a system or virtual machine, download the [http://releases.ubuntu.com/16.04 16.04] or [http://releases.ubuntu.com/18.04 18.04] LTS ''Desktop'' AMD64 distribution and follow the [https://tutorials.ubuntu.com/tutorial/tutorial-install-ubuntu-desktop#0 installation instructions].  GridPACK packages install a version of Global Arrays (GA) specifically for GridPACK use.  This will conflict with applications that depend on the Ubuntu GA packages, but this should be a rarity for GridPACK users.  
  
== GridPACK Installation on Ubuntu Linux 16.04 LTS ==
+
<span style="color:red">'''You will need super user or sudo privileges for this installation'''</span>.
 +
 
 +
== GridPACK Installation on Ubuntu Linux 16.04 or 18.04 LTS ==
  
 
Add the PPA to your system, and install GridPACK with
 
Add the PPA to your system, and install GridPACK with
Line 11: Line 13:
 
sudo apt-get update
 
sudo apt-get update
 
sudo apt-get install gridpack-dev</pre>
 
sudo apt-get install gridpack-dev</pre>
To use GridPACK, you will also need to install [https://cmake.org/ CMake]:
 
  
<pre>sudo apt-get install cmake</pre>
 
 
Make sure your installation works by building and running one of the several example applications, e.g. power flow:
 
Make sure your installation works by building and running one of the several example applications, e.g. power flow:
  
Line 20: Line 20:
 
cmake /usr/share/gridpack/example/powerflow
 
cmake /usr/share/gridpack/example/powerflow
 
make
 
make
mpiexec -np 4 ./powerflow.x</pre>
+
mpiexec -np 2 ./powerflow.x 118.xml</pre>
  
 
Also, you can run the installed powerflow application on this same input:
 
Also, you can run the installed powerflow application on this same input:
  
<pre>mpiexec -np 4 /usr/bin/pf.x</pre>
+
<pre>mpiexec -np 2 /usr/bin/pf.x 118.xml</pre>
 +
 
 +
Other GridPACK applications that can be found in <tt>/usr/bin</tt> are contingency analysis (<tt>ca.x</tt>), dynamic simulation (<tt>dsf.x</tt>), kalman filter (<tt>kds.x</tt>), and state estimation (<tt>stes.x</tt>). Additional example inputs for the GridPACK applications can be found under <tt>/usr/share/gridpack/example</tt>. The GridPACK libraries and include files are all found under <tt>/usr</tt>, so specify this directory as your GridPACK installation directory when compiling you own applications.
 +
 
 
GridPACK can be removed with
 
GridPACK can be removed with
  
 
<pre>sudo apt-get purge gridpack-dev
 
<pre>sudo apt-get purge gridpack-dev
 
sudo apt autoremove</pre>
 
sudo apt autoremove</pre>

Latest revision as of 13:54, 1 November 2019

GridPACK is relatively easy to install on an Ubuntu Linux system. Working packages for most GridPACK prerequisites are available from standard repositories. If you do not need to modify the GridPACK source, e.g. just use the GridPACK example applications or build your own application, you can install the binary package from the GridPACK PPA.

GridPACK packages are available for the long term support (LTS) 64-bit (AMD64) Ubuntu series 16.04 (xenial) and 18.04 (bionic). If you are installing Ubuntu on a system or virtual machine, download the 16.04 or 18.04 LTS Desktop AMD64 distribution and follow the installation instructions. GridPACK packages install a version of Global Arrays (GA) specifically for GridPACK use. This will conflict with applications that depend on the Ubuntu GA packages, but this should be a rarity for GridPACK users.

You will need super user or sudo privileges for this installation.

GridPACK Installation on Ubuntu Linux 16.04 or 18.04 LTS

Add the PPA to your system, and install GridPACK with

sudo add-apt-repository ppa:wperkins/gridpack-ppa
sudo apt-get update
sudo apt-get install gridpack-dev

Make sure your installation works by building and running one of the several example applications, e.g. power flow:

mkdir tmpbuild
cd tmpbuild
cmake /usr/share/gridpack/example/powerflow
make
mpiexec -np 2 ./powerflow.x 118.xml

Also, you can run the installed powerflow application on this same input:

mpiexec -np 2 /usr/bin/pf.x 118.xml

Other GridPACK applications that can be found in /usr/bin are contingency analysis (ca.x), dynamic simulation (dsf.x), kalman filter (kds.x), and state estimation (stes.x). Additional example inputs for the GridPACK applications can be found under /usr/share/gridpack/example. The GridPACK libraries and include files are all found under /usr, so specify this directory as your GridPACK installation directory when compiling you own applications.

GridPACK can be removed with

sudo apt-get purge gridpack-dev
sudo apt autoremove