Saturday 20 March 2010

New Host

I've decided to leave blogger and move to blogs.scienceforums.net. The change is almost entirely simply due to the fact that the blogging community (and larger forum community) at ScienceForums is more fitting my subject matter, and it's an easier way to have people find my site.

The new link is http://blogs.scienceforums.net/GlitchHound/ and my new posts will all go there. For the moment it's under construction, but it's still fully functional.

For my one regular reader out there, be sure to update your link!

Weekend Plans

So, this coming week is the last week of classes before Easter break, and also the only week standing between me and US soil for a little time at home.

That means that this week is the final week for a lot of projects. Pro/E was one of them, but that's done. I have one assignment due Wednesday, and technically two due Friday (one of those being MATLAB, which will probably be pushed back). Incidentally, I have a friend coming to visit on Wednesday.

So that puts me in a predicament. I'd like to not be doing any sort of (boring) work while my friend's here, so I need to get at least the second project which is due on Friday done by Wednesday. Obviously the other assignment needs to be done by Wednesday. MATLAB, therefore, is technically my last priority. Expect to see that reflected in this weekend's turnout. I want to get at least a bare minimum done each day, with an arbitrary goal being something like one class/object per day. But the main priority is other work. And that means, little news on this front.

See you tomorrow.

Friday 19 March 2010

Unplanned, Yet Foreseen Hiatus

What's that? No MATLAB code today? Who's surprised by that? *Looks out over the crowd* I'm not seeing any hands. Oh, I'm not seeing any crowd, either.

Regardless, I'm still posting. Aren't I a trooper? Today I did absolutely nothing. Not even gonna talk about some decision I made. I have not discussed any code aside from talking about the idiocy of MATLAB's ridiculously expensive compiler.

I /did/ play a good game of L4D2 versus. I /did/ get a hell of a lot done with CAD in school today. But nothing code-related. And that means that this post, while short, is done.

Wednesday 17 March 2010

30 Posts! Consecutive, no less!

Considering the average number of days in a month (in a non-leap year), rounded to the nearest integer (just truncated in a leap year. Yes, I did the math on this) is 30, I'm considering myself one full month of daily blog posts into this. For me, that's pretty impressive, as I'm usually the kind of guy who commits himself to something and then gets bored of it.

That said, I have literally accomplished NOTHING else today. Programming-wise, at least. I did get a new best answer for actual Java-related help on Y! A, but otherwise, nada. Zippo. Zilch. Get the picture? And here I thought I'd have time to do something today.

I did make one decision. In order to practice my object-oriented programming in this upcoming MATLAB assignment, I'm going to strive to achieve well-isolated code. I intend to program the essential workings first, getting the calculations encapsulated and finished, and then work on integrating them into the GUI and everything else. With Java, this is how I program already. With MATLAB, I programmed everything last time top-down. I built the GUI, then made the callbacks, then made the functions. It was actually ridiculous, in hindsight.

Doing things this way will give me the two-fold advantage of having the opportunity to play around with different arrangements and also allowing me to throw together a basic version if I find the optional stuff is taking too long.

And... that's all I've done today. Well, better than nothing. And still, a milestone! I'm happy.

Overcomplication, and How it Simplifies My Life

Did some thinking on MATLAB today. Not content with just doing a GUI, I figure I'm going to implement a simple sort of file I/O system whereby when a user enters constant values it can save them, and then reload them on a later start of the program. The inputs required include some that will be different on each logon, but things like the wingspan, chord length, and (empty) mass (and weight) will always be the same. As a result, it would save time in the long run, assuming, of course, that this program is usable beyond the marks it earns me, to be able to save an aircraft configuration to reference by name at a later point. It should also save time.

I looked over the functions today and, while not simple, they certainly look possible. Since my Java program has yet to actually produce output, and that output is going to be database-oriented, I figured it'd be a good idea to learn the basic .txt input/output procedures. MATLAB is object-oriented, so I should be able to manage stretching the assignment into a learning experience for Java, even if it isn't exact.

Depending on how much time we have (the lecturer suggested he may be pushing the deadline back on account of the actually massive workload we have between his assigning the project and the due date, including this being a solid week of CAD training), I was considering doing a bit more optimization work on the first assignment and packaging both assignments together into an "Aerospace Tools" package, with a central launcher accessing both. But that's entirely optional and will only happen if I do have an extra three weeks (given the holidays starting the day after the current due date, this is possible).

I'm still reading through Yahoo! Answers, having a good time of it. I actually got chosen as a best answer, and the best part of it is that it was the only question I answered half-heartedly. It was someone asking for a good free place to make a blog, and I simply recommended blogspot // blogger here. I like to think I've helped some people out with their code, but I know I won't get some best answers simply because I refuse to actually do people's homework for them, instead choosing to try to explain how they can do it.

That's all for today, though. Tomorrow's the only short day we have this week, so maybe I'll get some coding done.

Tuesday 16 March 2010

General Thoughts on MATLAB

MATLAB is a nice program. It's great for doing what it does, expandable, pretty easy to program, overall a very handy tool. Seriously, though, they haven't thought much about usability so far as I can tell. This isn't a rant about the program being hard to use for built-in functions. In fact, that's all pretty easy and, more importantly, well-documented.

This is a rant about development problems. Like any progamming language, you can code MATLAB programs in whatever text editor you feel like using. Unlike most, however, there are no third-party IDEs. Compiling code requires that MATLAB be installed (and in most, if not all, cases running), and if not MATLAB then a very expensive compiler. There's no such thing as a third-party compiler.

Compiling code is important as it's how you test it. Hopefully you don't get compilation errors, but if you do they'll tell you what's wrong. But you can't test for run-time errors without first compiling the code. In other words, I can't possibly develop efficiently on any machine that doesn't have their very expensive software on it. Nor can anyone else, of course.

I find this to be a major flaw with MATLAB. As great of a platform as it may be, it's such a hassle to program that most people prefer to program in a more accessible language. And it's not like those languages can't be manipulated to allow for the programs that MATLAB can support. In my opinion it was a seriously poor decision on their part.

I don't think Mathworks minds, however. They have a very strong hold on the academic and scientific markets. Their customers, mostly, make due with what they have. In other words, I don't expect anything to be changing on these fronts.

All I can do is post a mini-rant on my blog and suffer though the little inconveniences that these problems cause me. Or theoretically fork over $5,000 (no joke, I made an account on Mathworks to confirm this) to get the compiler for personal use. Can you guess which solution I chose?

Monday 15 March 2010

Old MATLAB Improvements, Java Data Objects Primer

Matlab m-file (Download and run) 

Matlab Source Code (to view online)

For the most part I haven't changed the workings of this code. I did change one error dialog that told you the height needed to be between 0 and 20,000 meters when inputting an incorrect value for the height increments. Just a copy-paste situation where I forgot to edit the message. The big changes here are comments. It's quite thoroughly commented now and should be a bit easier to follow. I also commented-out the "Standards Selection" box, which was unusable, and centered the title information to make it look more natural. Finally I cleaned up a function call that was passing the constants array despite the fact that the other function had full view of the same array. Basically, unnecessary transferring of variables. Theoretically should have sped up the code. Considering the ambiguity of some of this code and the amount of time that passed between writing it last and doing this editing, I'm quite pleased with my ability to understand what was performing which actions throughout.

After finishing that I decided not to start the new assignment yet. Instead I started reading my book on JDO. The more I read, the more excited I get about the system. It really seems quite easy to work with and I'm excited for the implementation of it all.

I'm not sure I've talked much about JDO and why it's important to my application and Java in general, so here goes. Java code is run in a Java Virtual Machine. This is what enables it to be so universal... once the JVM is started up, one computer "appears" to be exactly like any other. At least in terms of executing the code. Unfortunately, every action the code performs is done in this Virtual Machine, and this means that everything that's been done is deleted when the code finishes, as the code finishing results in the JVM being closed. Saving in Java is done by file output during the execution of the code, by Serialization, or by storing the values of a class's variables in a database.

The first, file output, is mostly for saving a text file or similar. It's simple and useful sometimes, but it's simple and therefore not useful other times. In the case of my simulation, it's impractical due to the methods of parsing a text file back in (it would take AGES) and due to the ease of editing that text file between sessions to hack the game. Besides that, saving the file on your computer makes it tough to have an exciting multiplayer experience.

The second, Serialization, is complex. Essentially it converts the state of an object into a stream of bits and bytes, then on loading deserializes it back into its object form. These bytestreams can be large, but more importantly it's a bit unwieldy to program a class to be Serializable and program the Serialization and Deserialization across a full application like the simulation. There's also, again, the problem of things being stored on a client computer and making multiplayer a bit lackluster.

The third is storing values in a database. To start with, we'll ignore JDO. Storing values in the database means building a database (using SQL, most likely), linking the Java code up with it through the JDBC API, and programming in all the possible commands for editing the database that the client will ever use. While it sounds daunting, it's certainly doable and it had my vote for a while. Every time the client-side application is run, the user would log into the database and it would load all of his/her details, initializing all the objects necessary and setting the values back to what they are in the database.

Then comes JDO. JDO is a standard that allows me, as a Java developer, to program everything in Java code. I don't need to build my database with SQL to start with, I don't need to include ridiculous amounts of SQL hidden among the Java I'm writing, I don't need to specially format my classes. All I do is write the class as normal, enhance it with an automated tool (which builds into the class all of the methods necessary to view and edit it, automatically), initiate my database with a similar automated tool, and tell my program to make an object persistent whenever I need it to. Loading that object isn't always done per se, more often you just access the values in the database. It's just that those values are set within the Java application and without any complicated translation are plopped into the database in a Java-accessible structure.

It's really the easiest of the bunch I've seen so far. I can't wait to actually use it.

But first... I have more MATLAB to code.

Sunday 14 March 2010

Java Hiatus

Alright, I'm officially putting my Java development on hold from this point until... well, when I change my mind (probably no more than a couple of weeks, possibly much shorter). The reasons for this are twofold:

  1. While I enjoy Java more, I'm actually required to do my MATLAB assignments, so I need to get to work on them.
  2. Before going on with serious development, I need to know what exactly is required for creating a Java Data Object database.
If I continue without researching JDO more thoroughly, I may well find myself stuck deep in the mud when suddenly it turns out I needed to implement specific classes for each of my classes, or I needed to ensure certain formats matched up or whatever.

I managed to find a book on JDO online in PDF form for free download. If you search Java Data Objects on Yahoo! Groups, the first result should be a site for the book, and if you become a member you can download it as a PDF. I haven't read it yet but it should be more useful than nothing by a long shot. That's what I'll be doing when I'm not thrilled with the idea of MATLAB and I need to progress on my Java developing.

Also, I've started scrolling through Yahoo! Answers, trying to provide help to people looking for Java//Generic Programming help. I refuse to outright code people's homework (or midterms, like one person asked) but hopefully the information I give is useful for those who want to learn what they're doing. It's also a little bit of publicity for the blog, by having it linked from my profile. We'll see if it gets anywhere, I'm not holding my breath.

Saturday 13 March 2010

Contract for the Material class

Today's post is mostly organization for me, setting down guidelines for the Material class I'm working on. Still, this could also serve as an informative post as I'm using strategies set out in some of my books.

A contract is essentially what the name implies: a list of terms and conditions. In these particular circumstances, it's a list of things that the class is expected to be able to do. In the professional world, a contract is often what a programmer will receive. How the person works out the inner dealings of the code is unimportant, so long as they accept inputs defined by the contract and return outputs defined by the contract.

So, without further ado, the Material contract:
The Material class must be able to:
-Create a new instance, with String inputs name and matcode.
   -Verify the formatting of the input (11 characters, a-z only).
   -Convert the characters of the matcode to integer values 0-25.
-Include classes to set individual attributes with int 0-25 input.
-[OPTIONAL] Include classes to set/get attributes by name.
-Include a class to get the current matcode of the material.
-Include all classes to produce a GUI to view and modify the material.
   -Construct input panel.
   -Construct edit panel.
   -Construct output panel (display graphic).
-Include a list of market prices for the past 12 weeks (or more).
   -Method to set current price (saving old price as above)
   -Method to archive prices when they're removed from above list.
   -Method to get current price
   -Method to display a graph of past prices
   -[OPTIONAL] Display graph including archive.


I'm pretty sure that's all, at least for now. I think it's safe to say that everything except the market prices has been coded, though it hasn't all been migrated to be within the Material class.

Remember I said that it's up to the programmer to decide how to then code the inner workings? That's how I think I've come up with another class. And then from the fact that I'm also developing the whole thing, I decided on another still. Internally, the Material class will also host the MatCode class. This class will make it easy for a Material method to alter a specific attribute by calling methods within that class. It will allow for error checking, editing materials by supplying integer OR character values, and overall serve to be a convenience class for making the Material class look cleaner. That said, it won't be needed outside of the Material class and serves as a good internal class.

As an external class, I need Price. Basically all it does is store a price and the date that price was set. It will be used for a number of different objects and needs to be outside of the Material class. Mostly, it makes the eventual database more useful when the price is its own object storing pertinent information.

With these done in a day or two, I'll be able to move on to the next class, probably Planet. But also expect some work done on both my old MATLAB project (ISA Calculator) mostly in the form of adding comments, and my new MATLAB project.

Friday 12 March 2010

Mobile Solution, and (Re?)inventing the Wheel

I've settled on an IDE called tIDE. It doesn't seem to be very popular, but I find it to be amazingly quick when set up on a flash drive, it's remarkably small, and it works quite well for everything I need. It's not Netbeans in terms of some convenience features, but it's actually survivable to use it for programming on the go. Compiling and running take a little bit of time, but that's because I'm running the JDK and JRE off of the same flash drive, which is not an inherently quick method for it.

Overall I'm quite pleased with the result, but I'll keep you posted if something happens to change my mind.

Now, I know, I was almost done, right? But no, I've decided to go back and play with the Matcode Interpeter I've nearly finished. In terms of hard stuff, I'm not doing too much. I've decided, however, to use a Material class rather than a string for the Matcode it edits. What's this mean? Well, a number of things:


  • Editing a single character in the MatCode is a bit easier and mostly more accessible, as the method is stored within the Material class.
  • The eventual creation of Materials will be easily managed through just the MatCode Interpreter (/editor), as the new Material object will be made and then uploaded to the database.
  • The graphic panel displaying a material's stats will be accessible by any and all objects that need to reference it, quite easily.
  • By moving all the buttons and panels I've been making to within the Material class, any panel throughout the entire simulation that needs to view or modify a Material can easily access all the tools that can be used for it.
In all, it's a more thorough form of isolation and encapsulation. It's also the general strategy I'll be following for all of the objects in the game from this point forth. In hindsight, it's blaringly obvious, but, well, hindsight's always 20/20.

Thursday 11 March 2010

Mobility and Programming (also: New Assignment)

Two major things today.

First, I'm working on getting a programming thumb-drive set up. Until I have a netbook, or, better yet in terms of performance, a laptop for my programming endeavors, I need some solution for mobility. My desktop and the PS3 are both set up on the same screen, which makes developing tough while my girlfriend slogs her way through Final Fantasy XIII, Tom Clancy, or whatever else she happens to be playing. I've tried a wide range of solutions to this but none have worked out. I haven't been able to get remote desktop working reliably, my first attempt at a thumb drive failed horribly (my second attempt is currently copying over), and I can't really think of much else.

When it comes to using my girlfriend's laptop, I could certainly install my tools on it and just worry about having the code on the thumb drive. But when I'm in school or anywhere else, that doesn't work so well. I'm now trying combinations of installing the IDE I normally use (Netbeans 6.8) on the flash drive as well as the JDK necessary for coding, installing just a text editor with some programming features (like highlighting code and suggesting auto-completion), and everything in between.

So, that said, I've also got a new MATLAB assignment. It's basically along the lines of the last one, accepting user input values for an aircraft and its flight, and working out things like cruising thrust and drag coefficients. No plotting this time but a few more complicated output values. We've got two weeks at this point, but given next week being a full-time (9-5 Monday through Friday) intensive CAD week, he's agreed to probably push the deadline back. Seeing as Easter holidays start the day after the current date, that would mean we have at least an extra three weeks.

I'll be getting started on it by the end of this weekend. I'd rather not take my chances. Besides, I like this stuff.

Wednesday 10 March 2010

Another Link in the Chain

So I've linked all of the characters to their own characters. In other words, I'm nearly done with the matcode piece for now.

I think next step after this is work on some of my data-storing classes. I'm working on thinking out the different things that will go into the management of an empire. A lot of what's to come isn't very graphical in nature, but, hey, it needs to be done for progress to be made.

I'm thinking an interface for sim-based objects, abstract classes for spatial bodies, for military values, for whatever else I can come up with. Non-abstract classes will then flesh out the specifics. I'm also trying to decide how best to organize the data within the classes. For now, though, I've still  got a while to go before I get to that having an effect.

Did I mention L4D 2 is a lot of fun? Oh, and FFXIII too. Lack of significant progression can certainly be attributed to the presence of these distractions. Fun times, these.

Tuesday 9 March 2010

Down to Business

Er... Left 4 Dead 2 is business, isn't it? And Final Fantasy XIII?

Yeah, having acquired these two games in the past 12 hours, my free time today was not very code-producing. I read a bit of my book during downtime in school, but the only snippet I've managed to add to my code was connecting the MatEditLine (previously described, still lacking the appropriate button sizing (in my opinion)) to a specified character in the material code. And heck, even that's not complete because it's a one-time linkup rather than a constantly-updating link (for the moment--that's a small thing to change).

I imagine tomorrow will be similarly... unproductive, but should have some sort of progress, like usual. It won't take me more than a few days to get back to programming as much as I have been up to now. Oh well, for now, it's bed-time (or maybe time to observe Final Fantasy... I'm not quite sure.)

Monday 8 March 2010

The Little Things

I got hung up today on the stupidest thing. My buttons.

They work great, do exactly what they're supposed to do. But my buttons bug the bejeezus out of me. Why? Because they're huge. I just want a nice little square button with a plus sign on it, maybe a minus sign, maybe two. They just do "fill," "add," "subtract," or "empty" on the value they're editing.

It's the "little" and "square" requirements that are annoying me. For some reason or other, the button truncates the string to "..." when it's smaller than 40 pixels wide. The plus sign is THINNER than the ellipsis, by my approximation, but is apparently too large to display. If I want the "+ +" label to display I need to extend it to 60 pixels.

Simple math says each character is 10 pixels wide, and the string needs to be a minimum of 15 pixels from each side. That's what Java is deciding. I can't figure out how to change this. I've asked in some forums and will keep searching, but this is what is currently holding up my development. I hate being obsessive-compulsive sometimes.

Theoretically progress is proceeding nicely. I added the functionality of showing the current matcode in the text input, a small feature mostly useful for changing your mind and therefore leaving the input with an empty string when you decide to play with a different setting. It also prepares the link-up of the value-editing MatEditLines that I've created to the matcode being displayed.

Still, this little tiny problem has bugged me enough to cause me not to progress too far forward. It's really a shame. Oh well, there's always tomorrow.

Sunday 7 March 2010

Where There's a Will There's a Way

I'm starting to realize more and more that, however convoluted it may be, there is always a method to get my program to do what I want it to. Sometimes the method is messy. Most times, I just assume it's messy and skim over the really easy answer for a few hours.

So far I've completed compartmentalizing the input panel (and successfully). Now I'm working on the editing panel, which consists simply of a fill button, an add button, an identifier of the current value, a subtract button, and an empty button. Repeated 11 times, once for each character in the Matcode, of course. I've gotten the edit line finalized (just did that now), so that I can simply repeat that 11 times. I still need to code it to accept those 11 values, in order, as a Matcode and make the appropriate graphic. Also, as this is a tool mostly for myself as the eventual administrator of the simulation, I'll have a points system set up so that every time I add or subtract a value I see where I stand versus the average number of points I'd like for a material to have. Just as a guideline.

The final product will link the current code in the text input to the code being manipulated with the +/- buttons in order to make a more intuitive interface.

The work I've been doing the past couple of days has been frustrating. It took a long time to make something that still isn't actually very useful. Still, not all was lost. I finally understand how to make a subclass constructor actually do what I want it to. I had been programming a stupid little setup where the constructor simply set instance variables, then constructed a version of the superclass. It then returned this superclass in a separate method, making the class I defined essentially useless except as an instance variable holder. Turns out, and I've finally stumbled across this factoid, that the first line of a constructor's code is supposed to be a call to the constructor being used. Worse yet, all the times I didn't place this call, the program calls it anyway and I simply don't make use of it.

Ah, well, live and learn. Have to go back and edit a couple of constructors, but for the most part that won't take much at all. Time for bed, now. I'll be back tomorrow.

Saturday 6 March 2010

Efficient Algorithms and Abstract Data Types

These are the things I've learned the most about today. I've read through roughly a quarter of my new book so far and I'm liking what it's teaching me. It started with algorithms.

Algorithms are basically just set methods to achieve some sort of goal. A majorly important aspect of them is that they're broken down into pieces, and set up in such a way that a machine (computer, mechanical, or whatever) can perform them step-by-step. You increase an algorithm's efficiency by reducing the number of "characteristic operations" done to complete the task.

Consider, as a metaphor, rabbits. You start off with two rabbits. Each set of two rabbits produces two offspring, and so on and so on. (Note: this is, indeed, a vague shroud covering the exponential equations used as a model in the book, and would be plagiarism if I didn't acknowledge the fact). Presuming we're not considering bunny lifespans in our scenario, the number of rabbits around at generation 1 is 2, at 2 it's 4, at 3 it's 8, 4 it's 16, and so on where n = 2^n rabbits. If you're in generation 1, it only takes n = 2 to calculate the answer. At generation 2, n = 2*2 for anything to determine the proper value, which is one characteristic operation (multiplication is done one time).  At three it's n = 2*2*2 (two characteristic operations), and so on to infinity.

In other words, it takes (n-1) characteristic calculations to determine the number of bunnies we've got running around our backyard.

Instead, you can consider the fact that for n = 1, it's simply 1*2 bunnies. For n = 2, it's 2*2 bunnies. For n = 3, it's (2*2)*2. This looks sloppy. Instead take n to be 100. For the first case, it takes 99 multiplications to get the proper answer. For the second, however, n = (2^50) * (2^50), which can also be broken down to simplify. When programmed properly (the value of 2^25 gets stored in a variable, then multiplied by itself to get the value of 2^50 which is stored into that variable, for example), this then only takes 6 iterations to calculate the number of bunnies at generation 100. And yes, it's possible to arrange this to apply to any value of n. And for any base (not just 2), for that matter.

It's really an amazing improvement, and in terms of code (the examples are provided in the book, I won't copy them here) you're looking at 1, maybe 2 extra lines to achieve that speed increase. Eventually I'll look over the equations I used for the MATLAB ISA Calculator assignment and try to figure out a quicker algorithm for that work. I'm sure something exists.

So, what are Abstract Data Types then? These are simply user-defined (where user- means programmer-) classes that serve to provide a structure and appropriate manipulation tools for the data stored within them. Technically pretty much every type of data in Java (or most any programming language) is an ADT, though most are defined by the language. Generally an ADT fulfills a specific role known as a contract, which states explicitly what the inputs to the class will be, what kinds of manipulation and output one can expect to get from the class, and what data must be stored within it. It's then the programmer's role to decide how to accomplish those goals most efficiently, without methods that are uncalled for (unless they serve to ease the processes that are required). I've been aware of the basic concept for a long time now, but the specifics of planning the type and implementing it as code is becoming more and more clear as time progresses.

I expect a lot of progress this weekend, as well as documentation of that progress.Wish me luck!

Thursday 4 March 2010

Computer Issues, More Code, and Toast

My girlfriend's laptop is on the fritz. I think there's a virus on it given how it's acting, though I admit she's usually more cautious about them than I am. That said, I spent a while working on it today and it left me with limited time.

Still, I finished the builder pattern. It works perfectly for the text box I used before, and I imagine it won't have any problems with any other text boxes I make. In the end I had a nasty if/else structure in the processing of the input text, but I spent a long time trying to come up with a better way and couldn't find one. That said I did reduce the redundancy of it by creating method calls to do any repetetive tasks, so while the structure is a bit messy it isn't very wordy.

Tomorrow will see the finalization of the interpreter with the last internalization of the input panels. Aside from that, I got a new book to read from the library. This one is actually one that I'll probably read cover-to-cover rather than as a reference book to pick and choose sections from. It's called "Java Collections: An Introduction to Abstract Data Types, Data Structures, and Algorithms" by David A. Wyatt and Deryck F. Brown. I'm hoping to find the best way of making my JDO classes by reading through it.

In all, a nice and short post, expect more tomorrow.

Wednesday 3 March 2010

"Bob" the Builder (pattern)

So, I've heard of Java constructors. These friendly little guys make an instance of an object when the program calls them, setting variables if necessary, making everything work the way you need to. Today, however, was the first time I'd heard of Builders.

Constructors can, sometimes, get really messy. "Setting variables if necessary" can get to the point where you have 20 variables to set and 18 of those are optional. It's nasty to program a constructor to properly handle optional variables and it's nasty to call a constructor with all of those variables. And who wants to print out a list of which variable comes when in the call to the constructor?

Hello, builders. Builders are like flexible constructors, but they require a bit more manipulation to set up properly. Basically a builder is a class placed inside the class you want to construct, and no constructor is made available for that class. Instead, you call the constructor for the builder (in Java syntax this means you call something like endgoal.builder() where endgoal is the thing being built), with any required values included in the () after builder. Then you continue calling optional values by adding .option1(), .option2(), and so on until the object is fully set up for you. All of the values that eventually go into your endgoal object are stored privately inside the builder class so as not to cause any funny business on the part of your outer class.

When you're all done, you call the endgoal.build() class to put it all together for you, as necessary.

What am I using this for? At the moment, validation on the text box used to enter Material Codes. Matcodes must be 11 characters long, consisting only of english alphabet letters. I convert the input to uppercase inside the material code interpreter's method, so it's not a big deal what case you use externally, but internally it does make a difference.

I realize that the matcode input is not the only text field I'm going to use, and in searching for the way to limit the maximum number of characters in a text field I've come to the conclusion that it requires making a so-called "Document" that tells the input box how to behave. This is easy enough, but why code a separate document for each text input when I can just create a builder?

For now I'm coding in the options to change the input to Upper/Lowercase depending on needs, to force the input to be alphabetical, numerical, or both, to set a maximum length onto the input, and finally to allow or disallow spaces in the input. In the case of my matcode text box, I'll call something like:


input.setDocument( new JTextFieldLimits.LimitBuilder()
.charLimit(11).toUpperCase().forceLetter()
.forceNoSpace().build() );

It looks a little nasty but for my sanity it's better than something more like:

input.setDocument( new JTextFieldLimits(true, 11,
true, false, true, false, false, true));

where I have to remember which position responds to which value every time I make a new input box. And that would be even longer if I come up with more options to throw in here. Don't forget that if all I want to do is disallow spaces, with the builder I can just do LimitBuilder().forceNoSpace().build() whereas with the other one I have to include all of the "false" values until the very end. And Java forbid I forget how many false values that adds up to.

The JTextFieldLimits class isn't quite finished yet, but it's progressing smoothly and I don't think I'll run into too many problems with it. Once that's done I'll get back to work on isolating the MatPolygonDraw class by having it build its own panels. I think I'll have both of those done before my next post.

Reference: http://rwhansen.blogspot.com/2007/07/theres-builder-pattern-that-joshua.html Thanks for the help!

MatPolygonDraw: LF More Responsibility, Better Name.

So, naming scheme aside, my "MatPolygonDraw" function is quite a capable function. It defines the vector of colors used to determine the fill color of the polygon in question, it draws the labels for each point, the bounds of the full shape, and the lines connecting each point to the maximum value for that point. In achieving these goals, it takes an input string, checks it for validity, determines its numerical value, converts the numerical value combined with its string position to work out the variable the value applies to and then determine X,Y coordinates of where that point is.

I'm sure it does more, but, meh, I'm still working on it so there's no need to keep explaining it. I updated it today to contain a nested class entitled matButton, a subclass of the JButton. Now, rather than creating a new JButton and assigning it an actionListener to make everything work as it should, the frame that hosts the MatPolygonDraw instance simply calls the getButton class, passes any pertinent information over, and receives a new JButton appropriately configured for the task.

Tomorrow will see the expansion of this concept. Rather than just the the JButton, I'll include the JTextField component and place both of them on a panel. This way I'll just call getInputPane or whatever I decide to name it and I'll receive both of these, properly configured. I'll do the same to create a getEditPane for manipulating the material's properties, and any other panes I may need to accomplish any task I can imagine that requires a material graphic interpretation.

Then I just make the structure for any other objects that need manipulation, I go ahead and follow the same process for getting the necessary interfaces, and voila, simple finished product.

In other words, I think I'm getting this, because suddenly I'm realizing just how little  work I'll have to put into the final assembly of everything compared to the creation of the manipulating classes.

In all, I'm content. It's time for bed though, and that leaves this post open for discussion. Any recommendations for a better name for this class? Preferably something that defines what it does, very concisely. Best name gets immortalized in my code! And... a cyber cookie?

P.S: I'm going to stop going ridiculously overboard on the tags for my posts. They're all about computing, no need to continue labelling that.

Tuesday 2 March 2010

Compartmentalization, Encapsulation, and Isolation, oh my!

I've been focusing a lot on these inheritance features today. I know, for instance, that I can create a class Planet, and that I can also create a class Moon extends Planet, so that the two are differentiated in name but don't need repetitive coding. I've been considering the pros and cons of making all of the attributes I've taken to calling low-level attributes (a planet's name, for exmaple... the things that the object stores that don't reference other objects) implement a custom interface.

Time for some explaining? I think so. In Java, a class (known as a child or a subclass) can extend another class (known as a parent or a superclass). This means that, unless an underlying method in the child overrides the parent's method (this is done simply by creating a method in the child with the same name as the parent's method), the methods defined in the parent are equally as applicable to the child. In the case of class Planet and class Moon extends Planet, as above, the method getSize() would return a number representing the planet's diameter, and would do the same for a Moon even without explicitly rewriting the code.

Now on to implementing interfaces. An interface is an abstract class, which means that it cannot be used directly. Instead, when a class implements an interface, everything written into that interface MUST be overridden by the new class. If I have attributes, to use the example above, which all have different variables within them (say, a description attribute holds text describing the object, an armor attribute holds a value representing the armor's strength), I can create an interface that defines getType() and getValue() as methods that MUST be overridden, therefore making the attributes universal in structure.

A Java class can extend only one parent lass, but can be extended by infinitely many children. A Java class can implement as many interfaces as it wishes, so long as all of the underlying methods are overridden. Because of the way these two aspects of "inheritance" work, they are known as two related but separate pathways of defining a new class. By making a new class a child of a parent class, you are inheriting behavior. That is to say, all of the 'hows' in the class are defined by the parent class, except for the occasional overriding method or additional method. By having a new class implement an interface, you are inheriting structure, because the layout of the new class must match the interface, but the specific algorithms used are specific to the new class.

There's my brief lecture on Java's inheritance. That out of the way, I haven't done coding work today, seeing as I instead attended a showing of "Willy Wonka and the Chocolate Factory" (that's right, the original) at the University. I did get a lot of (additional) thinking in and I realized one of the shortcomings in the current embodiment of the interpreter I showed yesterday. I have a button that is specialized for the window I showed you, not one I can place into just any window I place the graphic into. This also means that when I go to make a more capable "administrator" version that allows me to generate material codes on-the-fly, I'll have to completely reprogram that button.

Instead I can use some nifty features of Java's by including a specialized button subclass into the class that creates the material graphic. This subclass would be inherently tied to the material graphic that the button updates, and wouldn't require any coding except placement in the larger window.

Overall this would greatly increase the capabilities of the materials panel I've made, as well as the capabilities of any future classes I make. I consider this Compartmentalization (and I think the textbooks agree with me) because it means that any frame that uses the MatCodeInterpreter will, without extra work, be able to add the necessary buttons and fields to manipulate it.

I think tomorrow will see me working on making that a reality.

Monday 1 March 2010

Mission Accomplished!

For the first time in my blogging career of nearly two weeks, I have something to show you that I've been promising in relation to my Simulation. That's right, I have finished my material decoder. Well, at least functionally, certainly it needs work to be implemented.


That, my reader(s), is my new MatCode Interpreter in action. Type in 11 characters, hit evaluate, and a new shape will be made for you. I admit, it has limited practical use as it doesn't supply exact values (it could, just doesn't), but it gives a good representation of approximate values. The color of the figure shows an interpretation of the material's "Workability Factor," a fancy name for cost modifier. The interpretation is that the darker/redder the color, the more expensive it is to work with. This random material apparently is very cheap to work with. The ten named values are (clockwise from right (3 o'clock)) integrity, conductivity, combustibility, heat resistance [index], transparency, elasticity, magnetism, nuclear value [index], decay resistance [index], and [intrinsic] value. Bear in mind that mid-range values are assumed to be average. In other words, the only places this material is above-average are magnetism, elasticity, heat resistance, and perhaps combustibility.

Above average isn't always better, though.

Anyway, this is my first actually vaguely complex Java program, and my first go with Java graphics aside from JFrames (basically, windows and buttons). I had made the text layout in photoshop, but I decided instead to render it using Java's graphics, in part to better acquaint myself with the system and in part because for a long time I was having trouble figuring out how to get the image into the program. I've since figured it out, but that was after setting Java up to do it.

So... what's my next step? I have no freaking clue. But I have plenty of other classes to work on. Some should be pretty easy, just the structural classes for my JDO database. Others are more involved, making frames and panels for managing different pieces. I have a lot of work to go, but I've made the first sizeable step.

Sunday 28 February 2010

And in Health

Felt a bit better today. Still a little more playing around with graphics. I still suck, as if that's a surprise.

Given how Java implements its GUIs, I'm starting to question the usefulness of a visual GUI builder. Every component (essentially) needs to be specifically coded for its task before being placed into the GUI, and the builders don't give much help in that regard. That said, once I actually have the components built, the visual placement of each individual part will be a nice and convenient feature.

More work on the material decoder. I realize decoder is just a word I use because it sounds cool, but I'm sticking with it. Anyway, I haven't gotten far enough to test the output yet because I constantly get distracted, but in theory I'm about at the point where it does what I want it to. I hope to have, at the least, the interpretation graphic working tomorrow, which means the final build of the rest of the piece shouldn't take more than a day thereafter.

All in all, progress made, but not much of note. I'm dedicating tomorrow to working on it.

Saturday 27 February 2010

In Sickness

Didn't feel well today. As a sense of pride, I need to post something to keep up my trend. So I'm posting that I'm not actually posting.

Did a tiny bit of attempts at art and programming, slowly closing in on a prototype materials decoder, and now I'm getting still more rest. G'night.

Friday 26 February 2010

Making a Series of Menus Look Fun (also: Planet Classes)

Let's face it. Number crunching, data entry, and stat reviews aren't all that entertaining. It doesn't matter if the game they're all for is freaking awesome, it gets boring. I've been thinking about a few ways of making the management of an empire more entertaining even during peacetime.

If I can integrate messages and "forums" into the GUI, it gives the user more incentive to use the program. Also, putting in a chat system, while questionably useful for a small number of users, could occasionally make some entertainment. I intend to play background music, probably without including any files of my own. In other words, the user can integrate his/her own music library.

These features are all long-term planning, probably tough to implement, but they'd be brilliant additions to the game. Less long-term is making the game appear more entertaining.

My current hope is to develop (or find) a series of potential planet textures, as well as moon textures, and show animations of these in the background. When you're looking over your planets, you'll see an approximation of your planet and its moons rotating around. I don't think this will be too hard to implement and at the very least I'll have a static image of the planet in view. I have a friend looking into making them for me, but he doesn't promise anything. I pretended to do some work on it, but I suck with computer graphics. Hopefully I'll find, or have created, a decent set.

That said, if you can't already guess, I got distracted, so the GUI is not in any sort of displayable state.

I can, however, introduce my planet classification system. Avoiding copying a system from Star Trek or similar, I decided to derive my own. So, I give you my system:

  1. M[oon] or P[lanet]
  2. H[ospitable], I[nhospitable], C[olonizable], E[ngineer]
  3. R[ocky] or G[aseous]
  4. D[esert], A[rctic], T[emperate], B[arren], F[orest], J[ungle], W[ater], V[olcanic]
  5. Size (3 digit number, in 1000s of Kilometers (Megameters?))
In other words, a newly discovered planet will probably have a name something like: PHRT-013 and it may have a moon named MCRB-004. Follow the letters into the list above and you'll realize it's a planet vaguely similar to Earth with a moon much the same. Only thing that really needs explanation is the difference between I, C, and E. I means there's no way to settle it at all. C Means you can settle it via domes or other artificial structures. E means domes will work, but you could get more effect out of it if you terraform (sometimes called Space Engineering).

It's not ridiculously inventive or complex but I think it gets the job done. And that's all for now, tomorrow we'll see some sort of actual code progress. I cross my heart.

Thursday 25 February 2010

CRC Cards and How I Killed a Small Forest

Class, Responsibility, Collaborator. Those are the three things that go onto a CRC Card--the name of the class to be made, what that class does (including what data it stores), and which other classes this class interacts (or, as the name suggests, collaborates) with.

These cards are recommended as a tool for designing an object-oriented program. I do see the usefulness of them. That said, writing 41 CRC cards is not exactly the most entertaining way to pass time. And that includes a couple of cards that I finally decided to generalize, since some things like Ship, Vehicle, and Troop designs all actually contain the same thing and could, as a shortcut, be written on one card.

That said, I haven't gotten to programming yet but I've already seen a payoff from the cards in the form of an organizational hierarchy starting to form. I've got a list of seven classes that don't appear anywhere in the application, but will be great to add in as abstract parent classes. That is to say, I can make these classes with a set format but no data, and then make "child" or sub-classes that take that general structure and specialize it to their needs. It should also allow me to easily compare certain values.

As an example, a station could be built at any point of interest in a system, whether it's orbiting a planet, a moon, a star, or whatever else. Rather than having to store in the station's information both the name of the object it's stationed at and the type of object that is, by having all of these other objects (stars, planets, etc) as children classes to the overall Location parent class, I can simply have the station's location compared to anything that is a child of Location.

This will also work for fleets for current, and target, locations. As I said before, I haven't coded yet, so hopefully it'll work out half as well as I'm imagining it will, but it's nice to see things like this falling into place.

My plan, for the moment, is to develop the GUI class(es) next. I hope to have all of the GUI defined in one class, so that it can share a few easily-redefined variables, and then whenever I need a certain window I'll have the code handling that window call it from the list of already-created objects in the GUI. The intention is that when the user first starts the program, they'll be prompted with a login window where they enter their username and password, as well as being given either a list of display resolutions or a full-on configuration window (depending on how many things there actually are to configure). Personally, I'd like the application to run full-screen, but one of the options will most likely be a windowed mode. I did write up a little "Hello World!" fullscreen application, because I actually was doubtful that Java could even do that. It can, and therefore I intend to work with it.

When I say  I'm developing the GUI, I mean the bare minimums. Rather than dealing with test programs for all of my stuff, I'd like to just plug in the code to the GUI I'm actually going to be using. Formatting of that GUI can come later, since as far as the code is concerned, the button can be gray with the word "Exit" on it or it can be a picture of an open door, it's still the same object.

I have a lot of time tomorrow so definitely expect some preliminary work on the GUI to be done for my next post. I might even post screenshots, not that they'll be pretty.

Wednesday 24 February 2010

SQL Concurrency versus JDO, and why I want to make the switch

Small update tonight. I managed to not do much tonight except think. And think. And plan. The outcome is a decision to "scrap" what I have so far on the simulation and start new. Including, (most likely) the database.

And here I was promising the material decoder, huh? Not that it took very long to get nearly finished with that. Another couple of days and I'll probably have that finished, I just need to go through some organization first.

So what am I changing in starting new? Let's go into one of my standard bullet lists:


  • (Probably) Removing the SQL from my side of the coding by using Java Data Objects.
  • Creating classes for the different objects (like planets and ships) rather than tables per se.
  • Truly attempting to take advantage of the object-oriented nature of Java, a la Budd.
  • Avoiding so-called "Concurrency" issues
  • (Probably) Making the code easier on me to develop.
Java Data Objects, or JDO, are a method of storing entire Java Objects within a database. In my case, by creating a class for each in-game item, I can then store the classes in the database. This becomes useful in terms of the concurrency issues mentioned above. Concurrency in SQL is a problem where multiple users attempt to access the same data at the same time. When one person edits the data, the second person may well overwrite those changes even though the information they based it off of is no longer accurate. Generally this is handled by locking the row, so that only one person can access data at a time.

This is a major problem in my program because of the nature of the database I built, and how it would be accessed. The database is built with 'foreign keys,' or references to other tables, so that all of the data is interconnected. If one user is accessing all of the necessary data to run their empire, then a significant portion of the database is locked up while they're doing that work. Not a very user-friendly methodology. On the other hand, if the planets and ships and everything else are stored as independent objects, the user only accesses those that belong specifically to them and there aren't concerns about simultaneous edits.

I'm not too well-versed in the JDO things yet (I've just stumbled upon them today, really), so I'm not certain, but I do get the impression that using JDO means not needing to use SQL, and this simplifies my coding as well as removing the SQL altogether. Unfortunately, while I've found books that cover JDO, I can't find any at a library near me. I'm considering purchasing a copy somewhere off the web, but for now I'm going to try using the online documentation for it. Until I run into major issues, I'll probably stick with that.

My next couple of days are pretty slim in terms of time spent in-school, so hopefully I'll have a nice structure fleshed out and work started by... the weekend, at the latest? Wish me luck on that!

Tuesday 23 February 2010

The Platypus: Object-Oriented Programming Primer

So, about that material decoder. Maybe tomorrow? I didn't have time for much coding today, but I have done some reading. Platty Pat apparently has been given the name Phyl by the author, but I like Platty Pat better so I'm sticking with it.

So what is Object-Oriented programming, anyway? According to this book (I need to give credit where it's due, so the book in question is: "Understanding Object-Oriented Programming with Java" by Timothy Budd. ISBN: 0-321-21174-X for my particular version), it's all about creating code in sections, called objects, which are essentially independent. Each object has its own responsibilities and its own way of accomplishing the tasks set out for it. In principle, there should be only a couple of interconnections between objects, and objects should be reusable from project to project without major restructuring. The program should also be separated such that major feature changes (graphical updates or saving to a different format or what-have-you) should only take updating one or two of the objects, as the other objects don't rely on what's in the other things, but what comes out of them.

I've been reading a bit about the class-oriented nature of Java, which, as I've said in the past, is the biggest part of what the book is about, and the biggest thing about Java I feel I need to understand more clearly. It's the reason there's a platypus on the cover of the book, because if you extend the class structure to real life, the platypus 'extends' the 'class' mammal but 'overrides' some 'methods,' primarily birthing. Anyway, basically a convenient metaphor that sums up a lot of the features of class-oriented programming.

Right now they're going through the design process behind it all, and it certainly is a lot different than what I've done so far--a kind of disappointing fact considering most of the books I've studied have been based around Java, so it would have been nice if it had started with Object-Oriented facets of the language. That said, given my as-yet limited experience with programming, it shouldn't be hard to switch to their methodology, which definitely seems like it would help.

It's interesting stuff and it's something I'm definitely going to take into consideration. Especially on account of the conversation I had today with a friend about my plans for the Simulation. He feels it'd be better for both sides if the administrator was cut out, to save time and all. I'm still intent on allowing complete customization though, which can't be done without the administrator. If I properly program this, I should be able to pretty easily try both. So I guess that's one of my new goals for the project. Keep in mind that one of my favorite things about PC games, and the reason I prefer them to console games a lot of times, is the fact that they can be modified. Mods can extend the life of a game quite astonishingly, and the customization is a key selling point to me. That's probably why I'm so set on making the simulation with the administrator-figure.

Also I managed to stumble upon Google Code, a resource for developers. Apparently a ton of Google's stuff is available for use by independent coders like myself. I might have a go at it sometime, but for now it's conveniently filed away that if I ever have a project that could take advantage of it, it's there to be used.

Sunday 21 February 2010

Kicking a Dead Horse

My ISA calculator is done. I've left out the US Standard Atmosphere calculations from it, simply because if I were to add it now I'd take the cheap way out of simply converting the input to metric, then the original outputs back into US units. This would be a little bit inefficient and a bit inaccurate, as the different standards are bound to use different conversions than I would. If I ever want to add in that function, then I'll do it proper.

That said, I did change most of the other things I found to be lacking:


  • Now takes advantage of normalized units, which means the window can be resized (relatively) without problems. Resizing it will allow the table to be viewed without a horizontal scrollbar, and in many situations without a vertical one either.
  • No longer recalculates if the values entered at the time of giving it the calculation command are the same as the last values used.
  • Fixed a small bug in which if the user clicked the same plot button they were already on, they'd receive a dialog stating "Unknown Plot Type Error." Turns out, the error was simply that none of the plots were selected. If that situation comes up now, it simply returns out of the statement, leaving the last-selected plot in view.
  • Pressing enter in a text input box now calculates as necessary.
MATLAB itself has some shortfalls which prevented proper fixes for the recalculation bug and the axis tick mark problem. The first problem is that it's not easy (I'd like to say not possible but that almost always is proven wrong) to have more than one "axes" object in the same GUI. I wanted, originally, to have one set of axes for each plot, and simply hide/show the different axes as requested. Unfortunately, as MATLAB denies me this option, every time the user selects a different plot type, MATLAB has to go through and re-position all of the data points on the set of axes. While it doesn't need to calculate all of the values again, the plotting itself definitely appears to take longer than the calculations, as there's no noticeable decrease in time between inserting fresh values and just switching the displayed plot with the same values.

The second problem was axis tickmarks. The problem here is that the tickmarks have to be manually declared as exact values. While it's not incredibly hard to calculate a vector of values rounded to the nearest thousand or something, the requirements are so contextual to make it a mostly useless bit of extra programming. What happens when the user only wants to see the range of heights from 0 to 25m? From 1276 to 8452 meters? From 0 to 100 meters, in 520 increments? I think you see my point. MATLAB's automatic tickmark decisions are vaguely useful enough to allow them to be the only ones.

So, that said, my work is done.You can find, look over, criticize, and hopefully provide feedback on the source code at this link. I'd expect to hear things along the lines of "it's horribly inefficient," "I'm amazed this works at all," and "YOU SUCK!" so feel free to be brutal, as long as there's some sort of suggestion for improvement alongside it.

Expect to hear progress on my Java simulation tomorrow! Probably a working, if preliminary, version of my material decoder at the least.

Project Introduction: Java Simulation Game

While I'm doing some fine-tuning on the MATLAB project before posting the code, I figure now's a good time to introduce the other main project I'm working on. This one's a bit more complex and will probably be in production for ages (an unfortunate side-effect to lack of deadlines).

The simulation game I know and love doesn't really have much in terms of graphics. It's much more a thought-based, economy/diplomacy/strategy simulation, with rules governing interactions, extraction and deployment of resources, and the like. If you have an imagination, it's a real fun game to play because literally anything is possible--you have an administrator or two running it and keeping it balanced, but otherwise if you can think it, it can be done. My version, and all the ones I've played, are sci-fi, galactic empire style games. You rule planets, not cities, basically.

In the versions of these games that I've played, the major downfalls were (discounting admin inactivity and small player base):


  • Problems with cheat-detection. All of these I've played so far were excel-based (or worse, simply forum-based), meaning if a player modified the excel file it becomes tough to notice it.
  • Reliance on other players. As all interaction requires a response from someone else, things went slow. For diplomacy and trade, this isn't a problem. But what happens when your fleet is at another player's planet, waiting for the other player to respond to continue the battle, and another enemy comes to your planet knowing you've got no defenses?
  • Lack of 'realism.' Mostly in the fact that the player controls EVERYTHING in the past games I've played, which makes playing tougher. Sure, it's nice having absolute say over everything, but it isn't necessary and adds a lot of work.
Therefore I've set out to create my own version of the simulation-style game:

  • Programmed in Java, with no access to source code, to prevent cheating but allow essentially any computer to run it.
  • More administrator decision-making. A player entering a battle will get to dictate what the general strategy is, what the main targets are, under what circumstances the forces are to retreat, large-scale strategic things like how much of the fleet actually enters the battle to begin with and what remains as mid-fight reinforcements. The defending player then gets told what he knows of the situation (the ships currently in the fray, essentially), and issues main targets and defense objectives. The generals do the micromanaging, and the end result is a battle decision created in a short time through the administrators.
  • The concept behind my game in practice is that the leader does leader things. The economy is essentially entirely controlled by the player, but research is done more true-to-life. If a player wants to develop a new fighter craft, they don't tell the admin what exactly goes into it and receive a yes/no answer as to whether it works. Instead, they put the offer out to companies, who create prototypes and bid on contracts, and it's up to the player to choose from a few different options given to them.
Now, some of you may be thinking "this really doesn't sound like fun." For many of you, that'd actually probably be true. This style of game is certainly not everyone's cup of tea. Do bear in mind it isn't simply number crunching. Every action has an outcome on the whole of the galaxy, based on other players' political responses and the NPCs. And a battle doesn't simply go: X ships vs Y ships, Y wins, no ships remaining for X, Y-n ships remaining for Y. It's the administrator's job to narrate, tell a story, and entertain.

Some other features I'll be including in the game concept are:

  • Realistic (pythagorean-theorem based) travel times via galactic map coordinates.
  • In-depth trading system. All planets will have some of a predetermined list of resources, and most will have their own unique (though questionably useful) resources. Probably will also include a materials market much like the stock market, based on quasi-realistic supply and demand.
  • Through the material system, potentially interesting design quirks, waiting to be discovered, in nearly everything. A leader may find a nasty surprise waiting for him when he suddenly discovers his troops are carrying extremely magnetic weaponry, and his enemy knew this before he did, disarming them by way of electromagnets (for a top-of-my-head example).
  • By definition, each race will have (aside from preset starting 'equipment') completely unique armies, infrastructures, and economies.
  • Dynamic game structure--because the game is coded by the eventual administrator, things can be changed. Want to play a socialist utopia? The economy for your race can be re-coded to be more befitting. For example.
  • Espionage that provides both real and incorrect data, and most often time-sensitive. You'll be more likely to find out an enemy fleet's location than its composition. Like the real-world, using acquired intelligence is a gamble that can have huge rewards.
My current status is pretty bleak. The MySQL database structure to go behind it is essentially complete. It's a complex mess of inter-related tables, but it covers essentially everything. The Java work I had done (which was almost nothing anyway) is lost to my last computer wipe, but I've started fresh and am currently at work coding a material property display. Each material has 11 properties, with a range of values from 0-25 (Z-A respectively). I'm working on a 'decoder' that displays the properties in one of those attribute 'star-charts.' The only example I can find easily is this. Imagine the colored section moving around to fill in the shape depending on how high each stat is. Mostly I'm making this for my purposes so I can try to visually see the balance between materials found on varying planets.


Saturday 20 February 2010

The Home Stretch, and then some: ISA Calculator Project Review [MATLAB]

Today was, as I've mentioned before, the deadline for my little MATLAB project. Let's review requirements:


  • Calculate the ISA values for pressure, temperature, density, and viscosity at a user-input height.
  • Create and display a table of values for heights 0 to 15000 meters, at 1000 meter increments.
  • Create and display a plot of temperature, pressure, and density versus height (on three plots).
My end result was 733 lines of code (we needed to print that out... 14 pages of code, it turns out). It provided the user with a GUI window which allowed for easy input of various values. It allowed the table to be calculated for any input range of heights, with any increment, and even allowed for the division of the range into a set number of pieces, which is probably a useless feature but it was interesting to see how little or how much the plots changed as there was an increase in available data points.

It was made such that whatever value was set up for the single height would still be there (and calculated) after looking at graphs and tables, and vice versa, but the tables did draw off of the same information as the graphs.

There were a couple of shortcomings I noticed:
  • It was not configured to allow the user to type in the values and simply hit enter. A push button had to be pressed.
  • The table was displayed with scroll bars, as it did not fit into the window I'd allotted.
  • The original design was done in units of pixels, therefore no window resizing. This means it looks nice, but is not very expandable. I was halfway through fixing this by using normalized units, when I remembered that deadlines and required features were more important.
  • Every time you switched between one of the three plots, it recalculated the entire vector of outputs. I'm sure there was a cleaner way to do it, but again, that was the final moment when I realised there was a deadline fast approaching.  It's inefficient, sure, but you don't notice it unless you set the number of increments ridiculously high.
  • The axes on the graphs were sparsely populated. I should've programmed them to have a certain number of points.
Overall, I'm pleased, but I'm seriously considering going back and correcting these shortcomings before I officially say I'm done with it. Call it obsessive-compulsive, it's just the way I am sometimes.

In a few days (probably when I've fixed at least some of those shortcomings), I think I'll post the code. I doubt there are too many people out there looking for an ISA Calculator programmed in MATLAB, but I do think there are people out there who could learn something from it, and more importantly, I think there are people out there who can point out some of the stupid mistakes I've made.

Next up, Java simulation work. I think. I'm also considering looking into making apps for my new Blackberry, if I can come up with something that'd be useful, playing with the new Java game development book I've received, making my own USB Controller - to - keyboard/mouse mapper (because the one I like to use I don't really have the money for at the moment so I might as well try that out), or any number of other ideas.

Friday 19 February 2010

Quantity versus Quality, Round 1 (FIGHT!)

You'd normally accomplish a lot more in a day than ten minutes, but apparently circumstances make the difference. Yesterday, I accomplished almost nothing. Today, leaps and bounds.

MATLAB still isn't done. I keep getting side-tracked by features that are nice but not necessary. I just finished putting in code to make all of my numbers print in reasonable ways rather than some ridiculous thing like "24.50000" or similar. That said, it is due tomorrow, and all I've got left to do is the relatively easy graphing part of it.

Ten minutes into my work today I tested something I hadn't before: I inspected the full contents of each of my vectors. Turns out they weren't vectors, but rather matrices. This creates a problem as the program couldn't just leave out a whole bunch of values, even if those values were zeros.

Brief walkthrough for those like me. A for loop like the one I posted yesterday will (when made correctly) add a new value to the variable on each pass. MATLAB warns you in advance that this could go slowly, unless you tell it beforehand how long the vector will wind up being. I went ahead and did that by putting in the zeros() function, which fills the vector (or matrix) in with zeros.

I was new to this though and put zeros(length(h)) in for each of these 'vectors.' This actually creates a square matrix, length(h) x length(h) in size. An easy fix, once the error of my ways was realized. By making it zeros(1,length(h)) I told MATLAB to make it 'matrix' with only one value in the vertical direction, or, more commonly, a vector. Then what I originally wanted to do for my table output worked fine, and my table was done.

Quality 1, Quantity 0

In other news, I picked up two new books today at the library. One is about developing games in Java. I keep claiming that's not my overall goal, but it does interest me and the book seems thorough, so I snagged it. The other is about Object-Oriented Programming with Java. While I consider myself pretty good with Java, I've yet to come to terms with what specifically I gain through the OOP aspect of the language. I think my MATLAB work has aided me with it a little, since the two are so close to each other, but hopefully this will help me take advantage of the feature more thoroughly.

On the cover of the latter book is a platypus (complete with fur, duck bill, and eggs) holding a balloon. My girlfriend has named him "Platty Pat" the platypus, and wanted me to share the fact. So, there, fact shared. Oh, and the little guy is holding the book, so a nice case of recursive art.

Wednesday 17 February 2010

Why God Invented Energy Drinks (and Brain Food)

Today was a pretty unproductive day. It's not for lack of trying. It started with a bit of (non-programming) group work, which was handed in way too late. Me being the manager, I stayed up late, got two hours of sleep, and went right back into finishing the job.

Programming on two hours of sleep is not easy. In fact, if you ever have the choice, don't do it unless you're looking for frustration. In my lack of experience on this matter, I was happily back to work on my ISA Calculator (MATLAB), programming the GUI to display a table of values for a user-input height range.

I kept getting a run-time error along the lines of "array indexes must be real, positive numbers." I finally narrowed it down to one particular snippet that was causing the error: length(a).

If you know a little about programming, you probably know that length() functions simply determine the length of whatever's inside the parentheses. Basically every language has it built-in. MATLAB specifically uses the length() function to tell you how many different values there are in an array. In other words, it can't go wrong. I even confirmed that a was defined, had a value and a size. Length(a) simply wouldn't work.

Well, after an hour of head-scratching, I gave up. Hours later (still no sleep), I went back to it and again could find no solution. I then went to irc.freenode.net #matlab and asked for help. They agreed. There was nothing wrong with the code, and the length() function can't cause that error in the situation I put it in. (Thanks to CrimsonScythe for going all-out to track down my stupid mistake!)

Well, turns out it can. I used the string variable called length to store the name of units of length (meters). It was declared very early in development, and very early in my program, and basically got hidden away. This was the first nested function I wrote in my calculator, coded inside the overall function so that it has access to all the variables in the main function easily, and therefore it was the first one that noticed this oversight on my part. I now feel bad for MATLAB as I'm clueless as to what it was trying to do with my little variable-gone-function. Rather than a square peg in a round hole, I think it was more like replacing a screw with super glue. It might pretend to work, but, really, when it comes down to it, it's going to fail, and in a pretty catastrophic way.

So, that out of the way, my loop worked! I'm done! Right? No. Because the loop worked, sure, but the outcome wasn't what I needed. Why not? Because, after 20 minutes of searching, I realised I had this in my code:

for q=1:length(t)
    mu = t(q) * (constants);
end

Assume the math was right, as (constants) here is a bit more complicated in my code. Anyone catch my mistake?

for q=1:length(t)
    mu(q) = t(q) * (constants);
end

That'd be the right answer. MATLAB was happily doing the same equation multiple times over with different numbers, but it was storing it all to the same place. In other words, where my other variables had 11 values, mu had only 1. Fun stuff. Also, note that this kind of error is the thing that any book or teacher will tell you is a common beginner's mistake. I am a beginner, I admit. But I promise you, this is a common mistake in general. Small detail, easy to miss.

So that's fixed. My table works! Right? No, of course not. I'm still not sure why not. The first column works fine. The first row works fine. But columns 2 through 8 in any row after row 1 are blank, with the values instead inserted into new columns after column 8. No real reason I can see. Go figure. My buddies on IRC have gone to their own tasks and so I'm left clueless. I'm going to bed. Maybe when I'm rested this will make sense again.

There's a tip I heard very early on in programming: no matter how short your program is, there's bound to be a bug. In fact, my first "Hello, world!" program in Java utterly failed on me, though the reason is lost to the failings of my memory. This is just one of those situations. For the past week my MATLAB work had no real problems, so this is just everything catching up to me.

Tomorrow should be the final day of development for this MATLAB project, at least in terms of the official requirements (I do have some smaller features I'm interested in adding to it after the fact). It should be... eventful, but we'll see.

Boredom and a Whim

What do you get when you cross an engineering student and a boring materials lecture? I suppose if you asked all of the 180-odd students in the lecture theater that day, you'd wind up with at least 50 answers (the most common one being 'Nap time.")

In my case, it was a trip to the library to pick up a "Java book," as it would come to be called. This was (according to my library record) about 2 or 3 months ago. Since then, I've become obsessed with programming (or so I'm told). I stormed through Java basics, swallowed up a decent bit of SQL, and due to an assignment just last week, have powered through MATLAB.

A friend of mine today warned me about mixing work and pleasure, jokingly of course. I've gone overboard on my latest assignment, and it's because I like what I'm doing.

Why aerospace engineering, people ask (and that's not a joke, in those two months, I've been asked this many times, carrying and reading my Java, and later SQL, books at any opportunity). I don't think I could actually do programming for a living. I like it as a hobby, as a challenge. That's what this blog is for: documenting "Charlie's Crazy Computer Coding Capers," hopefully giving and getting hints and tips, and maybe some programming challenges here and there. I'll do a brief summary of my current projects:

  • International Standard Atmosphere Calculator (MATLAB), for an assignment due in just a few days. I'm in the home stretch here.
  • Sci-fi 'Simulation-Style' Game (Java, SQL), for fun. This was the project that started it all, originally planned as an elaborate excel file and evolving from there. Most of the SQL is complete, Java is still thoroughly in development.

Specific details to come on these later. For now, I'm open to suggestions for projects to try, languages to learn, or whatever else.