Fixed a performance bug that was forcing too many recalculations of the covariance...
[openmx:openmx.git] / src / omxMatrix.c
1 /*
2  *  Copyright 2007-2009 The OpenMx Project
3  *
4  *  Licensed under the Apache License, Version 2.0 (the "License");
5  *  you may not use this file except in compliance with the License.
6  *  You may obtain a copy of the License at
7  *
8  *       http://www.apache.org/licenses/LICENSE-2.0
9  *
10  *  Unless required by applicable law or agreed to in writing, software
11  *  distributed under the License is distributed on an "AS IS" BASIS,
12  *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13  *  See the License for the specific language governing permissions and
14  *  limitations under the License.
15  */
16
17 /***********************************************************
18 *
19 *  omxMatrix.cc
20 *
21 *  Created: Timothy R. Brick    Date: 2008-11-13 12:33:06
22 *
23 *       Contains code for the omxMatrix class
24 *   omxDataMatrices hold necessary information to simplify
25 *       dealings between the OpenMX back end and BLAS.
26 *
27 **********************************************************/
28 #include "omxMatrix.h"
29
30 const char omxMatrixMajorityList[3] = "Tn";             // BLAS Column Majority.
31
32 void omxPrintMatrix(omxMatrix *source, char* header) {
33         int j, k;
34
35         Rprintf("%s: (%d x %d) [%s-major]\n", header, source->rows, source->cols, (source->colMajor?"col":"row"));
36         if(OMX_DEBUG_MATRIX) {Rprintf("Matrix Printing is at %0x\n", source);}
37
38         if(source->colMajor) {
39                 for(j = 0; j < source->rows; j++) {
40                         for(k = 0; k < source->cols; k++) {
41                                 Rprintf("\t%3.6f", source->data[k*source->rows+j]);
42                         }
43                         Rprintf("\n");
44                 }
45         } else {
46                 for(j = 0; j < source->cols; j++) {
47                         for(k = 0; k < source->rows; k++) {
48                                 Rprintf("\t%3.6f", source->data[k*source->cols+j]);
49                         }
50                         Rprintf("\n");
51                 }
52         }
53 }
54
55 omxMatrix* omxInitMatrix(omxMatrix* om, int nrows, int ncols, unsigned short isColMajor, omxState* os) {
56
57         if(om == NULL) om = (omxMatrix*) R_alloc(1, sizeof(omxMatrix));
58         if(OMX_DEBUG_MATRIX) { Rprintf("Initializing matrix 0x%0x to (%d, %d) with state at 0x%x.\n", om, nrows, ncols, os); }
59
60         om->rows = nrows;
61         om->cols = ncols;
62         om->colMajor = (isColMajor?1:0);
63
64         om->originalRows = om->rows;
65         om->originalCols = om->cols;
66         om->originalColMajor=om->colMajor;
67
68         if(om->rows == 0 || om->cols == 0) {
69                 om->data = NULL;
70                 om->localData = FALSE;
71         } else {
72                 om->data = (double*) Calloc(nrows * ncols, double);
73                 om->localData = TRUE;
74         }
75
76         om->populateFrom = NULL;
77         om->populateFromCol = NULL;
78         om->populateFromRow = NULL;
79         om->populateToCol = NULL;
80         om->populateToRow = NULL;
81
82         om->numPopulateLocations = 0;
83
84         om->aliasedPtr = NULL;
85         om->algebra = NULL;
86         om->objective = NULL;
87
88         om->currentState = os;
89         om->lastCompute = -2;
90         om->lastRow = -2;
91         om->isTemporary = FALSE;
92
93         omxMatrixCompute(om);
94
95         return om;
96
97 }
98
99 omxMatrix* omxInitTemporaryMatrix(omxMatrix* om, int nrows, int ncols, unsigned short isColMajor, omxState* os) {
100
101         if(om == NULL) {
102                 om = (omxMatrix*) Calloc(1, omxMatrix);
103         }
104
105         om = omxInitMatrix(om, nrows, ncols, isColMajor, os);
106         om->isTemporary = TRUE;
107         
108         return(om);
109
110 }
111
112 void omxCopyMatrix(omxMatrix *dest, omxMatrix *orig) {
113         /* Duplicate a matrix.  NOTE: Matrix maintains its algebra bindings. */
114
115         if(OMX_DEBUG_MATRIX || OMX_DEBUG_ALGEBRA) { Rprintf("omxCopyMatrix"); }
116
117         int regenerateMemory = TRUE;
118
119         if(dest->localData && (dest->originalRows == orig->rows && dest->originalCols == orig->cols)) {
120                 regenerateMemory = FALSE;                               // If it's local data and the right size, we can keep memory.
121         }
122
123         dest->rows = orig->rows;
124         dest->cols = orig->cols;
125         dest->colMajor = orig->colMajor;
126         dest->originalRows = dest->rows;
127         dest->originalCols = dest->cols;
128         dest->originalColMajor = dest->colMajor;
129         dest->currentState = orig->currentState;
130         dest->lastCompute = orig->lastCompute;
131         dest->lastRow = orig->lastRow;
132
133         if(dest->rows == 0 || dest->cols == 0) {
134                 omxFreeMatrixData(dest);
135                 dest->data = NULL;
136                 dest->localData=FALSE;
137         } else {
138                 if(regenerateMemory) {
139                         omxFreeMatrixData(dest);                                                                                        // Free and regenerate memory
140                         dest->data = (double*) Calloc(dest->rows * dest->cols, double);
141                 }
142                 memcpy(dest->data, orig->data, dest->rows * dest->cols * sizeof(double));
143                 dest->localData = TRUE;
144         }
145
146         dest->aliasedPtr = NULL;
147
148         omxMatrixCompute(dest);
149
150 }
151
152 void omxAliasMatrix(omxMatrix *dest, omxMatrix *src) {
153         omxCopyMatrix(dest, src);
154         dest->aliasedPtr = src;                                 // Alias now follows back matrix precisely.
155         dest->algebra = NULL;                                   // Have to look at how this effect interacts with populating
156         dest->objective = NULL;                                 //              matrix values to other locations.
157 }
158
159 void omxFreeMatrixData(omxMatrix * om) {
160
161         if(om->localData && om->data != NULL) {
162                 if(OMX_DEBUG_MATRIX) { Rprintf("Freeing matrix at 0x%0x. Localdata = %d.\n", om->data, om->localData); }
163                 Free(om->data);
164                 om->data = NULL;
165                 om->localData = FALSE;
166         }
167
168 }
169
170 void omxFreeAllMatrixData(omxMatrix *om) {
171
172         if(OMX_DEBUG) { Rprintf("Freeing matrix at 0x%0x with data = %0x and algebra %0x.\n", om, om->data, om->algebra); }
173
174         if(om->localData && om->data != NULL) {
175                 Free(om->data);
176                 om->data = NULL;
177                 om->localData = FALSE;
178         }
179
180         if(om->algebra != NULL) {
181                 omxFreeAlgebraArgs(om->algebra);
182                 om->algebra = NULL;
183         }
184
185         if(om->objective != NULL) {
186                 omxFreeObjectiveArgs(om->objective);
187                 om->objective = NULL;
188         }
189         
190         if(om->isTemporary) {
191                 Free(om);
192                 om = NULL;
193         }
194
195 }
196
197 void omxZeroByZeroMatrix(omxMatrix *om) {
198         if (om->rows > 0 || om->cols > 0) {
199                 omxResizeMatrix(om, 0, 0, FALSE);
200         }
201 }
202
203 omxMatrix* omxNewIdentityMatrix(int nrows, omxState* state) {
204         omxMatrix* newMat = NULL;
205         int l,k;
206
207         newMat = omxInitMatrix(newMat, nrows, nrows, FALSE, state);
208         for(k =0; k < newMat->rows; k++) {
209                 for(l = 0; l < newMat->cols; l++) {
210                         if(l == k) {
211                                 omxSetMatrixElement(newMat, k, l, 1);
212                         } else {
213                                 omxSetMatrixElement(newMat, k, l, 0);
214                         }
215                 }
216         }
217         return newMat;
218 }
219
220 void omxResizeMatrix(omxMatrix *om, int nrows, int ncols, unsigned short keepMemory) {
221         // Always Recompute() before you Resize().
222         if(OMX_DEBUG_MATRIX) { Rprintf("Resizing matrix from (%d, %d) to (%d, %d) (keepMemory: %d)", om->rows, om->cols, nrows, ncols, keepMemory); }
223         if(keepMemory == FALSE) {
224                 if(OMX_DEBUG_MATRIX) { Rprintf(" and regenerating memory to do it"); }
225                 omxFreeMatrixData(om);
226                 om->data = (double*) Calloc(nrows * ncols, double);
227                 om->localData = TRUE;
228         } else if(om->originalRows * om->originalCols < nrows * ncols) {
229                 warning("Upsizing an existing matrix may cause undefined behavior.\n"); // TODO: Define this behavior?
230         }
231
232         if(OMX_DEBUG_MATRIX) { Rprintf(".\n"); }
233         om->rows = nrows;
234         om->cols = ncols;
235         if(keepMemory == FALSE) {
236                 om->originalRows = om->rows;
237                 om->originalCols = om->cols;
238         }
239
240         omxMatrixCompute(om);
241 }
242
243 void omxResetAliasedMatrix(omxMatrix *om) {
244         om->rows = om->originalRows;
245         om->cols = om->originalCols;
246         if(om->aliasedPtr != NULL) {
247                 memcpy(om->data, om->aliasedPtr->data, om->rows*om->cols*sizeof(double));
248                 om->colMajor = om->aliasedPtr->colMajor;
249         }
250         omxMatrixCompute(om);
251 }
252
253 void omxMatrixCompute(omxMatrix *om) {
254
255         if(OMX_DEBUG_MATRIX) { Rprintf("Matrix compute: 0x%0x, 0x%0x, algebra: 0x%x.\n", om, om->currentState, om->algebra); }
256         om->majority = &(omxMatrixMajorityList[(om->colMajor?1:0)]);
257         om->minority = &(omxMatrixMajorityList[(om->colMajor?0:1)]);
258         om->leading = (om->colMajor?om->rows:om->cols);
259         om->lagging = (om->colMajor?om->cols:om->rows);
260
261         for(int i = 0; i < om->numPopulateLocations; i++) {
262                 omxRecompute(om->populateFrom[i]);                              // Make sure it's up to date
263                 double value = omxMatrixElement(om->populateFrom[i], om->populateFromRow[i], om->populateFromCol[i]);
264                 omxSetMatrixElement(om, om->populateToRow[i], om->populateToCol[i], value);
265                 // And then fill in the details.  Use the Helper here in case of transposition/downsampling.
266         }
267
268         om->isDirty = FALSE;
269         om->lastCompute = om->currentState->computeCount;
270         om->lastRow = om->currentState->currentRow;
271
272 }
273
274 double* omxLocationOfMatrixElement(omxMatrix *om, int row, int col) {
275         int index = 0;
276         if(om->colMajor) {
277                 index = col * om->rows + row;
278         } else {
279                 index = row * om->cols + col;
280         }
281         return om->data + index;
282 }
283
284 void vectorElementError(int index, int numrow, int numcol) {
285         char *errstr = calloc(250, sizeof(char));
286         sprintf(errstr, "Requested improper index (%d) from (%d, %d) vector.", 
287                 index, numrow, numcol);
288         error(errstr);
289         free(errstr);
290 }
291
292 void setMatrixError(int row, int col, int numrow, int numcol) {
293         char *errstr = calloc(250, sizeof(char));
294         sprintf(errstr, "Attempted to set improper value (%d, %d) into (%d, %d) matrix.", 
295                 row, col, numrow, numcol);
296         error(errstr);
297         free(errstr);
298 }
299
300 void matrixElementError(int row, int col, int numrow, int numcol) {
301         char *errstr = calloc(250, sizeof(char));
302         sprintf(errstr, "Requested improper value (%d, %d) from (%d, %d) matrix.",
303                 row, col, numrow, numcol);
304         error(errstr);
305         free(errstr);
306 }
307
308 void setVectorError(int index, int numrow, int numcol) {
309         char *errstr = calloc(250, sizeof(char));
310         sprintf(errstr, "Setting improper index (%d) from (%d, %d) vector.", 
311                 index, numrow, numcol);
312         error(errstr);
313         free(errstr);
314 }
315
316 double omxAliasedMatrixElement(omxMatrix *om, int row, int col) {
317         int index = 0;
318         if(row >= om->originalRows || col >= om->originalCols) {
319                 char *errstr = calloc(250, sizeof(char));
320                 sprintf(errstr, "Requested improper value (%d, %d) from (%d, %d) matrix.", row+1, col+1, om->originalRows, om->originalCols);
321                 error(errstr);
322                 free(errstr);
323         return (NA_REAL);
324         }
325         if(om->colMajor) {
326                 index = col * om->originalRows + row;
327         } else {
328                 index = row * om->originalCols + col;
329         }
330         return om->data[index];
331 }
332
333 void omxMarkDirty(omxMatrix *om) { om->isDirty = TRUE; }
334
335 unsigned short omxMatrixNeedsUpdate(omxMatrix *om) {
336         for(int i = 0; i < om->numPopulateLocations; i++) {
337                 if(omxNeedsUpdate(om->populateFrom[i])) return TRUE;    // Make sure it's up to date
338         }
339     return FALSE;
340 };
341
342 omxMatrix* omxNewMatrixFromMxMatrix(SEXP mxMatrix, omxState* state) {
343 /* Creates and populates an omxMatrix with details from an R Matrix. */
344
345         omxMatrix *om = NULL;
346         om = omxInitMatrix(NULL, 0, 0, FALSE, state);
347         return omxFillMatrixFromMxMatrix(om, mxMatrix, state);
348
349 }
350
351 omxMatrix* omxFillMatrixFromMxMatrix(omxMatrix* om, SEXP mxMatrix, omxState* state) {
352 /* Populates the fields of a omxMatrix with details from an R Matrix. */
353
354         SEXP matrixDims;
355         SEXP matrix = mxMatrix;
356         int* dimList;
357         unsigned short int isMxMatrix = FALSE;
358
359         if(OMX_DEBUG) { Rprintf("Filling omxMatrix from R matrix.\n"); }
360
361         if(om == NULL) {
362                 om = omxInitMatrix(NULL, 0, 0, FALSE, state);
363         }
364
365         if(!isMatrix(mxMatrix) && !isVector(mxMatrix)) { // Sanity Check
366                 if(OMX_DEBUG) { Rprintf("R matrix is an object of some sort.\n"); }
367                 if(inherits(mxMatrix, "MxMatrix")) {
368                         if(OMX_DEBUG) { Rprintf("R matrix is Mx Matrix.  Processing.\n"); }
369                         PROTECT(matrix = GET_SLOT(mxMatrix,  install("values")));
370                         isMxMatrix = TRUE; // So we remember to unprotect.
371                 } else {
372                         error("Recieved unknown matrix type.");
373                 }
374         }
375
376         om->data = REAL(AS_NUMERIC(matrix));    // TODO: Class-check first?
377
378         if(isMatrix(matrix)) {
379                 PROTECT(matrixDims = getAttrib(matrix, R_DimSymbol));
380                 dimList = INTEGER(matrixDims);
381                 om->rows = dimList[0];
382                 om->cols = dimList[1];
383                 UNPROTECT(1);   // MatrixDims
384         } else if (isVector(matrix)) {          // If it's a vector, assume it's a row vector. BLAS doesn't care.
385                 if(OMX_DEBUG) { Rprintf("Vector discovered.  Assuming rowity.\n"); }
386                 om->rows = 1;
387                 om->cols = length(matrix);
388         }
389         if(OMX_DEBUG) { Rprintf("Matrix connected to (%d, %d) mxMatrix.\n", om->rows, om->cols); }
390
391         om->localData = FALSE;
392         om->colMajor = TRUE;
393         om->originalRows = om->rows;
394         om->originalCols = om->cols;
395         om->originalColMajor = TRUE;
396         om->aliasedPtr = NULL;
397         om->algebra = NULL;
398         om->objective = NULL;
399         om->currentState = state;
400         om->lastCompute = -1;
401         om->lastRow = -1;
402
403         if(OMX_DEBUG) { Rprintf("Pre-compute call.\n");}
404         omxMatrixCompute(om);
405         if(OMX_DEBUG) { Rprintf("Post-compute call.\n");}
406
407         if(OMX_DEBUG) {
408                 omxPrintMatrix(om, "Finished importing matrix");
409         }
410
411         if(isMxMatrix) {
412                 UNPROTECT(1); // matrix
413         }
414
415         return om;
416 }
417
418 void omxProcessMatrixPopulationList(omxMatrix* matrix, SEXP matStruct) {
419
420         if(OMX_DEBUG) { Rprintf("Processing Population List: %d elements.\n", length(matStruct) - 1); }
421         SEXP subList;
422
423         if(length(matStruct) > 1) {
424                 int numPopLocs = length(matStruct) - 1;
425                 matrix->numPopulateLocations = numPopLocs;
426                 matrix->populateFrom = (omxMatrix**)R_alloc(numPopLocs, sizeof(omxMatrix*));
427                 matrix->populateFromRow = (int*)R_alloc(numPopLocs, sizeof(int));
428                 matrix->populateFromCol = (int*)R_alloc(numPopLocs, sizeof(int));
429                 matrix->populateToRow = (int*)R_alloc(numPopLocs, sizeof(int));
430                 matrix->populateToCol = (int*)R_alloc(numPopLocs, sizeof(int));
431         }
432
433         for(int i = 0; i < length(matStruct)-1; i++) {
434                 PROTECT(subList = AS_INTEGER(VECTOR_ELT(matStruct, i+1)));
435
436                 int* locations = INTEGER(subList);
437                 int loc = locations[0];
438                 if(OMX_DEBUG) { Rprintf("."); } //:::
439                 if(loc < 0) {                   // NOTE: This duplicates some of the functionality of NewMatrixFromMxIndex
440                         matrix->populateFrom[i] = matrix->currentState->matrixList[(~loc)];
441                 } else {
442                         matrix->populateFrom[i] = matrix->currentState->algebraList[(loc)];
443                 }
444                 matrix->populateFromRow[i] = locations[1];
445                 matrix->populateFromCol[i] = locations[2];
446                 matrix->populateToRow[i] = locations[3];
447                 matrix->populateToCol[i] = locations[4];
448
449                 UNPROTECT(1); // subList
450         }
451 }
452
453 void omxTransposeMatrix(omxMatrix *mat) {
454         mat->colMajor = !mat->colMajor;
455         omxMatrixCompute(mat);
456 }
457
458 void omxRemoveRowsAndColumns(omxMatrix *om, int numRowsRemoved, int numColsRemoved, int rowsRemoved[], int colsRemoved[])
459 {
460 //      if(OMX_DEBUG_MATRIX) { Rprintf("Removing %d rows and %d columns from 0x%0x.\n", numRowsRemoved, numColsRemoved, om);}
461
462         if(numRowsRemoved < 1 && numColsRemoved < 1) { return; }
463
464         int oldRows, oldCols;
465
466         if(om->aliasedPtr == NULL) {
467                 if(om->originalRows == 0 || om->originalCols == 0) {
468                         om->originalRows = om->rows;
469                         om->originalCols = om->cols;
470                 }
471                 oldRows = om->originalRows;
472                 oldCols = om->originalCols;
473         } else {
474                 oldRows = om->aliasedPtr->rows;
475                 oldCols = om->aliasedPtr->cols;
476         }
477
478         int nextCol = 0;
479         int nextRow = 0;
480
481         if(om->rows > om->originalRows || om->cols > om->originalCols) {        // sanity check.
482                 error("Aliased Matrix is too small for alias.");
483         }
484
485         om->rows = oldRows - numRowsRemoved;
486         om->cols = oldCols - numColsRemoved;
487
488         // Note:  This really aught to be done using a matrix multiply.  Why isn't it?
489         for(int j = 0; j < oldCols; j++) {
490                 if(OMX_DEBUG_MATRIX || OMX_DEBUG_ALGEBRA) { Rprintf("Handling column %d/%d...", j, oldCols);}
491                 if(colsRemoved[j]) {
492                         if(OMX_DEBUG_MATRIX || OMX_DEBUG_ALGEBRA) { Rprintf("Removed.\n");}
493                         continue;
494                 } else {
495                         nextRow = 0;
496                         if(OMX_DEBUG_MATRIX || OMX_DEBUG_ALGEBRA) { Rprintf("Rows (max %d): ", oldRows); }
497                         for(int k = 0; k < oldRows; k++) {
498                                 if(rowsRemoved[k]) {
499                                         if(OMX_DEBUG_MATRIX || OMX_DEBUG_ALGEBRA) { Rprintf("%d removed....", k);}
500                                         continue;
501                                 } else {
502                                         if(OMX_DEBUG_MATRIX || OMX_DEBUG_ALGEBRA) { Rprintf("%d kept....", k);}
503                                         if(om->aliasedPtr == NULL) {
504                                                 if(OMX_DEBUG_MATRIX || OMX_DEBUG_ALGEBRA) { Rprintf("Self-aliased matrix access.\n");}
505                                                 omxSetMatrixElement(om, nextRow, nextCol, omxAliasedMatrixElement(om, k, j));
506                                         } else {
507                                                 if(OMX_DEBUG_MATRIX || OMX_DEBUG_ALGEBRA) { Rprintf("Matrix 0x%x re-aliasing to 0x%x.\n", om, om->aliasedPtr);}
508                                                 omxSetMatrixElement(om, nextRow, nextCol, omxMatrixElement(om->aliasedPtr, k,  j));
509                                         }
510                                         if(OMX_DEBUG_MATRIX || OMX_DEBUG_ALGEBRA) {
511                                                 omxPrint(om, "Now Reads: (:::DEBUG:::)");
512                                         }
513                                         nextRow++;
514                                 }
515                         }
516                         if(OMX_DEBUG_MATRIX || OMX_DEBUG_ALGEBRA) { Rprintf("\n");}
517                         nextCol++;
518                 }
519         }
520
521         omxMatrixCompute(om);
522 }
523
524 /* Function wrappers that switch based on inclusion of algebras */
525 void omxPrint(omxMatrix *source, char* d) {                                     // Pretty-print a (small) matrix
526         if(source->algebra != NULL) omxAlgebraPrint(source->algebra, d);
527         else if(source->objective != NULL) omxObjectivePrint(source->objective, d);
528         else omxPrintMatrix(source, d);
529 }
530
531 unsigned short omxNeedsUpdate(omxMatrix *matrix) {
532         unsigned short retval;
533         /* Simplest update check: If we're dirty or haven't computed this cycle (iteration or row), we need to. */
534         // TODO : Implement a dependency-tree-based dirtiness propagation system
535         if(OMX_DEBUG_MATRIX) {Rprintf("Matrix 0x%x NeedsUpdate?", matrix);}
536
537         if(matrix == NULL) {
538                 if(OMX_DEBUG_MATRIX) {Rprintf("matrix argument is NULL. ");}
539                 retval = FALSE;         // Not existing means never having to say you need to recompute.
540         } else if(matrix->isDirty) {
541                 if(OMX_DEBUG_MATRIX) {Rprintf("matrix is dirty. ");}
542                 retval = TRUE;
543         } else if(matrix->lastCompute < matrix->currentState->computeCount) {
544                 if(OMX_DEBUG_MATRIX) {Rprintf("matrix last compute is less than current compute count. ");}
545                 retval = TRUE;          // No need to check args if oa's dirty.
546         } else if(matrix->lastRow != matrix->currentState->currentRow) {
547                 if(OMX_DEBUG_MATRIX) {Rprintf("matrix last row is less than current row. ");}
548                 retval = TRUE;                  // Ditto.
549         } else if(matrix->algebra != NULL) {
550                 if(OMX_DEBUG_MATRIX) {Rprintf("checking algebra needs update. ");}
551                 retval = omxAlgebraNeedsUpdate(matrix->algebra);
552         } else if(matrix->objective != NULL) {
553                 if(OMX_DEBUG_MATRIX) {Rprintf("checking objective function needs update. ");}
554                 retval = omxObjectiveNeedsUpdate(matrix->objective);
555         } else {
556                 if(OMX_DEBUG_MATRIX) {Rprintf("checking matrix needs update. ");}
557                 retval = omxMatrixNeedsUpdate(matrix);
558         }
559         if(OMX_DEBUG_MATRIX && retval) {Rprintf("Yes.\n");}
560         if(OMX_DEBUG_MATRIX && !retval) {Rprintf("No.\n");}
561         return(retval);
562 }
563
564 void omxRecompute(omxMatrix *matrix) {
565         if(!omxNeedsUpdate(matrix)) return;
566         if(matrix->algebra != NULL) omxAlgebraCompute(matrix->algebra);
567         else if(matrix->objective != NULL) omxObjectiveCompute(matrix->objective);
568         else omxMatrixCompute(matrix);
569 }
570
571 void omxCompute(omxMatrix *matrix) {
572         if(matrix->algebra != NULL) omxAlgebraCompute(matrix->algebra);
573         else if(matrix->objective != NULL) omxObjectiveCompute(matrix->objective);
574         else omxMatrixCompute(matrix);
575 }