|
Size: 511
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 1: | Line 1: |
| ## page was renamed from StataLogs = Log Files = |
= Stata Log = |
| Line 4: | Line 3: |
| Stata outputs to a terminal emulator. Output can be recorded into a markup file, which can be rendered into file formats including raw text. | '''`-log-`''' wraps logging facilities. |
| Line 10: | Line 9: |
| == Built-in Logging == | == Usage == |
| Line 13: | Line 12: |
| log using "path/to/file", replace | log using "path/to/file" log close }}} |
| Line 15: | Line 16: |
| // do something | Stata's rich log format uses the `.smcl` file extension. |
| Line 17: | Line 18: |
| 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: {{{ |
|
| Line 18: | Line 28: |
| di "Rather than running commands `quietly`, temporarily turn off logging. | display "Rather than running commands quietly, temporarily turn off logging. |
| Line 20: | Line 30: |
| }}} | |
| Line 21: | Line 32: |
| // do something else | ---- |
| Line 23: | Line 34: |
| log close translate "path/to/file.smcl" "path/to/file.log" }}} |
== 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 chapter 15: Saving and printing output-log files