News:

Do you need help?
Simutrans Wiki Manual can help you to play and extend Simutrans. In 9 languages.

Auto-generated documentation from dat files

Started by VS, January 16, 2013, 02:15:55 PM

Previous topic - Next topic

0 Members and 1 Guest are viewing this topic.

VS

Here is a proof of concept script for generating documentation from pakset sources, and its output. I will definitely continue work on this!

https://dl.dropbox.com/u/63534647/pakdocs-ways-pak128.7z

My projects... Tools for messing with Simutrans graphics. Graphic archive - templates and some other stuff for painters. Development logs for most recent information on what is going on. And of course pak128!

Combuijs

Nice!

(You almost want to edit the values immediately, which of course is not possible...)
Bob Marley: No woman, no cry

Programmer: No user, no bugs



HDomos

Wow this is good :) The tram tracks aren't in the overview mode though...

VS

That's because for some reason they still have the old-style dat (wt=track, system_type=7). If you take a better look, there will be lots and lots of these little quirks...

My projects... Tools for messing with Simutrans graphics. Graphic archive - templates and some other stuff for painters. Development logs for most recent information on what is going on. And of course pak128!

mEGa

Current projects in progress : improvements of few designed french paks

Sarlock

Current projects: Pak128 Trees, blender graphics

VS

#6
I have added stations and extensions to the report. (Not attached anywhere.)

Next up are vehicles. However, there is a "small" problem. Vehicles can be sorted filtered by waytype, or goods, or both, and to complicate things a bit more, usually there are engine-only units (locomotives, tractors, tugs...) which may be interesting to see along with a specified goods type.

So, I can have a 3-dimensional matrix of static tables, with goods, waytype, and with or without pushers. But... Is that the right way to approach this? Do you think such type of organization will be good?

I could probably go the other way round, only sanitize the data in Python, and partially generate the actual reports browser-side. Less data duplication, but yet more coding in three (or four?) layers.

Comment please :)

My projects... Tools for messing with Simutrans graphics. Graphic archive - templates and some other stuff for painters. Development logs for most recent information on what is going on. And of course pak128!

VS

Well! This warrants a doublepost:

Vehicle parsing works, and the unholy waytype-goodtype matrix is temporally stable along all unfolded dimensions :P Wait with the fireworks, though, there are still many stupid bugs littered through the code for images. The generated output is simply bigger than what I am willing to upload, so here's at least the updated yet buggy script instead...

TODO:
1) gfx bug hunt
2) alpha release of script + docs for paksets
3) fireworks ;)
4) vehicle constraints in details
5) translations
6) factories and goods

My projects... Tools for messing with Simutrans graphics. Graphic archive - templates and some other stuff for painters. Development logs for most recent information on what is going on. And of course pak128!

Sarlock

Awesome, VS!
Is the finished HTML able to be hosted on the pak128 web space?  It's a great resource... I've built some hand-made Excel spreadsheets for this exact same purpose, it would be so wonderful to have a way to generate that data directly from the DAT files and be able to updated whenever required.
Current projects: Pak128 Trees, blender graphics

VS


My projects... Tools for messing with Simutrans graphics. Graphic archive - templates and some other stuff for painters. Development logs for most recent information on what is going on. And of course pak128!

IgorEliezer

It's wonderful! No wonder why I'm learning Python.

mEGa

Current projects in progress : improvements of few designed french paks

Sarlock

This is very nice... very well done!  Good job on the 3-D sorting logic.
Current projects: Pak128 Trees, blender graphics

VS

Fortunately it is not 3D, I gave up on the 3rd dimension. That would have been a bit too much. This way, you can always open the list of engines in another tab...

I just found that some of Fabio's ways break, which means they use offsets. Well. Back to coding!

My projects... Tools for messing with Simutrans graphics. Graphic archive - templates and some other stuff for painters. Development logs for most recent information on what is going on. And of course pak128!

VS

ARGH! I am so obsessed with this, I can't stop...

new TODO list:
* vehicle constraints
* ???
* economy - goods and factory
* more interlinking
* pretty output - dates as dates, capacity as "x units of y", translating all texts, etc.

My projects... Tools for messing with Simutrans graphics. Graphic archive - templates and some other stuff for painters. Development logs for most recent information on what is going on. And of course pak128!

VS

New version of documentation with vehicles. Please comment - what would be a better layout, what data do you want to see in this?

Script is in svn since forever (or so it seems)...

My projects... Tools for messing with Simutrans graphics. Graphic archive - templates and some other stuff for painters. Development logs for most recent information on what is going on. And of course pak128!

mEGa

Current projects in progress : improvements of few designed french paks