VAPP is a MATLAB/Octave tool that translates Verilog-A device models into ModSpec. It is a subproject of the Berkeley Model and Algorithm Prototyping Platform (MAPP).
VAPP requires MATLAB R2012a or later.
There is an Octave compatible version of VAPP which is maintained in a separate branch in this repository. For more information see the Octave Compatibility section below.
After cloning this repository to your machine and changing into the VAPP directory, there are two options to start using this source release.
###1 - On a Unix system
Run the following commands in a terminal
autoconf
./configure
make
This will create a new directory which will include softlinks to VAPP source files.
It will also create a script start_VAPP.m
that will add the VAPP directory structure to your MATLAB path.
This script has to be run each time you start MATLAB. There are two ways you can do this.
####Option 1 Add the VAPP directory permanently to your MATLAB path by including
addpath('/path/to/your/vapp_repo/');
in your startup.m
file.
This file is most likely located in ~/Documents/MATLAB
.
Don't forget to change /path/to/your/vapp_repo
to the actual path on your machine.
Now, each time you start MATLAB, you can run
start_VAPP
and VAPP paths will be setup for the rest of your MATLAB session.
Alternatively, you can add
run('/path/to/your/vapp_repo/start_VAPP');
to your startup.m
and let MATLAB add VAPP directories to its path every time a new session is started.
####Option 2 Each time you start a MATLAB session, run the following commands at a MATLAB prompt
cd /path/to/your/vapp_repo/
start_VAPP
###2 - On a non-Unix system
VAPP includes a start_VAPP_portable.m
file to be used on a platform where the GNU build system is not available.
This script will setup VAPP paths relative to the directory from where it is being run.
To use this script run the following commands at a MATLAB prompt each time you start a new session.
cd /path/to/your/vapp_repo/
start_VAPP_portable
VAPP has a simple user interface command: va2modspec
which takes a Verilog-A file as input and prints out the corresponding ModSpec file.
Basic usage of this command is simply
va2modspec('veriloga_file_name.va')
For further information, run help va2modspec
in MATLAB.
For a quick introduction and a complete example use case run help VAPPquickstart
.
For an introduction to VAPP try the following help documents.
help va2modspec
help VAPPquickstart
help VAPPexamples
VAPP comes with extensive examples. These examples are located in the examples directory. Each example consists of a different model and a MAPP script to perform an analysis using that model. The following models are available within the examples.
We maintain a separate Octave compatible branch in the VAPP repo.
To obtain the Octave compatible version of VAPP, please choose one of the options below.
-
Option 1: Use git
Clone this repository and change into the cloned directory.
git clone https://github.com/jaijeet/VAPP.git cd VAPP
Checkout the
2017-02-27-release-github-Octave_compatible
branch.git checkout 2017-02-27-release-github-Octave_compatible
-
Option 2: Download a snapshot zip file
Download a snapshot of the Octave compatible VAPP using the link below.