first version of Charm FAQ in latex form
authorFilippo Gioachin <gioachin@illinois.edu>
Mon, 10 Dec 2007 22:47:08 +0000 (22:47 +0000)
committerFilippo Gioachin <gioachin@illinois.edu>
Mon, 10 Dec 2007 22:47:08 +0000 (22:47 +0000)
17 files changed:
doc/faq/Makefile [new file with mode: 0644]
doc/faq/arrays.tex [new file with mode: 0644]
doc/faq/charm.tex [new file with mode: 0644]
doc/faq/converse.tex [new file with mode: 0644]
doc/faq/debugging.tex [new file with mode: 0644]
doc/faq/general.tex [new file with mode: 0644]
doc/faq/groups.tex [new file with mode: 0644]
doc/faq/index.tex [new file with mode: 0644]
doc/faq/install.tex [new file with mode: 0644]
doc/faq/internals.tex [new file with mode: 0644]
doc/faq/manual.tex [new file with mode: 0644]
doc/faq/messages.tex [new file with mode: 0644]
doc/faq/nodegroups.tex [new file with mode: 0644]
doc/faq/other.tex [new file with mode: 0644]
doc/faq/overview.tex [new file with mode: 0644]
doc/faq/ports.tex [new file with mode: 0644]
doc/faq/title.html [new file with mode: 0644]

diff --git a/doc/faq/Makefile b/doc/faq/Makefile
new file mode 100644 (file)
index 0000000..eea9833
--- /dev/null
@@ -0,0 +1,11 @@
+# Stub makefile for LaTeX PPL manual
+FILE=manual
+TEX=$(FILE).tex overview.tex general.tex charm.tex arrays.tex groups.tex nodegroups.tex messages.tex \
+       other.tex install.tex debugging.tex ports.tex converse.tex internals.tex
+DEST=faq
+LATEX2HTML=$(L2H) -split 2
+
+include ../Makefile.common
+
+index.tex:
+       touch index.tex
diff --git a/doc/faq/arrays.tex b/doc/faq/arrays.tex
new file mode 100644 (file)
index 0000000..673a142
--- /dev/null
@@ -0,0 +1,2 @@
+\section{\charmpp{} Arrays}
+
diff --git a/doc/faq/charm.tex b/doc/faq/charm.tex
new file mode 100644 (file)
index 0000000..597b613
--- /dev/null
@@ -0,0 +1,2 @@
+\section{\charmpp{} Programming}
+
diff --git a/doc/faq/converse.tex b/doc/faq/converse.tex
new file mode 100644 (file)
index 0000000..5eeb47b
--- /dev/null
@@ -0,0 +1,2 @@
+\section{\converse{} Programming}
+
diff --git a/doc/faq/debugging.tex b/doc/faq/debugging.tex
new file mode 100644 (file)
index 0000000..23b1e08
--- /dev/null
@@ -0,0 +1,2 @@
+\section{Debugging}
+
diff --git a/doc/faq/general.tex b/doc/faq/general.tex
new file mode 100644 (file)
index 0000000..6692035
--- /dev/null
@@ -0,0 +1,2 @@
+\section{General \charmpp{} Questions}
+
diff --git a/doc/faq/groups.tex b/doc/faq/groups.tex
new file mode 100644 (file)
index 0000000..0e7b3d9
--- /dev/null
@@ -0,0 +1,2 @@
+\section{\charmpp{} Groups}
+
diff --git a/doc/faq/index.tex b/doc/faq/index.tex
new file mode 100644 (file)
index 0000000..e69de29
diff --git a/doc/faq/install.tex b/doc/faq/install.tex
new file mode 100644 (file)
index 0000000..eb3d21b
--- /dev/null
@@ -0,0 +1,2 @@
+\section{Installation and Usage}
+
diff --git a/doc/faq/internals.tex b/doc/faq/internals.tex
new file mode 100644 (file)
index 0000000..db636f7
--- /dev/null
@@ -0,0 +1,2 @@
+\section{\charmpp{} and \converse{} Internals}
+
diff --git a/doc/faq/manual.tex b/doc/faq/manual.tex
new file mode 100644 (file)
index 0000000..15acbf5
--- /dev/null
@@ -0,0 +1,32 @@
+\documentclass[10pt]{article}
+\usepackage{../pplmanual}
+\input{../pplmanual}
+\usepackage{html}
+
+\title{\charmpp{}\\Frequently Asked Questions}
+\version{5.9 (Release 1)}
+\credits{empty}
+
+\begin{document}
+
+\maketitle
+
+For answers to questions not on this list, please contact us at \htmladdnormallink{ppl@cs.uiuc.edu}{mailto:ppl@cs.uiuc.edu}
+
+\input{overview}
+\input{charm}
+  \input{general}
+  \input{arrays}
+  \input{groups}
+  \input{nodegroups}
+  \input{messages}
+\input{other}
+\input{install}
+\input{debugging}
+\input{ports}
+\input{converse}
+\input{internals}
+
+
+\end{document}
+
diff --git a/doc/faq/messages.tex b/doc/faq/messages.tex
new file mode 100644 (file)
index 0000000..c669988
--- /dev/null
@@ -0,0 +1,2 @@
+\section{\charmpp{} Messages}
+
diff --git a/doc/faq/nodegroups.tex b/doc/faq/nodegroups.tex
new file mode 100644 (file)
index 0000000..e20570a
--- /dev/null
@@ -0,0 +1,2 @@
+\section{\charmpp{} Nodegroups}
+
diff --git a/doc/faq/other.tex b/doc/faq/other.tex
new file mode 100644 (file)
index 0000000..9c9cc40
--- /dev/null
@@ -0,0 +1,2 @@
+\section{Other PPL Tools, Libraries and Applications}
+
diff --git a/doc/faq/overview.tex b/doc/faq/overview.tex
new file mode 100644 (file)
index 0000000..40fea19
--- /dev/null
@@ -0,0 +1,96 @@
+\section{Big Questions}
+
+\subsubsection{What is Charm++?}
+
+\htmladdnormallink{Charm++}{http://charm.cs.uiuc.edu/research/charm/} is
+a runtime library to let C++ objects communicate with each other efficiently.
+The programming model is thus very much like CORBA, Java RMI, or RPC; but
+it is targeted towards tightly coupled, high-performance parallel machines.
+It uses the "single program, multiple data" (SPMD) programming model made
+popular by MPI.
+
+Charm++ has demonstrated scalability up to thousands of processors,
+and provides extremely advanced load balancing and object migration facilities.
+
+\subsubsection{Can Charm++ parallelize my serial program automatically?}
+
+No.
+
+Charm++ is used to write "explicitly parallel" programs--we don't have
+our own compiler, so we don't do automatic parallelization. We've found
+automatic parallelization useful only for a small range of very regular
+numerical applications.
+
+However, you should { \em not} have to throw away your serial code;
+normally only a small fraction of a large program needs to be changed to
+enable parallel execution. In particular, Charm++'s support for object-oriented
+programming and high-level abstractions such as Charm++ Arrays make it
+simpler and more expressive than many other parallel languages. So you
+will have to write some new code, but not as much as you might think. This
+is particularly true when using one of the Charm++ \htmladdnormallink{frameworks}{http://charm.cs.uiuc.edu/research/}.
+
+\subsubsection{I can already write parallel applications in MPI. Why should I use Charm++?}
+
+Charm++ provides several extremely sophisticated features, such as
+application-independent object migration, that are very difficult to provide
+in MPI. If you have a working MPI code but have scalability problems
+because of dynamic behavior, load imbalance, or communication costs, Charm++
+might dramatically improve your performance. You can even run your
+MPI code on Charm++ unchanged using \htmladdnormallink{AMPI}{http://charm.cs.uiuc.edu/research/ampi/}.
+
+\subsubsection{Will Charm++ run on my machine?}
+
+Yes.
+
+Charm++ supports both shared-memory and distributed-memory machines,
+SMPs and non-SMPs. In particular, we support serial machines, Windows
+machines, clusters connected via Ethernet or Myrinet, SGI Origin2000, IBM
+SP3, Cray T3E, Intel Paragon, ASCI Red, and any machine that supports MPI
+or SHMEM. We normally do our development on Linux workstations, and
+our testing on large parallel machines. Programs written using Charm++
+will run on any supported machine.
+
+No one has ported Charm++ to a vector supercomputer, but it should be
+possible.
+
+\subsubsection{Does anybody actually use Charm++?}
+
+Yes.
+
+The large, production-quality molecular dynamics application \htmladdnormallink{NAMD}{http://charm.cs.uiuc.edu/research/moldyn/}
+is built on Charm++.\\
+The \htmladdnormallink{Center for Simulation of Advanced Rockets}{http://www.csar.uiuc.edu/}
+has a large physical simulation code built using Charm++.\\
+We have significant collaborations with groups in Materials Science,
+Chemistry, and Astrophysics in Illinios, New York, and Washington.
+
+\subsubsection{Who created Charm++?}
+
+Prof. \htmladdnormallink{L.V. Kale}{mailto:kale@cs.uiuc.edu}, of the
+\htmladdnormallink{Computer Science Department}{http://www.cs.uiuc.edu/}
+of the \htmladdnormallink{University of Illinois at Urbana-Champaign}{http://www.uiuc.edu/},
+and his research group, the \htmladdnormallink{Parallel Programming Lab}{http://charm.cs.uiuc.edu/">Parallel}.
+ Nearly a hundred people have contributed something
+to the project over the course of aproximately 15 years; a partial list
+of contributors appears in the introduction to each manual.
+
+\subsubsection{What is the future of Charm++?}
+
+Our research group of approximately twenty people are actively engaged
+in maintaining and extending Charm++; and in particular the Charm++ 
+\htmladdnormallink{frameworks}{http://charm.cs.uiuc.edu/research/}.
+Several other groups are dependent on Charm++, so we expect to continue
+improving Charm++ indefinitely.
+
+\subsubsection{How is Charm++ Licensed?}
+
+Charm++ is open-source and free for research, educational, and academic
+use. The University of Illinois retains the copyright to the software,
+and requires a license for any commercial redistribution of our software.
+The actual, legal license is included with Charm++ (in charm/LICENSE).
+
+\subsubsection{I have a suggestion/feature request/bug report. Who should I send
+it to?}
+
+Our mailing list is \htmladdnormallink{ppl@cs.uiuc.edu}{mailto:ppl@cs.uiuc.edu}.
+We're always glad to get feedback on our software.
diff --git a/doc/faq/ports.tex b/doc/faq/ports.tex
new file mode 100644 (file)
index 0000000..2c20608
--- /dev/null
@@ -0,0 +1,2 @@
+\section{Versions and Ports}
+
diff --git a/doc/faq/title.html b/doc/faq/title.html
new file mode 100644 (file)
index 0000000..d76baa4
--- /dev/null
@@ -0,0 +1 @@
+C<SMALL>HARM++</SMALL> Frequently Asked Questions