1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
|
.. meta::
:description: hipSPARSE installation guide
:keywords: hipSPARSE, rocSPARSE, ROCm, API, documentation, install
.. _hipsparse_building:
*********************************
Installing and building hipSPARSE
*********************************
This topic explains how to install and build the hipSPARSE library.
Prerequisites
=============
hipSPARSE requires a ROCm enabled platform.
Installing prebuilt packages
=============================
hipSPARSE can be installed from the AMD ROCm repository.
For detailed instructions on installing ROCm, see :doc:`ROCm installation <rocm-install-on-linux:index>`.
To install hipSPARSE on Ubuntu, run these commands:
.. code-block:: shell
sudo apt-get update
sudo apt-get install hipsparse
After hipSPARSE is installed, it can be used just like any other library with a C API.
To call hipSPARSE, the header file must be included in the user code.
This means the hipSPARSE shared library becomes a link-time and run-time dependency for the user application.
Building hipSPARSE from source
==============================
It isn't necessary to build hipSPARSE from source because it's ready to use after installing
the prebuilt packages, as described above.
To build hipSPARSE from source, follow the instructions in this section.
To compile and run hipSPARSE, the `AMD ROCm Platform <https://github.com/ROCm/ROCm>`_ is required.
The build also requires the following compile-time dependencies:
* `rocSPARSE <https://github.com/ROCm/rocSPARSE>`_
* `git <https://git-scm.com/>`_
* `CMake <https://cmake.org/>`_ (Version 3.5 or later)
* `GoogleTest <https://github.com/google/googletest>`_ (Optional: only required to build the clients)
Downloading hipSPARSE
-------------------------
The hipSPARSE source code is available from the `hipSPARSE GitHub <https://github.com/ROCm/hipSPARSE>`_.
Download the develop branch using these commands:
.. code-block:: shell
git clone -b develop https://github.com/ROCm/hipSPARSE.git
cd hipSPARSE
Building hipSPARSE using the install script
-------------------------------------------
It's recommended to use the ``install.sh`` script to install hipSPARSE.
Here are the steps required to build different packages of the library, including the dependencies and clients.
Using install.sh to build hipSPARSE with dependencies
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
The following table lists the common ways to use ``install.sh`` to build the hipSPARSE dependencies and library.
.. csv-table::
:header: "Command","Description"
:widths: 30, 100
"``./install.sh -h``", "Print the help information."
"``./install.sh -d``", "Build the dependencies and library in your local directory. The ``-d`` flag only needs to be used once. For subsequent invocations of the script, it isn't necessary to rebuild the dependencies."
"``./install.sh``", "Build the library in your local directory. The script assumes the dependencies are available."
"``./install.sh -i``", "Build the library, then build and install the hipSPARSE package in ``/opt/rocm/hipsparse``. The script prompts you for ``sudo`` access. This installs hipSPARSE for all users."
Using install.sh to build hipSPARSE with dependencies and clients
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
The clients contains example code and unit tests. Common use cases of ``install.sh`` to build them are listed in the table below.
.. csv-table::
:header: "Command","Description"
:widths: 30, 100
"``./install.sh -h``", "Print the help information."
"``./install.sh -dc``", "Build the dependencies, library, and client in your local directory. The ``-d`` flag only needs to be used once. For subsequent invocations of the script, it isn't necessary to rebuild the dependencies."
"``./install.sh -c``", "Build the library and client in your local directory. The script assumes the dependencies are available."
"``./install.sh -idc``", "Build the library, dependencies, and client, then build and install the hipSPARSE package in ``/opt/rocm/hipsparse``. The script prompts you for ``sudo`` access. This installs hipSPARSE and the clients for all users."
"``./install.sh -ic``", "Build the library and client, then build and install the hipSPARSE package in ``opt/rocm/hipsparse``. The script prompts you for ``sudo`` access. This installs hipSPARSE and the clients for all users"
Building hipSPARSE using individual make commands
--------------------------------------------------
You can build hipSPARSE using the following commands:
.. note::
CMake 3.5 or later is required to build hipSPARSE.
.. code-block:: bash
# Create and change to build directory
mkdir -p build/release ; cd build/release
# Default install path is /opt/rocm, use -DCMAKE_INSTALL_PREFIX=<path> to adjust it
cmake ../..
# Compile hipSPARSE library
make -j$(nproc)
# Install hipSPARSE to /opt/rocm
make install
You can build hipSPARSE with the dependencies and clients using the following commands:
.. note::
GoogleTest is required to build the hipSPARSE clients.
.. code-block:: shell
# Install GoogleTest
mkdir -p build/release/deps ; cd build/release/deps
cmake ../../../deps
make -j$(nproc) install
# Change to build directory
cd ..
# Default install path is /opt/rocm, use -DCMAKE_INSTALL_PREFIX=<path> to adjust it
cmake ../.. -DBUILD_CLIENTS_TESTS=ON -DBUILD_CLIENTS_SAMPLES=ON
# Compile hipSPARSE library
make -j$(nproc)
# Install hipSPARSE to /opt/rocm
make install
Testing hipSPARSE
==============================
You can test the installation by running one of the hipSPARSE examples after successfully compiling the library with the clients.
.. code-block:: shell
# Navigate to clients binary directory
cd hipSPARSE/build/release/clients/staging
# Execute hipSPARSE example
./example_csrmv 1000
Supported targets
==============================
For a list of the currently supported operating systems, see the :doc:`ROCm compatibility matrix <rocm:compatibility/compatibility-matrix>`.
|
