org.matsim.run.TeleAtlas2Network Class Reference

Static Public Member Functions
static final Network	convert () throws Exception
static void	main (String[] args) throws Exception

Static Private Member Functions
static final void	printSetting ()
static final void	parseArguments (final String[] args)
static final void	ensureNextElement (final Iterator< String > iter)
static final void	printUsage ()

Static Private Attributes
static NetworkReaderTeleatlas	reader = null
static Network	network = null
static String	jcShpFileName = null
static String	nwShpFileName = null
static NetworkTeleatlasAddSpeedRestrictions	srModule = null
static String	srDbfFileName = null
static NetworkTeleatlasAddManeuverRestrictions	mrModule = null
static String	mnShpFileName
static String	mpDbfFileName
static String	outputDir = "output"
static boolean	writeNetworkXmlFile = false
static boolean	writeNetworkTxtFile = false
static boolean	writeNetworkShapeFile = false

Detailed Description

Definition at line 38 of file TeleAtlas2Network.java.

Member Function Documentation

convert()

static final Network org.matsim.run.TeleAtlas2Network.convert ( ) throws Exception

static

Definition at line 65 of file TeleAtlas2Network.java.

References org.matsim.run.TeleAtlas2Network.network, org.matsim.run.TeleAtlas2Network.printSetting(), org.matsim.core.network.io.NetworkReaderTeleatlas.read(), org.matsim.core.network.algorithms.NetworkWriteAsTable.run(), org.matsim.core.network.algorithms.NetworkTeleatlasAddSpeedRestrictions.run(), org.matsim.core.network.algorithms.NetworkTeleatlasAddManeuverRestrictions.run(), org.matsim.utils.gis.matsim2esri.network.FeatureGeneratorBuilderImpl.setFeatureGeneratorPrototype(), org.matsim.utils.gis.matsim2esri.network.FeatureGeneratorBuilderImpl.setWidthCalculatorPrototype(), org.matsim.core.network.io.NetworkWriter.write(), and org.matsim.utils.gis.matsim2esri.network.Links2ESRIShape.write().

Referenced by org.matsim.run.TeleAtlas2Network.main().

                                                           {
        System.out.println("conversion settings...");
        printSetting();
        System.out.println("done.");

        reader.read();
        if (srModule != null) { srModule.run(network); }
        if (mrModule != null) { mrModule.run(network); }

        if (writeNetworkXmlFile) {
            System.out.println("writing xml file...");
            new NetworkWriter(network).write(outputDir+"/output_network.xml.gz");
            System.out.println("done.");
        }
        if (writeNetworkTxtFile) {
            System.out.println("writing txt files...");
            NetworkWriteAsTable nwat = new NetworkWriteAsTable(outputDir);
            nwat.run(network);
            System.out.println("done.");
        }
        if (writeNetworkShapeFile) {
            System.out.println("writing shape file...");
//          if (Gbl.getConfig() == null) { Gbl.createConfig(null); }
//          Gbl.getConfig().global().setCoordinateSystem("WGS84");
            FeatureGeneratorBuilderImpl builder = new FeatureGeneratorBuilderImpl(network, "WGS84");
            builder.setFeatureGeneratorPrototype(LineStringBasedFeatureGenerator.class);
            builder.setWidthCalculatorPrototype(LanesBasedWidthCalculator.class);
            new Links2ESRIShape(network,outputDir+"/output_links.shp",builder).write();
            System.out.println("done.");
        }
        return network;
    }

Here is the call graph for this function:

printSetting()

static final void org.matsim.run.TeleAtlas2Network.printSetting ( )

staticprivate

Definition at line 102 of file TeleAtlas2Network.java.

References org.matsim.core.network.algorithms.NetworkTeleatlasAddSpeedRestrictions.printInfo(), org.matsim.core.network.algorithms.NetworkTeleatlasAddManeuverRestrictions.printInfo(), and org.matsim.core.network.io.NetworkReaderTeleatlas.printInfo().

Referenced by org.matsim.run.TeleAtlas2Network.convert().

                                             {
        reader.printInfo("  ");
        if (srModule != null) { srModule.printInfo("  "); }
        if (mrModule != null) { mrModule.printInfo("  "); }
        System.out.println("  output:");
        System.out.println("    outputDir:             "+outputDir);
        System.out.println("    writeNetworkXmlFile:   "+writeNetworkXmlFile);
        System.out.println("    writeNetworkTxtFile:   "+writeNetworkTxtFile);
        System.out.println("    writeNetworkShapeFile: "+writeNetworkShapeFile);
    }

Here is the call graph for this function:

parseArguments()

static final void org.matsim.run.TeleAtlas2Network.parseArguments ( final String []  args )

staticprivate

Definition at line 117 of file TeleAtlas2Network.java.

References org.matsim.run.TeleAtlas2Network.ensureNextElement(), org.matsim.core.network.algorithms.NetworkTeleatlasAddManeuverRestrictions.expansionRadius, org.matsim.core.network.io.NetworkReaderTeleatlas.ignoreFrcType7onewayN, org.matsim.core.network.io.NetworkReaderTeleatlas.ignoreFrcType8, org.matsim.core.utils.misc.ArgumentParser.iterator(), org.matsim.core.network.algorithms.NetworkTeleatlasAddManeuverRestrictions.linkSeparation, org.matsim.core.network.io.NetworkReaderTeleatlas.maxFrcTypeForDoubleLaneLink, org.matsim.core.network.io.NetworkReaderTeleatlas.minSpeedForNormalCapacity, org.matsim.run.TeleAtlas2Network.printUsage(), and org.matsim.core.network.algorithms.NetworkTeleatlasAddManeuverRestrictions.removeUTurns.

Referenced by org.matsim.run.TeleAtlas2Network.main().

                                                                  {
        // reader params
        boolean ignoreFrcType8 = false;
        boolean ignoreFrcType7onewayN = false;
        int maxFrcTypeForDoubleLaneLink = Integer.MIN_VALUE;
        int minSpeedForNormalCapacity = Integer.MAX_VALUE;
        // mrModule params
        boolean removeUTurns = false;
        double expansionRadius = Double.NaN;
        double linkSeparation = Double.NaN;

        if (args.length == 0) { System.out.println("Too few arguments."); printUsage(); System.exit(1); }
        Iterator<String> argIter = new ArgumentParser(args).iterator();
        while (argIter.hasNext()) {
            String arg = argIter.next();
            if (arg.equals("--xml")) { writeNetworkXmlFile = true; }
            else if (arg.equals("--txt")) { writeNetworkTxtFile = true; }
            else if (arg.equals("--shp")) { writeNetworkShapeFile = true; }
            else if (arg.equals("--frc8")) { ignoreFrcType8 = true; }
            else if (arg.equals("--frc7N")) { ignoreFrcType7onewayN = true; }
            else if (arg.equals("--maxfrc2l")) {
                ensureNextElement(argIter);
                try { maxFrcTypeForDoubleLaneLink = Integer.parseInt(argIter.next()); }
                catch (Exception e) { System.out.println("Cannot understand argument: --maxfrc2l " + arg); printUsage(); System.exit(1); }
            }
            else if (arg.equals("--minsnc")) {
                ensureNextElement(argIter);
                try { minSpeedForNormalCapacity = Integer.parseInt(argIter.next()); }
                catch (Exception e) { System.out.println("Cannot understand argument: --minsnc " + arg); printUsage(); System.exit(1); }
            }
            else if (arg.equals("--radius")) {
                ensureNextElement(argIter);
                try { expansionRadius = Double.parseDouble(argIter.next()); }
                catch (Exception e) { System.out.println("Cannot understand argument: --radius " + arg); printUsage(); System.exit(1); }
            }
            else if (arg.equals("--offset")) {
                ensureNextElement(argIter);
                try { linkSeparation =Double.parseDouble(argIter.next()); }
                catch (Exception e) { System.out.println("Cannot understand argument: --offset " + arg); printUsage(); System.exit(1); }
            }
            else if (arg.equals("--uturn")) { removeUTurns = true; }
            else if (arg.equals("-h") || arg.equals("--help")) { printUsage(); System.exit(0); }
            else if (arg.startsWith("-")) { System.out.println("Unrecognized option " + arg); System.exit(1); }
            else {
                jcShpFileName = arg;
                ensureNextElement(argIter);
                nwShpFileName = argIter.next();
                if (argIter.hasNext()) {
                    arg = argIter.next(); // dbf, shp&dbf, dir
                    if (arg.endsWith(".dbf")) {
                        srDbfFileName = arg;
                        if (argIter.hasNext()) {
                            arg = argIter.next(); // shp&dbf, dir
                            if (arg.endsWith(".shp")) {
                                ensureNextElement(argIter);
                                mnShpFileName = arg;
                                mpDbfFileName = argIter.next();
                                if (argIter.hasNext()) { // dir
                                    outputDir = argIter.next();
                                }
                            }
                            else {
                                outputDir = arg;
                            }
                        }
                    }
                    else if (arg.endsWith(".shp")) {
                        ensureNextElement(argIter);
                        mnShpFileName = arg;
                        mpDbfFileName = argIter.next();
                        if (argIter.hasNext()) { // dir
                            outputDir = argIter.next();
                        }
                    }
                    else {
                        outputDir = arg;
                    }
                }
                if (argIter.hasNext()) {
                    System.out.println("Too many arguments.");
                    printUsage();
                    System.exit(1);
                }
            }
        }
        // init the reader
        reader = new NetworkReaderTeleatlas(network,jcShpFileName,nwShpFileName);
        reader.ignoreFrcType8 = ignoreFrcType8;
        reader.ignoreFrcType7onewayN = ignoreFrcType7onewayN;
        if (maxFrcTypeForDoubleLaneLink != Integer.MIN_VALUE) { reader.maxFrcTypeForDoubleLaneLink = maxFrcTypeForDoubleLaneLink; }
        if (minSpeedForNormalCapacity != Integer.MAX_VALUE) { reader.minSpeedForNormalCapacity = minSpeedForNormalCapacity; }
        // init the srModule
        if (srDbfFileName != null) { srModule = new NetworkTeleatlasAddSpeedRestrictions(srDbfFileName); }
        // init mrModule
        if (mnShpFileName != null) {
            mrModule = new NetworkTeleatlasAddManeuverRestrictions(mnShpFileName,mpDbfFileName);
            mrModule.removeUTurns = removeUTurns;
            if (!Double.isNaN(expansionRadius)) { mrModule.expansionRadius = expansionRadius; }
            if (!Double.isNaN(linkSeparation)) { mrModule.linkSeparation = linkSeparation; }
        }
    }

Here is the call graph for this function:

ensureNextElement()

static final void org.matsim.run.TeleAtlas2Network.ensureNextElement ( final Iterator< String >  iter )

staticprivate

Definition at line 219 of file TeleAtlas2Network.java.

References org.matsim.run.TeleAtlas2Network.printUsage().

Referenced by org.matsim.run.TeleAtlas2Network.parseArguments().

                                                                             {
        if (!iter.hasNext()) {
            System.out.println("Too few arguments.");
            printUsage();
            System.exit(1);
        }
    }

Here is the call graph for this function:

printUsage()

static final void org.matsim.run.TeleAtlas2Network.printUsage ( )

staticprivate

Definition at line 227 of file TeleAtlas2Network.java.

Referenced by org.matsim.run.TeleAtlas2Network.ensureNextElement(), and org.matsim.run.TeleAtlas2Network.parseArguments().

                                           {
        System.out.println();
        System.out.println("TeleatlasParser");
        System.out.println("Parsers Teleatlas databases into MATSim network data structure.");
        System.out.println("Optional: It also writes a MATSim XML network file and/or a shape file of the data.");
        System.out.println();
        System.out.println("usage: TeleatlasParser [OPTIONS] jcShpFile nwShpFile [srDbfFile] [mnShpFile mpShpFile] [outputDirectory]");
        System.out.println();
        System.out.println("jcShpFile:       Teleatlas Junction Shape File (typically called 'xyz________jc.shp')");
        System.out.println("nwShpFile:       Teleatlas network Shape File (typically called 'xyz________nw.shp')");
        System.out.println("srDbfFile:       Teleatlas speed restriction DBF File (typically called 'xyz________sr.dbf')");
        System.out.println("mnShpFile:       Teleatlas maneuver Shape File (typically called 'xyz________mn.shp')");
        System.out.println("mpShpFile:       Teleatlas maneuver paths DBF File (typically called 'xyz________mp.dbf')");
        System.out.println("outputDirectory: Directory where output files (MATSim XML network file, ASCII files and shape files) are stored.");
        System.out.println("                 default: ./output");
        System.out.println("                 If writing option is set (see below) the files will be stored as:");
        System.out.println("                 <outputDirectory>/output_network.xml.gz");
        System.out.println("                 <outputDirectory>/output_links.shp (and related files)");
        System.out.println("                 <outputDirectory>/nodes.txt");
        System.out.println("                 <outputDirectory>/links.txt");
        System.out.println("                 <outputDirectory>/linksET.txt");
        System.out.println();
        System.out.println("Options:");
        System.out.println("--xml:           If set, a MATSim XML network file will be written to <outputDirectory>/output_network.xml.gz.");
        System.out.println("--txt:           If set, three ASCII network files will be written to <outputDirectory>/nodes.txt, links.txt, resp. linksET.txt).");
        System.out.println("                 These are useful for manual conversion with ESRI ArcGIS (ET GeoWizards plugin).");
        System.out.println("--shp:           If set, a network Shape file will be written to <outputDirectory>/output_links.shp");
        System.out.println("--frc8:          If set, links with FRC type = '8' will be ignored from the nwShpFile.");
        System.out.println("--frc7N:         If set, links with FRC type = '7' and ONEWAY = 'N' will be ignored from the nwShpFile.");
        System.out.println("--maxfrc2l FRCtype:");
        System.out.println("                 Defines, which links of the nwShpFile get 2 lanes per direction ('MAX FRC for 2 LANES').");
        System.out.println("                 Teleatlas defines the number of lanes (LANES attribute of the nwShpFile) only for");
        System.out.println("                 a few links. This option defines for links with LANES<'1' how many lanes will be set");
        System.out.println("                 based on the FRC type. E.g. '--maxfrc2l 4' sets 2 lanes for FRC=[0-4] and 1 lane for FRC>4.");
        System.out.println("                 default: '--maxfrc2l 3'");
        System.out.println("--minsnc freespeed:");
        System.out.println("                 Defines, which links of the nwShpFile get capacity[veh/h]=2000*#lanes ('MIN SPEED for NORMAL CAPACITY').");
        System.out.println("                 Teleatlas does not define link capacities. This option sets capactities based on freespeed and");
        System.out.println("                 derived number of lanes. E.g. '--minsnc 20'[km/h] sets capacity[veh/h]=2000*#lanes for freespeed>=20[km/h] and");
        System.out.println("                 capacity[veh/h]=1000*#lanes for freespeed<20[km/h].");
        System.out.println("                 default: '--minsnc 40'");
        System.out.println("--radius NodeExpansionRadius:");
        System.out.println("                 If [mnShpFile mpShpFile] are given, turn maneuvers will be created via expanding the corresponing node");
        System.out.println("                 with virtual nodes. The option defines the radius on which the virtual nodes will be places around");
        System.out.println("                 the expanded node. The unit of 'NodeExpansionRadius' depends on the projection of the input network.");
        System.out.println("                 E.g. for WGS84, '--radius 0.00003'[degrees] suits well. '--radius 0' will place all virtual nodes at the same place,");
        System.out.println("                 causing zero distance virtual links (for turn maneuvers).");
        System.out.println("                 default: '--radius 0.00003'");
        System.out.println("--offset NodeExpansionOffset:");
        System.out.println("                 If [mnShpFile mpShpFile] are given, turn maneuvers will be created via expanding the corresponing node");
        System.out.println("                 with virtual nodes. The option defines the offset against the position of the incident links of the");
        System.out.println("                 expanded node. The unit of 'NodeExpansionOffset' depends on the projection of the input network.");
        System.out.println("                 E.g. for WGS84, '--offset 0.0.000005'[degrees] suits well. '--offset 0' will place virtual nodes of an in- and");
        System.out.println("                 out-link pair at the same place, causing zero distance virtual u-turn links (for turn maneuvers).");
        System.out.println("                 default: '--offset 0.000005'");
        System.out.println("--uturn:         If set and if [mnShpFile mpShpFile] are given, no virtual u-turn links for an in- and out-link pair will be created.");
        System.out.println("-h, --help:      Displays this message.");
        System.out.println();
        System.out.println("----------------");
        System.out.println("2009, matsim.org");
        System.out.println();
    }

main()

static void org.matsim.run.TeleAtlas2Network.main ( String []  args ) throws Exception

static

Definition at line 294 of file TeleAtlas2Network.java.

References org.matsim.run.TeleAtlas2Network.convert(), org.matsim.core.network.NetworkUtils.createNetwork(), and org.matsim.run.TeleAtlas2Network.parseArguments().

                                                            {
//      // example arguments:
//      // usage: TeleatlasParser [OPTIONS] jcShpFile nwShpFile [srDbfFile] [mnShpFile mpShpFile] [outputDirectory]
//      String options = "--xml --txt --shp --frc8 --frc7N --maxfrc2l 3 --minsnc 40 --radius 0.000030 --offset 0.000005 --uturn ";
//      String jcShpFile = "../../input/teleatlas/jc_zurich.shp ";
//      String nwShpFile = "../../input/teleatlas/nw_zurich.shp ";
//      String srDbfFile = "../../input/teleatlas/cheche________sr.dbf ";
//      String mnShpFile = "../../input/teleatlas/cheche________mn.shp ";
//      String mpShpFile = "../../input/teleatlas/cheche________mp.dbf ";
//      String outDir = "../../output ";
//      String str = options+jcShpFile+nwShpFile+srDbfFile+mnShpFile+mpShpFile+outDir;
//      str = str.trim();
//      args = str.split(" ");

        network = NetworkUtils.createNetwork();
        parseArguments(args);
        convert();
        // TODO balmermi: more options
        // transform // -t WGS84toCH1903LV03
        // clean network // -c
        // network thinning // -t
    }

Here is the call graph for this function:

Member Data Documentation

reader

NetworkReaderTeleatlas org.matsim.run.TeleAtlas2Network.reader = null

staticprivate

Definition at line 44 of file TeleAtlas2Network.java.

network

Network org.matsim.run.TeleAtlas2Network.network = null

staticprivate

Definition at line 45 of file TeleAtlas2Network.java.

Referenced by org.matsim.run.TeleAtlas2Network.convert().

jcShpFileName

String org.matsim.run.TeleAtlas2Network.jcShpFileName = null

staticprivate

Definition at line 46 of file TeleAtlas2Network.java.

nwShpFileName

String org.matsim.run.TeleAtlas2Network.nwShpFileName = null

staticprivate

Definition at line 47 of file TeleAtlas2Network.java.

srModule

NetworkTeleatlasAddSpeedRestrictions org.matsim.run.TeleAtlas2Network.srModule = null

staticprivate

Definition at line 49 of file TeleAtlas2Network.java.

srDbfFileName

String org.matsim.run.TeleAtlas2Network.srDbfFileName = null

staticprivate

Definition at line 50 of file TeleAtlas2Network.java.

mrModule

NetworkTeleatlasAddManeuverRestrictions org.matsim.run.TeleAtlas2Network.mrModule = null

staticprivate

Definition at line 52 of file TeleAtlas2Network.java.

mnShpFileName

String org.matsim.run.TeleAtlas2Network.mnShpFileName

staticprivate

Definition at line 53 of file TeleAtlas2Network.java.

mpDbfFileName

String org.matsim.run.TeleAtlas2Network.mpDbfFileName

staticprivate

Definition at line 54 of file TeleAtlas2Network.java.

outputDir

String org.matsim.run.TeleAtlas2Network.outputDir = "output"

staticprivate

Definition at line 56 of file TeleAtlas2Network.java.

writeNetworkXmlFile

boolean org.matsim.run.TeleAtlas2Network.writeNetworkXmlFile = false

staticprivate

Definition at line 57 of file TeleAtlas2Network.java.

writeNetworkTxtFile

boolean org.matsim.run.TeleAtlas2Network.writeNetworkTxtFile = false

staticprivate

Definition at line 58 of file TeleAtlas2Network.java.

writeNetworkShapeFile

boolean org.matsim.run.TeleAtlas2Network.writeNetworkShapeFile = false

staticprivate

Definition at line 59 of file TeleAtlas2Network.java.

---

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

• run/TeleAtlas2Network.java