NINavTeqHelper Class Reference

#include <NINavTeqHelper.h>

---

Detailed Description

Some parser methods shared around several formats containing NavTeq-Nets.

Networks from NavTeq ofte use categories for speed limits and the number of lanes. This class parses such categories and converts them into proper values.

Definition at line 54 of file NINavTeqHelper.h.

Static Public Member Functions
static void	addVehicleClasses (NBEdge &e, const std::string &classS) throw ()
	Adds vehicle classes parsing the given list of allowed vehicles.
static unsigned int	getLaneNumber (const std::string &id, const std::string &laneNoS, SUMOReal speed) throw (ProcessError)
	Returns the lane number evaluating the given Navteq-description.
static SUMOReal	getSpeed (const std::string &id, const std::string &speedClassS) throw (ProcessError)
	Returns the speed evaluating the given Navteq-description.
Static Protected Member Functions
static void	addVehicleClass (NBEdge &e, SUMOVehicleClass c) throw ()
	Adds a single vehicle class to all lanes of the given edge.

---

Member Function Documentation

void NINavTeqHelper::addVehicleClass	(	NBEdge &	e,
		SUMOVehicleClass	c
	)			throw () [static, protected]

Adds a single vehicle class to all lanes of the given edge.

Parameters:

[in]	e	The edge to set the vehicle class into
[in]	c	The class to set (allow)

Definition at line 157 of file NINavTeqHelper.cpp.

                                                                     {
    for (unsigned int i=0; i<e.getNoLanes(); i++) {
        e.allowVehicleClass(i, c);
    }
}

void NINavTeqHelper::addVehicleClasses	(	NBEdge &	e,
		const std::string &	classS
	)			throw () [static]

Adds vehicle classes parsing the given list of allowed vehicles.

Parses the given class-string and sets all set (allowed) vehicle types into the given edge using "addVehicleClass".

Parameters:

[in]	e	The edge to set the parsed vehicle classes into
[in]	classS	The string that contains the information whether a vehicle class is allowed

See also:

addVehicleClass

Definition at line 107 of file NINavTeqHelper.cpp.

References SVC_BICYCLE, SVC_BUS, SVC_DELIVERY, SVC_HOV, SVC_PASSENGER, SVC_PEDESTRIAN, SVC_PUBLIC_EMERGENCY, SVC_PUBLIC_TRANSPORT, SVC_TAXI, and SVC_TRANSPORT.

Referenced by NIImporter_DlrNavteq::EdgesHandler::report().

                                                                             {
    std::string classS = "0000000000" + oclassS;
    classS = classS.substr(classS.length() - 10);
    // 0: allow all vehicle types
    if (classS[0]=='1') {
        return;
    }
    // Passenger cars -- becomes SVC_PASSENGER
    if (classS[1]=='1') {
        addVehicleClass(e, SVC_PASSENGER);
    }
    // High Occupancy Vehicle -- becomes SVC_PASSENGER|SVC_HOV
    if (classS[2]=='1') {
        addVehicleClass(e, SVC_HOV);
        addVehicleClass(e, SVC_PASSENGER);
    }
    // Emergency Vehicle -- becomes SVC_PUBLIC_EMERGENCY
    if (classS[3]=='1') {
        addVehicleClass(e, SVC_PUBLIC_EMERGENCY);
    }
    // Taxi -- becomes SVC_PASSENGER|SVC_TAXI
    if (classS[4]=='1') {
        addVehicleClass(e, SVC_TAXI);
        addVehicleClass(e, SVC_PASSENGER);
    }
    // Public Bus -- becomes SVC_BUS|SVC_PUBLIC_TRANSPORT
    if (classS[5]=='1') {
        addVehicleClass(e, SVC_PUBLIC_TRANSPORT);
        addVehicleClass(e, SVC_BUS);
    }
    // Delivery Truck -- becomes SVC_DELIVERY
    if (classS[6]=='1') {
        addVehicleClass(e, SVC_DELIVERY);
    }
    // Transport Truck -- becomes SVC_TRANSPORT
    if (classS[7]=='1') {
        addVehicleClass(e, SVC_TRANSPORT);
    }
    // Bicycle -- becomes SVC_BICYCLE
    if (classS[8]=='1') {
        addVehicleClass(e, SVC_BICYCLE);
    }
    // Pedestrian -- becomes SVC_PEDESTRIAN
    if (classS[9]=='1') {
        addVehicleClass(e, SVC_PEDESTRIAN);
    }
}

unsigned int NINavTeqHelper::getLaneNumber	(	const std::string &	id,
		const std::string &	laneNoS,
		SUMOReal	speed
	)			throw (ProcessError) [static]

Returns the lane number evaluating the given Navteq-description.

Parameters:

[in]	id	The id of the edge (for debug-output)
[in]	laneNoS	The string that describes the number of lanes
[in]	speed	An additional hint for guessing the proper lane number

Returns:

The converted lane number

Exceptions:

ProcessError

If the given lane number definition is not a number or if it is not known

Definition at line 77 of file NINavTeqHelper.cpp.

References TplConvert< E >::_2int().

Referenced by NIImporter_DlrNavteq::EdgesHandler::report().

                                                                                                               {
    try {
        int nolanes = TplConvert<char>::_2int(laneNoS.c_str());
        if (nolanes<0) {
            return 1;
        } else if (nolanes/10 > 0) {
            return nolanes / 10;
        } else {
            switch (nolanes%10) {
            case 1:
                return 1;
            case 2:
                nolanes = 2;
                if (speed>78.0/3.6) {
                    nolanes = 3;
                }
                return nolanes;
            case 3:
                return 4;
            default:
                throw ProcessError("Invalid lane number (edge '" + id + "').");
            }
        }
    } catch (NumberFormatException &) {
        throw ProcessError("Non-numerical value for an edge's lane number occured (edge '" + id + "'.");
    }
}

SUMOReal NINavTeqHelper::getSpeed	(	const std::string &	id,
		const std::string &	speedClassS
	)			throw (ProcessError) [static]

Returns the speed evaluating the given Navteq-description.

This method tries to parse the speed category into its int-representation and to determine the speed that is assigned to the category. If either of both steps can not be perfored, a ProcessError is thrown.

Parameters:

[in]	id	The id of the edge (for debug-output)
[in]	speedClassS	The string that describes the speed class

Returns:

The converted speed (in m/s)

Exceptions:

ProcessError

If the given speed class definition is not a number or if it is not known

Definition at line 45 of file NINavTeqHelper.cpp.

References TplConvert< E >::_2int(), and SUMOReal.

Referenced by NIImporter_DlrNavteq::EdgesHandler::report().

                                                                                              {
    try {
        int speedClass = TplConvert<char>::_2int(speedClassS.c_str());
        switch (speedClass) {
        case -1:
            return (SUMOReal) 1.0 / (SUMOReal) 3.6;
        case 1:
            return (SUMOReal) 200 / (SUMOReal) 3.6; //> 130 KPH / > 80 MPH
        case 2:
            return (SUMOReal) 120 / (SUMOReal) 3.6; //101-130 KPH / 65-80 MPH
        case 3:
            return (SUMOReal) 100 / (SUMOReal) 3.6; // 91-100 KPH / 55-64 MPH
        case 4:
            return (SUMOReal) 80 / (SUMOReal) 3.6; // 71-90 KPH / 41-54 MPH
        case 5:
            return (SUMOReal) 70 / (SUMOReal) 3.6; // 51-70 KPH / 31-40 MPH
        case 6:
            return (SUMOReal) 50 / (SUMOReal) 3.6; // 31-50 KPH / 21-30 MPH
        case 7:
            return (SUMOReal) 30 / (SUMOReal) 3.6; // 11-30 KPH / 6-20 MPH
        case 8:
            return (SUMOReal) 5 / (SUMOReal) 3.6; //< 11 KPH / < 6 MPH
        default:
            throw ProcessError("Invalid speed code (edge '" + id + "').");
        }
    } catch (NumberFormatException &) {
        throw ProcessError("Non-numerical value for an edge's speed type occured (edge '" + id + "').");
    }
}

---

The documentation for this class was generated from the following files:

• NINavTeqHelper.h
• NINavTeqHelper.cpp