input#
- Mapdl.input(fname='', ext='', dir_='', line='', log='', *, verbose=False, progress_bar=False, time_step_stream=None, chunk_size=512, orig_cmd='/INP', write_to_log=True, **kwargs)#
Stream a local input file to a remote mapdl instance. Stream the response back and deserialize the output.
Changed in version 0.65: From version 0.65 you can use the APDL commands arguments (
ext
,dir
,line
) in within this command. However, the gRPC implementation does not uses the APDL/INPUT
command, rather the gRPC input method with the appropriate configuration to replicate/INPUT
behaviour.- Parameters:
- fname
str
,optional
MAPDL input file to stream to the MAPDL gRPC server. File name and directory path. An unspecified directory path defaults to the Python working directory; in this case, you can use all 248 characters for the file name. The file name defaults to the current
Jobname
ifExt
is specified.- ext
str
,optional
Filename extension (eight-character maximum).
- dir
str
,optional
Directory path. The default is the current working directory.
- line
int
,optional
A value indicating either a line number in the file from which to begin reading the input file. The first line is the zero line (Python convention).
- (blank), or 0
Begins reading from the top of the file. Default.
- LINE_NUMBER
Begins reading from the specified line number in the file.
- log
optional
Not supported in the gRPC implementation.
- time_step_stream
int
,optional
Time to wait between streaming updates to send back chunks from the listener file. Larger values mean more data per chunk and less chunks, but if the command is short, will wait until time_step_stream is finished leading to a long execution time.
Due to stability issues, the default time_step_stream is dependent on verbosity. The defaults are:
verbose=True
:time_step_stream=500
verbose=False
:time_step_stream=50
These defaults will be ignored if
time_step_stream
is manually set.- orig_cmd
str
,optional
Original command. There are some cases, were input is used to send the file to the grpc server but then we want to run something different than
/INPUT
, for exampleCDREAD
.
- fname
- Returns:
str
Response from MAPDL.
Notes
This method does not use the APDL
/INPUT
command. However its usage is very similar to it. See Examples section.If you want to use
/INPUT
for some reason, although it is not recommended, you can write the desired input file, upload it usingMapdl.upload
, and then use run commandMapdl.run('/INPUT,
. This does not avoid to use the gRPC input method, but it allows you to use the APDL/INPUT
command from the generated input file. See Examples section for more information.Examples
Load a simple
"ds.dat"
input file generated from Ansys Workbench.>>> output = mapdl.input('ds.dat')
Load that same file while streaming the output in real-time.
>>> output = mapdl.input('ds.dat', verbose=True)
Use the default APDL
/INPUT
command:>>> with open('myinput.inp','w').write("/finish\n/prep7\n/com, my commands") >>> with open('inputtrigger.inp','w').write("/input,myinput,inp") >>> mapdl.upload("myinput.inp") Uploading myinput.inp: 100%|█████████████████████████████████████████████████| 26.0/26.0 [00:00<00:00, 5.86kB/s] 'myinput.inp' >>> mapdl.upload("inputtrigger.inp") Uploading inputtrigger.inp: 100%|████████████████████████████████████████████| 32.0/32.0 [00:00<00:00, 8.92kB/s] 'inputtrigger.inp' >>> with mapdl.non_interactive: mapdl.run("/input,inputtrigger,inp") # This inputs 'myinput.inp'