libpysal API reference

Spatial Weights

libpysal.weights.W(neighbors[, weights, …]) Spatial weights class.

Distance Weights

libpysal.weights.DistanceBand(data, threshold) Spatial weights based on distance band.
libpysal.weights.Kernel(data[, bandwidth, …]) Spatial weights based on kernel functions.
libpysal.weights.KNN(data[, k, p, ids, …]) Creates nearest neighbor weights matrix based on k nearest neighbors.

Contiguity Weights

libpysal.weights.Queen(polygons, **kw) Construct a weights object from a collection of pysal polygons that share at least one vertex.
libpysal.weights.Rook(polygons, **kw) Construct a weights object from a collection of pysal polygons that share at least one edge.
libpysal.weights.Voronoi(points) Voronoi weights for a 2-d point set
libpysal.weights.W(neighbors[, weights, …]) Spatial weights class.

spint Weights

libpysal.weights.WSP(sparse[, id_order]) Thin W class for spreg.
libpysal.weights.netW(link_list[, share, …]) Create a network-contiguity based weight object based on different nodal relationships encoded in a network.
libpysal.weights.mat2L(edge_matrix) Convert a matrix denoting network connectivity (edges or flows) to a list denoting edges
libpysal.weights.ODW(Wo, Wd[, transform, …]) Constructs an o*d by o*d origin-destination style spatial weight for o*d flows using standard spatial weights on o origins and d destinations.
libpysal.weights.vecW(origin_x, origin_y, …) Distance-based spatial weight for vectors that is computed using a 4-dimensional distance between the origin x,y-coordinates and the destination x,y-coordinates

Weights Util Classes and Functions

libpysal.weights.block_weights(regimes[, …]) Construct spatial weights for regime neighbors.
libpysal.weights.lat2W([nrows, ncols, rook, …]) Create a W object for a regular lattice.
libpysal.weights.comb(items[, n]) Combinations of size n taken from items
libpysal.weights.order(w[, kmax]) Determine the non-redundant order of contiguity up to a specific order.
libpysal.weights.higher_order(w[, k]) Contiguity weights object of order k.
libpysal.weights.shimbel(w) Find the Shimbel matrix for first order contiguity matrix.
libpysal.weights.remap_ids(w, old2new[, …]) Remaps the IDs in a spatial weights object.
libpysal.weights.full2W(m[, ids]) Create a PySAL W object from a full array.
libpysal.weights.full(w) Generate a full numpy array.
libpysal.weights.WSP2W(wsp[, silence_warnings]) Convert a pysal WSP object (thin weights matrix) to a pysal W object.
libpysal.weights.get_ids(in_shps, idVariable) Gets the IDs from the DBF file that moves with a given shape file or a geopandas.GeoDataFrame.
libpysal.weights.get_points_array_from_shapefile(…) Gets a data array of x and y coordinates from a given shapefile.

Weights user Classes and Functions

libpysal.weights.min_threshold_distance(data) Get the maximum nearest neighbor distance.
libpysal.weights.lat2SW([nrows, ncols, …]) Create a sparse W matrix for a regular lattice.
libpysal.weights.w_local_cluster(w) Local clustering coefficients for each unit as a node in a graph.
libpysal.weights.higher_order_sp(w[, k, …]) Contiguity weights for either a sparse W or W for order k.
libpysal.weights.hexLat2W([nrows, ncols]) Create a W object for a hexagonal lattice.
libpysal.weights.attach_islands(w, w_knn1) Attach nearest neighbor to islands in spatial weight w.
libpysal.weights.nonplanar_neighbors(w, …) Detect neighbors for non-planar polygon collections
libpysal.weights.fuzzy_contiguity(*args, …)
libpysal.weights.min_threshold_dist_from_shapefile(…) Get the maximum nearest neighbor distance between observations in the shapefile.
libpysal.weights.build_lattice_shapefile(…) Build a lattice shapefile with nrows rows and ncols cols.
libpysal.weights.spw_from_gal(galfile) Sparse scipy matrix for w from a gal file.

Set Theoretic Weights

libpysal.weights.w_union(w1, w2[, …]) Returns a binary weights object, w, that includes all neighbor pairs that exist in either w1 or w2.
libpysal.weights.w_intersection(w1, w2[, …]) Returns a binary weights object, w, that includes only those neighbor pairs that exist in both w1 and w2.
libpysal.weights.w_difference(w1, w2[, …]) Returns a binary weights object, w, that includes only neighbor pairs in w1 that are not in w2.
libpysal.weights.w_symmetric_difference(w1, w2) Returns a binary weights object, w, that includes only neighbor pairs that are not shared by w1 and w2.
libpysal.weights.w_subset(w1, ids[, …]) Returns a binary weights object, w, that includes only those observations in ids.
libpysal.weights.w_clip(w1, w2[, outSP, …]) Clip a continuous W object (w1) with a different W object (w2) so only cells where w2 has a non-zero value remain with non-zero values in w1.

Spatial Lag

libpysal.weights.lag_spatial(w, y) Spatial lag operator.
libpysal.weights.lag_categorical(w, y[, ties]) Spatial lag operator for categorical variables.

cg: Computational Geometry

alpha_shapes, alpha) Alpha-shape delineation (Edelsbrunner, Kirkpatrick & Seidel, 1983) from a collection of points …[, step, …]) Computation of alpha-shape delineation with automated selection of alpha.

voronoi[, radius]) Composite helper to return Voronoi regions and generator points as individual dataframes

sphere float(x) -> floating point number float(x) -> floating point number, pt1[, radius]) Arc distance between two points on a sphere.[, radius]) Convert an arc distance (spherical earth) to a linear distance (R3) in the unit sphere., k[, mode]) valid modes are [‘arc’,’xrz’], k[, return_dist]) Computes k nearest neighbors on a sphere., dist[, radius]) Find all neighbors on a sphere within a threshold distance[, radius]) Convert a linear distance in the unit sphere (R3) to an arc distance based on supplied radius Convert x,y,z to latitude and longitude Convert a point’s latitude and longitude to x,y,z Converts point order from lat-lon tuples to lon-lat (x,y) tuples, p1[, lonx, radius]) Alternative arc distance function, uses haversine formula, p1, t[, lonx]) Finds a point on a sphere along the great circle distance between two points on a sphere also known as a way point in great circle navigation, pdown, k[, lonx]) Computes a k+1 by k+1 set of grid points for a bounding box in lat-lon uses geointerpolate

shapes Geometric class for point objects., end_pt) Geometric representation of line segment objects., b) Geometric representation of line objects., second_p) Geometric representation of ray objects. Geometric representation of a chain, also known as a polyline.[, holes]) Geometric representation of polygon objects., lower, right, upper) Geometric representation of rectangle objects. Returns a pysal shape object from obj.

standalone, bbother) Old Stars method for bounding box overlap testing Also defined in pysal.weights._cont_binning Find bounding box for a list of geometries, ray2) Returns the angle formed between a pair of rays which share an origin get_angle_between(Ray, Ray) -> number, p2, p3) Returns whether a triplet of points is collinear., seg2) Returns the intersection of two segments., pt) Returns the intersection of a segment and point., pt) Returns the intersection of a polygon and point.…) Returns the intersection of a rectangle and point., seg) Returns the intersection of a ray and line segment., r1) Returns the intersection between two rectangles., pt) Returns the distance between a polygon and point., pt2) Returns the distance between a pair of points., pt) Returns the distance between a line segment and point and distance along the segment of the closest point on the segment to the point as a ratio of the length of the segment., …) Returns the point at a distance and angle relative to the origin of a ray. Returns the convex hull of a set of points. Returns whether a list of points describing a polygon are clockwise or counterclockwise., rect) Returns True if the point is in the rectangle or touches it’s boundary., poly2) Returns the line segments in common to both polygons.[, p, threshold]) Distance Matrices

locators, resolution) Representation of a binning data structure. An abstract representation of a point indexing data structure. An abstract representation of a polygon indexing data structure.

kdtree[, leafsize, …]) kd-tree built on top of kd-tree functionality in scipy.

io alias of[dataPath, mode, …]) Metaclass for supporting spatial data file read and write


libpysal.examples.available([verbose]) List available datasets
libpysal.examples.explain(name) Explain a dataset by name
libpysal.examples.get_path(example_name[, raw]) Get path of example folders