Code Monkey home page Code Monkey logo

simsig_importer's Introduction

Simsig Importer

.Net Desktop Application for converting Excel simplified timetables into Simsig timetables

Introduction

If you are creating your own timetables in SimSig, the task quickly becomes onerous due to the excessive amount of UI interaction required to import a timetable that you are likely to have developed separately in something like a spreadsheet, which can more closely mirror a working timetable document.

The motivation for this application is to provide the means to create timetables in a simple Excel spreadsheet format, which can then be imported into a SimSig format timetable directly. Any other tweaks can be made once the timetable is imported into Simsig using the GUI since not all functions are exposed to the importer for complexity reasons.

Licence

This software is licensed under the GNU General Public License v3 to allow you freedom to use and/or modify the software freely but with the requirement that you allow any changes to be made available along with an equivalent licence. Note that simsig software is proprietary and licenced by Hitachi Information and Control Systems Europe Limited to Cajon Software Ltd. I have no personal link to either Hitachi or Cajon, this is simply a hobby application developed with the knowledge of but not the official sanction of either Hitachi or Cajon.

I will endeavour to keep this up to date with any changes to timetable formats but without any direct access to source code, I can only do this with the helpful assistance of SimSig forum users.

Installation

Windows installer

To run the software, you will need to get the latest production release from the releases page (the one nearest the top). Any releases that are marked alpha or beta might contain new code that has not been fully tested. You are welcome to use those releases for features that are not available before then but with the usual caveat that they might not work properly yet. If you do not need any special new feature, just take the latest non-alpha/beat version.

The MSI is the installer that you need for Windows. The application will need the .Net framework 4.7.2 runtime to be installed but this should already be installed on newer versions of windows. If not, you can download it from here.

Source code

If you want to build the source and run the app locally for development or from curiosity, then you will need Visual Studio 2019+ and have the workload for Winform apps installed (called Windows Desktop in the installer).

Note that the initial development has been made for Wolverhampton and has not yet been tested on other simulations. It doesn't seem like there would be much difference across simulations except needing to know the correct timetable version and location (TIPLOC) codes. You can do this manually by creating a suitable timetable in Simsig, then saving it, renaming the saved file to .zip and then opening the SavedTimetable.xml file in a text editor. You can find codes for anything that you have created in your timetable but note that not all fields are exported if they are not set, to reduce the amount of data being written to disk.

Spreadsheet formats

Currently, the importer only supports Office Open XML format, which pretty much means Excel. This is simply to avoid all of the various conversions that people might need to do to make it work from random other formats. You should be able to save most other spreadsheets into Excel "xlsx" format in order to use it for this. CSV format is not suitable for the richer formats used in the spreadsheet so it will never be supported.

Usage instructions

See here

Contributing

See here

simsig_importer's People

Contributors

lukos avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.