Differences between revisions 6 and 10 (spanning 4 versions)
Revision 6 as of 2023-06-07 20:29:04
Size: 653
Comment:
Revision 10 as of 2025-10-24 17:27:01
Size: 1154
Comment: Rewrite
Deletions are marked like this. Additions are marked like this.
Line 3: Line 3:
The '''`log`''' command records commands and command output, and writes them to a log file. '''`-log-`''' wraps logging facilities.
Line 11: Line 11:


=== Rich Logs ===

Stata supports a rich log format, using the `.smcl` file extension.
Line 18: Line 12:
log using "path/to/file.smcl", replace log using "path/to/file"
Line 22: Line 16:
Stata's rich log format uses the `.smcl` file extension.
Line 23: Line 18:

=== Text Logs ===

Use the '''`text`''' option.

{{{
log using "path/to/file.txt", replace text
log close
}}}

----
If the '''`text`''' option is specified, or if the file extension is one of `.log` or `.txt`, then a plaintext log will instead be created.
Line 37: Line 22:
== Temporarily Disabling Logging == === Temporarily Disabling Logging ===
Line 47: Line 32:
----



== Stored Results ==

`-log-` stores the following details:

 * log name in `r(name)`
 * log filename in `r(filename)`
 * logging status (on or off) in `r(status)`
 * log type (smcl or text) in `r(type)`

`log query _all` stores the number of open logs in `r(numlogs)`. For each open log, it stores the above details as e.g. `r(name1)`, `r(name2)`, and so on.

----



== See also ==

[[https://www.stata.com/manuals/rlog.pdf|Stata manual for -log-]]

[[https://www.stata.com/manuals/u15.pdf|Stata manual chapter 15: Saving and printing output-log files]]

Stata Log

-log- wraps logging facilities.


Usage

log using "path/to/file"
log close

Stata's rich log format uses the .smcl file extension.

If the text option is specified, or if the file extension is one of .log or .txt, then a plaintext log will instead be created.

Temporarily Disabling Logging

Some output should not be recorded. Try:

log off
display "Rather than running commands quietly, temporarily turn off logging.
log on


Stored Results

-log- stores the following details:

  • log name in r(name)

  • log filename in r(filename)

  • logging status (on or off) in r(status)

  • log type (smcl or text) in r(type)

log query _all stores the number of open logs in r(numlogs). For each open log, it stores the above details as e.g. r(name1), r(name2), and so on.


See also

Stata manual for -log-

Stata manual chapter 15: Saving and printing output-log files


CategoryRicottone

Stata/Log (last edited 2025-10-24 17:27:01 by DominicRicottone)