![](\"https://www.nsf.gov/awardsearch/images/common/nsf_logo_bottom.png\"){kind=logo}
| This work sponsored by NSF grants OAC 1550551 and CCF 1539567 | |
| This work sponsored by NSF grants OAC 1550551 and CCF 1539567 | |
| This work sponsored by NSF grants OAC 1550551 and CCF 1539567 | |
![](\"http://simfactory.org/global/images/factory.png\")
"
91 | ]
92 | },
93 | {
94 | "cell_type": "markdown",
95 | "metadata": {},
96 | "source": [
97 | "# Simfactory\n",
98 | "Cactus is normally built with a tool called Simfactory. Simfactory, in turn, will call make.\n",
99 | "Before it can work, however, it needs to be configured. Please replace... my email address in the\n",
100 | "command below with yours. The email address isn't sent anywhere, all it's used for is allowing\n",
101 | "Cactus to send job change state notifications to you."
102 | ]
103 | },
104 | {
105 | "cell_type": "code",
106 | "execution_count": null,
107 | "metadata": {},
108 | "outputs": [],
109 | "source": [
110 | "%cd ~/CactusFW2\n",
111 | "!./simfactory/bin/sim setup-silent --setup-email=sbrandt@cct.lsu.edu "
112 | ]
113 | },
114 | {
115 | "cell_type": "markdown",
116 | "metadata": {},
117 | "source": [
118 | "At long last, we are ready to actually build Cactus. Cactus can often figure out what compilers and build\n",
119 | "options to use automatically, but in some cases it is necessary to specify it by hand (you can do this by adding --optionlist=centos.cfg to the build command below). The file containing\n",
120 | "this information is called the Option List. You might want to take a look at it."
121 | ]
122 | },
123 | {
124 | "cell_type": "markdown",
125 | "metadata": {},
126 | "source": [
127 | "This is the command to build Cactus using our thornlist. As written, it will build in parallel using two processes. That's what the -j option does."
128 | ]
129 | },
130 | {
131 | "cell_type": "code",
132 | "execution_count": null,
133 | "metadata": {},
134 | "outputs": [],
135 | "source": [
136 | "#!rm -fr configs"
137 | ]
138 | },
139 | {
140 | "cell_type": "code",
141 | "execution_count": null,
142 | "metadata": {},
143 | "outputs": [],
144 | "source": [
145 | "!time ./simfactory/bin/sim build --mdbkey make 'make -j2' --thornlist=./repos/cajunwave/funwave_carpet.th | cat -"
146 | ]
147 | },
148 | {
149 | "cell_type": "markdown",
150 | "metadata": {},
151 | "source": [
152 | "The build command creates a configuration called \"sim\". It is found in the \"configs/sim\" directory. One of the files in this directory is the ThornList. It contains the list of thorns Cactus will compile. If you wish to add or remove a thorn from your configuration, you can do it by editing this file. However, by doing so you risk confusing yourself by forgetting what you've done. Proceed at your own risk!"
153 | ]
154 | },
155 | {
156 | "cell_type": "code",
157 | "execution_count": null,
158 | "metadata": {},
159 | "outputs": [],
160 | "source": [
161 | "%ls ~/CactusFW2/configs/sim"
162 | ]
163 | },
164 | {
165 | "cell_type": "code",
166 | "execution_count": null,
167 | "metadata": {},
168 | "outputs": [],
169 | "source": [
170 | "%pycat ~/CactusFW2/configs/sim/ThornList"
171 | ]
172 | },
173 | {
174 | "cell_type": "markdown",
175 | "metadata": {},
176 | "source": [
177 | "The \"OptionList\" file contains all the configuration options (the things you saw in centos.cfg). Unlike the ThornList file, however, changing this file will have no effect. If you wish to change your configuration options without starting over from scratch, you should edit the file \"configs/sim/config-data/make.config.defn.\""
178 | ]
179 | },
180 | {
181 | "cell_type": "code",
182 | "execution_count": null,
183 | "metadata": {},
184 | "outputs": [],
185 | "source": [
186 | "%pycat ~/CactusFW2/configs/sim/config-data/make.config.defn"
187 | ]
188 | },
189 | {
190 | "cell_type": "markdown",
191 | "metadata": {},
192 | "source": [
193 | "| This work sponsored by NSF grants OAC 1550551 and CCF 1539567 | |