Package: coordgeompy
coordgeompyA simple coordinate geometry helper package. This package is developed for the UBC MDS DSCI 524 Collaborative Software Development course at the University of British Columbia.OverviewThis starter package allows users to perform various geometric operations like calculate distance between two parallel lines, distance between two n dimensional vectors, intersection of lines in 3-Dimensional space and so on. Our motivation in creating this package was to allow users with minimal experience in python coding to be able to perform these geometric calculations easily.Installation$pipinstallgit+https://github.com/UBC-MDS/CoordGeomPy.git@v1.0.0FeaturesThere are four main functions planned for development as outlined below. Additional functions may be added in the future.Function 1dist_pll_lines_2d: This function allows a user to calculate the distance between two parallel lines. This is the distance between the points where a perpendicular line intersects between the two parallel lines. This function will find that distance (d).Function 2get_distance: This function allows a user to calculate the the distance between two n dimensional vectors. Possible metrics that can be used with this function includes: Euclidean, Manhattan, Chebyshev, or MinkowskiFunction 3is_intersection_3d: This function allows a user to determine whether two infinite lines intersect in 3-dimensional space. The function will return True or False based on the input arguments.Function 4is_orthogonal: This function allows a user to determine whether two infinite lines are perpendicular in n-dimensional space. The function will return True or False based on the input arguments.While we are not really reinventing the wheel on coordinate geometry calculations with our package, we used this as an opportunity to gain some experience in understanding how these calculations function in python language. There are existing packages that execute similar functions. For example,SymPyis a Python library that contains comprehensive mathematical functions including intersection of lines, shortest distance between a point and a line etc. We also found a packagecoordinate-geometry 1.0.02that had similar functions to calculating distance between two points, a point and a line, area of a triangle etc.Scipy'sscipy.spatial.distance.cdistfunctions similarly to Function 2.Usageimport numpy as np
from coordgeompy.coordgeompy import dist_pll_lines_2d
from coordgeompy.coordgeompy import get_distance
from coordgeompy.coordgeompy import is_intersection_3d
from coordgeompy.coordgeompy import is_orthogonal

x1 <- c(1, 2, 3, 4)
x2 <- c(5, 6, 7, 8)
get_distance(x1, x2, metric="Euclidean")DocumentationThe official documentation is hosted onRead the DocsContributingInterested in contributing? Check out the contributing guidelines. Please note that this project is released with a Code of Conduct. By contributing to this project, you agree to abide by its terms.ContributorsWe welcome and recognize all contributors. Names and GitHub @usernames listed below:Arlin Cherian: @arlincherianNico Van Den Hooff: @nicovandenhooffZheren Xu: @ZherenXuJordan Casoli: @jcasoliLicensecoordgeompywas created by Jordan Casoli, Nico Van Den Hooff, Arlin Cherian and Zheren Xu. It is licensed under the terms of theCreditscoordgeompywas created withcookiecutterand thepy-pkgs-cookiecuttertemplate.