You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
225 lines
7.5 KiB
225 lines
7.5 KiB
<!-------- @HEADER
|
|
!
|
|
! !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
|
|
!
|
|
! Zoltan Toolkit for Load-balancing, Partitioning, Ordering and Coloring
|
|
! Copyright 2012 Sandia Corporation
|
|
!
|
|
! Under the terms of Contract DE-AC04-94AL85000 with Sandia Corporation,
|
|
! the U.S. Government retains certain rights in this software.
|
|
!
|
|
! Redistribution and use in source and binary forms, with or without
|
|
! modification, are permitted provided that the following conditions are
|
|
! met:
|
|
!
|
|
! 1. Redistributions of source code must retain the above copyright
|
|
! notice, this list of conditions and the following disclaimer.
|
|
!
|
|
! 2. Redistributions in binary form must reproduce the above copyright
|
|
! notice, this list of conditions and the following disclaimer in the
|
|
! documentation and/or other materials provided with the distribution.
|
|
!
|
|
! 3. Neither the name of the Corporation nor the names of the
|
|
! contributors may be used to endorse or promote products derived from
|
|
! this software without specific prior written permission.
|
|
!
|
|
! THIS SOFTWARE IS PROVIDED BY SANDIA CORPORATION "AS IS" AND ANY
|
|
! EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
! IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
|
|
! PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL SANDIA CORPORATION OR THE
|
|
! CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
|
|
! EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
|
|
! PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
|
|
! PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
|
|
! LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
|
|
! NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
|
|
! SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
!
|
|
! Questions? Contact Karen Devine kddevin@sandia.gov
|
|
! Erik Boman egboman@sandia.gov
|
|
!
|
|
! !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
|
|
!
|
|
! @HEADER
|
|
------->
|
|
<!DOCTYPE html PUBLIC "-//w3c//dtd html 4.0 transitional//en">
|
|
<html>
|
|
<head>
|
|
<meta http-equiv="Content-Type"
|
|
content="text/html; charset=iso-8859-1">
|
|
<meta name="GENERATOR"
|
|
content="Mozilla/4.76 [en] (X11; U; Linux 2.4.2-2smp i686) [Netscape]">
|
|
<meta name="sandia.approval_type" content="formal">
|
|
<meta name="sandia.approved" content="SAND2007-4748W">
|
|
<meta name="author" content="Zoltan PI">
|
|
|
|
<title>Zoltan User's Guide: PaToH</title>
|
|
</head>
|
|
<body bgcolor="#ffffff">
|
|
<div align="right"><b><i><a href="ug.html">Zoltan User's Guide</a>
|
|
| <a href="ug_alg_graph.html">Next</a> | <a
|
|
href="ug_alg_phg.html">Previous</a></i></b></div>
|
|
<h2>
|
|
<a name="PaToH"></a>PaToH</h2>
|
|
|
|
<a href="https://bmi.osu.edu/%7Eumit/software.htm">PaToH</a>
|
|
is a serial hypergraph partitioning package. It is not distributed
|
|
with Zoltan and must be obtained separately. (You will also need to
|
|
modify your Zoltan configuration file after installation.)
|
|
PaToH binary distribution is available free of charge for
|
|
non-commercial, research use by individuals, academic or research
|
|
institutions and corporations. Commercial use of PaToH software
|
|
requires commercial license. Please direct commercial-use license
|
|
inquiries to catalyurek.1@osu.edu.
|
|
<p>
|
|
Since PaToH is serial, it can be used in Zoltan only on a single
|
|
processor. PaToH is faster than Zoltan PHG in serial mode, and
|
|
often produces (slightly) better partition quality.
|
|
<p>
|
|
|
|
<table nosave="" width="100%">
|
|
<tbody>
|
|
<tr>
|
|
<td VALIGN=TOP><b>Value of LB_METHOD:</b></td>
|
|
<td><b>HYPERGRAPH</b></td>
|
|
</tr>
|
|
<tr>
|
|
<td VALIGN=TOP><b>Value of HYPERGRAPH_PACKAGE:</b></td>
|
|
<td><b>PATOH</b></td>
|
|
</tr>
|
|
|
|
<tr>
|
|
<td><b>Parameters:</b></td>
|
|
<td><br>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td ><i> PATOH_ALLOC_POOL0</i></td>
|
|
<td>
|
|
<br><i>non-zero</i>  (the value of the MemMul_CellNet PATOH parameter)
|
|
<br><i>0</i>  (the default)
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td ><i> PATOH_ALLOC_POOL1</i></td>
|
|
<td>
|
|
<br><i>non-zero</i>  (the value of the MemMul_Pins PATOH parameter)
|
|
<br><i>0</i>  (the default)
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td ><i> USE_TIMERS</i></td>
|
|
<td>
|
|
<br><i>1</i>  (time operations and print results)
|
|
<br><i>0</i>  (don't time, the default)
|
|
</td>
|
|
</tr>
|
|
<tr nosave="" valign="top">
|
|
<td> <span style="font-style: italic;">PHG_EDGE_SIZE_THRESHOLD</span><br>
|
|
</td>
|
|
<td nosave="">Value 0.0 through 1.0, if number of vertices in hyperedge divided by total vertices in hypergraph exceeds this fraction, the hyperedge will be omitted.<br>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td style="vertical-align: top;"> <span
|
|
style="font-style: italic;">ADD_OBJ_WEIGHT</span><br>
|
|
</td>
|
|
<td style="vertical-align: top;">Add implicit vertex (object)
|
|
weight. Multi-weight partitioning is not yet supported, so currently either
|
|
the user-defined weight or the implicit weight will be used.
|
|
Valid values:<br>
|
|
<i>none</i> (the default if <a href=ug_param.html#General_Parameters>OBJ_WEIGHT_DIM</a> > 0)<br>
|
|
<i>unit</i> or <i>vertices</i> (each vertex has weight 1.0,
|
|
default if <a href=ug_param.html#General_Parameters>OBJ_WEIGHT_DIM</a>
|
|
is zero)<br>
|
|
<i>pins</i> or <i>nonzeros</i> or <i>vertex degree</i> (vertex weight
|
|
equals number hyperedges containing it)<br>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td style="vertical-align: top;"> <span
|
|
style="font-style: italic;">CHECK_HYPERGRAPH</span><br>
|
|
</td>
|
|
<td style="vertical-align: top;">Check that the query functions
|
|
return valid input data; 0 or 1. (This slows performance; intended for debugging.)<br>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><b>Default Values:</b></td>
|
|
<td><br>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td></td>
|
|
<td><i>PATOH_ALLOC_POOL0</i> = 0 </td>
|
|
</tr>
|
|
<tr>
|
|
<td></td>
|
|
<td><i>PATOH_ALLOC_POOL1</i> = 0 </td>
|
|
</tr>
|
|
<tr>
|
|
<td></td>
|
|
<td><i>USE_TIMERS</i> = 0 </td>
|
|
</tr>
|
|
<tr>
|
|
<td></td>
|
|
<td><i>PHG_EDGE_SIZE_THRESHOLD</i> = 0.25 </td>
|
|
</tr>
|
|
<tr>
|
|
<td></td>
|
|
<td><i>ADD_OBJ_WEIGHT</i> = none </td>
|
|
</tr>
|
|
<tr>
|
|
<td></td>
|
|
<td><i>CHECK_HYPERGRAPH</i> = 0 </td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><b>Required Query Functions:</b></td>
|
|
<td><br>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><br>
|
|
</td>
|
|
<td><b><a href="ug_query_lb.html#ZOLTAN_NUM_OBJ_FN">ZOLTAN_NUM_OBJ_FN</a></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td><br>
|
|
</td>
|
|
<td><b><a href="ug_query_lb.html#ZOLTAN_OBJ_LIST_FN">ZOLTAN_OBJ_LIST_FN</a></b>
|
|
</td>
|
|
</tr>
|
|
<tr nosave="" valign="top">
|
|
<td><br>
|
|
</td>
|
|
<td nosave=""> <b><a href="ug_query_lb.html#ZOLTAN_HG_SIZE_CS_FN">ZOLTAN_HG_SIZE_CS_FN</a></b>
|
|
<br>
|
|
<b><a href="ug_query_lb.html#ZOLTAN_HG_CS_FN">ZOLTAN_HG_CS_FN</a></b>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td valign="top"><b>Optional Query Functions:</b></td>
|
|
<td><br>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><br>
|
|
</td>
|
|
<td><b><a href="ug_query_lb.html#ZOLTAN_HG_SIZE_EDGE_WTS_FN">ZOLTAN_HG_SIZE_EDGE_WTS_FN</a></b></td>
|
|
</tr>
|
|
<tr>
|
|
<td><br>
|
|
</td>
|
|
<td><b><a href="ug_query_lb.html#ZOLTAN_HG_EDGE_WTS_FN">ZOLTAN_HG_EDGE_WTS_FN</a></b></td>
|
|
</tr>
|
|
|
|
|
|
</body>
|
|
</table>
|
|
|
|
<hr width="100%">[<a href="ug.html">Table of Contents</a> | <a
|
|
href="ug_alg_graph.html">Next:
|
|
Graph Partitioning</a> | <a href="ug_alg_phg.html">Previous:
|
|
PHG</a> | <a href="https://www.sandia.gov/general/privacy-security/index.html">Privacy and Security</a>]
|
|
</body>
|
|
</html>
|
|
|