Commit Graph

43 Commits

Author SHA1 Message Date
Field G. Van Zee
d1aa87164e README.md update (External packages section).
Details:
- Updated External packages section in anticipation of introducing BLIS
  into Debian package universe. Thanks to M. Zhou for sponsoring BLIS in
  Debian.
2018-12-18 14:52:40 -06:00
Field G. Van Zee
5fec95b99f Implemented mixed-datatype support for gemm.
Details:
- Implemented support for gemm where A, B, and C may have different
  storage datatypes, as well as a computational precision (and implied
  computation domain) that may be different from the storage precision
  of either A or B. This results in 128 different combinations, all
  which are implemented within this commit. (For now, the mixed-datatype
  functionality is only supported via the object API.) If desired, the
  mixed-datatype support may be disabled at configure-time.
- Added a memory-intensive optimization to certain mixed-datatype cases
  that requires a single m-by-n matrix be allocated (temporarily) per
  call to gemm. This optimization aims to avoid the overhead involved in
  repeatedly updating C with general stride, or updating C after a
  typecast from the computation precision. This memory optimization may
  be disabled at configure-time (provided that the mixed-datatype
  support is enabled in the first place).
- Added support for testing mixed-datatype combinations to testsuite.
  The user may test gemm with mixed domains, precisions, both, or
  neither.
- Added a standalone test driver directory for building and running
  mixed-datatype performance experiments.
- Defined a new variation of castm, castnzm, which operates like castm
  except that imaginary values are not touched when casting a real
  operand to a complex operand. (By contrast, in these situations castm
  sets the imaginary components of the destination matrix to zero.)
- Defined bli_obj_imag_is_zero() and substituted calls in lieu of all
  usages of bli_obj_imag_equals() that tested against BLIS_ZERO, and
  also simplified the implementation of bli_obj_imag_equals().
- Fixed bad behavior from bli_obj_is_real() and bli_obj_is_complex()
  when given BLIS_CONSTANT objects.
- Disabled dt_on_output field in auxinfo_t structure as well as all
  accessor functions. Also commented out all usage of accessor
  functions within macrokernels. (Typecasting in the microkernel is
  still feasible, though probably unrealistic for now given the
  additional complexity required.)
- Use void function pointer type (instead of void*) for storing function
  pointers in bli_l0_fpa.c.
- Added documentation for using gemm with mixed datatypes in
  docs/MixedDatatypes.md and example code in examples/oapi/11gemm_md.c.
- Defined level-1d operation xpbyd and level-1m operation xpbym.
- Added xpbym test module to testsuite.
- Updated frame/include/bli_x86_asm_macros.h with additional macros
  (courtsey of Devin Matthews).
2018-10-15 16:37:39 -05:00
Field G. Van Zee
de07840ba5 Whitespace, https updates to README.md.
Details:
- Reformatted to fit all lines within 80 columns, unless a link is too
  long to fit on a single line.
- Changed some links from http to https.
2018-10-03 13:57:25 -05:00
Field G. Van Zee
0c3cd00ba7 More README.md updates.
Details:
- Replaced much of "Getting Started" section with a shortened version of
  the bullet list of documentation currently shown in the github wiki
  page. Thanks to Devangi Parikh for her feedback in this change.
2018-10-01 16:18:25 -05:00
Field G. Van Zee
8eaf34bd23 Very minor README.md update. 2018-10-01 14:29:07 -05:00
Field G. Van Zee
599090e0eb README.md update.
Details:
- Added language mentioning SHPC group to Introduction.
2018-10-01 14:04:30 -05:00
Field G. Van Zee
c03728f1f4 Various minor cleanups.
Details:
- Rewrote bli_winsys.c to define bli_setenv() and bli_sleep()
  unconditionally, but differently for Windows and non-Windows, but
  then disabled the definition of bli_setenv() entirely since BLIS
  no longer needs to set environment variables. Updated bli_winsys.h
  accordingly, and call bli_sleep() from within testsuite instead of
  sleep() directly.
- Use
    #if !defined(_POSIX_BARRIERS) || (_POSIX_BARRIERS != 200809L)
  instead of
    #if !defined(_POSIX_BARRIERS) || (_POSIX_BARRIERS < 0)
  when guarding against local definition of pthread barrier in
  testsuite. (The description for unistd.h implies that _POSIX_BARRIERS
  should always be set to 200809L when barriers are supported, though I
  won't be surprised if we encounter a case in the future where it is
  set to something else such as 1 while still supported.)
- Removed old _VERS_CONF_INST definitions and installation rules in
  top-level Makefile. These are no longer needed because we no longer
  output libraries with the version and configuration name as
  substrings.
- Comment/whitespace updates in Makefile, config.mk.in, common.mk,
  configure, bli_extern_defs.h, and test_libblis.h.
- Added mention of 1m to README.md and other trivial tweaks.
2018-09-10 17:54:27 -05:00
Field G. Van Zee
e358d5e497 README.md update (Funding section). 2018-08-16 12:18:45 -05:00
Field G. Van Zee
4f60d0288e README.md, comment updates.
Details:
- Added links, and sandbox language to README.md.
- Adjusted some comments in high-level level-3 object functions to make
  clear what bli_thread_init_rntm() does.
2018-07-30 19:22:57 -05:00
Field G. Van Zee
922a1c05e0 More tweaks to README.md. 2018-07-28 20:15:55 -05:00
Field G. Van Zee
5438375a03 Fixed link in README.md. 2018-07-28 16:34:21 -05:00
Field G. Van Zee
89c8806e3a Minor doc fixes to previous commit. 2018-07-28 16:30:56 -05:00
Field G. Van Zee
b8c7574f84 README.md, typed/object API updates.
Details:
- Updated the typed and object APIs to include language on the rntm_t
  parameters in the expert interfaces.
- Updated README to include link to object API.
2018-07-28 16:27:09 -05:00
Field G. Van Zee
e78e71d549 Added README.md mention/link to examples/tapi.
Details:
- Added language to README.md to bring the reader's attention to the
  example code for the typed API (in addition to those for the object
  API).
2018-07-07 20:18:09 -05:00
Field G. Van Zee
419ffb1585 Updates to README.md.
Details:
- Updated wiki links according to renamed/relocated files in 'docs'.
- Converted links to relative paths.
- Added link to docs/Multithreading.md.
2018-07-07 20:14:23 -05:00
Field G. Van Zee
7d3e8a7e5f Reverted docs/*.md links to relative paths.
Details:
- Within the documents in docs/*.md, reverted links to other local
  documents to relative paths.
- Fixed some links/documents that did not yet have the '.md' suffix.
- Testing whether we can use relative links ('docs/BLISTypedAPI.md')
  from within README.md.
2018-07-07 20:01:29 -05:00
Field G. Van Zee
4919b10c00 Minor changes to README.md and CONTRIBUTING.md. 2018-05-17 16:38:49 -05:00
Field G. Van Zee
b89451187e README.md update.
Details:
- Added "Contributing" section with relevant links.
2018-05-17 16:23:06 -05:00
Nico Schlömer
6e25e758b4 Debian config (#206)
* add debian config

* correct wording in the README
2018-05-15 07:03:20 -05:00
Field G. Van Zee
8a2857b5e3 Fixed README.md typo; mention 'make check'. 2018-05-11 18:42:05 -05:00
Field G. Van Zee
543935c02f Updated README.md with Ubuntu packages link.
Details:
- Created a separate section of README.md for external packages, with
  one bullet each for Dave Love's rpms and Nico Schlömer's Ubuntu apt
  packages. Thanks to Dave and Nico for their contributions.
2018-05-11 18:35:32 -05:00
Field G. Van Zee
8eda5fe7f6 Typo fix in README.md. 2018-05-02 12:20:37 -05:00
Field G. Van Zee
5e515f9a76 Tweaked new language in README.md. 2018-05-01 13:44:10 -05:00
Field G. Van Zee
1ddd9e316a Added link to Dave Love's Fedora Copr page.
Details:
- Added a blurb to README.md advertising Dave Love's Copr homepage,
  which contains rpm packages for RHEL/Fedora-like distributions.
2018-05-01 13:36:28 -05:00
Field G. Van Zee
5e5ca4984f README updates.
Details:
- Updates to the top-level README files in the top-level directory as
  well as the 'examples/oapi' directory.
2018-04-28 13:48:01 -05:00
Field G. Van Zee
d6ab25a323 Add setijm, getijm operations.
Details:
- Added bli_setgetijm.c, which defines bli_setijm(), bli_getijm(), and
  related functions that can be used to read and write individual
  elements of an obj_t.
- Defined a new function, bli_obj_create_conf_to(), in bli_obj.c that will
  create a new object with dimensions conformal to an existing object.
  Transposition and conjugation states on the existing object are ignored,
  as are structure and uplo fields.
- Defined a new function, bli_datatype_string(), in bli_obj.c that returns
  a char* to a string representation of the name of each num_t datatype.
  For example, BLIS_DOUBLE is "double" and BLIS_DCOMPLEX is "dcomplex".
  BLIS_INT is included (as "int"), but BLIS_CONSTANT is not, and thus is
  not a valid input argument to bli_datatype_string().
- Added calls to bli_init_once() to various functions in bli_obj.c, the
  most important of which was bli_obj_create_without_buffer().
- Removed unintended/extra newline from the end of printv output.
- Whitespace changes to
  - frame/base/bli_machval.c
  - frame/base/bli_machval.h
  - frame/0/copysc/bli_copysc.c
- Trivial changes to README.md and common.mk.
2018-04-24 18:43:03 -05:00
Field G. Van Zee
a731a428f7 Another README.md update. 2018-04-17 16:44:55 -05:00
Field G. Van Zee
c734ee928a README.md update. 2018-04-17 16:40:05 -05:00
Field G. Van Zee
c441caa95a README update.
Details:
- Minor updates to README.md.
- Minor change to blastest/Makefile.
2018-03-20 17:56:02 -05:00
Field G. Van Zee
8e917b256c Updated bibtex info for BLIS5 (3m4m) article. 2017-09-09 14:10:15 -05:00
Devin Matthews
cf54c77bc7 Add new SSI acknowledgment 2017-06-06 20:23:17 -05:00
Field G. Van Zee
43007f7b65 Fixed stray parentheses in README citations. 2017-05-02 16:48:43 -05:00
Field G. Van Zee
ca3a792477 README.md update.
Details:
- Updated bibtex entries for 4th BLIS paper, and adds entries for 5th
  and 6th BLIS papers.
2017-05-02 12:09:39 -05:00
Shaden Smith
e1453f68f6 Fixes broken URL in README.md 2016-09-16 09:29:28 -05:00
Field G. Van Zee
abd61f9fa7 Updated BLIS4 TOMS citation in README.md. 2016-08-30 12:34:19 -05:00
Field G. Van Zee
413d62aca2 README update (use official ACM TOMS links). 2016-07-12 15:02:52 -05:00
Field G. Van Zee
dfa431f696 README update (BLIS2 TOMS article now in-print). 2016-07-12 14:21:19 -05:00
Jeff Hammond
33557eccca add Travis CI build status icon to the README 2015-11-02 12:18:43 -08:00
Field G. Van Zee
276da36618 Minor formatting change to README.md. 2015-10-12 11:43:03 -05:00
Field G. Van Zee
d17057446f Added "Getting Started" section to README.md.
Details:
- Added section to README.md file containing links to wikis with brief
  descriptions.
2015-10-12 11:39:49 -05:00
Field G. Van Zee
e7e1f2f7b6 Minor updates to CREDITS, README files. 2015-10-02 16:51:52 -05:00
Field G. Van Zee
55329906ec Minor edits to README.md, testsuite.
Details:
- Fixed typos in README.md.
- Fixed column heading alignment for testsuite when matlab output is
  enabled.
- Minor updates to test/3m4m/runme.sh and test/3m4m/Makefile.
2015-09-26 20:47:19 -05:00
Field G. Van Zee
bbebdb5793 Replaced README with README.md.
Details:
- Replaced the old (and short) README file with a much more comprehensive
  version written in github-flavored markdown. The new file is based on
  content taken from the old Google Code homepage.
2015-09-25 14:47:27 -05:00