submission for peer assessment

Author: Jerome Jia

.gitignore

@@ -0,0 +1,3 @@
+.Rproj.user
+.Rhistory
+.RData

cachematrix.R

@@ -1,15 +1,40 @@
-## Put comments here that give an overall description of what your
-## functions do
+## A set of functions that aids frequent access of results of matrix inversion operations,
+## best fit for matrices with large dimensions.
 
-## Write a short comment describing this function
+## Function to create a special matrix whose inversion is cached for subsequent access
 
 makeCacheMatrix <- function(x = matrix()) {
-
+    i <- NULL
+    set <- function(y) {
+        x <<- y
+        i <<- NULL
+    }
+    get <- function() x
+    setinv <- function(inv) i <<- inv
+    getinv <- function() i
+    list(set = set, get = get,
+         setinv = setinv,
+         getinv = getinv)
 }
 
 
-## Write a short comment describing this function
+## Function to retrieve the inversion of any matrix created via makeCacheMatrix if already
+## cached, otherwise calculcates the inversion and cache it for the matrix
 
 cacheSolve <- function(x, ...) {
-        ## Return a matrix that is the inverse of 'x'
+    ## returns NA if x is not properly created via makeCacheMatrix
+    if(!"getinv" %in% names(x) | !"setinv" %in% names(x)) {
+        warning("input matrix not wrapped by makeCacheMatrix")
+        return(NA)
+    }
+    ## Return a matrix that is the inverse of 'x'
+    i <- x$getinv()
+    if(!is.null(i)) {
+        message("getting cached data")
+        return(i)
+    }
+    data <- x$get()
+    i <- solve(data, ...) %*% data
+    x$setinv(i)
+    i
 }