GeomHelper.h

Go to the documentation of this file.

/****************************************************************************/
// Eclipse SUMO, Simulation of Urban MObility; see https://eclipse.dev/sumo
// Copyright (C) 2001-2024 German Aerospace Center (DLR) and others.
// This program and the accompanying materials are made available under the
// terms of the Eclipse Public License 2.0 which is available at
// https://www.eclipse.org/legal/epl-2.0/
// This Source Code may also be made available under the following Secondary
// Licenses when the conditions for such availability set forth in the Eclipse
// Public License 2.0 are satisfied: GNU General Public License, version 2
// or later which is available at
// https://www.gnu.org/licenses/old-licenses/gpl-2.0-standalone.html
// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-or-later
/****************************************************************************/
// Some static methods performing geometrical operations
/****************************************************************************/
#pragma once
#include <config.h>
 
#include <cmath>
#include "Position.h"
#include "PositionVector.h"
#include <utils/common/UtilExceptions.h>
 
#ifndef M_PI
#define M_PI 3.1415926535897932384626433832795
#endif
 
#define DEG2RAD(x) static_cast<double>((x) * M_PI / 180.)
#define RAD2DEG(x) static_cast<double>((x) * 180. / M_PI)
#define GRAVITY 9.80665
 
 
// ===========================================================================
// class definitions
// ===========================================================================
class GeomHelper {
 
public:
    static const double INVALID_OFFSET;
 
    static void findLineCircleIntersections(const Position& c, double radius, const Position& p1, const Position& p2,
                                            std::vector<double>& into);
 
 
    static double angle2D(const Position& p1, const Position& p2);
 
    static double nearest_offset_on_line_to_point2D(
        const Position& lineStart, const Position& lineEnd,
        const Position& p, bool perpendicular = true);
 
    static double nearest_offset_on_line_to_point25D(
        const Position& lineStart, const Position& lineEnd,
        const Position& p, bool perpendicular = true);
 
    static Position crossPoint(const Boundary& b,
                               const PositionVector& v);
 
    static double getCCWAngleDiff(double angle1, double angle2);
 
 
    static double getCWAngleDiff(double angle1, double angle2);
 
 
    static double getMinAngleDiff(double angle1, double angle2);
 
 
    static double angleDiff(const double angle1, const double angle2);
 
 
    static double naviDegree(const double angle);
 
    static double fromNaviDegree(const double angle);
 
    static double legacyDegree(const double angle, const bool positive = false);
 
    static PositionVector makeCircle(const double radius, const Position& center, unsigned int nPoints);
 
    static PositionVector makeRing(const double radius1, const double radius2, const Position& center, unsigned int nPoints);
 
    static const Position calculateLotSpacePosition(const PositionVector& shape, const int index,
            const double spaceDim, const double angle, const double width, const double length);
 
    static double calculateLotSpaceAngle(const PositionVector& shape, const int index, const double spaceDim, const double angle);
 
    static double calculateLotSpaceSlope(const PositionVector& shape, const int index, const double spaceDim);
};