NOTE: HOW to interpret these examples
In this repository, you may likely see custom datasetiterators - these iterators are only for special examples and 1 off use cases. Consult the gitter if you are not sure how to proceed. Once you find a record reader for your use case, you then should use one of pre made iterators that knows how to interpret record reader output, either RecordReaderDataSetIterator for normal data or SequenceRecordReaderDataSetIterator for sequence data. For more on sequences, please see our rnns page
We have special iterators for 1 off use cases where normal data does not quite exist, or sometimes it is legacy. 99% of the time you should be using datavec and writing your own custom record readers if one of our pre provided ones is not suitable. If you are not sure what is available, please again consult the gitter - In general, you can find both normal record readers and sequence record readers in the datavec javadoc.
Note that this repository contains all dl4j examples for all modules. It will download about 1.5g of dependencies from maven central when you are first starting out. That being said, this makes it easier to get started without worrying about what to download. This examples repository is meant to be a reference point to get started with most common use cases. It is broken up in to modules. If you would like to just have a more minimal/simple, guide please go here
Repository of Deeplearning4J neural net examples:
- MLP Neural Nets
- Convolutional Neural Nets
- Recurrent Neural Nets
- Word2Vec & GloVe
- Anomaly Detection
- User interface examples.
DL4J-Examples is released under an Apache 2.0 license. By contributing code to this repository, you agree to make your contribution available under an Apache 2.0 license.
Build and Run
Use Maven to build the examples.
mvn clean package
This downloads binaries for all platforms, but we can also append
windows-x86_64 to get binaries for only one platform and produce much smaller archives.
runexamples.sh script to run the examples (requires bash). It will list the examples and prompt you for the one to run. Pass the
--all argument to run all of them. (Other options are shown with
./runexamples.sh [-h | --help]
GradientsListenerExample.java in dl4j-examples/src/main/java/org/deeplearning4j/examples/userInterface uses JavaFX. If you're using Java 8 or greater, it should run as is. If you're using Java 7 or an earlier version, you should set JAVAFX_HOME to point to the root directory of the JavaFX 2.0 SDK.
Known issues with JavaFX
If you are running on JDK 1.7 or inferior, the maven-enforcer plugin will require you to set the variable
JAVAFX_HOME before building. That variable should point to a directory containing
jfxrt.jar, a file that is part of the JavaFX 2.0 distrbution.
Please set it to an instance of JavaFX that matches the JDK with which you are trying to use this project. Usually, the Sun JDK comes with JavaFX. However, OpenJDK does not and you may have to install OpenJFX, a free distribution of JavaFX.
Beware that your editor (e.g. IntelliJ) may not be using the JDK that is your system default (and that you may ancounter on the command line).
To run the JavaFX examples from IntelliJ, you'll have to add the
jfxrt.jar as an exernal dependency of your project. Here's a screencast on how to do it: https://youtu.be/si146q7WkSY
If you are using OpenJDK, on Ubuntu 16, you can install OpenJFX with
sudo apt-get install libopenjfx-java. A typical
JAVAFX_HOME is then
/usr/share/java/openjfx/jre/lib/ext/. If you are on Ubuntu 14, you can install OpenJFX with the following process:
/etc/apt/sources.list.d/openjdk-r-ppa-trusty.listand uncomment the line for deb-src
sudo apt-get update
sudo apt-get install libicu-dev
sudo aptitude build-dep libopenjfx-java
sudo apt-get --compile source libopenjfx-java
ls -1 *.deb|xargs sudo dpkg -i
On JDK 1.8
The Sun version of JDK8 still comes with its own JavaFX, so that there should be no need to configure anything particular there and the build will succeed. If using OpenJDK8, you will still have to install OpenJFX and set
JAVAFX_HOME, but the maven-enforcer plugin will not catch you — the reason being that it's difficult to distinguish between OpenJDK and Sun's JDK since version 8, with both adoptiong the same Vendor ID.
If you are using OpenJDK 8, install OpenJFX and set JAVAFX_HOME as indicated above. Compile with
mvn clean install -POpenJFX
If you notice issues, please log them, and if you want to contribute, submit a pull request. Input is welcome here.