Entry source is now prog.c for IOCCC years 2014 thru 2020, or is now dirname.c IOCCC years 1984 thru 2013. To achieve this state, we renamed the following: renamed: 2004/hibachi/src/hibachi.c -> 2004/hibachi/hibachi.c renamed: 2012/omoikane/nyaruko.alt.c -> 2012/omoikane/omoikane.alt.c renamed: 2012/omoikane/nyaruko.alt2.c -> 2012/omoikane/omoikane.alt2.c renamed: 2012/omoikane/nyaruko.c -> 2012/omoikane/omoikane.c renamed: 2012/omoikane/nyaruko.orig.c -> 2012/omoikane/omoikane.orig.c Modified `bin/subst.entry-index.sh` to add to entry `index.html` file, links to the `Makefile` and the _C code_ to the top navigation bar. Changed `bin/subst.entry-index.sh` VERSION from "1.2.2 2024-02-25" to "1.3 2024-03-02". Moved printing the Inventory link in the top navigation bar from `bin/subst.entry-navbar.awk` to `bin/subst.entry-index.sh`. Changed `bin/subst.entry-navbar.awk` VERSION from "1.0.1 2024-02-23" to "1.1 2024-03-02". Moved printing the Inventory link in the top navigation bar from `bin/subst.year-navbar.awk` to `bin/subst.year-index.sh`. Changed `bin/subst.year-index.sh` VERSION from "1.0 2024-02-11" to "1.1 2024-03-02". Changed `bin/subst.year-navbar.awk` VERSION from "1.0 2024-02-11" to "1.1 2024-03-02". Added location names (both default and common) to `author.html`. Changed `tmp/gen_author_json.sh` VERSION from "1.0 2023-06-06" to "1.1 2024-03-04". Added location names (both default and common) to `author.html`. Changed `bin/gen-authors.sh` VERSION from "1.2 2024-03-09" to "1.3 2024-03-04". The manifest and the resulting `.entry.json` files have been changed for `2004/hibachi` and `2012/omoikane`. The Makefiles for `2004/hibachi` and `2012/omoikane` copy the source file into the "previously used location". The `make clobber` rule removes the copied source. The `.gitignore` files have been updated accordingly. Improved how the concept of IOCCC terms _entry_, _author_ and _submission_ are used in markdown files. Links to markdown files (files ending in .md) within the repo were changed to link to HTML files (files ending in .html). Special cases where `README.md` became `index.html` were modified accordingly. Fixed URL for `bugs.html` in Makefile comments. Fixed name of `bin/sgi.sh` referenced in comments in `.gitignore` files. Links to locations within the repo are now relative. For example a link to `/contact.html` may become `../contact.html' or '../../contact.html` depending on the directory level of the markdown file. Nearly all links with absolute URLs under _https://www.ioccc.org_ or `https://ioccc-src.github.io/temp-test-ioccc_ have been changed to relative paths within the repo. Some exceptions to this (such as referring to a GitHub repo) were preserved. Fixed a number of inside `faq.md` and `bugs.md`. Added HTML name tags (in the form of an _entry_id_) for each entry referenced in `bugs.md`. Fixed links from outside of `bugs.html` into `bugs.html` accordingly. Where FAQ entries are referenced, a named tag is used so that if a FAQ is ever renumbered, links outside of `faq.html` will still work. Changed the _inventory_order_ of a compressed tarball from _300_ to _100000_. While this may have been done for the manifest, this changed had not yet been propagated into the `.entry.json` files. Links to web sites that were in the for <URL> are now [URL](URL). Performed `name www` to process all of the above. Improved format of `authors.html`. Full names are now bold. Location codes are now links back into `location.html` and location names (both default and common) are now italics. Added _author_handle_ each author. Changed `bin/gen-authors.sh` VERSION from "1.1 2024-02-25" to "1.2 2024-03-09". Improved format of `location.html` as location codes are now bold, author counts in a given location are now bold, and location names (both default and common) are now italics. Changed `bin/gen-location.sh` VERSION from "1.0.1 2024-02-23" to "1.1 2024-03-04". Added italic location name after location code in entry `index.html` files. Changed `bin/output-index-author.sh` VERSION from "1.4.1 2024-02-23" to "1.5 2024-03-04". Added _Location of authors_ to the sidebar as a link to `location.html`. TODO: While nearly all of the above mentioned changes are likely correct, they likely introduced a few errors that need correcting.
To build:
make
Bugs and (Mis)features:
The current status of this entry is:
STATUS: missing or dead link - please provide them
STATUS: INABIAF - please **DO NOT** fix
For more detailed information see 2011 dlowe bugs.
To use:
./dlowe -<n_iterations> corpus1/ [...] corpus0/ < start.net > trained.net
NOTE: In the above command, the directory args MUST end in a /.
Then to use trained.net:
./dlowe file [file ...] < trained.net
Try:
Try these pre-trained networks:
./try.sh
NOTE: The dlowe-aux-data/ directory, which try.sh refers to, was
created by:
tar -jxf dlowe-aux-data.tar.bz2
Judges' remarks:
This entry is a ghoulish example of a brain (dead?) neural network classifier. It comes with a set of corpora for you to try.
ioccc-winlose-trained.net
You can create your own trained networks. For example, we trained a network on the C code of entries that were supplied to the 20Th IOCCC.
The ioccc-winlose-trained.net was trained using the
earlystop.pl tool:
rm -f ioccc-winlose-trained.net
./earlystop.pl ioccc-winlose-trained.net ioccc_won_training/ ioccc_lost_training/ ioccc_won_test/ ioccc_lost_test/
where:
-
ioccc_won_training/1/2 of C code of the 20th IOCCC entries (except for dlowe.c from 2011) plus 1/2 of the C code winning entries from prior IOCCC contests -
ioccc_won_test/1/2 of C code of the 20th IOCCC entries (except for dlowe.c from 2011) plus 1/2 of the C code winning entries from prior IOCCC contests -
ioccc_lost_training/1/2 of C code from entries that that did not win -
ioccc_lost_test/1/2 of C code from entries that that did not win
NOTE: The above directories were not shipped and everything from the entries
that did not win were flushed to /dev/null.
The earlystop.pl tool wrote:
training 1 to 1001...
training 1001 to 2001...
prior error = 56.746974766043; current error = 58.095691135305
The resulting ioccc-winlose-trained.net file was included in the
dlowe-aux-data.tar.bz2 tarball.
The dlowe.c was explicitly excluded from this trailing set, so this test is interesting:
./dlowe dlowe.c < dlowe-aux-data/ioccc-winlose-trained.net
NOTE: this is done in try.sh.
The match of dlowe.c to the lose/win trailed network was:
dlowe.c 0.125108
NOTE: The non-artificially intelligent decisions of the IOCCC judges include random quirks and their non-linear judgment calls not found in the ioccc trained network. Just because C code is or isn't scored highly by this network does not mean it will win or lose a future IOCCC. On the other hand ... it just might!
other data sets to try
While we cannot supply you with the losing IOCCC source code, the author did supply a number data sets on which to test:
We created the english-trained.net as follows:
./dlowe -8000 dlowe-aux-data/english-1/ dlowe-aux-data/english-0/ < /dev/null > dlowe-aux-data/english-trained.net
-
dlowe-aux-data/english-0/ Non-English (French) text
-
dlowe-aux-data/english-1/ English (non-French) text
We created the png-trained.net as follows:
./dlowe -8000 png-1/ png-0/ < /dev/null > dlowe-aux-data/png-trained.net
-
dlowe-aux-data/png-0/ Non-png (gif) images
-
dlowe-aux-data/png-1/ png (non-gif) images
We created the xor-trained.net as follows:
./dlowe -8000 dlowe-aux-data/xor-1/ dlowe-aux-data/xor-0/ < /dev/null > dlowe-aux-data/xor-trained.net
-
dlowe-aux-data/xor-0 Data that XORs to 0
-
dlowe-aux-data/xor-1/ Data that XORs to 1
NOTE: The directory args must end in a / for them to work.
Author's remarks:
Synopsis
This is an artificially intelligent judging tool to help the IOCCC judges. Here's to shorter, more frequent contests!
Description
This is a multilayer perceptron (a feedforward artificial neural network) which can be trained, using on-line backpropagation, to classify input files.
It has a fixed topology of 2^16 input neurons, 6 hidden neurons and 1 output
neuron.
The neurons' activation function is the logistic function 1 / (1 + e ^ -x).
Classifying
./dlowe file [file ...] < trained.net
To classify files, one specifies a trained network (on stdin) and one or more
files to classify. The program will output one line per successfully-classified
file to stderr, with the filename and the classification: a number between 0
and 1.
The interpretation of the classification number depends on how the network was trained, but it's geared toward interpretation as a probability or a confidence.
Training
./dlowe -<n_iterations> corpus1/ [...] corpus0/ < start.net > end.net
NOTE: The directory args must end in a / for them to work.
To train a network, one specifies a starting network (on stdin), two or more
corpora (directories containing training data), and the number of training
iterations to run. The program will write some progress data to stderr and,
when it's done, will serialize the updated network to stdout.
If no input network is given, a random new network will be generated as a
starting point (i.e. provide an empty stdin).
The first corpus will be assigned a target value of 1. The last will be
assigned a target value of 0. Intervening directories (if any) will be assigned
intermediate target values.
The learning rate is hard-coded as 0.3. No momentum factor is used.
png corpora
The png-1 corpus was obtained by manually scraping the first results from an https://images.google.com search for "obfuscate filetype:png".
The png-0 corpus was obtained by manually scraping the first results from an https://images.google.com search for "obfuscate filetype:gif".
Results:
- Using these corpora as a training set;
- Using several hundred random
*.gifand*.pngfiles from my home computer as a test set; - Using the included earlystop.pl script, which stopped after 67000 iterations.
- Interpreting output of
> 0.5as "probably a.png" and< 0.5as "probably a.gif"
produced a network with about 87% accuracy
English corpora
The english-1 corpus was obtained by manually scraping the first results from a https://www.google.com/webhp?lr=lang_en search for "paris filetype:txt".
The english-0 corpus was obtained by manually scraping the first results from a https://www.google.com/webhp?lr=lang_fr search for "paris filetype:txt".
Results:
- Using these corpora as a training set;
- Using several dozen additional text files (obtained by the same methods) as a test set;
- Using the included earlystop.pl script, which stopped after 10000 iterations;
- Interpreting output of
> 0.5as "probably English" and< 0.5as "probably French"
produced a network with 100% accuracy.
xor corpora
The xor-1 corpus consists of two files containing 01
and 10 respectively.
The xor-0 corpus consists of two files containing 00
and 11 respectively.
Results:
Using these corpora as a training set takes about 8000 iterations to learn xor
to within a tolerance of <0.01.
Limitations
The program can't tell you anything meaningful about files with less than two bytes in them (I'm looking at you, smr.c!)
You must include the trailing directory separator on training directories (this allows the program to be portable without wasting precious bytes on figuring out how to concatenate directory and file names...).
Serialized network files are only portable between systems with the same floating-point representation and endianness.
Making sure not to overfit the network to the training data is a bit of a black art. I have enclosed earlystop.pl, a wrapper script that implements a simple 'early stopping' algorithm; other techniques are possible.
Bad input (e.g. nonexistent files, non-numeric number of iterations, etc.) tends to result in empty output.
Given exactly one corpus, the program will crash or produce garbage.
Leaks memory and file descriptors while processing files.
Will crash and die horribly if it runs out of memory.
The Microsoft C compiler doesn't provide a dirent API, so to get this working
on a Windows system you'll need cygwin+gcc (tested) or a dirent compatibility
library (untested, but they do exist).
Backpropagation doesn't always converge: if you play with this long enough, you'll eventually have a training session that completely fails to converge.
Obfuscation
- Zombies! (Since neural networks are modeled after BRAINS, ya know? And corpus sounds a lot like corpse. And I have 4- and 7-year-old kids ;) )
- Neural networks are interesting, and while the math isn't terribly difficult, their behavior is difficult to fully understand.
- Had some extra space in one of the major data structures, and it seemed a shame to waste it.
- Similarly, I think three file pointers ought to be enough for anyone.
- Lots of magic numbers expressed in various ways.
- Random abuse of random C trivia.
- Some textual changes were made to maximize the classification of this program by a network trained to recognize IOCCC entries ;)
... but mostly zombies!
Copyright and CC BY-SA 4.0 License:
This file is Copyright (c) 2023 by Landon Curt Noll. All Rights Reserved. You are free to share and adapt this file under the terms of this license:
Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0)
For more information, see: https://creativecommons.org/licenses/by-sa/4.0/