<!--
{
  "availability" : [
    "iOS: 9.0.0 -",
    "iPadOS: 9.0.0 -",
    "macCatalyst: 13.1.0 -",
    "macOS: 10.11.0 -",
    "tvOS: 9.0.0 -",
    "visionOS: 1.0.0 -",
    "watchOS: 3.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Accelerate",
  "identifier" : "/documentation/Accelerate/sparse_matrix_create_double(_:_:)",
  "metadataVersion" : "0.1.0",
  "role" : "Function",
  "symbol" : {
    "kind" : "Function",
    "modules" : [
      "Accelerate"
    ],
    "preciseIdentifier" : "c:@F@sparse_matrix_create_double"
  },
  "title" : "sparse_matrix_create_double(_:_:)"
}
-->

# sparse_matrix_create_double(_:_:)

Returns a double-precision sparse matrix object.

```
func sparse_matrix_create_double(_ M: sparse_dimension, _ N: sparse_dimension) -> sparse_matrix_double!
```

## Parameters

`M`

The number of rows of the matrix. Must be greater than 0.

`N`

The number of columns of the matrix. Must be greater than 0.

## Return Value

A matrix object that is ready for receiving entries. If an error occurs, `nil` is returned.

## Discussion

This function creates a sparse matrix object that is stored in pointwise format and is ready to receive values from the various insert routines.  Pointwise format means individual values are stored for a given `i,j` location as opposed to blocks of values.  For block support use the block create routines.  See the various insert routines for details on inserting entries into this matrix object.

After you’ve finished with the matrix, it’s important that you free the memory allocated to it with [`sparse_matrix_destroy(_:)`](/documentation/Accelerate/sparse_matrix_destroy(_:)).

> Important:
> Apple provides the BLAS and LAPACK libraries under the Accelerate framework to be in line with LAPACK 3.9.1. Starting with iOS 26, iPadOS 26, macOS 26, tvOS 26, visionOS 26, and watchOS 26, the libraries are in line with LAPACK 3.12.0. These new interfaces provide additional functionality, as well as a new ILP64 interface. To use the new interfaces, define `ACCELERATE_NEW_LAPACK` before including the Accelerate or vecLib headers. For ILP64 interfaces, also define `ACCELERATE_LAPACK_ILP64`. For Swift projects, specify `ACCELERATE_NEW_LAPACK=1` and `ACCELERATE_LAPACK_ILP64=1` as preprocessor macros in Xcode build settings under Apple Clang - Preprocessing > Preprocessor Macros.

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)