Products
  • Wolfram|One

    The definitive Wolfram Language and notebook experience

  • Mathematica

    The original technical computing environment

  • System Modeler

    Multidomain modeling and simulation of complex systems

  • Compute ServicesUse with Mathematica and Wolfram|One
  • AI AccessUse with Mathematica and Wolfram|One
  • Finance Platform
  • Wolfram|Alpha Notebook Edition
  • Application Server
  • Enterprise Private Cloud
  • Wolfram Engine
  • Wolfram Player
  • Wolfram Cloud App
  • Wolfram Player App

More mobile apps

Wolfram|Alpha

  • Wolfram|Alpha Website
  • Wolfram|Alpha APIs

AI Products

  • Wolfram AI Ecosystem
  • Wolfram Foundation Tool
  • Wolfram Cloud MCP
  • Wolfram Local MCP
  • Agent One API
  • CAG Component APIs

Core Technologies of Wolfram Products

  • Wolfram Language
  • Computable Data
  • Wolfram Notebooks
  • Linguistic Understanding

Additional Deployment Options

  • Wolfram Cloud
  • Wolfram Web Engine
  • wolframscript
  • WSTPServer
  • Group & Organizational Licensing
  • All Products
Consulting & Solutions

We deliver solutions for the AI era—combining symbolic computation, data-driven insights and deep technical expertise

Wolfram Consulting

Data Science, Finance & Business

  • Artificial Intelligence
  • Data Science
  • Healthcare
  • Real Estate

Engineering

  • Civil Engineering
  • Automotive Engineering
  • Sustainable Energy

Science & Technology

  • AgTech
  • Biosciences
  • Environmental Science
  • Food Science
  • Quantum Computation
  • Social and Behavioral Sciences

More Wolfram Solutions

Technology for Education

  • Research Universities
  • Colleges & Teaching Universities
  • High Schools
  • Resources for Students

Education Initiatives

  • Next-Gen EdTech
  • Computer-Based Math

More Solutions for Education

  • Contact Us
Learning & Support

Get Started

  • Wolfram Language Introduction
  • Fast Intro for Programmers
  • Fast Intro for Math Students
  • Wolfram Language Documentation

More Learning

  • Highlighted Core Areas
  • Demonstrations
  • YouTube
  • Daily Study Groups
  • Wolfram Schools and Programs
  • Books

Grow Your Skills

  • Wolfram U

    Courses in computing, science, life and more

  • Community

    Learn, solve problems and share ideas.

  • Blog

    News, views and insights from Wolfram

  • Resources for

    Software Developers

Tech Support

  • Contact Us
  • Support FAQs
  • Support FAQs
  • Contact Us
Company
  • About Wolfram
  • Career Center
  • All Sites & Resources
  • Connect & Follow
  • Contact Us

Work with Us

  • Student Ambassador Initiative
  • Wolfram for Startups
  • Student Opportunities
  • Jobs Using Wolfram Language

Educational Programs for Adults

  • Summer School
  • Winter School

Educational Programs for Youth

  • Middle School Camp
  • High School Research Program
  • Computational Adventures

Read

  • Stephen Wolfram's Writings
  • Wolfram Blog
  • Wolfram Tech | Books
  • Wolfram Media
  • Complex Systems

Educational Resources

  • Wolfram MathWorld
  • Wolfram in STEM
  • Wolfram Challenges
  • Wolfram Problem Generator

Wolfram Initiatives

  • Wolfram Science
  • Wolfram Foundation
  • History of Mathematics Project

Events

  • Stephen Wolfram Livestreams
  • Online & In-Person Events
  • Contact Us
  • Connect & Follow
For AIs
  • Your Account
  • User Portal
  • Wolfram Cloud
  • Products
    • Wolfram|One
    • Mathematica
    • System Modeler
    • Compute ServicesUse with Mathematica and Wolfram|One
    • AI AccessUse with Mathematica and Wolfram|One
    • Finance Platform
    • Wolfram|Alpha Notebook Edition
    • Application Server
    • Enterprise Private Cloud
    • Wolfram Engine
    • Wolfram Player
    • Wolfram Cloud App
    • Wolfram Player App

    More mobile apps

    • Wolfram|Alpha
      • Wolfram|Alpha Website
      • Wolfram|Alpha APIs
    • AI Products
      • Wolfram AI Ecosystem
      • Wolfram Foundation Tool
      • Wolfram Cloud MCP
      • Wolfram Local MCP
      • Agent One API
      • CAG Component APIs
    • Core Technologies
      • Wolfram Language
      • Computable Data
      • Wolfram Notebooks
      • Linguistic Understanding
    • Additional Deployment Options
      • Wolfram Cloud
      • Wolfram Web Engine
      • wolframscript
      • WSTPServer
    • Group & Organizational Licensing
    • All Products
  • Consulting & Solutions
    • Wolfram Consulting

    Data Science, Finance & Business

    • Artificial Intelligence
    • Data Science
    • Healthcare
    • Real Estate

    Engineering

    • Civil Engineering
    • Automotive Engineering
    • Sustainable Energy

    Science & Technology

    • AgTech
    • Biosciences
    • Environmental Science
    • Food Science
    • Quantum Computation
    • Social and Behavioral Sciences

    More Wolfram Solutions

    Technology for Education

    • Research Universities
    • Colleges & Teaching Universities
    • High Schools
    • Resources for Students

    Education Initiatives

    • Next-Gen EdTech
    • Computer-Based Math

    More Solutions for Education

    • Contact Us
  • Learning & Support

    Get Started

    • Wolfram Language Introduction
    • Fast Intro for Programmers
    • Fast Intro for Math Students
    • Wolfram Language Documentation

    Grow Your Skills

    • Wolfram U

      Courses in computing, science, life and more

    • Community

      Learn, solve problems and share ideas.

    • Blog

      News, views and insights from Wolfram

    • Resources for

      Software Developers
    • Tech Support
      • Contact Us
      • Support FAQs
    • More Learning
      • Highlighted Core Areas
      • Demonstrations
      • YouTube
      • Daily Study Groups
      • Wolfram Schools and Programs
      • Books
    • Support FAQs
    • Contact Us
  • Company
    • About Wolfram
    • Career Center
    • All Sites & Resources
    • Connect & Follow
    • Contact Us

    Work with Us

    • Student Ambassador Initiative
    • Wolfram for Startups
    • Student Opportunities
    • Jobs Using Wolfram Language

    Educational Programs for Adults

    • Summer School
    • Winter School

    Educational Programs for Youth

    • Middle School Camp
    • High School Research Program
    • Computational Adventures

    Read

    • Stephen Wolfram's Writings
    • Wolfram Blog
    • Wolfram Tech | Books
    • Wolfram Media
    • Complex Systems
    • Educational Resources
      • Wolfram MathWorld
      • Wolfram in STEM
      • Wolfram Challenges
      • Wolfram Problem Generator
    • Wolfram Initiatives
      • Wolfram Science
      • Wolfram Foundation
      • History of Mathematics Project
    • Events
      • Stephen Wolfram Livestreams
      • Online & In-Person Events
    • Contact Us
    • Connect & Follow
  • For AIs
  • Wolfram Cloud
  • Your Account
  • User Portal
Wolfram Language & System Documentation Center
ArrayRules
  • See Also
    • SparseArray
    • Position
    • Normal
    • Keys
    • Values
  • Related Guides
    • Sparse Arrays
    • Parts of Matrices
    • Matrices and Linear Algebra
    • Elements of Lists
  • Tech Notes
    • Getting and Setting Pieces of Matrices
    • Sparse Arrays: Manipulating Lists
    • Sparse Arrays: Linear Algebra
    • See Also
      • SparseArray
      • Position
      • Normal
      • Keys
      • Values
    • Related Guides
      • Sparse Arrays
      • Parts of Matrices
      • Matrices and Linear Algebra
      • Elements of Lists
    • Tech Notes
      • Getting and Setting Pieces of Matrices
      • Sparse Arrays: Manipulating Lists
      • Sparse Arrays: Linear Algebra

ArrayRules[SparseArray[…]]

gives the rules {pos1val1,pos2val2,…} specifying elements in a sparse array.

ArrayRules[list]

gives rules for SparseArray[list].

Details
Details and Options Details and Options
Examples  
Basic Examples  
Scope  
Applications  
Properties & Relations  
See Also
Tech Notes
Related Guides
History
Cite this Page
BUILT-IN SYMBOL
  • See Also
    • SparseArray
    • Position
    • Normal
    • Keys
    • Values
  • Related Guides
    • Sparse Arrays
    • Parts of Matrices
    • Matrices and Linear Algebra
    • Elements of Lists
  • Tech Notes
    • Getting and Setting Pieces of Matrices
    • Sparse Arrays: Manipulating Lists
    • Sparse Arrays: Linear Algebra
    • See Also
      • SparseArray
      • Position
      • Normal
      • Keys
      • Values
    • Related Guides
      • Sparse Arrays
      • Parts of Matrices
      • Matrices and Linear Algebra
      • Elements of Lists
    • Tech Notes
      • Getting and Setting Pieces of Matrices
      • Sparse Arrays: Manipulating Lists
      • Sparse Arrays: Linear Algebra

ArrayRules

ArrayRules[SparseArray[…]]

gives the rules {pos1val1,pos2val2,…} specifying elements in a sparse array.

ArrayRules[list]

gives rules for SparseArray[list].

Details

  • The last element of ArrayRules[s] is always {_,_,…}->def, where def is the default value for unspecified elements in the sparse array. »
  • ArrayRules[list,val] takes the default value to be val. »
  • ArrayRules[list] assumes a default value of 0. »

Examples

open all close all

Basic Examples  (1)

Get the explicit elements in a SparseArray:

Wolfram Language code: s = SparseArray[{{i_, j_} /; Abs[i - j] ≤ 1 -> -2 + 3Abs[i - j]}, {5, 5}]
Wolfram Language code: ar = ArrayRules[s]

These rules are sufficient to efficiently construct an identical SparseArray:

Wolfram Language code: s2 = SparseArray[ar]
Wolfram Language code: s === s2

Scope  (2)

The last element of ArrayRules[s] is always {_,_,…}->def:

Wolfram Language code: m = RandomInteger[2, {3, 3}]

A SparseArray with a default value of 2:

Wolfram Language code: s2 = SparseArray[m, Automatic, 2]
Wolfram Language code: ar2 = ArrayRules[s2]

You can override this by explicitly specifying what default you would like:

Wolfram Language code: ar1 = ArrayRules[s2, 1]

These will construct a SparseArray identical to SparseArray[m,Automatic,1]:

Wolfram Language code: SparseArray[ar1, {3, 3}] === SparseArray[m, Automatic, 1]

Positions of 1 in an explicit array with the default taken to be 0:

Wolfram Language code: a = RandomInteger[1, {2, 2, 2}]
Wolfram Language code: ArrayRules[a]

These will construct a SparseArray identical to SparseArray[a]:

Wolfram Language code: SparseArray[%, {2, 2, 2}] === SparseArray[a]

Positions of 0 with 1 taken as default:

Wolfram Language code: ArrayRules[a, 1]

These will construct a SparseArray identical to SparseArray[a,Automatic,1]:

Wolfram Language code: SparseArray[%, {2, 2, 2}] === SparseArray[a, Automatic, 1]

Applications  (4)

Get the number of explicit elements in a SparseArray:

Wolfram Language code: s = SparseArray[RandomChoice[{100, 1} -> {0, 1}, 1000]]
Wolfram Language code: Length[ArrayRules[s]] - 1

Get the explicit elements of a sparse array satisfying a condition:

Wolfram Language code: SeedRandom[1234];s = SparseArray[RandomInteger[{1, 9}, {19, 2}] -> RandomInteger[{-9, 9}, 19], {9, 9}]

Note the more complicated pattern is needed since Cases has special behavior for Rule:

Wolfram Language code: Cases[ArrayRules[s], (r : (_ -> x_ /; Positive[x])) -> r]

SparseArray objects with positive and negative values:

Wolfram Language code: spos = SparseArray[%, Dimensions[s]]
Wolfram Language code: sneg = SparseArray[Cases[ArrayRules[s], (r : (_ -> x_ /; Negative[x])) -> r], Dimensions[s]]

Get the upper and lower triangular parts of a sparse matrix:

Wolfram Language code: s = SparseArray[{{1, -2, 1, 0, 0}, {0, 1, -2, 1, 0}, {0, 0, 1, -2, 1}, {0, 0, 0, 1, -2}, {-2, -3, -4, -5, -6}}]
Wolfram Language code: upperrules = Cases[ArrayRules[s], (r : ({i_, j_} /; i ≤ j -> _)) -> r]
Wolfram Language code: u = SparseArray[upperrules, Dimensions[s]]

Lower triangular part with 1s on the diagonal:

Wolfram Language code: lowerrules = Cases[ArrayRules[s], (r : ({i_, j_} /; i > j -> _)) -> r]; l = SparseArray[Append[lowerrules, {i_, i_} -> 1], Dimensions[s]]

This just happens to be the LU decomposition of a tridiagonal matrix:

Wolfram Language code: MatrixForm[(l.u)[[{5, 1, 2, 3, 4}]]]

Make a plot showing the positions of the explicit elements of a SparseArray with tooltips:

Wolfram Language code: s = SparseArray[{{i_, i_} -> 1 / i, {i_, j_} /; Mod[i + 2 j, 4] == 0 -> 1 / (i + j)}, {10, 10}]
Wolfram Language code: ListPlot[Apply[Tooltip, Drop[ArrayRules[s], -1], {1}], AspectRatio -> 1, PlotStyle -> PointSize[1 / 10], PlotMarkers -> {"■"}]

MatrixPlot generally makes a visually better plot:

Wolfram Language code: MatrixPlot[s]

Properties & Relations  (2)

For a SparseArray s, SparseArray[ArrayRules[s],Dimensions[s]] is identical to s:

Wolfram Language code: s = SparseArray[RandomInteger[{1, 9}, {5, 2}] :> RandomInteger[{-9, 9}], {10, 10}]
Wolfram Language code: ar = ArrayRules[s]
Wolfram Language code: s === SparseArray[ar, Dimensions[s]]

Specifying the dimensions is needed since they would be inferred from explicit elements:

Wolfram Language code: {Max[ar[[1 ;; -2, 1, 1]]], Max[ar[[1 ;; -2, 1, 2]]]}
Wolfram Language code: SparseArray[ar]

For an explicit array ArrayRules can be written in terms of Position:

Wolfram Language code: par[list_ ? ArrayQ, def_ : 0] := Module[{n = ArrayDepth[list], pos}, pos = Position[list, x_ /; x ≠ def, {n}]; Append[Thread[pos -> Extract[list, pos]], Table[_, {n}] -> def]]
Wolfram Language code: a = RandomInteger[1, {2, 3}]
Wolfram Language code: par[a]
Wolfram Language code: % === ArrayRules[a]
Wolfram Language code: par[a, 1] === ArrayRules[a, 1]

This will not work for SparseArray objects because pattern matching works on the FullForm:

Wolfram Language code: Position[SparseArray[a], x_ /; x ≠ 0, {ArrayDepth[a]}]
Wolfram Language code: FullForm[SparseArray[a]]

See Also

SparseArray  Position  Normal  Keys  Values

Tech Notes

    ▪
  • Getting and Setting Pieces of Matrices
  • ▪
  • Sparse Arrays: Manipulating Lists
  • ▪
  • Sparse Arrays: Linear Algebra

Related Guides

    ▪
  • Sparse Arrays
  • ▪
  • Parts of Matrices
  • ▪
  • Matrices and Linear Algebra
  • ▪
  • Elements of Lists

History

Introduced in 2003 (5.0)

Wolfram Research (2003), ArrayRules, Wolfram Language function, https://reference.wolfram.com/language/ref/ArrayRules.html.

Text

Wolfram Research (2003), ArrayRules, Wolfram Language function, https://reference.wolfram.com/language/ref/ArrayRules.html.

CMS

Wolfram Language. 2003. "ArrayRules." Wolfram Language & System Documentation Center. Wolfram Research. https://reference.wolfram.com/language/ref/ArrayRules.html.

APA

Wolfram Language. (2003). ArrayRules. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/ArrayRules.html

BibTeX

@misc{reference.wolfram_2026_arrayrules, author="Wolfram Research", title="{ArrayRules}", year="2003", howpublished="\url{https://reference.wolfram.com/language/ref/ArrayRules.html}", note=[Accessed: 01-September-2026]}

BibLaTeX

@online{reference.wolfram_2026_arrayrules, organization={Wolfram Research}, title={ArrayRules}, year={2003}, url={https://reference.wolfram.com/language/ref/ArrayRules.html}, note=[Accessed: 01-September-2026]}

Top
Introduction for Programmers
Introductory Book
Wolfram Function Repository | Wolfram Data Repository | Wolfram Data Drop | Wolfram Language Products
Top
  • Products
  • Wolfram|One
  • Mathematica
  • AI Access
  • Compute Services
  • System Modeler

  • Wolfram|Alpha Notebook Edition
  • Wolfram|Alpha Pro
  • Mobile Apps

  • Wolfram Engine
  • Wolfram Player

  • Volume & Site Licensing
  • Server Deployment Options
  • Consulting
  • Wolfram Consulting
  • Repositories
  • Data Repository
  • Function Repository
  • Community Paclet Repository
  • Neural Net Repository
  • Prompt Repository

  • Wolfram Language Example Repository
  • Notebook Archive
  • Wolfram GitHub
  • Learning
  • Wolfram U
  • Wolfram Language Documentation
  • Webinars & Training
  • Educational Programs

  • Wolfram Language Introduction
  • Fast Introduction for Programmers
  • Fast Introduction for Math Students
  • Books

  • Wolfram Community
  • Wolfram Blog
  • Public Resources
  • Wolfram|Alpha
  • Wolfram Problem Generator
  • Wolfram Challenges

  • Computer-Based Math
  • Computational Thinking
  • Computational Adventures

  • Demonstrations Project
  • Wolfram Data Drop
  • MathWorld
  • Wolfram Science
  • Wolfram Media Publishing
  • Customer Resources
  • Store
  • Product Downloads
  • User Portal
  • Your Account
  • Organization Access

  • Support FAQ
  • Contact Support
  • Company
  • About Wolfram
  • Careers
  • Contact
  • Events
Wolfram Community Wolfram Blog
Legal & Privacy Policy
WolframAlpha.com | WolframCloud.com
© 2026 Wolfram
© 2026 Wolfram | Legal & Privacy Policy |
English