SUMO - Simulation of Urban MObility
SUMOVehicleParserHelper Class Reference

Helper methods for parsing vehicle attributes. More...

#include <SUMOVehicleParserHelper.h>

Collaboration diagram for SUMOVehicleParserHelper:
Collaboration graph

Static Public Member Functions

static SUMOVTypeParameterbeginVTypeParsing (const SUMOSAXAttributes &attrs, const std::string &file)
 Starts to parse a vehicle type. More...
 
static void closeVTypeParsing (SUMOVTypeParameter &vtype)
 Closes parsing of the vehicle type. More...
 
static SUMOEmissionClass parseEmissionClass (const SUMOSAXAttributes &attrs, const std::string &id)
 Parses the vehicle emission class. More...
 
static SUMOVehicleParameterparseFlowAttributes (const SUMOSAXAttributes &attrs, const SUMOTime beginDefault, const SUMOTime endDefault)
 Parses a flow's attributes. More...
 
static SUMOVehicleShape parseGuiShape (const SUMOSAXAttributes &attrs, const std::string &id)
 Parses the vehicle class. More...
 
static SUMOVehicleParameterparseVehicleAttributes (const SUMOSAXAttributes &attrs, const bool optionalID=false, const bool skipDepart=false, const bool isPerson=false)
 Parses a vehicle's attributes. More...
 
static SUMOVehicleClass parseVehicleClass (const SUMOSAXAttributes &attrs, const std::string &id)
 Parses the vehicle class. More...
 
static void parseVTypeEmbedded (SUMOVTypeParameter &into, int element, const SUMOSAXAttributes &attrs, bool fromVType=false)
 Parses an element embedded in vtype definition. More...
 

Private Types

typedef std::map< SumoXMLTag, std::set< SumoXMLAttr > > CFAttrMap
 

Static Private Member Functions

static const CFAttrMapgetAllowedCFModelAttrs ()
 
static void parseCommonAttributes (const SUMOSAXAttributes &attrs, SUMOVehicleParameter *ret, std::string element)
 Parses attributes common to vehicles and flows. More...
 

Static Private Attributes

static CFAttrMap allowedCFModelAttrs
 

Detailed Description

Helper methods for parsing vehicle attributes.

This class supports helper methods for parsing a vehicle's attributes.

Definition at line 55 of file SUMOVehicleParserHelper.h.

Member Typedef Documentation

typedef std::map<SumoXMLTag, std::set<SumoXMLAttr> > SUMOVehicleParserHelper::CFAttrMap
private

Definition at line 186 of file SUMOVehicleParserHelper.h.

Member Function Documentation

SUMOVTypeParameter * SUMOVehicleParserHelper::beginVTypeParsing ( const SUMOSAXAttributes attrs,
const std::string &  file 
)
static

Starts to parse a vehicle type.

Parameters
[in]attrThe SAX-attributes to get vehicle parameter from
[in]fileThe name of the file being parsed (for resolving paths)
Exceptions
ProcessErrorIf an attribute's value is invalid
See also
SUMOVTypeParameter
Note
: the caller is responsible for deleting the returned pointer

Definition at line 323 of file SUMOVehicleParserHelper.cpp.

References SUMOVTypeParameter::boardingDuration, SUMOXMLDefinitions::CarFollowModels, SUMOVTypeParameter::cfModel, SUMOVTypeParameter::color, SUMOVTypeParameter::containerCapacity, SUMOVTypeParameter::defaultProbability, SUMOVTypeParameter::emissionClass, SUMOSAXAttributes::get(), StringBijection< T >::get(), FileHelpers::getConfigurationRelative(), SUMOSAXAttributes::getSUMOTimeReporting(), SUMOSAXAttributes::hasAttribute(), SUMOVTypeParameter::height, SUMOVTypeParameter::id, SUMOVTypeParameter::imgFile, SUMOVTypeParameter::impatience, FileHelpers::isAbsolute(), SUMOXMLDefinitions::LaneChangeModels, SUMOVTypeParameter::lcModel, SUMOVTypeParameter::length, SUMOVTypeParameter::loadingDuration, max, SUMOVTypeParameter::maxSpeed, SUMOVTypeParameter::minGap, SUMOVTypeParameter::osgFile, parseEmissionClass(), parseGuiShape(), parseVehicleClass(), parseVTypeEmbedded(), SUMOVTypeParameter::personCapacity, SUMOVTypeParameter::setParameter, SUMOVTypeParameter::shape, SUMOVTypeParameter::speedDev, SUMOVTypeParameter::speedFactor, SUMO_ATTR_BOARDING_DURATION, SUMO_ATTR_CAR_FOLLOW_MODEL, SUMO_ATTR_COLOR, SUMO_ATTR_CONTAINER_CAPACITY, SUMO_ATTR_EMISSIONCLASS, SUMO_ATTR_GUISHAPE, SUMO_ATTR_HEIGHT, SUMO_ATTR_ID, SUMO_ATTR_IMGFILE, SUMO_ATTR_IMPATIENCE, SUMO_ATTR_LANE_CHANGE_MODEL, SUMO_ATTR_LENGTH, SUMO_ATTR_LOADING_DURATION, SUMO_ATTR_MAXSPEED, SUMO_ATTR_MINGAP, SUMO_ATTR_OSGFILE, SUMO_ATTR_PERSON_CAPACITY, SUMO_ATTR_PROB, SUMO_ATTR_SPEEDDEV, SUMO_ATTR_SPEEDFACTOR, SUMO_ATTR_VCLASS, SUMO_ATTR_WIDTH, SUMOReal, SVC_PASSENGER, VTYPEPARS_BOARDING_DURATION, VTYPEPARS_CAR_FOLLOW_MODEL, VTYPEPARS_COLOR_SET, VTYPEPARS_CONTAINER_CAPACITY, VTYPEPARS_EMISSIONCLASS_SET, VTYPEPARS_HEIGHT_SET, VTYPEPARS_IMGFILE_SET, VTYPEPARS_IMPATIENCE_SET, VTYPEPARS_LANE_CHANGE_MODEL_SET, VTYPEPARS_LENGTH_SET, VTYPEPARS_LOADING_DURATION, VTYPEPARS_MAXSPEED_SET, VTYPEPARS_MINGAP_SET, VTYPEPARS_OSGFILE_SET, VTYPEPARS_PERSON_CAPACITY, VTYPEPARS_PROBABILITY_SET, VTYPEPARS_SHAPE_SET, VTYPEPARS_SPEEDDEVIATION_SET, VTYPEPARS_SPEEDFACTOR_SET, VTYPEPARS_VEHICLECLASS_SET, VTYPEPARS_WIDTH_SET, SUMOVTypeParameter::width, WRITE_ERROR, and RGBColor::YELLOW.

Referenced by MSStateHandler::myStartElement(), and SUMORouteHandler::myStartElement().

static void SUMOVehicleParserHelper::closeVTypeParsing ( SUMOVTypeParameter vtype)
inlinestatic

Closes parsing of the vehicle type.

Returns
The resulting vehicle type parameter
See also
SUMOVTypeParameter

Definition at line 116 of file SUMOVehicleParserHelper.h.

References parseCommonAttributes(), parseEmissionClass(), parseGuiShape(), parseVehicleClass(), and UNUSED_PARAMETER.

Referenced by SUMORouteHandler::myEndElement().

void SUMOVehicleParserHelper::parseCommonAttributes ( const SUMOSAXAttributes attrs,
SUMOVehicleParameter ret,
std::string  element 
)
staticprivate

Parses attributes common to vehicles and flows.

Parses all attributes stored in "SUMOVehicleParameter".

See also
SUMOVehicleParameter
Parameters
[in]attrThe SAX-attributes to get vehicle parameter from
[out]retThe parameter to parse into
[in]elementThe name of the element (vehicle or flow)
Exceptions
ProcessErrorIf an attribute's value is invalid

Definition at line 218 of file SUMOVehicleParserHelper.cpp.

References SUMOVehicleParameter::arrivalLane, SUMOVehicleParameter::arrivalLaneProcedure, SUMOVehicleParameter::arrivalPos, SUMOVehicleParameter::arrivalPosProcedure, SUMOVehicleParameter::arrivalSpeed, SUMOVehicleParameter::arrivalSpeedProcedure, SUMOVehicleParameter::color, SUMOVehicleParameter::containerNumber, RGBColor::DEFAULT_COLOR, SUMOVehicleParameter::departLane, SUMOVehicleParameter::departLaneProcedure, SUMOVehicleParameter::departPos, SUMOVehicleParameter::departPosProcedure, SUMOVehicleParameter::departSpeed, SUMOVehicleParameter::departSpeedProcedure, SUMOVehicleParameter::fromTaz, SUMOSAXAttributes::get(), SUMOSAXAttributes::getOpt(), SUMOSAXAttributes::hasAttribute(), SUMOVehicleParameter::id, SUMOVehicleParameter::line, SUMOVehicleParameter::parseArrivalLane(), SUMOVehicleParameter::parseArrivalPos(), SUMOVehicleParameter::parseArrivalSpeed(), SUMOVehicleParameter::parseDepartLane(), SUMOVehicleParameter::parseDepartPos(), SUMOVehicleParameter::parseDepartSpeed(), SUMOVehicleParameter::personNumber, SUMOVehicleParameter::routeid, SUMOVehicleParameter::setParameter, SUMO_ATTR_ARRIVALLANE, SUMO_ATTR_ARRIVALPOS, SUMO_ATTR_ARRIVALSPEED, SUMO_ATTR_COLOR, SUMO_ATTR_CONTAINER_NUMBER, SUMO_ATTR_DEPARTLANE, SUMO_ATTR_DEPARTPOS, SUMO_ATTR_DEPARTSPEED, SUMO_ATTR_FROM_TAZ, SUMO_ATTR_LINE, SUMO_ATTR_PERSON_NUMBER, SUMO_ATTR_REROUTE, SUMO_ATTR_ROUTE, SUMO_ATTR_TO_TAZ, SUMO_ATTR_TYPE, SUMOVehicleParameter::toTaz, VEHPARS_ARRIVALLANE_SET, VEHPARS_ARRIVALPOS_SET, VEHPARS_ARRIVALSPEED_SET, VEHPARS_COLOR_SET, VEHPARS_CONTAINER_NUMBER_SET, VEHPARS_DEPARTLANE_SET, VEHPARS_DEPARTPOS_SET, VEHPARS_DEPARTSPEED_SET, VEHPARS_FORCE_REROUTE, VEHPARS_FROM_TAZ_SET, VEHPARS_LINE_SET, VEHPARS_PERSON_NUMBER_SET, VEHPARS_ROUTE_SET, VEHPARS_TO_TAZ_SET, VEHPARS_VTYPE_SET, and SUMOVehicleParameter::vtypeid.

Referenced by closeVTypeParsing(), parseFlowAttributes(), and parseVehicleAttributes().

SUMOEmissionClass SUMOVehicleParserHelper::parseEmissionClass ( const SUMOSAXAttributes attrs,
const std::string &  id 
)
static

Parses the vehicle emission class.

When given, the vehicle emission class is parsed using getVehicleEmissionTypeID. Exceptions occuring within this process are catched and reported.

If no vehicle class is available in the attributes, the default class (SVE_UNKNOWN) is returned.

Parameters
[in]attrsThe attributes to read the class from
[in]idThe id of the parsed element, for error message generation
Returns
The parsed vehicle emission class
See also
SUMOEmissionClass
Todo:
Recheck how errors are handled and what happens if they occure

Definition at line 590 of file SUMOVehicleParserHelper.cpp.

References PollutantsInterface::getClassByName(), SUMOSAXAttributes::getObjectType(), SUMOSAXAttributes::getOpt(), SUMO_ATTR_EMISSIONCLASS, and WRITE_ERROR.

Referenced by beginVTypeParsing(), and closeVTypeParsing().

SUMOVehicleParameter * SUMOVehicleParserHelper::parseFlowAttributes ( const SUMOSAXAttributes attrs,
const SUMOTime  beginDefault,
const SUMOTime  endDefault 
)
static

Parses a flow's attributes.

Parses all attributes stored in "SUMOVehicleParameter".

See also
SUMOVehicleParameter
Parameters
[in]attrThe SAX-attributes to get vehicle parameter from
Returns
The parsed attribute structure if no error occured, 0 otherwise
Exceptions
ProcessErrorIf an attribute's value is invalid
Note
: the caller is responsible for deleting the returned pointer

Definition at line 59 of file SUMOVehicleParserHelper.cpp.

References SUMOSAXAttributes::get(), SUMOSAXAttributes::getName(), SUMOSAXAttributes::getSUMOTimeReporting(), SUMOSAXAttributes::hasAttribute(), max, MAX2(), parseCommonAttributes(), SUMO_ATTR_BEGIN, SUMO_ATTR_END, SUMO_ATTR_ID, SUMO_ATTR_NUMBER, SUMO_ATTR_PERIOD, SUMO_ATTR_PROB, SUMO_ATTR_VEHSPERHOUR, SUMOReal, SUMOTime_MAX, TIME2STEPS, VEHPARS_PERIODFREQ_SET, and WRITE_WARNING.

Referenced by SUMORouteHandler::myStartElement().

SUMOVehicleShape SUMOVehicleParserHelper::parseGuiShape ( const SUMOSAXAttributes attrs,
const std::string &  id 
)
static

Parses the vehicle class.

When given, the vehicle class is parsed using getVehicleShapeID. Exceptions occuring within this process are catched and reported.

If no vehicle class is available in the attributes, the default class (SVS_UNKNOWN) is returned.

Parameters
[in]attrsThe attributes to read the class from
[in]idThe id of the parsed element, for error message generation
Returns
The parsed vehicle shape
See also
SUMOVehicleShape
Todo:
Recheck how errors are handled and what happens if they occure

Definition at line 603 of file SUMOVehicleParserHelper.cpp.

References SUMOSAXAttributes::getObjectType(), SUMOSAXAttributes::getOpt(), SUMO_ATTR_GUISHAPE, SumoVehicleShapeStrings, SVS_UNKNOWN, WRITE_ERROR, and WRITE_WARNING.

Referenced by beginVTypeParsing(), and closeVTypeParsing().

SUMOVehicleParameter * SUMOVehicleParserHelper::parseVehicleAttributes ( const SUMOSAXAttributes attrs,
const bool  optionalID = false,
const bool  skipDepart = false,
const bool  isPerson = false 
)
static

Parses a vehicle's attributes.

Parses all attributes stored in "SUMOVehicleParameter".

See also
SUMOVehicleParameter
Parameters
[in]attrThe SAX-attributes to get vehicle parameter from
[in]optionalIDWhether the id shall be skipped
[in]skipDepartWhether parsing the departure time shall be skipped
[in]isPersonWhether a person is parsed
Returns
The parsed attribute structure if no error occured, 0 otherwise
Exceptions
ProcessErrorIf an attribute's value is invalid
Note
: the caller is responsible for deleting the returned pointer

Definition at line 187 of file SUMOVehicleParserHelper.cpp.

References DEFAULT_PEDTYPE_ID, SUMOSAXAttributes::get(), SUMOSAXAttributes::getOpt(), parseCommonAttributes(), SUMOVehicleParameter::parseDepart(), SUMO_ATTR_DEPART, and SUMO_ATTR_ID.

Referenced by ROMARouteHandler::myStartElement(), SUMORouteHandler::myStartElement(), and MSCalibrator::myStartElement().

SUMOVehicleClass SUMOVehicleParserHelper::parseVehicleClass ( const SUMOSAXAttributes attrs,
const std::string &  id 
)
static

Parses the vehicle class.

When given, the vehicle class is parsed using getVehicleClassID. Exceptions occuring within this process are catched and reported.

If no vehicle class is available in the attributes, the default class (SVC_IGNORING) is returned.

Parameters
[in]attrsThe attributes to read the class from
[in]idThe id of the parsed element, for error message generation
Returns
The parsed vehicle class
See also
SUMOVehicleClass
Todo:
Recheck how errors are handled and what happens if they occure

Definition at line 567 of file SUMOVehicleParserHelper.cpp.

References SUMOSAXAttributes::getObjectType(), SUMOSAXAttributes::getOpt(), getVehicleClassID(), SUMO_ATTR_VCLASS, SumoVehicleClassStrings, SVC_IGNORING, WRITE_ERROR, and WRITE_WARNING.

Referenced by beginVTypeParsing(), and closeVTypeParsing().

Field Documentation

SUMOVehicleParserHelper::CFAttrMap SUMOVehicleParserHelper::allowedCFModelAttrs
staticprivate

Definition at line 192 of file SUMOVehicleParserHelper.h.

Referenced by getAllowedCFModelAttrs().


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