Installation of Taxsimlocal35
-taxsimlocal35-is a Stata .ado file for calculating US Federal and
State income tax liabilities. Unlike
-taxsim35.ado- the actual calculation is done
by a binary executable on the user's computer. No data is sent over the
Internet.
Normal Install
net from https://taxsim.nber.org/stata
net install taxsimlocal35,all
Stata will automatically choose the Windows, OSX or Linux version of the
Fortran executable. Please test the install with the following program:
set obs 1
gen mstat=2
gen year=1970
gen ltcg=100000
taxsimlocal35,replace
fiitax should be 16,700.04. The most likely failure is not
an incorrect dollar amount, but no result at all. You can check for
what is wrong by opening a terminal window and changing to the directory
where the taxsimlocal35 files have been stored. The -which taxsimlocal35-
command will give you the directory path. Once in that directory issue
commands to
type taxsimlocal35.ado
type taxsimlocal35.hlp
"type" would be "cat" in Linux or OSX. Those commands should send several
pages of ASCII text to the window. If they don't, check that the files exist
and are generally readable. Next test the executable
./taxsim35.exe
taxsimid,mstat,year,ltcg
1,2,1970,100000
You should receive a 2-line csv file in reply. If not, check the existence
and permissions (Linux and OSX) on the executable.
Firewall Interference with the Installation
One of the files that must be installed on your computer is the binary
executable - taxsim35.exe. -net install- attempts to put it in the
same directory as -taxsimlocal35.ado-, but a local or institutional
firewall
may interfere with the download. There is typically no error message
during the install, but -taxsimlocal35- will fail with
TAXSIM: not found
The best solution is to somehow get the executable into that directory.
One way is to ask your IT group for help. Many IT departments pride
themselves on never helping with user concerns, so you may have to find a
workaround. You can perhaps download the executable at home, and
transfer the file on a thumb drive. The file is available at one of these
URLs:
depending on which kind of computer you will run -taxsimlocal35- on.
(These are all 64-bit Intel binaries). That file must be renamed to
taxsim35.exe on your machine. You can find the directory to place
the file in with the Stata -which taxsimlocal35- command. That would
typically be in the ado/plus/t subdirectory of your home directory.
Update problems
You should be able to update taxsim ado files with the normal
community update command:
ado update taxsim*,update
The Stata -net uninstall- command dosn't always uninstall a
program, and if it doesn't, -net install- and -ado update- may not
function correctly. There is an alternative and more reliable
uninstall procedure, but it is a little harder. Run
ado dir taxsimlocal35
to get a numbered list of existing -taxsimlocal35- installations. Then
uninstall each of them with
ado uninstall [#]
where # is the relevant number from the -ado dir- command. Then do a
normal install of -taxsimlocal35-.
Desperation measures
If you don't have write permission in the default location for
Stata .ado files, you can install -taxsimlocal35.ado- and
taxsim35.exe anywhere you chose, such as your home or download
directory. Once there, you will have to use the -adopath- command
to tell Stata where to look. If those files are in "/path/to/dir"
then use
adopath ++ /path/to/dir
to add that to the Stata search path. If only the binary is off the path and you can
set a global variable to tell the ado file where to look for the binary.
global taxsimexe "c:\users\userid\downloads"
These commands can be put in your -profile.do- to avoid repeating them.
I have, on occaision, made the Fortran 77 source code available. C
language source is also available.
last update 14 January 2022 by drf