{"id":3357,"date":"2026-09-20T00:33:07","date_gmt":"2026-09-19T15:33:07","guid":{"rendered":"https:\/\/www.frontistr.com\/?page_id=3357&#038;lang=ja"},"modified":"2026-09-20T00:33:07","modified_gmt":"2026-09-19T15:33:07","slug":"getting-started","status":"publish","type":"page","link":"https:\/\/www.frontistr.com\/en\/getting-started\/","title":{"rendered":"<i>Getting Started<\/i>"},"content":{"rendered":"<div class=\"getting-started\" lang=\"en\" dir=\"ltr\">\n<section class=\"section gs-intro\">\n  <div class=\"inner gs-pair\">\n    <div class=\"section-title\">\n      <p class=\"gs-eyebrow\">FrontISTR \/ Getting Started<\/p>\n      <h1 class=\"title\">Getting Started<\/h1>\n      <p class=\"description\">Run a hinge analysis with FrontISTR, then explore the stress distribution in ParaView. Download the solver and a ready-made example: no meshing is needed for this first run.<\/p>\n      <p class=\"button\"><a href=\"#gs-install\">Follow the steps<\/a><\/p>\n    <\/div>\n    <figure>\n      <img decoding=\"async\" src=\"https:\/\/www.frontistr.com\/wp-content\/themes\/frontistr-2022\/images-page\/hinge.png\" alt=\"Von Mises stress distribution in a hinge, with stress concentrations around the holes.\" width=\"1200\" height=\"800\" fetchpriority=\"high\">\n      <figcaption>Run a linear static analysis of a hinge. Your goal is to display a colour contour plot of NodalMISES, the nodal von Mises stress.<\/figcaption>\n    <\/figure>\n  <\/div>\n<\/section>\n<section id=\"gs-install\" class=\"section gs-step\">\n  <div class=\"inner\">\n    <div class=\"section-title\"><p class=\"gs-eyebrow\">01<\/p><h2 class=\"title\">Get FrontISTR<\/h2><\/div>\n    <div class=\"gs-platforms\" data-gs-choice=\"method\">\n      <div>\n        <h3>Windows (64-bit)<\/h3>\n        <p class=\"button button-border\"><a href=\"https:\/\/frontistr-commons.gitlab.io\/FrontISTR\/release\/x86_64-w64-mingw32\/FrontISTR-latest.thread_openblas.zip\">Download for Windows<\/a><\/p>\n        <p>Extract the ZIP. After preparing the example in the next step, copy fistr1.exe and all its accompanying DLLs into the example folder (01_elastic_hinge).<\/p>\n      <\/div>\n      <div>\n        <h3>Docker (Windows \/ macOS \/ Linux)<\/h3>\n        <p>Start Docker, then run this command in a terminal. On Windows, use Docker in Linux container mode and run the command in PowerShell.<\/p>\n        <pre dir=\"ltr\"><code>docker pull --platform linux\/amd64 registry.gitlab.com\/frontistr-commons\/frontistr\/fistr1:master<\/code><\/pre>\n        <p class=\"gs-note\">The current official image is built for amd64. On Apple Silicon Macs it runs under emulation and may take longer.<\/p>\n        <ul class=\"gs-links\">\n          <li><a href=\"https:\/\/docs.docker.com\/get-started\/get-docker\/\" target=\"_blank\" rel=\"noopener\">Set up Docker<\/a><\/li>\n        <\/ul>\n      <\/div>\n      <div>\n      <h3>Build from source<\/h3>\n      <p>You can also build FrontISTR from source on any of these operating systems. Once compilers and the required libraries are installed, CMake detects your environment and configures the build.<\/p>\n      <p>Install the basic tools using the commands for your distribution below. Use your existing development environment without adding MPI or other optional libraries.<\/p>\n      <h3>Ubuntu \/ Debian<\/h3>\n      <pre dir=\"ltr\"><code>sudo apt-get update\nsudo apt-get install build-essential cmake git gfortran<\/code><\/pre>\n      <h3>RHEL \/ Rocky Linux \/ AlmaLinux<\/h3>\n      <pre dir=\"ltr\"><code>sudo dnf install gcc gcc-c++ gcc-gfortran make cmake git<\/code><\/pre>\n      <p>The following commands build and install on macOS and Linux. Executables go into bin under your home directory, so installation needs neither sudo nor PATH changes. See the build guide for macOS\/Windows setup and optional libraries.<\/p>\n      <pre dir=\"ltr\"><code>git clone https:\/\/gitlab.com\/FrontISTR-Commons\/FrontISTR.git\ncd FrontISTR\ncmake -S . -B build -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=\"$HOME\"\ncmake --build build --parallel\ncmake --install build<\/code><\/pre>\n      <p>Run the bundled example without downloading it again. Run the commands below, then continue to step 04 to view the result in ParaView.<\/p>\n      <pre dir=\"ltr\"><code>cd tutorial\/01_elastic_hinge\n\"$HOME\/bin\/fistr1\"<\/code><\/pre>\n      <p><a href=\"https:\/\/docs.frontistr.com\/en\/build_guide\/\">Build from source<\/a><\/p>\n      <\/div>\n    <\/div>\n    <p class=\"gs-note\">The binaries and container use the continuously updated master \/ LATEST versions. See the download page for tagged releases and other environments. <a href=\"https:\/\/www.frontistr.com\/en\/download\/\">Other versions and environments<\/a><\/p>\n  <\/div>\n<\/section>\n<section class=\"section gs-step\">\n  <div class=\"inner gs-pair\">\n    <div class=\"section-title\">\n      <p class=\"gs-eyebrow\">02<\/p><h2 class=\"title\">Download the example<\/h2>\n      <p>Download and extract the example ZIP. Use the three input files in the 01_elastic_hinge folder.<\/p>\n      <p class=\"button button-border\"><a href=\"https:\/\/www.frontistr.com\/sys\/files\/01_elastic_hinge.zip\">Download example (ZIP)<\/a><\/p>\n      <p class=\"gs-note\">Run the analysis in the extracted 01_elastic_hinge folder. The macOS\/Linux extraction command uses unzip.<\/p>\n    <\/div>\n    <div class=\"gs-files\">\n      <p><code>01_elastic_hinge\/<\/code><\/p>\n      <dl>\n        <dt><code>hecmw_ctrl.dat<\/code><\/dt><dd>Input and output file locations<\/dd>\n        <dt><code>hinge.cnt<\/code><\/dt><dd>Materials, loads, restraints and analysis settings<\/dd>\n        <dt><code>hinge.msh<\/code><\/dt><dd>The hinge mesh<\/dd>\n      <\/dl>\n    <\/div>\n  <\/div>\n  <div class=\"inner\">\n    <p>To use the command line, run the entire block below from the location where you want to keep the example. It downloads and extracts the archive, then enters the example folder. Continue with the analysis command in the same terminal.<\/p>\n    <div class=\"gs-platforms\" data-gs-choice=\"shell\">\n      <div><h3>Windows \/ PowerShell<\/h3><pre dir=\"ltr\"><code>curl.exe -fL -o 01_elastic_hinge.zip https:\/\/www.frontistr.com\/sys\/files\/01_elastic_hinge.zip\nif ($LASTEXITCODE -eq 0) {\n  Expand-Archive -Path 01_elastic_hinge.zip -DestinationPath . -ErrorAction Stop\n  cd 01_elastic_hinge\n}<\/code><\/pre><\/div>\n      <div><h3>macOS \/ Linux<\/h3><pre dir=\"ltr\"><code>curl -fL -o 01_elastic_hinge.zip https:\/\/www.frontistr.com\/sys\/files\/01_elastic_hinge.zip &amp;&amp;\nunzip 01_elastic_hinge.zip &amp;&amp;\ncd 01_elastic_hinge<\/code><\/pre><\/div>\n    <\/div>\n  <\/div>\n<\/section>\n<section class=\"section gs-step\">\n  <div class=\"inner\">\n    <div class=\"section-title\"><p class=\"gs-eyebrow\">03<\/p><h2 class=\"title\">Run from the example folder<\/h2><\/div>\n    <div class=\"gs-platforms\" data-gs-choice=\"method\">\n            <div>\n        <h3>Windows binary<\/h3>\n        <p>Run the analysis in the example folder, 01_elastic_hinge. Check that hecmw_ctrl.dat is in that folder.<\/p>\n                <p>Double-click fistr1.exe in the example folder. Keep its accompanying DLLs in the same folder. If the window closes when the run ends, open the results written to the example folder in ParaView.<\/p>\n        <details class=\"gs-help\"><summary>To inspect the log<\/summary><p>If the window closes immediately without producing results, or you want to inspect the log, open PowerShell in the example folder and run:<\/p><pre dir=\"ltr\"><code>.\\fistr1.exe<\/code><\/pre><\/details>\n                <div class=\"gs-complete\"><p>When running in a terminal, this message at the end of the log confirms that the analysis has finished. Run time depends on your PC.<\/p><pre dir=\"ltr\"><code>FrontISTR Completed !!<\/code><\/pre><\/div>\n        <details class=\"gs-help\"><summary>If something goes wrong<\/summary><p>If input files cannot be found, check that you are running from the 01_elastic_hinge folder. On Windows, check that fistr1.exe and all its accompanying DLLs have been copied into that same folder.<\/p><\/details>\n      <\/div>\n            <div>\n        <h3>Docker (Windows \/ macOS \/ Linux)<\/h3>\n        <p>Run the analysis in the example folder, 01_elastic_hinge. Check that hecmw_ctrl.dat is in that folder.<\/p>\n                <pre dir=\"ltr\"><code>docker run --rm --platform linux\/amd64 -v \"${PWD}:\/work\" -w \/work registry.gitlab.com\/frontistr-commons\/frontistr\/fistr1:master fistr1<\/code><\/pre>\n        <p class=\"gs-note\">Open a terminal (PowerShell on Windows) in the example folder and run the command. It mounts that folder at \/work in the container. Results are saved in your local example folder.<\/p>\n                <div class=\"gs-complete\"><p>When running in a terminal, this message at the end of the log confirms that the analysis has finished. Run time depends on your PC.<\/p><pre dir=\"ltr\"><code>FrontISTR Completed !!<\/code><\/pre><\/div>\n        <details class=\"gs-help\"><summary>If something goes wrong<\/summary><p>If input files cannot be found, check that you are running from the 01_elastic_hinge folder. On Windows, check that fistr1.exe and all its accompanying DLLs have been copied into that same folder.<\/p><\/details>\n      <\/div>\n            <div>\n        <h3>Build from source<\/h3>\n        <p>Run the analysis in the example folder, 01_elastic_hinge. Check that hecmw_ctrl.dat is in that folder.<\/p>\n                <pre dir=\"ltr\"><code>\"$HOME\/bin\/fistr1\"<\/code><\/pre>\n                <div class=\"gs-complete\"><p>When running in a terminal, this message at the end of the log confirms that the analysis has finished. Run time depends on your PC.<\/p><pre dir=\"ltr\"><code>FrontISTR Completed !!<\/code><\/pre><\/div>\n        <details class=\"gs-help\"><summary>If something goes wrong<\/summary><p>If input files cannot be found, check that you are running from the 01_elastic_hinge folder. On Windows, check that fistr1.exe and all its accompanying DLLs have been copied into that same folder.<\/p><\/details>\n      <\/div>\n          <\/div>\n  <\/div>\n<\/section>\n<section class=\"section gs-step\">\n  <div class=\"inner\">\n    <div class=\"section-title\"><p class=\"gs-eyebrow\">04<\/p><h2 class=\"title\">Open the result in ParaView<\/h2><p>Install ParaView. Choose File \u2192 Open and select this file in the example folder.<\/p><\/div>\n    <pre dir=\"ltr\"><code>hinge_vis_psf.0001.pvtu<\/code><\/pre>\n    <p class=\"gs-note\">Results are written to the same 01_elastic_hinge folder. Keep the neighbouring hinge_vis_psf.0001 folder: do not move the .pvtu file on its own. 0000 is the initial state; 0001 is the loaded result.<\/p>\n    <p class=\"button button-border\"><a href=\"https:\/\/www.paraview.org\/download\/\" target=\"_blank\" rel=\"noopener\">Download ParaView<\/a><\/p>\n    <p class=\"gs-note\">Screenshots: ParaView 6.1.0 on macOS. The basic steps are the same on Windows and Linux.<\/p>\n    <ol class=\"gs-visual-steps\">\n            <li class=\"gs-pair\">\n        <div><p class=\"gs-eyebrow\">04 \/ 1<\/p><p>Just after opening the file. Click Apply on the left.<\/p><\/div>\n        <a class=\"gs-screenshot\" href=\"https:\/\/www.frontistr.com\/wp-content\/themes\/frontistr-2022\/images-page\/paraview-open.png\" target=\"_blank\" rel=\"noopener\"><img decoding=\"async\" src=\"https:\/\/www.frontistr.com\/wp-content\/themes\/frontistr-2022\/images-page\/paraview-open.png\" alt=\"Just after opening the file. Click Apply on the left.\" width=\"3162\" height=\"2122\" loading=\"lazy\"><\/a>\n      <\/li>\n            <li class=\"gs-pair\">\n        <div><p class=\"gs-eyebrow\">04 \/ 2<\/p><p>The hinge geometry appears after you click Apply.<\/p><\/div>\n        <a class=\"gs-screenshot\" href=\"https:\/\/www.frontistr.com\/wp-content\/themes\/frontistr-2022\/images-page\/paraview-apply.png\" target=\"_blank\" rel=\"noopener\"><img decoding=\"async\" src=\"https:\/\/www.frontistr.com\/wp-content\/themes\/frontistr-2022\/images-page\/paraview-apply.png\" alt=\"The hinge geometry appears after you click Apply.\" width=\"3162\" height=\"2122\" loading=\"lazy\"><\/a>\n      <\/li>\n            <li class=\"gs-pair\">\n        <div><p class=\"gs-eyebrow\">04 \/ 3<\/p><p>Change Solid Color in the top toolbar to NodalMISES to display the von Mises stress distribution.<\/p><\/div>\n        <a class=\"gs-screenshot\" href=\"https:\/\/www.frontistr.com\/wp-content\/themes\/frontistr-2022\/images-page\/paraview-mises.png\" target=\"_blank\" rel=\"noopener\"><img decoding=\"async\" src=\"https:\/\/www.frontistr.com\/wp-content\/themes\/frontistr-2022\/images-page\/paraview-mises.png\" alt=\"Change Solid Color in the top toolbar to NodalMISES to display the von Mises stress distribution.\" width=\"3162\" height=\"2122\" loading=\"lazy\"><\/a>\n      <\/li>\n          <\/ol>\n    <p class=\"gs-note\">Colours and background depend on your ParaView settings; they do not need to match the illustration. If the model is out of view, try Reset Camera.<\/p>\n  <\/div>\n<\/section>\n<section class=\"section gs-outro\"><div class=\"inner section-title\">\n  <h2 class=\"title\">Your first analysis is complete<\/h2><p>Next, explore the loads and material settings in the example. The manual explains this model and introduces other analysis types.<\/p>\n  <ul class=\"gs-links\"><li><a href=\"https:\/\/docs.frontistr.com\/en\/examples\/tutorial_01.html\">Read about this example<\/a><\/li><li><a href=\"https:\/\/docs.frontistr.com\/en\/introduction\/workflow_guide.html\">Choose a GUI or modelling workflow<\/a><\/li><\/ul>\n<\/div><\/section>\n<\/div>\n\n","protected":false},"excerpt":{"rendered":"Run your first structural analysis with FrontISTR. Download the solver and example, run the analysis, and view the stress distribution in ParaView.","protected":false},"author":1,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_acf_changed":false,"inline_featured_image":false,"_locale":"en_US","_original_post":"https:\/\/www.frontistr.com\/?page_id=3355&lang=ja","footnotes":""},"class_list":["post-3357","page","type-page","status-publish","hentry","en-US"],"acf":[],"_links":{"self":[{"href":"https:\/\/www.frontistr.com\/wp-json\/wp\/v2\/pages\/3357","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.frontistr.com\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/www.frontistr.com\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/www.frontistr.com\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.frontistr.com\/wp-json\/wp\/v2\/comments?post=3357"}],"version-history":[{"count":1,"href":"https:\/\/www.frontistr.com\/wp-json\/wp\/v2\/pages\/3357\/revisions"}],"predecessor-version":[{"id":3358,"href":"https:\/\/www.frontistr.com\/wp-json\/wp\/v2\/pages\/3357\/revisions\/3358"}],"wp:attachment":[{"href":"https:\/\/www.frontistr.com\/wp-json\/wp\/v2\/media?parent=3357"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}