gravatar
kpeter (Peter Kovacs)
kpeter@inf.elte.hu
Small improvements in NS pivot rules (#298)
0 1 0
default
1 file changed with 47 insertions and 55 deletions:
↑ Collapse diff ↑
Ignore white space 384 line context
... ...
@@ -175,638 +175,630 @@
175 175
      STATE_LOWER =  1
176 176
    };
177 177

	
178 178
  private:
179 179

	
180 180
    // Data related to the underlying digraph
181 181
    const GR &_graph;
182 182
    int _node_num;
183 183
    int _arc_num;
184 184
    int _all_arc_num;
185 185
    int _search_arc_num;
186 186

	
187 187
    // Parameters of the problem
188 188
    bool _have_lower;
189 189
    SupplyType _stype;
190 190
    Value _sum_supply;
191 191

	
192 192
    // Data structures for storing the digraph
193 193
    IntNodeMap _node_id;
194 194
    IntArcMap _arc_id;
195 195
    IntVector _source;
196 196
    IntVector _target;
197 197

	
198 198
    // Node and arc data
199 199
    ValueVector _lower;
200 200
    ValueVector _upper;
201 201
    ValueVector _cap;
202 202
    CostVector _cost;
203 203
    ValueVector _supply;
204 204
    ValueVector _flow;
205 205
    CostVector _pi;
206 206

	
207 207
    // Data for storing the spanning tree structure
208 208
    IntVector _parent;
209 209
    IntVector _pred;
210 210
    IntVector _thread;
211 211
    IntVector _rev_thread;
212 212
    IntVector _succ_num;
213 213
    IntVector _last_succ;
214 214
    IntVector _dirty_revs;
215 215
    BoolVector _forward;
216 216
    IntVector _state;
217 217
    int _root;
218 218

	
219 219
    // Temporary data used in the current pivot iteration
220 220
    int in_arc, join, u_in, v_in, u_out, v_out;
221 221
    int first, second, right, last;
222 222
    int stem, par_stem, new_stem;
223 223
    Value delta;
224 224

	
225 225
  public:
226 226
  
227 227
    /// \brief Constant for infinite upper bounds (capacities).
228 228
    ///
229 229
    /// Constant for infinite upper bounds (capacities).
230 230
    /// It is \c std::numeric_limits<Value>::infinity() if available,
231 231
    /// \c std::numeric_limits<Value>::max() otherwise.
232 232
    const Value INF;
233 233

	
234 234
  private:
235 235

	
236 236
    // Implementation of the First Eligible pivot rule
237 237
    class FirstEligiblePivotRule
238 238
    {
239 239
    private:
240 240

	
241 241
      // References to the NetworkSimplex class
242 242
      const IntVector  &_source;
243 243
      const IntVector  &_target;
244 244
      const CostVector &_cost;
245 245
      const IntVector  &_state;
246 246
      const CostVector &_pi;
247 247
      int &_in_arc;
248 248
      int _search_arc_num;
249 249

	
250 250
      // Pivot rule data
251 251
      int _next_arc;
252 252

	
253 253
    public:
254 254

	
255 255
      // Constructor
256 256
      FirstEligiblePivotRule(NetworkSimplex &ns) :
257 257
        _source(ns._source), _target(ns._target),
258 258
        _cost(ns._cost), _state(ns._state), _pi(ns._pi),
259 259
        _in_arc(ns.in_arc), _search_arc_num(ns._search_arc_num),
260 260
        _next_arc(0)
261 261
      {}
262 262

	
263 263
      // Find next entering arc
264 264
      bool findEnteringArc() {
265 265
        Cost c;
266 266
        for (int e = _next_arc; e < _search_arc_num; ++e) {
267 267
          c = _state[e] * (_cost[e] + _pi[_source[e]] - _pi[_target[e]]);
268 268
          if (c < 0) {
269 269
            _in_arc = e;
270 270
            _next_arc = e + 1;
271 271
            return true;
272 272
          }
273 273
        }
274 274
        for (int e = 0; e < _next_arc; ++e) {
275 275
          c = _state[e] * (_cost[e] + _pi[_source[e]] - _pi[_target[e]]);
276 276
          if (c < 0) {
277 277
            _in_arc = e;
278 278
            _next_arc = e + 1;
279 279
            return true;
280 280
          }
281 281
        }
282 282
        return false;
283 283
      }
284 284

	
285 285
    }; //class FirstEligiblePivotRule
286 286

	
287 287

	
288 288
    // Implementation of the Best Eligible pivot rule
289 289
    class BestEligiblePivotRule
290 290
    {
291 291
    private:
292 292

	
293 293
      // References to the NetworkSimplex class
294 294
      const IntVector  &_source;
295 295
      const IntVector  &_target;
296 296
      const CostVector &_cost;
297 297
      const IntVector  &_state;
298 298
      const CostVector &_pi;
299 299
      int &_in_arc;
300 300
      int _search_arc_num;
301 301

	
302 302
    public:
303 303

	
304 304
      // Constructor
305 305
      BestEligiblePivotRule(NetworkSimplex &ns) :
306 306
        _source(ns._source), _target(ns._target),
307 307
        _cost(ns._cost), _state(ns._state), _pi(ns._pi),
308 308
        _in_arc(ns.in_arc), _search_arc_num(ns._search_arc_num)
309 309
      {}
310 310

	
311 311
      // Find next entering arc
312 312
      bool findEnteringArc() {
313 313
        Cost c, min = 0;
314 314
        for (int e = 0; e < _search_arc_num; ++e) {
315 315
          c = _state[e] * (_cost[e] + _pi[_source[e]] - _pi[_target[e]]);
316 316
          if (c < min) {
317 317
            min = c;
318 318
            _in_arc = e;
319 319
          }
320 320
        }
321 321
        return min < 0;
322 322
      }
323 323

	
324 324
    }; //class BestEligiblePivotRule
325 325

	
326 326

	
327 327
    // Implementation of the Block Search pivot rule
328 328
    class BlockSearchPivotRule
329 329
    {
330 330
    private:
331 331

	
332 332
      // References to the NetworkSimplex class
333 333
      const IntVector  &_source;
334 334
      const IntVector  &_target;
335 335
      const CostVector &_cost;
336 336
      const IntVector  &_state;
337 337
      const CostVector &_pi;
338 338
      int &_in_arc;
339 339
      int _search_arc_num;
340 340

	
341 341
      // Pivot rule data
342 342
      int _block_size;
343 343
      int _next_arc;
344 344

	
345 345
    public:
346 346

	
347 347
      // Constructor
348 348
      BlockSearchPivotRule(NetworkSimplex &ns) :
349 349
        _source(ns._source), _target(ns._target),
350 350
        _cost(ns._cost), _state(ns._state), _pi(ns._pi),
351 351
        _in_arc(ns.in_arc), _search_arc_num(ns._search_arc_num),
352 352
        _next_arc(0)
353 353
      {
354 354
        // The main parameters of the pivot rule
355 355
        const double BLOCK_SIZE_FACTOR = 0.5;
356 356
        const int MIN_BLOCK_SIZE = 10;
357 357

	
358 358
        _block_size = std::max( int(BLOCK_SIZE_FACTOR *
359 359
                                    std::sqrt(double(_search_arc_num))),
360 360
                                MIN_BLOCK_SIZE );
361 361
      }
362 362

	
363 363
      // Find next entering arc
364 364
      bool findEnteringArc() {
365 365
        Cost c, min = 0;
366 366
        int cnt = _block_size;
367
        int e, min_arc = _next_arc;
367
        int e;
368 368
        for (e = _next_arc; e < _search_arc_num; ++e) {
369 369
          c = _state[e] * (_cost[e] + _pi[_source[e]] - _pi[_target[e]]);
370 370
          if (c < min) {
371 371
            min = c;
372
            min_arc = e;
372
            _in_arc = e;
373 373
          }
374 374
          if (--cnt == 0) {
375
            if (min < 0) break;
375
            if (min < 0) goto search_end;
376 376
            cnt = _block_size;
377 377
          }
378 378
        }
379
        if (min == 0 || cnt > 0) {
380
          for (e = 0; e < _next_arc; ++e) {
381
            c = _state[e] * (_cost[e] + _pi[_source[e]] - _pi[_target[e]]);
382
            if (c < min) {
383
              min = c;
384
              min_arc = e;
385
            }
386
            if (--cnt == 0) {
387
              if (min < 0) break;
388
              cnt = _block_size;
389
            }
379
        for (e = 0; e < _next_arc; ++e) {
380
          c = _state[e] * (_cost[e] + _pi[_source[e]] - _pi[_target[e]]);
381
          if (c < min) {
382
            min = c;
383
            _in_arc = e;
384
          }
385
          if (--cnt == 0) {
386
            if (min < 0) goto search_end;
387
            cnt = _block_size;
390 388
          }
391 389
        }
392 390
        if (min >= 0) return false;
393
        _in_arc = min_arc;
391

	
392
      search_end:
394 393
        _next_arc = e;
395 394
        return true;
396 395
      }
397 396

	
398 397
    }; //class BlockSearchPivotRule
399 398

	
400 399

	
401 400
    // Implementation of the Candidate List pivot rule
402 401
    class CandidateListPivotRule
403 402
    {
404 403
    private:
405 404

	
406 405
      // References to the NetworkSimplex class
407 406
      const IntVector  &_source;
408 407
      const IntVector  &_target;
409 408
      const CostVector &_cost;
410 409
      const IntVector  &_state;
411 410
      const CostVector &_pi;
412 411
      int &_in_arc;
413 412
      int _search_arc_num;
414 413

	
415 414
      // Pivot rule data
416 415
      IntVector _candidates;
417 416
      int _list_length, _minor_limit;
418 417
      int _curr_length, _minor_count;
419 418
      int _next_arc;
420 419

	
421 420
    public:
422 421

	
423 422
      /// Constructor
424 423
      CandidateListPivotRule(NetworkSimplex &ns) :
425 424
        _source(ns._source), _target(ns._target),
426 425
        _cost(ns._cost), _state(ns._state), _pi(ns._pi),
427 426
        _in_arc(ns.in_arc), _search_arc_num(ns._search_arc_num),
428 427
        _next_arc(0)
429 428
      {
430 429
        // The main parameters of the pivot rule
431
        const double LIST_LENGTH_FACTOR = 1.0;
430
        const double LIST_LENGTH_FACTOR = 0.25;
432 431
        const int MIN_LIST_LENGTH = 10;
433 432
        const double MINOR_LIMIT_FACTOR = 0.1;
434 433
        const int MIN_MINOR_LIMIT = 3;
435 434

	
436 435
        _list_length = std::max( int(LIST_LENGTH_FACTOR *
437 436
                                     std::sqrt(double(_search_arc_num))),
438 437
                                 MIN_LIST_LENGTH );
439 438
        _minor_limit = std::max( int(MINOR_LIMIT_FACTOR * _list_length),
440 439
                                 MIN_MINOR_LIMIT );
441 440
        _curr_length = _minor_count = 0;
442 441
        _candidates.resize(_list_length);
443 442
      }
444 443

	
445 444
      /// Find next entering arc
446 445
      bool findEnteringArc() {
447 446
        Cost min, c;
448
        int e, min_arc = _next_arc;
447
        int e;
449 448
        if (_curr_length > 0 && _minor_count < _minor_limit) {
450 449
          // Minor iteration: select the best eligible arc from the
451 450
          // current candidate list
452 451
          ++_minor_count;
453 452
          min = 0;
454 453
          for (int i = 0; i < _curr_length; ++i) {
455 454
            e = _candidates[i];
456 455
            c = _state[e] * (_cost[e] + _pi[_source[e]] - _pi[_target[e]]);
457 456
            if (c < min) {
458 457
              min = c;
459
              min_arc = e;
458
              _in_arc = e;
460 459
            }
461
            if (c >= 0) {
460
            else if (c >= 0) {
462 461
              _candidates[i--] = _candidates[--_curr_length];
463 462
            }
464 463
          }
465
          if (min < 0) {
466
            _in_arc = min_arc;
467
            return true;
468
          }
464
          if (min < 0) return true;
469 465
        }
470 466

	
471 467
        // Major iteration: build a new candidate list
472 468
        min = 0;
473 469
        _curr_length = 0;
474 470
        for (e = _next_arc; e < _search_arc_num; ++e) {
475 471
          c = _state[e] * (_cost[e] + _pi[_source[e]] - _pi[_target[e]]);
476 472
          if (c < 0) {
477 473
            _candidates[_curr_length++] = e;
478 474
            if (c < min) {
479 475
              min = c;
480
              min_arc = e;
476
              _in_arc = e;
481 477
            }
482
            if (_curr_length == _list_length) break;
478
            if (_curr_length == _list_length) goto search_end;
483 479
          }
484 480
        }
485
        if (_curr_length < _list_length) {
486
          for (e = 0; e < _next_arc; ++e) {
487
            c = _state[e] * (_cost[e] + _pi[_source[e]] - _pi[_target[e]]);
488
            if (c < 0) {
489
              _candidates[_curr_length++] = e;
490
              if (c < min) {
491
                min = c;
492
                min_arc = e;
493
              }
494
              if (_curr_length == _list_length) break;
481
        for (e = 0; e < _next_arc; ++e) {
482
          c = _state[e] * (_cost[e] + _pi[_source[e]] - _pi[_target[e]]);
483
          if (c < 0) {
484
            _candidates[_curr_length++] = e;
485
            if (c < min) {
486
              min = c;
487
              _in_arc = e;
495 488
            }
489
            if (_curr_length == _list_length) goto search_end;
496 490
          }
497 491
        }
498 492
        if (_curr_length == 0) return false;
493
      
494
      search_end:        
499 495
        _minor_count = 1;
500
        _in_arc = min_arc;
501 496
        _next_arc = e;
502 497
        return true;
503 498
      }
504 499

	
505 500
    }; //class CandidateListPivotRule
506 501

	
507 502

	
508 503
    // Implementation of the Altering Candidate List pivot rule
509 504
    class AlteringListPivotRule
510 505
    {
511 506
    private:
512 507

	
513 508
      // References to the NetworkSimplex class
514 509
      const IntVector  &_source;
515 510
      const IntVector  &_target;
516 511
      const CostVector &_cost;
517 512
      const IntVector  &_state;
518 513
      const CostVector &_pi;
519 514
      int &_in_arc;
520 515
      int _search_arc_num;
521 516

	
522 517
      // Pivot rule data
523 518
      int _block_size, _head_length, _curr_length;
524 519
      int _next_arc;
525 520
      IntVector _candidates;
526 521
      CostVector _cand_cost;
527 522

	
528 523
      // Functor class to compare arcs during sort of the candidate list
529 524
      class SortFunc
530 525
      {
531 526
      private:
532 527
        const CostVector &_map;
533 528
      public:
534 529
        SortFunc(const CostVector &map) : _map(map) {}
535 530
        bool operator()(int left, int right) {
536 531
          return _map[left] > _map[right];
537 532
        }
538 533
      };
539 534

	
540 535
      SortFunc _sort_func;
541 536

	
542 537
    public:
543 538

	
544 539
      // Constructor
545 540
      AlteringListPivotRule(NetworkSimplex &ns) :
546 541
        _source(ns._source), _target(ns._target),
547 542
        _cost(ns._cost), _state(ns._state), _pi(ns._pi),
548 543
        _in_arc(ns.in_arc), _search_arc_num(ns._search_arc_num),
549 544
        _next_arc(0), _cand_cost(ns._search_arc_num), _sort_func(_cand_cost)
550 545
      {
551 546
        // The main parameters of the pivot rule
552
        const double BLOCK_SIZE_FACTOR = 1.5;
547
        const double BLOCK_SIZE_FACTOR = 1.0;
553 548
        const int MIN_BLOCK_SIZE = 10;
554 549
        const double HEAD_LENGTH_FACTOR = 0.1;
555 550
        const int MIN_HEAD_LENGTH = 3;
556 551

	
557 552
        _block_size = std::max( int(BLOCK_SIZE_FACTOR *
558 553
                                    std::sqrt(double(_search_arc_num))),
559 554
                                MIN_BLOCK_SIZE );
560 555
        _head_length = std::max( int(HEAD_LENGTH_FACTOR * _block_size),
561 556
                                 MIN_HEAD_LENGTH );
562 557
        _candidates.resize(_head_length + _block_size);
563 558
        _curr_length = 0;
564 559
      }
565 560

	
566 561
      // Find next entering arc
567 562
      bool findEnteringArc() {
568 563
        // Check the current candidate list
569 564
        int e;
570 565
        for (int i = 0; i < _curr_length; ++i) {
571 566
          e = _candidates[i];
572 567
          _cand_cost[e] = _state[e] *
573 568
            (_cost[e] + _pi[_source[e]] - _pi[_target[e]]);
574 569
          if (_cand_cost[e] >= 0) {
575 570
            _candidates[i--] = _candidates[--_curr_length];
576 571
          }
577 572
        }
578 573

	
579 574
        // Extend the list
580 575
        int cnt = _block_size;
581
        int last_arc = 0;
582 576
        int limit = _head_length;
583 577

	
584
        for (int e = _next_arc; e < _search_arc_num; ++e) {
578
        for (e = _next_arc; e < _search_arc_num; ++e) {
585 579
          _cand_cost[e] = _state[e] *
586 580
            (_cost[e] + _pi[_source[e]] - _pi[_target[e]]);
587 581
          if (_cand_cost[e] < 0) {
588 582
            _candidates[_curr_length++] = e;
589
            last_arc = e;
590 583
          }
591 584
          if (--cnt == 0) {
592
            if (_curr_length > limit) break;
585
            if (_curr_length > limit) goto search_end;
593 586
            limit = 0;
594 587
            cnt = _block_size;
595 588
          }
596 589
        }
597
        if (_curr_length <= limit) {
598
          for (int e = 0; e < _next_arc; ++e) {
599
            _cand_cost[e] = _state[e] *
600
              (_cost[e] + _pi[_source[e]] - _pi[_target[e]]);
601
            if (_cand_cost[e] < 0) {
602
              _candidates[_curr_length++] = e;
603
              last_arc = e;
604
            }
605
            if (--cnt == 0) {
606
              if (_curr_length > limit) break;
607
              limit = 0;
608
              cnt = _block_size;
609
            }
590
        for (e = 0; e < _next_arc; ++e) {
591
          _cand_cost[e] = _state[e] *
592
            (_cost[e] + _pi[_source[e]] - _pi[_target[e]]);
593
          if (_cand_cost[e] < 0) {
594
            _candidates[_curr_length++] = e;
595
          }
596
          if (--cnt == 0) {
597
            if (_curr_length > limit) goto search_end;
598
            limit = 0;
599
            cnt = _block_size;
610 600
          }
611 601
        }
612 602
        if (_curr_length == 0) return false;
613
        _next_arc = last_arc + 1;
603
        
604
      search_end:
614 605

	
615 606
        // Make heap of the candidate list (approximating a partial sort)
616 607
        make_heap( _candidates.begin(), _candidates.begin() + _curr_length,
617 608
                   _sort_func );
618 609

	
619 610
        // Pop the first element of the heap
620 611
        _in_arc = _candidates[0];
612
        _next_arc = e;
621 613
        pop_heap( _candidates.begin(), _candidates.begin() + _curr_length,
622 614
                  _sort_func );
623 615
        _curr_length = std::min(_head_length, _curr_length - 1);
624 616
        return true;
625 617
      }
626 618

	
627 619
    }; //class AlteringListPivotRule
628 620

	
629 621
  public:
630 622

	
631 623
    /// \brief Constructor.
632 624
    ///
633 625
    /// The constructor of the class.
634 626
    ///
635 627
    /// \param graph The digraph the algorithm runs on.
636 628
    NetworkSimplex(const GR& graph) :
637 629
      _graph(graph), _node_id(graph), _arc_id(graph),
638 630
      INF(std::numeric_limits<Value>::has_infinity ?
639 631
          std::numeric_limits<Value>::infinity() :
640 632
          std::numeric_limits<Value>::max())
641 633
    {
642 634
      // Check the value types
643 635
      LEMON_ASSERT(std::numeric_limits<Value>::is_signed,
644 636
        "The flow type of NetworkSimplex must be signed");
645 637
      LEMON_ASSERT(std::numeric_limits<Cost>::is_signed,
646 638
        "The cost type of NetworkSimplex must be signed");
647 639
        
648 640
      // Resize vectors
649 641
      _node_num = countNodes(_graph);
650 642
      _arc_num = countArcs(_graph);
651 643
      int all_node_num = _node_num + 1;
652 644
      int max_arc_num = _arc_num + 2 * _node_num;
653 645

	
654 646
      _source.resize(max_arc_num);
655 647
      _target.resize(max_arc_num);
656 648

	
657 649
      _lower.resize(_arc_num);
658 650
      _upper.resize(_arc_num);
659 651
      _cap.resize(max_arc_num);
660 652
      _cost.resize(max_arc_num);
661 653
      _supply.resize(all_node_num);
662 654
      _flow.resize(max_arc_num);
663 655
      _pi.resize(all_node_num);
664 656

	
665 657
      _parent.resize(all_node_num);
666 658
      _pred.resize(all_node_num);
667 659
      _forward.resize(all_node_num);
668 660
      _thread.resize(all_node_num);
669 661
      _rev_thread.resize(all_node_num);
670 662
      _succ_num.resize(all_node_num);
671 663
      _last_succ.resize(all_node_num);
672 664
      _state.resize(max_arc_num);
673 665

	
674 666
      // Copy the graph (store the arcs in a mixed order)
675 667
      int i = 0;
676 668
      for (NodeIt n(_graph); n != INVALID; ++n, ++i) {
677 669
        _node_id[n] = i;
678 670
      }
679 671
      int k = std::max(int(std::sqrt(double(_arc_num))), 10);
680 672
      i = 0;
681 673
      for (ArcIt a(_graph); a != INVALID; ++a) {
682 674
        _arc_id[a] = i;
683 675
        _source[i] = _node_id[_graph.source(a)];
684 676
        _target[i] = _node_id[_graph.target(a)];
685 677
        if ((i += k) >= _arc_num) i = (i % k) + 1;
686 678
      }
687 679
      
688 680
      // Initialize maps
689 681
      for (int i = 0; i != _node_num; ++i) {
690 682
        _supply[i] = 0;
691 683
      }
692 684
      for (int i = 0; i != _arc_num; ++i) {
693 685
        _lower[i] = 0;
694 686
        _upper[i] = INF;
695 687
        _cost[i] = 1;
696 688
      }
697 689
      _have_lower = false;
698 690
      _stype = GEQ;
699 691
    }
700 692

	
701 693
    /// \name Parameters
702 694
    /// The parameters of the algorithm can be specified using these
703 695
    /// functions.
704 696

	
705 697
    /// @{
706 698

	
707 699
    /// \brief Set the lower bounds on the arcs.
708 700
    ///
709 701
    /// This function sets the lower bounds on the arcs.
710 702
    /// If it is not used before calling \ref run(), the lower bounds
711 703
    /// will be set to zero on all arcs.
712 704
    ///
713 705
    /// \param map An arc map storing the lower bounds.
714 706
    /// Its \c Value type must be convertible to the \c Value type
715 707
    /// of the algorithm.
716 708
    ///
717 709
    /// \return <tt>(*this)</tt>
718 710
    template <typename LowerMap>
719 711
    NetworkSimplex& lowerMap(const LowerMap& map) {
720 712
      _have_lower = true;
721 713
      for (ArcIt a(_graph); a != INVALID; ++a) {
722 714
        _lower[_arc_id[a]] = map[a];
723 715
      }
724 716
      return *this;
725 717
    }
726 718

	
727 719
    /// \brief Set the upper bounds (capacities) on the arcs.
728 720
    ///
729 721
    /// This function sets the upper bounds (capacities) on the arcs.
730 722
    /// If it is not used before calling \ref run(), the upper bounds
731 723
    /// will be set to \ref INF on all arcs (i.e. the flow value will be
732 724
    /// unbounded from above on each arc).
733 725
    ///
734 726
    /// \param map An arc map storing the upper bounds.
735 727
    /// Its \c Value type must be convertible to the \c Value type
736 728
    /// of the algorithm.
737 729
    ///
738 730
    /// \return <tt>(*this)</tt>
739 731
    template<typename UpperMap>
740 732
    NetworkSimplex& upperMap(const UpperMap& map) {
741 733
      for (ArcIt a(_graph); a != INVALID; ++a) {
742 734
        _upper[_arc_id[a]] = map[a];
743 735
      }
744 736
      return *this;
745 737
    }
746 738

	
747 739
    /// \brief Set the costs of the arcs.
748 740
    ///
749 741
    /// This function sets the costs of the arcs.
750 742
    /// If it is not used before calling \ref run(), the costs
751 743
    /// will be set to \c 1 on all arcs.
752 744
    ///
753 745
    /// \param map An arc map storing the costs.
754 746
    /// Its \c Value type must be convertible to the \c Cost type
755 747
    /// of the algorithm.
756 748
    ///
757 749
    /// \return <tt>(*this)</tt>
758 750
    template<typename CostMap>
759 751
    NetworkSimplex& costMap(const CostMap& map) {
760 752
      for (ArcIt a(_graph); a != INVALID; ++a) {
761 753
        _cost[_arc_id[a]] = map[a];
762 754
      }
763 755
      return *this;
764 756
    }
765 757

	
766 758
    /// \brief Set the supply values of the nodes.
767 759
    ///
768 760
    /// This function sets the supply values of the nodes.
769 761
    /// If neither this function nor \ref stSupply() is used before
770 762
    /// calling \ref run(), the supply of each node will be set to zero.
771 763
    /// (It makes sense only if non-zero lower bounds are given.)
772 764
    ///
773 765
    /// \param map A node map storing the supply values.
774 766
    /// Its \c Value type must be convertible to the \c Value type
775 767
    /// of the algorithm.
776 768
    ///
777 769
    /// \return <tt>(*this)</tt>
778 770
    template<typename SupplyMap>
779 771
    NetworkSimplex& supplyMap(const SupplyMap& map) {
780 772
      for (NodeIt n(_graph); n != INVALID; ++n) {
781 773
        _supply[_node_id[n]] = map[n];
782 774
      }
783 775
      return *this;
784 776
    }
785 777

	
786 778
    /// \brief Set single source and target nodes and a supply value.
787 779
    ///
788 780
    /// This function sets a single source node and a single target node
789 781
    /// and the required flow value.
790 782
    /// If neither this function nor \ref supplyMap() is used before
791 783
    /// calling \ref run(), the supply of each node will be set to zero.
792 784
    /// (It makes sense only if non-zero lower bounds are given.)
793 785
    ///
794 786
    /// Using this function has the same effect as using \ref supplyMap()
795 787
    /// with such a map in which \c k is assigned to \c s, \c -k is
796 788
    /// assigned to \c t and all other nodes have zero supply value.
797 789
    ///
798 790
    /// \param s The source node.
799 791
    /// \param t The target node.
800 792
    /// \param k The required amount of flow from node \c s to node \c t
801 793
    /// (i.e. the supply of \c s and the demand of \c t).
802 794
    ///
803 795
    /// \return <tt>(*this)</tt>
804 796
    NetworkSimplex& stSupply(const Node& s, const Node& t, Value k) {
805 797
      for (int i = 0; i != _node_num; ++i) {
806 798
        _supply[i] = 0;
807 799
      }
808 800
      _supply[_node_id[s]] =  k;
809 801
      _supply[_node_id[t]] = -k;
810 802
      return *this;
811 803
    }
812 804
    
0 comments (0 inline)