Starting Up & Plotting

Here, let's download RINEARN Graph 3D, start it up, and try plotting a graph!

There are several different methods depending on your environment and preferred usage (either in GUI or via command line). Please choose the method that suits you best and give it a try.

Please note: If the steps on this page fail due to errors or other issues, please also refer to the troubleshooting information page.
- Table of Contents -

Step 1: Download RINEARN Graph 3D

First, let's download RINEARN Graph 3D! You can download it for free anytime from the official website or by clicking the button below:

When you click the button above, you will be asked whether you want to save a ZIP file with the following name. Please save it to somewhere in your PC:

rinearn_graph_3d_?_?_?.zip
(The "?" represents the version number, and ".zip" may not be displayed depending on your environment.)

Please note that directly opening the ZIP file without saving it first may allow you to see its contents, but proceeding without properly extracting it can lead to errors later on. It's important to save the file to your PC first, and then follow the steps to properly extract (unzip) it before using the application.

Step 2: Extract (Unzip) the Downloaded ZIP File

A ZIP file is a compressed archive that contains multiple files and folders packed into a single file. While you can double-click to view its contents, this is merely for "temporary inspection." Before using the app properly, you need to extract (unzip) its contents. Using the contents of the ZIP file without extracting them can lead to various errors and issues.

So, let's proceed to extract the ZIP file "rinearn_graph_3d_?_?_?.zip" that we downloaded and saved earlier!

However, this step, seemingly simple, has a few pitfalls. Depending on your environment, the procedure differs, so please read the instructions below based on your operating system: For Windows Users | For Linux and Other OS Users |

For Microsoft® Windows® Users

If you are using Windows, please follow these steps to ensure proper extraction of the downloaded ZIP file.

First, right-click on the ZIP file that you downloaded and saved earlier, and open "Properties."

Then, in the security section at the bottom of the properties window, check the box that says "Allow" and click "OK."

Please note: Failure to perform this step on a ZIP file downloaded from the internet can result in extraction and execution of the app being blocked. Of course, do not easily unblock security for ZIP files from unknown or untrusted sources.

Next, right-click on the ZIP file again and select the option "Extract All ..." from the menu.

Once the extraction is successful, a regular folder with the following name will be created:

rinearn_graph_3d_?_?_?
(The "?" represents the version number)

This folder contains everything composing RINEARN Graph 3D, so please copy and place it somewhere convenient for use. The original ZIP file is no longer needed.

For Linux and Other OS Users

In Linux and other operating systems, you can typically extract (unzip) the file "rinearn_graph_3d_?_?_?.zip" by right-clicking on it and selecting the appropriate option from the menu. If the extraction process completes without any issues, then you're all set.

However, depending on the environment, the names of the files within the extracted folder might appear garbled. If that happens, try extracting the file using the 'unzip' command from a command-line terminal as follows:

cd <location of the ZIP file>
unzip -O cp932 rinearn_graph_3d_?_?_?.zip
(Replace "?" with the version number)

If this doesn't resolve the issue, you may consider using a different extraction tool or attempting to repair the garbled filenames after extraction using commands like 'convmv.'

Step 3: Launch by Double-Clicking (Windows Only)

Now, let's finally start up RINEARN Graph 3D!

While you can start RINEARN Graph 3D via command line, let's begin by launching it with a double-click like a regular application.

Please note: This method of launching is currently only available on Windows. If you are using Linux or another OS, please proceed to the section on command-line startup.

Double-Click the Launcher File

First, open the folder "rinearn_graph_3d_?_?_?" resulting from unzipping the ZIP file earlier. Inside, you should find a file named:

RinearnGraph3D_?_?_?.bat
(The "?" represents the version number, and ".bat" may not be displayed depending on your environment.)

This is the file used for launching, so please double-click it with your mouse. RINEARN Graph 3D will then start up.

[First-Time Launch Only] Environment Setup Proceeds Semi-Automatically

The first time you start RINEARN Graph 3D after downloading, a black screen with white text will appear, indicating the progress of environment setup (preparing the necessary environment for the application to run).

You may be prompted for input at certain points, but unless there are specific reasons not to, you can generally complete this process by pressing the Enter key (YES).

Please note: This environment setup occurs within the "rinearn_graph_3d_???" folder and does not involve installation elsewhere or changes to your PC settings. Feel free to proceed with confidence. Once the environment setup is completed, you can carry the folder on a USB drive, for example, and use it on another PC.

The Window of RINEARN Graph 3D Launches

After completing the environment setup, RINEARN Graph 3D will start and its window will launch as shown below. From the second launch onwards, the environment setup will be skipped, and the application will start immediately.

Typically, you interact with this window's interface using your mouse, opening data files and plotting graphs. This is actually covered in the "Opening Data Files and Plotting Graphs" section later, so if you primarily use this app by mouse, not a command-line, please proceed there.

Step 4: (If Necessary) Setting Up for Command Line Use

RINEARN Graph 3D can also be launched and utilized from the command terminal. Especially for users of operating systems other than Windows, this method is the primary way of launching. Even for Windows users, having the option to use it via command can be convenient in some situations.

Please proceed to the setting instructions applicable to your environment: For Windows Users | For Linux and Other OS Users |

Note: if you do not intend to use the command line, feel free to skip this section and move on to the next step.

For Windows Users

First, Place in a Fixed Location

If you are using Windows, first place the "rinearn_graph_3d_?_?_?" folder, which contains RINEARN Graph 3D, in a fixed location. For the sake of simplicity in explanation (though it's a bit informal), let's assume you placed it in the following location:

C drive > "RINEARN" folder > "rinearn_graph_3d_?_?_?" folder
(The "?" represents the version number)

Prepare the Absolute Path of the "bin" Folder

Inside the "rinearn_graph_3d_?_?_?" folder mentioned above, there's a folder named "bin." The location of this folder can be represented in text using an absolute path. You'll need this value shortly.

C:\RINEARN\rinearn_graph_3d_?_?_?\bin
(The "?" represents the version number)
Note, you can easily copy this absolute path by holding down the Shift key, right-clicking the "bin" folder, and selecting "Copy as path." This method is less error-prone and convenient compared to typing it manually.

Register in the Environment Variable "Path"

Next, register the above absolute path in the Windows environment variable "Path (or PATH)." If you're familiar with command-line work, you may not need detailed instructions on how to do this. However, if you're new to this or unfamiliar, please refer to the following article for guidance:

The above article provides a detailed explanation of the steps necessary for using the commands, including setting the path.

Launch with the "ring3d" Command

Once you've completed the path registration setup, launch a command input terminal such as Command Prompt or PowerShell, and try entering the following:

ring3d

This will launch the RINEARN Graph 3D window. Not only can you simply start it up, but various command-line options are available as well. For details, either run "ring3d --help" or refer to the article mentioned above.

For Linux and Other OS Users

First, Place in a Fixed Location

For Linux and other operating systems, please start by placing the "rinearn_graph_3d_?_?_?" folder, which contains RINEARN Graph 3D, in a fixed location. A typical example would be:

/usr/local/bin/rinearn/rinearn_graph_3d_?_?_?/
(The "?" represents the version number)

Grant Execution Permission

Next, go to the "bin" directory within this location using the cd command, and execute the following command:

chmod +x ring3d
(This grants execution permission to the launcher shell script)

Register in the Environment Variable PATH

Finally, register the absolute path of the "bin" directory, where this file is located, in the environment variable "PATH." The registration setting differs depending on the OS and shell, so please search the web for "how to set PATH [Your OS Name]" to find the method that fits your environment.

For instance, on Ubuntu or similar Linux systems using a bash-compatible shell, open the ".bashrc" (a hidden file), ".bash_profile", or ".profile" file (which one is active varies case by case) located in the user's home directory with a text editor and append the following line to the end:

export PATH="$PATH:/usr/local/bin/rinearn/rinearn_graph_3d_?_?_?/bin/"
(Replace "?" with the version number)
Note, enclosing the right side in double quotes (") is safer if your shell/environment guarantees it, but if it's better not to enclose them in your environment/shell, then leave them out.

Launch with the "ring3d" Command

Once the PATH setup is completed, after re-logging in, running the following command will launch RINEARN Graph 3D (if an error occurs due to a missing environment, it will be mentioned shortly after):

ring3d

Not only does this launch the application, but various command-line options are also available. For more details, either run "ring3d --help" or refer to the following article:

Install Java™ Environment if You Encounter an Error Due to Its Absence

When executing the above command, if you encounter errors indicating the absence of the environment for running Java programs, you'll need to install the environment separately. The most reliable way is to install the OpenJDK, an open-source development environment for Java. The following "Eclipse Temurin", a destributuion of OpenJDK, can be installed relatively easily:

Alternatively, if you can obtain just the Java runtime environment via apt or similar package managers, you can run this app with that. However, please note that it won't work if you install the headless version (without a GUI environment).

Also, for optimal performance and compatibility, it's recommended to install the latest LTS (or later) version of Java, as RINEARN Graph 3D is compatible with it.

Step 5: Opening a Data File and Plotting It on a Graph

Congratulations! You've completed all the preparations to use RINEARN Graph 3D. Great job getting here!

Now, let's try using it for real. We'll open a sample data file and plot it on a 3D graph.

Note: If you don't have any data files on hand, several sample files are included in the "Sample" > "SampleDataFile" folder within the downloaded package.

First, launch RINEARN Graph 3D, then from the menu bar, select "File" > "Open File" and choose the file you want to plot.

Once you select a file with the "OPEN" button, it will be added to the text area above the button. After adding all the files you want to plot, press the "PLOT" button to plot them on the graph.

Note: If you want to plot data directly from a spreadsheet software, rather than opening a file, select and copy the data in the spreadsheet, then right-click on the graph screen, and perform "Paste Data".

The following image shows an example of plotting a single file. By default, points are plotted at the positions of each coordinate contained in the file. The color of these points varies in gradient according to the Z-values of the coordinates (as explained later, you can also disable this and use a single color).

If you check "Line Plot" in the "Option" menu from the menu bar, each point will be connected with lines, as shown in the image below.

If the data is compatible with mesh format (see the "Data File Formats" page for details), selecting "Option" > "Membrane Plot" (*) draws a membrane (surface) by connecting each four neighboring coordinates as a quadrangle, as depicted on the right side of the image below. The Sample folder mentioned earlier also includes sample files for surface plotting.

*: "Membrane Plot" is a specific feature for plotting surfaces in RINEARN Graph 3D.
Furthermore, enabling "Option" > "Tessellation" will densely interpolate the coordinates composing the surface, resulting in a smooth surface as shown in the image below. If the interpolated surface extends beyond the original plotting range and gets clipped, adjust the range via "Edit" > "Set Range."

When plotting multiple files, as depicted on the left side of the image below, the data from all files will be plotted together. The data from each file is internally distinguished as different series, allowing for color-coding. Unchecking "Gradient (Z Value)" in "Option" menu will result in color-coding as shown on the right side of the image below.

Moreover, if a single file contains multiple series of data (refer to the "Data File Formats" page), disabling the gradient will also result in color-coding by series.

Note: If the Graph Screen Appears Jagged...

When drawing graphs with RINEARN Graph 3D, depending on your environment, you may notice that the edges of text and lines on the graph displayed within the window appear jagged and rough (Example: see below image).

Image at 125%

This can occur when your PC is set to display content enlarged on the screen. On Windows, you can check or adjust the scale setting (zoom level) by right-clicking on the desktop and selecting "Display Settings."

Note: This phenomenon is not due to any issues with the OS's functionality itself but may arise due to various reasons including software factors.

If the display scale is set to anything other than 100%, text and line boundaries may appear rough as shown above. The image quality when set to 100% scale is as shown below (this is the original quality).

Image at 100%

However, the degradation in image quality only affects the appearance on the window and has no impact on the quality when saving the graph image to a file or copying it via right-click (the quality remains the same as at 100% scale). Therefore, unless the appearance is so bothersome that it hampers your work, there's no need to force your display scale to 100%.

*1: Oracle and Java are registered trademarks of Oracle and/or its affiliates.
*2: Microsoft Windows is either a registered trademarks or trademarks of Microsoft Corporation in the United States and/or other countries.
*3: Linux is a trademark of linus torvalds in the United States and/or other countries.
* Other names may be either a registered trademarks or trademarks of their respective owners.