fancy API, comments, clean refactoring

This commit is contained in:
Johann Dreo 2018-12-12 22:40:23 +01:00
commit e3257d32c0

View file

@ -9,18 +9,38 @@ import copy
def x(a):
return a[0]
def y(a):
return a[1]
def distance(a,b):
"""Euclidean distance (in pixels)."""
return np.sqrt( (x(a)-x(b))**2 + (y(a)-y(b))**2 )
def highlight_sensors(domain, sensors):
for s in sensors:
# `coverage` fills the domain with ones,
# adding twos will be visible in an image.
domain[y(s)][x(s)] = 2
return domain
########################################################################
# Objective functions
########################################################################
def coverage(domain,sensors,sensor_range):
def coverage(domain, sensors, sensor_range):
"""Set a given domain's cells to on if they are visible
from one of the given sensors at the given sensor_range.
>>> snp.coverage(np.zeros((5,5)),[(2,2)],2)
array([[ 0., 0., 0., 0., 0.],
[ 0., 1., 1., 1., 0.],
[ 0., 1., 1., 1., 0.],
[ 0., 1., 1., 1., 0.],
[ 0., 0., 0., 0., 0.]])
"""
for py in range(len(domain)):
for px in range(len(domain[py])):
p = (px,py)
@ -30,23 +50,52 @@ def coverage(domain,sensors,sensor_range):
break
return domain
def cover_bit(sol,domain_width,sensor_range):
domain = np.zeros((domain_width,domain_width))
sensors = []
for i in range(domain_width):
for j in range(domain_width):
if sol[i][j] == 1:
sensors.append( (j,i) )
return np.sum(coverage(domain, sensors, sensor_range))
def cover_num(sol,domain_width,sensor_range):
domain = np.zeros((domain_width,domain_width))
# Decoupled from objective functions, so as to be used in display.
def num_to_sensors(sol):
"""Convert a vector of n*2 dimension to an array of n 2-tuples.
>>> num_to_sensors([0,1,2,3])
[(0, 1), (2, 3)]
"""
sensors = []
for i in range(0,len(sol),2):
sensors.append( (sol[i],sol[i+1]) )
sensors.append( ( int(round(sol[i])), int(round(sol[i+1])) ) )
return sensors
def bit_to_sensors(sol):
"""Convert an square array of d lines/columns containing n ones
to an array of n 2-tuples with related coordinates.
>>> bit_to_sensors([[1,0],[1,0]])
[(0, 0), (0, 1)]
"""
sensors = []
for i in range(len(sol)):
for j in range(len(sol[i])):
if sol[i][j] == 1:
sensors.append( (j,i) )
return sensors
def bit_cover_sum(sol, domain_width, sensor_range):
"""Compute the coverage quality of the given array of bits."""
domain = np.zeros((domain_width,domain_width))
sensors = bit_to_sensors(sol)
return np.sum(coverage(domain, sensors, sensor_range))
def make_func(cover,**kwargs):
def num_cover_sum(sol, domain_width, sensor_range):
"""Compute the coverage quality of the given vector."""
domain = np.zeros((domain_width,domain_width))
sensors = num_to_sensors(sol)
return np.sum(coverage(domain, sensors, sensor_range))
def make_func(cover, **kwargs):
"""Make an objective function from the given function.
An objective function takes a solution and returns a scalar."""
def f(sol):
return cover(sol,**kwargs)
return f
@ -56,16 +105,22 @@ def make_func(cover,**kwargs):
# Initialization
########################################################################
def rand_num(dim):
return np.random.random(dim)
def num_rand(dim, scale):
"""Draw a random vector in [0,scale]**dim."""
return np.random.random(dim) * scale
def rand_bit(domain_width,nb_sensors):
domain = np.zeros((domain_width,domain_width))
for x,y in np.random.randint(0,domain_width,(nb_sensors,2)):
def bit_rand(domain_width, nb_sensors):
""""Draw a random domain containing nb_sensors ones."""
domain = np.zeros( (domain_width,domain_width) )
for x,y in np.random.randint(0, domain_width, (nb_sensors, 2)):
domain[y][x] = 1
return domain
def make_init(init,**kwargs):
def make_init(init, **kwargs):
"""Make an initialization operator from the given function.
An init. op. returns a solution."""
def f():
return init(**kwargs)
return f
@ -75,21 +130,29 @@ def make_init(init,**kwargs):
# Neighborhood
########################################################################
def neighb_num_rect(sol, scale):
return np.random.random(len(sol)) * scale - scale/2
def num_neighb_square(sol, scale):
"""Draw a random vector in a square of witdh `scale`
around the given one."""
return sol + np.random.random(len(sol)) * scale - scale/2
def neighb_bit_rect(sol, scale):
# Copy, because Python pass by reference.
def bit_neighb_square(sol, scale):
"""Draw a random array by moving ones to adjacent cells."""
# Copy, because Python pass by reference
# and we may not the to alter the original solution.
new = copy.copy(sol)
for yy in range(len(sol)):
for xx in range(len(sol[yy])):
if sol[yy][xx] == 1:
new[yy][xx] = 0
for py in range(len(sol)):
for px in range(len(sol[py])):
if sol[py][px] == 1:
new[py][px] = 0 # Remove original position.
d = np.random.randint(-scale//2,scale//2,2)
new[yy+y(d)][xx+x(d)] = 1
new[py+y(d)][px+x(d)] = 1
return new
def make_neig(neighb,**kwargs):
def make_neig(neighb, **kwargs):
"""Make an neighborhood operator from the given function.
A neighb. op. takes a solution and returns another one."""
def f(sol):
return neighb(sol, **kwargs)
return f
@ -99,14 +162,18 @@ def make_neig(neighb,**kwargs):
# Stopping criterions
########################################################################
def iters_nb(val,sol,nb_it):
for i in range(nb_it):
yield i
yield i
def iter_max(val, sol, nb_it):
"""Return a generator of nb_it items."""
# Directly return the `range` generator.
return range(nb_it)
def make_iter(iters,nb_it):
def cont(val,sol):
return iters(val,sol,nb_it)
def make_iter(iters, **kwargs):
"""Make an iterations operator from the given function.
A iter. op. takes a value and a solution and returns
the current number of iterations."""
def cont(val, sol):
return iters(val, sol, **kwargs)
return cont
@ -115,6 +182,7 @@ def make_iter(iters,nb_it):
########################################################################
def search(func, init, neighb, iters):
"""Iterative randomized heuristic template."""
best_sol = init()
best_val = func(best_sol)
for i in iters(best_val, best_sol):
@ -125,33 +193,97 @@ def search(func, init, neighb, iters):
best_sol = sol
return val,sol
# TODO add a population-based stochastic heuristic template.
########################################################################
# Interface
########################################################################
if __name__=="__main__":
import argparse
# Dimension of the search space.
d = 2
nb_sensors = 3
sensor_range = 2
domain_width = 10
# domain = np.zeros((domain_width,domain_width))
# domain = coverage(domain,[(10,50),(40,80)],50)
# plt.imshow(domain)
# plt.show()
can = argparse.ArgumentParser()
print(
search(
make_func(cover_num, domain_width=domain_width, sensor_range=sensor_range),
make_init(rand_num, dim=d * nb_sensors),
make_neig(neighb_num_rect, scale=domain_width/10),
make_iter(iters_nb,10)
can.add_argument("-n", "--nb-sensors", metavar="NB", default=3, type=int,
help="Number of sensors")
can.add_argument("-r", "--sensor-range", metavar="RATIO", default=0.3, type=float,
help="Sensors' range (as a fraction of domain width)")
can.add_argument("-w", "--domain-width", metavar="NB", default=100, type=int,
help="Domain width (a number of cells)")
can.add_argument("-i", "--iters", metavar="NB", default=100, type=int,
help="Maximum number of iterations")
can.add_argument("-s", "--seed", metavar="VAL", default=0, type=int,
help="Random pseudo-generator seed (0 for epoch)")
solvers = ["num_greedy","bit_greedy"]
can.add_argument("-m", "--solver", metavar="NAME", choices=solvers, default="num_greedy",
help="Solver to use, among: "+", ".join(solvers))
# TODO add the corresponding stopping criterion.
can.add_argument("-t", "--target", metavar="VAL", default=1e-3, type=float,
help="Function value target delta")
the = can.parse_args()
# Minimum checks.
assert(0 < the.nb_sensors)
assert(0 < the.sensor_range <= 1)
assert(0 < the.domain_width)
assert(0 < the.iters)
# Do not forget the seed option,
# in case you would start "runs" in parallel.
np.random.seed(the.seed)
domain = np.zeros((the.domain_width, the.domain_width))
if the.solver == "num_greedy":
val,sol = search(
make_func(num_cover_sum,
domain_width = the.domain_width,
sensor_range = the.sensor_range * the.domain_width),
make_init(num_rand,
dim = d * the.nb_sensors,
scale = the.domain_width),
make_neig(num_neighb_square,
scale = the.domain_width/10), # TODO think of an alternative.
make_iter(iter_max,
nb_it = the.iters)
)
)
sensors = num_to_sensors(sol)
print(
search(
make_func(cover_bit, domain_width=domain_width, sensor_range=sensor_range),
make_init(rand_bit, domain_width=domain_width, nb_sensors=nb_sensors),
make_neig(neighb_bit_rect, scale=3),
make_iter(iters_nb,10)
elif the.solver == "bit_greedy":
val,sol = search(
make_func(bit_cover_sum,
domain_width = the.domain_width,
sensor_range = the.sensor_range),
make_init(bit_rand,
domain_width = the.domain_width,
nb_sensors = the.nb_sensors),
make_neig(bit_neighb_square,
scale = the.domain_width/10),
make_iter(iter_max,
nb_it = the.iters)
)
)
sensors = bit_to_sensors(sol)
# TODO add a simulated annealing solver.
# Fancy output.
print(val,":",sensors)
domain = coverage(domain, sensors,
the.sensor_range * the.domain_width)
domain = highlight_sensors(domain, sensors)
plt.imshow(domain)
plt.show()