payanam | mapping public transport routes to static GTFS format

 by   WRI-Cities JavaScript Version: Current License: GPL-3.0

kandi X-RAY | payanam Summary

kandi X-RAY | payanam Summary

payanam is a JavaScript library. payanam has no bugs, it has no vulnerabilities, it has a Strong Copyleft License and it has low support. You can download it from GitHub.

A browser-based user-friendly tool for progressively mapping public transport routes when there wasn't geo-data available to begin with, and converting it to static GTFS standard. Payanam (pronounced as "Paa-ya-nam") means "pathway" in Telugu. Created by a joint collaboration between World Resources Institute (WRI) and Telangana Open Data Portal, Telangana, India. Lead programmer: Nikhil VJ from Pune, India. Initially deployed on

            kandi-support Support

              payanam has a low active ecosystem.
              It has 7 star(s) with 5 fork(s). There are 4 watchers for this library.
              It had no major release in the last 6 months.
              There are 1 open issues and 29 have been closed. On average issues are closed in 3 days. There are 1 open pull requests and 0 closed requests.
              It has a neutral sentiment in the developer community.
              The latest version of payanam is current.

            kandi-Quality Quality

              payanam has no bugs reported.

            kandi-Security Security

              payanam has no vulnerabilities reported, and its dependent libraries have no vulnerabilities reported.

            kandi-License License

              payanam is licensed under the GPL-3.0 License. This license is Strong Copyleft.
              Strong Copyleft licenses enforce sharing, and you can use them when creating open source projects.

            kandi-Reuse Reuse

              payanam releases are not available. You will need to build from source code and install.
              Installation instructions, examples and code snippets are available.

            Top functions reviewed by kandi - BETA

            kandi's functional review helps you automatically verify the functionalities of the libraries and avoid rework.
            Currently covering the most popular Java, JavaScript and Python libraries. See a Sample of payanam
            Get all kandi verified functions for this library.

            payanam Key Features

            No Key Features are available at this moment for payanam.

            payanam Examples and Code Snippets

            No Code Snippets are available at this moment for payanam.

            Community Discussions

            No Community Discussions are available at this moment for payanam.Refer to stack overflow page for discussions.

            Community Discussions, Code Snippets contain sources that include Stack Exchange Network


            No vulnerabilities reported

            Install payanam

            Download this repository and unzip / clone to a folder on your computer.
            Currently the tool needs to be run using Python 3 programming language - executable binaries are not yet available.
            Set up a Python 3.6 Virtual environment. See this guide or lookup on the net.
            Install the required packages: pip install -r requirements.txt (if not running in virtual env, use: pip3 install --user -r requirements.txt )
            Run python (or python3 This should deploy the tool on your web browser on a URL like localhost:5050. In case your default web browse is IE (Internet Explorer - default browser of Windows), please change to another web browser like Chrome or Firefox, as certain front end features may not work so well on IE.
            If you're running this for the first time, you may see a popup asking to enter your API key. See the "access.csv" section below to know more. You can press "Cancel" to go with the default "Guest" user, and can change it from the bottom of the screen later.
            Head to the Data Entry page and create your first route. After you have saved it, see the 'routes/' folder in the payanam folder and you'll see a new sub-folder created and a .json in it. That's your route.
            Once at least one route is saved from Data Entry page, run python This will generate the CSVs and shapefiles needed for the pages Overview, Stops Reconciliation, Map.
            For making the above pages reflect the latest data, run repeatedly at regular intervals. You can set this up as a cronjob on a linux laptop / server.
            Similary, reads the CSVs generated by reports script and generates GTFS feed in gtfs/ subfolder : both the .txt files and a Run that only after you have run at least once. This too can be scheduled as a cron job or so, so that you have the latest GTFS output ready once you've set up your routes.
            Please run both the scripts once manually to get an estimate of the time needed for them to run and thus the proper interval between runs. Typically, 5 to 10 mins interval is good for reports_creation and 1 to 2 hrs interval is good for gtfs_creation.
            Here are sample crontab entries that can be set up on a unbuntu system by crontab -e command:
            Cron tips:
            Ensure that the user account has write access to the payanam folder
            Use absolute paths in all things cron.
            You can redirect the stdout and stderr outputs to other log files or to /dev/null (aka the black hole); these files are logging everything to reports/logs/log.txt anyways.
            This website will help you figure out your cron:
            Payanam comes packed with a plethora of assistance features to aid the user in mapping the routes. There are several options and settings laid out to configure the same. Upon changing any of the below, please re-launch the tool and empty you browser cache or Ctrl+F5 at every page to ensure that the latest settings are being loaded. This is a simple lat-long listing of prominent depots / stations / terminuses that user may want to see marked on the map for reference while mapping routes. They show up as pink dots on the map pages. Edit the CSV to update to your location.
            Change STARTLOCATION, STARTZOOM values to reflect your region.
            Change MBaccessToken, mapillaryClientID values to put in access tokens created at 3rd party services.
            MBaccessToken : Mapbox Access Token. click here to create your free account and see this to get your access token (only public scopes needed).
            mapillaryClientID : Mapillary Client ID. This is for the feature where you can fetch all street-view photos taken around 1km of your map's center. Click here to create your free account and see this to get your own Client ID.
            Note: You can keep using the values already there, but this project's maintainer might dispose of them at any point (particularly if too many users are hogging the monthly free quota), so you're on your own. The mapbox access token is a little more critical for the various map backgrounds, so shoot for getting your own for that at least.
            After any change here, Ctrl+F5 (or force-refresh) all the pages when you deploy the tool, so that the latest changes are reflected and browser doesn't use cached files.
            Open this in Excel or another spreadsheet editor.
            Here you can set up API keys (or passwords) for different levels of users.
            First, edit the ADMIN row and assign a secret password and your email id.
            For your team members, create rows with different access values, and assign each user a unique email id and key.
            Do not share the 'key' values with everybody, and please keep them unique (one key = one user).
            DATAENTRY level will allow to create routes in the Data Entry page.
            MAPPER level will allow to map created routes in the Route Mapper page. This is the most basic level with any exective powers.
            REVIEW level will let the user "lock" a route once its mapping and timings info is fully set.
            ADMIN level allows for bulk actions in the Admin and Stops Reconciliation pages.
            Please keep the "guest" line as-is to enable default visitors to see the site, to load up the individual routes, etc. Change it if you don't want the tool (if deployed on an intranet or the web) to work properly for regular visitors.
            databanksList has the list of databanks that can be used to assist in stop locations finding. They will appear under "Databank table" heading on Route Mapper page. The first one in the sequence will be the databank used (in addition to mapped stops) in Automatic Suggestions and Bulk Mapping.
            timeDefaults contains the default trip times that will be assumed as trip timings for a route in GTFS calculation if its timings aren't saved. Also, these are the values that will load up on pressing "load Defaults" button(s) in Timings page.
            sanityDistance is max distance in km from neighboring stops used in the sanity-check on auto-mapped routes (See Admin page). Auto-map picks that are too far away from the neighboring stops get dropped. (provided sanity check is enabled) fuzzyTopN: If the automatic suggestions function is working in fuzzy mode, if the number of matches exceeds this number then only this many top matches will be taken. This is to ensure cases like 50 stops getting suggested because the matching algorithm was too broad.
            In many cases, there IS a list of possible stop locations available; only it's not been matched with the routes yet.
            User can store this 'databank' in the databank/ folder, configure it in config/config.json and then Payanam tool will show it on the map as yellow dots that one can click when mapping a route.
            Multiple databank files can be stored in the databank/ folder.
            There is a dummy databank 'randomPoints.csv' set up by default. See the structure and adapt your databank(s) accordingly (this follows the GTFS stops.txt structure).
            You can use 'rank' column in your databank to prioritise which stops should be favoured in the matching algorithm.


            For any new features, suggestions and bugs create an issue on GitHub. If you have any questions check and ask questions on community page Stack Overflow .
            Find more information at:

            Find, review, and download reusable Libraries, Code Snippets, Cloud APIs from over 650 million Knowledge Items

            Find more libraries
          • HTTPS


          • CLI

            gh repo clone WRI-Cities/payanam

          • sshUrl


          • Stay Updated

            Subscribe to our newsletter for trending solutions and developer bootcamps

            Agree to Sign up and Terms & Conditions

            Share this Page

            share link