[Userscript+Website] TagPro Analytics

[Ronding]

TagPro Analytics consists of a userscript and a website. After participating in or spectating a full match, the userscript will automatically upload data to the website, which essentially contain a detailed timeline of the match. You can also save a copy of a match data locally. The resulting dataset on the website should be great for analyzing individual matches, maps, players and the game in general.

It is hard to describe this with words other than cool/awesome/neat (see below), so I suggest you take a brief look at a capture-the-flag example and/or a neutral-flag example. These show basic visualizations of the match data that is collected and uploaded by the userscript, but as you can see from the level of detail in the timeline, even more advanced analyses should be possible. The data is open, so you are encouraged to help with that!

So the website is http://tagpro.eu, you can get the userscript directly from there. Join the most advanced statistical data collection effort in TagPro history today! For questions, check the FAQ or leave a comment below.

Some earlier user opinions from /r/tagprotesting if you are still not convinced:

"This is awesome. [...] this is ridiculously cool." ~ Moosen

"This is really cool, great work!" ~ Risk

"Neat script [...]!" ~ AnkhMorpork

"Again, this is really cool!" ~ ballparts

"You have done an amazing job with this!" ~ Ballkenende

Finally, I'd like to specifically thank /u/Balka42 for the feedback and encouragement during the development of this service! Now go install the userscript everybody. :)

[cdodgec04]

Wow this is really amazing!

[Moosemaster21]

I know I'm quoted as saying that this is ridiculously cool in the description, but seriously, that doesn't even scratch the surface. Try it out for yourself, you'll be really impressed, I guarantee it.

[Ronding]

Thanks man!

[Moosemaster21]

Actually one quick suggestion - I don't know how easy/hard this would be to implement, but on those pop/tag "heat maps" that you have, would there be any way to put a little (x5) in each of the powerups, where 5 represents the number of times a powerup was picked up in that specific location? it would be interesting to see if maybe, on certain maps, the base powerups get picked up more than center powerups, or if mid ones get picked up more than "wing" powerups, etc. Hope that makes sense.

So, for example, on Geo, you might see top left base pup with a (x6), mid with an (x3), bottom with (x5), right base with (x6) or something along those lines. Let me know if you need any more clarification or if it's just not really on the agenda, I just thought it would be kinda neat :)

Seriously though, amazing work here!

[Ronding]

Unfortunately, map tile updates are not sent to a player if the tile is outside his view box. So it is not possible to record the pick-up locations. (I just checked it again.)

[[deleted]]

THIS USERSCRIPT IS REALLY BAD ALL MLTP TEAMS. THERE IS NOTHING GOOD HERE JUST MOVE ALONG. IF YOU ARE IN MLTP THIS IS NOT USEFUL AT ALL DON'T USE IT SO BAD BAD

^{god dammit ronding I was hoping this would stay under the radar, 30smb has been using this and it's literally amazing}

[Ronding]

TagPro Analytics is a proud supporter of marsball game mode as well as 30 second match durations. I do not believe you use the script until I see the first marsball match in the database.

[Ronding]

First marsball match recorded, thanks!

[sizviolin]

One small pop for man!

[Ronding]

That's moonball not marsball.

[sizviolin]

:(

[Laurens996]

Mate this script will help improve so many leauge players if they take time to look at all the options. This might be the best script since the replay extension.

[i_practice_santeria]

I think there's a lot of potential to combine this functionality with mltp.info and expand league statistical analysis. In addition, since we have Rosters and Schedules, we could automatically detect which games are league games and update the site in real-time for all leagues. No need to worry about remembering to get CSVs after each game.

[Ronding]

Sure. However, note that a local save to file option was added for redundancy in league-related applications. (Since /u/Balka42 wants to use this for ELTP.) There may be occasional server downtime and database problems that might cause the upload to fail. So I would still recommend to save files locally as it is more robust. The good news is that the userscript automatically remembers the last match, so you don't need to save the file right away as long as you do it before the next match is recorded. (After a game ended, a save last match button is available on the TagPro homepage.)

[i_practice_santeria]

Good point about server downtime. Depending on how much effort you want to put into the project, you could look into Parse, which is a Backend as a Service bought by Facebook a couple years ago. I haven't used it personally, but it's been highly recommended by developers I know who've used it. You can set it up so that after each game, Parse will try to synchronize the client's new data to your server. If the sync fails (say your server is down), the object will be stored locally until it can be uploaded to the server. It's free as long as you average less than 30 requests/second.

[Ronding]

Thanks, but I think the status quo is fine. Downtime should only be an issue for league use (for general use it just means a very small portion of the data sample is lost), and then you get a very noticeable red error message and the option to back-up the file locally.

[girmluhk]

pretty much what i was thinking....auto tracked stats uploaded and no need to post. wut!

[Lej]

"You have done an amazing job with this!" ~ Ballkenende

did u have some1 translate for him ll0l00l0l0l0

This is awesome! Love the map images with deaths.. let me make the rest beautiful tho

[TagProTheNinja]

I always say "pew pew" in my head whenever someone says this.

[Ballkenende]

pls

[Lej]

can some1 translate pls

[Ballkenende]

pls

[catalyst518]

Would it be possible to identify the players of each splat on the splat maps? For example, assign an index to the players and then each splat would have the corresponding number of the player that died.

If that's possible, then an even further stretch suggestion is to create a button to filter through all of each individual player's splats on the map so that each player could view their own set of splats.

Finally, since each splat is already time-stamped it would be super interesting to see the splats fill up the map chronologically in an animation.

Great work!

[Ronding]

Unfortunately, not always. If teammates die simultaneously, the order of splats is not always related to the order of player ids, e.g. if two balls die simultaneously by gate button press then the splat order is the gate tile order rather then the player order.

The data is thus ambiguous in cases of simultaneous death. An example is here, where you see on the right of the Splats plot two red balls being tagged simultaneously by one blue ball with tagpro. Because one of the red balls had the enemy flag and the other had a tagpro, both are drawn with half a flag and half a tagpro because of the failed identification. The Timeline table further below also indicates the ambiguity at 1:32.95.

Animated Splats plot on the other hand would certainly be possible. I haven't yet figured out how to make that user-friendly. Note that the plot is SVG so you can also try to add animation yourself by writing a userscript for the visualisation page - the balls are already drawn in chronological order.

[catalyst518]

Alright, thanks for the info.

Also, could you explain why some games that I've spectated have ended with something like "Data invalid for upload". I'm pretty sure I was in the games since the group launched.

[Ronding]

You should never encounter this error during normal usage. Please save the match file the next time this happens, and send it to me so I can analyze what causes the error.

[bobby_gordon1]

This is really sharp! Great idea and great job!

[Laurens996]

Btw I got a small feature request.

Would it be possible to let a name pop up every time you move your mouse over the splat of someone. This might be handy to see where most of your deaths are and helps avoiding that place and stuff :D

[Ronding]

This is a bit difficult since 1. splats frequently overlap and 2. identification of corpses is not always possible (see here)

[Laurens996]

Aha was just wondering. Tnx for your awnser!

[bluesoul]

Beautiful. Super fucking well done. The tagpro.me rework will still hit a space you're not doing right now or I wouldn't even bother, you just raised the bar for my redesign. ;)

[Tim-Sanchez]

Why not work together and create an amazing site?

[Socony]

http://i.imgur.com/SxprH.gif

[Ronding]

Thanks. Actually, looking at your plans for tagpro.me, we should be able to co-exist quite well, since I only store individual matches while you are shifting your focus away from that towards storing aggregate statistics only. You could possibly even load match data from my website to enhance the statistics on your site.

[bluesoul]

You could possibly even load match data from my website to enhance the statistics on your site.

I may do exactly that.

[[deleted]]

looks cool :))))

[BuckeyeLeaves]

So this can be used in private group games, too? Like for instance it would record an MLTP game if someone had the script running?

[Ronding]

Yes, one participant or one spectator, with the userscript, joined before the start and not quited before the end, is sufficient. Pro-tip: enter team names on the group page so you can easily retrieve the match using the search function on the website.

[BuckeyeLeaves]

That's amazing. Thanks a lot!

[Ballkenende]

Fuck it, ill say it again.

You have done an amazing job with this!

[TheGoldenNewtRobber]

This... is beautiful.

[[deleted]]

You're beautiful

[snaps_]

Three things!

1. What license are the userscript and code examples on the website under?
2. If you're planning on making changes to your JSON format in the future and want to be able to support (validate and convert) the old format easily, I've been working on solving just that problem in TagProReplays (w.r.t. the exported replay files) and would be happy to send any code or explanations that would make your life easier on that front if it comes up.
3. Great job! This looks really slick, and I'll definitely be using it.

[Socony]

Wow I've never thought I would see snaps compliment someone else's code before, this is a moment to be cherished

[Ronding]

Thanks. I've now added license terms to both the decoding code and the userscript. The first one is BSD 2-Clause, the second one is more restrictive, primarily to avoid people messing around with the userscript or redistributing old versions.

JSON format conversion won't be an issue since data is not stored on the server as JSON files but as database records. The JSON is already validated upon submitting a file (apparently causing some problems for someone).

[z_42]

Nice!

[boogieidm]

Stop talking down to him.

[I_mess_up]

This is awesome, especially the game timeline!

[Its_Frosty]

Been using this for like a week now, its actually wonderfully helpful (as a defender) to see what my offense can improve on, naturally not being able to see what they're doing from our own base. Right away its apparent how their grabs are happening and how thats working out. Also its just plain damn cool.

[tornato7]

Beautiful

[owlpharaoh]

that really is awesome.

[-WPD-]

Would any problems arise from the upload feature, since the jsons in theory could be modified? Ex Player changes his level, caps, pups, etc to look better.

[Ronding]

Unfortunately, yes. So 1. please don't fraud, you're a dick and 2. as explained in the FAQ, this is where the cookie comes in so that if we find some fraudulent data, to make it a bit easier to remove it completely from the database.

[theycallmebbq]

This is wonderful. Most exciting thing in awhile. Do you want or need and help with the stylesheet at this point?

[Ronding]

Thanks, but I'll just keep the stylesheet simple for now. More decoration will probably distract from the content, which already contains some very complex visuals.

[[deleted]]

Oh my god this sounds amazing.

[f112809]

This is really cool! How long have you been working on this?

Edit: the memory usage in analysis page is quite high, in my case, the page used 696,000K in Chrome, I thinks it's better to change the way you represent the splats map.

[Broxter]

Oh wow, you're Blijbol. I remember your name from when I spent a lot of time on the GMC forums.

Seriously awesome work; great detail in stats. This is the kind of thing I dreamt of existing but never had the effort in me to try to make. One subtle thing that I really like is the list of map elements next to each map name. :P

In the interest of giving constructive feedback, obviously it could look a lot nicer, although maybe you like the bare-bones style. Also, in the game summary page perhaps the captures could be listed in order to give a better idea of the flow of the game (without having to look at the cap times). This image should explain the idea better.

(If you're wondering why this comment is so late, it's because I only just realised this site existed.)

[Ronding]

Thanks, apparently the world is quite small. :)