Antiprism Up Next
Home
Programs
Examples
Album
Download
Development
Forum
About

repel - equilibrium of points repelling on a sphere

Usage    |    Examples    |    Notes

Usage



Usage: repel [options] [input_file]

An equilibrium position is found for a set of points which repel each
other. The initial coordinates are read from input_file if given (or
from standard input), otherwise use -N to generate a random set.

Options
  -h,--help this help message (run 'off_util -H help' for general help)
  --version version information
  -N <num>  initialise with a number of randomly placed points
  -n <itrs> maximum number of iterations, -1 for unlimited (default: -1)
  -s <perc> percentage to shorten the travel distance (default: adaptive)
  -r <exp>  repelling formula, 1/distance^exp (default: 2)
  -l <lim>  minimum change of distance/width_of_model to terminate, as 
               negative exponent (default: 12 giving 1e-12)
  -z <nums> number of iterations between status reports (implies termination
            check) (0 for final report only, -1 for no report), optionally
            followed by a comma and the number of iterations between
            termination checks (0 for report checks only) (default: 1000,1)
  -o <file> write output to file (default: write to standard output)

Examples

Make a snub cube
repel -N 24 -l 15 | conv_hull | antiview


Make a snub cube in fewer iterations by not using adaptive shortening
repel -N 24 -s 1 -l 15 | conv_hull | antiview


Notes

The default adaptive shortening of travel will not always be quickest. It is worth experimenting with specific values using option -s. However, in the snub cube examples above the adaptive shortening gives better results, producing more accurate squares.

The progress report includes the number of iterations, the greatest distance moved by a point, the shortening factor, and the sum of all the forces.


     Next: bravais - Bravais lattices
     Up: Programs and Documentation


Home   |   Programs   |   Examples   |   Album   |   Download   |   Development   |   Forum   |   About

Contact: adrian@antiprism.com      -      Modified 1.6.2022