Frequently Asked Questions about Statalist
| Title |
|
The Statalist FAQ
statalist@hsphsun2.harvard.edu |
| Author |
Nicholas J. Cox |
| Date |
October 1999; updated November 2012 |
0. Introduction
Statalist is an email-based discussion group for users of StataCorp's Stata
statistical program. It is not moderated. The list is closely followed by
the list maintainer.
Statalist was started in August 1994.
0.1 What is Statalist for?
The appropriate subjects for discussion on Statalist are
Postings on anything to do with Stata are welcome, such as
- how to do something in Stata
- difficulties in using and understanding Stata
- apparent bugs or limitations in Stata
- areas for future additions to or improvements to Stata
- neat tricks in Stata that others may appreciate
- new Stata ado-files
- announcements of Stata-related meetings or material.
Once a statistical topic is mentioned, comments on the statistical or
scientific merits and demerits of different approaches are legitimate.
Statalisters want to use Stata to do good statistical science, and many
members value Statalist for the broader material it includes.
0.2 How does a list work?
(This is for anyone new to lists like Statalist.)
Listservers send and receive email. When anyone sends email
to a listserver like Statalist, it is forwarded to all the subscribers of the list. Later,
if someone feels moved to respond, that person sends email to the
listserver, and that, too, is forwarded to all subscribers. Thus the
process of using a list is
- You subscribe to the list by sending email to a special
address; it's free.
- Thereafter, you receive the email forwarded by the list.
- You optionally participate by sending email to the list,
which is then forwarded to the other subscribers.
- You optionally unsubscribe from the list.
Some people join lists and just watch—that’s called lurking in
netspeak, and, despite the negative connotation of the word, there is nothing
wrong doing that. You can learn a lot by lurking.
Once posted, your contribution is archived indefinitely. There is no deleting.
0.3 How does Statalist work?
Statalist is one of several lists managed by the majordomo list processor
running on the Harvard School of Public Health’s hsphsun2 computer.
Majordomo handles requests for subscribing and unsubscribing from email
lists. Some requests, like subscribe, unsubscribe, who, or help, are sent
to majordomo not to Statalist. In reply, you will get an
email message with the information and action that you want.
Questions that should be sent to all readers of Statalist
are sent to statalist not majordomo.
In either case, you must communicate in plain text.
See also 2.2 below.
There are two lists under the general label of Statalist: statalist and
statalist-digest. The former forwards all posted messages, and the latter
only a digest version at the end of the day. You may prefer the digest if
you wish to receive fewer messages. It is easier to skim one long
digest message than to skip through several individual messages (currently
averaging about 40 each day).
The software considers statalist and statalist-digest separate lists, so
when you unsubscribe, make sure it is from the correct list.
0.4 Who is responsible for Statalist?
Statalist is maintained by Marcello Pagano, Harvard School of Public Health.
pagano@hsph.harvard.edu
The Statalist FAQ (this document) is maintained by Nicholas J. Cox, Durham
University. n.j.cox@durham.ac.uk
StataCorp does not run Statalist, but StataCorp staff monitor Statalist
constantly and contribute frequently.
None of these people or organizations is responsible for the content of
Statalist postings, which are all informal public communications, or for the
consequences of acting upon them.
Statalist is not moderated. Thus we rely upon the good sense and the good
manners of Statalist members to maintain the aims of the list.
1. Before you post
Before posting, consider other ways of finding information:
- the online help for Stata:
search can tell
you about all built-in Stata commands, all ado-files published in the Stata
Technical Bulletin or the Stata Journal, and all FAQs on the
Stata website, www.stata.com.
findit can tell
you about not only all of the above, but also about user-written Stata
programs available on the Internet.
From Stata 11 on, a PDF version of the manuals is included with each copy
of Stata so that all users have access to the manuals.
- your local Stata expert or technical support person
- past issues of the Stata Technical Bulletin or the Stata
Journal
- the authors of user-written ado-files (who usually have email
addresses but are not always members of Statalist)
- Stata technical
support, if it is really a question for them
Before you post to Statalist, please read sections 2,
3, and
4 of this
FAQ. Doing so will only take a few minutes but is likely to save you
embarrassment and frustration. The main aim of these sections is to provide
precise advice on what does and does not maximize your chances of
quickly getting answers that are clear, correct, and complete.
If you do not get an answer to your question, please read
section 5. If
you feel tempted to post private mail to people active on Statalist, please
read section 6.
2. How to use Statalist: mechanics
2.1 I want to join Statalist. What do I do?
- Send an email to
majordomo@hsphsun2.harvard.edu.
- The message body should contain
subscribe statalist your@email.address
Replace your@email.address with your actual address.
Note: If you
want to get the digest version of Statalist, change statalist to
statalist-digest.
-
You are asked to post on Statalist using your full real name. This is a
long-standing practice on Statalist. Giving full names is one of the ways in
which we show respect for others. Your chances of eliciting a good reply are
greatly diminished if you write and conceal your identity. Conversely, if
you decide just to watch and read on the list, your email identity remains
entirely up to you.
2.2 How do I send questions to Statalist?
Only subscribers may post to the list, so you must subscribe before posting;
see above.
In addition, note that your posting will succeed only if you are mailing
from the same account that you used to subscribe to the list.
If you wish to subscribe with one address (to either Statalist or
Statalist-digest) and to post from another, please email Marcello Pagano at
pagano@hsph.harvard.edu with
your alternative address(es).
To send a posting to Statalist that goes out to all users,
- Address email to
statalist@hsphsun2.harvard.edu.
- Please make the subject line informative. The list software
will add “st:” to your subject line. Try to keep titles of
messages to the 52 letters of the English alphabet (a–z
A–Z). Some mailers around the world object to some characters,
even underscores!
- Put whatever you wish in the body of the message.
- We ask you not to post formatted messages or attachments. In fact,
Statalist software should trap formatted messages or attachments
without sending an error message to you.
-
Please make sure your
mailer is set to send ASCII or “plain text” for outgoing messages, or the
equivalent for your mailer. That is, do not send HTML, rich text,
VCards, winmail.dat files, or anything other than
Plain Text.
It is your responsibility to find out how to do this in your mailer or
email provider. You will not receive error messages if you
send a message that is trapped by Statalist.
(Advice on various commonly used systems can be found at
http://email.about.com/cs/netiquettetips/qt/et070103.htm.)
- Please do not include attachments, even ASCII or text files such as Stata programs,
.do files or logs. Many members have mailers that
cannot handle them. In any case, attachments can spread viruses and
clog up mailers with unwanted large files.
- Majordomo sometimes misreads posts and in particular can chop the first
line. One known problem arises if the first line of your post starts
with “From”; thus that should be avoided. If your post is rendered
unintelligible by such beheading, feel free to revise and repost,
possibly with a new first line you do not mind sacrificing.
Note: if you get the statalist-digest version of Statalist, you should still
post your questions to statalist@hsphsun2.harvard.edu.
If you are replying to a posting, your mailer will typically produce a
sensible message title automatically (e.g., by prefixing the previous title
with “Re:”).
However, if you are replying to a daily digest, put your reply
in a new posting, taking care to use the same title as the specific posting
you are replying to. Replying to the digest itself (even if you edit out all
irrelevant content and change the title) causes
archiving software to receive irrelevant information about what you are
replying to.
In addition, please do not start a new thread by replying to a previous
posting. Again even if you delete the previous posting’s contents and
change its title, such practice messes up archiving.
Because posts are not moderated, a post should normally be sent to everyone on
Statalist within a few minutes of your submitting it. If you do not receive a
copy of your post or—especially in the case of digest subscribers—do not
see it appear in the archives, then it is likely that your post was rejected
for reasons described earlier in this section.
2.3 I want to stop getting Statalist messages. What do I
do?
- Send email to
majordomo@hsphsun2.harvard.edu
- The message body should contain
unsubscribe statalist your@email.address
Replace your@email.address with your actual address.
Note: if you
get the digest version of Statalist, change statalist to
statalist-digest.
- Please note that majordomo only lets you unsubscribe yourself. Thus
nobody else can unsubscribe you, with or without your knowing.
When you unsubscribe, you must email majordomo from the same email
address you used when you subscribed. Thus it is best to
unsubscribe before changing your address.
- Please be patient. It is possible to continue to receive messages for a
few hours after you unsubscribe.
See also 2.7 below.
2.4 I stopped getting Statalist messages. What
happened?
If there is a problem with your email server or your email address changes,
you might generate enough error messages that you are removed from the
subscriber list.
If this happens to you, resubscribe.
See also 2.7 below.
2.5 I want FEWER Statalist messages. What do I do?
There is a digest version of Statalist. In order to receive that, you need
to unsubscribe from Statalist and subscribe to Statalist-digest. Do the
following:
- Send email to
majordomo@hsphsun2.harvard.edu
- The message body should contain
unsubscribe statalist your@email.address
subscribe statalist-digest your@email.address
Replace your@email.address with your actual email address.
To receive even fewer messages, you also have the option of unsubscribing
from Statalist and scanning the archives from time to time.
2.6 I want MORE frequent Statalist messages. What
do I do?
In order to receive the regular version of Statalist, you need to
unsubscribe from Statalist-digest and subscribe to Statalist. Do the
following:
- Send email to
majordomo@hsphsun2.harvard.edu
- The message body should contain
unsubscribe statalist-digest your@email.address
subscribe statalist your@email.address
Replace your@email.address with your actual email address.
2.7 I may have missed some messages. Or, I want to look at past
messages. Where are the archives?
The archives can be found in two places:
-
http://www.stata.com/statalist/archive/
(site located in the United States)
This covers postings from June 2002, arranged by month. The entire
archives are searchable, and postings within each month may be viewed by
thread or by date.
-
http://www.hsph.harvard.edu/statalist (site located
in the United States)
This covers postings from January 2001, arranged by month. You can
search postings in each month sorted by date, author, or subject.
2.8 When you are out of the office
Some people use their mailer to send out-of-office messages to Statalist
when they travel. You are asked not to do that, because such messages are of
no interest or use to almost all readers. If you do send messages of that
kind to Statalist, you will usually be unsubscribed by the moderator. You
may naturally resubscribe when you return.
Similarly, you are asked not to set up your mailer to send such messages to
individual posters who send to Statalist.
One suggestion is to exclude sending
out-of-office replies to any messages that contain st: in the subject
line instead of filtering on the email address statalist@hsphsun2.harvard.edu.
This is, however, not absolutely guaranteed to exclude only Statalist
messages or even all Statalist messages.
The simplest solution of all is to unsubscribe when you go on vacation.
Address email to pagano@hsph.harvard.edu.
Statalist is maintained by Marcello Pagano. If you have private comments or
difficulty with the automatic subscription software, please contact him.
3. How to use Statalist: advice
As with all such lists, Statalist relies on the generosity and good manners
of its members to function well. The following guidelines arise from
reflection on what does—and what does not—ease understanding of
questions and production of answers.
You might also find various websites that discuss general issues in
getting help from technical lists instructive and even amusing. Mike Ash
discusses “Getting answers” at
http://www.mikeash.com/getting_answers.html, with key headings:
- Explain what doesn’t work
- Provide everything up-front
- Post your code
- Do your research beforehand
- Do your research during
- Do your research afterwards
- Don’t post the same question repeatedly
- Follow up after you get an answer
- Treat the list like people
- Always consider the answer
Eric Raymond and Rick Moen discuss “How to ask questions the smart way” at
http://www.catb.org/~esr/faqs/smart-questions.html. We don’t
endorse every detail in this statement, but we particularly underline that
scorn, sarcasm, and bad language are deprecated on Statalist, although irony
and more gentle wit have been observed on occasion. However, Raymond and
Moen capture much of the ethos and style that characterize
technically oriented lists such as ours.
As already mentioned, once you have posted something to Statalist, it
appears in the archives. Any less than gracious postings will remain visible
to embarrass or handicap the sender forever, so don't send them in the first
place.
3.2 Write clear questions
- Many questions do not get answered because they are too short,
too unfocused, or too obscure. If you hope others will spend time
answering your question, be prepared to spend time writing as clearly
yet as crisply as possible.
- Please write carefully. List members often delete badly written postings
without reading them. They will naturally take note whenever it is
clear that you are not writing in your first language, but postings
marred by careless grammar, spelling, and punctuation, excessive or deficient
use of uppercase letters, and sloppy
presentation generally are often just too much like hard work to be
worth bothering about. Why should people put themselves out to try to
understand you when you are so thoughtless about presenting your
question?
- Do not bundle very different questions in the same posting; the odds are
that some will get overlooked.
- Beginners' questions are usually indulged (we were all beginners once),
but if you ask too many elementary questions, you may get little or no
response. Read The Fine Manual (or a good statistics text)!
- Please do not post homework questions, and please ignore any that are
posted.
3.3 Stata references in your question
- Say exactly what you typed and exactly what Stata typed (or did) in
response. N.B. exactly! If you can, reproduce the error with one of
Stata's provided datasets or a simple concocted dataset that you include
in your posting.
- The current version of Stata is 12.1. Please specify if you are using an
earlier version; otherwise, the answer to your question is likely to
refer to commands or features unavailable to you. Moreover, as bug fixes
and new features are issued frequently by StataCorp, make sure that you
update your
Stata before posting a query, as your problem may already have been
solved. It may help if you give the results of typing
about within your
Stata, specifically the first two lines of the form
Stata/MP 12.1 for Windows (32-bit)
Revision 30 Jan 2012
-
Say what commands you are using. If they are not part of official
Stata, say where they came from: the SJ/STB, SSC, or other archives.
This helps (often crucially) in explaining your precise problem, and it
alerts readers to commands that may be interesting or useful to them.
Three examples of good practice follow.
Example 1:
I am using -xtreg- in Stata 12.1.
Example 2:
I am using -estout- from SSC in Stata 12.1. Typing -which estout- in
Stata shows me
*! version 3.13 06aug2009 Ben Jann
Example 3:
I am using -metareg- from SJ 8-4 in Stata 12.1. Typing -which metareg-
in Stata shows me
. which metareg
*! v2.6.1 Roger Harbord 4 Nov 2008
*! v1.06 copyright Stephen Sharp January 1998 STB-42 sbe23
For more explanation, see 8. Ado-files FAQ below.
- Refer to Stata commands and other syntax within ordinary text using
dashes (- -) to flag words that you would type when using Stata.
Example: You could try the -assert- command, which is useful for
this kind of problem. (We do not use that convention much in this document, because
we have better kinds of emphasis open to us, but those are denied you in plain-text
emails.)
Do not send examples like this, which gives no information:
The command -fiddle- worked yesterday, but it is not working today.
or like this, which gives very little information:
I am using -frog-, but I just get the message "invalid syntax".
This example shows better style:
I am using Stata 10.1 to try to draw a plot using -scatter-. Here is an
example showing my problem with the auto dataset:
. sysuse auto, clear
. scatter mpg weight
I want to attach a text label to an outlier like that at 41 mpg. How do I do that?
3.4 Consider other members
- Statalist is interdisciplinary Many questions will be of interest to only some Statalist members.
Always recall that members come from many different sciences. Try to
show a little sensitivity to those noneconometricians,
nonbiostatisticians, or whoever it may be who may know little about your
question. Flag your question as of limited interest so that people can
delete it quickly, or take the trouble to avoid subject-specific jargon.
-
Precise literature references please! Please do not assume that the
literature familiar to you is familiar to all members of Statalist. Do not
refer to publications with just minimal details (for example, author and date).
Questions like “Has anyone implemented the heteroscedasticity under a
full moon test of Sue, Grabbit, and Runne (1989)?” admittedly divide
the world. Anyone who has not heard of the said test would not be helped by
the full reference to answer the question, but he or she might well appreciate
the full reference. References should be in a form that you would expect in
an academic publication or technical document. For example, include full
author name, date, paper title, journal title, and volume and page numbers in
the case of a journal article.
- Stata runs on different platforms Similarly, please remember that Stata runs on Windows, Macs, and Unix
platforms. Windows is not the only OS in the world (or even the best).
Specify the platform you are using if your question is specific to that
platform.
- The local is not global Statalist is an international list.
Please explain details that may make sense only in your own corner of
the world (even if it is the United States). References to time of day
(good morning), time of year (enjoy the warm weather), or sporting
arcana (how some team fared recently) can look pretty silly or obscure
to members in other longitudes or latitudes.
- Keep private or personal stuff off the list We all goof by sometimes
forgetting to check destinations before mailing, but the principle is
important.
- Edit previous postings Edit mail so that readers easily see
what the issue is and what your
contribution is. Please do not repost the whole version of a very long message
together with your one-sentence tidbit. Your mailer may have a facility
to select a block of text and then reply quoting only that text.
-
Start new threads with fresh postings, not replies Please do not send a message starting a new thread by replying to
someone else's message on a different topic. Even if you remove all
the previous content, archiving software will still pick up
that your message is a reply and that will unnecessarily mess up
documentation of mail threads in the list archives.
- Choose an informative subject line for your message Empty lines or
headings like “Query” do not attract attention: remember that many
people delete messages on the basis of uninteresting titles. Majordomo
does not like the word “Help” as the first word of your subject,
so please do not start your subject line that way.
- Do not request private replies unless you are offering payment
The Statalist convention is that you reply to the list not to the
poster. Please do not request a direct personal reply unless the
question refers to information about (for example) a job or paid
consultancy. Otherwise, you will bother the list with your question, but
the list does not benefit from any answers. If people reply directly to
you, consider posting a summary to the list.
- Just delete weird stuff Please ignore any messages that appear inappropriate or obvious
malfunctions of the list. Mail about these, mail about mail about these,
and so forth only add to the stuff that members must spend time deleting and do not contribute
to the solution.
-
Urgency is only your concern
Pleas of urgency, desperation, and the like are widely deprecated by
Statalist members. What is urgent for you is unlikely to translate
into urgency for other members of the list. It is simplest and best
to just ask your question directly.
- Thanks in advance? Note that the expression “Thanks in advance” divides the world. Many regard it
as both efficient and courteous. Others regard it as formulaic at best. Saying
“Thanks for your consideration” may capture your meaning better.
- Don't walk away from the thread you started Continuing or closing a thread you started is important, especially by
answering secondary questions and by reporting what solved your problem. You can then
thank those who tried to help.
- Assume goodwill even if it is not evident
4. The names Stata and Mata
4.1 What is the correct way to pronounce
‘Stata’?
Stata is an invented word. Some pronounce it with a long a as in day
(Stay-ta); some pronounce it with a short a as in flat (Sta-ta); and some
pronounce it with a long a as in ah (Stah-ta). The correct English
pronunciation must remain a mystery, except that personnel of StataCorp use
the first of these. Some other languages have stricter rules on
pronunciation that will determine this issue for speakers of those
languages. (Mata rhymes with Stata, naturally.)
4.2 What is the correct way to write
‘Stata’?
Stata is an invented word, not an acronym, and should not appear with all
letters capitalized: please write “Stata”, not
“STATA”. Mata is also an invented word, not an acronym.
5. What to do if you do not get an answer
Sometimes, a posting gets no reply. It is possible that your posting got
overlooked, but this is much less likely than you might think.
If you get no answer, you might be tempted to repost the question, but
please think twice before you do. The same post reappearing repeatedly
strikes many Statalist members as impatient and inconsiderate. You had your
chance, but, unfortunately, no one wanted to answer the question.
If your posting gets no reply, it may be the fault of the question, of the
questioner, or of those who read the question. Who knows for sure?
However, it is most likely to be for one or more of the following reasons:
- No one knows of any such Stata program. You need to write your own code
or use some other software.
- Your question really should be answered by using the manual, the
online help, or by typing findit in an up-to-date Stata, but no
one felt blunt enough to point that out.
- We do not have the knowledge of your project needed to work out the best
thing to do in your circumstances, and, in any case, it is really your call.
- Whether what you are doing is “correct” is very difficult to discuss helpfully.
- You did not provide enough information. For example, postings of the
form “I tried using -foobar-, but it did not work” are usually
impossible to answer, except by asking for more information.
- Your question is too unclear or too complicated to understand. For
example, very complicated data-management tasks or large chunks of code that
are not working are usually too much like hard work to understand, even for
Stata experts.
It is possible that you may benefit from trying to make your problem much
clearer or simpler. Remember that a very long posting with a mass of
detailed explanation is just as offputting as a question that is cryptically
brief. The best advice is to rewrite the question so that
the key issue is made as clear as possible but also is stated as briefly as
possible.
But in all circumstances, there is a simple rule of thumb: A rewrite or even
one repost of the original is tolerable, but more than one repost is not.
If after two attempts you have not received an answer, there is too slim a
chance that you will get an answer on Statalist to warrant another attempt.
6. Private emails to those active on Statalist
People very active on Statalist or in the Stata user community
can get many personal emails from people they hardly know
requesting Stata support. This is not very surprising: people
who want help naturally tend to ask those who they think may provide
it. But, for everyone’s sake, this may need a little more consideration
than it is sometimes given.
In particular, some posters are tempted to reply directly to people who
answer their initial questions. You are asked not to do that. Instead keep the
thread public so that anyone interested can see any further discussion and so
that no particular person is pressured to write further if they do not wish.
There can be many reasons to email someone directly: most obviously,
if you are a friend or you have a question specifically
about a program someone has written. Nothing below applies to
those kinds of mail.
However, emailing someone on the grounds that they appear active and
knowledgeable about Stata is a tactic with a low probability of getting
precisely what you want and a high probability of wasting the time of
both parties.
- Often the experts cannot help, because they do not understand the question,
do not know the answer, or just do not have the time.
- Much of the benefit of Statalist is that an answer to a question might
well interest other people. Thinking that an answer might help many is an
incentive to everyone. Or say you start a thread and then you take it
private. Your response is now invisible to others who may be interested in
the thread.
- Nobody is obliged to answer anything on Statalist. If you send private
mail to anyone, you oblige him or her to answer or to feel rude or awkward if
he or she ignores your mail.
- Some people send private mail because they think that a question is too
elementary or trivial to post to Statalist. If it really is elementary
or trivial, why should an expert want to answer it?
- Time spent posting to Statalist is time unavailable for doing the other
things in life. So guessing that Stata-active people have
more time available for private support is likely to be wrong.
- Someone
answering your question is not necessarily volunteering to provide you with
further support. Indeed, that person may have said the one thing that he or she wants to
contribute and have nothing further to add.
- People who pop up in your mailbox frequently, perhaps daily, may appear
familiar to you, but that does not mean they know you.
So, for all these reasons, it is usually better to post directly to Statalist.
7. FAQs on Stata
7.1 Where to find this FAQ
The URL is
http://www.stata.com/support/faqs/resources/statalist-faq/.
7.2 Where to find other FAQs on Stata
The answers to the most Frequently Asked Questions (FAQs) about Stata can be
found at StataCorp’s website:
- Point your browser to
http://www.stata.com.
- Click on Support.
- Click on FAQs.
These are worth reviewing periodically, even if you are not searching for a
particular answer. On the FAQs page, you can click on "What's New in
the FAQs" to see what has been added recently.
The FAQs are indexed in Stata’s online
search but only
if you install the updates. See "Updates to Stata" below.
For specific information on the Stata Technical Bulletin, point your
browser to
http://www.stata.com/support/faqs/resources/stata-technical-bulletin-faq/.
For specific information on the Stata Journal, point your browser to
http://www.stata.com/support/faqs/resources/stata-journal-faq/.
7.3 Updates to Stata
Every few years, there is a new release of Stata from
StataCorp.
A given release, however, is updated periodically. These updates are
available free over the Internet.
If you have an Internet connection, the
easiest way to do this is with the
update command. From within Stata, type
update from http://www.stata.com
and follow the instructions.
This will work with any version of Stata; Stata will not
confuse updates for one version of Stata with updates for another.
Updates are also available via your browser,
http://www.stata.com/support/updates.
7.4 Ways to learn how to use Stata
Statalist is one way to learn about Stata. In addition, StataCorp offers
courses over the Internet that range from beginner to advanced.
Point your browser to http://www.stata.com/netcourse.
In addition, there are various books published that can help—visit
the Stata Bookstore at stata.com/bookstore.
8. Ado-files FAQ
8.1 Where to find Stata-released ado (STB/SJ) files
Programs published in the Stata Technical Bulletin
(STB, the bimonthly journal, which appeared between March 1991 and May 2001)
and in the Stata Journal
(SJ, the quarterly journal, 4th quarter 2001–present) are available for free
over the Internet.
The easiest way to do this is from within Stata.
Suppose you want to download gr0001 from SJ1-1. Type
net from http://www.stata-journal.com
net cd software
net cd sj1-1
net install gr0001
In windowed flavors of Stata, you can do this with your mouse. First, click
Help and then SJ and User-written Programs.
Type help net
for further information.
In addition to downloading programs, you will usually want to read the original articles.
Electronic access is free for articles published 3 or more years ago. For information
on that and on accessing newer articles, see
The Stata Journal archives
or
Individual Stata Technical Bulletin (STB) issues.
Publications to the STB or SJ are indexed in
search
and findit.
search will only yield up-to-date results if you install
the updates periodically. See "Updates to Stata" above.
8.2 User-contributed ado-files: the SSC Archive
Kit Baum (baum@bc.edu) maintains the
Statistical Software Components (SSC) archive at the Boston College
Department of Economics. This can be found at
http://ideas.repec.org/s/boc/bocode.html,
hosted by the University of Connecticut Department of Economics
or
http://econpapers.repec.org/software/bocbocode/,
hosted by the University of Örebro Department of Business, Economics,
Statistics and Informatics
This archive covers most of
what has appeared or been publicized on Statalist since September 1997.
Some of it is now outdated by later additions to official Stata, and some of
it is obsolete for other reasons, but a lot of it remains the best way of
doing many tasks. Much of it has not appeared in the STB or SJ and may
never appear there.
For official explanation and for detailed notes on how to submit to and
retrieve from the archive, see
http://repec.org/bocode/s/sscsubmit.html.
Most programs being added now require Stata 10,
Stata 11, or Stata 12, but some older code may work under earlier
versions. Recent additions, and some older ones, specify the required
version.
Some authors send updates of programs directly to Kit Baum
(baum@bc.edu) without publicizing the
updates on Statalist, especially those regarding minor bug fixes or
enhancements. Hence, do not copy programs posted on Statalist from old
email messages; always go straight to Kit's site.
By far the best way to interact with this site is with the official Stata
command ssc.
If you want information on the hotdeck module, type ssc describe
hotdeck. If you want to install the hotdeck module, type ssc
install hotdeck [,replace]. (ssc install, like net
install, will not overwrite existing files unless replace is
specified.)
Alternatively, local restrictions may
oblige you to use a browser rather than ssc. Be warned, however, that
your browser is not as smart as Stata in understanding Stata program files
correctly, especially with regard to ends of lines and handling .hlp files.
In fact, your Stata may tell you that there are syntax errors in ado-files
that have been downloaded. Typically, those errors have been introduced by
your browser. Similarly, Windows in particular has its own help
files that postdate the introduction of Stata .hlp files.
In windowed flavors of Stata, you can do this with your mouse. Click on
Help and then on SJ and User-written Programs. Type
help net for
further information.
You may also search to see what is in the SSC archive by accessing
http://ideas.repec.org/s/boc/bocode.html and using the
“Search this series” feature (there are several pages of
listings, so a Find on this Page will not be comprehensive). Using this
method, you can find tools for ‘inequality’ or those by
‘Jann’. This search covers the full text of the abstracts, as
well as the titles of the items posted.
Alternatively,
you may use findit to search for user-written material, including the
SSC archive.
You may see what has been added to SSC within the last month by typing
ssc new (or in Stata versions 7 to 9
ssc whatsnew). This provides clickable links for the description and installation of
new and revised SSC items.
Alternatively, you may see what has been added to SSC by accessing
http://repec.org/docs/ssc.php
in your browser.
8.3 Are there other sources of user-written ado-files?
There are extra sources on the Stata website at
stata.com/links/resources-for-adding-features and at
http://www.stata.com/meetings.
In addition, various users have made programs available at different
sites. See
stata.com/links/resources-for-adding-features for some links to other user
sites.
You may use
findit, which finds and lists sources of information on Stata and Stata
commands that have already been installed on your computer or are available
on the web. The results include (1) official help files installed on your
computer, (2) FAQs available at the Stata website, (3) material published
in the STB and in SJ, and (4) user-written programs and help files available
over the web.
It is also possible to access these sources using your normal browser. A
good search engine should catch material not referenced via the web pages
mentioned above. However, downloading software is much easier using Stata.
Much of this material is in the form of packages that may include several files.
Much of it is also available in the SSC archive.
8.4 What is the relationship between ado-files from the SSC
Archive, other user-written ados, ados published in the Stata Journal, and
ados that are part of official Stata?
There is no inevitable progression from the SSC Archive to the
Stata Journal and
certainly no inevitable progression from either to official Stata. These
are operated as separate, but not isolated, entities. Many users post
programs first in the SSC Archive; they may or may not then publish in
the SJ. That depends on whether they submit to the journal and on the
editorial process of the journal. Some users who publish in the SJ make
little or no use of Statalist. Those are matters largely of personal habit.
User-written programs accessible from the StataCorp website have
essentially the same status as those available from the SSC Archive. Their
posting there is basically a matter of convenience to users and is not an
official endorsement by StataCorp.
However, StataCorp has nonexclusive rights to any program published in the
STB or SJ, while anything placed in the SSC Archive is tacitly put in the
public domain. In practice, you can probably take anything published in
either medium and modify it as you will—especially if you do that
privately—but publicly we recommend that, unless you are the original
author, you change the name of the program, take all blame for any
limitations your changes produce, and imply that a suitably large portion of
the credit for the program belongs to the original authors.
StataCorp is entirely responsible for decisions about what is incorporated
in official Stata.
8.5 Does downloading an upgraded or augmented STB/SJ
contribution automatically replace an earlier one, and does it inherit
all functionality of the previous version?
Generally, the answer is yes. An ado-file with the same name as a previous
version will normally correct bugs or augment the functions of the
superseded version.
The tag (in the STB the insert number) indicates the version of the file.
Suppose st0067 provides
some feature. st0067_1 should provide all the same features and be better
than st0067. st0067_2 should be the same thing but better than the two that
preceded it, and so on.
We say “generally” only because authors and editors sometimes make
mistakes. In terms of installation, if the name of the command is the same,
then the new automatically replaces the old.
Incidentally, make sure you are aware of the scope for using the adoupdate command
to keep your installed packages up-to-date. See
help adoupdate.
8.6 What happens if an STB/SJ contribution upgrades,
corrects, or expands an official ado-file or built-in command?
It cannot, in the sense that no user-written material could change the
behavior of an official command of Stata such as regress or
logit. An STB/SJ contribution, however, could offer an alternative to
an official command, such as offering a command named regress2 or
logit2. In that case, the command should do whatever the author says
it does. In most cases, a numeric suffix would mean that the author is
proffering this as a replacement for the original, but there are no rules.
8.7 How do I know if official ado upgrades (and executable
upgrades) incorporate the functionality of previous STB/SJ contributions (so
that the STB/SJ contributions become "obsolete")?
Stata’s
search
database tries to keep track of that information. When StataCorp
incorporates a feature from a previous STB/SJ submission in its entirety, it
marks the original insert as historical.
For instance, type search glm, and you will get a list of suggestions
that includes previous STB/SJ submissions. All those suggestions should be
relevant to present users. Type search glm, historical, and the list
will include more suggestions–all the above plus more STB/SJ
submissions. The extras are not really relevant now because those features
have been incorporated into Stata.
We can turn this around. Say that you stumble across sg16.1 somehow.
You can look up items in the search database by their reference
number by specifying the entry option. If you type search sg16.1,
entry, Stata should tell you about the sg16.1 insert. Stata,
however, will say nothing. It is as if sg16.1 does not exist.
If, on the other hand, you type search sg16.1, entry historical you
will learn that sg16.1 was published in STB-12, that its title is
"Generalized linear models using power links", and that it was
written by J. Hilbe. search with the historical option looks
in entries of historical interest, too. sg16.1 is interesting,
historically speaking, but not of practical use today because Stata now has
a glm command.
But note there is absolutely no guarantee that StataCorp will
incorporate any contribution from the STB/SJ into official Stata. In the
long run, all users benefit because Stata is centered on a stringently
selected core of code that is both of high quality and of use to many, if
not all, users.
|
