- Undocumented Matlab - https://undocumentedmatlab.com -

Recovering previous editor state

Posted By Yair Altman On January 11, 2012 | 22 Comments

Editor with multiple loaded documents I find it very useful to use the Matlab editor’s ability to load multiple files to help me remember which files I still need to work on. I typically have a few dozen files loaded in the editor. I guess you could say that the editor’s list of files is a simple reflection of my open tasks. It would be extremely inconvenient if I ever lost this list.
Which is, unfortunately, exactly what happened to me yesterday.
I was about to close a figure window and accidentally closed the editor window that was behind it.
I was now in quite a jam: reopening the editor would not load all my files, but start with a blank (empty) editor. The Matlab editor, unlike modern browsers, does not have a ‘reopen last session’ option, and using the most-recently-used (MRU) files list would at best return the latest 9 files (the default Matlab preference is to have an MRU depth of only 4 files, but this is one of the very first things that I change whenever I install Matlab, along with a few other very questionable [IMHO] default preferences).
Luckily for me, there is an escape hatch: Matlab stores its Desktop windows state in a file called MATLABDesktop.xml that is located in the user’s prefdir folder. This file includes information about the position and state (docked/undocked etc.) of every Desktop window. Since the editor files are considered Desktop documents (you can see them under the Desktop’s main menu’s Window menu), they are also included in this file. When I closed the Editor, these documents were simply removed from the MATLABDesktop.xml file.
It turns out that Matlab automatically stores a backup version of this file in another file called MATLABDesktop.xml.prev, in the same prefdir folder. We can inspect the folder using our system’s file browser. For example, on Windows we could use:

winopen(prefdir)

So before doing anything else, I closed Matlab (I actually crashed it to prevent any cleanup tasks to accidentally erase this backup file, but that turned out to be an unnecessary precaution), deleted the latest MATLABDesktop.xml file, replaced it with a copy of the MATLABDesktop.xml.prev file (which I renamed MATLABDesktop.xml), and only then did I restart Matlab.
Problem solved – everything back to normal. Resume breathing. Once again I have my never-ending virtual task list in front of me as I write this.
Lessons learned:

  1. don’t be too quick on the close button trigger
  2. always keep a relatively recent backup copy of your important config files (BTW, I use the same advice with my FireFox browser, where I normally have dozens of open tabs – I keep a backup copy of the sessionstore.js file)
  3. if you do get into a jam, don’t do anything hasty that might make recovery impossible. Calm down, look around, and maybe you’ll find an automatic backup somewhere

Categories: Desktop, Low risk of breaking in future versions, Undocumented feature


22 Comments (Open | Close)

22 Comments To "Recovering previous editor state"

#1 Comment By Alexander On January 12, 2012 @ 01:33

Hello Yair,

in above article you state “…best return the latest 9 files (the default Matlab preference is to have an MRU depth of only 4 files, but this is one of the very first things that I change whenever I install Matlab, along with a few other very questionable [IMHO] default preferences).”.

It might be interesting to me and maybe other readers what these questionable default preferences are. Perhaps you find the time to write an article on this topic.

Alexander

#2 Comment By Rafael On January 12, 2012 @ 01:58

One alternative I always do is to leave one blank unsaved file all the time open, so that when you close the editor by accident, it will first ask if you want to save that file, and then you have the option to cancel…
BTW, I’m also curious about what are your ‘default’ preferences 🙂
Mine are:
-display format using short g (I always work with matrix that represent different states at each line, and I hate when MATLAB just shows everything as 1e5 * [1 0.0001 0.01] instead of [1e5 10 1e3])
-increase java heap, I quite often hit the default value of 128mb…
-change the default font from to Consolas
-enable code folding for everything
-change indentation mode to all functions
-disable wrap comments (we have widescreen monitors, don’t need everything to be within 80 col anymore!)
-increase the number of lines in the cmd window buffer (one of the libraries I use outputs a lot of text to the cmd window, and I want to be able to scroll up and see what was before)
-when on linux, change the default keyboard set from emacs to windows (give me back my Ctrl+C Ctrl+V 🙂 )

any other I’m missing?

#3 Comment By Amit On January 12, 2012 @ 11:02

What could be really nice is to be able to easily change the colors of the names of the files, so as to group them into projects.

And regarding default options, naturally remove the vertical line from the middle of the screen.

#4 Comment By Brian Emery On January 12, 2012 @ 14:05

Very cool! It seems we have a similar work flow. It also seems a reasonable task then to write some code that will make saving and restoring different editor states for different projects an easy thing to do. I’ll get right on it …

#5 Comment By Robert Cumming On January 14, 2012 @ 01:46

Yair,

I had a similar problem a while back and wrote a function to manage it, I have finally uploaded it on Matlab [7].

Regards

#6 Comment By Amit On January 16, 2012 @ 23:36

Robert,
This is simple and excellent , thank you.

#7 Pingback By MLintFailureFiles or: Why can’t I save my m-file?! | Undocumented Matlab On February 1, 2012 @ 17:15

[…] a few weeks ago, when I explained how to use the stored editor state file that is stored in the prefdir folder […]

#8 Comment By CarzyOliv On August 2, 2012 @ 09:22

Thaks a lot for this post.
I use to work the same way you do (you = the original poster).
It was a very hard task to automately recover my document bar after I closed and reopened an ancient project.
Now it is, and I quote Tommy Lee Jones, Ladies Lingerie.

Very great investigation.

I resume the way I do :

  1. I have got a very ramified document bar in my editor I want to save and recover after.
  2. I write the command : winopen(prefdir)
  3. I copy the file MATLABDesktop.xml (this only very file) I found in the folder
  4. I paste the copy on the folder of my project, somewhere I can easily recover it in a far future.
  5. I close the editor.
  6. start a new project out of a blank document bar.
  7. long time after, I write the command winopen(prefdir)
  8. I close Matlab, using the regular way.
  9. paste into the previously opened prefdir directory the MATLABDesktop.xml related to the project I want to recover. Matlab use to be shut-down
  10. I open Matlab.
  11. I enjoy a automatic startup of the editor with the document bar I used to deal with a few time ago.

This is very easy and intuitive.

Thanks

#9 Comment By MFloyd On March 26, 2014 @ 22:35

Is there a way to programmatically change where files are loaded in the editor? The editor can have split panes for example with multiple files associated with one pane or another. MATLABDesktop.xml contains the information, but my current matlab version (2013b) always loads them to a single pane if opening matlab after closing it. So even though I know how to manually modify the xml, it won’t load to correct panes in the first place.

Robot Cumming’s file works well to load different sets of files without changing the xml directly. I just can’t find where outside of the xml file pane position can be found or changed, either in the com.mathworks.mde.editor.MatlabEditor class or elsewhere.
Being able to programmatically change the pane location would allow organizing by location or name as well, instead having to manually drag and drop each file to the desired location in the editor.

Thanks

#10 Comment By Yair Altman On March 27, 2014 @ 02:34

@MFloyd – you can access the Desktop handle as explained [8], and then use its setClientLocation method. Something like this:

jDesktop = com.mathworks.mde.desk.MLDesktop.getInstance;
jDesktop.setClientLocation(fullFileName, location)

Where location is a com.mathworks.widgets.desk.DTTiledLocation object. You can get existing client locations via

location=jDesktop.getClientLocation(fullFileName)

But I’m not sure exactly how to create new locations. It’s something like com.mathworks.widgets.desk.DTTiledLocation.create(...) or com.mathworks.widgets.desk.DTTiledLocation.fromXML(com.mathworks.mwswing.SimpleElement), but you’ll need to find out for yourself. Let us know if you discover anything useful.

#11 Comment By MFloyd On April 24, 2014 @ 10:55

Thanks, you helped a lot. It took a while, but I finally got something working end to end.

To get an existing location I had to make a small change:

jDesktop = com.mathworks.mde.desk.MLDesktop.getInstance;
jEditorViewClient = jDesktop.getClient(fileName);
location = jDesktop.getClientLocation(jEditorViewClient)

Where fileName could be the short name found in the tab title including the ‘*’ at the end if modified or if unsaved it could be ‘Unsaved#’. Specifying a location independent of a specific view can be done with

location = com.mathworks.widgets.desk.DTLocation.create(tileNumber)

Note that getting a location from a specific view will have properties specifying the view placement (x,y,w,h), but creating one directly from the tileNumber will only set tileNumber to something meaningful. In either case they work equally well for setting a view to a specific location.

To set or change the location the following options worked:

jDesktop.setClientLocation(jEditorViewClient, location)
jDesktop.setClientLocation(fileName, location)

I spent a long time trying to figure out how to create a new location. Creating a new DTLocation object was insufficient in any case and was only useful if it already existed. If a DTLocation that did exist was saved and files were later moved to other locations so that tile no longer existed, it wouldn’t recreate the tile. It would always set it to one of the existing tiles.

To change the editor layout I used the following functions:

jDesktop.setDocumentArrangement('Editor',2,java.awt.Dimension(nTilesW,nTilesH));
jDesktop.setDocumentColumnSpan('Editor',row,column,columnSpan);
jDesktop.setDocumentRowSpan('Editor',row,column,rowSpan);
jDesktop.setDocumentRowHeights('Editor',hieghtPercentages)
jDesktop.setDocumentColumnWidths('Editor',widthPercentages)

There were some tricky parts in using these to avoid “eating” files in adjacent tiles when expanding tiles using ColumnSpan and RowSpan functions as well as correlating between old tile numbers and new tile numbers since the sequence of how tiles are expanded/created affects tile numbers.

I made a session manager inspired by Robert Cummings file exchange submission mentioned above. I completely reworked it and it is likely not backward compatible, but is found here: [9]

Thanks for your help!

#12 Comment By Robert Cumming On April 25, 2014 @ 05:53

MFloyd – Good to hear that you have taken inspiration from my submission! 🙂

I will have to have a look at your code later.

Regards

#13 Comment By cw On September 18, 2014 @ 15:02

This is pretty much one of the most useful posts I’ve encountered in a very long time. Thank you !

#14 Comment By Eric Melonakos On January 12, 2015 @ 15:30

Thank you! This just saved me a ton of time and confusion!

#15 Comment By Noam Greenboim On May 27, 2015 @ 08:57

Thanks for posting this, I have the same issue every now and then.

#16 Comment By DoTTy On November 17, 2015 @ 08:45

Thank you very much for this post, it saved my live!! 😉 Regards

#17 Comment By Michael On March 4, 2016 @ 16:11

Inspired by this post, I created a shortcut in Matlab with the following content:

%parse XML file
xmlFiles    = xmlread([prefdir filesep 'MATLABDesktop.xml.prev']);
%Retrieve the "clients"
FileNodes   = xmlFiles.getElementsByTagName('Client');
%get the length of the FileNodes
nrFiles     = FileNodes.getLength;
%initialize Files
Files       = cell(nrFiles,1);
%initialize isFile
isFile      = zeros(nrFiles,1);
%Iterate over all Elements and check if it is a file.
for iNode = 0:nrFiles-1 % Java indexing.
    %Files
    Files{iNode+1} = char(FileNodes.item(iNode).getAttribute('Title'));
    %check if the "client" is a file:
    isFile(iNode+1) = exist(Files{iNode+1},'file') == 2 && ~(strcmp(Files{iNode+1},'Workspace'));
end
%remove the other files:
MyFiles = Files(find(isFile));
%open the files in the editor:
edit(MyFiles{:});

So whenever I close my editor by accident, I click on the shortcut to retrieve the files. It works in R2013a for me – I did not check other versions.

BR Michael

#18 Comment By Martin WH On April 19, 2016 @ 13:17

Great – thanks! This doesn’t happen to me very often, but when it does, it’s really annoying. Your script works fine in R2016a (Mac) by the way.

#19 Comment By Oleg Shebanits On August 19, 2016 @ 11:48

This is brilliant! Thank you so much!
Works in R2016a and much simpler than making functions etc.

#20 Comment By Me On May 5, 2016 @ 23:46

I wish there were more people like you in this world!
Saved a lot of my time!

#21 Comment By Hexler On October 10, 2016 @ 02:14

For some reason this didn’t work for me. It had just stored 4 out of a bunch of tabs.
However, I found a list of files in MATLAB_Editor_State.xml. It looks like the tabs I was working on.

#22 Comment By Yair Altman On October 10, 2016 @ 10:44

@Hexler – I believe that MATLAB_Editor_State.xml merely stores the states of the various folding blocks in the code of every m-file that you have ever opened in the Editor, not just those files that are currently open.


Article printed from Undocumented Matlab: https://undocumentedmatlab.com

URL to article: https://undocumentedmatlab.com/articles/recovering-previous-editor-state

URLs in this post:

[1] EditorMacro – assign a keyboard macro in the Matlab editor : https://undocumentedmatlab.com/articles/editormacro-assign-a-keyboard-macro-in-the-matlab-editor

[2] Tri-state checkbox : https://undocumentedmatlab.com/articles/tri-state-checkbox

[3] Variables Editor scrolling : https://undocumentedmatlab.com/articles/variables-editor-scrolling

[4] Spicing up the Matlab Editor : https://undocumentedmatlab.com/articles/spicing-up-the-matlab-editor

[5] Determining axes zoom state : https://undocumentedmatlab.com/articles/determining-axes-zoom-state

[6] Non-textual editor actions : https://undocumentedmatlab.com/articles/non-textual-editor-actions

[7] : http://www.mathworks.co.uk/matlabcentral/fileexchange/34577-savecurrenteditorfiles

[8] : https://undocumentedmatlab.com/blog/accessing-the-matlab-editor/

[9] : http://www.mathworks.com/matlabcentral/fileexchange/46352-editor-session-manager

Copyright © Yair Altman - Undocumented Matlab. All rights reserved.