{"id":13731476,"url":"https://github.com/STEllAR-GROUP/blaze_tensor","last_synced_at":"2025-05-08T04:33:59.058Z","repository":{"id":146620739,"uuid":"157039072","full_name":"STEllAR-GROUP/blaze_tensor","owner":"STEllAR-GROUP","description":"3D Tensors for Blaze (https://bitbucket.org/blaze-lib/blaze)","archived":false,"fork":false,"pushed_at":"2020-10-01T15:59:27.000Z","size":2744,"stargazers_count":37,"open_issues_count":5,"forks_count":8,"subscribers_count":9,"default_branch":"master","last_synced_at":"2025-04-30T05:35:57.950Z","etag":null,"topics":["3d-tensors","blaze-library","linear-algebra"],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/STEllAR-GROUP.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2018-11-11T02:03:03.000Z","updated_at":"2025-04-21T01:39:15.000Z","dependencies_parsed_at":"2023-04-11T05:01:45.874Z","dependency_job_id":null,"html_url":"https://github.com/STEllAR-GROUP/blaze_tensor","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/STEllAR-GROUP%2Fblaze_tensor","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/STEllAR-GROUP%2Fblaze_tensor/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/STEllAR-GROUP%2Fblaze_tensor/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/STEllAR-GROUP%2Fblaze_tensor/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/STEllAR-GROUP","download_url":"https://codeload.github.com/STEllAR-GROUP/blaze_tensor/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253000830,"owners_count":21838414,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["3d-tensors","blaze-library","linear-algebra"],"created_at":"2024-08-03T02:01:31.023Z","updated_at":"2025-05-08T04:33:54.045Z","avatar_url":"https://github.com/STEllAR-GROUP.png","language":"C++","readme":"\u003c!-- =================================================================================================--\u003e\n\u003c!--                                                                                                  --\u003e\n\u003c!--   Copyright (C) 2012-2018 Klaus Iglberger - All Rights Reserved                                  --\u003e\n\u003c!--   Copyright (C) 2018 Hartmut Kaiser - All Rights Reserved                                        --\u003e\n\u003c!--                                                                                                  --\u003e\n\u003c!--   This file is part of the Blaze library. You can redistribute it and/or modify it under         --\u003e\n\u003c!--   the terms of the New (Revised) BSD License. Redistribution and use in source and binary        --\u003e\n\u003c!--   forms, with or without modification, are permitted provided that the following conditions      --\u003e\n\u003c!--   are met:                                                                                       --\u003e\n\u003c!--                                                                                                  --\u003e\n\u003c!--   1. Redistributions of source code must retain the above copyright notice, this list of         --\u003e\n\u003c!--      conditions and the following disclaimer.                                                    --\u003e\n\u003c!--   2. Redistributions in binary form must reproduce the above copyright notice, this list         --\u003e\n\u003c!--      of conditions and the following disclaimer in the documentation and/or other materials      --\u003e\n\u003c!--      provided with the distribution.                                                             --\u003e\n\u003c!--   3. Neither the names of the Blaze development group nor the names of its contributors          --\u003e\n\u003c!--      may be used to endorse or promote products derived from this software without specific      --\u003e\n\u003c!--      prior written permission.                                                                   --\u003e\n\u003c!--                                                                                                  --\u003e\n\u003c!--   THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS \"AS IS\" AND ANY            --\u003e\n\u003c!--   EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES           --\u003e\n\u003c!--   OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT            --\u003e\n\u003c!--   SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,                 --\u003e\n\u003c!--   INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED           --\u003e\n\u003c!--   TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR             --\u003e\n\u003c!--   BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN               --\u003e\n\u003c!--   CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN             --\u003e\n\u003c!--   ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH            --\u003e\n\u003c!--   DAMAGE.                                                                                        --\u003e\n\u003c!--                                                                                                  --\u003e\n\u003c!-- =================================================================================================--\u003e\n\n# 3D Tensors for Blaze\n\nThis project implements 3D datastructures (tensors) that integrate well with the\n[Blaze library](https://bitbucket.org/blaze-lib/blaze/src). \n\nAll the highlights listed for Blaze apply to BlazeTensor as well:\n\n- high performance through the integration of BLAS libraries and manually tuned\n  HPC math kernels\n- vectorization by SSE, SSE2, SSE3, SSSE3, SSE4, AVX, AVX2, AVX-512, FMA, and SVML\n- parallel execution by OpenMP, HPX, C++11 threads and Boost threads\n- the intuitive and easy to use API of a domain specific language\n- unified arithmetic with dense 3D tensors\n- thoroughly tested 3D tensor arithmetic\n- completely portable, high quality C++ source code\n\nThe implemented facilities are verified using a thorough testing environment.\nThe [CircleCI](https://circleci.com/gh/STEllAR-GROUP/blaze_tensor) contiguous\nintegration service tracks the current build status for the master branch:\n[![CircleCI](https://circleci.com/gh/STEllAR-GROUP/blaze_tensor.svg?style=svg)](https://circleci.com/gh/STEllAR-GROUP/blaze_tensor).\n\n## What's implemented:\n\n### Datastructures\n\n- `blaze::DynamicArray\u003cN, T\u003e`: a resizable, row-major ND dense array data structure\n  of arbitrary types\n- `blaze::CustomArray\u003cN, T, ...\u003e`: a non-owning ND dense array data structure usable\n  to refer to some other ND dense array\n- `blaze::DynamicTensor\u003cT\u003e`: a resizable, row-major 3D dense array data structure\n  of arbitrary types\n- `blaze::CustomTensor\u003cT, ...\u003e`: a non-owning 3D dense array data structure usable\n  to refer to some other 3D dense array\n- `blaze::StaticTensor\u003cT, O, M, N\u003e`: a statically sized 3D dense array data\n  structure of arbitrary types\n- `blaze::UniformTensor\u003cT\u003e`: a dynamically sized uniform (all elements have the\n  same value) 3D dense array data structure of arbitrary types\n\n### Views\n\n- `blaze::SubTensor\u003c...\u003e`: a view representing a contigous subregion of a dense\n  3D array that is statically or dynamically sized\n- `blaze::PageSlice\u003c...\u003e`: a view representing a slice of 'thickness' one along\n  the row/column plane of a 3D dense array\n- `blaze::ColumnSlice\u003c...\u003e`: a view representing a slice of 'thickness' one along\n  the page/column plane of a 3D dense array\n- `blaze::RowSlice\u003c...\u003e`: a view representing a slice of 'thickness' one along\n  the column/page plane of a 3D dense array\n- `blaze::DilatedSubvector\u003c...\u003e`: a view representing a sub-vector of any Blaze\n  vector-like data structure with an additional 'dilation' (step-size between\n  the elements of the underlying vector)\n- `blaze::DilatedSubmatrix\u003c...\u003e`: a view representing a sub-matrix of any Blaze\n  matrix-like data structure with two additional argumnts: 'rowdilation' and \n  'columndilation' (step-size between the rows and the columns of the underlying\n  matrix, respectively).\n- `blaze::DilatedSubtensor\u003c...\u003e`: a view representing a sub-tensor of any Blaze\n  tensor-like data structure with three additional argumnts: 'pagedilation',  \n  'rowdilation' and 'columndilation' (step-size between the pages, rows and the \n  columns of the underlying tensor, respectively).\n- `blaze::QuatSlice\u003c...\u003e`: a view representing a slice of 'thickness' one along\n  the page/row/column tensor of a 4D dense array\n  \n### Operations\n\n- All element-wise arithmetic operations that are supported by the Blaze library:\n  element-wise addition, subtraction, division, Schur-multiplication, scalar\n  multiplication, boolean comparison operations, and many mathematical operations\n  like `sqrt`, `cqrt`, `abs`, `sign`, `floor`, etc.\n- Reduction operations like `min` and `max`, also unary and binary overloads for\n  `blaze::map`.\n- Matrix expand operations that produce tensors from expanding (broadcasting)\n  matrices in page direction (`blaze::expand()`).\n- Matrix and Tensor flattening (`blaze::ravel()`).\n\nWe have created a list of things that need to be implemented:\n[TODO: Things to implement](https://github.com/STEllAR-GROUP/blaze_tensor/issues/2).\nThis is a good starting point if you would like to help developing BlazeTensor.\n\n## Building and installing BlazeTensor\n\nIn order to use BlazeTensor you will need a proper installation of the\n[Blaze library](https://bitbucket.org/blaze-lib/blaze/src). Please see\n[here](https://bitbucket.org/blaze-lib/blaze/wiki/Configuration%20and%20Installation)\nfor instructions on how to install it. Please note that you will need a very\nrecent version (preferrably top of master) of Blaze. If you want to run the\nBlazeTensor tests you will also need the Blaze source directory.\n\n1. Clone this repository\n2. Create a build directory\n   ```\n   $ mkdir build\n   $ cd build\n   ```\n3. Call cmake with the relevant options:\n   ```\n   $ cmake -DCMAKE_INSTALL_PREFIX=/opt/BlazeTensor -Dblaze_DIR=\u003cblaze_dir\u003e \u003csrcdir\u003e\n   ```\n   here: `\u003cblaze_dir\u003e` should refer to the directory that contains the file\n   `blaze-config.cmake` that was created during installation of Blaze.  \n4. Build and install:\n   ```\n   $ make\n   $ make install\n   ```\n5. If you want to build the tests, additionally specify `-DBLAZETENSOR_WITH_TESTS=ON`\n   and `-Dblazetest_DIR=\u003cblazesrc/blazetest\u003e` \n   on the `cmake` command line. Run the tests with `make tests`.\n   \nBlazeTensor is a header only C++ library. Projects depending on it should make\nsure the headers are being found by the compiler. If your depending project uses\n`cmake`, just add `find_package(BlazeTensor)` to your scripts and refer to the\ntarget named `BlazeTensor::BlazeTensor`.\n\n## Communication\nA channel on the freenode IRC network is used for discussions on\nBlazeTensor: #ste||ar on freenode (via SSL). Feel free to use the\n[Github issue tracker](https://github.com/STEllAR-GROUP/blaze_tensor/issues) for\nquestions, bug reports, and feature requests. \n\n## License\nBlazeTensor is released under the terms of the\n[New (Revised) BSD license](https://github.com/STEllAR-GROUP/blaze_tensor/blob/master/LICENSE).\n\n## Acknowledgements\n\nWe would like to acknowledge the NSF, DoD, and the Center for Computation\nand Technology (CCT) at Louisiana State University (LSU).\n\nBlazeTensor is currently funded by:\n\n* The National Science Foundation through awards 1737785 (Phylanx).\n\n  Any opinions, findings, and conclusions or recommendations expressed in this\n  material are those of the author(s) and do not necessarily reflect the views\n  of the National Science Foundation.\n  \n* The Defense Technical Information Center (DTIC) under contract FA8075-14-D-0002/0007\n\n  Neither the United States Government nor any agency thereof, nor any of their \n  employees makes any warranty, express or implied, or assumes any legal liability \n  or responsibility for the accuracy, completeness, or usefulness of any information, \n  apparatus, product, or process disclosed, or represents that its use would not \n  infringe privately owned rights.\n","funding_links":[],"categories":["Maths"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FSTEllAR-GROUP%2Fblaze_tensor","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FSTEllAR-GROUP%2Fblaze_tensor","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FSTEllAR-GROUP%2Fblaze_tensor/lists"}