From 749ca60a097433c6374cc9d6e1c563d15c329522 Mon Sep 17 00:00:00 2001
From: Miguel Correia Ricardo <miguelcricardo@gmail.com>
Date: Tue, 22 Jul 2014 23:29:47 +0100
Subject: [PATCH 1/2] Implementation of cached matrix

---
 cachematrix.R | 40 +++++++++++++++++++++++++++++++++-------
 1 file changed, 33 insertions(+), 7 deletions(-)

diff --git a/cachematrix.R b/cachematrix.R
index a50be65aa44..b04d9a6e0ca 100644
--- a/cachematrix.R
+++ b/cachematrix.R
@@ -1,15 +1,41 @@
-## Put comments here that give an overall description of what your
-## functions do
-
-## Write a short comment describing this function
+## makeCacheMatrix(x) an optional matrix definition
+## Purpose: a constructor of "cached" matrices
+## Usage example:
+## 1) m <- makeCacheMatrix() to instantiate an empty matrix 
+## or 
+## 2) m <- makeCacheMatrix(matrix(...))) to instatiate with a pre-defined matrix
+## 
+## For either the 1) or 2) case you can always (re-)define the cached matrix by using the "set" method:
+## m$set(matrix(...))
 
 makeCacheMatrix <- function(x = matrix()) {
-
+  i <- NULL
+  set <- function(y) {
+    x <<- y
+    i <<- NULL
+  }
+  get <- function() x
+  setinverse <- function(inverse) i <<- inverse
+  getinverse <- function() i
+  list(set = set, get = get,
+       setinverse = setinverse,
+       getinverse = getinverse)
 }
 
 
-## Write a short comment describing this function
+## cacheSolve(x, ...) where x is a "cached" matrix and "..." are additional arguments that can be passed to the "solve" method.
+## Purpose: a solver of "cached" matrices. The first time its called it solves the inverse of the matrix, in subsequent calls a cached result is returned.
+## Usage example:
+## result <- cacheSolve(m) where m is "cached" matrix instatiated with the method "makeCacheMatrix"
 
 cacheSolve <- function(x, ...) {
-        ## Return a matrix that is the inverse of 'x'
+  i <- x$getinverse()
+  if(!is.null(i)) {
+    message("getting cached data")
+    return(i)
+  }
+  data <- x$get()
+  i <- solve(data, ...)
+  x$setinverse(i)
+  i
 }

From 173a06aa7e36e60ed24fd3b4949e0ab7370f6c43 Mon Sep 17 00:00:00 2001
From: Miguel Correia Ricardo <miguelcricardo@gmail.com>
Date: Sun, 27 Jul 2014 22:17:35 +0100
Subject: [PATCH 2/2] Implementation of cached matrix

---
 cachematrix.R | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/cachematrix.R b/cachematrix.R
index b04d9a6e0ca..ad35bfa62e3 100644
--- a/cachematrix.R
+++ b/cachematrix.R
@@ -1,5 +1,7 @@
-## makeCacheMatrix(x) an optional matrix definition
+## makeCacheMatrix(x)
 ## Purpose: a constructor of "cached" matrices
+## Parameters: x is an optional matrix definition
+## Output: "cached" matrix
 ## Usage example:
 ## 1) m <- makeCacheMatrix() to instantiate an empty matrix 
 ## or 
@@ -23,8 +25,10 @@ makeCacheMatrix <- function(x = matrix()) {
 }
 
 
-## cacheSolve(x, ...) where x is a "cached" matrix and "..." are additional arguments that can be passed to the "solve" method.
+## cacheSolve(x, ...)
 ## Purpose: a solver of "cached" matrices. The first time its called it solves the inverse of the matrix, in subsequent calls a cached result is returned.
+## Parameters:  x is a "cached" matrix and "..." are additional arguments that can be passed to the "solve" method.
+## Output: inverse of a matrix
 ## Usage example:
 ## result <- cacheSolve(m) where m is "cached" matrix instatiated with the method "makeCacheMatrix"