R: Translate LISREL syntax to lavaan 'model.syntax'

lisrel2lavaan-deprecated {semTools} | R Documentation

## Translate LISREL syntax to lavaan `model.syntax`

### Description

This function is deprecated because it is based on an old template for lavaan's parameter table, which is expected to differ more as development continues.

### Usage

    lisrel2lavaan(filename = NULL, analyze = TRUE, silent = FALSE, ...)

### Arguments

`filename` | Filename of the LISREL syntax file. If the `filename` arguement is not specified, the user will be prompted with a file browser with which LISREL syntax file can be selected (recommended).
`analyze` | Logical. If `analyze==TRUE` (default), data will be automatically imported and analyzed; `lavaan` summary output displayed and fit object will be returned silently. If `analyze==FALSE`, data will not be imported or analyzed; instead, a `lavaan` parameter table containing the model specifications will be returned.
`silent` | Logical. If false (default) the data will be analyzed and output displayed. If true, a fit object will be returned and summary output will not be displayed.
`...` | Additional arguments to be passed to `lavaan`. See also `lavOptions`

### Details

This function can be used to estimate a structural equation model in `lavaan` using LISREL syntax. Data are automatically imported from the LISREL syntax file, or, if data files names are provided within LISREL syntax, from the same directory as the syntax itself, as per standard LISREL data importation.

### Value

Output summary is printed to screen and `lavaan` fit object is returned.

### Note

`lisrel2lavaan` is still in development, and not all LISREL commands are currently functional. A number of known limitations are outlined below. If an error is encountered that is not listed, please contact corbinq@ku.edu.

1. data importation: `lisrel2lavaan` currently supports .csv, .dat, and most other delimited data formats. However, formats that are specific to LISREL or PRELIS (e.g., the .PSF file format) cannot be imported. `lisrel2lavaan` supports raw data, covariance matrices, and correlation matrices (accompanied by a variance vector). Symmetric matrices can either contain lower triangle or full matrix. For MACS structure models, either raw data or summary statistics (that include a mean vector) are supported.

2. variable labels: Certain variable labels that are permitted in LISREL cannot be supported in `lisrel2lavaan`.

3. duplicate labels: Most importantly, no two variables of any kind (including phantom variables) should be given the same label when using `lisrel2lavaan`. If multiple variables are given the same label, `lavaan` will estimate an incorrect model.

4. numeric character labels: All variable labels are recommended to include non-numeric characters. In addition, the first character in each variable label is recommended to be non-numeric.

5. labels not specified: If variable labels are not provided by the user, names will be generated reflecting variable assignment (e.g. 'eta1', 'ksi1'); manifest variables will be in lower case and latent variables in upper case.

6. OU paragraph Not all commands in the OU paragraph are presently supported in `lisrel2lavaan`. The ME command can be used to specify estimation method; however, not all estimations available in LISREL are currently supported by `lavaan`. If the specified ME is unsupported, `lisrel2lavaan` will revert to default estimation. The AD, EP, IT, ND and NP keywords will be ignored. Requests for text files containing starting values (e.g., `OU BE`) will also be ignored.

7. starting values: Certain functionalities related to starting values in LISREL are not yet operational in `lisrel2lavaan`. Note that due to differences in estimation, starting values are not as important in `lavaan` model estimation as in LISREL.

8. text file output: Requests for text files containing starting values for individual matrices in the in the `OU` command (e.g., `OU BE`) are not currently supported. These requests will be ignored.

9. MA paragraph: Specification of matrix starting values using the MA command is permitted by providing starting values within syntax directly. However, `lisrel2lavaan` has sometimes encountered problems with importation when files are specified following the MA paragraph.

### Author(s)

Corbin Quick (University of Michigan; corbinq@umich.edu)

### See Also

`semTools-deprecated`

### Examples

    ## Not run:
    	## calling lisrel2lavaan without specifying the filename argument will
    	## open a file browser window with which LISREL syntax can be selected.

    	## any additional arguments to be passed to lavaan for data analysis can
    	## be specified normally.

    	lisrel2lavaan(se = "standard")
    	## lavaan output summary printed to screen
    	## lavaan fit object returned silently

    	## manual file specification

    	lisrel2lavaan(filename = "myFile.LS8", se = "standard")
    	## lavaan output summary printed to screen
    	## lavaan fit object returned silently

    ## End(Not run)

[Package semTools version 0.5-0 Index]