{"action":"created","comment":{"url":"https://api.github.com/repos/gonum/blas/pulls/comments/24179488","id":24179488,"diff_hunk":"@@ -0,0 +1,80 @@\n+/*\n+Package native is a Go implementation of the BLAS API. This implementation\n+panics when the input arguments are invalid as per the standard, for example\n+if a vector increment is zero. Please note that the treatment of NaN values\n+is not specified, and differs among the BLAS implementations.\n+github.com/gonum/blas/blas64 provides helpful wrapper functions to the BLAS\n+interface. The rest of this text describes the layout of the data for the input types.\n+Please note that in the function documentation, x[i] refers to the i^th element\n+of the vector, which will be different from the i^th element of the slice if\n+incX != 1.\n+\n+See http://www.netlib.org/lapack/explore-html/d4/de1/_l_i_c_e_n_s_e_source.html\n+for more license information.\n+\n+Vector arguments are effectively strided slices. They have two input arguments,\n+a number of elements, n, and an increment, incX. The increment specifies the\n+distance between elements of the vector. The actual go slice may be longer\n+than necessary.\n+The increment may be positive or negative, except in functions with only\n+a single vector argument where the increment may only be positive. If the increment\n+is negative, s[0] is the last element in the slice. Note that this is not the same\n+as counting backward from the end of the slice, as len(s) may be longer than\n+necessary. So, for example, if n = 5 and incX = 3, the elements of s are\n+\t[0 * * 1 * * 2 * * 3 * * 4 * * * ...]\n+where * elements are never accessed. If incX = -3, the same elements are\n+accessed, just in reverse order (4, 3, 2, 1, 0).\n+\n+Dense matrices are specified by a number of rows, a number of columns, and a stride.\n+The stride specifies the number of entries in the slice between the first element\n+of successive rows. The stride must be at least as large as the number of columns\n+but may be longer.\n+[a00 ... a0n a0* ... a1stride-1 a21 ... amn am* ... amstride-1]\n+Thus, dense[i*ld + j] refers to the {i, j}th element of the matrix.\n+\n+Symmetric and triangular matrices (non-packed) are stored identically to Dense,\n+except only elements in one triangle of the matrix are accessed.\n+\n+Packed symmetric and packed triangular matrices are laid out with the entries\n+condensed such that all of the zeros are removed. So, the upper triangular\n+matrix\n+[\n+  1  2  3\n+  0  4  5\n+  0  0  6\n+]\n+and the lower-triangular matrix\n+[\n+  1  0  0\n+  2  3  0\n+  4  5  6\n+]\n+will both be compacted as [1 2 3 4 5 6]. The (i, j) element of the original\n+dense matrix can be found at element i*n - (i-1)*i/2 + j for upper triangular,\n+and at element i * (i+1) /2 + j for lower triangular.\n+\n+Banded matrices are laid out in a compact format, constructed by removing the\n+zeros in the rows and aligning the diagonals. For example, the matrix\n+[\n+  1  2   3  0  0  0\n+  4  5   6  7  0  0\n+  0  8   9 10 11  0\n+  0  0  12 13 14 15\n+  0  0   0 16 17 18\n+  0  0   0  0 19 20\n+]\n+\n+implicitly becomes (* entries are never accessed)\n+[\n+   *  1  2  3\n+   4  5  6  7\n+   8  9 10 11\n+  12 13 14 15\n+  16 17 18  *\n+  19 20  *  *\n+]\n+which is given to the BLAS routine is [* 1 2 3 4 ...].\n+See http://www.crest.iu.edu/research/mtl/reference/html/banded.html","path":"native/doc.go","position":77,"original_position":77,"commit_id":"ce96b9f59350d812ef6422f96a381809a6919ba1","original_commit_id":"ce96b9f59350d812ef6422f96a381809a6919ba1","user":{"login":"btracey","id":3680859,"avatar_url":"https://avatars.githubusercontent.com/u/3680859?v=3","gravatar_id":"","url":"https://api.github.com/users/btracey","html_url":"https://github.com/btracey","followers_url":"https://api.github.com/users/btracey/followers","following_url":"https://api.github.com/users/btracey/following{/other_user}","gists_url":"https://api.github.com/users/btracey/gists{/gist_id}","starred_url":"https://api.github.com/users/btracey/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/btracey/subscriptions","organizations_url":"https://api.github.com/users/btracey/orgs","repos_url":"https://api.github.com/users/btracey/repos","events_url":"https://api.github.com/users/btracey/events{/privacy}","received_events_url":"https://api.github.com/users/btracey/received_events","type":"User","site_admin":false},"body":"Done.","created_at":"2015-02-05T17:13:36Z","updated_at":"2015-02-05T17:13:36Z","html_url":"https://github.com/gonum/blas/pull/107#discussion_r24179488","pull_request_url":"https://api.github.com/repos/gonum/blas/pulls/107","_links":{"self":{"href":"https://api.github.com/repos/gonum/blas/pulls/comments/24179488"},"html":{"href":"https://github.com/gonum/blas/pull/107#discussion_r24179488"},"pull_request":{"href":"https://api.github.com/repos/gonum/blas/pulls/107"}}},"pull_request":{"url":"https://api.github.com/repos/gonum/blas/pulls/107","id":28706033,"html_url":"https://github.com/gonum/blas/pull/107","diff_url":"https://github.com/gonum/blas/pull/107.diff","patch_url":"https://github.com/gonum/blas/pull/107.patch","issue_url":"https://api.github.com/repos/gonum/blas/issues/107","number":107,"state":"open","locked":false,"title":"Updated comments for all the functions and added a doc comment to the pa...","user":{"login":"btracey","id":3680859,"avatar_url":"https://avatars.githubusercontent.com/u/3680859?v=3","gravatar_id":"","url":"https://api.github.com/users/btracey","html_url":"https://github.com/btracey","followers_url":"https://api.github.com/users/btracey/followers","following_url":"https://api.github.com/users/btracey/following{/other_user}","gists_url":"https://api.github.com/users/btracey/gists{/gist_id}","starred_url":"https://api.github.com/users/btracey/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/btracey/subscriptions","organizations_url":"https://api.github.com/users/btracey/orgs","repos_url":"https://api.github.com/users/btracey/repos","events_url":"https://api.github.com/users/btracey/events{/privacy}","received_events_url":"https://api.github.com/users/btracey/received_events","type":"User","site_admin":false},"body":"...ckage","created_at":"2015-02-05T08:14:12Z","updated_at":"2015-02-05T17:13:36Z","closed_at":null,"merged_at":null,"merge_commit_sha":"0aaeda2f22f224391177fd2985035491c26ea6e9","assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/gonum/blas/pulls/107/commits","review_comments_url":"https://api.github.com/repos/gonum/blas/pulls/107/comments","review_comment_url":"https://api.github.com/repos/gonum/blas/pulls/comments/{number}","comments_url":"https://api.github.com/repos/gonum/blas/issues/107/comments","statuses_url":"https://api.github.com/repos/gonum/blas/statuses/ce96b9f59350d812ef6422f96a381809a6919ba1","head":{"label":"gonum:fixdocs","ref":"fixdocs","sha":"ce96b9f59350d812ef6422f96a381809a6919ba1","user":{"login":"gonum","id":3771091,"avatar_url":"https://avatars.githubusercontent.com/u/3771091?v=3","gravatar_id":"","url":"https://api.github.com/users/gonum","html_url":"https://github.com/gonum","followers_url":"https://api.github.com/users/gonum/followers","following_url":"https://api.github.com/users/gonum/following{/other_user}","gists_url":"https://api.github.com/users/gonum/gists{/gist_id}","starred_url":"https://api.github.com/users/gonum/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/gonum/subscriptions","organizations_url":"https://api.github.com/users/gonum/orgs","repos_url":"https://api.github.com/users/gonum/repos","events_url":"https://api.github.com/users/gonum/events{/privacy}","received_events_url":"https://api.github.com/users/gonum/received_events","type":"Organization","site_admin":false},"repo":{"id":9615328,"name":"blas","full_name":"gonum/blas","owner":{"login":"gonum","id":3771091,"avatar_url":"https://avatars.githubusercontent.com/u/3771091?v=3","gravatar_id":"","url":"https://api.github.com/users/gonum","html_url":"https://github.com/gonum","followers_url":"https://api.github.com/users/gonum/followers","following_url":"https://api.github.com/users/gonum/following{/other_user}","gists_url":"https://api.github.com/users/gonum/gists{/gist_id}","starred_url":"https://api.github.com/users/gonum/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/gonum/subscriptions","organizations_url":"https://api.github.com/users/gonum/orgs","repos_url":"https://api.github.com/users/gonum/repos","events_url":"https://api.github.com/users/gonum/events{/privacy}","received_events_url":"https://api.github.com/users/gonum/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/gonum/blas","description":"A blas implementation for Go.","fork":false,"url":"https://api.github.com/repos/gonum/blas","forks_url":"https://api.github.com/repos/gonum/blas/forks","keys_url":"https://api.github.com/repos/gonum/blas/keys{/key_id}","collaborators_url":"https://api.github.com/repos/gonum/blas/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/gonum/blas/teams","hooks_url":"https://api.github.com/repos/gonum/blas/hooks","issue_events_url":"https://api.github.com/repos/gonum/blas/issues/events{/number}","events_url":"https://api.github.com/repos/gonum/blas/events","assignees_url":"https://api.github.com/repos/gonum/blas/assignees{/user}","branches_url":"https://api.github.com/repos/gonum/blas/branches{/branch}","tags_url":"https://api.github.com/repos/gonum/blas/tags","blobs_url":"https://api.github.com/repos/gonum/blas/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/gonum/blas/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/gonum/blas/git/refs{/sha}","trees_url":"https://api.github.com/repos/gonum/blas/git/trees{/sha}","statuses_url":"https://api.github.com/repos/gonum/blas/statuses/{sha}","languages_url":"https://api.github.com/repos/gonum/blas/languages","stargazers_url":"https://api.github.com/repos/gonum/blas/stargazers","contributors_url":"https://api.github.com/repos/gonum/blas/contributors","subscribers_url":"https://api.github.com/repos/gonum/blas/subscribers","subscription_url":"https://api.github.com/repos/gonum/blas/subscription","commits_url":"https://api.github.com/repos/gonum/blas/commits{/sha}","git_commits_url":"https://api.github.com/repos/gonum/blas/git/commits{/sha}","comments_url":"https://api.github.com/repos/gonum/blas/comments{/number}","issue_comment_url":"https://api.github.com/repos/gonum/blas/issues/comments/{number}","contents_url":"https://api.github.com/repos/gonum/blas/contents/{+path}","compare_url":"https://api.github.com/repos/gonum/blas/compare/{base}...{head}","merges_url":"https://api.github.com/repos/gonum/blas/merges","archive_url":"https://api.github.com/repos/gonum/blas/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/gonum/blas/downloads","issues_url":"https://api.github.com/repos/gonum/blas/issues{/number}","pulls_url":"https://api.github.com/repos/gonum/blas/pulls{/number}","milestones_url":"https://api.github.com/repos/gonum/blas/milestones{/number}","notifications_url":"https://api.github.com/repos/gonum/blas/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/gonum/blas/labels{/name}","releases_url":"https://api.github.com/repos/gonum/blas/releases{/id}","created_at":"2013-04-23T04:48:28Z","updated_at":"2015-02-04T04:09:33Z","pushed_at":"2015-02-05T08:13:35Z","git_url":"git://github.com/gonum/blas.git","ssh_url":"git@github.com:gonum/blas.git","clone_url":"https://github.com/gonum/blas.git","svn_url":"https://github.com/gonum/blas","homepage":null,"size":2518,"stargazers_count":48,"watchers_count":48,"language":"Go","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":7,"mirror_url":null,"open_issues_count":7,"forks":7,"open_issues":7,"watchers":48,"default_branch":"master"}},"base":{"label":"gonum:master","ref":"master","sha":"ccdaf383160cb35e9fb6b1c782a84778a46a191e","user":{"login":"gonum","id":3771091,"avatar_url":"https://avatars.githubusercontent.com/u/3771091?v=3","gravatar_id":"","url":"https://api.github.com/users/gonum","html_url":"https://github.com/gonum","followers_url":"https://api.github.com/users/gonum/followers","following_url":"https://api.github.com/users/gonum/following{/other_user}","gists_url":"https://api.github.com/users/gonum/gists{/gist_id}","starred_url":"https://api.github.com/users/gonum/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/gonum/subscriptions","organizations_url":"https://api.github.com/users/gonum/orgs","repos_url":"https://api.github.com/users/gonum/repos","events_url":"https://api.github.com/users/gonum/events{/privacy}","received_events_url":"https://api.github.com/users/gonum/received_events","type":"Organization","site_admin":false},"repo":{"id":9615328,"name":"blas","full_name":"gonum/blas","owner":{"login":"gonum","id":3771091,"avatar_url":"https://avatars.githubusercontent.com/u/3771091?v=3","gravatar_id":"","url":"https://api.github.com/users/gonum","html_url":"https://github.com/gonum","followers_url":"https://api.github.com/users/gonum/followers","following_url":"https://api.github.com/users/gonum/following{/other_user}","gists_url":"https://api.github.com/users/gonum/gists{/gist_id}","starred_url":"https://api.github.com/users/gonum/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/gonum/subscriptions","organizations_url":"https://api.github.com/users/gonum/orgs","repos_url":"https://api.github.com/users/gonum/repos","events_url":"https://api.github.com/users/gonum/events{/privacy}","received_events_url":"https://api.github.com/users/gonum/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/gonum/blas","description":"A blas implementation for Go.","fork":false,"url":"https://api.github.com/repos/gonum/blas","forks_url":"https://api.github.com/repos/gonum/blas/forks","keys_url":"https://api.github.com/repos/gonum/blas/keys{/key_id}","collaborators_url":"https://api.github.com/repos/gonum/blas/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/gonum/blas/teams","hooks_url":"https://api.github.com/repos/gonum/blas/hooks","issue_events_url":"https://api.github.com/repos/gonum/blas/issues/events{/number}","events_url":"https://api.github.com/repos/gonum/blas/events","assignees_url":"https://api.github.com/repos/gonum/blas/assignees{/user}","branches_url":"https://api.github.com/repos/gonum/blas/branches{/branch}","tags_url":"https://api.github.com/repos/gonum/blas/tags","blobs_url":"https://api.github.com/repos/gonum/blas/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/gonum/blas/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/gonum/blas/git/refs{/sha}","trees_url":"https://api.github.com/repos/gonum/blas/git/trees{/sha}","statuses_url":"https://api.github.com/repos/gonum/blas/statuses/{sha}","languages_url":"https://api.github.com/repos/gonum/blas/languages","stargazers_url":"https://api.github.com/repos/gonum/blas/stargazers","contributors_url":"https://api.github.com/repos/gonum/blas/contributors","subscribers_url":"https://api.github.com/repos/gonum/blas/subscribers","subscription_url":"https://api.github.com/repos/gonum/blas/subscription","commits_url":"https://api.github.com/repos/gonum/blas/commits{/sha}","git_commits_url":"https://api.github.com/repos/gonum/blas/git/commits{/sha}","comments_url":"https://api.github.com/repos/gonum/blas/comments{/number}","issue_comment_url":"https://api.github.com/repos/gonum/blas/issues/comments/{number}","contents_url":"https://api.github.com/repos/gonum/blas/contents/{+path}","compare_url":"https://api.github.com/repos/gonum/blas/compare/{base}...{head}","merges_url":"https://api.github.com/repos/gonum/blas/merges","archive_url":"https://api.github.com/repos/gonum/blas/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/gonum/blas/downloads","issues_url":"https://api.github.com/repos/gonum/blas/issues{/number}","pulls_url":"https://api.github.com/repos/gonum/blas/pulls{/number}","milestones_url":"https://api.github.com/repos/gonum/blas/milestones{/number}","notifications_url":"https://api.github.com/repos/gonum/blas/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/gonum/blas/labels{/name}","releases_url":"https://api.github.com/repos/gonum/blas/releases{/id}","created_at":"2013-04-23T04:48:28Z","updated_at":"2015-02-04T04:09:33Z","pushed_at":"2015-02-05T08:13:35Z","git_url":"git://github.com/gonum/blas.git","ssh_url":"git@github.com:gonum/blas.git","clone_url":"https://github.com/gonum/blas.git","svn_url":"https://github.com/gonum/blas","homepage":null,"size":2518,"stargazers_count":48,"watchers_count":48,"language":"Go","has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":7,"mirror_url":null,"open_issues_count":7,"forks":7,"open_issues":7,"watchers":48,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/gonum/blas/pulls/107"},"html":{"href":"https://github.com/gonum/blas/pull/107"},"issue":{"href":"https://api.github.com/repos/gonum/blas/issues/107"},"comments":{"href":"https://api.github.com/repos/gonum/blas/issues/107/comments"},"review_comments":{"href":"https://api.github.com/repos/gonum/blas/pulls/107/comments"},"review_comment":{"href":"https://api.github.com/repos/gonum/blas/pulls/comments/{number}"},"commits":{"href":"https://api.github.com/repos/gonum/blas/pulls/107/commits"},"statuses":{"href":"https://api.github.com/repos/gonum/blas/statuses/ce96b9f59350d812ef6422f96a381809a6919ba1"}}}}