17f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/* 27f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project * Copyright (C) 2008 The Android Open Source Project 37f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project * 47f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project * Licensed under the Apache License, Version 2.0 (the "License"); 57f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project * you may not use this file except in compliance with the License. 67f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project * You may obtain a copy of the License at 77f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project * 87f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project * http://www.apache.org/licenses/LICENSE-2.0 97f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project * 107f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project * Unless required by applicable law or agreed to in writing, software 117f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project * distributed under the License is distributed on an "AS IS" BASIS, 127f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 137f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project * See the License for the specific language governing permissions and 147f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project * limitations under the License. 157f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project */ 167f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 177f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project#ifndef bts_INT32MAT_EM_H 187f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project#define bts_INT32MAT_EM_H 197f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 207f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/* ---- includes ----------------------------------------------------------- */ 217f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 227f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project#include "b_BasicEm/Int32Arr.h" 237f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 247f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/* ---- related objects --------------------------------------------------- */ 257f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 267f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/* ---- typedefs ----------------------------------------------------------- */ 277f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 287f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/* ---- constants ---------------------------------------------------------- */ 297f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 307f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/* data format version number */ 317f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project#define bts_INT32MAT_VERSION 100 327f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 337f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/* ---- object definition -------------------------------------------------- */ 347f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 357f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/** square matrix */ 367f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Projectstruct bts_Int32Mat 377f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project{ 387f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 397f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project /* ---- private data --------------------------------------------------- */ 407f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 417f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project /* ---- public data ---------------------------------------------------- */ 427f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 437f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project /* width = height of square matrix */ 447f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project uint32 widthE; 457f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 467f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project /* array of matrix elements (data is arranged by rows) */ 477f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project struct bbs_Int32Arr arrE; 487f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 497f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project}; 507f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 517f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/* ---- associated objects ------------------------------------------------- */ 527f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 537f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/* ---- external functions ------------------------------------------------- */ 547f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 557f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/* ---- \ghd{ constructor/destructor } ------------------------------------- */ 567f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 577f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/** initializes matrix */ 587f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Projectvoid bts_Int32Mat_init( struct bbs_Context* cpA, 597f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project struct bts_Int32Mat* ptrA ); 607f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 617f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/** destroys matric */ 627f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Projectvoid bts_Int32Mat_exit( struct bbs_Context* cpA, 637f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project struct bts_Int32Mat* ptrA ); 647f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 657f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/* ---- \ghd{ operators } -------------------------------------------------- */ 667f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 677f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/* copies matrices */ 687f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Projectvoid bts_Int32Mat_copy( struct bbs_Context* cpA, 697f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project struct bts_Int32Mat* ptrA, 707f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project const struct bts_Int32Mat* srcPtrA ); 717f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 727f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/* ---- \ghd{ query functions } -------------------------------------------- */ 737f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 747f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/* ---- \ghd{ modify functions } ------------------------------------------- */ 757f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 767f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/** allocates square matrix */ 777f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Projectvoid bts_Int32Mat_create( struct bbs_Context* cpA, 787f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project struct bts_Int32Mat* ptrA, 797f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project int32 widthA, 807f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project struct bbs_MemSeg* mspA ); 817f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 827f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/* ---- \ghd{ memory I/O } ------------------------------------------------- */ 837f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 847f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/** size object needs when written to memory */ 857f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Projectuint32 bts_Int32Mat_memSize( struct bbs_Context* cpA, 867f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project const struct bts_Int32Mat* ptrA ); 877f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 887f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/** writes object to memory; returns number of bytes written */ 897f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Projectuint32 bts_Int32Mat_memWrite( struct bbs_Context* cpA, 907f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project const struct bts_Int32Mat* ptrA, 917f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project uint16* memPtrA ); 927f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 937f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/** reads object from memory; returns number of bytes read */ 947f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Projectuint32 bts_Int32Mat_memRead( struct bbs_Context* cpA, 957f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project struct bts_Int32Mat* ptrA, 967f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project const uint16* memPtrA, 977f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project struct bbs_MemSeg* mspA ); 987f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 997f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/* ---- \ghd{ exec functions } --------------------------------------------- */ 1007f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 1017f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/** computes the solution to matrix * outVecA = inVecA, returns false if the 1027f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project * function was not successful; 1037f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project * internally calls solve2() which is overflow safe; 1047f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project * use large bbpA if you need high accuracy; 1057f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project * 1067f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project * matA: the square matrix, array of size ( matWidthA * matWidthA ) 1077f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project * matWidthA: width of the matrix 1087f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project * inVecA: array of size matWidthA 1097f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project * outVecA: array of size matWidthA 1107f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project * bbpA: bbp for all matrices and vectors 1117f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project * tmpMatA: matrix of same size as matA 1127f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project * tmpVecA: array of size matWidthA 1137f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project */ 1147f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Projectflag bts_Int32Mat_solve( struct bbs_Context* cpA, 1157f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project const int32* matA, 1167f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project int32 matWidthA, 1177f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project const int32* inVecA, 1187f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project int32* outVecA, 1197f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project int32 bbpA, 1207f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project int32* tmpMatA, 1217f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project int32* tmpVecA ); 1227f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 1237f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project/** same as _solve(), but matA gets overwritten, and tmpMatA is not needed: 1247f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project * saves memory when matA is large; 1257f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project * overflow safe; 1267f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project * use large bbpA if you need high accuracy; 1277f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project */ 1287f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Projectflag bts_Int32Mat_solve2( struct bbs_Context* cpA, 1297f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project int32* matA, 1307f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project int32 matWidthA, 1317f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project const int32* inVecA, 1327f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project int32* outVecA, 1337f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project int32 bbpA, 1347f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project int32* tmpVecA ); 1357f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 1367f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project#endif /* bts_INT32MAT_EM_H */ 1377f81d9b6fa7f2ec161b682622db577a28c90b49fThe Android Open Source Project 138