Files
blis/examples/tapi
Field G. Van Zee bb6df2814f Defined a new level-1d operation: shiftd.
Details:
- Defined a new level-1d operation called 'shiftd', including object and
  typed APIs. This operation adds a scalar value to every element along
  an arbitrary diagonal of a matrix. Currently, shiftd is implemented in
  terms of the addv kernel. (The scalar is passed in as the x vector
  with an increment of zero.)
- Replaced ad-hoc usage of setd and addd (after creating a temporary
  matrix object) with use of shiftd, which is much more concise, in
  various test driver files in the testsuite. Similar changes were made
  to the standalone test drivers and the example code.
- Added documentation entries in BLISObjectAPI.md and BLISTypedAPI.md
  for bli_shiftd() and bli_?shiftd(), respectively.
- Added observed object properties to level-1d documentation in
  BLISObjectAPI.md.
2018-10-18 17:11:39 -05:00
..
2018-08-29 18:06:41 -05:00
2018-08-29 18:06:41 -05:00
2018-08-29 18:06:41 -05:00

BLIS typed API examples
-----------------------

This directory contains several files, each containing various pieces of
example code that demonstrate core functionality of the typed API in BLIS.
These example files should be thought of collectively like a tutorial, and
therefore it is recommended to start from the beginning (the file that
starts in '00').

You can build all of the examples by simply running 'make' from this
directory. (You can also run 'make clean'.) The makefile assumes that
you've already configured and built (but not necessarily installed) BLIS
two directories up, in "../..". If you have already installed BLIS to
some permanent directory, you may refer to that installation by setting
the environment variable BLIS_INSTALL_PATH prior to running make:

  export BLIS_INSTALL_PATH=/usr/local; make

or by setting the same variable as part of the make command:

  make BLIS_INSTALL_PATH=/usr/local

Once the executable files have been built, we recommend reading the code in
one terminal window alongside the executable output in another. This will
help you see the effects of each section of code.

This tutorial is not exhaustive or complete; many typed API functions
were omitted (mostly for brevity's sake) and thus more examples could be
written. If you've found typed functionality in BLIS and are unsure how to
use it, or if you are unsure of what additional functionality is present in
BLIS, please feel free to join and then start a discussion on the blis-devel
mailing list [1].

Thanks for your interest in BLIS!

[1] https://groups.google.com/d/forum/blis-devel