1 /*M///////////////////////////////////////////////////////////////////////////////////////
3 // IMPORTANT: READ BEFORE DOWNLOADING, COPYING, INSTALLING OR USING.
5 // By downloading, copying, installing or using the software you agree to this license.
6 // If you do not agree to this license, do not download, install,
7 // copy or use the software.
10 // Intel License Agreement
12 // Copyright (C) 2000, Intel Corporation, all rights reserved.
13 // Third party copyrights are property of their respective owners.
15 // Redistribution and use in source and binary forms, with or without modification,
16 // are permitted provided that the following conditions are met:
18 // * Redistribution's of source code must retain the above copyright notice,
19 // this list of conditions and the following disclaimer.
21 // * Redistribution's in binary form must reproduce the above copyright notice,
22 // this list of conditions and the following disclaimer in the documentation
23 // and/or other materials provided with the distribution.
25 // * The name of Intel Corporation may not be used to endorse or promote products
26 // derived from this software without specific prior written permission.
28 // This software is provided by the copyright holders and contributors "as is" and
29 // any express or implied warranties, including, but not limited to, the implied
30 // warranties of merchantability and fitness for a particular purpose are disclaimed.
31 // In no event shall the Intel Corporation or contributors be liable for any direct,
32 // indirect, incidental, special, exemplary, or consequential damages
33 // (including, but not limited to, procurement of substitute goods or services;
34 // loss of use, data, or profits; or business interruption) however caused
35 // and on any theory of liability, whether in contract, strict liability,
36 // or tort (including negligence or otherwise) arising in any way out of
37 // the use of this software, even if advised of the possibility of such damage.
43 /* Blob (foreground-pixel connected-component) tracking with collision resolution.
45 * For entrypoints into the literature see:
47 * A Tutorial on Particle Filters for Online Nonlinear/Non-Gaussian Bayesian Tracking
48 * Arulampalam &t al, 2001, 15p
49 * http://www-clmc.usc.edu/publications/A/arulampalam-TSP2002.pdf
51 * Particle Filters for Positioning, Navigation, and Tracking
52 * Gustafsson et al, 2002 12p
53 * http://www.control.isy.liu.se/~fredrik/reports/01SPpf4pos.pdf
55 * Particle Filtering in High Clutter Environments
56 * Korhonen et al, 2005 4p
57 * http://www.cs.uku.fi/finsig05/papers/paper26_FINSIG05.pdf
59 * Appearance Models for Occlusion Handling
60 * Andrew Senior &t al, 8p 2001
61 * http://www.research.ibm.com/peoplevision/PETS2001.pdf
65 /*============== BLOB TRACKERCC CLASS DECLARATION =============== */
66 typedef struct DefBlobTrackerCR
69 CvBlobTrackPredictor* pPredictor;
74 CvBlobTrackerOne* pResolver;
77 void cvFindBlobsByCCClasters(IplImage* pFG, CvBlobSeq* pBlobs, CvMemStorage* storage);
79 class CvBlobTrackerCCCR : public CvBlobTracker
85 CvBlobSeq m_BlobListNew;
87 CvBlobTrackerOne* (*m_CreateCR)();
88 char m_ModuleName[1024];
92 CvBlobTrackerCCCR(CvBlobTrackerOne* (*CreateCR)(), char* CRName):m_BlobList(sizeof(DefBlobTrackerCR))
94 m_CreateCR = CreateCR;
95 m_pMem = cvCreateMemStorage();
97 m_Collision = 1; /* if 1 then collistion will be detected and processed */
100 AddParam("AlphaSize",&m_AlphaSize);
101 CommentParam("AlphaSize", "Size update speed (0..1)");
103 strcpy(m_ModuleName, "CC");
104 if(CRName)strcat(m_ModuleName,CRName);
105 SetModuleName(m_ModuleName);
108 CvBlobTrackerOne* pM = m_CreateCR();
109 TransferParamsFromChild(pM,NULL);
112 SetParam("SizeVar",0);
117 if(m_pMem)cvReleaseMemStorage(&m_pMem);
120 /* Blob functions: */
121 virtual int GetBlobNum() {return m_BlobList.GetBlobNum();};
122 virtual CvBlob* GetBlob(int BlobIndex){return m_BlobList.GetBlob(BlobIndex);};
123 virtual void SetBlob(int BlobIndex, CvBlob* pBlob)
125 CvBlob* pB = m_BlobList.GetBlob(BlobIndex);
126 if(pB) pB[0] = pBlob[0];
129 virtual CvBlob* GetBlobByID(int BlobID){return m_BlobList.GetBlobByID(BlobID);};
130 virtual void DelBlob(int BlobIndex)
132 DefBlobTrackerCR* pBT = (DefBlobTrackerCR*)m_BlobList.GetBlob(BlobIndex);
133 if(pBT->pResolver)pBT->pResolver->Release();
134 if(pBT->pPredictor)pBT->pPredictor->Release();
135 delete pBT->pBlobHyp;
136 m_BlobList.DelBlob(BlobIndex);
139 virtual void DelBlobByID(int BlobID)
141 DefBlobTrackerCR* pBT = (DefBlobTrackerCR*)m_BlobList.GetBlobByID(BlobID);
142 if(pBT->pResolver)pBT->pResolver->Release();
143 if(pBT->pPredictor)pBT->pPredictor->Release();
144 delete pBT->pBlobHyp;
145 m_BlobList.DelBlobByID(BlobID);
148 virtual void Release(){delete this;};
150 /* Add new blob to track it and assign to this blob personal ID */
151 /* pBlob - pinter to structure with blob parameters (ID is ignored)*/
152 /* pImg - current image */
153 /* pImgFG - current foreground mask */
154 /* Return pointer to new added blob: */
155 virtual CvBlob* AddBlob(CvBlob* pB, IplImage* pImg, IplImage* pImgFG = NULL )
157 DefBlobTrackerCR NewB;
159 NewB.pBlobHyp = new CvBlobSeq;
160 NewB.pPredictor = cvCreateModuleBlobTrackPredictKalman(); /* module for predict position */
161 NewB.pPredictor->SetParam("DataNoisePos",0.001);
162 NewB.pPredictor->ParamUpdate();
163 NewB.pResolver = NULL;
166 NewB.pResolver = m_CreateCR();
167 TransferParamsToChild(NewB.pResolver,NULL);
168 NewB.pResolver->Init(pB, pImg, pImgFG);
170 m_BlobList.AddBlob((CvBlob*)&NewB);
171 return m_BlobList.GetBlob(m_BlobList.GetBlobNum()-1);
174 virtual void Process(IplImage* pImg, IplImage* pImgFG = NULL)
181 if(m_BlobList.GetBlobNum() <= 0 ) return;
183 /* Clear blob list for new blobs: */
184 m_BlobListNew.Clear();
187 cvClearMemStorage(m_pMem);
190 { /* One contour - one blob: */
191 IplImage* pBin = cvCloneImage(pImgFG);
193 cvThreshold(pBin,pBin,128,255,CV_THRESH_BINARY);
194 cvFindContours(pBin, m_pMem, &cnts, sizeof(CvContour), CV_RETR_EXTERNAL);
196 /* Process each contour: */
197 for(cnt = cnts; cnt; cnt=cnt->h_next)
202 double M00,X,Y,XX,YY;
204 CvRect r = ((CvContour*)cnt)->rect;
206 if(r.height < 3 || r.width < 3) continue;
207 cvMoments( cvGetSubRect(pImgFG,&mat,r), &m, 0 );
208 M00 = cvGetSpatialMoment( &m, 0, 0 );
209 if(M00 <= 0 ) continue;
210 X = cvGetSpatialMoment( &m, 1, 0 )/M00;
211 Y = cvGetSpatialMoment( &m, 0, 1 )/M00;
212 XX = (cvGetSpatialMoment( &m, 2, 0 )/M00) - X*X;
213 YY = (cvGetSpatialMoment( &m, 0, 2 )/M00) - Y*Y;
214 NewBlob = cvBlob(r.x+(float)X,r.y+(float)Y,(float)(4*sqrt(XX)),(float)(4*sqrt(YY)));
215 m_BlobListNew.AddBlob(&NewBlob);
217 } /* Next contour. */
219 cvReleaseImage(&pBin);
222 for(i=m_BlobList.GetBlobNum(); i>0; --i)
223 { /* Predict new blob position. */
225 DefBlobTrackerCR* pBT = (DefBlobTrackerCR*)m_BlobList.GetBlob(i-1);
227 /* Update predictor. */
228 pBT->pPredictor->Update(&(pBT->blob));
229 pB = pBT->pPredictor->Predict();
232 pBT->BlobPredict = pB[0];
234 pBT->BlobPrev = pBT->blob;
235 } /* Predict new blob position. */
238 if(m_BlobList.GetBlobNum()>0 && m_BlobListNew.GetBlobNum()>0)
239 { /* Resolve new blob to old: */
241 int NOld = m_BlobList.GetBlobNum();
242 int NNew = m_BlobListNew.GetBlobNum();
244 for(i=0; i<NOld; i++)
245 { /* Set 0 collision and clear all hyp: */
246 DefBlobTrackerCR* pF = (DefBlobTrackerCR*)m_BlobList.GetBlob(i);
248 pF->pBlobHyp->Clear();
249 } /* Set 0 collision. */
251 /* Create correspondence records: */
252 for(j=0; j<NNew; ++j)
254 CvBlob* pB1 = m_BlobListNew.GetBlob(j);
255 DefBlobTrackerCR* pFLast = NULL;
257 for(i=0; i<NOld; i++)
258 { /* Check intersection: */
259 int Intersection = 0;
260 DefBlobTrackerCR* pF = (DefBlobTrackerCR*)m_BlobList.GetBlob(i);
261 CvBlob* pB2 = &(pF->BlobPredict);
263 if( fabs(pB1->x-pB2->x)<0.5*(pB1->w+pB2->w) &&
264 fabs(pB1->y-pB2->y)<0.5*(pB1->h+pB2->h) ) Intersection = 1;
270 pF->Collision = pFLast->Collision = 1;
273 pF->pBlobHyp->AddBlob(pB1);
275 } /* Check intersection. */
276 } /* Check next new blob. */
277 } /* Resolve new blob to old. */
279 for(i=m_BlobList.GetBlobNum(); i>0; --i)
280 { /* Track each blob. */
281 CvBlob* pB = m_BlobList.GetBlob(i-1);
282 DefBlobTrackerCR* pBT = (DefBlobTrackerCR*)pB;
283 int BlobID = CV_BLOB_ID(pB);
284 //CvBlob* pBBest = NULL;
285 //double DistBest = -1;
290 pBT->pResolver->SetCollision(pBT->Collision);
294 { /* Tracking in collision: */
297 pB[0] = pBT->pResolver->Process(&(pBT->BlobPredict),pImg, pImgFG)[0];
299 } /* Tracking in collision. */
301 { /* Non-collision tracking: */
302 CvBlob NewCC = pBT->BlobPredict;
303 if(pBT->pBlobHyp->GetBlobNum()==1)
304 { /* One blob to one CC: */
305 NewCC = pBT->pBlobHyp->GetBlob(0)[0];
308 { /* One blob several CC: */
309 CvBlob* pBBest = NULL;
310 double DistBest = -1;
312 for(j=pBT->pBlobHyp->GetBlobNum();j>0;--j)
313 { /* Find best CC: */
314 CvBlob* pBNew = pBT->pBlobHyp->GetBlob(j-1);
316 { /* Choose CC by confidence: */
317 // double dx = fabs(CV_BLOB_X(pB)-CV_BLOB_X(pBNew));
318 // double dy = fabs(CV_BLOB_Y(pB)-CV_BLOB_Y(pBNew));
319 double C = pBT->pResolver->GetConfidence(pBNew,pImg, pImgFG);
320 if(C > CMax || pBBest == NULL)
327 { /* Choose CC by distance: */
328 double dx = fabs(CV_BLOB_X(pB)-CV_BLOB_X(pBNew));
329 double dy = fabs(CV_BLOB_Y(pB)-CV_BLOB_Y(pBNew));
330 double Dist = sqrt(dx*dx+dy*dy);
331 if(Dist < DistBest || pBBest == NULL)
337 } /* Find best CC. */
340 } /* One blob several CC. */
343 pB->w = (m_AlphaSize)*NewCC.w+(1-m_AlphaSize)*pB->w;
344 pB->h = (m_AlphaSize)*NewCC.h+(1-m_AlphaSize)*pB->h;
345 pBT->pResolver->SkipProcess(&(pBT->BlobPredict),pImg, pImgFG);
346 } /* Non-collision tracking. */
348 pBT->pResolver->Update(pB, pImg, pImgFG);
350 CV_BLOB_ID(pB)=BlobID;
352 } /* Track next blob. */
356 IplImage* pI = cvCloneImage(pImg);
358 for(i=m_BlobListNew.GetBlobNum(); i>0; --i)
359 { /* Draw each new CC: */
360 CvBlob* pB = m_BlobListNew.GetBlob(i-1);
361 CvPoint p = cvPointFrom32f(CV_BLOB_CENTER(pB));
362 int x = cvRound(CV_BLOB_RX(pB)), y = cvRound(CV_BLOB_RY(pB));
363 CvSize s = cvSize(MAX(1,x), MAX(1,y));
369 CV_RGB(255,255,0), 1 );
372 for(i=m_BlobList.GetBlobNum(); i>0; --i)
373 { /* Draw each new CC: */
374 DefBlobTrackerCR* pF = (DefBlobTrackerCR*)m_BlobList.GetBlob(i-1);
375 CvBlob* pB = &(pF->BlobPredict);
376 CvPoint p = cvPointFrom32f(CV_BLOB_CENTER(pB));
377 int x = cvRound(CV_BLOB_RX(pB)), y = cvRound(CV_BLOB_RY(pB));
378 CvSize s = cvSize(MAX(1,x), MAX(1,y));
383 CV_RGB(0,0,255), 1 );
386 p = cvPointFrom32f(CV_BLOB_CENTER(pB));
387 x = cvRound(CV_BLOB_RX(pB)); y = cvRound(CV_BLOB_RY(pB));
388 s = cvSize(MAX(1,x), MAX(1,y));
393 CV_RGB(0,255,0), 1 );
396 //cvNamedWindow("CCwithCR",0);
397 //cvShowImage("CCwithCR",pI);
403 virtual void SaveState(CvFileStorage* fs)
405 int b,bN = m_BlobList.GetBlobNum();
406 cvWriteInt(fs,"BlobNum",m_BlobList.GetBlobNum());
407 cvStartWriteStruct(fs,"BlobList",CV_NODE_SEQ);
411 DefBlobTrackerCR* pF = (DefBlobTrackerCR*)m_BlobList.GetBlob(b);
412 cvStartWriteStruct(fs,NULL,CV_NODE_MAP);
413 cvWriteInt(fs,"ID",CV_BLOB_ID(pF));
414 cvStartWriteStruct(fs,"Blob",CV_NODE_SEQ|CV_NODE_FLOW);
415 cvWriteRawData(fs,&(pF->blob),1,"ffffi");
416 cvEndWriteStruct(fs);
417 cvStartWriteStruct(fs,"BlobPredict",CV_NODE_SEQ|CV_NODE_FLOW);
418 cvWriteRawData(fs,&(pF->BlobPredict),1,"ffffi");
419 cvEndWriteStruct(fs);
420 cvStartWriteStruct(fs,"BlobPrev",CV_NODE_SEQ|CV_NODE_FLOW);
421 cvWriteRawData(fs,&(pF->BlobPrev),1,"ffffi");
422 cvEndWriteStruct(fs);
423 pF->pBlobHyp->Write(fs,"BlobHyp");
424 cvWriteInt(fs,"Collision",pF->Collision);
426 cvStartWriteStruct(fs,"Predictor",CV_NODE_MAP);
427 pF->pPredictor->SaveState(fs);
428 cvEndWriteStruct(fs);
430 cvStartWriteStruct(fs,"Resolver",CV_NODE_MAP);
431 pF->pResolver->SaveState(fs);
432 cvEndWriteStruct(fs);
433 cvEndWriteStruct(fs);
436 cvEndWriteStruct(fs);
440 virtual void LoadState(CvFileStorage* fs, CvFileNode* node)
442 int b,bN = cvReadIntByName(fs,node,"BlobNum",0);
443 CvFileNode* pBlobListNode = cvGetFileNodeByName(fs,node,"BlobList");
444 if(!CV_NODE_IS_SEQ(pBlobListNode->tag)) return;
445 bN = pBlobListNode->data.seq->total;
449 DefBlobTrackerCR* pF = NULL;
451 CvFileNode* pSeqNode = NULL;
452 CvFileNode* pBlobNode = (CvFileNode*)cvGetSeqElem(pBlobListNode->data.seq,b);
455 Blob.ID = cvReadIntByName(fs,pBlobNode,"ID",0);
457 pSeqNode = cvGetFileNodeByName(fs, pBlobNode, "Blob");
458 if(CV_NODE_IS_SEQ(pSeqNode->tag))
459 cvReadRawData( fs, pSeqNode, &Blob, "ffffi" );
461 AddBlob(&Blob,NULL,NULL);
462 pF = (DefBlobTrackerCR*)m_BlobList.GetBlobByID(Blob.ID);
464 pSeqNode = cvGetFileNodeByName(fs, pBlobNode, "BlobPredict");
465 if(CV_NODE_IS_SEQ(pSeqNode->tag))
466 cvReadRawData( fs, pSeqNode, &pF->BlobPredict, "ffffi" );
468 pSeqNode = cvGetFileNodeByName(fs, pBlobNode, "BlobPrev");
469 if(CV_NODE_IS_SEQ(pSeqNode->tag))
470 cvReadRawData( fs, pSeqNode, &pF->BlobPrev, "ffffi" );
472 pSeqNode = cvGetFileNodeByName(fs, pBlobNode, "BlobHyp");
474 pF->pBlobHyp->Load(fs,pSeqNode);
475 pF->Collision = cvReadIntByName(fs, pBlobNode,"Collision",pF->Collision);
477 pSeqNode = cvGetFileNodeByName(fs, pBlobNode, "Predictor");
479 pF->pPredictor->LoadState(fs,pSeqNode);
481 pSeqNode = cvGetFileNodeByName(fs, pBlobNode, "Resolver");
483 pF->pResolver->LoadState(fs,pSeqNode);
484 } /* Read next blob. */
485 } /* CCwithCR LoadState */
487 //void SetCollision(int Collision){m_Collision = Collision;};
490 CvBlobTrackerOne* cvCreateBlobTrackerOneMSPF();
491 CvBlobTracker* cvCreateBlobTrackerCCMSPF()
493 return (CvBlobTracker*) new CvBlobTrackerCCCR(cvCreateBlobTrackerOneMSPF,"MSPF");
495 /*============== BLOB TRACKERCC CLASS DECLARATION =============== */