Provides tools to facilitate working with numpy and the geometry and attributes of spatial data. The focus is largely on array/raster/grid data and vector geometry (ie featureclasses in ArcGIS Pro).

A couple of useful ditties to get a string representation of functions in a module. The first uses a simple dir, the second is for modules that have __all__ defined

import arraytools as art

print(", ".join([i.replace("'", "") for i in dir(art.tools)])  # art.(script/module to import)

print(", ".join([i.replace("'", "") for i in art.--module--.__all__]))

• arraytools ...Tools for working with numpy arrays
  • _basic.py
    • arr_info, keep_ascii, is_float, keep_nums, del_punc, n_largest, n_smallest, num_to_nan, num_to_mask, even_odd, pad_even_odd, pad_nan, pad_zero, shape_to2D, reshape_options
  • _io.py
    • load_npy, save_npy, load_txt, save_txt, arr_json, dict_arrays, iterable_dict, dict_struct, struct_dict, excel_np
  • frmts.py
    • col_hdr, deline, in_by, redent, _chunks, head_tail, _check, _slice_rows, _slice_cols, _slice_head_tail, _col_format, prn_nd, prn_ma, prn_rec, pd_, prn_struct, make_row_format, prn_, prn
  • geom.py
    • close_arr, stride, poly2segments, intersect_pnt, intersects, cartesian_dist, densify_by_factor, _convert, densify, simplify, rotate, trans_rot, pnt_in_list, pnt_on_seg, pnts_on_line, pnt_on_poly, point_in_polygon, knn, nn_kdtree, cross, remove_self, adjacency_edge
  • geom_common.py
    • _new_view_, _reshape_, _view_
  • geom_create.py
    • arc_, arc_sector, circle, circle_mini, circle_ring, ellipse, hex_flat, hex_pointy, convex, mesh_xy, pyramid, rectangle, triangle, pnt_from_dist_bearing, xy_grid, transect_lines
  • geom_properties.py
    • max_, median_, min_, extent_, center_, centers, centroid_, centroids, e_area, e_dist, e_leng, areas, lengths, total_length, seg_lengths, dx_dy_np, angle_np, azim_np, angle_between, angle_2pnts, angle_seq, angles_poly, orig_dest_angle, line_dir
  • grid.py
    • check_shapes, combine_, euc_dist, euc_alloc, expand_, shrink_, regions_, expand_zone, fill_arr, reclass_vals, reclass_ranges, scale_up
  • image.py
    • _even_odd, _pad_even_odd, _pad_nan, _pad_zero, a_filter, block, equalize, normalize, plot_img, rgb_gray, stride
  • ndset.py
    • view_as, check_dtype, nd_diff, nd_diffxor, nd_intersect, nd_isin, nd_merge, nd_union, nd_uniq
  • py_tools.py
    • comp_info, get_dir, folders, sub_folders, dir_py, _flatten, flatten_shape, pack, unpack, combine_dicts
  • stackstats.py
    • check_shapes, check_stack, mask_stack, stack_sum, stack_cumsum, stack_prod, stack_cumprod, stack_min, stack_mean, stack_median, stack_max, stack_std, stack_var, stack_percentile, stack_stats, stack_stats_tbl
  • surface.py
    • a2z, all_f, angle2azim, aspect_a, aspect_dem, circ_demo, circle_a, cross_f, dedent, filter_a, hillshade_a, kernels, no_cnt, pad_a, plot_, plt, plus_f, pyramid, slope_a, stride, surface_kernel
  • tbl.py
    • find_in, tbl_replace, tbl_count, tbl_sum
  • tblstats.py
    • freq, summ, skew_kurt, _calc_stats, _numeric_fields_, col_stats, group_stats
  • tools.py
    • _tools_help_, arr2xyz, make_blocks, group_vals, reclass, scale, split_array, make_flds, nd_rec, nd_struct, nd2struct, nd2rec, rc_vals, xy_vals, arrays_struct, change_arr, concat_arrs, pad_, stride, block, sliding_window_view, block_arr, rolling_stats, _func, find, group_pnts, uniq, is_in, running_count, sequences, sort_cols_by_row, sort_rows_by_col, radial_sort, pack_last_axis
  • utils.py
    • time_deco, run_deco, doc_func, get_func, get_modu, dirr, wrapper, _utils_help_

• . . . \analysis
  • array_moving.py
    • more to come

• . . . \fc_tools Many functions in this section require ArcGIS Pro be installed to access arcpy
  • _common.py
    • _describe, arr_csv, de_punc, fc_info, fld_info, null_dict, tbl_arr, tweet'
  • apt.py
    • _arr_common, _id_geom_array, _split_array, arc_np, arr_pnts, arr_polygon_fc, arr_polyline_fc, array_fc, array_struct, change_fld, dedent, fc_array, fc_info, obj_polygon, obj_polyline, output_points, output_polygons, output_polylines, pnts_arr, polygons_arr, polylines_arr, shapes_fc, struct_polygon, struct_polyline, tbl_arr, to_fc, tweet'
  • arc_io.py
    • array2raster, rasters2nparray,
    • more to come
  • fc.py
    • _cross_3pnts, _cursor_array, _geo_array, _get_shapes, _ndarray, _props, _two_arrays, _xy, _xyID, _xy_idx, change_fld, fc_info, ft, indent, join_arr_fc,obj_array, orig_dest_pnts, tweet, warnings'

• . . . \geomtools
  • circular.py
    • plot_, rot_matrix, _arc, _circle, arc_sector buffer_ring
  • hulls.py
    • concave, convex
  • mesh_pnts.py
  • mst.py
  • n_spaced.py
  • pip.py
  • split_polys.py
    • more to come

• . . . \graphing

• . . . \rasters

• . . . \stats

It is assumed throughout that numpy has been imported as

import numpy as np

a_io.py (9) io tools for numpy arrays

1.  load_npy      - load numpy npy files
2.  save_npy      - save array to *.npy format
3.  read_txt      - read array created by save_txtt
4.  save_txt      - save array to npy format
5.  arr_json      - save to json format
6.  dict_arrays   - dictionary to arrays
7.  iterable_dict - iterable to dictionary
8.  dict_struct   - dictionary to structured array
9.  struct_dict   - structured array to dictionary
10. excel_np      - excel xls/xlsx to numpy structured array using xlrd

data_maker.py Various functions for creating data. Functions for numeric and text data conforming to random sampling distributions.

frmts.py (18) Format options to facilitate viewing of numpy arrays in a variety of ways.

1.  col_hdr           column headers
2.  deline            remove excessive blank lines
3.  in_by             an indent variant with options 
4.  redent            indent
5.  _chunks           take chunks of stuff
6.  head_tail         return the head/tail of a 1d array
7.  _check            helper functions
8.  _slice_rows
9.  _slice_cols
10. _slice_head_tail
11. _col_format        printing section
12. prn_nd             for ndarray
13. prn_ma             for masked arrays
14. prn_rec pd_        record/structured arrays
15. prn_struct
16. make_row_format    a big helper function
17. prn_               ndarray variant
18. prn         ---- this def is used to call all the others ----

geom.py (40) Geometry related functions

1. helpers
   _flat_, _unpack, segment, stride, _new_view_, _view_, _reshape_,
2. boundary
   _min, _max, _extent,
3. centrality
   _center, _centroid, centers, centroids,
4. area, length, distance
   e_area, e_dist, e_leng, areas, lengths, total_length, seg_lengths,
5. sorting
   radial_sort
6. angles
   dx_dy_np, angle_np, azim_np, angle_2pnts, angle_seq, angles_poly, dist_bearing,
7. densify, simplify
   _densify_2D, _convert, densify, simplify,
8. property alteration
   rotate,  trans_rot, repeat,
9. construction
   circle, ellipse, rectangle, hex_flat, hex_pointy

grid.py: () Reclassification, array restructuring

1. 3D array helper functions
     combine_, check_shapes, check_stack, mask_stack,
2. moving to grid_stats below!!!
3. other functions
   expand_zone, fill_arr, reclass_vals, reclass_ranges, scale_up

graphing: Graphing capabilities using MatPlotLib as the basic graphing program plot_pnts_

grid_stats.py: Statistical functions for 3D-stacks of array data, like annual temperature data etc. Whatever can be stacked and is numeric.... you can get the stats for. Moving window functions are also contained for all stats.

1. 3D array helper functions
   check_shapes, check_stack, mask_stack
2. statistical functions
   stack_sum, stack_cumsum, stack_prod, stack_cumprod, stack_min, stack_mean,
   stack_median, stack_max, stack_std, stack_var, stack_percentile, stack_stats,
   stack_stats_tbl

image.py:

1. helper functions
   _even_odd, _pad_even_odd, _pad_nan, _pad_zero,
2. image processing filtering
   a_filter
3. graphing
   plot_img',
4. conversion/alteration
   rgb_gray, normalize, equalize

py_tools.py:

1. computer information
   comp_info
2. basic folder functions
   get_dir, folders, sub_folders
3. object and directory functions
   dir_py, _flatten, flatten_shape
4. iterables
   pack, unpack, combine_dicts

surface.py:

tbl.py:

tools.py (30) Main tool set containing the following functions...

:all_art:

 'doc_func', 'get_func', 'get_modu', 'info', 'num_to_nan', 'num_to_mask', 'make_blocks',
 'make_flds', 'rec_arr', 'arr2xyz', 'change_arr', 'nd2struct', 'scale', 'split_array', 'stride',
 '_pad_', 'block', 'block_arr', 'find', '_func', 'group_pnts', 'group_vals', 'reclass',
 'rolling_stats', 'uniq', 'is_in', 'n_largest', 'n_smallest', 'rc_vals', 'xy_vals',
 'sort_rows_by_col', 'sort_cols_by_row', '_help'

analysis: (5) Tools for calculating distance, proximity, angles.

:all 'compass', 'line_dir', 'not_closer', 'n_near', 'vincenty'

stats: Statistics and related crosstab

other: Placeholder

fc.py (11) tools for working with featureclasses :all_fc

'_get_shapes', '_ndarray', '_props', '_two_arrays', '_xy',
'_xyID', '_xy_idx', 'change_fld'

examples: Documentation for *.py script, will have the same name but end with *.txt.