@Override public final Map<String, String> getComments() { Map<String,String> map = super.getComments(); map.put(BEELINE_DISTANCE_FACTOR, "factor with which beeline distances (and therefore times) " + "are multiplied in order to obtain an estimate of the network distances/times. Default is something like 1.3") ; map.put(NETWORK_MODES, "All the modes for which the router is supposed to generate network routes (like car)") ; map.put(RANDOMNESS, "strength of the randomness for the utility of money in routing under toll. " + "Leads to Pareto-optimal route with randomly drawn money-vs-other-attributes tradeoff. " + "Technically the width parameter of a log-normal distribution. 3.0 seems to be a good value. " ) ; return map; }
@Override public final Map<String, String> getComments() { Map<String,String> map = super.getComments(); map.put(INPUT_NETWORK_ATTRIBUTE_FILE, "Path to a file containing information for the network's links (required file format: ObjectAttributes)."); map.put(INPUT_COMFORT, "marginalUtilityOfSurfacetype"); map.put(INPUT_INFRASTRUCTURE, "marginalUtilityOfStreettype"); map.put(INPUT_GRADIENT, "marginalUtilityOfGradient"); return map; } void setNetworkAttFile(String file) {
@Override public Map<String, String> getComments() { Map<String,String> map = super.getComments(); // I don't think that the following is used anywhere: final String message = "Deprecated, do not use. The file is loaded when the filename is given. Functionality needs to be switched on elsewhere."; map.put(USE_LANES, message) ; // since jul'15 map.put(USE_HOUSEHOLDS, message); // since jul'15 map.put(USE_VEHICLES, message); // since jul'15 map.put(USE_TRANSIT, "Deprecated, do not use. See transit section of config file.") ; // since jul'15 return map; }
@Override public final Map<String, String> getComments() { Map<String, String> comments = super.getComments(); comments.put(CALIBRATED_ITEMS, "Comma-separated list of items with counts to be calibrated."); comments.put(START_TIME, "The first second of the day to be used for calibration. hh:mm:ss format"); comments.put(END_TIME, "The last second of the day to be used for calibration. hh:mm:ss format"); comments.put(TIME_BIN_SIZE, "Length of time bin for which counts are aggregated. IN SECONDS!!!! Default is 3600.") ; return comments; }
@Override public final Map<String, String> getComments() { Map<String,String> map = super.getComments(); map.put(MULTI_MODAL_SIMULATION_ENABLED, "Set this parameter to true if multi modal simulation should be used, false if not."); map.put(NUMBER_OF_THREADS, "Use number of threads > 1 for parallel version using the specified number of threads."); map.put(SIMULATED_MODES, "List the modes that should be simulated by the multi modal simulation (supported so far: bike, walk)."); map.put(INPUT_SLOPE_INFORMATION_FILE, "Path to a file containing slope information for the network's links (required file format: ObjectAttributes)."); map.put(CREATE_MULTI_MODAL_NETWORK, "Use this if your network is not multi modal. Links with free speeds that are lower than " + "the specified cutoff value will be usable for walk and bike trips."); map.put(CUTOFF_VALUE_FOR_NON_MOTORIZED_MODES, "Only used if createMultiModalNetwork is enabled (set value in m/s)."); return map; }
@Override public final Map<String, String> getComments() { Map<String,String> map = super.getComments(); map.put(INTERNAL_PLAN_DATA_STRUCTURE, "During the location choice process, many alternative locations are evaluated. " + "For each of them, a temporary plan is created. By default, MATSim regular plan objects are used ('planImpl'). " + "However, using them results in a certain overhead and more objects to be cleared by the garbage collector. " + "Instead, an alternative data structure can be used ('lcPlan') - this is still experimental, so use the default ('planImpl') " + "unless you know what you are doing! "); map.put(USE_CONFIG_PARAMS_FOR_SCORING, "Default is 'true'. Parameter was already present in the DCScoringFunction."); map.put(USE_INDIVIDUAL_SCORING_PARAMETERS, "MATSim supports individual scoring parameters for sub-populations or even single agents. " + "If you use global parameters, this can be set to 'false' (default is 'true')."); map.put( RE_USE_TEMPORARY_PLANS, "Default is 'false'. During the location choice process, many potential locations are evaluated. " + "For each of them, a copy of the person's current plan is created, which results in a huge workload for the " + "garbage collector as well as the memory bus. When this option is set to 'true', only one copy of the plan is created " + "and re-used for each checked location. Note that this is still experimental! cdobler oct'15" ); return map; }
@Override public final Map<String, String> getComments() { Map<String,String> map = super.getComments(); map.put(FRACTION_OF_ITERATIONS_TO_START_SCORE_MSA, "fraction of iterations at which MSA score averaging is started. The matsim theory department " + "suggests to use this together with switching off choice set innovation (where a similar switch exists), but it has not been tested yet.") ; map.put(USING_OLD_SCORING_BELOW_ZERO_UTILITY_DURATION, "There used to be a plateau between duration=0 and duration=zeroUtilityDuration. " + "This caused durations to evolve to zero once they were below zeroUtilityDuration, causing problems. Only use this switch if you need to be " + "backwards compatible with some old results. (changed nov'13)") ; map.put(PERFORMING,"[utils/hr] marginal utility of doing an activity. normally positive. also the opportunity cost of " + "time if agent is doing nothing. MATSim separates the resource value of time from the direct (dis)utility of travel time, see, e.g., " + "Boerjesson and Eliasson, TR-A 59 (2014) 144-158."); map.put(LATE_ARRIVAL, "[utils/hr] utility for arriving late (i.e. after the latest start time). normally negative") ; map.put(EARLY_DEPARTURE, "[utils/hr] utility for departing early (i.e. before the earliest end time). Normally negative. Probably " + "implemented correctly, but not tested." ); map.put(WAITING, "[utils/hr] additional marginal utility for waiting. normally negative. this comes on top of the opportunity cost of time. Probably " + "implemented correctly, but not tested.") ; map.put(WAITING_PT, "[utils/hr] additional marginal utility for waiting for a pt vehicle. normally negative. this comes on top of the opportunity cost " + "of time. Default: if not set explicitly, it is equal to traveling_pt!!!" ) ; map.put(BRAIN_EXP_BETA, "logit model scale parameter. default: 1. Has name and default value for historical reasons " + "(see Bryan Raney's phd thesis).") ; map.put(LEARNING_RATE, "new_score = (1-learningRate)*old_score + learningRate * score_from_mobsim. learning rates " + "close to zero emulate score averaging, but slow down initial convergence") ; map.put(UTL_OF_LINE_SWITCH, "[utils] utility of switching a line (= transfer penalty). Normally negative") ; map.put(MARGINAL_UTL_OF_MONEY, "[utils/unit_of_money] conversion of money (e.g. toll, distance cost) into utils. Normall positive (i.e. toll/cost/fare are processed as negative amounts of money)." ) ; map.put(WRITE_EXPERIENCED_PLANS, "write a plans file in each iteration directory which contains what each agent actually did, and the score it received."); return map; }
@Override public final Map<String, String> getComments() { Map<String,String> map = super.getComments(); map.put(AGENT_SIZE, "The (initial) size of the agents. Only a range of numbers is allowed, otherwise otfvis aborts" + " rather ungracefully, or displays no agents at all."); map.put(LINK_WIDTH, "The (initial) width of the links of the network. Use positive floating point values."); map.put(LINK_WIDTH_IS_PROPORTIONAL_TO, "Link width is proportional to `"+NUMBER_OF_LANES+"' or to `"+CAPACITY+"'."); StringBuilder allowedColorings = new StringBuilder(); for (ColoringScheme scheme : ColoringScheme.values()) { allowedColorings.append(' '); allowedColorings.append(scheme.toString()); } map.put(COLORING, "coloring scheme for otfvis. Currently (2012) allowed values:" + allowedColorings); map.put(MAP_OVERLAY_MODE, "Render everything on top of map tiles. Default: From tiles.openstreetmap.org"); map.put(MAP_BASE_URL, "URL to get WMS tiles from. For a local GeoServer instance, use http://localhost:8080/geoserver/wms?service=WMS&"); map.put(MAP_LAYER, "The WMS layer to display. For GeoServer and a layer called clipped in workspace mz, use mz:clipped"); map.put(DRAW_NON_MOVING_ITEMS, "If non-moving items (e.g. agents at activities, at bus stops, etc.) should be showed. " + "May affect all non-moving items.") ; return map ; }
@Override public final Map<String, String> getComments() { Map<String,String> map = super.getComments(); map.put(ReflectiveDelegate.ITERATION_FRACTION_TO_DISABLE_INNOVATION, "fraction of iterations where innovative strategies are switched off. Something like 0.8 should be good. E.g. if you run from iteration 400 to iteration 500, innovation is switched off at iteration 480" ) ; map.put(ReflectiveDelegate.MAX_AGENT_PLAN_MEMORY_SIZE, "maximum number of plans per agent. ``0'' means ``infinity''. Currently (2010), ``5'' is a good number"); StringBuilder strb = new StringBuilder() ; for ( DefaultPlansRemover name : DefaultPlansRemover.values() ) { strb.append( name.toString() + " " ) ; } map.put(ReflectiveDelegate.PLAN_SELECTOR_FOR_REMOVAL,"strategyName of PlanSelector for plans removal. " + "Possible defaults: " + strb.toString() + ". The current default, WorstPlanSelector is not a good " + "choice from a discrete choice theoretical perspective. Alternatives, however, have not been systematically " + "tested. kai, feb'12") ; map.put(ReflectiveDelegate.EXTERNAL_EXE_CONFIG_TEMPLATE,"the external executable will be called with a config file as argument. This is the pathname to a possible " + "skeleton config, to which additional information will be added. Can be null."); map.put(ReflectiveDelegate.EXTERNAL_EXE_TMP_FILE_ROOT_DIR, "root directory for temporary files generated by the external executable. Provided as a service; " + "I don't think this is used by MATSim.") ; map.put(ReflectiveDelegate.EXTERNAL_EXE_TIME_OUT, "time out value (in seconds) after which matsim will consider the external strategy as failed") ; return map ; }
@Override public final Map<String, String> getComments() { Map<String, String> map = super.getComments(); map.put(FRACTION_OF_ITERATIONS_TO_START_SCORE_MSA, "fraction of iterations at which MSA score averaging is started. The matsim theory department "
public Map<String, String> getComments() { final Map<String, String> comments = super.getComments();
@Override void writeModule(final ConfigGroup module, final BufferedWriter out) throws UncheckedIOException { Map<String, String> params = module.getParams(); Map<String, String> comments = module.getComments();
@Override public final Map<String, String> getComments() { Map<String,String> map = super.getComments();
final ConfigGroup comparisonModule ) { Map<String, String> params = module.getParams(); Map<String, String> comments = module.getComments();